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

package/dist/reporting/headline-templates/research.js

@@ -0,0 +1,23 @@
+const REASON_TEXT = {
+    cost_cap: 'cost cap reached',
+    timeout: 'timed out',
+    turn_cap: 'turn cap reached',
+};
+export const researchHeadlineTemplate = {
+    compose({ report, status, runResult }) {
+        const r = report;
+        const findings = Array.isArray(r?.findings) ? r.findings : [];
+        const sources = Array.isArray(r?.sourcesUsed) ? r.sourcesUsed : [];
+        if (status === 'incomplete') {
+            const reasonKey = runResult?.incompleteReason ?? '';
+            const reason = REASON_TEXT[reasonKey] ?? reasonKey ?? 'incomplete';
+            return `[incomplete] research: ${reason}`;
+        }
+        if (status === 'error') {
+            const msg = runResult?.error ?? 'runner crash';
+            return `[error] research: ${msg}`;
+        }
+        return `[ok] research: ${sources.length} sources, ${findings.length} findings`;
+    },
+};
+//# sourceMappingURL=research.js.map

package/dist/reporting/headline-templates/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../../src/reporting/headline-templates/research.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,GAA2B;IAC1C,QAAQ,EAAE,kBAAkB;IAC5B,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,kBAAkB;CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAqB;IACxD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE;QACnC,MAAM,CAAC,GAAG,MAAoD,CAAC;QAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpE,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAI,SAAuD,EAAE,gBAAgB,IAAI,EAAE,CAAC;YACnG,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,YAAY,CAAC;YACnE,OAAO,0BAA0B,MAAM,EAAE,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM,GAAG,GAAI,SAA4C,EAAE,KAAK,IAAI,cAAc,CAAC;YACnF,OAAO,qBAAqB,GAAG,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,kBAAkB,OAAO,CAAC,MAAM,aAAa,QAAQ,CAAC,MAAM,WAAW,CAAC;IACjF,CAAC;CACF,CAAC"}

package/dist/reporting/report-parser-slots/research-report.d.ts

@@ -0,0 +1,30 @@
+import type { ReportSchema } from '../structured-report-parser.js';
+import { z } from 'zod';
+declare const researchReportZod: z.ZodObject<{
+    findings: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        body: z.ZodString;
+        citations: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                url: "url";
+                file_line: "file_line";
+                source: "source";
+            }>;
+            label: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    sourcesUsed: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        attempted: z.ZodBoolean;
+        used: z.ZodBoolean;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ResearchReport = z.infer<typeof researchReportZod>;
+/** ReportSchema that parses worker narrative text (numbered findings +
+ *  `## Sources used` table) into a structured ResearchReport. */
+export declare const researchReportSchema: ReportSchema<ResearchReport>;
+export declare function parseResearchReport(output: string): ResearchReport;
+export {};
+//# sourceMappingURL=research-report.d.ts.map

package/dist/reporting/report-parser-slots/research-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-report.d.ts","sourceRoot":"","sources":["../../../src/reporting/report-parser-slots/research-report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;iBAgBrB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE/D;iEACiE;AACjE,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,cAAc,CAI7D,CAAC;AAuDF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAclE"}

package/dist/reporting/report-parser-slots/research-report.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+const researchReportZod = z.object({
+    findings: z.array(z.object({
+        index: z.number().int().nonnegative(),
+        body: z.string(),
+        citations: z.array(z.object({
+            kind: z.enum(['url', 'file_line', 'source']),
+            label: z.string().optional(),
+            target: z.string().optional(),
+        })),
+    })),
+    sourcesUsed: z.array(z.object({
+        source: z.string(),
+        attempted: z.boolean(),
+        used: z.boolean(),
+        note: z.string().optional(),
+    })),
+});
+/** ReportSchema that parses worker narrative text (numbered findings +
+ *  `## Sources used` table) into a structured ResearchReport. */
+export const researchReportSchema = {
+    parse(text) {
+        return parseResearchReport(text);
+    },
+};
+const NUMBERED_FINDING_RE = /^\s*(\d+)\.\s+([\s\S]*?)(?=^\s*\d+\.\s+|\n##\s|\n#\s|$)/gmu;
+const URL_RE = /https?:\/\/[^\s)]+/g;
+const FILE_LINE_RE = /([A-Za-z0-9_./-]+):(\d+(?:-\d+)?)/g;
+function parseSourcesUsed(text) {
+    const m = text.match(/##\s+Sources used\s*([\s\S]*?)(?:\n##\s|$)/i);
+    if (!m)
+        return [];
+    const lines = m[1].split('\n').map(l => l.trim()).filter(Boolean);
+    const rows = [];
+    for (const line of lines) {
+        if (!line.startsWith('|') || /^\|\s*-/.test(line) || /^\|\s*source\s*\|/i.test(line))
+            continue;
+        const cells = line.split('|').slice(1, -1).map(c => c.trim());
+        if (cells.length < 3)
+            continue;
+        const [source, attemptedRaw, usedRaw, note] = cells;
+        rows.push({
+            source,
+            attempted: /^yes$/i.test(attemptedRaw),
+            used: /^yes$/i.test(usedRaw),
+            ...(note ? { note } : {}),
+        });
+    }
+    return rows;
+}
+function extractCitations(body, sources) {
+    const citations = [];
+    for (const m of body.matchAll(URL_RE)) {
+        citations.push({ kind: 'url', label: extractDomain(m[0]), target: m[0] });
+    }
+    for (const m of body.matchAll(FILE_LINE_RE)) {
+        if (URL_RE.test(m[0]))
+            continue; // skip if it's part of a URL
+        citations.push({ kind: 'file_line', label: m[1], target: `${m[1]}:${m[2]}` });
+    }
+    // Pass 2: source-name match against the Sources Used table.
+    const lower = body.toLowerCase();
+    for (const row of sources) {
+        if (lower.includes(row.source.toLowerCase())) {
+            citations.push({ kind: 'source', label: row.source });
+        }
+    }
+    return citations;
+}
+function extractDomain(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return url;
+    }
+}
+export function parseResearchReport(output) {
+    const sourcesUsed = parseSourcesUsed(output);
+    const findings = [];
+    for (const m of output.matchAll(NUMBERED_FINDING_RE)) {
+        const idx = Number(m[1]);
+        const body = m[2].trim();
+        if (!body)
+            continue;
+        findings.push({
+            index: idx,
+            body,
+            citations: extractCitations(body, sourcesUsed),
+        });
+    }
+    return { findings, sourcesUsed };
+}
+//# sourceMappingURL=research-report.js.map

package/dist/reporting/report-parser-slots/research-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-report.js","sourceRoot":"","sources":["../../../src/reporting/report-parser-slots/research-report.ts"],"names":[],"mappings":"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"}

package/dist/review/annotator-prompt-builder.d.ts

@@ -8,7 +8,7 @@ export declare class AnnotatorPromptBuilder {
 /**
  * Trim the implementer brief down to the "what was asked" essentials
  * before sending to the annotator. The annotator does NOT need the
- * finding-format spec (it has its own format spec via ANNOTATOR_RUBRIC)
+ * finding-format spec (it has its own format spec via buildAnnotatorRubric)
  * or the delta-mode instructions. Sending the full brief wastes
  * 1-3KB context per call and mildly distracts the model.
  *

package/dist/review/annotator-prompt-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-prompt-builder.d.ts","sourceRoot":"","sources":["../../src/review/annotator-prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAExH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAErF,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAG9D,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM;CAGlE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2B3D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAoBxG"}
+{"version":3,"file":"annotator-prompt-builder.d.ts","sourceRoot":"","sources":["../../src/review/annotator-prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAE5H,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAErF,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAG9D,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM;CAGlE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2B3D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAoBxG"}

package/dist/review/annotator-prompt-builder.js

@@ -1,4 +1,4 @@
-import { ANNOTATOR_RUBRIC } from './templates/annotator-shared.js';
+import { buildAnnotatorRubric } from './templates/annotator-shared.js';
 export class AnnotatorPromptBuilder {
     templates;
     constructor(templates) {
@@ -11,7 +11,7 @@ export class AnnotatorPromptBuilder {
 /**
  * Trim the implementer brief down to the "what was asked" essentials
  * before sending to the annotator. The annotator does NOT need the
- * finding-format spec (it has its own format spec via ANNOTATOR_RUBRIC)
+ * finding-format spec (it has its own format spec via buildAnnotatorRubric)
  * or the delta-mode instructions. Sending the full brief wastes
  * 1-3KB context per call and mildly distracts the model.
  *
@@ -57,7 +57,7 @@ export function trimBriefForAnnotator(brief) {
 }
 export function assembleAnnotatorPrompt(template, ctx) {
     // Tool sweep #11: trim the brief — the format-spec section is
-    // duplicated by ANNOTATOR_RUBRIC below, so sending it again is
+    // duplicated by buildAnnotatorRubric below, so sending it again is
     // redundant + costly.
     const compactBrief = trimBriefForAnnotator(ctx.brief);
     return `You are reviewing a ${template.role} produced by a worker.
@@ -74,6 +74,6 @@ ${template.onBriefCheck}
 
 ${ctx.workerOutput}
 
-${ANNOTATOR_RUBRIC}`;
+${buildAnnotatorRubric(template)}`;
 }
 //# sourceMappingURL=annotator-prompt-builder.js.map

package/dist/review/annotator-prompt-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotator-prompt-builder.js","sourceRoot":"","sources":["../../src/review/annotator-prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAuD,MAAM,iCAAiC,CAAC;AAIxH,MAAM,OAAO,sBAAsB;IAEvB;IADV,YACU,SAAoD;QAApD,cAAS,GAAT,SAAS,CAA2C;IAC3D,CAAC;IAEJ,KAAK,CAAC,KAAqB,EAAE,GAA2B;QACtD,OAAO,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAElE,4DAA4D;IAC5D,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,CAAC;IAED,oEAAoE;IACpE,kEAAkE;IAClE,iEAAiE;IACjE,+DAA+D;IAC/D,gBAAgB;IAChB,MAAM,OAAO,GAAG;QACd,oCAAoC;QACpC,4CAA4C;QAC5C,sCAAsC;QACtC,kBAAkB;QAClB,sCAAsC;KACvC,CAAC;IACF,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAA2B,EAAE,GAA2B;IAC9F,8DAA8D;IAC9D,+DAA+D;IAC/D,sBAAsB;IACtB,MAAM,YAAY,GAAG,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,uBAAuB,QAAQ,CAAC,IAAI;;uBAEtB,QAAQ,CAAC,IAAI;;EAElC,YAAY;;;;EAIZ,QAAQ,CAAC,YAAY;;;;EAIrB,GAAG,CAAC,YAAY;;EAEhB,gBAAgB,EAAE,CAAC;AACrB,CAAC"}
+{"version":3,"file":"annotator-prompt-builder.js","sourceRoot":"","sources":["../../src/review/annotator-prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAuD,MAAM,iCAAiC,CAAC;AAI5H,MAAM,OAAO,sBAAsB;IAEvB;IADV,YACU,SAAoD;QAApD,cAAS,GAAT,SAAS,CAA2C;IAC3D,CAAC;IAEJ,KAAK,CAAC,KAAqB,EAAE,GAA2B;QACtD,OAAO,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAElE,4DAA4D;IAC5D,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,CAAC;IAED,oEAAoE;IACpE,kEAAkE;IAClE,iEAAiE;IACjE,+DAA+D;IAC/D,gBAAgB;IAChB,MAAM,OAAO,GAAG;QACd,oCAAoC;QACpC,4CAA4C;QAC5C,sCAAsC;QACtC,kBAAkB;QAClB,sCAAsC;KACvC,CAAC;IACF,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAA2B,EAAE,GAA2B;IAC9F,8DAA8D;IAC9D,mEAAmE;IACnE,sBAAsB;IACtB,MAAM,YAAY,GAAG,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,uBAAuB,QAAQ,CAAC,IAAI;;uBAEtB,QAAQ,CAAC,IAAI;;EAElC,YAAY;;;;EAIZ,QAAQ,CAAC,YAAY;;;;EAIrB,GAAG,CAAC,YAAY;;EAEhB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;AACnC,CAAC"}

package/dist/review/reviewer-engine.d.ts

@@ -12,7 +12,7 @@ export { qualityDebugTemplate } from './templates/quality-review-debug.js';
 export { qualityInvestigateTemplate } from './templates/quality-review-investigate.js';
 export { ReviewerPromptBuilder } from './reviewer-prompt-builder.js';
 export type { QualityReviewRoute } from './reviewer-prompt-builder.js';
-export type ReviewRoute = 'delegate' | 'execute-plan' | 'audit' | 'review' | 'verify' | 'investigate' | 'debug' | 'explore';
+export type ReviewRoute = 'delegate' | 'execute-plan' | 'audit' | 'review' | 'verify' | 'investigate' | 'debug' | 'research';
 export interface ReviewerInput {
     workerOutput: string;
     brief: string;

package/dist/review/reviewer-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reviewer-engine.d.ts","sourceRoot":"","sources":["../../src/review/reviewer-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reviewer-engine.d.ts","sourceRoot":"","sources":["../../src/review/reviewer-engine.ts"],"names":[],"mappings":"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"}

package/dist/review/reviewer-prompt-builder.d.ts

@@ -1,5 +1,5 @@
 import type { ReviewTemplate, ReviewTemplateContext } from './templates/shared.js';
-export type QualityReviewRoute = 'delegate' | 'execute-plan' | 'audit' | 'review' | 'verify' | 'investigate' | 'debug' | 'explore';
+export type QualityReviewRoute = 'delegate' | 'execute-plan' | 'audit' | 'review' | 'verify' | 'investigate' | 'debug' | 'research';
 export declare class ReviewerPromptBuilder {
     private templates;
     private qualityTemplates;

package/dist/review/reviewer-prompt-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reviewer-prompt-builder.d.ts","sourceRoot":"","sources":["../../src/review/reviewer-prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnI,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,gBAAgB;gBALhB,SAAS,EAAE;QACjB,IAAI,EAAE,cAAc,CAAC;QACrB,YAAY,EAAE,cAAc,CAAC;QAC7B,IAAI,EAAE,cAAc,CAAC;KACtB,EACO,gBAAgB,GAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAM;IAGpF,SAAS,CAAC,GAAG,EAAE,qBAAqB,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAOnF,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG;QAAE,KAAK,CAAC,EAAE,kBAAkB,CAAA;KAAE,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAQzH,SAAS,CAAC,GAAG,EAAE,qBAAqB,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAMpF"}
+{"version":3,"file":"reviewer-prompt-builder.d.ts","sourceRoot":"","sources":["../../src/review/reviewer-prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpI,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,gBAAgB;gBALhB,SAAS,EAAE;QACjB,IAAI,EAAE,cAAc,CAAC;QACrB,YAAY,EAAE,cAAc,CAAC;QAC7B,IAAI,EAAE,cAAc,CAAC;KACtB,EACO,gBAAgB,GAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAM;IAGpF,SAAS,CAAC,GAAG,EAAE,qBAAqB,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAOnF,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG;QAAE,KAAK,CAAC,EAAE,kBAAkB,CAAA;KAAE,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAQzH,SAAS,CAAC,GAAG,EAAE,qBAAqB,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAMpF"}

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

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

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

@@ -1,5 +1,18 @@
 export const annotatorAuditTemplate = {
     role: 'audit',
     onBriefCheck: 'For each finding, ask: is this the kind of issue the audit asked for? A security audit should produce security findings, not style nits.',
+    evidenceRule: [
+        '- Audit findings come in three valid shapes:',
+        '  1. Doc quote: a verbatim passage from the document showing the issue.',
+        '  2. Absence-reference: a precise pointer to where the doc *should* address something but doesn\'t (e.g. "Section 3.2 lists failure modes but is silent on queue overflow").',
+        '  3. Claim + contradiction: the doc\'s claim plus a quote from the source it contradicts.',
+        '- A finding without one of these three forms is speculation; downgrade to low or drop.',
+    ].join('\n'),
+    scopeRule: [
+        '- The document and what it directly references are in scope.',
+        '- Cross-section / cross-doc reasoning IS the value of an audit — do not penalize as speculation.',
+        '- Repository-wide enumeration / globbing is out of scope; flag findings whose evidence depends on broad enumeration.',
+        '- Coding-style nits on inline examples belong in a code review, not an audit; flag as off-brief.',
+    ].join('\n'),
 };
 //# sourceMappingURL=annotator-audit.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"annotator-audit.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-audit.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,IAAI,EAAE,OAAO;IACb,YAAY,EAAE,0IAA0I;CACzJ,CAAC"}
+{"version":3,"file":"annotator-audit.js","sourceRoot":"","sources":["../../../src/review/templates/annotator-audit.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,IAAI,EAAE,OAAO;IACb,YAAY,EAAE,0IAA0I;IACxJ,YAAY,EAAE;QACZ,8CAA8C;QAC9C,yEAAyE;QACzE,8KAA8K;QAC9K,2FAA2F;QAC3F,wFAAwF;KACzF,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,SAAS,EAAE;QACT,8DAA8D;QAC9D,kGAAkG;QAClG,sHAAsH;QACtH,kGAAkG;KACnG,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC"}

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

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

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

@@ -1,5 +1,15 @@
 export const annotatorDebugTemplate = {
     role: 'debugging hypothesis',
-    onBriefCheck: '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.',
+    onBriefCheck: 'Each finding should be a hypothesis, root-cause claim, or evidence (reproducer, error pattern, code path).',
+    evidenceRule: [
+        '- Debug findings are hypotheses with reasoning chains.',
+        '- Evidence: reproducer + traced code path (file:line) + observed output.',
+        '- Hypothesis-level findings with PARTIAL evidence are valid — that is debugging.',
+        '- Severity reflects evidence strength: confirmed root cause = high; plausible = medium; ruled out = low or drop.',
+    ].join('\n'),
+    scopeRule: [
+        '- Cross-file tracing is in scope and required to follow the failure path.',
+        '- Out of scope: applied fixes (the worker should propose, not apply); unrelated code-review remarks.',
+    ].join('\n'),
 };
 //# sourceMappingURL=annotator-debug.js.map

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"}