Skip to content

docs(opmem): formatted manuscript and SHA 20533f2 experiment pin - #190

Draft
sdntsng wants to merge 19 commits into
devfrom
pr/opmem-manuscript-5ada
Draft

sdntsng wants to merge 19 commits into
devfrom
pr/opmem-manuscript-5ada

Conversation

@sdntsng

@sdntsng sdntsng commented Sep 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

OpMem Paper 1 manuscript (LaTeX + PDF) grounded in PR #189 publication-readiness protocol and frozen empirical pins. Primary merge-pin at git 20533f2: Brainy 13/13, verbatim 10/13, Mem0 Platform 10/13 (opmem-pin-20260918.json). Phase~2 external lanes are pinned artifacts only in this PR (Mem0 OSS 9/13, LangMem 8/13, Letta 5/13, Zep 3/9*); no new paid API runs in the latest babysit pass.

Changes

  • docs/research/opmem/paper/ — main.tex, references.bib, Makefile, generated fragments, main.pdf
  • docs/benchmarks/artifacts/opmem-manuscript-20533f2/ — run manifest, primary/lane/mechanism/stability JSON, logs
  • docs/benchmarks/artifacts/opmem-pin-20260918.json — combined three-system per-task pin
  • docs/benchmarks/artifacts/opmem-external-lanes/ — Phase~2 manifests + live JSON (historical runs; preserved)
  • evals/run_opmem_paper_experiments.py, scripts/run-opmem-manuscript.sh, scripts/generate-opmem-paper-tex.py
  • docs/research/opmem/PUBLICATION_READINESS.md, README.md — aligned executive table + pin pointers
  • docs/benchmarks/artifacts/opmem-verify-ca4eec0-20261013.md — local embedded re-verify at ca4eec0 (no Mem0 key)

Test plan

  • unset MEM0_API_KEY && go test ./internal/api/ -run 'TestOpMemBenchmarkAgainstHTTPServer|TestOpMemPaperExperiments' -count=1 — Brainy 13/13, verbatim 10/13 matches 20533f2 pin
  • make -C docs/research/opmem/paper pdf
  • pdftotext — no TODO / ?? in PDF text
  • Visual QA: pages 4–5 (Table 4 external lanes, limitations) — Zep 3/9*, footnote present

Risk / follow-ups

  • Not merging to dev/main without explicit approval (draft only).
  • Stability harness: 2/5 clean repeats on pinned opmem-stability.json; manuscript documents invalid 9/10 aggregates when infra errors > 0.
  • Recall enumerate lane: low pass rate vs search lane (documented ablation); product /recall not a substitute for search pin.
  • Cost/access (no new spend this pass): Mem0 Platform re-pin (47 API steps) and any new Phase2 vendor runs require worksheet + approval; Zep forget tasks remain not supported on pinned adapter.

Related

  • PR #189 — publication readiness package
  • PR #188 — inventory / reproduction plan
Open in Web Open in Cursor 

cursoragent and others added 19 commits September 18, 2026 21:06
Add docs/research/opmem/PUBLICATION_READINESS.md with reproducible protocol,
claims/evidence table, independent 13/13 vs 10/13 review, missing work,
threats to validity, artifact instructions, manuscript outline, and PR
#185-#187 overlap map.

Fix provably stale 12-task wording in opmem-spec, public-bench-ladder,
mem0-parity-gaps, and master-plan; banner July opmem post as pre-upd03.

Co-authored-by: aria <aria@engramhq.com>
Add brainy-recall and brainy-supersede adapter variants for manuscript
ablations. Introduce run_opmem_paper_experiments.py with run manifests and
optional OPMEM_ALLOW_INFRA_EXIT for diagnostic harness runs.

Co-authored-by: aria <aria@engramhq.com>
Co-authored-by: aria <aria@engramhq.com>
Co-authored-by: aria <aria@engramhq.com>
Co-authored-by: aria <aria@engramhq.com>
Paid vendor runs require cost estimate plus approval (not a spend ban).
Block Mem0 OSS/Zep/Letta/LangMem on missing adapters and worksheets.
Treat 9/10 with infra errors as invalid runs, not comparable scores.
Replace placeholder bib entries with verified arXiv/URL records.

Co-authored-by: aria <aria@engramhq.com>
Add mem0-oss, zep, letta, and langmem lane adapters with deterministic
namespaces, per-task reset, settling hooks, and redacted response logs.
Dry-run token instrumentation and spend worksheets use pinned gpt-4.1-mini
and embedding-3-small rates; live runs gated by OPMEM_EXTERNAL_LIVE.

Co-authored-by: aria <aria@engramhq.com>
Co-authored-by: aria <aria@engramhq.com>
Wire tiktoken payload budgets (mem0 extraction prompt included) into dry-run
output. Add run_opmem_external_live.py with preflight ceilings, smoke/full modes,
and live Mem0 OSS + LangMem adapters (Postgres/pgvector).

Co-authored-by: aria <aria@engramhq.com>
Record mem0-oss 9/13 and langmem 8/13 live pins, blocked zep/letta lanes,
payload worst-case worksheet, run manifests, and updated manuscript PDF.

Co-authored-by: aria <aria@engramhq.com>
Implement Letta 0.11.7 pip server adapter (opmem_facts block mapping),
start script, pinned requirements, and full 13-task run (5/13, 0 infra).
Document Zep blocked artifact when ZEP_API_KEY is absent; update manuscript
and external-lanes setup for independent reproduction.

Co-authored-by: aria <aria@engramhq.com>
ZEP_API_KEY absent from VM env and CLOUD_AGENT_INJECTED_SECRET_NAMES;
smoke/full Zep runs remain blocked with artifacts; no score claimed.

Co-authored-by: aria <aria@engramhq.com>
Co-authored-by: aria <aria@engramhq.com>
Migrate adapter to thread/graph SDK; free-tier preflight; smoke+full artifacts
opmem-phase2-zep-full (0 infra). Update manuscript matrix and Phase 2 summary.

Co-authored-by: aria <aria@engramhq.com>
Publication scoring from opmem-phase2-zep-full artifact only; raw 3/13 in footnote.
No harness re-run or scoring code changes.

Co-authored-by: aria <aria@engramhq.com>
Remove stale blocked/pending Zep-Letta wording; limitations and future work
match Table tab:external-lanes (9/13, 8/13, 5/13, 3/9*). PDF rebuild only.

Co-authored-by: aria <aria@engramhq.com>
Update Table 4 caption to state each lane ran the full 13-task script and
Zep is scored on nine supported tasks with the existing asterisk footnote.
Document hand-maintained external-lanes.tex in generated/README.md.
Rebuild main.pdf for publication.

Co-authored-by: aria <aria@engramhq.com>
Add xurl \artifact macro and sloppy evidence block; use breakable
paths for live-full JSON names and Zep fixture ids. Rebuild PDF.

Co-authored-by: aria <aria@engramhq.com>
- README and PUBLICATION_READINESS executive table match frozen pins
- Record ca4eec0 embedded re-verify (no Mem0 API)
- Rebuild main.pdf after make pdf (no text TODOs)

Co-authored-by: aria <aria@engramhq.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants