Supplemental Material
Supplemental Material
Artifacts supporting “Toward Human-Like Memory: Learning to Remember by Structure”
(boss-vision.pdf). Everything here backs a number, table, or protocol claim in the
paper. Nothing here depends on a trained model: the paper’s architecture is
prospective, and this bundle contains only the demonstrated evidence — the
diagnostic, the human study, the baseline sweep, and the two structure-aware probes.
Bundle: 72 files + a 1,637-file response cache, 8.1 MB.
Integrity: MANIFEST.sha256 (SHA-256 of every shipped file; the response cache
is fingerprinted in aggregate on the last line).
Anonymity: no author names, affiliations, emails, or absolute local paths.
1. What each paper claim maps to
| Paper claim | Value | Artifact | Regenerate |
|---|---|---|---|
| Baseline Q2-over-Q3 (Table 2) | 2–10%, 8 retrievers | results/per_item/*.json |
experiments/run_{tfidf,bm25,dense,cross_encoder}.py |
| Schema-clustered 95% CIs | 20 schemas, 10k bootstrap, seed 42 | results/aggregate/schema_clustered_results.json |
scripts/schema_clustered_analysis.py |
| Human recognition | 99.4% mean [98.3, 100] | human-study/human-annotation-{1,2,3}.csv |
scripts/score_human_validation.py |
| Extract + overlap (Table 3) | 75.0% (30/40) | results/ablation/extract_overlap_gpt-4o-mini.json |
scripts/llm_experiments.py |
| Extract + model match (Table 3) | 87.5% (35/40) | results/ablation/extract_match_gpt-4o-mini.json |
scripts/llm_experiments.py |
| Pairwise reference (Table 3) | 100% (40/40), exhaustive O(N) | results/ablation/pairwise_gpt-4o-mini.json |
scripts/llm_experiments.py |
| Minimal-pair ranking | 87.5% [80.0, 95.0] | results/ablation/mapping40_end2end_constrained.json |
scripts/mapping_eval.py |
| Edge localization ≈ chance | 32.5% vs 33.3% | same | same |
| Causal-reversal localization | 0.0% | same | same |
| Role-map F1 / coverage | 88.5 / 97.3% | same | same |
All \Res* macros used in the paper |
— | results/result_macros.tex |
scripts/export_result_macros.py |
results/result_macros.tex is the single source of truth: every empirical number in
the manuscript is a macro defined there, so no figure is typed by hand.
2. Directory guide
data/ — the diagnostic
triplets_60.json— the 60-triplet diagnostic (20 schemas × 3 realizations). Each triplet: query, Q2 far analogy, Q3 surface-matched near-disanalogy.schema_definitions.json— the 20 relational schemas.dataset_manifest.json,checksums.sha256— version (v2.4.0) and checksums.battery_answer_key.json— authoritative key (seed 42,q2_positionper item); what the human study is scored against.mapping_frozen_40.json+.manifest.json,FREEZE_mapping40.md— the frozen 40-item minimal-pair set: four transformation families (role rebinding, causal-direction reversal, edge redirection, participant reassignment), 10 each. Both candidates sit in the same foreign domain; the foil differs by a single directed-edge edit preserving the predicate multiset and node inventory. Checksum-pinned before the extractor was run.mapping_pilot.json— the authoring pilot (kept separate from the frozen block).SEALED_TEST_SET.md,ANNOTATOR_INSTRUCTIONS.md— freeze note and instructions.
human-study/ — the 3-rater blinded validation
human-annotation-{1,2,3}.csv— per-item judgments. Each rater scored both candidates on Surface and Structure (1–5, plus confidence); the rater’s implied choice is the candidate with the higher Structure score. There was no separate direct-choice question and no foil triplets.human_validation_instructions.md,human_validation_analysis_plan.md— the instrument and the analysis plan, both fixed before annotation.human_scores.json— scored output.
Two reading notes a reviewer will want:
- CSV layout differs. File 1’s header is on row 0; files 2 and 3 have a title block and their header on row 3. The scorer handles both.
- Label typo. Files 2 and 3 both carry the title “Annotator 2”. Their data differ; they are distinct raters. This is a spreadsheet-title typo, not duplicated data.
- Disclosed revision. Two Q3 candidates (items 23, 28) were clarified and re-rated mid-study. The paper therefore reports the 58-item frozen subset as confirmatory and the repaired 60-item set as robustness; the headline is unchanged either way. Pre- and post-revision ratings are never mixed within an item.
results/
per_item/— 13 files of per-item outcomes: the 8 evaluated retrievers (TF-IDF, BM25,text-embedding-3-large, cross-encoder, and the four open bi-encoders, which sharedense_results.json), the three LLM conditions, four model-free relation-matcher variants, and the answer-key ceiling (oracle, 100% by construction — it reads annotation fields directly and is not an inference method).ablation/— the 40-item abstraction probe, the minimal-pair mapping study (gold / end-to-end / role-constrained), a shuffled-assignment control, and a weaker-extractor reproduction (gpt-4o-mini: 73% overlap, 88% model match).aggregate/— schema-clustered bootstrap CIs and the summary table.result_macros.tex— all\Res*macros.
scaffolds/ — cached structural extractions
Frozen relational scaffolds, extracted one episode at a time (the extractor never saw a triplet’s siblings) and cached before any matching ran. This is what makes the structure-aware rows auditable: the abstraction step is fixed and inspectable, independent of the matcher applied on top.
llm-cache/responses/ — 1,637 cached model responses
Every request/response keyed by a content hash of prompt + model snapshot. The evaluated LLM outputs are therefore reproducible without API access, even though the API itself is not deterministic.
scripts/ and experiments/
Scoring and evaluation code: the human-study scorer, the schema-clustered bootstrap,
the mapping/minimal-pair evaluator, the relation-aware matcher, the four baseline
runners, BASELINE_PROTOCOL.md, and the macro exporter.
prompts/
PROMPT_SPEC.md— full extractor/matcher specification: model snapshots (gpt-4o-2024-08-06,gpt-4o-mini-2024-07-18), temperature 0, JSON mode, the scaffold schema, the closed 20-predicate vocabulary, canonicalization rules, the model-free matcher formula, and the prompt-development discipline (prompts were worded on the 20-item pilot only; the frozen 40 were never inspected).mask_integrity_frozen.yaml— frozen config for the mask-integrity probe.
3. Reproducing
python3 scripts/score_human_validation.py # human study: 99.4% [98.3,100], AC1
python3 scripts/schema_clustered_analysis.py # clustered CIs (10k boot, seed 42)
python3 experiments/run_tfidf.py # sparse baselines
python3 experiments/run_dense.py # open bi-encoders (downloads weights)
python3 scripts/mapping_eval.py # minimal-pair rank + edge localization
Open-model baselines and every scoring step run offline. Reproducing the LLM rows
from scratch needs OPENAI_API_KEY; reading them from llm-cache/responses/ does
not. run_dense.py downloads public sentence-transformer weights.
AC1, both variants. The scorer prints Gwet’s AC1 two ways: 1.00 with ties
dropped, and 0.985 (→ 0.99) treating the single tie as a third category. The
\ResHumanACOne macro carries the conservative 0.99. Neither choice moves the
headline: 179 of 180 rater–item comparisons favored Q2, one tied, none favored Q3.
4. Scope — what is not here
Stated plainly, because the paper’s central architecture is a proposal:
- No trained consolidation engine. No learned state
Z, routing keyc=ρ(Z), residual channel, or trained matcher. These are proposed (paper Table 1) and tested by H-Structure / H-Consolidation / H-Generation / H-Interface, none of which this bundle settles. - The structure-aware rows use a stand-in extractor (a general-purpose LLM), not
the proposed
Z. They support automatic abstraction, not schema generalization. - No held-out split. All realizations were authored together; no split is genuinely held out. The 40-item block is a frozen reporting block, not a test set.
- The 100% pairwise row is an exhaustive O(N) reference, not a scalable retriever.
- No natural-analogy corpus. Dataset (b) — the decisive transfer falsifier — does not exist yet.
- Embedding cache excluded (11 MB): the open-model vectors are recomputable via
run_dense.py.
5. Note on the companion paper
A separate systems-framed version (boss-vision-short.tex, VLDB) shares this
diagnostic and these result macros but adds scaling/shortlist experiments
(H-Scale, H-System) that the position paper deliberately drops. Those artifacts —
shortlist matrices, fixed-target scaling, the 1K/10K probes — live in the repo’s
supplement/ directory and are not duplicated here.