@zhixuan92/multi-model-agent-core 4.5.4 → 4.6.0

package/dist/lifecycle/annotate-prompts.js

@@ -0,0 +1,86 @@
+// packages/core/src/lifecycle/annotate-prompts.ts
+//
+// Two LLM prompt builders for the annotate stage (write route + read route).
+// Both produce transcript-only prompts that ask for a JSON judgment matching
+// AnnotatePayload. Helpers serialize upstream state without raw file contents
+// or secrets (spec §15.2).
+export function annotatePromptWrite(state) {
+    const ctx = serializeWriteContext(state);
+    return `You are the annotator for a code-change task. Read the structured outputs from each prior stage and produce a single JSON judgment.
+
+Input (truncated for budget):
+\`\`\`json
+${JSON.stringify(ctx, null, 2)}
+\`\`\`
+
+Rules:
+1. Emit ONLY a JSON code block with these exact fields: completed (boolean), message (string, 1-3 sentences), findings (array passed through from upstream — you may dedupe identical entries and re-categorize severity ONLY; never invent new findings), summary, filesChanged, commitSha.
+2. Set completed=true ONLY IF: the latest worker self-assessment is 'done'; AND review is approved OR rework's unaddressedFindingIds is empty; AND commit is 'committed' or 'no_op:no_diff' or skipped-with-autoCommit-disabled.
+3. If completed=false, message must name a specific blocking gate or finding ID AND suggest a recovery action.
+4. filesChanged and commitSha must come from commit.payload if it committed, else [] and null. Do not invent them.
+
+Output the JSON block now.`;
+}
+export function annotatePromptRead(state) {
+    const ctx = serializeReadContext(state);
+    return `You are the annotator for a read-only investigation task. Read the structured output from the implement stage and produce a single JSON judgment.
+
+Input:
+\`\`\`json
+${JSON.stringify(ctx, null, 2)}
+\`\`\`
+
+Rules:
+1. Emit ONLY a JSON code block with these exact fields: completed (boolean), message (string, 1-3 sentences), findings (array passed through from implement.findings; dedupe identical entries and may re-categorize severity — never invent new findings), summary, filesChanged (must be []), commitSha (must be null).
+2. Set completed=true ONLY IF: implement.workerSelfAssessment === 'done' AND (criteriaSucceeded.length > 0 OR criteriaErrors.length === 0).
+3. If completed=false, message must name a specific blocking criterion error or note that the worker self-assessed as failed, AND suggest a recovery action.
+4. Findings count is NOT a completion signal — empty findings on a read route means "I investigated and found nothing wrong," which is a valid completion when (2) holds.
+
+Output the JSON block now.`;
+}
+// ───── helpers ─────
+export function serializeWriteContext(state) {
+    const last = state.lastRunResult ?? null;
+    return {
+        task: { id: state.task?.id ?? null, brief: { title: state.task?.brief?.title ?? null, body: (state.task?.brief?.body ?? '').slice(0, 2000) } },
+        route: state.route,
+        implement: last ? {
+            workerSelfAssessment: last.workerStatus ?? null,
+            summary: (last.summary ?? '').slice(0, 1000),
+            filesChanged: last.filesChanged ?? [],
+        } : null,
+        review: {
+            verdict: state.reviewVerdict ?? null,
+            findings: stripEvidence(state.reviewFindings ?? []),
+        },
+        rework: {
+            applied: state.reworkApplied ?? false,
+            error: state.reworkError ?? null,
+            unaddressedFindingIds: last?.unaddressedFindingIds ?? [],
+        },
+        commit: {
+            committed: Array.isArray(state.commits) && state.commits.length > 0,
+            skipReason: last?.commitSkipReason ?? null,
+            sha: last?.commitSha ?? null,
+        },
+    };
+}
+export function serializeReadContext(state) {
+    const last = state.lastRunResult ?? null;
+    return {
+        task: { id: state.task?.id ?? null, brief: { title: state.task?.brief?.title ?? null, body: (state.task?.brief?.body ?? '').slice(0, 2000) } },
+        route: state.route,
+        implement: last ? {
+            workerSelfAssessment: last.workerStatus ?? null,
+            summary: (last.summary ?? '').slice(0, 1000),
+            findings: stripEvidence(last.findings ?? []),
+            citations: last.citations ?? [],
+            criteriaSucceeded: last.criteriaSucceeded ?? [],
+            criteriaErrors: last.criteriaErrors ?? [],
+        } : null,
+    };
+}
+export function stripEvidence(items) {
+    return items.map(i => ({ ...i, evidence: undefined }));
+}
+//# sourceMappingURL=annotate-prompts.js.map

package/dist/lifecycle/annotate-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotate-prompts.js","sourceRoot":"","sources":["../../src/lifecycle/annotate-prompts.ts"],"names":[],"mappings":"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"}

package/dist/lifecycle/auto-register-context-block.d.ts

@@ -1,4 +1,4 @@
-import type { RunResult } from '../types.js';
+import type { RuntimeRunResult } from '../types.js';
 import type { ContextBlockStore } from '../stores/context-block-tool.js';
 /**
  * Register usable task outputs as a combined context block.
@@ -7,5 +7,5 @@ import type { ContextBlockStore } from '../stores/context-block-tool.js';
  * Promoted here so the generic task executor and remaining per-tool
  * executors share a single implementation.
  */
-export declare function autoRegisterContextBlock(results: RunResult[], store: ContextBlockStore | undefined): string | undefined;
+export declare function autoRegisterContextBlock(results: RuntimeRunResult[], store: ContextBlockStore | undefined): string | undefined;
 //# sourceMappingURL=auto-register-context-block.d.ts.map

package/dist/lifecycle/auto-register-context-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-register-context-block.d.ts","sourceRoot":"","sources":["../../src/lifecycle/auto-register-context-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,EAAE,EACpB,KAAK,EAAE,iBAAiB,GAAG,SAAS,GACnC,MAAM,GAAG,SAAS,CAOpB"}
+{"version":3,"file":"auto-register-context-block.d.ts","sourceRoot":"","sources":["../../src/lifecycle/auto-register-context-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,KAAK,EAAE,iBAAiB,GAAG,SAAS,GACnC,MAAM,GAAG,SAAS,CAOpB"}

package/dist/lifecycle/auto-register-context-block.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-register-context-block.js","sourceRoot":"","sources":["../../src/lifecycle/auto-register-context-block.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAoB,EACpB,KAAoC;IAEpC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"auto-register-context-block.js","sourceRoot":"","sources":["../../src/lifecycle/auto-register-context-block.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA2B,EAC3B,KAAoC;IAEpC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/lifecycle/build-cancelled-result.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeRunResult } from '../types/run-result.js';
+/**
+ * Builds a cancelled-not-started result envelope. Used by the grouped
+ * dispatcher to fill slots for tasks that never began because the batch
+ * was aborted mid-group. Reuses workerStatus 'failed' to preserve the
+ * existing WorkerStatus enum and asyncDispatch.detectFailure logic; the
+ * 'cancelled' errorCode is the distinguishing field for consumers that
+ * care.
+ */
+export declare function buildCancelledResult(): RuntimeRunResult;
+//# sourceMappingURL=build-cancelled-result.d.ts.map

package/dist/lifecycle/build-cancelled-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-cancelled-result.d.ts","sourceRoot":"","sources":["../../src/lifecycle/build-cancelled-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAiBvD"}

package/dist/lifecycle/build-cancelled-result.js

@@ -0,0 +1,27 @@
+/**
+ * Builds a cancelled-not-started result envelope. Used by the grouped
+ * dispatcher to fill slots for tasks that never began because the batch
+ * was aborted mid-group. Reuses workerStatus 'failed' to preserve the
+ * existing WorkerStatus enum and asyncDispatch.detectFailure logic; the
+ * 'cancelled' errorCode is the distinguishing field for consumers that
+ * care.
+ */
+export function buildCancelledResult() {
+    return {
+        output: '',
+        status: 'error',
+        usage: { inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0 },
+        turns: 0,
+        filesRead: [],
+        filesWritten: [],
+        toolCalls: [],
+        outputIsDiagnostic: false,
+        escalationLog: [],
+        durationMs: 0,
+        workerStatus: 'failed',
+        errorCode: 'cancelled',
+        actualCostUSD: 0,
+        directoriesListed: [],
+    };
+}
+//# sourceMappingURL=build-cancelled-result.js.map

package/dist/lifecycle/build-cancelled-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-cancelled-result.js","sourceRoot":"","sources":["../../src/lifecycle/build-cancelled-result.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE;QACvF,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;QACb,kBAAkB,EAAE,KAAK;QACzB,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,QAAQ;QACtB,SAAS,EAAE,WAAW;QACtB,aAAa,EAAE,CAAC;QAChB,iBAAiB,EAAE,EAAE;KACF,CAAC;AACxB,CAAC"}

package/dist/lifecycle/executor-output-types.d.ts

@@ -1,4 +1,4 @@
-import type { RunResult, ReviewVerdict } from '../types.js';
+import type { RuntimeRunResult, ReviewVerdict } from '../types.js';
 import type { NotApplicable } from '../reporting/not-applicable.js';
 /** Aggregate timing metrics for a `delegate_tasks` batch. */
 export interface BatchTimings {
@@ -31,7 +31,7 @@ export interface BatchAggregateCost {
  */
 export interface ExecutorOutput {
     headline: string;
-    results: RunResult[] | NotApplicable;
+    results: RuntimeRunResult[] | NotApplicable;
     batchTimings: BatchTimings | NotApplicable;
     costSummary: BatchAggregateCost | NotApplicable;
     structuredReport: Record<string, unknown> | NotApplicable;

package/dist/lifecycle/executor-output-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor-output-types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/executor-output-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,0BAA0B,EAAE,MAAM,CAAA;CACnC;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,uBAAuB,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC;IACrC,YAAY,EAAE,YAAY,GAAG,aAAa,CAAC;IAC3C,WAAW,EAAE,kBAAkB,GAAG,aAAa,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC;IAC1D,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa,CAAC;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,oBAAoB,CAAC,EAAE,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"executor-output-types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/executor-output-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,0BAA0B,EAAE,MAAM,CAAA;CACnC;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,uBAAuB,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,EAAE,GAAG,aAAa,CAAC;IAC5C,YAAY,EAAE,YAAY,GAAG,aAAa,CAAC;IAC3C,WAAW,EAAE,kBAAkB,GAAG,aAAa,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC;IAC1D,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa,CAAC;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,oBAAoB,CAAC,EAAE,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/lifecycle/fallback-report.d.ts

@@ -1,5 +1,5 @@
-import type { RunResult } from '../types.js';
+import type { RuntimeRunResult } from '../types.js';
 import type { ParsedStructuredReport } from '../reporting/structured-report.js';
 export declare function readImplementerFileContents(filesWritten: string[], cwd: string | undefined): Promise<Record<string, string>>;
-export declare function buildFallbackImplReport(result: RunResult): ParsedStructuredReport;
+export declare function buildFallbackImplReport(result: RuntimeRunResult): ParsedStructuredReport;
 //# sourceMappingURL=fallback-report.d.ts.map

package/dist/lifecycle/fallback-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fallback-report.d.ts","sourceRoot":"","sources":["../../src/lifecycle/fallback-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAIhF,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,EAAE,EACtB,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAejC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,sBAAsB,CAajF"}
+{"version":3,"file":"fallback-report.d.ts","sourceRoot":"","sources":["../../src/lifecycle/fallback-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAIhF,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,EAAE,EACtB,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAejC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CAaxF"}

package/dist/lifecycle/fallback-report.js.map

@@ -1 +1 @@
-{"version":3,"file":"fallback-report.js","sourceRoot":"","sources":["../../src/lifecycle/fallback-report.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAsB,EACtB,GAAuB;IAEvB,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACjF,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM;gBAC1C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,uBAAuB;gBACpD,CAAC,CAAC,OAAO,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,QAAQ,CAAC,GAAG,qBAAqB,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;QACxC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7E,cAAc,EAAE,EAAE;QAClB,mBAAmB,EAAE,EAAE;QACvB,UAAU,EAAE,EAAE;QACd,aAAa,EAAE,EAAE;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"fallback-report.js","sourceRoot":"","sources":["../../src/lifecycle/fallback-report.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAsB,EACtB,GAAuB;IAEvB,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;YACjF,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM;gBAC1C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,uBAAuB;gBACpD,CAAC,CAAC,OAAO,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,QAAQ,CAAC,GAAG,qBAAqB,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAwB;IAC9D,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;QACxC,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7E,cAAc,EAAE,EAAE;QAClB,mBAAmB,EAAE,EAAE;QACvB,UAAU,EAAE,EAAE;QACd,aAAa,EAAE,EAAE;KAClB,CAAC;AACJ,CAAC"}

package/dist/lifecycle/findings-parser.d.ts

@@ -1,9 +1,11 @@
 export interface Finding {
+    id?: string;
     severity: 'critical' | 'high' | 'medium' | 'low';
     category: string;
     claim: string;
     evidence?: string;
     suggestion?: string;
+    source?: 'implementer' | 'reviewer';
 }
 export declare function parseFindings(text: string, criterionId: string): Finding[];
 //# sourceMappingURL=findings-parser.d.ts.map

package/dist/lifecycle/findings-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findings-parser.d.ts","sourceRoot":"","sources":["../../src/lifecycle/findings-parser.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAqC1E"}
+{"version":3,"file":"findings-parser.d.ts","sourceRoot":"","sources":["../../src/lifecycle/findings-parser.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;CACrC;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CA2C1E"}

package/dist/lifecycle/findings-parser.js

@@ -22,10 +22,15 @@ export function parseFindings(text, criterionId) {
         blocks.push(current.join('\n'));
     const findings = [];
     for (const block of blocks) {
-        const headingMatch = block.match(/^## Finding \d+:\s*(.+)$/m);
-        if (!headingMatch)
-            continue;
-        const claim = headingMatch[1].trim();
+        // Extract the claim from the "- Claim:" bullet line within the block.
+        // Note: the ## Finding N: heading line has no inline text (just the
+        // heading + colon + newline); the actual claim lives in the bullet.
+        // Claim can come from a `- Claim:` bullet (reviewer format) OR the inline
+        // text on the `## Finding N: <text>` heading (legacy worker format).
+        let claim = block.match(/^- Claim:\s*(.+)$/im)?.[1]?.trim() ?? '';
+        if (!claim) {
+            claim = block.match(/^## Finding \d+:\s*(.+)$/m)?.[1]?.trim() ?? '';
+        }
         if (claim.startsWith('[N/A]'))
             continue;
         const sevRaw = block.match(/^- Severity:\s*(\w+)/im)?.[1]?.toLowerCase();

package/dist/lifecycle/findings-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"findings-parser.js","sourceRoot":"","sources":["../../src/lifecycle/findings-parser.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,sEAAsE;AACtE,iEAAiE;AAUjE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,WAAmB;IAC7D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACxD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC9D,IAAI,CAAC,YAAY;YAAE,SAAS;QAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAExC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACzE,MAAM,QAAQ,GAAwB,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC;YACzE,CAAC,CAAE,MAA8B;YACjC,CAAC,CAAC,QAAQ,CAAC;QACb,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;QAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAC9E,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAEhF,MAAM,CAAC,GAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACjD,IAAI,QAAQ;YAAE,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACpC,IAAI,UAAU;YAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"findings-parser.js","sourceRoot":"","sources":["../../src/lifecycle/findings-parser.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,sEAAsE;AACtE,iEAAiE;AAYjE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,WAAmB;IAC7D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACxD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,sEAAsE;QACtE,oEAAoE;QACpE,oEAAoE;QACpE,0EAA0E;QAC1E,qEAAqE;QACrE,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACtE,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAExC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACzE,MAAM,QAAQ,GAAwB,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC;YACzE,CAAC,CAAE,MAA8B;YACjC,CAAC,CAAC,QAAQ,CAAC;QACb,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;QAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAC9E,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAEhF,MAAM,CAAC,GAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACjD,IAAI,QAAQ;YAAE,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACpC,IAAI,UAAU;YAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lifecycle/git-toplevel.d.ts

@@ -0,0 +1,12 @@
+export interface ResolveOptions {
+    timeoutMs?: number;
+}
+/**
+ * Returns the canonical absolute path of the git toplevel for `cwd`, or
+ * null if `cwd` is not in a git repo, git is unavailable, the directory
+ * does not exist, or the spawn times out (default 5 s).
+ *
+ * Pure function of (cwd, filesystem state). Never throws.
+ */
+export declare function resolveGitToplevel(cwd: string, opts?: ResolveOptions): Promise<string | null>;
+//# sourceMappingURL=git-toplevel.d.ts.map

package/dist/lifecycle/git-toplevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-toplevel.d.ts","sourceRoot":"","sources":["../../src/lifecycle/git-toplevel.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB"}

package/dist/lifecycle/git-toplevel.js

@@ -0,0 +1,49 @@
+import { spawn } from 'node:child_process';
+/**
+ * Returns the canonical absolute path of the git toplevel for `cwd`, or
+ * null if `cwd` is not in a git repo, git is unavailable, the directory
+ * does not exist, or the spawn times out (default 5 s).
+ *
+ * Pure function of (cwd, filesystem state). Never throws.
+ */
+export async function resolveGitToplevel(cwd, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 5000;
+    return new Promise((resolve) => {
+        let settled = false;
+        const settle = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(value);
+        };
+        let child;
+        try {
+            child = spawn('git', ['-C', cwd, 'rev-parse', '--show-toplevel'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+        }
+        catch {
+            settle(null);
+            return;
+        }
+        let stdout = '';
+        child.stdout?.on('data', (b) => { stdout += b.toString('utf8'); });
+        child.stderr?.on('data', () => { });
+        child.on('error', () => settle(null));
+        child.on('exit', (code) => {
+            if (code === 0)
+                settle(stdout.trim() || null);
+            else
+                settle(null);
+        });
+        const t = setTimeout(() => {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch { /* ignore */ }
+            settle(null);
+        }, timeoutMs);
+        child.on('exit', () => clearTimeout(t));
+    });
+}
+//# sourceMappingURL=git-toplevel.js.map

package/dist/lifecycle/git-toplevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-toplevel.js","sourceRoot":"","sources":["../../src/lifecycle/git-toplevel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAM3C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,OAAuB,EAAE;IAEzB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IACzC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,KAAoB,EAAE,EAAE;YACtC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QACF,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE;gBAChE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,CAAC;YACb,OAAO;QACT,CAAC;QACD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAiB,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC;gBAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC;;gBACzC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,IAAI,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lifecycle/handlers/annotator.d.ts

@@ -1,5 +1,6 @@
 import type { LifecycleState } from '../stage-plan-types.js';
 import { type ResearchSourcesUsedEntry } from '../../reporting/report-parser-slots/research-report.js';
+import type { AnnotatePayload, StageGate } from '../stage-io.js';
 export interface StructuredReport {
     summary: string;
     workerStatus: 'done' | 'done_with_concerns' | 'blocked' | 'failed';
@@ -31,5 +32,5 @@ export interface StructuredReport {
      *  every other route (audit/review/debug/investigate/write routes). */
     sourcesUsed?: ResearchSourcesUsedEntry[];
 }
-export declare function annotator(state: LifecycleState): Promise<void>;
+export declare function annotator(state: LifecycleState): Promise<StageGate<AnnotatePayload>>;
 //# sourceMappingURL=annotator.d.ts.map

package/dist/lifecycle/handlers/annotator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotator.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/annotator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,wDAAwD,CAAC;AAIhE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,UAAU,GAAG,kBAAkB,GAAG,IAAI,CAAC;IACtD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1G,cAAc,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD;2EACuE;IACvE,WAAW,CAAC,EAAE,wBAAwB,EAAE,CAAC;CAC1C;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDpE"}
+{"version":3,"file":"annotator.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/annotator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,wDAAwD,CAAC;AAIhE,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIjE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,UAAU,GAAG,kBAAkB,GAAG,IAAI,CAAC;IACtD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1G,cAAc,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD;2EACuE;IACvE,WAAW,CAAC,EAAE,wBAAwB,EAAE,CAAC;CAC1C;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CA0O1F"}

package/dist/lifecycle/handlers/annotator.js

@@ -7,6 +7,9 @@
 // nulls on the other side so the orchestrator parses one shape.
 import { mergeStageStats } from '../merge-stage-stats.js';
 import { parseSourcesUsed, } from '../../reporting/report-parser-slots/research-report.js';
+import { applyAnnotatePreconditions } from '../annotate-parser.js';
+import { annotatePromptWrite, annotatePromptRead } from '../annotate-prompts.js';
+import { runAnnotatorTurn } from '../../providers/run-annotator-turn.js';
 const READ_ROUTES = new Set(['audit', 'review', 'debug', 'investigate', 'research']);
 export async function annotator(state) {
     const t0 = Date.now();
@@ -36,18 +39,174 @@ export async function annotator(state) {
         report.sourcesUsed = parseSourcesUsed(lastOutput);
     }
     state.structuredReport = report;
+    // v5: prompt-budget truncation per spec §14 assumption 7 + AC-30 to AC-33.
+    // Three tiers, applied progressively when config.truncateAnnotatePromptTier
+    // signals overflow:
+    //   tier 1 → strip Finding.evidence
+    //   tier 2 → also strip summary fields (set to '')
+    //   tier 3 → fallback mode: emit deterministic AnnotatePayload with verbatim
+    //            spec-text message; completed=false; findings passthrough.
+    const cfg = state.config ?? {};
+    const tier = cfg.truncateAnnotatePromptTier ?? 0;
+    const bus = state.executionContext?.bus;
+    const reviewGate = state.gates?.['review'];
+    const implementGate = state.gates?.['implement'];
+    const aggregatedFindings = [
+        ...(last.findings ?? []),
+        ...((reviewGate?.outcome === 'advance' ? reviewGate.payload?.findings : undefined) ?? []),
+        ...((implementGate?.outcome === 'advance' ? implementGate.payload?.findings : undefined) ?? []),
+    ];
+    // Dedupe by claim+evidence (preserve first occurrence)
+    const seen = new Set();
+    const dedupedFindings = [];
+    for (const f of aggregatedFindings) {
+        const key = `${f.claim ?? ''}|${f.evidence ?? ''}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        dedupedFindings.push(f);
+    }
+    // Mechanical filesChanged + commitSha derivation (spec §5.7 rule 4)
+    const commitGate = state.gates?.['commit'];
+    const mechanicalFilesChanged = commitGate?.outcome === 'advance' &&
+        commitGate.payload?.kind === 'committed'
+        ? commitGate.payload.filesChanged ?? []
+        : (isRead ? [] : report.filesChanged);
+    const mechanicalCommitSha = commitGate?.outcome === 'advance' &&
+        commitGate.payload?.kind === 'committed'
+        ? (commitGate.payload.commitSha ?? null)
+        : (isRead ? null : (report.commitSha ?? null));
+    let truncatedFindings = dedupedFindings.slice();
+    let truncatedSummary = report.summary;
+    let fallbackMode = false;
+    if (tier >= 1) {
+        const droppedEvidenceCount = truncatedFindings.filter(f => f.evidence !== undefined).length;
+        truncatedFindings = truncatedFindings.map(f => {
+            const cp = { ...f };
+            delete cp.evidence;
+            return cp;
+        });
+        bus?.emit({ event: 'annotate_truncation', ts: new Date().toISOString(), tier: 1, droppedFieldCount: droppedEvidenceCount });
+    }
+    if (tier >= 2) {
+        const dropped = truncatedSummary ? 1 : 0;
+        truncatedSummary = '';
+        bus?.emit({ event: 'annotate_truncation', ts: new Date().toISOString(), tier: 2, droppedFieldCount: dropped });
+    }
+    if (tier >= 3) {
+        // Tier 3 = fallback mode per spec §5.7.3
+        fallbackMode = true;
+        bus?.emit({ event: 'annotate_truncation', ts: new Date().toISOString(), tier: 3, droppedFieldCount: 0 });
+    }
+    let annotated;
+    // LLM judge layer (spec §5.7.2). The annotator stage runs an LLM turn
+    // unless tier-3 truncation kicked us into fallback mode. The LLM is the
+    // proposer; the deterministic parser is the enforcer — applyAnnotatePreconditions
+    // always runs on the LLM-proposed payload and may flip completed=false. On
+    // transport error we fall back to mechanical synthesis (same path that ran
+    // before this layer was added).
+    let llmCostUSD = 0;
+    let llmDurationMs = 0;
+    let llmTurnsUsed = 0;
+    let llmTransportFailed = false;
+    let llmModel = null;
+    let llmInputTokens = 0;
+    let llmOutputTokens = 0;
+    let llmCachedReadTokens = 0;
+    let llmCachedNonReadTokens = 0;
+    if (fallbackMode) {
+        // Fallback findings: only gate-sourced findings flow through (gates.review,
+        // gates.implement). lastRunResult.findings are dropped as part of tier-3
+        // citation/non-gate-evidence clearing (spec §5.7.3 / AC-32).
+        const fallbackFindings = [];
+        const fbSeen = new Set();
+        const reviewFindings = (reviewGate?.outcome === 'advance' ? reviewGate.payload?.findings : undefined) ?? [];
+        const implementFindings = (implementGate?.outcome === 'advance' ? implementGate.payload?.findings : undefined) ?? [];
+        for (const f of [...reviewFindings, ...implementFindings]) {
+            const k = `${f.claim ?? ''}|${f.evidence ?? ''}`;
+            if (fbSeen.has(k))
+                continue;
+            fbSeen.add(k);
+            const cp = { ...f };
+            delete cp.evidence;
+            fallbackFindings.push(cp);
+        }
+        annotated = {
+            completed: false,
+            message: 'annotator prompt budget exceeded after tier-3 truncation; verdict computed mechanically from upstream gates',
+            findings: fallbackFindings,
+            summary: '',
+            filesChanged: mechanicalFilesChanged,
+            commitSha: mechanicalCommitSha,
+        };
+    }
+    else {
+        // Default mechanical proposal — used directly when LLM fails or returns
+        // unparseable output. The parser still gets the final say either way.
+        const mechanical = {
+            completed: true,
+            message: truncatedSummary || (isRead ? 'investigation completed' : 'task completed'),
+            findings: truncatedFindings,
+            summary: truncatedSummary,
+            filesChanged: mechanicalFilesChanged,
+            commitSha: mechanicalCommitSha,
+        };
+        let proposed = mechanical;
+        const ctx = state.executionContext;
+        if (ctx && typeof ctx.getSession === 'function') {
+            const prompt = isRead ? annotatePromptRead(state) : annotatePromptWrite(state);
+            const tres = await runAnnotatorTurn({ prompt, ctx: ctx, tier: 'standard' });
+            if (tres.kind === 'ok') {
+                llmCostUSD = tres.costUSD ?? 0;
+                llmModel = tres.model;
+                llmDurationMs = tres.ms;
+                llmTurnsUsed = tres.turnsUsed;
+                llmInputTokens = tres.inputTokens;
+                llmOutputTokens = tres.outputTokens;
+                llmCachedReadTokens = tres.cachedReadTokens;
+                llmCachedNonReadTokens = tres.cachedNonReadTokens;
+                const parsed = extractAnnotateJson(tres.text);
+                if (parsed) {
+                    // Authoritative fields come from upstream gates (mechanicalFilesChanged,
+                    // mechanicalCommitSha, dedupedFindings). The LLM gets to propose
+                    // completed + message + summary; everything mechanical we override.
+                    proposed = {
+                        completed: typeof parsed.completed === 'boolean' ? parsed.completed : mechanical.completed,
+                        message: typeof parsed.message === 'string' && parsed.message.length > 0 ? parsed.message : mechanical.message,
+                        summary: typeof parsed.summary === 'string' ? parsed.summary : mechanical.summary,
+                        findings: truncatedFindings,
+                        filesChanged: mechanicalFilesChanged,
+                        commitSha: mechanicalCommitSha,
+                    };
+                }
+                // parsed === null → keep mechanical (parser unaffected)
+            }
+            else {
+                // transport_error — fall through to mechanical synthesis
+                llmTransportFailed = true;
+                llmDurationMs = tres.ms;
+                bus?.emit({ event: 'annotate_llm_transport_error', ts: new Date().toISOString(), message: tres.message, durationMs: tres.ms });
+            }
+        }
+        annotated = applyAnnotatePreconditions(proposed, state);
+    }
+    state.annotatePayload = annotated;
     mergeStageStats(state, 'annotating', {
-        inputTokens: 0,
-        outputTokens: 0,
-        cachedReadTokens: 0,
-        cachedNonReadTokens: 0,
-        turnCount: 0,
+        inputTokens: llmInputTokens,
+        outputTokens: llmOutputTokens,
+        cachedReadTokens: llmCachedReadTokens,
+        cachedNonReadTokens: llmCachedNonReadTokens,
+        turnCount: llmTurnsUsed,
         toolCallCount: 0,
-        costUSD: 0,
+        costUSD: llmCostUSD,
         durationMs: Date.now() - t0,
         filesReadCount: 0,
         filesWrittenCount: 0,
-    }, { tier: null, model: null });
+    }, { tier: llmTurnsUsed > 0 ? 'standard' : null, model: llmModel });
+    // suppress unused-variable warning while keeping the durationMs field for
+    // diagnostics callers; mergeStageStats already captured the value above.
+    void llmDurationMs;
+    void llmTransportFailed;
     const annotatingStats = state.lastRunResult
         ?.stageStats?.annotating;
     if (annotatingStats) {
@@ -55,5 +214,64 @@ export async function annotator(state) {
         annotatingStats.maxIdleMs = 0;
         annotatingStats.totalIdleMs = 0;
     }
+    return {
+        outcome: 'advance',
+        payload: annotated,
+        telemetry: {
+            stageLabel: 'annotate',
+            durationMs: Date.now() - t0,
+            costUSD: llmCostUSD,
+            turnsUsed: llmTurnsUsed,
+            stopReason: 'normal',
+        },
+    };
+}
+/**
+ * Extract a single JSON object from the LLM's response.
+ *
+ * Accepts:
+ *   - A fenced ```json …``` block (preferred form per annotate prompts)
+ *   - A fenced ``` …``` block (no language tag)
+ *   - The first balanced `{…}` substring in the text
+ *
+ * Returns `null` if no parseable JSON is found, signalling the caller to keep
+ * the mechanical proposal. This is intentional: a malformed LLM response
+ * should not cause stage failure — the parser already has a deterministic
+ * answer it can fall back on.
+ */
+function extractAnnotateJson(text) {
+    if (!text)
+        return null;
+    const fencedJson = text.match(/```(?:json)?\s*\n([\s\S]*?)\n```/i);
+    const candidate = fencedJson ? fencedJson[1] : firstBalancedBraces(text);
+    if (!candidate)
+        return null;
+    try {
+        const parsed = JSON.parse(candidate);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return null;
+}
+function firstBalancedBraces(text) {
+    const start = text.indexOf('{');
+    if (start < 0)
+        return null;
+    let depth = 0;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '{')
+            depth++;
+        else if (ch === '}') {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null;
 }
 //# sourceMappingURL=annotator.js.map