@webpieces/rules-config 0.4.774 → 0.4.776

package/src/subagent-provenance.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SubagentProvenanceService = exports.ReviewerContext = exports.TranscriptScan = exports.ReviewerEvidence = exports.ProvenanceResult = exports.PROVENANCE_SKIPPED = exports.PROVENANCE_MISSING = exports.PROVENANCE_OK = void 0;
+exports.SubagentProvenanceService = exports.ExpectedReviewer = exports.ReviewerContext = exports.TranscriptScan = exports.ReviewerEvidence = exports.ProvenanceResult = exports.PROVENANCE_SKIPPED = exports.PROVENANCE_MISSING = exports.PROVENANCE_OK = void 0;
 const tslib_1 = require("tslib");
 const child_process_1 = require("child_process");
 const fs = tslib_1.__importStar(require("fs"));
@@ -16,10 +16,11 @@ exports.PROVENANCE_SKIPPED = 'skipped'; // no CLAUDE_CODE_SESSION_ID (plain term
 class ProvenanceResult {
     status; // PROVENANCE_OK | PROVENANCE_MISSING | PROVENANCE_SKIPPED
     detail; // human-readable explanation for the warning/error/dashboard
-    // agentIds credited, keyed by agentType, so an evidence pass does not re-scan to find them again.
+    // agentIds credited, keyed by CHECKLIST ID, so an evidence pass does not re-scan to find them again. Two
+    // checklists may map to the same agentId when `reviewerAgents` let one subagent cover both.
     agentIds;
     /**
-     * The agentTypes that could NOT be credited — the FACT, with no remedy attached.
+     * The checklist ids that could NOT be credited — the FACT, with no remedy attached.
      *
      * Structured rather than only spelled into `detail` because the remedy depends on something this
      * service cannot see: whether that reviewer already wrote a verdict file. "It never ran" and "it ran
@@ -50,11 +51,12 @@ exports.ProvenanceResult = ProvenanceResult;
 /**
  * What ONE credited reviewer actually DID, read from its own transcript. Data-only (per CLAUDE.md).
  *
- * `verifyDistinct` answers "did a reviewer of this type run?" — an INTEGRITY question, and it blocks. This
+ * `verifyReviewers` answers "did a reviewer of this type run?" — an INTEGRITY question, and it blocks. This
  * answers "did it look at the change?" — a QUALITY question, and it only warns. The distinction is
  * deliberate; see {@link SubagentProvenanceService.evidenceFor}.
  */
 class ReviewerEvidence {
+    checklistId; // the checklist this evidence is FOR (one subagent may appear under several)
     agentType;
     agentId;
     readDiff; // opened the materialized diff dir (or its own instructions file)
@@ -73,7 +75,7 @@ class ReviewerEvidence {
      * Distinct `message.model` values OBSERVED in the transcript, in first-seen order.
      *
      * The model that actually ran, never the one that was configured — and never anything the reviewer
-     * says about itself. A checklist's `.claude/agents/<subagent>.md` declares `model:`, but that is the
+     * says about itself. The reviewer agent's `.claude/agents/<name>.md` may declare `model:`, but that is the
      * REQUESTED value and it can silently disagree with what served the request: a repo was measured
      * running opus for a reviewer whose agent file said `model: sonnet`. Asking the model instead would
      * be worse — a model is unreliable about its own identity, naming a family instead of a version or
@@ -97,7 +99,8 @@ class ReviewerEvidence {
     // known — see ReviewProvenanceService, which records it as the audit link for the verdict.
     transcriptPath;
     // eslint-disable-next-line @typescript-eslint/max-params
-    constructor(agentType, agentId, readDiff = false, readDoc = false, toolCallCount = 0, offRepoSearches = 0, transcriptPath = '', models = [], wroteVerdict = false) {
+    constructor(checklistId, agentType, agentId, readDiff = false, readDoc = false, toolCallCount = 0, offRepoSearches = 0, transcriptPath = '', models = [], wroteVerdict = false) {
+        this.checklistId = checklistId;
         this.agentType = agentType;
         this.agentId = agentId;
         this.readDiff = readDiff;
@@ -130,7 +133,7 @@ exports.TranscriptScan = TranscriptScan;
 /**
  * WHERE this branch's review materials live. Data-only.
  *
- * One class for BOTH passes — crediting (`verifyDistinct`) and evidence (`evidenceFor`) — because they
+ * One class for BOTH passes — crediting (`verifyReviewers`) and evidence (`evidenceFor`) — because they
  * ask their questions of the same paths. `diffDir` is the per-branch materialization
  * (`.webpieces/pr-review/<featureSlug>/diff`), which is what makes it usable as PROOF of which branch a
  * reviewer looked at: the path names the branch, it is absolute, and stage ② recreates it per run.
@@ -138,9 +141,9 @@ exports.TranscriptScan = TranscriptScan;
 class ReviewerContext {
     branch;
     diffDir; // '' when nothing was materialized
-    docPaths; // agentType → its checklist doc path ('' when none)
+    docPaths; // checklist id → its checklist doc path ('' when none)
     /**
-     * agentType → the absolute path of the verdict file THAT checklist must write on THIS branch
+     * checklist id → the absolute path of the verdict file THAT checklist must write on THIS branch
      * (`.webpieces/pr-review/<featureSlug>/review-<id>.json`). '' when unknown.
      *
      * The strongest attribution signal available, and stronger than `diffDir`: the path is
@@ -158,11 +161,27 @@ class ReviewerContext {
     }
 }
 exports.ReviewerContext = ReviewerContext;
+/**
+ * One checklist that must be credited to a reviewer run, and the agent type that run must carry. Data-only.
+ *
+ * The two used to be one string — a checklist's id WAS its agent type — and provenance keyed everything by
+ * it. Now every checklist is reviewed by the same repo-wide agent type, so the id and the type are
+ * separate facts and a run is matched on the type but credited to the id.
+ */
+class ExpectedReviewer {
+    checklistId;
+    agentType;
+    constructor(checklistId, agentType) {
+        this.checklistId = checklistId;
+        this.agentType = agentType;
+    }
+}
+exports.ExpectedReviewer = ExpectedReviewer;
 /**
  * Verifies — from the Claude Code harness's OWN artifacts, never from anything the model asserts — that
  * a subagent of a given `agentType` actually ran during the current session on the current branch. Used
- * to enforce a checklist's optional `subagent:` field: that an INDEPENDENT reviewer looked, rather than
- * the coding agent self-certifying.
+ * to enforce that every checklist was reviewed by a `reviewerAgentName` subagent: that an INDEPENDENT
+ * reviewer looked, rather than the coding agent self-certifying.
  *
  * The harness writes, beside each subagent transcript:
  *   ~/.claude/projects/<cwd-slug>/<sessionId>/subagents/agent-<id>.meta.json  → { agentType, spawnDepth, … }
@@ -173,7 +192,7 @@ exports.ReviewerContext = ReviewerContext;
  *
  * IMPORTANT — this is NOT tamper-proof. A determined agent can `cat >` a fake agent-*.meta.json. This
  * raises the bar from "trust the model's word" to "deliberate, auditable forgery outside the repo"; it
- * is not cryptographic. Say so wherever `subagent:` is documented.
+ * is not cryptographic. Say so wherever reviewer provenance is documented.
  *
  * `@injectable(bindingScopeValues.Singleton)` so it is drawn in the DI design and injected by type.
  */
@@ -185,16 +204,23 @@ let SubagentProvenanceService = class SubagentProvenanceService {
     // the same (largest) files this service opens, and the credit pass may look at candidates the
     // evidence pass then re-visits. See scanTranscript for why one pass answers both.
     scanByPath = new Map();
-    // Verify EVERY expected reviewer subagent ran on `context.branch` as a DISTINCT run — the coding agent
-    // may not self-certify, and one reviewer may not stand in for several. SKIPPED (pass) without a
-    // session id.
+    // Verify EVERY expected checklist was reviewed by a reviewer subagent that ran on `context.branch` — the
+    // coding agent may not self-certify. SKIPPED (pass) without a session id.
+    //
+    // `sharedRuns` false (no `reviewerAgents` configured): each checklist needs a DISTINCT run, so one
+    // reviewer may not stand in for several. `sharedRuns` true (`reviewerAgents` set): one run may cover
+    // several checklists, because that grouping is exactly what the repo asked for; a run is still only
+    // credited when it is a real subagent of the right type on this branch.
+    //
+    // Either way a run that NAMED this checklist's verdict file is preferred over one that merely ran on the
+    // branch, so each checklist is credited to the reviewer that actually wrote it whenever that is knowable.
     //
     // Scoped by BRANCH across ALL sessions (not the current session): once a reviewer ran on this branch in
     // any session, a later re-push in a NEW session still finds it, so the review is NOT forced to re-run.
     // That is what keeps "review once per branch" true across sessions. A PR opened outside the gated flow
     // still has no review-<id>.json, so wp-finish forces the review regardless of provenance.
-    verifyDistinct(expectedAgentTypes, context) {
-        if (expectedAgentTypes.length === 0)
+    verifyReviewers(expected, context, sharedRuns) {
+        if (expected.length === 0)
             return new ProvenanceResult(exports.PROVENANCE_OK, 'no reviewer subagents required', {}, []);
         if (!this.inClaudeSession())
             return this.skipped('reviewer subagents');
@@ -202,23 +228,25 @@ let SubagentProvenanceService = class SubagentProvenanceService {
         const missing = [];
         const usedAgentIds = new Set();
         const credited = {};
-        for (const type of expectedAgentTypes) {
-            const agentId = this.findMatchingAgentId(dirs, type, context, usedAgentIds);
+        for (const want of expected) {
+            const exclude = sharedRuns ? new Set() : usedAgentIds;
+            const agentId = this.findMatchingAgentId(dirs, want, context, exclude);
             if (agentId === '')
-                missing.push(type);
+                missing.push(want.checklistId);
             else {
                 usedAgentIds.add(agentId);
-                credited[type] = agentId;
+                credited[want.checklistId] = agentId;
             }
         }
+        const runs = new Set(Object.values(credited)).size;
         return missing.length === 0
-            ? new ProvenanceResult(exports.PROVENANCE_OK, `verified ${expectedAgentTypes.length} distinct reviewer subagent(s) ran`, credited, [])
-            : new ProvenanceResult(exports.PROVENANCE_MISSING, `${missing.length} reviewer subagent(s) could not be attributed to this branch: ${missing.join(', ')}`, credited, missing);
+            ? new ProvenanceResult(exports.PROVENANCE_OK, `verified ${expected.length} checklist(s) were reviewed by ${runs} reviewer subagent run(s)`, credited, [])
+            : new ProvenanceResult(exports.PROVENANCE_MISSING, `${missing.length} checklist(s) could not be attributed to a reviewer subagent on this branch: ${missing.join(', ')}`, credited, missing);
     }
     /**
      * What each credited reviewer actually READ, from its own transcript.
      *
-     * `verifyDistinct` proves a reviewer of the right type RAN. It cannot tell a reviewer that read the diff
+     * `verifyReviewers` proves a reviewer of the right type RAN. It cannot tell a reviewer that read the diff
      * and thought about it from one that wrote a verdict having opened nothing. This closes that gap — and
      * the motivating case is real: one reviewer spent 14 of 26 tool calls grepping `node_modules` because
      * nothing had told it where anything was, which `offRepoSearches` now makes visible.
@@ -229,34 +257,36 @@ let SubagentProvenanceService = class SubagentProvenanceService {
      *      consumer's PR with no self-service recovery — `sidechainOnBranch` is already lenient for exactly
      *      this reason, and blocking on a richer read of the same files would be less safe, not more.
      *   2. A reviewer can legitimately receive the diff another way (inlined into its prompt, say).
-     *   3. verifyDistinct is the INTEGRITY signal and rightly blocks; this is a QUALITY signal. Conflating
+     *   3. verifyReviewers is the INTEGRITY signal and rightly blocks; this is a QUALITY signal. Conflating
      *      them would let a transcript-parsing quirk refuse a PR that a real reviewer really did review.
      *
-     * Returns [] outside a Claude Code session, matching verifyDistinct's SKIP behavior.
+     * Returns [] outside a Claude Code session, matching verifyReviewers's SKIP behavior.
      */
-    evidenceFor(context, agentIds) {
+    evidenceFor(context, expected, agentIds) {
         if (!this.inClaudeSession())
             return [];
         const dirs = this.allSubagentsDirs();
         const out = [];
-        for (const agentType of Object.keys(agentIds)) {
-            const agentId = agentIds[agentType];
+        for (const want of expected) {
+            const agentId = agentIds[want.checklistId];
+            if (agentId === undefined)
+                continue;
             const jsonl = this.transcriptPath(dirs, agentId);
             if (jsonl === '') {
-                out.push(new ReviewerEvidence(agentType, agentId));
+                out.push(new ReviewerEvidence(want.checklistId, want.agentType, agentId));
                 continue;
             }
-            out.push(this.evidenceFromTranscript(agentType, agentId, jsonl, context));
+            out.push(this.evidenceFromTranscript(want, agentId, jsonl, context));
         }
         return out;
     }
     // eslint-disable-next-line @typescript-eslint/max-params
-    evidenceFromTranscript(agentType, agentId, jsonl, context) {
+    evidenceFromTranscript(want, agentId, jsonl, context) {
         const scan = this.scanTranscript(jsonl);
         const inputs = scan.inputs;
-        const docPath = context.docPaths[agentType] ?? '';
-        const verdictPath = context.verdictPaths[agentType] ?? '';
-        return new ReviewerEvidence(agentType, agentId, this.readDiffDir(scan, context), docPath !== '' && this.mentions(inputs, docPath), inputs.length, inputs.filter((i) => i.includes('node_modules')).length, jsonl, scan.models, verdictPath !== '' && this.mentions(inputs, verdictPath));
+        const docPath = context.docPaths[want.checklistId] ?? '';
+        const verdictPath = context.verdictPaths[want.checklistId] ?? '';
+        return new ReviewerEvidence(want.checklistId, want.agentType, agentId, this.readDiffDir(scan, context), docPath !== '' && this.mentions(inputs, docPath), inputs.length, inputs.filter((i) => i.includes('node_modules')).length, jsonl, scan.models, verdictPath !== '' && this.mentions(inputs, verdictPath));
     }
     // The instructions file counts as "read the diff": it lives in the same per-branch dir, it is what
     // the reviewer is told to open first, and it inlines the diff paths. A reviewer that opened it and
@@ -355,26 +385,46 @@ let SubagentProvenanceService = class SubagentProvenanceService {
     skipped(what) {
         return new ProvenanceResult(exports.PROVENANCE_SKIPPED, `CLAUDE_CODE_SESSION_ID not set — cannot verify ${what} ran (plain terminal / CI). Skipping the provenance check.`, {}, []);
     }
-    // The agentId of a matching subagent run for `agentType` on `branch`, searched across ALL sessions'
+    // The agentId of a matching subagent run for `want.agentType` on `branch`, searched across ALL sessions'
     // subagent dirs (branch-scoped, so a run from a prior session still counts). '' if none. `exclude`
     // skips agentIds already credited to another checklist so one run can't satisfy two.
-    findMatchingAgentId(dirs, agentType, context, exclude = new Set()) {
+    //
+    // Now that every checklist shares ONE agent type, several runs match, so the one that NAMED this
+    // checklist's verdict file wins; the first branch-matching run is the fallback, as before.
+    // eslint-disable-next-line @typescript-eslint/max-params
+    findMatchingAgentId(dirs, want, context, exclude) {
+        let fallback = '';
         for (const dir of dirs) {
             for (const metaFile of this.metaFiles(dir)) {
                 const agentId = this.agentIdOf(metaFile);
-                if (exclude.has(agentId))
-                    continue;
-                const meta = this.readJson(path.join(dir, metaFile));
-                if (!meta || meta['agentType'] !== agentType)
+                if (exclude.has(agentId) || !this.isReviewerRun(dir, metaFile, want.agentType))
                     continue;
-                const spawnDepth = meta['spawnDepth'];
-                if (typeof spawnDepth !== 'number' || spawnDepth < 1)
+                if (!this.sidechainOnBranch(dir, agentId, want.checklistId, context))
                     continue;
-                if (this.sidechainOnBranch(dir, agentId, agentType, context))
+                if (this.namedVerdict(dir, agentId, want.checklistId, context))
                     return agentId;
+                if (fallback === '')
+                    fallback = agentId;
             }
         }
-        return '';
+        return fallback;
+    }
+    // A harness-written meta for a real subagent (spawnDepth >= 1) of the wanted type.
+    isReviewerRun(dir, metaFile, agentType) {
+        const meta = this.readJson(path.join(dir, metaFile));
+        if (!meta || meta['agentType'] !== agentType)
+            return false;
+        const spawnDepth = meta['spawnDepth'];
+        return typeof spawnDepth === 'number' && spawnDepth >= 1;
+    }
+    // Did this run's transcript name the checklist's own verdict path?
+    // eslint-disable-next-line @typescript-eslint/max-params
+    namedVerdict(dir, agentId, checklistId, context) {
+        const verdictPath = context.verdictPaths[checklistId] ?? '';
+        const jsonl = path.join(dir, `agent-${agentId}.jsonl`);
+        if (verdictPath === '' || !fs.existsSync(jsonl))
+            return false;
+        return this.mentions(this.scanTranscript(jsonl).inputs, verdictPath);
     }
     // Every `projects/*/<session>/subagents` dir that exists — matching by the recorded gitBranch (not by
     // session id) is what makes provenance survive across sessions.
@@ -452,7 +502,7 @@ let SubagentProvenanceService = class SubagentProvenanceService {
      * evidence the reviewer cannot inherit and cannot fake by accident: {@link creditedByWhatItTouched}.
      */
     // eslint-disable-next-line @typescript-eslint/max-params
-    sidechainOnBranch(dir, agentId, agentType, context) {
+    sidechainOnBranch(dir, agentId, checklistId, context) {
         const jsonl = path.join(dir, `agent-${agentId}.jsonl`);
         if (!fs.existsSync(jsonl))
             return true;
@@ -473,7 +523,7 @@ let SubagentProvenanceService = class SubagentProvenanceService {
             return true;
         if (want !== '' && this.stripWp(this.branchOfCwd(rec['cwd'])) === want)
             return true;
-        return this.creditedByWhatItTouched(jsonl, agentType, context);
+        return this.creditedByWhatItTouched(jsonl, checklistId, context);
     }
     /**
      * Credit a reviewer for WHAT IT TOUCHED when neither harness-stamped field can settle it.
@@ -494,14 +544,14 @@ let SubagentProvenanceService = class SubagentProvenanceService {
      *      branch, and refusing that would re-open a narrower version of the same unrecoverable deadlock.
      *
      * Independence is NOT weakened by either: `isSidechain === true` and `spawnDepth >= 1` are checked
-     * before we get here (so the main loop's own transcript can never qualify), and `verifyDistinct`
+     * before we get here (so the main loop's own transcript can never qualify), and `verifyReviewers`
      * excludes an agentId already credited to another checklist. It remains non-tamper-proof in exactly
      * the way the class doc already states — forging this now means forging a transcript rather than a
      * meta.json, which is the same bar, not a lower one.
      */
-    creditedByWhatItTouched(jsonl, agentType, context) {
+    creditedByWhatItTouched(jsonl, checklistId, context) {
         const scan = this.scanTranscript(jsonl);
-        const verdictPath = context.verdictPaths[agentType] ?? '';
+        const verdictPath = context.verdictPaths[checklistId] ?? '';
         if (verdictPath !== '' && this.mentions(scan.inputs, verdictPath))
             return true;
         return this.readDiffDir(scan, context);

package/src/subagent-provenance.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-provenance.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/subagent-provenance.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { injectable, bindingScopeValues } from 'inversify';\nimport { toError } from './to-error';\nimport { dotWebpieces } from './state-dir';\n\n// Outcome of a provenance check.\nexport const PROVENANCE_OK = 'ok';           // a matching reviewer subagent demonstrably ran on this branch\nexport const PROVENANCE_MISSING = 'missing'; // session known, but no matching subagent artifact found → refuse (BLOCK)\nexport const PROVENANCE_SKIPPED = 'skipped'; // no CLAUDE_CODE_SESSION_ID (plain terminal / CI) → warn + pass\n\nexport class ProvenanceResult {\n    status: string; // PROVENANCE_OK | PROVENANCE_MISSING | PROVENANCE_SKIPPED\n    detail: string; // human-readable explanation for the warning/error/dashboard\n    // agentIds credited, keyed by agentType, so an evidence pass does not re-scan to find them again.\n    agentIds: Record<string, string>;\n    /**\n     * The agentTypes that could NOT be credited — the FACT, with no remedy attached.\n     *\n     * Structured rather than only spelled into `detail` because the remedy depends on something this\n     * service cannot see: whether that reviewer already wrote a verdict file. \"It never ran\" and \"it ran\n     * and cannot be attributed\" need OPPOSITE instructions — spawn one, versus do not re-spawn, because a\n     * re-spawn overwrites the verdict and is stamped identically. Handing the caller a pre-worded\n     * imperative is what produced the destructive loop this field exists to end; see ProvenanceEnforcer.\n     */\n    missing: string[];\n\n    /**\n     * `agentIds` and `missing` are REQUIRED, with no defaults.\n     *\n     * A default on `missing` is what made the dangerous state cheap to reach: the caller BLOCKS on this\n     * list, so a `PROVENANCE_MISSING` built without it would report unverified and refuse NOTHING — a\n     * silent pass, one forgotten argument away. Required parameters make the omission a compile error at\n     * every construction site, present and future. The remaining `missing: []` on a blocking status is\n     * caught by the caller, which refuses on the STATUS and falls back to `detail`; see\n     * ProvenanceEnforcer.refuse.\n     */\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(status: string, detail: string, agentIds: Record<string, string>, missing: string[]) {\n        this.status = status;\n        this.detail = detail;\n        this.agentIds = agentIds;\n        this.missing = missing;\n    }\n}\n\n/**\n * What ONE credited reviewer actually DID, read from its own transcript. Data-only (per CLAUDE.md).\n *\n * `verifyDistinct` answers \"did a reviewer of this type run?\" — an INTEGRITY question, and it blocks. This\n * answers \"did it look at the change?\" — a QUALITY question, and it only warns. The distinction is\n * deliberate; see {@link SubagentProvenanceService.evidenceFor}.\n */\nexport class ReviewerEvidence {\n    agentType: string;\n    agentId: string;\n    readDiff: boolean;       // opened the materialized diff dir (or its own instructions file)\n    readDoc: boolean;        // opened its checklist's guidance doc\n    /**\n     * Named its own verdict file — `.webpieces/pr-review/<featureSlug>/review-<id>.json` — in a tool input.\n     *\n     * Recorded, not just consumed, because it is the field that answers \"who wrote this verdict?\" for an\n     * auditor reading provenance.json later. It is also a CREDIT channel: see\n     * {@link SubagentProvenanceService.creditedByWhatItTouched}.\n     */\n    wroteVerdict: boolean;\n    toolCallCount: number;\n    offRepoSearches: number; // tool calls that reached into node_modules — the archaeology signal\n    /**\n     * Distinct `message.model` values OBSERVED in the transcript, in first-seen order.\n     *\n     * The model that actually ran, never the one that was configured — and never anything the reviewer\n     * says about itself. A checklist's `.claude/agents/<subagent>.md` declares `model:`, but that is the\n     * REQUESTED value and it can silently disagree with what served the request: a repo was measured\n     * running opus for a reviewer whose agent file said `model: sonnet`. Asking the model instead would\n     * be worse — a model is unreliable about its own identity, naming a family instead of a version or\n     * repeating whatever the system prompt implied, so a self-reported field is usually right and\n     * silently wrong, which is the worst kind of telemetry because it looks authoritative.\n     * `message.model` is written by the harness, so this inherits the anti-forgery property the rest of\n     * this class documents.\n     *\n     * An ARRAY, not a string: one reviewer run can span more than one model (a fallback after a refusal,\n     * a mid-run config change). Collapsing to one value forces a lossy choice at read time; recording\n     * what happened lets the renderer decide.\n     *\n     * Token counts and cost are deliberately NOT here. Prices change, vary by platform and differ under\n     * intro pricing, so a rate table in this package would rot silently — and the question this answers\n     * is \"which model reviewed this?\", not \"what did it cost?\".\n     */\n    models: string[];\n    // Absolute path of the transcript these counters were read out of, '' when it could not be resolved.\n    // Carried out rather than recomputed because a reviewer subagent cannot learn its own transcript path\n    // (the environment exposes the PARENT session id and no agent id), so this is the only place it is\n    // known — see ReviewProvenanceService, which records it as the audit link for the verdict.\n    transcriptPath: string;\n\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(agentType: string, agentId: string, readDiff = false, readDoc = false, toolCallCount = 0, offRepoSearches = 0, transcriptPath = '', models: string[] = [], wroteVerdict = false) {\n        this.agentType = agentType;\n        this.agentId = agentId;\n        this.readDiff = readDiff;\n        this.readDoc = readDoc;\n        this.wroteVerdict = wroteVerdict;\n        this.toolCallCount = toolCallCount;\n        this.offRepoSearches = offRepoSearches;\n        this.transcriptPath = transcriptPath;\n        this.models = models;\n    }\n}\n\n/**\n * One pass over one transcript: the tool inputs AND the models that served it. Data-only.\n *\n * They are gathered together rather than in two passes because they come from the SAME records — the\n * inputs from `message.content[].input`, the model from `message.model` one level up — and a transcript\n * is the largest file this service opens. Two reads of it to answer two questions about the same lines\n * would be the duplicate-work trap the diff materializer documents at length.\n */\nexport class TranscriptScan {\n    inputs: string[];   // every tool_use input, JSON-stringified\n    models: string[];   // distinct message.model values, first-seen order\n\n    constructor(inputs: string[] = [], models: string[] = []) {\n        this.inputs = inputs;\n        this.models = models;\n    }\n}\n\n/**\n * WHERE this branch's review materials live. Data-only.\n *\n * One class for BOTH passes — crediting (`verifyDistinct`) and evidence (`evidenceFor`) — because they\n * ask their questions of the same paths. `diffDir` is the per-branch materialization\n * (`.webpieces/pr-review/<featureSlug>/diff`), which is what makes it usable as PROOF of which branch a\n * reviewer looked at: the path names the branch, it is absolute, and stage ② recreates it per run.\n */\nexport class ReviewerContext {\n    branch: string;\n    diffDir: string;                  // '' when nothing was materialized\n    docPaths: Record<string, string>; // agentType → its checklist doc path ('' when none)\n    /**\n     * agentType → the absolute path of the verdict file THAT checklist must write on THIS branch\n     * (`.webpieces/pr-review/<featureSlug>/review-<id>.json`). '' when unknown.\n     *\n     * The strongest attribution signal available, and stronger than `diffDir`: the path is\n     * worktree-absolute (naming the tree), per-branch (naming the featureSlug) AND per-checklist (naming\n     * the id), so a transcript containing it can only belong to a reviewer that authored that checklist's\n     * verdict for that branch. `diffDir` proves the branch but not the checklist.\n     */\n    verdictPaths: Record<string, string>;\n\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(branch: string, diffDir = '', docPaths: Record<string, string> = {}, verdictPaths: Record<string, string> = {}) {\n        this.branch = branch;\n        this.diffDir = diffDir;\n        this.docPaths = docPaths;\n        this.verdictPaths = verdictPaths;\n    }\n}\n\n/**\n * Verifies — from the Claude Code harness's OWN artifacts, never from anything the model asserts — that\n * a subagent of a given `agentType` actually ran during the current session on the current branch. Used\n * to enforce a checklist's optional `subagent:` field: that an INDEPENDENT reviewer looked, rather than\n * the coding agent self-certifying.\n *\n * The harness writes, beside each subagent transcript:\n *   ~/.claude/projects/<cwd-slug>/<sessionId>/subagents/agent-<id>.meta.json  → { agentType, spawnDepth, … }\n *   ~/.claude/projects/<cwd-slug>/<sessionId>/subagents/agent-<id>.jsonl      → record 0 { isSidechain, gitBranch, … }\n * `agentType`/`spawnDepth`/`isSidechain` are written by Claude Code, not by the model. We locate the dir\n * by the unique sessionId (globbing `projects/&#42;/<sessionId>/subagents`), so the cwd-slug never has to be\n * derived/guessed.\n *\n * IMPORTANT — this is NOT tamper-proof. A determined agent can `cat >` a fake agent-*.meta.json. This\n * raises the bar from \"trust the model's word\" to \"deliberate, auditable forgery outside the repo\"; it\n * is not cryptographic. Say so wherever `subagent:` is documented.\n *\n * `@injectable(bindingScopeValues.Singleton)` so it is drawn in the DI design and injected by type.\n */\n@injectable(bindingScopeValues.Singleton)\nexport class SubagentProvenanceService {\n    // cwd → the branch it is PINNED to ('' when it is not a linked worktree, or is unresolvable).\n    // See branchOfCwd for why it is cached and pinnedBranch for what \"pinned\" buys.\n    private readonly branchByCwd = new Map<string, string>();\n\n    // transcript path → its one scan. The credit pass and the evidence pass ask different questions of\n    // the same (largest) files this service opens, and the credit pass may look at candidates the\n    // evidence pass then re-visits. See scanTranscript for why one pass answers both.\n    private readonly scanByPath = new Map<string, TranscriptScan>();\n\n    // Verify EVERY expected reviewer subagent ran on `context.branch` as a DISTINCT run — the coding agent\n    // may not self-certify, and one reviewer may not stand in for several. SKIPPED (pass) without a\n    // session id.\n    //\n    // Scoped by BRANCH across ALL sessions (not the current session): once a reviewer ran on this branch in\n    // any session, a later re-push in a NEW session still finds it, so the review is NOT forced to re-run.\n    // That is what keeps \"review once per branch\" true across sessions. A PR opened outside the gated flow\n    // still has no review-<id>.json, so wp-finish forces the review regardless of provenance.\n    verifyDistinct(expectedAgentTypes: readonly string[], context: ReviewerContext): ProvenanceResult {\n        if (expectedAgentTypes.length === 0) return new ProvenanceResult(PROVENANCE_OK, 'no reviewer subagents required', {}, []);\n        if (!this.inClaudeSession()) return this.skipped('reviewer subagents');\n        const dirs = this.allSubagentsDirs();\n        const missing: string[] = [];\n        const usedAgentIds = new Set<string>();\n        const credited: Record<string, string> = {};\n        for (const type of expectedAgentTypes) {\n            const agentId = this.findMatchingAgentId(dirs, type, context, usedAgentIds);\n            if (agentId === '') missing.push(type);\n            else {\n                usedAgentIds.add(agentId);\n                credited[type] = agentId;\n            }\n        }\n        return missing.length === 0\n            ? new ProvenanceResult(PROVENANCE_OK, `verified ${expectedAgentTypes.length} distinct reviewer subagent(s) ran`, credited, [])\n            : new ProvenanceResult(PROVENANCE_MISSING,\n                `${missing.length} reviewer subagent(s) could not be attributed to this branch: ${missing.join(', ')}`,\n                credited, missing);\n    }\n\n    /**\n     * What each credited reviewer actually READ, from its own transcript.\n     *\n     * `verifyDistinct` proves a reviewer of the right type RAN. It cannot tell a reviewer that read the diff\n     * and thought about it from one that wrote a verdict having opened nothing. This closes that gap — and\n     * the motivating case is real: one reviewer spent 14 of 26 tool calls grepping `node_modules` because\n     * nothing had told it where anything was, which `offRepoSearches` now makes visible.\n     *\n     * WARNING-ONLY by default, for three reasons, and `requireDiffEvidence` must stay opt-in until at least\n     * one repo has watched it:\n     *   1. The transcript layout is undocumented Claude Code internals. A format change would wedge every\n     *      consumer's PR with no self-service recovery — `sidechainOnBranch` is already lenient for exactly\n     *      this reason, and blocking on a richer read of the same files would be less safe, not more.\n     *   2. A reviewer can legitimately receive the diff another way (inlined into its prompt, say).\n     *   3. verifyDistinct is the INTEGRITY signal and rightly blocks; this is a QUALITY signal. Conflating\n     *      them would let a transcript-parsing quirk refuse a PR that a real reviewer really did review.\n     *\n     * Returns [] outside a Claude Code session, matching verifyDistinct's SKIP behavior.\n     */\n    evidenceFor(context: ReviewerContext, agentIds: Record<string, string>): ReviewerEvidence[] {\n        if (!this.inClaudeSession()) return [];\n        const dirs = this.allSubagentsDirs();\n        const out: ReviewerEvidence[] = [];\n        for (const agentType of Object.keys(agentIds)) {\n            const agentId = agentIds[agentType];\n            const jsonl = this.transcriptPath(dirs, agentId);\n            if (jsonl === '') {\n                out.push(new ReviewerEvidence(agentType, agentId));\n                continue;\n            }\n            out.push(this.evidenceFromTranscript(agentType, agentId, jsonl, context));\n        }\n        return out;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/max-params\n    private evidenceFromTranscript(agentType: string, agentId: string, jsonl: string, context: ReviewerContext): ReviewerEvidence {\n        const scan = this.scanTranscript(jsonl);\n        const inputs = scan.inputs;\n        const docPath = context.docPaths[agentType] ?? '';\n        const verdictPath = context.verdictPaths[agentType] ?? '';\n        return new ReviewerEvidence(\n            agentType, agentId, this.readDiffDir(scan, context),\n            docPath !== '' && this.mentions(inputs, docPath),\n            inputs.length,\n            inputs.filter((i: string): boolean => i.includes('node_modules')).length,\n            jsonl,\n            scan.models,\n            verdictPath !== '' && this.mentions(inputs, verdictPath),\n        );\n    }\n\n    // The instructions file counts as \"read the diff\": it lives in the same per-branch dir, it is what\n    // the reviewer is told to open first, and it inlines the diff paths. A reviewer that opened it and\n    // then its own diff files is the intended path; treating only the diff dir as proof would flag it.\n    private readDiffDir(scan: TranscriptScan, context: ReviewerContext): boolean {\n        return context.diffDir !== '' && this.mentions(scan.inputs, context.diffDir);\n    }\n\n    /**\n     * Record this line's `message.model`, deduped, in first-seen order.\n     *\n     * `<synthetic>` records are SKIPPED. The harness writes them for messages no model produced (tool\n     * results, injected notices); counting one would put a non-model in a field whose entire purpose is\n     * \"which model reviewed this\", and it would show up on every single reviewer.\n     */\n    // webpieces-disable no-any-unknown -- opaque transcript record, only `model` is read and it is type-guarded below\n    private collectModel(message: Record<string, unknown>, models: string[]): void {\n        const model = message['model'];\n        if (typeof model !== 'string' || model === '' || model === '<synthetic>') return;\n        if (!models.includes(model)) models.push(model);\n    }\n\n    // The absolute path of agent-<id>.jsonl across all session dirs, or '' if it is not there.\n    private transcriptPath(dirs: readonly string[], agentId: string): string {\n        for (const dir of dirs) {\n            const candidate = path.join(dir, `agent-${agentId}.jsonl`);\n            if (fs.existsSync(candidate)) return candidate;\n        }\n        return '';\n    }\n\n    /**\n     * ONE pass over the transcript for both answers (see {@link TranscriptScan}), CACHED per path.\n     *\n     * Cached because two passes now ask questions of the same file: crediting (does it name this branch's\n     * verdict/diff?) and evidence (what did it read, which model served it?). Without the cache the credit\n     * pass would re-read every candidate the evidence pass then re-opens — on the largest files this\n     * service touches, on the path that opens a PR.\n     *\n     * Tool inputs are JSON-stringified rather than walked field-by-field because the shape differs per\n     * tool (Read takes file_path, Bash takes command, Grep takes path) and a substring test over the\n     * serialized input is both simpler and robust to a tool we have not seen.\n     *\n     * Best-effort, like everything else that parses this file: a format change must never wedge the\n     * gate, so an unreadable transcript yields empty rather than throwing. That matters more for the\n     * models than for the counters — this is quality telemetry, not an integrity check, and a missing\n     * `model` field must not be able to block a PR.\n     */\n    private scanTranscript(jsonl: string): TranscriptScan {\n        const cached = this.scanByPath.get(jsonl);\n        if (cached !== undefined) return cached;\n        const scan = this.readTranscript(jsonl);\n        this.scanByPath.set(jsonl, scan);\n        return scan;\n    }\n\n    private readTranscript(jsonl: string): TranscriptScan {\n        const scan = new TranscriptScan();\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: an unreadable transcript yields no evidence, never a crash\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            for (const line of fs.readFileSync(jsonl, 'utf8').split('\\n')) {\n                if (line.trim() === '') continue;\n                const rec = this.parseLine(line);\n                const message = rec?.['message'];\n                if (typeof message !== 'object' || message === null) continue;\n                // webpieces-disable no-any-unknown -- opaque transcript record, narrowed by the guard above\n                const msg = message as Record<string, unknown>;\n                this.collectModel(msg, scan.models);\n                const content = msg['content'];\n                if (!Array.isArray(content)) continue;\n                for (const block of content) {\n                    // webpieces-disable no-any-unknown -- opaque content block, only `type`/`input` are read\n                    const b = block as Record<string, unknown>;\n                    if (b['type'] === 'tool_use') scan.inputs.push(JSON.stringify(b['input'] ?? {}));\n                }\n            }\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n        }\n        return scan;\n    }\n\n    private mentions(inputs: readonly string[], needle: string): boolean {\n        return inputs.some((i: string): boolean => i.includes(needle));\n    }\n\n    // Are we running under Claude Code at all? (CI / plain terminal → provenance is unverifiable → SKIP.)\n    private inClaudeSession(): boolean {\n        return (process.env['CLAUDE_CODE_SESSION_ID'] ?? '').trim() !== '';\n    }\n\n    private skipped(what: string): ProvenanceResult {\n        return new ProvenanceResult(PROVENANCE_SKIPPED,\n            `CLAUDE_CODE_SESSION_ID not set — cannot verify ${what} ran (plain terminal / CI). Skipping the provenance check.`,\n            {}, []);\n    }\n\n    // The agentId of a matching subagent run for `agentType` on `branch`, searched across ALL sessions'\n    // subagent dirs (branch-scoped, so a run from a prior session still counts). '' if none. `exclude`\n    // skips agentIds already credited to another checklist so one run can't satisfy two.\n    private findMatchingAgentId(dirs: readonly string[], agentType: string, context: ReviewerContext, exclude: ReadonlySet<string> = new Set()): string {\n        for (const dir of dirs) {\n            for (const metaFile of this.metaFiles(dir)) {\n                const agentId = this.agentIdOf(metaFile);\n                if (exclude.has(agentId)) continue;\n                const meta = this.readJson(path.join(dir, metaFile));\n                if (!meta || meta['agentType'] !== agentType) continue;\n                const spawnDepth = meta['spawnDepth'];\n                if (typeof spawnDepth !== 'number' || spawnDepth < 1) continue;\n                if (this.sidechainOnBranch(dir, agentId, agentType, context)) return agentId;\n            }\n        }\n        return '';\n    }\n\n    // Every `projects/*/<session>/subagents` dir that exists — matching by the recorded gitBranch (not by\n    // session id) is what makes provenance survive across sessions.\n    private allSubagentsDirs(): string[] {\n        const projects = path.join(os.homedir(), '.claude', 'projects');\n        if (!fs.existsSync(projects)) return [];\n        const out: string[] = [];\n        for (const proj of this.readDir(projects)) {\n            const projDir = path.join(projects, proj);\n            for (const session of this.readDir(projDir)) {\n                const candidate = path.join(projDir, session, 'subagents');\n                if (fs.existsSync(candidate)) out.push(candidate);\n            }\n        }\n        return out;\n    }\n\n    private metaFiles(dir: string): string[] {\n        return this.readDir(dir).filter((f: string): boolean => f.endsWith('.meta.json'));\n    }\n\n    // agent-<id>.meta.json → <id>\n    private agentIdOf(metaFile: string): string {\n        return metaFile.replace(/^agent-/, '').replace(/\\.meta\\.json$/, '');\n    }\n\n    /**\n     * Cross-check the sibling transcript's record 0: isSidechain true (a real subagent, not the main\n     * loop) and the same branch. Lenient on branch drift (a leftover …wpN suffix from a mid-flight\n     * branch rename) and on a missing jsonl (meta already matched — accept, best-effort).\n     *\n     * WHEN `gitBranch` DISAGREES, A PINNED `cwd` DECIDES. Record 0 carries both fields, and the harness\n     * can write a `gitBranch` that CONTRADICTS the record's own `cwd`: a reviewer subagent spawned into\n     * a worktree on `dean/one-2406-…` was stamped `worktree-agent-a54887200e40eb956` — an unrelated,\n     * still-live worktree's scaffold branch — deterministically, on four consecutive attempts, blocking\n     * a PR whose required reviewer genuinely ran and genuinely passed. `stripWp` cannot bridge that, so\n     * the reviewer was never credited and `wp-finish-upsert-pr` refused a legitimately-reviewed PR with\n     * no in-flow recovery. A sweep of 961 record-0s on one machine found the mis-stamp is the MAJORITY\n     * case among subagents in dedicated worktrees, so trusting `gitBranch` alone can never be correct.\n     *\n     * ─── Why ONLY a linked worktree, and never the primary clone ──────────────────────────────────\n     * \"Ask git what branch the cwd is on\" is correct only when that cwd CANNOT have moved since the\n     * reviewer ran. A LINKED WORKTREE is 1:1 with the agent that owns it and nothing re-checks it out;\n     * the PRIMARY CLONE gets checked out constantly. Falling back on a primary-clone cwd would credit a\n     * STALE reviewer, and by construction rather than by accident:\n     *\n     *   1. a reviewer runs in the primary clone while it is on branch A\n     *   2. the clone is later checked out to branch B\n     *   3. `wp-finish-upsert-pr` runs on B — `gitBranch` (stamped A) mismatches\n     *   4. `git -C <clone>` now answers B, because the CLONE moved → the reviewer is credited for B\n     *\n     * It reviewed A. Every past reviewer run in that clone would be credited for whatever branch is\n     * checked out at finish time — which in a repo with a required reviewer on every PR is not an\n     * exotic sequence, it is the normal one. So the fallback is gated on `dotWebpieces.isLinkedWorktree`\n     * (git's own `--git-dir != --git-common-dir` test, reused rather than re-derived), and a primary\n     * clone falls through to a refusal exactly as it does today.\n     *\n     * That gate keeps the anti-forgery property intact: `cwd` is harness-written in the same record by\n     * the same writer as `gitBranch`, so it carries the same weight — and inside a pinned worktree it is\n     * the field that is CORRECT. There is deliberately no config flag and no second comparison mode:\n     * ONE rule, with `gitBranch` only ever a cheap way to skip the subprocess when it already agrees.\n     *\n     * An UNRESOLVABLE cwd does not credit either. A reaped worktree, a deleted directory, a non-repo\n     * path or a detached HEAD yields '' and falls through to a refusal. Leniency here is bounded by\n     * \"git can still prove it\", never by \"we could not check, so assume yes\".\n     *\n     * ─── Why neither field can settle it from a PRIMARY CLONE, and what does ──────────────────────\n     * Both fields above are stamped from the SPAWNING session's cwd — the Agent tool has no cwd\n     * parameter, so a subagent inherits its parent's. A session rooted in the primary clone that spawns\n     * a reviewer for a WORKTREE branch therefore produces `gitBranch` = the clone's branch (mismatch)\n     * and `cwd` = the clone (gated off, correctly) — and NO respawn can change either stamp. That is not\n     * an exotic setup: it is what the flow instructs the moment a worker agent dies mid-flow and the\n     * top-level session has to take over, and it deadlocked a branch whose seven reviewers had all run.\n     *\n     * So the third channel is not a loosening of the cwd rule — it is a DIFFERENT question, asked of\n     * evidence the reviewer cannot inherit and cannot fake by accident: {@link creditedByWhatItTouched}.\n     */\n    // eslint-disable-next-line @typescript-eslint/max-params\n    private sidechainOnBranch(dir: string, agentId: string, agentType: string, context: ReviewerContext): boolean {\n        const jsonl = path.join(dir, `agent-${agentId}.jsonl`);\n        if (!fs.existsSync(jsonl)) return true;\n        const first = this.firstNonEmptyLine(jsonl);\n        if (first === '') return true;\n        const rec = this.parseLine(first);\n        if (!rec) return true;\n        if (rec['isSidechain'] !== true) return false;\n        const gitBranch = rec['gitBranch'];\n        // Not recorded at all → accept, as before: nothing to contradict and nothing to verify against.\n        if (typeof gitBranch !== 'string' || gitBranch === '') return true;\n        const want = this.stripWp(context.branch);\n        if (this.stripWp(gitBranch) === want) return true;\n        if (want !== '' && this.stripWp(this.branchOfCwd(rec['cwd'])) === want) return true;\n        return this.creditedByWhatItTouched(jsonl, agentType, context);\n    }\n\n    /**\n     * Credit a reviewer for WHAT IT TOUCHED when neither harness-stamped field can settle it.\n     *\n     * Both paths compared here are ABSOLUTE and BRANCH-SPECIFIC — they live under\n     * `<worktree>/.webpieces/pr-review/<featureSlug>/`, so the string names the tree AND the branch. A\n     * reviewer that worked on a different branch cannot have them in its transcript, and a reviewer of\n     * this branch that ran from a mis-stamped cwd cannot avoid having them. That is the property\n     * `gitBranch` lacks — this file's own sweep of 961 record-0s found the mis-stamp is the MAJORITY\n     * case among subagents in dedicated worktrees.\n     *\n     * Two channels, either sufficient:\n     *   1. it WROTE this checklist's verdict file — proves branch AND checklist, and is the act the whole\n     *      gate is trying to attribute. Matched as a substring of any tool input, so a Write, an Edit and\n     *      a `cat > <path>` heredoc all count; the point is that the path was named, not which tool named it.\n     *   2. it READ this branch's materialized diff dir — proves the branch. Kept as a second channel\n     *      because a reviewer whose verdict was relayed by its parent still demonstrably reviewed this\n     *      branch, and refusing that would re-open a narrower version of the same unrecoverable deadlock.\n     *\n     * Independence is NOT weakened by either: `isSidechain === true` and `spawnDepth >= 1` are checked\n     * before we get here (so the main loop's own transcript can never qualify), and `verifyDistinct`\n     * excludes an agentId already credited to another checklist. It remains non-tamper-proof in exactly\n     * the way the class doc already states — forging this now means forging a transcript rather than a\n     * meta.json, which is the same bar, not a lower one.\n     */\n    private creditedByWhatItTouched(jsonl: string, agentType: string, context: ReviewerContext): boolean {\n        const scan = this.scanTranscript(jsonl);\n        const verdictPath = context.verdictPaths[agentType] ?? '';\n        if (verdictPath !== '' && this.mentions(scan.inputs, verdictPath)) return true;\n        return this.readDiffDir(scan, context);\n    }\n\n    /**\n     * The branch record-0's own `cwd` is PINNED to, '' when that cannot be established or is not pinned.\n     *\n     * Cached per cwd because `findMatchingAgentId` walks every subagent of every session on the machine\n     * and several of them share a worktree — one `git` process per RECORD would put dozens of spawns on\n     * the path that opens a PR.\n     */\n    // webpieces-disable no-any-unknown -- one opaque record field, type-guarded on the next line\n    private branchOfCwd(cwd: unknown): string {\n        if (typeof cwd !== 'string' || cwd === '') return '';\n        const cached = this.branchByCwd.get(cwd);\n        if (cached !== undefined) return cached;\n        const resolved = this.pinnedBranch(cwd);\n        this.branchByCwd.set(cwd, resolved);\n        return resolved;\n    }\n\n    /**\n     * The branch of `cwd` when — and only when — `cwd` is a LINKED WORKTREE. '' otherwise.\n     *\n     * '' for the primary clone (it moves; see sidechainOnBranch for the false-accept that closes), for a\n     * reaped or deleted directory, for a non-repo path, when git is unavailable, and for a detached HEAD,\n     * which `--abbrev-ref` prints as the literal `HEAD` and which names no branch.\n     */\n    private pinnedBranch(cwd: string): string {\n        if (!fs.existsSync(cwd)) return '';\n        if (!dotWebpieces.isLinkedWorktree(cwd)) return '';\n        const result = spawnSync('git', ['-C', cwd, 'rev-parse', '--abbrev-ref', 'HEAD'], { encoding: 'utf8' });\n        if (result.status !== 0) return '';\n        const printed = (result.stdout ?? '').trim();\n        return printed === 'HEAD' ? '' : printed;\n    }\n\n    private stripWp(branch: string): string {\n        return branch.replace(/-?wp\\d+$/i, '');\n    }\n\n    private readDir(dir: string): string[] {\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: an unreadable dir yields [] (best-effort provenance)\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            return fs.readdirSync(dir);\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n            return [];\n        }\n    }\n\n    private firstNonEmptyLine(filePath: string): string {\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: unreadable transcript → '' (best-effort)\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            for (const line of fs.readFileSync(filePath, 'utf8').split('\\n')) {\n                if (line.trim() !== '') return line;\n            }\n            return '';\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n            return '';\n        }\n    }\n\n    // webpieces-disable no-any-unknown -- opaque parsed JSON object, keys read by the caller\n    private readJson(filePath: string): Record<string, unknown> | null {\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: malformed meta.json → null (skipped)\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            // webpieces-disable no-any-unknown -- parsed JSON is opaque until narrowed by the caller\n            return JSON.parse(fs.readFileSync(filePath, 'utf8')) as Record<string, unknown>;\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n            return null;\n        }\n    }\n\n    // webpieces-disable no-any-unknown -- one opaque JSONL record, keys read by the caller\n    private parseLine(line: string): Record<string, unknown> | null {\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: malformed JSONL record → null\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            // webpieces-disable no-any-unknown -- parsed JSON is opaque until narrowed by the caller\n            return JSON.parse(line) as Record<string, unknown>;\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n            return null;\n        }\n    }\n}\n"]}
+{"version":3,"file":"subagent-provenance.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/subagent-provenance.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { injectable, bindingScopeValues } from 'inversify';\nimport { toError } from './to-error';\nimport { dotWebpieces } from './state-dir';\n\n// Outcome of a provenance check.\nexport const PROVENANCE_OK = 'ok';           // a matching reviewer subagent demonstrably ran on this branch\nexport const PROVENANCE_MISSING = 'missing'; // session known, but no matching subagent artifact found → refuse (BLOCK)\nexport const PROVENANCE_SKIPPED = 'skipped'; // no CLAUDE_CODE_SESSION_ID (plain terminal / CI) → warn + pass\n\nexport class ProvenanceResult {\n    status: string; // PROVENANCE_OK | PROVENANCE_MISSING | PROVENANCE_SKIPPED\n    detail: string; // human-readable explanation for the warning/error/dashboard\n    // agentIds credited, keyed by CHECKLIST ID, so an evidence pass does not re-scan to find them again. Two\n    // checklists may map to the same agentId when `reviewerAgents` let one subagent cover both.\n    agentIds: Record<string, string>;\n    /**\n     * The checklist ids that could NOT be credited — the FACT, with no remedy attached.\n     *\n     * Structured rather than only spelled into `detail` because the remedy depends on something this\n     * service cannot see: whether that reviewer already wrote a verdict file. \"It never ran\" and \"it ran\n     * and cannot be attributed\" need OPPOSITE instructions — spawn one, versus do not re-spawn, because a\n     * re-spawn overwrites the verdict and is stamped identically. Handing the caller a pre-worded\n     * imperative is what produced the destructive loop this field exists to end; see ProvenanceEnforcer.\n     */\n    missing: string[];\n\n    /**\n     * `agentIds` and `missing` are REQUIRED, with no defaults.\n     *\n     * A default on `missing` is what made the dangerous state cheap to reach: the caller BLOCKS on this\n     * list, so a `PROVENANCE_MISSING` built without it would report unverified and refuse NOTHING — a\n     * silent pass, one forgotten argument away. Required parameters make the omission a compile error at\n     * every construction site, present and future. The remaining `missing: []` on a blocking status is\n     * caught by the caller, which refuses on the STATUS and falls back to `detail`; see\n     * ProvenanceEnforcer.refuse.\n     */\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(status: string, detail: string, agentIds: Record<string, string>, missing: string[]) {\n        this.status = status;\n        this.detail = detail;\n        this.agentIds = agentIds;\n        this.missing = missing;\n    }\n}\n\n/**\n * What ONE credited reviewer actually DID, read from its own transcript. Data-only (per CLAUDE.md).\n *\n * `verifyReviewers` answers \"did a reviewer of this type run?\" — an INTEGRITY question, and it blocks. This\n * answers \"did it look at the change?\" — a QUALITY question, and it only warns. The distinction is\n * deliberate; see {@link SubagentProvenanceService.evidenceFor}.\n */\nexport class ReviewerEvidence {\n    checklistId: string;     // the checklist this evidence is FOR (one subagent may appear under several)\n    agentType: string;\n    agentId: string;\n    readDiff: boolean;       // opened the materialized diff dir (or its own instructions file)\n    readDoc: boolean;        // opened its checklist's guidance doc\n    /**\n     * Named its own verdict file — `.webpieces/pr-review/<featureSlug>/review-<id>.json` — in a tool input.\n     *\n     * Recorded, not just consumed, because it is the field that answers \"who wrote this verdict?\" for an\n     * auditor reading provenance.json later. It is also a CREDIT channel: see\n     * {@link SubagentProvenanceService.creditedByWhatItTouched}.\n     */\n    wroteVerdict: boolean;\n    toolCallCount: number;\n    offRepoSearches: number; // tool calls that reached into node_modules — the archaeology signal\n    /**\n     * Distinct `message.model` values OBSERVED in the transcript, in first-seen order.\n     *\n     * The model that actually ran, never the one that was configured — and never anything the reviewer\n     * says about itself. The reviewer agent's `.claude/agents/<name>.md` may declare `model:`, but that is the\n     * REQUESTED value and it can silently disagree with what served the request: a repo was measured\n     * running opus for a reviewer whose agent file said `model: sonnet`. Asking the model instead would\n     * be worse — a model is unreliable about its own identity, naming a family instead of a version or\n     * repeating whatever the system prompt implied, so a self-reported field is usually right and\n     * silently wrong, which is the worst kind of telemetry because it looks authoritative.\n     * `message.model` is written by the harness, so this inherits the anti-forgery property the rest of\n     * this class documents.\n     *\n     * An ARRAY, not a string: one reviewer run can span more than one model (a fallback after a refusal,\n     * a mid-run config change). Collapsing to one value forces a lossy choice at read time; recording\n     * what happened lets the renderer decide.\n     *\n     * Token counts and cost are deliberately NOT here. Prices change, vary by platform and differ under\n     * intro pricing, so a rate table in this package would rot silently — and the question this answers\n     * is \"which model reviewed this?\", not \"what did it cost?\".\n     */\n    models: string[];\n    // Absolute path of the transcript these counters were read out of, '' when it could not be resolved.\n    // Carried out rather than recomputed because a reviewer subagent cannot learn its own transcript path\n    // (the environment exposes the PARENT session id and no agent id), so this is the only place it is\n    // known — see ReviewProvenanceService, which records it as the audit link for the verdict.\n    transcriptPath: string;\n\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(checklistId: string, agentType: string, agentId: string, readDiff = false, readDoc = false, toolCallCount = 0, offRepoSearches = 0, transcriptPath = '', models: string[] = [], wroteVerdict = false) {\n        this.checklistId = checklistId;\n        this.agentType = agentType;\n        this.agentId = agentId;\n        this.readDiff = readDiff;\n        this.readDoc = readDoc;\n        this.wroteVerdict = wroteVerdict;\n        this.toolCallCount = toolCallCount;\n        this.offRepoSearches = offRepoSearches;\n        this.transcriptPath = transcriptPath;\n        this.models = models;\n    }\n}\n\n/**\n * One pass over one transcript: the tool inputs AND the models that served it. Data-only.\n *\n * They are gathered together rather than in two passes because they come from the SAME records — the\n * inputs from `message.content[].input`, the model from `message.model` one level up — and a transcript\n * is the largest file this service opens. Two reads of it to answer two questions about the same lines\n * would be the duplicate-work trap the diff materializer documents at length.\n */\nexport class TranscriptScan {\n    inputs: string[];   // every tool_use input, JSON-stringified\n    models: string[];   // distinct message.model values, first-seen order\n\n    constructor(inputs: string[] = [], models: string[] = []) {\n        this.inputs = inputs;\n        this.models = models;\n    }\n}\n\n/**\n * WHERE this branch's review materials live. Data-only.\n *\n * One class for BOTH passes — crediting (`verifyReviewers`) and evidence (`evidenceFor`) — because they\n * ask their questions of the same paths. `diffDir` is the per-branch materialization\n * (`.webpieces/pr-review/<featureSlug>/diff`), which is what makes it usable as PROOF of which branch a\n * reviewer looked at: the path names the branch, it is absolute, and stage ② recreates it per run.\n */\nexport class ReviewerContext {\n    branch: string;\n    diffDir: string;                  // '' when nothing was materialized\n    docPaths: Record<string, string>; // checklist id → its checklist doc path ('' when none)\n    /**\n     * checklist id → the absolute path of the verdict file THAT checklist must write on THIS branch\n     * (`.webpieces/pr-review/<featureSlug>/review-<id>.json`). '' when unknown.\n     *\n     * The strongest attribution signal available, and stronger than `diffDir`: the path is\n     * worktree-absolute (naming the tree), per-branch (naming the featureSlug) AND per-checklist (naming\n     * the id), so a transcript containing it can only belong to a reviewer that authored that checklist's\n     * verdict for that branch. `diffDir` proves the branch but not the checklist.\n     */\n    verdictPaths: Record<string, string>;\n\n    // eslint-disable-next-line @typescript-eslint/max-params\n    constructor(branch: string, diffDir = '', docPaths: Record<string, string> = {}, verdictPaths: Record<string, string> = {}) {\n        this.branch = branch;\n        this.diffDir = diffDir;\n        this.docPaths = docPaths;\n        this.verdictPaths = verdictPaths;\n    }\n}\n\n/**\n * One checklist that must be credited to a reviewer run, and the agent type that run must carry. Data-only.\n *\n * The two used to be one string — a checklist's id WAS its agent type — and provenance keyed everything by\n * it. Now every checklist is reviewed by the same repo-wide agent type, so the id and the type are\n * separate facts and a run is matched on the type but credited to the id.\n */\nexport class ExpectedReviewer {\n    checklistId: string;\n    agentType: string;\n\n    constructor(checklistId: string, agentType: string) {\n        this.checklistId = checklistId;\n        this.agentType = agentType;\n    }\n}\n\n/**\n * Verifies — from the Claude Code harness's OWN artifacts, never from anything the model asserts — that\n * a subagent of a given `agentType` actually ran during the current session on the current branch. Used\n * to enforce that every checklist was reviewed by a `reviewerAgentName` subagent: that an INDEPENDENT\n * reviewer looked, rather than the coding agent self-certifying.\n *\n * The harness writes, beside each subagent transcript:\n *   ~/.claude/projects/<cwd-slug>/<sessionId>/subagents/agent-<id>.meta.json  → { agentType, spawnDepth, … }\n *   ~/.claude/projects/<cwd-slug>/<sessionId>/subagents/agent-<id>.jsonl      → record 0 { isSidechain, gitBranch, … }\n * `agentType`/`spawnDepth`/`isSidechain` are written by Claude Code, not by the model. We locate the dir\n * by the unique sessionId (globbing `projects/&#42;/<sessionId>/subagents`), so the cwd-slug never has to be\n * derived/guessed.\n *\n * IMPORTANT — this is NOT tamper-proof. A determined agent can `cat >` a fake agent-*.meta.json. This\n * raises the bar from \"trust the model's word\" to \"deliberate, auditable forgery outside the repo\"; it\n * is not cryptographic. Say so wherever reviewer provenance is documented.\n *\n * `@injectable(bindingScopeValues.Singleton)` so it is drawn in the DI design and injected by type.\n */\n@injectable(bindingScopeValues.Singleton)\nexport class SubagentProvenanceService {\n    // cwd → the branch it is PINNED to ('' when it is not a linked worktree, or is unresolvable).\n    // See branchOfCwd for why it is cached and pinnedBranch for what \"pinned\" buys.\n    private readonly branchByCwd = new Map<string, string>();\n\n    // transcript path → its one scan. The credit pass and the evidence pass ask different questions of\n    // the same (largest) files this service opens, and the credit pass may look at candidates the\n    // evidence pass then re-visits. See scanTranscript for why one pass answers both.\n    private readonly scanByPath = new Map<string, TranscriptScan>();\n\n    // Verify EVERY expected checklist was reviewed by a reviewer subagent that ran on `context.branch` — the\n    // coding agent may not self-certify. SKIPPED (pass) without a session id.\n    //\n    // `sharedRuns` false (no `reviewerAgents` configured): each checklist needs a DISTINCT run, so one\n    // reviewer may not stand in for several. `sharedRuns` true (`reviewerAgents` set): one run may cover\n    // several checklists, because that grouping is exactly what the repo asked for; a run is still only\n    // credited when it is a real subagent of the right type on this branch.\n    //\n    // Either way a run that NAMED this checklist's verdict file is preferred over one that merely ran on the\n    // branch, so each checklist is credited to the reviewer that actually wrote it whenever that is knowable.\n    //\n    // Scoped by BRANCH across ALL sessions (not the current session): once a reviewer ran on this branch in\n    // any session, a later re-push in a NEW session still finds it, so the review is NOT forced to re-run.\n    // That is what keeps \"review once per branch\" true across sessions. A PR opened outside the gated flow\n    // still has no review-<id>.json, so wp-finish forces the review regardless of provenance.\n    verifyReviewers(expected: readonly ExpectedReviewer[], context: ReviewerContext, sharedRuns: boolean): ProvenanceResult {\n        if (expected.length === 0) return new ProvenanceResult(PROVENANCE_OK, 'no reviewer subagents required', {}, []);\n        if (!this.inClaudeSession()) return this.skipped('reviewer subagents');\n        const dirs = this.allSubagentsDirs();\n        const missing: string[] = [];\n        const usedAgentIds = new Set<string>();\n        const credited: Record<string, string> = {};\n        for (const want of expected) {\n            const exclude = sharedRuns ? new Set<string>() : usedAgentIds;\n            const agentId = this.findMatchingAgentId(dirs, want, context, exclude);\n            if (agentId === '') missing.push(want.checklistId);\n            else {\n                usedAgentIds.add(agentId);\n                credited[want.checklistId] = agentId;\n            }\n        }\n        const runs = new Set(Object.values(credited)).size;\n        return missing.length === 0\n            ? new ProvenanceResult(PROVENANCE_OK,\n                `verified ${expected.length} checklist(s) were reviewed by ${runs} reviewer subagent run(s)`, credited, [])\n            : new ProvenanceResult(PROVENANCE_MISSING,\n                `${missing.length} checklist(s) could not be attributed to a reviewer subagent on this branch: ${missing.join(', ')}`,\n                credited, missing);\n    }\n\n    /**\n     * What each credited reviewer actually READ, from its own transcript.\n     *\n     * `verifyReviewers` proves a reviewer of the right type RAN. It cannot tell a reviewer that read the diff\n     * and thought about it from one that wrote a verdict having opened nothing. This closes that gap — and\n     * the motivating case is real: one reviewer spent 14 of 26 tool calls grepping `node_modules` because\n     * nothing had told it where anything was, which `offRepoSearches` now makes visible.\n     *\n     * WARNING-ONLY by default, for three reasons, and `requireDiffEvidence` must stay opt-in until at least\n     * one repo has watched it:\n     *   1. The transcript layout is undocumented Claude Code internals. A format change would wedge every\n     *      consumer's PR with no self-service recovery — `sidechainOnBranch` is already lenient for exactly\n     *      this reason, and blocking on a richer read of the same files would be less safe, not more.\n     *   2. A reviewer can legitimately receive the diff another way (inlined into its prompt, say).\n     *   3. verifyReviewers is the INTEGRITY signal and rightly blocks; this is a QUALITY signal. Conflating\n     *      them would let a transcript-parsing quirk refuse a PR that a real reviewer really did review.\n     *\n     * Returns [] outside a Claude Code session, matching verifyReviewers's SKIP behavior.\n     */\n    evidenceFor(context: ReviewerContext, expected: readonly ExpectedReviewer[], agentIds: Record<string, string>): ReviewerEvidence[] {\n        if (!this.inClaudeSession()) return [];\n        const dirs = this.allSubagentsDirs();\n        const out: ReviewerEvidence[] = [];\n        for (const want of expected) {\n            const agentId = agentIds[want.checklistId];\n            if (agentId === undefined) continue;\n            const jsonl = this.transcriptPath(dirs, agentId);\n            if (jsonl === '') {\n                out.push(new ReviewerEvidence(want.checklistId, want.agentType, agentId));\n                continue;\n            }\n            out.push(this.evidenceFromTranscript(want, agentId, jsonl, context));\n        }\n        return out;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/max-params\n    private evidenceFromTranscript(want: ExpectedReviewer, agentId: string, jsonl: string, context: ReviewerContext): ReviewerEvidence {\n        const scan = this.scanTranscript(jsonl);\n        const inputs = scan.inputs;\n        const docPath = context.docPaths[want.checklistId] ?? '';\n        const verdictPath = context.verdictPaths[want.checklistId] ?? '';\n        return new ReviewerEvidence(\n            want.checklistId, want.agentType, agentId, this.readDiffDir(scan, context),\n            docPath !== '' && this.mentions(inputs, docPath),\n            inputs.length,\n            inputs.filter((i: string): boolean => i.includes('node_modules')).length,\n            jsonl,\n            scan.models,\n            verdictPath !== '' && this.mentions(inputs, verdictPath),\n        );\n    }\n\n    // The instructions file counts as \"read the diff\": it lives in the same per-branch dir, it is what\n    // the reviewer is told to open first, and it inlines the diff paths. A reviewer that opened it and\n    // then its own diff files is the intended path; treating only the diff dir as proof would flag it.\n    private readDiffDir(scan: TranscriptScan, context: ReviewerContext): boolean {\n        return context.diffDir !== '' && this.mentions(scan.inputs, context.diffDir);\n    }\n\n    /**\n     * Record this line's `message.model`, deduped, in first-seen order.\n     *\n     * `<synthetic>` records are SKIPPED. The harness writes them for messages no model produced (tool\n     * results, injected notices); counting one would put a non-model in a field whose entire purpose is\n     * \"which model reviewed this\", and it would show up on every single reviewer.\n     */\n    // webpieces-disable no-any-unknown -- opaque transcript record, only `model` is read and it is type-guarded below\n    private collectModel(message: Record<string, unknown>, models: string[]): void {\n        const model = message['model'];\n        if (typeof model !== 'string' || model === '' || model === '<synthetic>') return;\n        if (!models.includes(model)) models.push(model);\n    }\n\n    // The absolute path of agent-<id>.jsonl across all session dirs, or '' if it is not there.\n    private transcriptPath(dirs: readonly string[], agentId: string): string {\n        for (const dir of dirs) {\n            const candidate = path.join(dir, `agent-${agentId}.jsonl`);\n            if (fs.existsSync(candidate)) return candidate;\n        }\n        return '';\n    }\n\n    /**\n     * ONE pass over the transcript for both answers (see {@link TranscriptScan}), CACHED per path.\n     *\n     * Cached because two passes now ask questions of the same file: crediting (does it name this branch's\n     * verdict/diff?) and evidence (what did it read, which model served it?). Without the cache the credit\n     * pass would re-read every candidate the evidence pass then re-opens — on the largest files this\n     * service touches, on the path that opens a PR.\n     *\n     * Tool inputs are JSON-stringified rather than walked field-by-field because the shape differs per\n     * tool (Read takes file_path, Bash takes command, Grep takes path) and a substring test over the\n     * serialized input is both simpler and robust to a tool we have not seen.\n     *\n     * Best-effort, like everything else that parses this file: a format change must never wedge the\n     * gate, so an unreadable transcript yields empty rather than throwing. That matters more for the\n     * models than for the counters — this is quality telemetry, not an integrity check, and a missing\n     * `model` field must not be able to block a PR.\n     */\n    private scanTranscript(jsonl: string): TranscriptScan {\n        const cached = this.scanByPath.get(jsonl);\n        if (cached !== undefined) return cached;\n        const scan = this.readTranscript(jsonl);\n        this.scanByPath.set(jsonl, scan);\n        return scan;\n    }\n\n    private readTranscript(jsonl: string): TranscriptScan {\n        const scan = new TranscriptScan();\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: an unreadable transcript yields no evidence, never a crash\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            for (const line of fs.readFileSync(jsonl, 'utf8').split('\\n')) {\n                if (line.trim() === '') continue;\n                const rec = this.parseLine(line);\n                const message = rec?.['message'];\n                if (typeof message !== 'object' || message === null) continue;\n                // webpieces-disable no-any-unknown -- opaque transcript record, narrowed by the guard above\n                const msg = message as Record<string, unknown>;\n                this.collectModel(msg, scan.models);\n                const content = msg['content'];\n                if (!Array.isArray(content)) continue;\n                for (const block of content) {\n                    // webpieces-disable no-any-unknown -- opaque content block, only `type`/`input` are read\n                    const b = block as Record<string, unknown>;\n                    if (b['type'] === 'tool_use') scan.inputs.push(JSON.stringify(b['input'] ?? {}));\n                }\n            }\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n        }\n        return scan;\n    }\n\n    private mentions(inputs: readonly string[], needle: string): boolean {\n        return inputs.some((i: string): boolean => i.includes(needle));\n    }\n\n    // Are we running under Claude Code at all? (CI / plain terminal → provenance is unverifiable → SKIP.)\n    private inClaudeSession(): boolean {\n        return (process.env['CLAUDE_CODE_SESSION_ID'] ?? '').trim() !== '';\n    }\n\n    private skipped(what: string): ProvenanceResult {\n        return new ProvenanceResult(PROVENANCE_SKIPPED,\n            `CLAUDE_CODE_SESSION_ID not set — cannot verify ${what} ran (plain terminal / CI). Skipping the provenance check.`,\n            {}, []);\n    }\n\n    // The agentId of a matching subagent run for `want.agentType` on `branch`, searched across ALL sessions'\n    // subagent dirs (branch-scoped, so a run from a prior session still counts). '' if none. `exclude`\n    // skips agentIds already credited to another checklist so one run can't satisfy two.\n    //\n    // Now that every checklist shares ONE agent type, several runs match, so the one that NAMED this\n    // checklist's verdict file wins; the first branch-matching run is the fallback, as before.\n    // eslint-disable-next-line @typescript-eslint/max-params\n    private findMatchingAgentId(dirs: readonly string[], want: ExpectedReviewer, context: ReviewerContext, exclude: ReadonlySet<string>): string {\n        let fallback = '';\n        for (const dir of dirs) {\n            for (const metaFile of this.metaFiles(dir)) {\n                const agentId = this.agentIdOf(metaFile);\n                if (exclude.has(agentId) || !this.isReviewerRun(dir, metaFile, want.agentType)) continue;\n                if (!this.sidechainOnBranch(dir, agentId, want.checklistId, context)) continue;\n                if (this.namedVerdict(dir, agentId, want.checklistId, context)) return agentId;\n                if (fallback === '') fallback = agentId;\n            }\n        }\n        return fallback;\n    }\n\n    // A harness-written meta for a real subagent (spawnDepth >= 1) of the wanted type.\n    private isReviewerRun(dir: string, metaFile: string, agentType: string): boolean {\n        const meta = this.readJson(path.join(dir, metaFile));\n        if (!meta || meta['agentType'] !== agentType) return false;\n        const spawnDepth = meta['spawnDepth'];\n        return typeof spawnDepth === 'number' && spawnDepth >= 1;\n    }\n\n    // Did this run's transcript name the checklist's own verdict path?\n    // eslint-disable-next-line @typescript-eslint/max-params\n    private namedVerdict(dir: string, agentId: string, checklistId: string, context: ReviewerContext): boolean {\n        const verdictPath = context.verdictPaths[checklistId] ?? '';\n        const jsonl = path.join(dir, `agent-${agentId}.jsonl`);\n        if (verdictPath === '' || !fs.existsSync(jsonl)) return false;\n        return this.mentions(this.scanTranscript(jsonl).inputs, verdictPath);\n    }\n\n    // Every `projects/*/<session>/subagents` dir that exists — matching by the recorded gitBranch (not by\n    // session id) is what makes provenance survive across sessions.\n    private allSubagentsDirs(): string[] {\n        const projects = path.join(os.homedir(), '.claude', 'projects');\n        if (!fs.existsSync(projects)) return [];\n        const out: string[] = [];\n        for (const proj of this.readDir(projects)) {\n            const projDir = path.join(projects, proj);\n            for (const session of this.readDir(projDir)) {\n                const candidate = path.join(projDir, session, 'subagents');\n                if (fs.existsSync(candidate)) out.push(candidate);\n            }\n        }\n        return out;\n    }\n\n    private metaFiles(dir: string): string[] {\n        return this.readDir(dir).filter((f: string): boolean => f.endsWith('.meta.json'));\n    }\n\n    // agent-<id>.meta.json → <id>\n    private agentIdOf(metaFile: string): string {\n        return metaFile.replace(/^agent-/, '').replace(/\\.meta\\.json$/, '');\n    }\n\n    /**\n     * Cross-check the sibling transcript's record 0: isSidechain true (a real subagent, not the main\n     * loop) and the same branch. Lenient on branch drift (a leftover …wpN suffix from a mid-flight\n     * branch rename) and on a missing jsonl (meta already matched — accept, best-effort).\n     *\n     * WHEN `gitBranch` DISAGREES, A PINNED `cwd` DECIDES. Record 0 carries both fields, and the harness\n     * can write a `gitBranch` that CONTRADICTS the record's own `cwd`: a reviewer subagent spawned into\n     * a worktree on `dean/one-2406-…` was stamped `worktree-agent-a54887200e40eb956` — an unrelated,\n     * still-live worktree's scaffold branch — deterministically, on four consecutive attempts, blocking\n     * a PR whose required reviewer genuinely ran and genuinely passed. `stripWp` cannot bridge that, so\n     * the reviewer was never credited and `wp-finish-upsert-pr` refused a legitimately-reviewed PR with\n     * no in-flow recovery. A sweep of 961 record-0s on one machine found the mis-stamp is the MAJORITY\n     * case among subagents in dedicated worktrees, so trusting `gitBranch` alone can never be correct.\n     *\n     * ─── Why ONLY a linked worktree, and never the primary clone ──────────────────────────────────\n     * \"Ask git what branch the cwd is on\" is correct only when that cwd CANNOT have moved since the\n     * reviewer ran. A LINKED WORKTREE is 1:1 with the agent that owns it and nothing re-checks it out;\n     * the PRIMARY CLONE gets checked out constantly. Falling back on a primary-clone cwd would credit a\n     * STALE reviewer, and by construction rather than by accident:\n     *\n     *   1. a reviewer runs in the primary clone while it is on branch A\n     *   2. the clone is later checked out to branch B\n     *   3. `wp-finish-upsert-pr` runs on B — `gitBranch` (stamped A) mismatches\n     *   4. `git -C <clone>` now answers B, because the CLONE moved → the reviewer is credited for B\n     *\n     * It reviewed A. Every past reviewer run in that clone would be credited for whatever branch is\n     * checked out at finish time — which in a repo with a required reviewer on every PR is not an\n     * exotic sequence, it is the normal one. So the fallback is gated on `dotWebpieces.isLinkedWorktree`\n     * (git's own `--git-dir != --git-common-dir` test, reused rather than re-derived), and a primary\n     * clone falls through to a refusal exactly as it does today.\n     *\n     * That gate keeps the anti-forgery property intact: `cwd` is harness-written in the same record by\n     * the same writer as `gitBranch`, so it carries the same weight — and inside a pinned worktree it is\n     * the field that is CORRECT. There is deliberately no config flag and no second comparison mode:\n     * ONE rule, with `gitBranch` only ever a cheap way to skip the subprocess when it already agrees.\n     *\n     * An UNRESOLVABLE cwd does not credit either. A reaped worktree, a deleted directory, a non-repo\n     * path or a detached HEAD yields '' and falls through to a refusal. Leniency here is bounded by\n     * \"git can still prove it\", never by \"we could not check, so assume yes\".\n     *\n     * ─── Why neither field can settle it from a PRIMARY CLONE, and what does ──────────────────────\n     * Both fields above are stamped from the SPAWNING session's cwd — the Agent tool has no cwd\n     * parameter, so a subagent inherits its parent's. A session rooted in the primary clone that spawns\n     * a reviewer for a WORKTREE branch therefore produces `gitBranch` = the clone's branch (mismatch)\n     * and `cwd` = the clone (gated off, correctly) — and NO respawn can change either stamp. That is not\n     * an exotic setup: it is what the flow instructs the moment a worker agent dies mid-flow and the\n     * top-level session has to take over, and it deadlocked a branch whose seven reviewers had all run.\n     *\n     * So the third channel is not a loosening of the cwd rule — it is a DIFFERENT question, asked of\n     * evidence the reviewer cannot inherit and cannot fake by accident: {@link creditedByWhatItTouched}.\n     */\n    // eslint-disable-next-line @typescript-eslint/max-params\n    private sidechainOnBranch(dir: string, agentId: string, checklistId: string, context: ReviewerContext): boolean {\n        const jsonl = path.join(dir, `agent-${agentId}.jsonl`);\n        if (!fs.existsSync(jsonl)) return true;\n        const first = this.firstNonEmptyLine(jsonl);\n        if (first === '') return true;\n        const rec = this.parseLine(first);\n        if (!rec) return true;\n        if (rec['isSidechain'] !== true) return false;\n        const gitBranch = rec['gitBranch'];\n        // Not recorded at all → accept, as before: nothing to contradict and nothing to verify against.\n        if (typeof gitBranch !== 'string' || gitBranch === '') return true;\n        const want = this.stripWp(context.branch);\n        if (this.stripWp(gitBranch) === want) return true;\n        if (want !== '' && this.stripWp(this.branchOfCwd(rec['cwd'])) === want) return true;\n        return this.creditedByWhatItTouched(jsonl, checklistId, context);\n    }\n\n    /**\n     * Credit a reviewer for WHAT IT TOUCHED when neither harness-stamped field can settle it.\n     *\n     * Both paths compared here are ABSOLUTE and BRANCH-SPECIFIC — they live under\n     * `<worktree>/.webpieces/pr-review/<featureSlug>/`, so the string names the tree AND the branch. A\n     * reviewer that worked on a different branch cannot have them in its transcript, and a reviewer of\n     * this branch that ran from a mis-stamped cwd cannot avoid having them. That is the property\n     * `gitBranch` lacks — this file's own sweep of 961 record-0s found the mis-stamp is the MAJORITY\n     * case among subagents in dedicated worktrees.\n     *\n     * Two channels, either sufficient:\n     *   1. it WROTE this checklist's verdict file — proves branch AND checklist, and is the act the whole\n     *      gate is trying to attribute. Matched as a substring of any tool input, so a Write, an Edit and\n     *      a `cat > <path>` heredoc all count; the point is that the path was named, not which tool named it.\n     *   2. it READ this branch's materialized diff dir — proves the branch. Kept as a second channel\n     *      because a reviewer whose verdict was relayed by its parent still demonstrably reviewed this\n     *      branch, and refusing that would re-open a narrower version of the same unrecoverable deadlock.\n     *\n     * Independence is NOT weakened by either: `isSidechain === true` and `spawnDepth >= 1` are checked\n     * before we get here (so the main loop's own transcript can never qualify), and `verifyReviewers`\n     * excludes an agentId already credited to another checklist. It remains non-tamper-proof in exactly\n     * the way the class doc already states — forging this now means forging a transcript rather than a\n     * meta.json, which is the same bar, not a lower one.\n     */\n    private creditedByWhatItTouched(jsonl: string, checklistId: string, context: ReviewerContext): boolean {\n        const scan = this.scanTranscript(jsonl);\n        const verdictPath = context.verdictPaths[checklistId] ?? '';\n        if (verdictPath !== '' && this.mentions(scan.inputs, verdictPath)) return true;\n        return this.readDiffDir(scan, context);\n    }\n\n    /**\n     * The branch record-0's own `cwd` is PINNED to, '' when that cannot be established or is not pinned.\n     *\n     * Cached per cwd because `findMatchingAgentId` walks every subagent of every session on the machine\n     * and several of them share a worktree — one `git` process per RECORD would put dozens of spawns on\n     * the path that opens a PR.\n     */\n    // webpieces-disable no-any-unknown -- one opaque record field, type-guarded on the next line\n    private branchOfCwd(cwd: unknown): string {\n        if (typeof cwd !== 'string' || cwd === '') return '';\n        const cached = this.branchByCwd.get(cwd);\n        if (cached !== undefined) return cached;\n        const resolved = this.pinnedBranch(cwd);\n        this.branchByCwd.set(cwd, resolved);\n        return resolved;\n    }\n\n    /**\n     * The branch of `cwd` when — and only when — `cwd` is a LINKED WORKTREE. '' otherwise.\n     *\n     * '' for the primary clone (it moves; see sidechainOnBranch for the false-accept that closes), for a\n     * reaped or deleted directory, for a non-repo path, when git is unavailable, and for a detached HEAD,\n     * which `--abbrev-ref` prints as the literal `HEAD` and which names no branch.\n     */\n    private pinnedBranch(cwd: string): string {\n        if (!fs.existsSync(cwd)) return '';\n        if (!dotWebpieces.isLinkedWorktree(cwd)) return '';\n        const result = spawnSync('git', ['-C', cwd, 'rev-parse', '--abbrev-ref', 'HEAD'], { encoding: 'utf8' });\n        if (result.status !== 0) return '';\n        const printed = (result.stdout ?? '').trim();\n        return printed === 'HEAD' ? '' : printed;\n    }\n\n    private stripWp(branch: string): string {\n        return branch.replace(/-?wp\\d+$/i, '');\n    }\n\n    private readDir(dir: string): string[] {\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: an unreadable dir yields [] (best-effort provenance)\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            return fs.readdirSync(dir);\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n            return [];\n        }\n    }\n\n    private firstNonEmptyLine(filePath: string): string {\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: unreadable transcript → '' (best-effort)\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            for (const line of fs.readFileSync(filePath, 'utf8').split('\\n')) {\n                if (line.trim() !== '') return line;\n            }\n            return '';\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n            return '';\n        }\n    }\n\n    // webpieces-disable no-any-unknown -- opaque parsed JSON object, keys read by the caller\n    private readJson(filePath: string): Record<string, unknown> | null {\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: malformed meta.json → null (skipped)\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            // webpieces-disable no-any-unknown -- parsed JSON is opaque until narrowed by the caller\n            return JSON.parse(fs.readFileSync(filePath, 'utf8')) as Record<string, unknown>;\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n            return null;\n        }\n    }\n\n    // webpieces-disable no-any-unknown -- one opaque JSONL record, keys read by the caller\n    private parseLine(line: string): Record<string, unknown> | null {\n        // webpieces-disable no-unmanaged-exceptions -- chokepoint: malformed JSONL record → null\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            // webpieces-disable no-any-unknown -- parsed JSON is opaque until narrowed by the caller\n            return JSON.parse(line) as Record<string, unknown>;\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error;\n            return null;\n        }\n    }\n}\n"]}

package/src/validate-config.js

@@ -295,8 +295,10 @@ function prGateExample() {
         `    "gates": [\n` +
         `      { "name": "API Changed", "patterns": ["libraries/apis/**", "**/*Api.ts"], "warningColor": "yellow" }\n` +
         `    ],\n` +
-        `    "checklists": [   // OPTIONAL — per-area review, one distinct reviewer subagent each\n` +
-        `      { "subagent": "db-migration-reviewer", "doc": ".claude/review/db-migrations.md", "patterns": ["**/*.sql"] }\n` +
+        `    "reviewerAgentName": "webpieces-reviewer",\n` +
+        `    "reviewerAgents": 1,   // OPTIONAL — the most reviewer subagents per round; omit for one per checklist\n` +
+        `    "checklists": [   // OPTIONAL — per-area review, each against its own doc\n` +
+        `      { "id": "db-migrations", "doc": ".claude/review/db-migrations.md", "patterns": ["**/*.sql"], "required": true }\n` +
         `    ]\n` +
         `  }`);
 }
@@ -378,6 +380,7 @@ function validatePrGateSection(section, repoRoot) {
         else if (typeof mm !== 'string' || !PR_GATE_MERGE_MODES.includes(mm)) {
             errors.push(`[pr-gate] "mergeMode" = "${String(mm)}" is not valid. ${MERGE_MODE_HELP}`);
         }
+        errors.push(...(0, pr_gate_section_validators_1.validateReviewerAgentKeys)(s, repoRoot));
     }
     if ('gates' in s)
         errors.push(...validateGatesSection(s['gates']));