diff --git a/AGENTS.md b/AGENTS.md index 8963896..2475f1f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -15,3 +15,7 @@ Chromeria's `GLOSSARY.md` is the system glossary; this repository's | Agent Observer | `toolboxmd/agent-observer` | [`GLOSSARY.md`](https://github.com/toolboxmd/agent-observer/blob/main/GLOSSARY.md) | Model Router (`toolboxmd/model-router`) is retired; Chromeria's Prism absorbed it. + +## Feature map + +When a pull request adds, splits, merges or removes a part of ContextMD, or binds a new Issue to one, update [`docs/map.md`](docs/map.md) in that same pull request. diff --git a/CHANGELOG.md b/CHANGELOG.md index 0c57491..919836d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,11 @@ # Changelog +## [0.5.6] - 2026-10-13 + +### Changed + +- docs/map.md maps ContextMD's parts to their Issues and PRs for Chromeria's Map tab (toolboxmd/chromeria#235) + ## [0.5.5] - 2026-10-13 ### Changed diff --git a/VERSION b/VERSION index d1d899f..b49b253 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.5.5 +0.5.6 diff --git a/docs/map.md b/docs/map.md new file mode 100644 index 0000000..c382b07 --- /dev/null +++ b/docs/map.md @@ -0,0 +1,138 @@ +# ContextMD map + +The parts of ContextMD and how they connect. Chromeria's Map tab colours each part +from GitHub: planned, working, broken or done. + +Each part is declared once as `ID["Name"]`. The comment line `%% ID: refs` under it +names the part's Issues and pull requests; the first ref is the primary ref, which +decides planned, working or done. `%% ID: context` marks a part this project draws +but does not track. GitHub ignores these comment lines. + +Change this map in the pull request that adds, splits, merges or removes a part. + +```mermaid +flowchart TD + S["Session in Chromeria"] + %% S: context + R["1 Record: Agent Observer sync"] + %% R: context + C["2 Capture: extract and judge"] + %% C: #7 PR #22 + CJ["Judge calibration, blind rounds"] + %% CJ: #8 + MC["Capture on every machine, scheduled"] + %% MC: #42 + D["3 Cause: route and historical miss join"] + %% D: #16 + W["4a Shape and add-only apply"] + %% W: PR #44 #39 + ST["Great Library store"] + %% ST: context + KV["4b Key variant proposal"] + %% KV: #17 + SI["4c Serving health check"] + %% SI: #40 + CX["4d Cue miss example to retraining"] + %% CX: #16 #4 + ES["4e Escalation proposal"] + %% ES: #17 + RF["4f Reflection update or remove"] + %% RF: #10 + DI["4g Defect Issues, tracker protocol"] + %% DI: #9 + AS["AgentsMD procedure store"] + %% AS: context + EK["5 Exact-key serving"] + %% EK: #3 #11 + MK["Must-know rule before its action"] + %% MK: toolboxmd/chromeria PR #233 toolboxmd/chromeria#231 + PK["Path keys on shell commands"] + %% PK: toolboxmd/chromeria#234 + FR["Pointer lifts only on a full read"] + %% FR: toolboxmd/chromeria PR #226 toolboxmd/chromeria#225 + FL["Serving on Codex, Grok, OpenCode"] + %% FL: #12 + GD["Grok deny defects"] + %% GD: toolboxmd/chromeria#229 toolboxmd/chromeria#230 toolboxmd/chromeria#228 + CU["5 Cue lane: scoring service and Chromeria lane"] + %% CU: PR #36 #13 toolboxmd/chromeria PR #227 + GL["Great Library pointer and registration on every machine"] + %% GL: #34 + SR["6 Serve evidence report"] + %% SR: PR #38 #15 + SC["6 Serve card and label prompt"] + %% SC: PR #45 #15 + LJ["6 Labeler judge runs"] + %% LJ: #15 + RP["7 Twice-weekly report"] + %% RP: #17 + CI["Waiting items into Cue entries"] + %% CI: #19 + WF["Cue input window format"] + %% WF: #20 + SP["Per-row proof that a serve was shown"] + %% SP: toolboxmd/chromeria#245 + CK["Command keys fire on runs, not mentions"] + %% CK: toolboxmd/chromeria#232 + RD["Readers called by path; OpenCode reservations"] + %% RD: toolboxmd/chromeria#221 + LF["Library format, flat"] + %% LF: #41 + PT["Pointer-trial retirement"] + %% PT: #43 + NC["Non-code capture"] + %% NC: #35 + GH["GPU serving host recovers on its own"] + %% GH: #6 + RL["Retrieval lane, only if needed"] + %% RL: #14 + + S --> R --> C --> D + CJ -. gates writes .-> C + MC -.-> C + D -->|needs a home| W --> ST --> EK + AS --> EK + D -->|key_mismatch| KV --> W + D -->|serving or matcher defect| SI + D -->|cue_missed| CX --> CU + D -->|ignored| ES --> W + D -->|wrong| RF --> ST + D -->|defect| DI + EK --- MK + EK --- PK + EK --- FR + EK --> FL + FL --- GD + GL --> S + EK --> SR + CU --> SR + SR --> SC --> LJ + LJ --> D + EK -->|next moment| S + CU -->|next moment| S + LJ --> RP + D --> RP + RP --> KV + RP --> ES + W --> CI --> CU + WF -.-> CU + GH -.-> CU + SP --> SR + EK --- CK + EK --- RD + LF -.-> ST + PT --> EK + NC -.-> C + EK -.-> RL +``` + +## Work that is not a part + +Every piece of work on the path to the Objective is a part above, except these: + +| Work | Why it is not a part | +| --- | --- | +| First bake (#39) | A run of one lesson through the whole loop, not a piece of it. It is bound on W. | +| Great Library flat store | Drawn as ST, a context part: its tracking lives outside this public repository. | +| "Read in full" wording in AgentsMD (toolboxmd/agentsmd#224, merged) | AgentsMD's own change, inside the AS context part. | +| Agent Observer event search and lock failures (toolboxmd/agent-observer#70, #71, done) | Agent Observer's own work, inside the R context part. |