feat(subagent): opportunistic projection-cache rung for cold listings

Cold children consult the optional session-projection-cache checkpoint
before paying a preparation recompute: the identity is immutable once
appended, so a cached value is definitive regardless of its watermark.
The cache stays a read-only accelerator (absent service or any rung-two
fault falls through silently; verdicts stay with the authoritative
refold), and the note plus core-data-structures pages describe the
three-rung ladder.
This commit is contained in:
imccyu
2026-08-06 22:16:28 +08:00
parent 6ff4fc0ed0
commit a25d4331d7
15 changed files with 199 additions and 58 deletions

View File

@@ -288,8 +288,11 @@ export class SubagentService extends Service {
* resuming an Agent and without any query seam: the listing merges the live
* session store with optional session persistence (live-preferred) and
* serves each child's durable mode/label from the registered `subagent`
* projection unit — the registry's watermark snapshot for a live child, one
* persistence inspection folded through the registry for a cold one. The
* projection unit down a three-rung ladder — the registry's watermark
* snapshot for a live child; for a cold one, a durable projection-cache
* row when the optional cache already serves the identity (the value is
* immutable, so staleness cannot matter), else one persistence inspection
* folded through the registry. The
* projection fold is the single classification authority; per-child
* diagnostics relay a fold that served no identity or a failed inspection,
* never a list-time descriptor parse. Absent persistence, enumeration is