Repository navigation
docs(phd): App.K Agent Memory scaffold β GOLD IV PhD anchor (closes #465) - #487
Merged
Merged
Conversation
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
This was referenced May 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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-kgas the long-horizon memory substrate forLEAD/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 existingappendix/D-golden-mirror.texper the issue title note.docs/phd/main.texnow includes\include{appendix/K-agent-memory}.assertions/igla_assertions.jsongains 3 INV candidates bornwip(neverProven) per the INV-13 policy:kg_remember_idempotentkg_recall_budget_bounded(already enforced at the trait level by SR-MEM-01 π₯ [SR-MEM-01] kg-client-adapter β retry/circuit-breaker over trios-kgΒ #453)kg_supersede_history_monotonedocs/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.texcreated β atdocs/phd/appendix/K-agent-memory.texto match existing repo convention (appendix/<Letter>-<slug>.tex) and avoid the App.G/App.D-mirror collision called out in the issue title.docs/phd/experiment_map.mdlinking App. K β GOLD IV ring.assertions/igla_assertions.jsonfor INV-13/14/15 withstatus: wip(NOTProven).\citetheorem{}fallback macro (added at top of file).crates/trios-coq/andtrinity-clara/proofs/untouched).Admitted.(admitted_budget=5/5 LOCKED).Agent: CitationScribetrailer.R5-honest disclosures
.vfile created. The Coq theorem names in Β§G.5 are placeholders only. The chapter cites them via\citeWIP{}(companion macro added in docs(phd): R14 \citetheorem retrofit for 3 Proven INVs across 11 chapters (closes #464)Β #486), never via\citetheorem{}~(Proven).recall_respects_budgettest. INV-13 (remember_triple_idempotent_on_idtest) and INV-15 (supersede_inserts_then_deletes) are likewise covered at runtime β but neither is Coq-Proven, hencewip.appendix/K-agent-memory.texnotchapters/appendix_G_agent_memory.tex) follows existing repo convention; flagging here so the issue's wording isn't misread as a different file.Out of scope (tracked, not in this PR)
crates/trios-agent-memory/rings/BR-OUTPUT/) β π₯ [BR-OUTPUT] AgentMemory trait assembler (GOLD IV)Β #461.three-roads-465.jsonR1.trios-kginto LEAD agent.CI honest disclosure
Pre-existing failures on
main(I5red on legacycrates/trios-a2a/rings/*andcrates/trios-mcp/rings/*,ARCH-UI, genericTest) are out of scope. Merge via--admin --squash --delete-branchper EPIC #446 stewardship.Closes #465
Part-of: #446
π»
Ξ±_Ο = Οβ»Β³/2 β 0.1180Β·ΟΒ²+Οβ»Β²=3Β· TRINITY