@zhixuan92/multi-model-agent-core 4.0.4 → 4.0.6

package/dist/review/templates/annotator-debug.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-debug.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-debug.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,IAAI,EAAE,sBAAsB;IAC5B,YAAY,EAAE,yNAAyN;CACxO,CAAC"}
+{"version":3,"file":"annotator-debug.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-debug.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,IAAI,EAAE,sBAAsB;IAC5B,YAAY,EAAE,4GAA4G;IAC1H,YAAY,EAAE;QACZ,wDAAwD;QACxD,0EAA0E;QAC1E,kFAAkF;QAClF,kHAAkH;KACnH,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,SAAS,EAAE;QACT,2EAA2E;QAC3E,sGAAsG;KACvG,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC"}

package/dist/review/templates/annotator-investigate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-investigate.d.ts","sourceRoot":"","sources":["../../../src/review/templates/annotator-investigate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,eAAO,MAAM,4BAA4B,EAAE,iBAG1C,CAAC"}
+{"version":3,"file":"annotator-investigate.d.ts","sourceRoot":"","sources":["../../../src/review/templates/annotator-investigate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,eAAO,MAAM,4BAA4B,EAAE,iBAY1C,CAAC"}

package/dist/review/templates/annotator-investigate.js

@@ -1,5 +1,14 @@
 export const annotatorInvestigateTemplate = {
     role: 'codebase investigation',
-    onBriefCheck: 'Each finding should be relevant to the question. Findings may be code-level (file:line cited in evidence) or project-level synthesis (what was searched, what was not found). Flag findings whose evidence does not support the claim or whose claim drifts from the question.',
+    onBriefCheck: 'Each finding should be relevant to the question.',
+    evidenceRule: [
+        '- Present-thing citations: real `file:line` from files actually read, with a quote or summary.',
+        '- Absent-thing citations: explicit "searched <pattern> in <path>, no matches" — negative findings are legitimate answers and must NOT be downgraded for lacking a code quote.',
+        '- Synthesis findings: cite each link in the reasoning chain by file:line.',
+    ].join('\n'),
+    scopeRule: [
+        '- Wherever the question leads is in scope; the question may not name files.',
+        '- Drift into unrelated code-review remarks is out of scope.',
+    ].join('\n'),
 };
 //# sourceMappingURL=annotator-investigate.js.map

package/dist/review/templates/annotator-investigate.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-investigate.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-investigate.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,4BAA4B,GAAsB;IAC7D,IAAI,EAAE,wBAAwB;IAC9B,YAAY,EAAE,gRAAgR;CAC/R,CAAC"}
+{"version":3,"file":"annotator-investigate.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-investigate.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,4BAA4B,GAAsB;IAC7D,IAAI,EAAE,wBAAwB;IAC9B,YAAY,EAAE,kDAAkD;IAChE,YAAY,EAAE;QACZ,gGAAgG;QAChG,+KAA+K;QAC/K,2EAA2E;KAC5E,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,SAAS,EAAE;QACT,6EAA6E;QAC7E,6DAA6D;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC"}

package/dist/review/templates/annotator-review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-review.d.ts","sourceRoot":"","sources":["../../../src/review/templates/annotator-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,EAAE,iBAGrC,CAAC"}
+{"version":3,"file":"annotator-review.d.ts","sourceRoot":"","sources":["../../../src/review/templates/annotator-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,EAAE,iBAarC,CAAC"}

package/dist/review/templates/annotator-review.js

@@ -1,5 +1,15 @@
 export const annotatorReviewTemplate = {
     role: 'code review',
     onBriefCheck: 'For each finding, ask: is this within the requested focus area? A security review should produce security findings, not formatting nits.',
+    evidenceRule: [
+        '- Code-review findings must cite `file:line` from the named files.',
+        '- Evidence must include a verbatim code quote, not paraphrase.',
+        '- Findings without a quotable code excerpt are speculation; downgrade or drop.',
+    ].join('\n'),
+    scopeRule: [
+        '- Only the named files are in scope. Behavior of direct callers/callees may be referenced when visible in the named files.',
+        '- Speculation about untouched files is out of scope.',
+        '- Doc/spec issues belong in an audit, not a review — flag as off-brief.',
+    ].join('\n'),
 };
 //# sourceMappingURL=annotator-review.js.map

package/dist/review/templates/annotator-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-review.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-review.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,IAAI,EAAE,aAAa;IACnB,YAAY,EAAE,0IAA0I;CACzJ,CAAC"}
+{"version":3,"file":"annotator-review.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-review.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,IAAI,EAAE,aAAa;IACnB,YAAY,EAAE,0IAA0I;IACxJ,YAAY,EAAE;QACZ,oEAAoE;QACpE,gEAAgE;QAChE,gFAAgF;KACjF,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,SAAS,EAAE;QACT,4HAA4H;QAC5H,sDAAsD;QACtD,yEAAyE;KAC1E,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC"}

package/dist/review/templates/annotator-shared.d.ts

@@ -5,6 +5,12 @@ export interface AnnotatorPromptContext {
 export interface AnnotatorTemplate {
     role: string;
     onBriefCheck: string;
+    /** Per-tool evidence rule. Tells the annotator what counts as
+     *  grounded evidence for findings from this tool. */
+    evidenceRule: string;
+    /** Per-tool scope rule. Tells the annotator what is in/out of scope
+     *  for findings from this tool. */
+    scopeRule: string;
 }
-export declare const ANNOTATOR_RUBRIC: string;
+export declare function buildAnnotatorRubric(template: AnnotatorTemplate): string;
 //# sourceMappingURL=annotator-shared.d.ts.map

package/dist/review/templates/annotator-shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-shared.d.ts","sourceRoot":"","sources":["../../../src/review/templates/annotator-shared.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,QA0DrB,CAAC"}
+{"version":3,"file":"annotator-shared.d.ts","sourceRoot":"","sources":["../../../src/review/templates/annotator-shared.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB;yDACqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB;uCACmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CA+CxE"}

package/dist/review/templates/annotator-shared.js

@@ -1,6 +1,7 @@
 // Data shared by all 5 annotator templates. The actual prompt assembly
 // happens in review/annotator-prompt-builder.ts.
-export const ANNOTATOR_RUBRIC = String.raw `
+export function buildAnnotatorRubric(template) {
+    return String.raw `
 ## Output format (REQUIRED)
 
 Respond with exactly one fenced JSON code block AS THE LAST BLOCK in your
@@ -16,47 +17,35 @@ the worker presented them. Example:
     "suggestion": "Use a parameterized API or escape input",
     "annotatorConfidence": 90,
     "category": "security"
-  },
-  {
-    "id": "F2",
-    "severity": "medium",
-    "claim": "Auth check missing on /admin endpoint",
-    "evidence": "router.get('/admin', adminHandler) — no auth middleware applied",
-    "annotatorConfidence": 60,
-    "category": "security"
   }
 ]
 ` + '```' + `
 
 Field rules:
-- ` + '`id`' + `: assign sequentially F1, F2, F3, ... (your choice; must be unique).
+- ` + '`id`' + `: assign sequentially F1, F2, F3, ... (must be unique).
 - ` + '`severity`' + `: one of "critical" | "high" | "medium" | "low" — YOUR
-   final judgment, not the worker's. The worker's value is a hint; you may
-   dial it up or down based on actual impact (workers tend to inflate).
-   - critical: must fix before any other work (RCE, auth bypass, data loss)
-   - high:     serious bug / security issue, blocks release
-   - medium:   real issue, should fix soon
-   - low:      minor issue, nice to fix
-   Map worker-said "mid" -> "medium". When the worker omitted severity, judge.
+   final judgment. The worker's value is a hint; calibrate to actual impact.
 - ` + '`claim`' + `: one-sentence summary.
 - ` + '`evidence`' + `: REQUIRED, ≥20 chars, MUST be a verbatim quote from the
-   worker's output. The parser flags non-substring quotes — quote precisely.
+   worker's output.
 - ` + '`suggestion`' + `: optional; quote or paraphrase the worker's recommended fix.
-- ` + '`annotatorConfidence`' + `: integer 0-100. How confident YOU (reviewer) are
-   that the finding is correct, on-brief, and well-grounded:
-     80-100: defend without hesitation
-     60-79:  plausible, minor gaps
-     40-59:  thin evidence
-     20-39:  weak / off-brief
-      0-19:  unsupported / fabricated
+- ` + '`annotatorConfidence`' + `: integer 0-100. How confident YOU are
+   that the finding is correct, on-brief, and well-grounded.
 - ` + '`category`' + `: optional, one of: "missing_test" | "scope_creep" |
    "incomplete_impl" | "style_lint" | "security" | "performance" |
    "maintainability" | "doc_gap" | "doc_drift" | "contract_violation" |
    "coverage_gap" | "dead_code" | "queue_hygiene" | "other".
-   When omitted, the parser will infer from the claim text. Prefer to emit
-   it when the category is unambiguous from your reading.
 
-If the worker raised NO issues, return ` + '`[]`' + `. Surrounding prose is allowed
-but ignored by the parser — only the LAST ` + '```json' + ` block is read.
+## Tool-specific evidence rule (apply when judging "well-grounded")
+
+` + template.evidenceRule + `
+
+## Tool-specific scope rule (apply when judging "on-brief")
+
+` + template.scopeRule + `
+
+If the worker raised NO issues, return ` + '`[]`' + `. Surrounding prose is
+allowed but ignored by the parser — only the LAST ` + '```json' + ` block is read.
 `.trim();
+}
 //# sourceMappingURL=annotator-shared.js.map

package/dist/review/templates/annotator-shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-shared.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-shared.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,iDAAiD;AAYjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;CAOzC,GAAG,WAAW,GAAG;;;;;;;;;;;;;;;;;;;CAmBjB,GAAG,KAAK,GAAG;;;GAGT,GAAG,MAAM,GAAG;GACZ,GAAG,YAAY,GAAG;;;;;;;;GAQlB,GAAG,SAAS,GAAG;GACf,GAAG,YAAY,GAAG;;GAElB,GAAG,cAAc,GAAG;GACpB,GAAG,uBAAuB,GAAG;;;;;;;GAO7B,GAAG,YAAY,GAAG;;;;;;;wCAOmB,GAAG,MAAM,GAAG;2CACT,GAAG,SAAS,GAAG;CACzD,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"annotator-shared.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-shared.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,iDAAiD;AAkBjD,MAAM,UAAU,oBAAoB,CAAC,QAA2B;IAC9D,OAAO,MAAM,CAAC,GAAG,CAAA;;;;;;;CAOlB,GAAG,WAAW,GAAG;;;;;;;;;;;CAWjB,GAAG,KAAK,GAAG;;;GAGT,GAAG,MAAM,GAAG;GACZ,GAAG,YAAY,GAAG;;GAElB,GAAG,SAAS,GAAG;GACf,GAAG,YAAY,GAAG;;GAElB,GAAG,cAAc,GAAG;GACpB,GAAG,uBAAuB,GAAG;;GAE7B,GAAG,YAAY,GAAG;;;;;;;CAOpB,GAAG,QAAQ,CAAC,YAAY,GAAG;;;;CAI3B,GAAG,QAAQ,CAAC,SAAS,GAAG;;wCAEe,GAAG,MAAM,GAAG;mDACD,GAAG,SAAS,GAAG;CACjE,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/review/templates/annotator-verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-verify.d.ts","sourceRoot":"","sources":["../../../src/review/templates/annotator-verify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,EAAE,iBAGrC,CAAC"}
+{"version":3,"file":"annotator-verify.d.ts","sourceRoot":"","sources":["../../../src/review/templates/annotator-verify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,EAAE,iBAarC,CAAC"}

package/dist/review/templates/annotator-verify.js

@@ -1,5 +1,15 @@
 export const annotatorVerifyTemplate = {
     role: 'verification report',
-    onBriefCheck: 'Each finding should map to one checklist item with evidence the criterion was met or unmet. Flag findings that do not correspond to any checklist item, or whose evidence does not actually demonstrate the claimed pass/fail status.',
+    onBriefCheck: 'Each finding should map to one checklist item with evidence the criterion was met or unmet.',
+    evidenceRule: [
+        '- Each Finding must map 1:1 to a checklist item.',
+        '- Evidence is execution output (test/build/command output) OR a code reference (`file:line`).',
+        '- A claimed PASS without evidence is speculation; downgrade or drop.',
+        '- Severity binding: PASS = low; FAIL = medium or high based on impact.',
+    ].join('\n'),
+    scopeRule: [
+        '- Only checklist items are in scope. Findings not tied to a checklist item are off-brief.',
+        '- All checklist items should be covered (one Finding per item, in order).',
+    ].join('\n'),
 };
 //# sourceMappingURL=annotator-verify.js.map

package/dist/review/templates/annotator-verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-verify.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-verify.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,IAAI,EAAE,qBAAqB;IAC3B,YAAY,EAAE,uOAAuO;CACtP,CAAC"}
+{"version":3,"file":"annotator-verify.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-verify.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,IAAI,EAAE,qBAAqB;IAC3B,YAAY,EAAE,6FAA6F;IAC3G,YAAY,EAAE;QACZ,kDAAkD;QAClD,+FAA+F;QAC/F,sEAAsE;QACtE,wEAAwE;KACzE,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,SAAS,EAAE;QACT,2FAA2F;QAC3F,2EAA2E;KAC5E,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC"}

package/dist/review/templates/finding-criteria.d.ts

@@ -1,39 +1,15 @@
 /**
- * Shared finding-quality criteria — the single source of truth for what
- * makes a "good finding" across the implementer + annotator stages.
+ * Truly-shared finding criteria — the constants that apply *identically*
+ * across every consumer. Per-tool blocks live next to each tool, not here.
  *
- * Tool sweep #12: the implementer prompts didn't share the annotator's
- * rubric, so workers emitted weak narrative (miscalibrated severity,
- * unsupported claims, speculative scope) and the annotator had to
- * either downgrade everything or rubber-stamp. This module gives
- * implementer prompts the SAME calibration the annotator uses, so the
- * two stages converge:
+ *  - SEVERITY_LADDER: same severity ladder, same anti-inflation hint, same
+ *    impact-anchored definitions for all 5 read-only tools.
+ *  - REVIEWER_AWARENESS_AP: same spec+quality reviewer expectation across
+ *    delegate / execute-plan / retry implementer prompts.
  *
- *   - Implementer is told what counts as evidence, what severity means,
- *     and what's out of scope BEFORE it writes findings.
- *   - Annotator validates the worker emitted them properly (its rubric
- *     in `annotator-shared.ts` references the same definitions).
- *
- * Result: fewer false positives, fewer missed criticals, less rework
- * (the worker self-aligned with what the reviewer will check). No
- * heuristic short-circuits — both stages run, they just spend less
- * time correcting each other.
+ * Evidence + scope + annotator-awareness are calibrated per-tool; see
+ * tools/<tool>/implementer-criteria.ts for each tool's blocks.
  */
-/** Severity ladder for read-only finding emission AND annotator
- *  validation. Same words, same meaning across stages. */
 export declare const SEVERITY_LADDER: string;
-/** Evidence-grounding rule. Required for every finding the worker
- *  emits. The annotator rejects findings without quotable evidence. */
-export declare const EVIDENCE_GROUNDING: string;
-/** Scope discipline. Workers commonly hallucinate citations into files
- *  they didn't open; this rule blocks the most common failure mode. */
-export declare const SCOPE_DISCIPLINE: string;
-/** What the annotator (which doubles as the read-only quality reviewer)
- *  will check the worker's output against. Pre-fix the worker had no
- *  visibility into this; now it can self-align. */
-export declare const ANNOTATOR_CHECK_AWARENESS_RO: string;
-/** Awareness block for delegate / execute-plan / retry implementers.
- *  Tells the worker what spec_review and quality_review will judge,
- *  so the worker self-aligns. */
 export declare const REVIEWER_AWARENESS_AP: string;
 //# sourceMappingURL=finding-criteria.d.ts.map

package/dist/review/templates/finding-criteria.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finding-criteria.d.ts","sourceRoot":"","sources":["../../../src/review/templates/finding-criteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;0DAC0D;AAC1D,eAAO,MAAM,eAAe,QAOhB,CAAC;AAEb;uEACuE;AACvE,eAAO,MAAM,kBAAkB,QAKnB,CAAC;AAEb;uEACuE;AACvE,eAAO,MAAM,gBAAgB,QAKjB,CAAC;AAEb;;mDAEmD;AACnD,eAAO,MAAM,4BAA4B,QAO7B,CAAC;AAEb;;iCAEiC;AACjC,eAAO,MAAM,qBAAqB,QAiBtB,CAAC"}
+{"version":3,"file":"finding-criteria.d.ts","sourceRoot":"","sources":["../../../src/review/templates/finding-criteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,eAAe,QAOhB,CAAC;AAEb,eAAO,MAAM,qBAAqB,QAiBtB,CAAC"}

package/dist/review/templates/finding-criteria.js

@@ -1,64 +1,23 @@
 /**
- * Shared finding-quality criteria — the single source of truth for what
- * makes a "good finding" across the implementer + annotator stages.
+ * Truly-shared finding criteria — the constants that apply *identically*
+ * across every consumer. Per-tool blocks live next to each tool, not here.
  *
- * Tool sweep #12: the implementer prompts didn't share the annotator's
- * rubric, so workers emitted weak narrative (miscalibrated severity,
- * unsupported claims, speculative scope) and the annotator had to
- * either downgrade everything or rubber-stamp. This module gives
- * implementer prompts the SAME calibration the annotator uses, so the
- * two stages converge:
+ *  - SEVERITY_LADDER: same severity ladder, same anti-inflation hint, same
+ *    impact-anchored definitions for all 5 read-only tools.
+ *  - REVIEWER_AWARENESS_AP: same spec+quality reviewer expectation across
+ *    delegate / execute-plan / retry implementer prompts.
  *
- *   - Implementer is told what counts as evidence, what severity means,
- *     and what's out of scope BEFORE it writes findings.
- *   - Annotator validates the worker emitted them properly (its rubric
- *     in `annotator-shared.ts` references the same definitions).
- *
- * Result: fewer false positives, fewer missed criticals, less rework
- * (the worker self-aligned with what the reviewer will check). No
- * heuristic short-circuits — both stages run, they just spend less
- * time correcting each other.
+ * Evidence + scope + annotator-awareness are calibrated per-tool; see
+ * tools/<tool>/implementer-criteria.ts for each tool's blocks.
  */
-/** Severity ladder for read-only finding emission AND annotator
- *  validation. Same words, same meaning across stages. */
 export const SEVERITY_LADDER = [
-    'Severity (your judgment, calibrated to impact):',
+    'Severity (your judgment, calibrated to actual impact):',
     '- critical: must fix first — RCE, data loss, auth bypass, build broken, data corruption.',
     '- high:     real bug or security gap; blocks release.',
     '- medium:   real issue; fix soon; not blocking.',
-    '- low:      minor or cosmetic issue; nice-to-fix; PASS in checklist contexts.',
+    '- low:      minor or cosmetic issue; nice-to-fix.',
     'Calibrate to actual impact, not how alarming the wording sounds. Workers commonly inflate — resist the urge.',
 ].join('\n');
-/** Evidence-grounding rule. Required for every finding the worker
- *  emits. The annotator rejects findings without quotable evidence. */
-export const EVIDENCE_GROUNDING = [
-    'Evidence grounding (REQUIRED for every finding):',
-    '- Cite `file:line` (or `file:line-line` for a span) where the issue lives.',
-    '- Quote the exact code excerpt or command output that demonstrates the issue. Don\'t paraphrase — quote.',
-    '- If you cannot quote evidence directly, do NOT raise the finding. Note "investigation needed" in your summary instead.',
-].join('\n');
-/** Scope discipline. Workers commonly hallucinate citations into files
- *  they didn't open; this rule blocks the most common failure mode. */
-export const SCOPE_DISCIPLINE = [
-    'Scope discipline:',
-    '- Only flag issues you verified by reading the file directly.',
-    '- If a claim depends on caller behavior or files outside the requested scope, mark "investigation needed" in your summary — do NOT speculate.',
-    '- Stay within the requested files. Don\'t audit dependencies you weren\'t asked about.',
-].join('\n');
-/** What the annotator (which doubles as the read-only quality reviewer)
- *  will check the worker's output against. Pre-fix the worker had no
- *  visibility into this; now it can self-align. */
-export const ANNOTATOR_CHECK_AWARENESS_RO = [
-    'After your output, an annotator validates each finding against this rubric:',
-    '- Is the severity calibrated to actual impact (or did you inflate)?',
-    '- Does the evidence directly support the claim, or is it paraphrased?',
-    '- Is the finding within scope, or is it speculation about untouched files?',
-    '- Is the finding on-brief (matching the focus / audit type / checklist item)?',
-    'Findings that fail any of these are downgraded or dropped. Self-check before emitting.',
-].join('\n');
-/** Awareness block for delegate / execute-plan / retry implementers.
- *  Tells the worker what spec_review and quality_review will judge,
- *  so the worker self-aligns. */
 export const REVIEWER_AWARENESS_AP = [
     'After your edit, two reviewers see the cumulative diff (every change since task start):',
     '',

package/dist/review/templates/finding-criteria.js.map

@@ -1 +1 @@
-{"version":3,"file":"finding-criteria.js","sourceRoot":"","sources":["../../../src/review/templates/finding-criteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;0DAC0D;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iDAAiD;IACjD,0FAA0F;IAC1F,uDAAuD;IACvD,iDAAiD;IACjD,+EAA+E;IAC/E,8GAA8G;CAC/G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;uEACuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,kDAAkD;IAClD,4EAA4E;IAC5E,0GAA0G;IAC1G,yHAAyH;CAC1H,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;uEACuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,mBAAmB;IACnB,+DAA+D;IAC/D,+IAA+I;IAC/I,wFAAwF;CACzF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;mDAEmD;AACnD,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,6EAA6E;IAC7E,qEAAqE;IACrE,uEAAuE;IACvE,4EAA4E;IAC5E,+EAA+E;IAC/E,wFAAwF;CACzF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;iCAEiC;AACjC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,yFAAyF;IACzF,EAAE;IACF,uDAAuD;IACvD,yGAAyG;IACzG,kFAAkF;IAClF,mFAAmF;IACnF,EAAE;IACF,gEAAgE;IAChE,6FAA6F;IAC7F,+FAA+F;IAC/F,EAAE;IACF,mCAAmC;IACnC,kDAAkD;IAClD,gDAAgD;IAChD,2HAA2H;IAC3H,qEAAqE;CACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"finding-criteria.js","sourceRoot":"","sources":["../../../src/review/templates/finding-criteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,wDAAwD;IACxD,0FAA0F;IAC1F,uDAAuD;IACvD,iDAAiD;IACjD,mDAAmD;IACnD,8GAA8G;CAC/G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,yFAAyF;IACzF,EAAE;IACF,uDAAuD;IACvD,yGAAyG;IACzG,kFAAkF;IAClF,mFAAmF;IACnF,EAAE;IACF,gEAAgE;IAChE,6FAA6F;IAC7F,+FAA+F;IAC/F,EAAE;IACF,mCAAmC;IACnC,kDAAkD;IAClD,gDAAgD;IAChD,2HAA2H;IAC3H,qEAAqE;CACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/review/templates/quality-review-audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-audit.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,oBAAoB,EAAE,cAMlC,CAAC"}
+{"version":3,"file":"quality-review-audit.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,oBAAoB,EAAE,cAMlC,CAAC"}

package/dist/review/templates/quality-review-audit.js

@@ -1,9 +1,10 @@
-import { ANNOTATOR_RUBRIC } from './annotator-shared.js';
+import { buildAnnotatorRubric } from './annotator-shared.js';
+import { annotatorAuditTemplate } from './annotator-audit.js';
 export const qualityAuditTemplate = {
     systemPrompt: `You are a quality reviewer checking an audit produced by a worker.
 For each finding, ask: is this the kind of issue the audit asked for? A security audit should produce security findings, not style nits.`,
     buildUserPrompt(ctx) {
-        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${ANNOTATOR_RUBRIC}`;
+        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${buildAnnotatorRubric(annotatorAuditTemplate)}`;
     },
 };
 //# sourceMappingURL=quality-review-audit.js.map

package/dist/review/templates/quality-review-audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-audit.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-audit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,YAAY,EAAE;yIACyH;IACvI,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,gBAAgB,EAAE,CAAC;IAC5F,CAAC;CACF,CAAC"}
+{"version":3,"file":"quality-review-audit.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-audit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,YAAY,EAAE;yIACyH;IACvI,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,oBAAoB,CAAC,sBAAsB,CAAC,EAAE,CAAC;IACxH,CAAC;CACF,CAAC"}

package/dist/review/templates/quality-review-debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-debug.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,oBAAoB,EAAE,cAMlC,CAAC"}
+{"version":3,"file":"quality-review-debug.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,oBAAoB,EAAE,cAMlC,CAAC"}

package/dist/review/templates/quality-review-debug.js

@@ -1,9 +1,10 @@
-import { ANNOTATOR_RUBRIC } from './annotator-shared.js';
+import { buildAnnotatorRubric } from './annotator-shared.js';
+import { annotatorDebugTemplate } from './annotator-debug.js';
 export const qualityDebugTemplate = {
     systemPrompt: `You are a quality reviewer checking a debugging hypothesis produced by a worker.
 Each finding should be a hypothesis, root-cause claim, or evidence (reproducer, error pattern, code path). Flag findings that do not logically follow from cited evidence or that exceed what the trace actually shows.`,
     buildUserPrompt(ctx) {
-        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${ANNOTATOR_RUBRIC}`;
+        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${buildAnnotatorRubric(annotatorDebugTemplate)}`;
     },
 };
 //# sourceMappingURL=quality-review-debug.js.map

package/dist/review/templates/quality-review-debug.js.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-debug.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-debug.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,YAAY,EAAE;wNACwM;IACtN,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,gBAAgB,EAAE,CAAC;IAC5F,CAAC;CACF,CAAC"}
+{"version":3,"file":"quality-review-debug.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-debug.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,YAAY,EAAE;wNACwM;IACtN,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,oBAAoB,CAAC,sBAAsB,CAAC,EAAE,CAAC;IACxH,CAAC;CACF,CAAC"}

package/dist/review/templates/quality-review-investigate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-investigate.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-investigate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,0BAA0B,EAAE,cAMxC,CAAC"}
+{"version":3,"file":"quality-review-investigate.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-investigate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,0BAA0B,EAAE,cAMxC,CAAC"}

package/dist/review/templates/quality-review-investigate.js

@@ -1,9 +1,10 @@
-import { ANNOTATOR_RUBRIC } from './annotator-shared.js';
+import { buildAnnotatorRubric } from './annotator-shared.js';
+import { annotatorInvestigateTemplate } from './annotator-investigate.js';
 export const qualityInvestigateTemplate = {
     systemPrompt: `You are a quality reviewer checking a codebase investigation produced by a worker.
 Each finding should be relevant to the question. Findings may be code-level (file:line cited in evidence) or project-level synthesis (what was searched, what was not found). Flag findings whose evidence does not support the claim or whose claim drifts from the question.`,
     buildUserPrompt(ctx) {
-        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${ANNOTATOR_RUBRIC}`;
+        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${buildAnnotatorRubric(annotatorInvestigateTemplate)}`;
     },
 };
 //# sourceMappingURL=quality-review-investigate.js.map

package/dist/review/templates/quality-review-investigate.js.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-investigate.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-investigate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,0BAA0B,GAAmB;IACxD,YAAY,EAAE;+QAC+P;IAC7Q,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,gBAAgB,EAAE,CAAC;IAC5F,CAAC;CACF,CAAC"}
+{"version":3,"file":"quality-review-investigate.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-investigate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAE1E,MAAM,CAAC,MAAM,0BAA0B,GAAmB;IACxD,YAAY,EAAE;+QAC+P;IAC7Q,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,oBAAoB,CAAC,4BAA4B,CAAC,EAAE,CAAC;IAC9H,CAAC;CACF,CAAC"}

package/dist/review/templates/quality-review-review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-review.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAC"}
+{"version":3,"file":"quality-review-review.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAC"}

package/dist/review/templates/quality-review-review.js

@@ -1,9 +1,10 @@
-import { ANNOTATOR_RUBRIC } from './annotator-shared.js';
+import { buildAnnotatorRubric } from './annotator-shared.js';
+import { annotatorReviewTemplate } from './annotator-review.js';
 export const qualityReviewTemplate = {
     systemPrompt: `You are a quality reviewer checking a code review produced by a worker.
 For each finding, ask: is this within the requested focus area? A security review should produce security findings, not formatting nits.`,
     buildUserPrompt(ctx) {
-        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${ANNOTATOR_RUBRIC}`;
+        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${buildAnnotatorRubric(annotatorReviewTemplate)}`;
     },
 };
 //# sourceMappingURL=quality-review-review.js.map

package/dist/review/templates/quality-review-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-review.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-review.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,YAAY,EAAE;yIACyH;IACvI,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,gBAAgB,EAAE,CAAC;IAC5F,CAAC;CACF,CAAC"}
+{"version":3,"file":"quality-review-review.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-review.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,YAAY,EAAE;yIACyH;IACvI,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,oBAAoB,CAAC,uBAAuB,CAAC,EAAE,CAAC;IACzH,CAAC;CACF,CAAC"}

package/dist/review/templates/quality-review-verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-verify.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-verify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAC"}
+{"version":3,"file":"quality-review-verify.d.ts","sourceRoot":"","sources":["../../../src/review/templates/quality-review-verify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAC"}

package/dist/review/templates/quality-review-verify.js

@@ -1,9 +1,10 @@
-import { ANNOTATOR_RUBRIC } from './annotator-shared.js';
+import { buildAnnotatorRubric } from './annotator-shared.js';
+import { annotatorVerifyTemplate } from './annotator-verify.js';
 export const qualityVerifyTemplate = {
     systemPrompt: `You are a quality reviewer checking a verification report produced by a worker.
 Each finding should map to one checklist item with evidence the criterion was met or unmet. Flag findings that do not correspond to any checklist item, or whose evidence does not actually demonstrate the claimed pass/fail status.`,
     buildUserPrompt(ctx) {
-        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${ANNOTATOR_RUBRIC}`;
+        return `Task: ${ctx.brief}\n\nWorker output:\n${ctx.workerOutput}\n\n${buildAnnotatorRubric(annotatorVerifyTemplate)}`;
     },
 };
 //# sourceMappingURL=quality-review-verify.js.map

package/dist/review/templates/quality-review-verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"quality-review-verify.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-verify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,YAAY,EAAE;sOACsN;IACpO,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,gBAAgB,EAAE,CAAC;IAC5F,CAAC;CACF,CAAC"}
+{"version":3,"file":"quality-review-verify.js","sourceRoot":"","sources":["../../../src/review/templates/quality-review-verify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,YAAY,EAAE;sOACsN;IACpO,eAAe,CAAC,GAAG;QACjB,OAAO,SAAS,GAAG,CAAC,KAAK,uBAAuB,GAAG,CAAC,YAAY,OAAO,oBAAoB,CAAC,uBAAuB,CAAC,EAAE,CAAC;IACzH,CAAC;CACF,CAAC"}

package/dist/stores/file-backed-context-block-store.d.ts

@@ -8,9 +8,13 @@ export interface FileBackedContextBlockStoreOptions {
     maxBlockBytes?: number;
     /** Max total bytes on disk. Defaults to 100 MiB. */
     maxTotalBytes?: number;
+    /** Override `os.homedir()` — used by tests for filesystem isolation. */
+    homeDir?: string;
 }
 export declare class FileBackedContextBlockStore implements ContextBlockStore {
-    private rootDir;
+    /** Absolute root: `<homeDir>/.multi-model-agent/context-blocks/<sha256(projectCwd)>`.
+     *  Public so tests can read meta files directly without re-deriving the path. */
+    readonly rootDir: string;
     private _ttlMs;
     private gcCheckIntervalMs;
     private maxBlockBytes;

package/dist/stores/file-backed-context-block-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-backed-context-block-store.d.ts","sourceRoot":"","sources":["../../src/stores/file-backed-context-block-store.ts"],"names":[],"mappings":"AA0CA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAcjC,MAAM,WAAW,kCAAkC;IACjD,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,2BAA4B,YAAW,iBAAiB;IACnE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAK;IACxB;;kDAE8C;IAC9C,OAAO,CAAC,SAAS,CAA6B;gBAElC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,kCAAuC;IAS7E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe;IA+BtE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAoBnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIrB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMvB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI5B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAuBpD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;qCACiC;IACjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,qEAAqE;IACrE,KAAK,IAAI,IAAI;IAKb;4CACwC;IACxC,gBAAgB,IAAI,MAAM;IAc1B,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,WAAW;IAKnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAYnB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAuBvB"}
+{"version":3,"file":"file-backed-context-block-store.d.ts","sourceRoot":"","sources":["../../src/stores/file-backed-context-block-store.ts"],"names":[],"mappings":"AA0CA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAcjC,MAAM,WAAW,kCAAkC;IACjD,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,2BAA4B,YAAW,iBAAiB;IACnE;qFACiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAK;IACxB;;kDAE8C;IAC9C,OAAO,CAAC,SAAS,CAA6B;gBAElC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,kCAAuC;IAW7E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe;IA+BtE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAoBnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIrB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMvB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI5B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAuBpD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;qCACiC;IACjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,qEAAqE;IACrE,KAAK,IAAI,IAAI;IAKb;4CACwC;IACxC,gBAAgB,IAAI,MAAM;IAc1B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,WAAW;IAKnB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAYnB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAuBvB"}

package/dist/stores/file-backed-context-block-store.js

@@ -7,14 +7,17 @@
  * everything on `npm run serve` cycles, breaking the recipe. This store
  * persists to disk and reloads lazily on first access.
  *
- * Layout: `<projectCwd>/.mma/context-blocks/<id>.txt` (content) +
- * `<id>.meta.json` ({ createdAt, ttlMs, lengthChars, sha256 }).
+ * Layout: `<homeDir>/.multi-model-agent/context-blocks/<sha256(projectCwd)>/<id>.txt`
+ * (content) + `<id>.meta.json` ({ createdAt, ttlMs, lengthChars, sha256 }).
+ * Storing in the user home (not the project tree) keeps repos clean —
+ * no `.gitignore` entries needed — while the per-project hash subdir
+ * preserves project isolation.
  *
- * Operational properties (per round-2 F5/F6/F7/F8/F9):
- *   - **Authoritative cwd**: store root is constructed from `projectCwd`
- *     supplied at construction time. NOT daemon cwd, NOT task cwd.
- *   - **Permissions**: directory `0700`, files `0600`. Audit findings can
- *     carry sensitive code excerpts; user-only access by default.
+ * Operational properties:
+ *   - **Authoritative cwd**: per-project subdir is `sha256(path.resolve(projectCwd))`.
+ *     NOT daemon cwd, NOT task cwd.
+ *   - **Permissions**: directories `0700`, files `0600`. Audit findings
+ *     can carry sensitive code excerpts; user-only access by default.
  *   - **TTL**: 7 days default. Enforced on `get()` (lazy delete on
  *     stale read), at the start of `register()` (opportunistic GC if
  *     last sweep was over `gcCheckIntervalMs` ago), and via
@@ -26,10 +29,6 @@
  *   - **Atomic writes**: temp-file → fsync → rename. GC treats orphaned
  *     pairs (content without metadata or vice versa) as corrupt and
  *     deletes both — recovers cleanly from daemon SIGKILL mid-write.
- *   - **Gitignore awareness**: on first directory creation, log a
- *     stderr breadcrumb suggesting `.mma/` be added to the project's
- *     `.gitignore` (we do NOT auto-edit the ignore file — surprising
- *     and may not be a git repo).
  *
  * Pinning is a no-op on this implementation — disk persistence is
  * stronger than the in-memory pin contract. The `pin`/`unpin` methods
@@ -39,12 +38,15 @@
  */
 import { createHash, randomUUID } from 'node:crypto';
 import * as fs from 'node:fs';
+import * as os from 'node:os';
 import * as path from 'node:path';
 const DEFAULT_TTL_MS = 7 * 24 * 60 * 60 * 1000;
 const DEFAULT_GC_INTERVAL_MS = 60 * 60 * 1000;
 const DEFAULT_MAX_BLOCK_BYTES = 1 * 1024 * 1024;
 const DEFAULT_MAX_TOTAL_BYTES = 100 * 1024 * 1024;
 export class FileBackedContextBlockStore {
+    /** Absolute root: `<homeDir>/.multi-model-agent/context-blocks/<sha256(projectCwd)>`.
+     *  Public so tests can read meta files directly without re-deriving the path. */
     rootDir;
     _ttlMs;
     gcCheckIntervalMs;
@@ -56,7 +58,9 @@ export class FileBackedContextBlockStore {
      *  TTL-based GC handles the recovery side. */
     pinCounts = new Map();
     constructor(projectCwd, opts = {}) {
-        this.rootDir = path.resolve(projectCwd, '.mma', 'context-blocks');
+        const home = opts.homeDir ?? os.homedir();
+        const projectHash = createHash('sha256').update(path.resolve(projectCwd)).digest('hex');
+        this.rootDir = path.join(home, '.multi-model-agent', 'context-blocks', projectHash);
         this._ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
         this.gcCheckIntervalMs = opts.gcCheckIntervalMs ?? DEFAULT_GC_INTERVAL_MS;
         this.maxBlockBytes = opts.maxBlockBytes ?? DEFAULT_MAX_BLOCK_BYTES;
@@ -178,14 +182,7 @@ export class FileBackedContextBlockStore {
     }
     // ── private helpers ────────────────────────────────────────────────
     ensureRoot() {
-        const created = !fs.existsSync(this.rootDir);
         fs.mkdirSync(this.rootDir, { recursive: true, mode: 0o700 });
-        if (created) {
-            // First-creation breadcrumb: nudge the user about gitignore. We
-            // intentionally do NOT modify their .gitignore — that would
-            // surprise users + may not be a git repo at all.
-            process.stderr.write(`[mmagent] created ${this.rootDir} — add ".mma/" to .gitignore (contains worker-output context blocks)\n`);
-        }
     }
     contentPath(id) {
         return path.join(this.rootDir, `${id}.txt`);