@mmnto/totem 1.67.0 → 1.68.0

package/dist/capability/falsification.d.ts

@@ -0,0 +1,18 @@
+import { type RegenerateOptions } from './regenerate.js';
+import type { CapabilityClaim, CapabilityResolution } from './schema.js';
+export type CapabilityFmClause = 'a' | 'c' | 'd';
+export interface CapabilityFmViolation {
+    clause: CapabilityFmClause;
+    detail: string;
+}
+export interface CapabilityFalsificationResult {
+    ok: boolean;
+    violations: CapabilityFmViolation[];
+}
+/**
+ * Run FM a/c/d over an append-only claim/resolution log. (FM-b is structural — the
+ * `ResolutionSource` enum cannot express an LLM-judge — so there is nothing to check at
+ * runtime; it is locked at the schema/type level + asserted in the schema tests.)
+ */
+export declare function runCapabilityFalsification(claims: readonly CapabilityClaim[], resolutions: readonly CapabilityResolution[], opts: RegenerateOptions): CapabilityFalsificationResult;
+//# sourceMappingURL=falsification.d.ts.map

package/dist/capability/falsification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"falsification.d.ts","sourceRoot":"","sources":["../../src/capability/falsification.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,WAAW,EAAE,SAAS,oBAAoB,EAAE,EAC5C,IAAI,EAAE,iBAAiB,GACtB,6BAA6B,CAwC/B"}

package/dist/capability/falsification.js

@@ -0,0 +1,56 @@
+// ─── #697 Layer-B — falsification harness (FM a–d) ───────────────────────────
+//
+// The done-criterion guard over the capability log. FM a–d (#697 fold 4):
+//   (a) byte-reproducible — the ledger regenerates identically from the log;
+//   (b) no-LLM-judge — STRUCTURAL via the `ResolutionSource` enum (no `llm-judge`
+//       member exists), so it is unconstructible, not runtime-checked here;
+//   (c) join integrity — every resolution → an existing claim; ≤1 effective terminal
+//       per claim per horizon (enforced by `regenerateCapabilityLedger`'s fail-loud
+//       throws, surfaced here as clause `c`);
+//   (d) arithmetic integrity — every row's `decisiveN`/`hitRate` exactly equals the
+//       pinned formula over its counts (catches partial-inflation / wrong-denominator).
+import { canonicalStringify } from '../compile-manifest.js';
+import { collectJoinIntegrityErrors, regenerateCapabilityLedger, } from './regenerate.js';
+/**
+ * Run FM a/c/d over an append-only claim/resolution log. (FM-b is structural — the
+ * `ResolutionSource` enum cannot express an LLM-judge — so there is nothing to check at
+ * runtime; it is locked at the schema/type level + asserted in the schema tests.)
+ */
+export function runCapabilityFalsification(claims, resolutions, opts) {
+    const violations = [];
+    // FM-c: join integrity — collect the breaches (the SAME shared check `regenerate`
+    // throws on) and surface each as a clause-`c` violation. No swallowing catch: the
+    // regenerate call below runs only on a log already proven clean, so it cannot throw
+    // here — the harness reports integrity breaches as data, never drops them (Tenet 4).
+    for (const detail of collectJoinIntegrityErrors(claims, resolutions, opts)) {
+        violations.push({ clause: 'c', detail });
+    }
+    if (violations.length > 0)
+        return { ok: false, violations };
+    const ledger = regenerateCapabilityLedger(claims, resolutions, opts);
+    // FM-a: regenerating again must produce a byte-identical ledger.
+    const again = regenerateCapabilityLedger(claims, resolutions, opts);
+    if (canonicalStringify(ledger) !== canonicalStringify(again)) {
+        violations.push({ clause: 'a', detail: 'ledger is not byte-reproducible from the log' });
+    }
+    // FM-d: each row's arithmetic is honest — `decisiveN` excludes partial+unresolved and
+    // `hitRate` is exactly `correctN / decisiveN` (or null when no decisive evidence).
+    for (const row of ledger.rows) {
+        const id = `${row.agentSource}/${row.taskType}`;
+        if (row.decisiveN !== row.correctN + row.wrongN) {
+            violations.push({
+                clause: 'd',
+                detail: `row ${id}: decisiveN ${row.decisiveN} != correctN+wrongN ${row.correctN + row.wrongN}`,
+            });
+        }
+        const expected = row.decisiveN === 0 ? null : row.correctN / row.decisiveN;
+        if (row.hitRate !== expected) {
+            violations.push({
+                clause: 'd',
+                detail: `row ${id}: hitRate ${row.hitRate} != correctN/decisiveN ${expected}`,
+            });
+        }
+    }
+    return { ok: violations.length === 0, violations };
+}
+//# sourceMappingURL=falsification.js.map

package/dist/capability/falsification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"falsification.js","sourceRoot":"","sources":["../../src/capability/falsification.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,kFAAkF;AAClF,4EAA4E;AAC5E,qFAAqF;AACrF,oFAAoF;AACpF,8CAA8C;AAC9C,oFAAoF;AACpF,wFAAwF;AAExF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAE3B,MAAM,iBAAiB,CAAC;AAezB;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAkC,EAClC,WAA4C,EAC5C,IAAuB;IAEvB,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,kFAAkF;IAClF,kFAAkF;IAClF,oFAAoF;IACpF,qFAAqF;IACrF,KAAK,MAAM,MAAM,IAAI,0BAA0B,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;QAC3E,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAE5D,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAErE,iEAAiE;IACjE,MAAM,KAAK,GAAG,0BAA0B,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACpE,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,8CAA8C,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,sFAAsF;IACtF,mFAAmF;IACnF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QAChD,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YAChD,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,GAAG;gBACX,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,CAAC,SAAS,uBAAuB,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE;aAChG,CAAC,CAAC;QACL,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC;QAC3E,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7B,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,GAAG;gBACX,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,CAAC,OAAO,0BAA0B,QAAQ,EAAE;aAC9E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC"}

package/dist/capability/falsification.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=falsification.test.d.ts.map

package/dist/capability/falsification.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"falsification.test.d.ts","sourceRoot":"","sources":["../../src/capability/falsification.test.ts"],"names":[],"mappings":""}

package/dist/capability/falsification.test.js

@@ -0,0 +1,112 @@
+import { describe, expect, it } from 'vitest';
+import { runCapabilityFalsification } from './falsification.js';
+import { mineReviewCatch } from './review-catch.js';
+const sha = (n) => String(n).padStart(40, '0');
+const HORIZON = '2026-06-21T00:00:00.000Z';
+const minedLog = () => mineReviewCatch([
+    {
+        commentId: 1,
+        author: 'coderabbitai[bot]',
+        prRef: 'x#1',
+        commitSha: sha(1),
+        assertedAt: '2026-06-20T00:00:00.000Z',
+        disposition: 'accepted',
+    },
+    {
+        commentId: 2,
+        author: 'gemini-code-assist[bot]',
+        prRef: 'x#1',
+        commitSha: sha(1),
+        assertedAt: '2026-06-20T00:00:00.000Z',
+        disposition: 'declined',
+    },
+    {
+        commentId: 3,
+        author: 'totem-claude',
+        prRef: 'x#1',
+        commitSha: sha(1),
+        assertedAt: '2026-06-20T00:00:00.000Z',
+    },
+]);
+describe('runCapabilityFalsification', () => {
+    it('passes a clean mined log (FM a/c/d all hold)', () => {
+        const { claims, resolutions } = minedLog();
+        const result = runCapabilityFalsification(claims, resolutions, { resolutionHorizon: HORIZON });
+        expect(result.ok).toBe(true);
+        expect(result.violations).toEqual([]);
+    });
+    it('flags FM-c when a resolution references an absent claim', () => {
+        const { claims } = minedLog();
+        const orphan = {
+            resolutionId: 'r-orphan',
+            claimId: 'does-not-exist',
+            outcome: 'correct',
+            resolutionSource: 'disposition-thread',
+            evidenceRef: 'ev',
+            resolvedAt: '2026-06-20T00:00:00.000Z',
+        };
+        const result = runCapabilityFalsification(claims, [orphan], { resolutionHorizon: HORIZON });
+        expect(result.ok).toBe(false);
+        expect(result.violations.map((v) => v.clause)).toContain('c');
+    });
+    it('flags FM-c on a duplicate resolutionId', () => {
+        const claims = [
+            {
+                claimId: 'c1',
+                agentSource: 'cr',
+                taskType: 'review-catch',
+                claimKind: 'review-finding',
+                provenance: { ref: 'x#1', commitSha: sha(1) },
+                nativeKey: 'gh-review-comment:1',
+                assertedAt: '2026-06-20T00:00:00.000Z',
+            },
+            {
+                claimId: 'c2',
+                agentSource: 'cr',
+                taskType: 'review-catch',
+                claimKind: 'review-finding',
+                provenance: { ref: 'x#1', commitSha: sha(1) },
+                nativeKey: 'gh-review-comment:2',
+                assertedAt: '2026-06-20T00:00:00.000Z',
+            },
+        ];
+        const dup = [
+            {
+                resolutionId: 'same',
+                claimId: 'c1',
+                outcome: 'correct',
+                resolutionSource: 'deterministic-event',
+                evidenceRef: 'e1',
+                resolvedAt: '2026-06-20T00:00:00.000Z',
+            },
+            {
+                resolutionId: 'same',
+                claimId: 'c2',
+                outcome: 'wrong',
+                resolutionSource: 'deterministic-event',
+                evidenceRef: 'e2',
+                resolvedAt: '2026-06-20T00:00:00.000Z',
+            },
+        ];
+        const result = runCapabilityFalsification(claims, dup, { resolutionHorizon: HORIZON });
+        expect(result.ok).toBe(false);
+        expect(result.violations.map((v) => v.clause)).toContain('c');
+    });
+    it('flags FM-c on a duplicate claimId (greptile P1)', () => {
+        const dupClaim = {
+            claimId: 'same-claim',
+            agentSource: 'cr',
+            taskType: 'review-catch',
+            claimKind: 'review-finding',
+            provenance: { ref: 'x#1', commitSha: sha(1) },
+            nativeKey: 'gh-review-comment:1',
+            assertedAt: '2026-06-20T00:00:00.000Z',
+        };
+        const result = runCapabilityFalsification([dupClaim, { ...dupClaim }], [], {
+            resolutionHorizon: HORIZON,
+        });
+        expect(result.ok).toBe(false);
+        expect(result.violations.map((v) => v.clause)).toContain('c');
+    });
+});
+//# sourceMappingURL=falsification.test.js.map

package/dist/capability/falsification.test.js.map

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

package/dist/capability/regenerate.d.ts

@@ -0,0 +1,20 @@
+import { type CapabilityClaim, type CapabilityLedger, type CapabilityResolution } from './schema.js';
+export interface RegenerateOptions {
+    /** ISO bound: resolutions with `resolvedAt > resolutionHorizon` are immature and ignored. */
+    resolutionHorizon: string;
+}
+/**
+ * Collect FM-c join-integrity errors (empty array = clean): a duplicate `resolutionId`,
+ * a resolution referencing an absent `claimId`, or an ambiguous supersession terminal.
+ * Pure. SHARED by the fail-loud `regenerateCapabilityLedger` (which throws on the first)
+ * and the falsification harness (which surfaces each as a clause-`c` violation) — so the
+ * harness reports integrity breaches WITHOUT a swallowing catch (Tenet 4).
+ */
+export declare function collectJoinIntegrityErrors(claims: readonly CapabilityClaim[], resolutions: readonly CapabilityResolution[], opts: RegenerateOptions): string[];
+/**
+ * Recompute the `CapabilityLedger` cache from the append-only claim/resolution log.
+ * Throws (FM-c join integrity) on a duplicate `resolutionId`, a resolution referencing
+ * an absent `claimId`, or an ambiguous supersession terminal.
+ */
+export declare function regenerateCapabilityLedger(claims: readonly CapabilityClaim[], resolutions: readonly CapabilityResolution[], opts: RegenerateOptions): CapabilityLedger;
+//# sourceMappingURL=regenerate.d.ts.map

package/dist/capability/regenerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerate.d.ts","sourceRoot":"","sources":["../../src/capability/regenerate.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAGrB,KAAK,oBAAoB,EAE1B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA0DD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,WAAW,EAAE,SAAS,oBAAoB,EAAE,EAC5C,IAAI,EAAE,iBAAiB,GACtB,MAAM,EAAE,CA6DV;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,WAAW,EAAE,SAAS,oBAAoB,EAAE,EAC5C,IAAI,EAAE,iBAAiB,GACtB,gBAAgB,CA4FlB"}

package/dist/capability/regenerate.js.map

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

package/dist/capability/regenerate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=regenerate.test.d.ts.map

package/dist/capability/regenerate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerate.test.d.ts","sourceRoot":"","sources":["../../src/capability/regenerate.test.ts"],"names":[],"mappings":""}

package/dist/capability/regenerate.test.js

@@ -0,0 +1,136 @@
+import { describe, expect, it } from 'vitest';
+import { canonicalStringify } from '../compile-manifest.js';
+import { regenerateCapabilityLedger } from './regenerate.js';
+const sha = (n) => String(n).padStart(40, '0');
+const HORIZON = '2026-06-20T12:00:00.000Z';
+function claim(id, agentSource = 'cr', overrides = {}) {
+    return {
+        claimId: id,
+        agentSource,
+        taskType: 'review-catch',
+        claimKind: 'review-finding',
+        provenance: { ref: `mmnto-ai/totem#${id}`, commitSha: sha(1) },
+        nativeKey: `gh-review-comment:${id}`,
+        assertedAt: '2026-06-19T00:00:00.000Z',
+        ...overrides,
+    };
+}
+function resolution(id, claimId, outcome, overrides = {}) {
+    return {
+        resolutionId: id,
+        claimId,
+        outcome,
+        resolutionSource: 'disposition-thread',
+        evidenceRef: `ev:${id}`,
+        resolvedAt: '2026-06-19T06:00:00.000Z',
+        ...overrides,
+    };
+}
+const row = (ledger, agent) => ledger.rows.find((r) => r.agentSource === agent);
+describe('regenerateCapabilityLedger — fold + hit-rate', () => {
+    it('counts held/wrong/partial/silence and computes hitRate = correct/(correct+wrong)', () => {
+        const claims = [claim('1'), claim('2'), claim('3'), claim('4')];
+        const resolutions = [
+            resolution('r1', '1', 'correct'),
+            resolution('r2', '2', 'wrong'),
+            resolution('r3', '3', 'partial'),
+            // claim 4 has no resolution → unresolved by absence
+        ];
+        const ledger = regenerateCapabilityLedger(claims, resolutions, { resolutionHorizon: HORIZON });
+        const cr = row(ledger, 'cr');
+        expect(cr.correctN).toBe(1);
+        expect(cr.wrongN).toBe(1);
+        expect(cr.partialN).toBe(1);
+        expect(cr.unresolvedN).toBe(1);
+        expect(cr.decisiveN).toBe(2); // partial + unresolved excluded
+        expect(cr.hitRate).toBe(0.5); // 1/(1+1)
+    });
+    it('hitRate is null when there is no decisive evidence (never 0/0)', () => {
+        const ledger = regenerateCapabilityLedger([claim('1'), claim('2')], [resolution('r1', '1', 'partial')], // claim 2 unresolved
+        { resolutionHorizon: HORIZON });
+        expect(row(ledger, 'cr').hitRate).toBeNull();
+        expect(row(ledger, 'cr').decisiveN).toBe(0);
+    });
+    it('divides the cohort by actor-id (the acceptance shape)', () => {
+        const claims = [claim('1', 'cr'), claim('2', 'cr'), claim('3', 'gca'), claim('4', 'gca')];
+        const resolutions = [
+            resolution('r1', '1', 'correct'),
+            resolution('r2', '2', 'correct'),
+            resolution('r3', '3', 'correct'),
+            resolution('r4', '4', 'wrong'),
+        ];
+        const ledger = regenerateCapabilityLedger(claims, resolutions, { resolutionHorizon: HORIZON });
+        expect(row(ledger, 'cr').hitRate).toBe(1); // 2/2
+        expect(row(ledger, 'gca').hitRate).toBe(0.5); // 1/2
+    });
+    it('excludes immature resolutions past the horizon (near-HEAD skew fix)', () => {
+        const ledger = regenerateCapabilityLedger([claim('1')], [resolution('r1', '1', 'wrong', { resolvedAt: '2026-06-21T00:00:00.000Z' })], // > horizon
+        { resolutionHorizon: HORIZON });
+        expect(row(ledger, 'cr').unresolvedN).toBe(1);
+        expect(row(ledger, 'cr').decisiveN).toBe(0);
+    });
+    it('compares the horizon chronologically across precision — equal instant is within-horizon (greptile P2)', () => {
+        // resolvedAt has no ms; horizon has ms — the SAME instant. A raw lexicographic compare
+        // would EXCLUDE it ('.' < 'Z'); the chronological compare correctly includes it (<=).
+        const ledger = regenerateCapabilityLedger([claim('1')], [resolution('r1', '1', 'correct', { resolvedAt: '2026-06-20T12:00:00Z' })], { resolutionHorizon: '2026-06-20T12:00:00.000Z' });
+        expect(row(ledger, 'cr').correctN).toBe(1);
+    });
+});
+describe('regenerateCapabilityLedger — supersession', () => {
+    it('selects the terminal of a supersedesResolutionId chain', () => {
+        const ledger = regenerateCapabilityLedger([claim('1')], [
+            resolution('r1', '1', 'correct', { resolvedAt: '2026-06-19T01:00:00.000Z' }),
+            resolution('r2', '1', 'wrong', {
+                resolvedAt: '2026-06-19T02:00:00.000Z',
+                supersedesResolutionId: 'r1',
+            }),
+        ], { resolutionHorizon: HORIZON });
+        expect(row(ledger, 'cr').wrongN).toBe(1); // r2 (terminal) wins
+        expect(row(ledger, 'cr').correctN).toBe(0);
+    });
+    it('falls back to latest resolvedAt when there is no chain', () => {
+        const ledger = regenerateCapabilityLedger([claim('1')], [
+            resolution('r1', '1', 'wrong', { resolvedAt: '2026-06-19T01:00:00.000Z' }),
+            resolution('r2', '1', 'correct', { resolvedAt: '2026-06-19T05:00:00.000Z' }),
+        ], { resolutionHorizon: HORIZON });
+        expect(row(ledger, 'cr').correctN).toBe(1); // latest (r2) wins
+    });
+});
+describe('regenerateCapabilityLedger — FM-c join integrity (fail loud)', () => {
+    it('throws on a resolution referencing an absent claim', () => {
+        expect(() => regenerateCapabilityLedger([claim('1')], [resolution('r9', 'NOPE', 'correct')], {
+            resolutionHorizon: HORIZON,
+        })).toThrow(/references absent claim/);
+    });
+    it('throws on a duplicate resolutionId', () => {
+        expect(() => regenerateCapabilityLedger([claim('1'), claim('2')], [resolution('dup', '1', 'correct'), resolution('dup', '2', 'wrong')], { resolutionHorizon: HORIZON })).toThrow(/duplicate resolutionId/);
+    });
+    it('throws on a duplicate claimId — would otherwise double-count unresolvedN (greptile P1)', () => {
+        expect(() => regenerateCapabilityLedger([claim('1'), claim('1')], [], { resolutionHorizon: HORIZON })).toThrow(/duplicate claimId/);
+    });
+    it('throws on a dangling supersedesResolutionId — references an absent resolutionId (CR)', () => {
+        expect(() => regenerateCapabilityLedger([claim('1')], [resolution('r1', '1', 'correct', { supersedesResolutionId: 'r-ghost' })], { resolutionHorizon: HORIZON })).toThrow(/references an absent resolutionId/);
+    });
+    it('throws on an ambiguous supersession terminal (two unsuperseded heads)', () => {
+        // r3 supersedes r1 (a real pointer — no dangling ref); r2 and r3 are both unsuperseded
+        // heads → ambiguous. (Pointers are real so the dangling-ref guard does not fire first.)
+        expect(() => regenerateCapabilityLedger([claim('1')], [
+            resolution('r1', '1', 'correct'),
+            resolution('r2', '1', 'wrong'),
+            resolution('r3', '1', 'partial', { supersedesResolutionId: 'r1' }),
+        ], { resolutionHorizon: HORIZON })).toThrow(/ambiguous terminal/);
+    });
+});
+describe('regenerateCapabilityLedger — FM-a byte reproducibility + ordering', () => {
+    it('regenerates byte-identically and sorts rows by (agentSource, taskType)', () => {
+        const claims = [claim('2', 'gca'), claim('1', 'cr')];
+        const resolutions = [resolution('r1', '1', 'correct'), resolution('r2', '2', 'wrong')];
+        const a = regenerateCapabilityLedger(claims, resolutions, { resolutionHorizon: HORIZON });
+        const b = regenerateCapabilityLedger([...claims].reverse(), [...resolutions].reverse(), {
+            resolutionHorizon: HORIZON,
+        });
+        expect(canonicalStringify(a)).toBe(canonicalStringify(b));
+        expect(a.rows.map((r) => r.agentSource)).toEqual(['cr', 'gca']); // sorted
+    });
+});
+//# sourceMappingURL=regenerate.test.js.map

package/dist/capability/regenerate.test.js.map

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

package/dist/capability/review-catch.d.ts

@@ -0,0 +1,53 @@
+import { type CapabilityClaim, type CapabilityResolution } from './schema.js';
+/** The injected port's output — one mined review finding per review comment. */
+export interface MinedReviewFinding {
+    /** GitHub review-comment numeric id (REST exposes no GraphQL node_id) — the nativeKey source. */
+    commentId: number;
+    /** GitHub author login (a review-bot or a cohort seat). */
+    author: string;
+    /** Provenance ref of the thread/PR, e.g. `mmnto-ai/totem#2205`. */
+    prRef: string;
+    /** The commit the finding was asserted against (lowercase 40-hex). */
+    commitSha: string;
+    /** When the finding was posted (ISO). */
+    assertedAt: string;
+    /**
+     * The deterministic disposition read (reusing `bot-review-parser`'s taxonomy):
+     * `accepted` → held → `correct`; `declined` → wrong → `wrong`; `undefined` = silence
+     * (no disposition, no fix) → NO resolution row → the regenerator derives `unresolved`
+     * (strategy pin: never count silence as a miss).
+     */
+    disposition?: 'accepted' | 'declined';
+    /** The disposition comment id / fix-commit ref the read was grounded in. */
+    dispositionEvidenceRef?: string;
+    /** When the disposition was made (ISO); falls back to `assertedAt`. */
+    resolvedAt?: string;
+}
+export interface ReviewCatchMineResult {
+    claims: CapabilityClaim[];
+    resolutions: CapabilityResolution[];
+}
+/**
+ * Resolve a GitHub author login to a stable Layer-B actor-id, COUPLING to existing
+ * actors rather than minting a parallel scheme (#697 fold 5, corrected c.4755848293).
+ * The namespace is `{ cohort agent-seats } ∪ { coderabbit, gemini-code-assist, greptile }`:
+ * the three ACTIVE paid review bots (de-facto home: `doctrine/bot-protocols.md` + the
+ * parity-manifest `bot-review-configs` dimension) + the cohort seats (a cohort dispatch
+ * login already IS its `cohort-roles.md` id). `pr-agent`/`qodo` are research-only/dropped
+ * (no shipped #670 backend registry to couple to — forward-couple only IF #670 ships), so
+ * they are NOT specially mapped. Model/backend identity is intentionally NOT folded into
+ * the id (so the hit-rate aggregates across model swaps).
+ *
+ * @param author - the GitHub login of the finding's author (bot or cohort seat).
+ * @returns the stable actor-id — a known bot's canonical id, else the trimmed login.
+ * @throws if `author` is empty or whitespace-only (no silent empty actor-id).
+ */
+export declare function resolveActorId(author: string): string;
+/**
+ * Mine the review-catch column from a list of findings. One claim per finding; a
+ * resolution only when the finding carries a disposition (silence → unresolved by
+ * absence). Deterministic: `claimId`/`resolutionId` derive from the finding's stable
+ * `commentId`, so re-mining identical history yields identical rows.
+ */
+export declare function mineReviewCatch(findings: readonly MinedReviewFinding[]): ReviewCatchMineResult;
+//# sourceMappingURL=review-catch.d.ts.map

package/dist/capability/review-catch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-catch.d.ts","sourceRoot":"","sources":["../../src/capability/review-catch.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;AAErB,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACtC,4EAA4E;IAC5E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,qBAAqB,CA+C9F"}

package/dist/capability/review-catch.js

@@ -0,0 +1,92 @@
+// ─── #697 Layer-B — review-catch back-miner (the first column) ───────────────
+//
+// Back-mines the review-catch capability column from PR review primitives: each posted
+// review finding is a CLAIM by its author; its disposition (held = accepted+fixed →
+// correct, declined-as-FP → wrong, silence → unresolved-by-absence) is the RESOLUTION.
+// Author-adjudicated correctness, identical scope to #670. Pure + deterministic: it
+// consumes already-mined findings through an injected port (the live GitHub fetch +
+// `bot-review-parser` disposition read is the CLI-side adapter, a follow-on); core stays
+// network/LLM-free. No LLM-judge — the resolution is a deterministic disposition read
+// (resolutionSource `disposition-thread`), so FM-b holds.
+import { CapabilityClaimSchema, CapabilityResolutionSchema, deriveClaimId, } from './schema.js';
+const REVIEW_CATCH_CLAIM_KIND = 'review-finding';
+/** The three active paid review bots → their stable actor-id, keyed by EXACT login. */
+const REVIEW_BOT_ACTOR_IDS = {
+    'coderabbitai[bot]': 'coderabbit',
+    'gemini-code-assist[bot]': 'gemini-code-assist',
+    'greptile-apps[bot]': 'greptile',
+};
+/**
+ * Resolve a GitHub author login to a stable Layer-B actor-id, COUPLING to existing
+ * actors rather than minting a parallel scheme (#697 fold 5, corrected c.4755848293).
+ * The namespace is `{ cohort agent-seats } ∪ { coderabbit, gemini-code-assist, greptile }`:
+ * the three ACTIVE paid review bots (de-facto home: `doctrine/bot-protocols.md` + the
+ * parity-manifest `bot-review-configs` dimension) + the cohort seats (a cohort dispatch
+ * login already IS its `cohort-roles.md` id). `pr-agent`/`qodo` are research-only/dropped
+ * (no shipped #670 backend registry to couple to — forward-couple only IF #670 ships), so
+ * they are NOT specially mapped. Model/backend identity is intentionally NOT folded into
+ * the id (so the hit-rate aggregates across model swaps).
+ *
+ * @param author - the GitHub login of the finding's author (bot or cohort seat).
+ * @returns the stable actor-id — a known bot's canonical id, else the trimmed login.
+ * @throws if `author` is empty or whitespace-only (no silent empty actor-id).
+ */
+export function resolveActorId(author) {
+    const trimmed = author.trim();
+    if (trimmed.length === 0) {
+        // Fail loud: an empty/whitespace login (e.g. a deleted GH user → null author) must
+        // never silently mint an empty actor-id (Tenet 4).
+        throw new Error('[Totem Error] resolveActorId: author login must be a non-empty string');
+    }
+    // EXACT login match, NOT a prefix — so a future variant like `greptile-enterprise[bot]`
+    // is not silently collapsed into `greptile` and mixed into its hit-rate (greptile P2).
+    // A cohort seat login (e.g. `totem-claude`) is unknown here → returned as its own id.
+    return REVIEW_BOT_ACTOR_IDS[trimmed.toLowerCase()] ?? trimmed;
+}
+/**
+ * Mine the review-catch column from a list of findings. One claim per finding; a
+ * resolution only when the finding carries a disposition (silence → unresolved by
+ * absence). Deterministic: `claimId`/`resolutionId` derive from the finding's stable
+ * `commentId`, so re-mining identical history yields identical rows.
+ */
+export function mineReviewCatch(findings) {
+    const claims = [];
+    const resolutions = [];
+    for (const f of findings) {
+        const nativeKey = `gh-review-comment:${f.commentId}`;
+        const agentSource = resolveActorId(f.author);
+        const claimId = deriveClaimId({
+            agentSource,
+            taskType: 'review-catch',
+            claimKind: REVIEW_CATCH_CLAIM_KIND,
+            provenanceRef: f.prRef,
+            commitSha: f.commitSha,
+            nativeKey,
+        });
+        claims.push(CapabilityClaimSchema.parse({
+            claimId,
+            agentSource,
+            taskType: 'review-catch',
+            claimKind: REVIEW_CATCH_CLAIM_KIND,
+            provenance: { ref: f.prRef, commitSha: f.commitSha },
+            nativeKey,
+            assertedAt: f.assertedAt,
+        }));
+        if (f.disposition === 'accepted' || f.disposition === 'declined') {
+            resolutions.push(CapabilityResolutionSchema.parse({
+                resolutionId: `rc-res:${f.commentId}`,
+                claimId,
+                outcome: f.disposition === 'accepted' ? 'correct' : 'wrong',
+                // Deterministic read of the disposition primitive — never an LLM-judge (FM-b).
+                resolutionSource: 'disposition-thread',
+                // `?.trim() ||` (not `??`) so an empty/whitespace evidenceRef/resolvedAt falls
+                // back instead of tripping the schema's non-empty/datetime guards (GCA).
+                evidenceRef: f.dispositionEvidenceRef?.trim() || nativeKey,
+                resolvedAt: f.resolvedAt?.trim() || f.assertedAt,
+            }));
+        }
+        // silence (no disposition) → no resolution row → regenerator buckets it `unresolved`.
+    }
+    return { claims, resolutions };
+}
+//# sourceMappingURL=review-catch.js.map

package/dist/capability/review-catch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-catch.js","sourceRoot":"","sources":["../../src/capability/review-catch.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,uFAAuF;AACvF,oFAAoF;AACpF,uFAAuF;AACvF,oFAAoF;AACpF,oFAAoF;AACpF,yFAAyF;AACzF,sFAAsF;AACtF,0DAA0D;AAE1D,OAAO,EAEL,qBAAqB,EAErB,0BAA0B,EAC1B,aAAa,GACd,MAAM,aAAa,CAAC;AA2BrB,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAOjD,uFAAuF;AACvF,MAAM,oBAAoB,GAAqC;IAC7D,mBAAmB,EAAE,YAAY;IACjC,yBAAyB,EAAE,oBAAoB;IAC/C,oBAAoB,EAAE,UAAU;CACjC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,mFAAmF;QACnF,mDAAmD;QACnD,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,wFAAwF;IACxF,uFAAuF;IACvF,sFAAsF;IACtF,OAAO,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAuC;IACrE,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,qBAAqB,CAAC,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,WAAW;YACX,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,uBAAuB;YAClC,aAAa,EAAE,CAAC,CAAC,KAAK;YACtB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CACT,qBAAqB,CAAC,KAAK,CAAC;YAC1B,OAAO;YACP,WAAW;YACX,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,uBAAuB;YAClC,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;YACpD,SAAS;YACT,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACjE,WAAW,CAAC,IAAI,CACd,0BAA0B,CAAC,KAAK,CAAC;gBAC/B,YAAY,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE;gBACrC,OAAO;gBACP,OAAO,EAAE,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;gBAC3D,+EAA+E;gBAC/E,gBAAgB,EAAE,oBAAoB;gBACtC,+EAA+E;gBAC/E,yEAAyE;gBACzE,WAAW,EAAE,CAAC,CAAC,sBAAsB,EAAE,IAAI,EAAE,IAAI,SAAS;gBAC1D,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,UAAU;aACjD,CAAC,CACH,CAAC;QACJ,CAAC;QACD,sFAAsF;IACxF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC"}

package/dist/capability/review-catch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=review-catch.test.d.ts.map

package/dist/capability/review-catch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-catch.test.d.ts","sourceRoot":"","sources":["../../src/capability/review-catch.test.ts"],"names":[],"mappings":""}