@productbrain/cli 0.1.0-beta.15 → 0.1.0-beta.1522

package/dist/scoreboard/diagnose.test.js

@@ -0,0 +1,192 @@
+/**
+ * Diagnosis-layer unit tests (spec §2d, A4).
+ *
+ * Asserts the pure metric→{status,reading,cause,nextAction} mapping, with explicit coverage of
+ * the awaiting / unmeasured / degraded / ok states and the honesty invariants:
+ *   - No flip threshold is pinned (DEC-1282) → judged readings are `awaiting`, never an invented
+ *     number, and the raw reading is always present.
+ *   - M4 is a standing `awaiting` tile (deferred, TEN-2433) — never a fake green.
+ *   - Coaching/moat quality is a standing `unmeasured` line (TEN-2377).
+ */
+import { describe, it, expect } from 'vitest';
+import { diagnose, diagnoseM1, diagnoseM2, diagnoseM3, diagnoseM4, diagnoseM5, diagnoseCoachingMoat, } from './diagnose.js';
+const m1WithData = {
+    mix: { audited: 3, draft: 2, noDomain: 5, total: 10 },
+    noDomainShare: 0.5,
+    auditedShare: 0.3,
+    draftShare: 0.2,
+    windowMs: 30 * 24 * 60 * 60 * 1000,
+    servedRowCount: 10,
+};
+const m1Empty = {
+    mix: { audited: 0, draft: 0, noDomain: 0, total: 0 },
+    noDomainShare: null,
+    auditedShare: null,
+    draftShare: null,
+    windowMs: 30 * 24 * 60 * 60 * 1000,
+    servedRowCount: 0,
+};
+describe('diagnoseM1', () => {
+    it('is awaiting (never an invented floor) when there is data — DEC-1282', () => {
+        const d = diagnoseM1(m1WithData);
+        expect(d.status).toBe('awaiting');
+        expect(d.metric).toBe('M1');
+        // Raw reading always shown.
+        expect(d.reading).toContain('no-domain=50%');
+        expect(d.reading).toContain('served=10');
+        // Unpinned cause + concrete next action (domains unratified).
+        expect(d.cause).toMatch(/unpinned/i);
+        expect(d.nextAction).toMatch(/ratify/i);
+    });
+    it('is unmeasured when nothing was served', () => {
+        const d = diagnoseM1(m1Empty);
+        expect(d.status).toBe('unmeasured');
+        expect(d.nextAction).toMatch(/serve/i);
+    });
+});
+describe('diagnoseM2', () => {
+    it('is ok at full parity (post-unify steady state — 0 vs non-0 is exact, no number invented)', () => {
+        const m2 = { divergentBuckets: 0, fullParity: true, task: null };
+        const d = diagnoseM2(m2);
+        expect(d.status).toBe('ok');
+        expect(d.nextAction).toBe('');
+        expect(d.reading).toContain('divergentBuckets=0');
+    });
+    it('is degraded when the surfaces re-fork (regression signal)', () => {
+        const m2 = { divergentBuckets: 2, fullParity: false, task: 'do a thing' };
+        const d = diagnoseM2(m2);
+        expect(d.status).toBe('degraded');
+        expect(d.reading).toContain('divergentBuckets=2');
+        expect(d.reading).toContain('task="do a thing"');
+        expect(d.nextAction).toMatch(/shared ranker|TEN-2431/);
+    });
+});
+describe('diagnoseM3', () => {
+    it('is awaiting when there are captures (floor unpinned)', () => {
+        const m3 = {
+            capturedCount: 8,
+            everRatifiedCount: 3,
+            inSessionRatifiedCount: 1,
+            everRatifiedRate: 0.375,
+            inSessionRatifiedRate: 0.125,
+            sessionWindow: 20,
+            sessionsConsidered: 12,
+        };
+        const d = diagnoseM3(m3);
+        expect(d.status).toBe('awaiting');
+        expect(d.reading).toContain('captured=8');
+        expect(d.cause).toMatch(/unpinned/i);
+    });
+    it('is unmeasured with zero captures', () => {
+        const m3 = {
+            capturedCount: 0,
+            everRatifiedCount: 0,
+            inSessionRatifiedCount: 0,
+            everRatifiedRate: null,
+            inSessionRatifiedRate: null,
+            sessionWindow: 20,
+            sessionsConsidered: 5,
+        };
+        const d = diagnoseM3(m3);
+        expect(d.status).toBe('unmeasured');
+    });
+});
+describe('diagnoseM4', () => {
+    it('is a standing awaiting tile — never a fake green, never a number (TEN-2433)', () => {
+        const d = diagnoseM4();
+        expect(d.status).toBe('awaiting');
+        expect(d.metric).toBe('M4');
+        expect(d.cause).toMatch(/baseline/);
+        expect(d.nextAction).toMatch(/baseline arm|blind-judged/);
+        // chain-id-leak guard: the user-facing strings carry no raw Chain IDs.
+        expect(d.cause).not.toMatch(/\b[A-Z]{2,5}-\d+\b/);
+        expect(d.nextAction).not.toMatch(/\b[A-Z]{2,5}-\d+\b/);
+        // No invented number in the reading — it is a delta-or-nothing tile.
+        expect(d.reading).toMatch(/delta|baseline/i);
+    });
+});
+describe('diagnoseM5', () => {
+    it('is unmeasured (fail-soft) when the local projection is unavailable', () => {
+        const m5 = {
+            localProjectionMtime: null,
+            serverMaterializedAt: 123,
+            localLagMs: null,
+            localAgeMs: null,
+            unavailableReason: 'no .productbrain/ project root found',
+        };
+        const d = diagnoseM5(m5);
+        expect(d.status).toBe('unmeasured');
+        expect(d.reading).toContain('no .productbrain/');
+    });
+    it('is awaiting (threshold unpinned) when local drift is determinable', () => {
+        const m5 = {
+            localProjectionMtime: 1_000,
+            serverMaterializedAt: 2_000,
+            localLagMs: 1_000,
+            localAgeMs: 5_000,
+        };
+        const d = diagnoseM5(m5);
+        expect(d.status).toBe('awaiting');
+        expect(d.cause).toMatch(/unpinned/i);
+        // The CLAUDE.md-can't-drift framing is preserved.
+        expect(d.cause).toMatch(/CLAUDE\.md/);
+    });
+    it('is unmeasured (not awaiting) when the local projection exists but there is no server reference', () => {
+        // Local projection present, but no server materialization to diff against → the local-pull
+        // DRIFT (server−local) is undeterminable, so the honest status is unmeasured, not a misleading
+        // `awaiting` with local-lag=n/a. local-age is still surfaced.
+        const m5 = {
+            localProjectionMtime: 5_000,
+            serverMaterializedAt: null,
+            localLagMs: null,
+            localAgeMs: 3_000,
+        };
+        const d = diagnoseM5(m5);
+        expect(d.status).toBe('unmeasured');
+        expect(d.reading).toContain('local-age=');
+        expect(d.reading).toMatch(/drift undeterminable/i);
+    });
+});
+describe('diagnoseCoachingMoat', () => {
+    it('is a standing unmeasured line — four green tiles != healthy moat (TEN-2377)', () => {
+        const d = diagnoseCoachingMoat();
+        expect(d.status).toBe('unmeasured');
+        expect(d.cause).toMatch(/WHY-moat|TEN-2377|skips/i);
+        expect(d.nextAction).toMatch(/four green tiles/i);
+    });
+});
+describe('diagnose (bundle)', () => {
+    it('produces all five metric diagnoses plus the standing moat line', () => {
+        const payload = {
+            workspaceId: 'ws_1',
+            generatedAt: Date.now(),
+            m1: m1WithData,
+            m2: { divergentBuckets: 0, fullParity: true, task: null },
+            m3: {
+                capturedCount: 0,
+                everRatifiedCount: 0,
+                inSessionRatifiedCount: 0,
+                everRatifiedRate: null,
+                inSessionRatifiedRate: null,
+                sessionWindow: 20,
+                sessionsConsidered: 0,
+            },
+            materialization: { latestMaterializedAt: null, materializationAgeMs: null, now: Date.now() },
+        };
+        const m5 = {
+            localProjectionMtime: null,
+            serverMaterializedAt: null,
+            localLagMs: null,
+            localAgeMs: null,
+            unavailableReason: 'absent',
+        };
+        const bundle = diagnose(payload, m5);
+        expect(bundle.m1.status).toBe('awaiting');
+        expect(bundle.m2.status).toBe('ok');
+        expect(bundle.m3.status).toBe('unmeasured');
+        expect(bundle.m4.status).toBe('awaiting');
+        expect(bundle.m5.status).toBe('unmeasured');
+        expect(bundle.moat.status).toBe('unmeasured');
+    });
+});
+//# sourceMappingURL=diagnose.test.js.map

package/dist/scoreboard/diagnose.test.js.map

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

package/dist/scoreboard/localDrift.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Flywheel scoreboard M5 — LOCAL-PULL drift, computed at the CLI (DEC-1284).
+ *
+ * The data layer deliberately exposes only the SERVER-side projection-generation time
+ * (`materialization.latestMaterializedAt`) — a Convex query cannot stat the worktree's files
+ * (DEC-1284). The TRUE M5 the spec asks for is LOCAL-pull staleness: how far the agent's pulled
+ * `.productbrain/` projection lags the server projection (or its absolute age). Only the CLI can
+ * compute it, by stat-ing the local projection files' mtime. This module is that computation.
+ *
+ * Fail-soft: if `.productbrain/` is absent or no projection files are found, returns an
+ * `unavailableReason` so the diagnosis layer renders `unmeasured` — NEVER a fake `ok`.
+ */
+import type { LocalDriftM5 } from './diagnose.js';
+/**
+ * computeLocalDrift — the M5 local-pull drift (A5).
+ *
+ * @param serverMaterializedAt the data layer's `materialization.latestMaterializedAt` (ms epoch,
+ *   or null when the workspace never materialized server-side).
+ * @param now injectable clock for tests (defaults to Date.now()).
+ * @param startDir injectable start dir for tests (defaults to process.cwd()).
+ */
+export declare function computeLocalDrift(serverMaterializedAt: number | null, now?: number, startDir?: string): LocalDriftM5;
+//# sourceMappingURL=localDrift.d.ts.map

package/dist/scoreboard/localDrift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localDrift.d.ts","sourceRoot":"","sources":["../../src/scoreboard/localDrift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAwClD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,GAAG,GAAE,MAAmB,EACxB,QAAQ,GAAE,MAAsB,GAC/B,YAAY,CAkDd"}

package/dist/scoreboard/localDrift.js

@@ -0,0 +1,111 @@
+/**
+ * Flywheel scoreboard M5 — LOCAL-PULL drift, computed at the CLI (DEC-1284).
+ *
+ * The data layer deliberately exposes only the SERVER-side projection-generation time
+ * (`materialization.latestMaterializedAt`) — a Convex query cannot stat the worktree's files
+ * (DEC-1284). The TRUE M5 the spec asks for is LOCAL-pull staleness: how far the agent's pulled
+ * `.productbrain/` projection lags the server projection (or its absolute age). Only the CLI can
+ * compute it, by stat-ing the local projection files' mtime. This module is that computation.
+ *
+ * Fail-soft: if `.productbrain/` is absent or no projection files are found, returns an
+ * `unavailableReason` so the diagnosis layer renders `unmeasured` — NEVER a fake `ok`.
+ */
+import { existsSync, statSync, readdirSync } from 'fs';
+import { resolve } from 'path';
+import { findProjectRoot } from '../lib/config.js';
+/**
+ * The `pb handshake`-written projection files whose mtime tracks the local pull. These are the
+ * gitignored projections regenerated per worktree (context.md / briefing.md / generated/). We
+ * take the NEWEST mtime across whatever projection files exist — that is the most recent pull.
+ * `config.json` is excluded: it is committed + static, not a projection, so it never reflects a
+ * handshake pull.
+ */
+const PROJECTION_FILES = ['context.md', 'briefing.md'];
+const PROJECTION_DIRS = ['generated', 'rules'];
+/** Newest mtime (ms) across a set of candidate paths, or null if none exist. */
+function newestMtime(paths) {
+    let newest = null;
+    for (const p of paths) {
+        try {
+            if (!existsSync(p))
+                continue;
+            const st = statSync(p);
+            const mtime = st.mtimeMs;
+            if (newest === null || mtime > newest)
+                newest = mtime;
+        }
+        catch {
+            // unreadable path — skip, fail-soft
+        }
+    }
+    return newest;
+}
+/** Collect file paths one level deep inside a projection directory. */
+function filesInDir(dir) {
+    try {
+        if (!existsSync(dir))
+            return [];
+        return readdirSync(dir, { withFileTypes: true })
+            .filter((e) => e.isFile())
+            .map((e) => resolve(dir, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * computeLocalDrift — the M5 local-pull drift (A5).
+ *
+ * @param serverMaterializedAt the data layer's `materialization.latestMaterializedAt` (ms epoch,
+ *   or null when the workspace never materialized server-side).
+ * @param now injectable clock for tests (defaults to Date.now()).
+ * @param startDir injectable start dir for tests (defaults to process.cwd()).
+ */
+export function computeLocalDrift(serverMaterializedAt, now = Date.now(), startDir = process.cwd()) {
+    const projectRoot = findProjectRoot(startDir);
+    if (!projectRoot) {
+        return {
+            localProjectionMtime: null,
+            serverMaterializedAt,
+            localLagMs: null,
+            localAgeMs: null,
+            unavailableReason: 'no .productbrain/ project root found (walked up from CWD)',
+        };
+    }
+    const pbDir = resolve(projectRoot, '.productbrain');
+    if (!existsSync(pbDir)) {
+        return {
+            localProjectionMtime: null,
+            serverMaterializedAt,
+            localLagMs: null,
+            localAgeMs: null,
+            unavailableReason: `.productbrain/ missing at ${projectRoot}`,
+        };
+    }
+    const candidatePaths = [
+        ...PROJECTION_FILES.map((f) => resolve(pbDir, f)),
+        ...PROJECTION_DIRS.flatMap((d) => filesInDir(resolve(pbDir, d))),
+    ];
+    const localProjectionMtime = newestMtime(candidatePaths);
+    if (localProjectionMtime === null) {
+        return {
+            localProjectionMtime: null,
+            serverMaterializedAt,
+            localLagMs: null,
+            localAgeMs: null,
+            unavailableReason: 'no .productbrain/ projection files (context.md / briefing.md / generated/ / rules/) found — run pb handshake',
+        };
+    }
+    // local-lag = how far the local pull lags the server projection. Positive = server is newer
+    // (local is stale). Clamp at 0 (a local mtime ahead of the server is not "negative staleness").
+    const localLagMs = serverMaterializedAt === null ? null : Math.max(0, serverMaterializedAt - localProjectionMtime);
+    // local-age = absolute age of the local projection vs now.
+    const localAgeMs = Math.max(0, now - localProjectionMtime);
+    return {
+        localProjectionMtime,
+        serverMaterializedAt,
+        localLagMs,
+        localAgeMs,
+    };
+}
+//# sourceMappingURL=localDrift.js.map

package/dist/scoreboard/localDrift.js.map

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

package/dist/scoreboard/localDrift.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * M5 local-pull drift unit tests (A5, DEC-1284).
+ *
+ * Exercises computeLocalDrift over a real temp `.productbrain/` so the stat path is genuinely
+ * driven (not mocked): a config-bearing root (so findProjectRoot resolves) + a projection file
+ * whose mtime is the local pull. Asserts the lag/age math, the clamp, and the fail-soft branches.
+ */
+export {};
+//# sourceMappingURL=localDrift.test.d.ts.map

package/dist/scoreboard/localDrift.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localDrift.test.d.ts","sourceRoot":"","sources":["../../src/scoreboard/localDrift.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/scoreboard/localDrift.test.js

@@ -0,0 +1,82 @@
+/**
+ * M5 local-pull drift unit tests (A5, DEC-1284).
+ *
+ * Exercises computeLocalDrift over a real temp `.productbrain/` so the stat path is genuinely
+ * driven (not mocked): a config-bearing root (so findProjectRoot resolves) + a projection file
+ * whose mtime is the local pull. Asserts the lag/age math, the clamp, and the fail-soft branches.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, mkdirSync, writeFileSync, utimesSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { resolve } from 'path';
+import { computeLocalDrift } from './localDrift.js';
+let root;
+function setMtime(path, ms) {
+    const secs = ms / 1000;
+    utimesSync(path, secs, secs);
+}
+beforeEach(() => {
+    root = mkdtempSync(resolve(tmpdir(), 'pb-m5-'));
+    const pb = resolve(root, '.productbrain');
+    mkdirSync(pb, { recursive: true });
+    // config.json makes this a CLI project root (findProjectRoot requires it).
+    writeFileSync(resolve(pb, 'config.json'), JSON.stringify({ siteUrl: 'https://example.test' }));
+});
+afterEach(() => {
+    rmSync(root, { recursive: true, force: true });
+});
+describe('computeLocalDrift', () => {
+    it('fails soft to unavailable when no projection files exist', () => {
+        const d = computeLocalDrift(5_000, 10_000, root);
+        expect(d.localProjectionMtime).toBeNull();
+        expect(d.localLagMs).toBeNull();
+        expect(d.localAgeMs).toBeNull();
+        expect(d.unavailableReason).toMatch(/projection files/);
+    });
+    it('computes lag (server − local) and age (now − local) from the newest projection mtime', () => {
+        const pb = resolve(root, '.productbrain');
+        const ctx = resolve(pb, 'context.md');
+        writeFileSync(ctx, '# context');
+        setMtime(ctx, 1_000);
+        // Also write a newer briefing — newest mtime should win.
+        const brief = resolve(pb, 'briefing.md');
+        writeFileSync(brief, '# briefing');
+        setMtime(brief, 3_000);
+        const d = computeLocalDrift(5_000 /* server */, 10_000 /* now */, root);
+        expect(d.localProjectionMtime).toBe(3_000);
+        expect(d.serverMaterializedAt).toBe(5_000);
+        expect(d.localLagMs).toBe(2_000); // 5000 − 3000
+        expect(d.localAgeMs).toBe(7_000); // 10000 − 3000
+        expect(d.unavailableReason).toBeUndefined();
+    });
+    it('clamps lag at 0 when the local pull is newer than the server materialization', () => {
+        const pb = resolve(root, '.productbrain');
+        const ctx = resolve(pb, 'context.md');
+        writeFileSync(ctx, '# context');
+        setMtime(ctx, 9_000);
+        const d = computeLocalDrift(5_000, 10_000, root);
+        expect(d.localLagMs).toBe(0); // max(0, 5000 − 9000)
+        expect(d.localAgeMs).toBe(1_000);
+    });
+    it('returns null lag when the server never materialized', () => {
+        const pb = resolve(root, '.productbrain');
+        const ctx = resolve(pb, 'context.md');
+        writeFileSync(ctx, '# context');
+        setMtime(ctx, 2_000);
+        const d = computeLocalDrift(null, 10_000, root);
+        expect(d.localLagMs).toBeNull();
+        expect(d.localAgeMs).toBe(8_000);
+    });
+    it('reports unavailable when no project root is found', () => {
+        const bare = mkdtempSync(resolve(tmpdir(), 'pb-noroot-'));
+        try {
+            const d = computeLocalDrift(5_000, 10_000, bare);
+            expect(d.localProjectionMtime).toBeNull();
+            expect(d.unavailableReason).toMatch(/project root|missing/i);
+        }
+        finally {
+            rmSync(bare, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=localDrift.test.js.map

package/dist/scoreboard/localDrift.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localDrift.test.js","sourceRoot":"","sources":["../../src/scoreboard/localDrift.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,IAAI,IAAY,CAAC;AAEjB,SAAS,QAAQ,CAAC,IAAY,EAAE,EAAU;IACxC,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,2EAA2E;IAC3E,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC,CAAC;AACjG,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACtC,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAChC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrB,yDAAyD;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QACzC,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAEvB,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxE,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc;QAChD,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe;QACjD,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,aAAa,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACtC,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAChC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;QACpD,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACtC,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAChC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACjD,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC/D,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/setup/__tests__/coach-traces.test.d.ts

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

package/dist/setup/__tests__/coach-traces.test.d.ts.map

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

package/dist/setup/__tests__/coach-traces.test.js

@@ -0,0 +1,189 @@
+/**
+ * Cross-model coach validation harness — WP-431 S4 (doneWhen #16).
+ *
+ * Mock harness chosen for cross-model validation per TEN-1962 — deterministic,
+ * runs in CI without API keys. Live trace via dev-only Cursor Desktop documented
+ * separately if needed. The harness does NOT call any model; it simulates the
+ * criteria-progression loop encoded in `.productbrain/skills/pb-setup.md`
+ * Phase 3 and asserts convergence within 3 turns OR correct fallback to the
+ * FLO-72 Path C wizard (DEC-991).
+ *
+ * The fixture set covers cross-model behaviour by encoding three response
+ * shapes that any reasonable instruction-following model produces — the user's
+ * answer is the variable, the agent's response loop is the constant. The
+ * skill body is the universal SSOT (DEC-997); this harness exercises it.
+ */
+import { describe, expect, it } from 'vitest';
+/**
+ * Criteria check (verbatim from `.productbrain/skills/pb-setup.md` Phase 3):
+ *   "answer mentions a verb + a thing they do regularly".
+ *
+ * The criteria predicate keeps the test honest: it deterministically maps a
+ * user utterance to met/not-met. The tokeniser is intentionally simple — the
+ * skill text says "verb + thing", and that's what we look for.
+ */
+const VERB_HINTS = [
+    'ship',
+    'shipping',
+    'fix',
+    'fixing',
+    'write',
+    'writing',
+    'review',
+    'reviewing',
+    'build',
+    'building',
+    'integrate',
+    'integrating',
+    'design',
+    'designing',
+    'debug',
+    'debugging',
+    'refactor',
+    'refactoring',
+    'document',
+    'documenting',
+];
+const THING_HINTS = [
+    'feature',
+    'features',
+    'bug',
+    'bugs',
+    'copy',
+    'integration',
+    'integrations',
+    'review',
+    'reviews',
+    'issue',
+    'issues',
+    'doc',
+    'docs',
+    'api',
+    'apis',
+    'endpoint',
+    'endpoints',
+    'workflow',
+    'workflows',
+    'page',
+    'pages',
+    'rule',
+    'rules',
+];
+function meetsCriteria(answer) {
+    const lower = answer.toLowerCase();
+    const hasVerb = VERB_HINTS.some((v) => new RegExp(`\\b${v}\\b`).test(lower));
+    const hasThing = THING_HINTS.some((t) => new RegExp(`\\b${t}\\b`).test(lower));
+    return hasVerb && hasThing;
+}
+/**
+ * Run the coach loop encoded in pb-setup.md against a scripted user.
+ *
+ * Loop (verbatim from the skill):
+ *   1. Ask the open question.
+ *   2. If answer meets criteria -> progress.
+ *   3. If vague, ask one follow-up.
+ *   4. If 2 follow-ups don't yield, fall back to wizard (DEC-991).
+ *
+ * Convergence target (doneWhen #16): within 3 turns. Three turns means: the
+ * open question + at most two follow-ups. After the third turn without
+ * criteria-met, the agent MUST fall back to the wizard.
+ */
+function runCoachLoop(turns) {
+    const trace = [];
+    let followUps = 0;
+    for (let i = 0; i < turns.length; i++) {
+        const turn = turns[i];
+        const met = meetsCriteria(turn.user);
+        trace.push({ turn: i + 1, user: turn.user, met });
+        if (met) {
+            return {
+                state: 'criteria-met',
+                turnsUsed: i + 1,
+                finalAnswer: turn.user,
+                trace,
+            };
+        }
+        followUps += 1;
+        if (followUps >= 2) {
+            // Skill behaviour: "if 2 follow-ups don't yield, suggest a default
+            // catalog and let them pick (DEC-991 fallback path)".
+            return {
+                state: 'wizard-fallback',
+                turnsUsed: i + 1,
+                finalAnswer: turn.user,
+                trace,
+            };
+        }
+    }
+    // Out of scripted turns without convergence — treat as wizard-fallback so
+    // the test surfaces a faulty fixture rather than silently passing.
+    return {
+        state: 'wizard-fallback',
+        turnsUsed: turns.length,
+        finalAnswer: turns[turns.length - 1]?.user ?? '',
+        trace,
+    };
+}
+describe('Phase 3 coach loop — cross-model trace harness (TEN-1962)', () => {
+    it('Scenario A — happy path (specific answer, 1 turn)', () => {
+        const turns = [
+            { user: 'Mostly shipping new features for our SvelteKit app.' },
+        ];
+        const outcome = runCoachLoop(turns);
+        expect(outcome.state).toBe('criteria-met');
+        expect(outcome.turnsUsed).toBe(1);
+        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
+    });
+    it('Scenario B — vague then specific (follow-up, 2 turns)', () => {
+        const turns = [
+            { user: 'I dunno, various stuff.' },
+            { user: 'Last week I spent the most time fixing customer bugs.' },
+        ];
+        const outcome = runCoachLoop(turns);
+        expect(outcome.state).toBe('criteria-met');
+        expect(outcome.turnsUsed).toBe(2);
+        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
+    });
+    it('Scenario C — 2 vague turns triggers wizard fallback (DEC-991 path)', () => {
+        const turns = [
+            { user: 'Just code, you know how it is.' },
+            { user: 'Stuff. Things. The usual.' },
+        ];
+        const outcome = runCoachLoop(turns);
+        expect(outcome.state).toBe('wizard-fallback');
+        expect(outcome.turnsUsed).toBe(2);
+        // Convergence to a deterministic outcome (criteria-met OR wizard) within
+        // the 3-turn budget defends KEY-32 generalisation across surfaces.
+        expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
+    });
+    it('Scenario D — marketing copy answer (non-engineering domain, criteria still met)', () => {
+        const turns = [
+            { user: 'I write marketing copy and review pages from the design team.' },
+        ];
+        const outcome = runCoachLoop(turns);
+        expect(outcome.state).toBe('criteria-met');
+        expect(outcome.turnsUsed).toBe(1);
+    });
+    it('Scenario E — every fixture converges within the 3-turn budget', () => {
+        // Roll-up assertion across all scenarios so a future fixture addition that
+        // exceeds the budget surfaces here as a single named failure.
+        const fixtures = [
+            [{ user: 'Mostly shipping new features for our SvelteKit app.' }],
+            [
+                { user: 'I dunno, various stuff.' },
+                { user: 'Last week I spent the most time fixing customer bugs.' },
+            ],
+            [
+                { user: 'Just code, you know how it is.' },
+                { user: 'Stuff. Things. The usual.' },
+            ],
+            [{ user: 'I write marketing copy and review pages from the design team.' }],
+        ];
+        for (const turns of fixtures) {
+            const outcome = runCoachLoop(turns);
+            expect(outcome.turnsUsed).toBeLessThanOrEqual(3);
+            expect(['criteria-met', 'wizard-fallback']).toContain(outcome.state);
+        }
+    });
+});
+//# sourceMappingURL=coach-traces.test.js.map