Skip to content

docs(phd): App.K Agent Memory scaffold β€” GOLD IV PhD anchor (closes #465) - #487

Merged
gHashTag merged 1 commit into
mainfrom
lead/465-app-k-agent-memory-scaffold
May 2, 2026
Merged

gHashTag merged 1 commit into
mainfrom
lead/465-app-k-agent-memory-scaffold

Conversation

@gHashTag

@gHashTag gHashTag commented May 2, 2026

Copy link
Copy Markdown
Collaborator

App.K β€” Agent Memory scaffold (GOLD IV PhD anchor)

Documentation-only scaffold for the GOLD IV ring (KG-memory layer): integration of zig-knowledge-graph + trios-kg as the long-horizon memory substrate for LEAD/agent orchestration.

What ships

  • docs/phd/appendix/K-agent-memory.tex β€” 7-section appendix (G.1 Motivation through G.7 References). The chapter was renamed App.G β†’ App.K to avoid collision with the existing appendix/D-golden-mirror.tex per the issue title note.
  • docs/phd/main.tex now includes \include{appendix/K-agent-memory}.
  • assertions/igla_assertions.json gains 3 INV candidates born wip (never Proven) per the INV-13 policy:
  • docs/phd/experiment_map.md β€” new GOLD-IV row + counter shift (3 Proven + 5 Admitted + 3 wip).
  • .trinity/state/three-roads-465.json β€” follow-up routes.
  • .trinity/experience/trios_<date>.trinity β€” entry appended.

Acceptance criteria audit

  • docs/phd/chapters/appendix_G_agent_memory.tex created β€” at docs/phd/appendix/K-agent-memory.tex to match existing repo convention (appendix/<Letter>-<slug>.tex) and avoid the App.G/App.D-mirror collision called out in the issue title.
  • G.1 Motivation, G.2 Substrate, G.3 Public API, G.4 INV candidates, G.5 Coq placeholders, G.6 Falsifiers (sketch), G.7 References β€” all sections present.
  • Entry added to docs/phd/experiment_map.md linking App. K β†’ GOLD IV ring.
  • Entries added to assertions/igla_assertions.json for INV-13/14/15 with status: wip (NOT Proven).
  • R14: prose mentions of existing Proven INVs use \citetheorem{} fallback macro (added at top of file).
  • No Coq changes (crates/trios-coq/ and trinity-clara/proofs/ untouched).
  • No new Admitted. (admitted_budget=5/5 LOCKED).
  • Agent: CitationScribe trailer.

R5-honest disclosures

Out of scope (tracked, not in this PR)

CI honest disclosure

Pre-existing failures on main (I5 red on legacy crates/trios-a2a/rings/* and crates/trios-mcp/rings/*, ARCH-UI, generic Test) are out of scope. Merge via --admin --squash --delete-branch per EPIC #446 stewardship.

Closes #465
Part-of: #446

🌻 Ξ±_Ο† = φ⁻³/2 β‰ˆ 0.1180 Β· φ²+φ⁻²=3 Β· TRINITY

New file docs/phd/appendix/K-agent-memory.tex (was App.G, renamed
to avoid collision with appendix/D-golden-mirror.tex):
- G.1 Motivation (anti-amnesia for long-horizon LEAD loop)
- G.2 Substrate (zig-knowledge-graph + trios-kg)
- G.3 Public API (KgBackend trait surface)
- G.4 INV candidates (INV-13/14/15, born wip per INV-13 policy)
- G.5 Coq theorem placeholders (names only; no .v file in this PR)
- G.6 Falsifiers (sketch only; reserved file under
  crates/trios-agent-memory/rings/BR-OUTPUT/tests/)
- G.7 References

Wiring:
- main.tex: \include{appendix/K-agent-memory}
- assertions/igla_assertions.json: 3 new entries (INV-13/14/15)
  with status="wip" β€” never declared Proven without .v files.
  admitted_budget=5/5 LOCKED untouched.
- docs/phd/experiment_map.md: new GOLD-IV row + counter shift
  (3 wip invariants tracked alongside 3 Proven + 5 Admitted).

R5-honest:
- No Coq files created (admitted_budget=5/5 LOCKED).
- No new Admitted. introduced.
- All INV-13/14/15 marked wip, never Proven.
- App.K cites SR-MEM-01 (#453) trait-level enforcement of INV-14
  budget bound β€” already shipped, factual.
- Existing Proven trio (INV-2, INV-6, INV-12) cited via
  \providecommand{\citetheorem}{} fallback macro.

Three-roads written: .trinity/state/three-roads-465.json
Experience entry: .trinity/experience/trios_<date>.trinity

Closes #465
Part-of: #446

Agent: CitationScribe
@gHashTag
gHashTag merged commit 53d26a2 into main May 2, 2026
2 of 3 checks passed
@gHashTag
gHashTag deleted the lead/465-app-k-agent-memory-scaffold branch May 2, 2026 11:36
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.

🌻 App.K β€” Agent Memory chapter scaffold (KG-memory β†’ GOLD IV PhD) [was App.G β€” clash with CLARA Mirror]

1 participant