@productbrain/cli 0.1.0-beta.1440 → 0.1.0-beta.1463

package/dist/scoreboard/diagnose.js

@@ -0,0 +1,250 @@
+/**
+ * SYNCED from packages/scoreboard-core/src/index.ts — DO NOT EDIT HERE.
+ * Canonical SSOT for the flywheel scoreboard diagnosis (consumed by BOTH the published
+ * `pb` CLI and the Cortex page). The CLI cannot import the workspace package at publish time
+ * (tsc, no bundler), so it carries this committed copy. Edit the source, then run:
+ *   node scripts/sync-scoreboard-core.mjs
+ * A content-hash drift gate (scripts/check-mcp-lib-drift.mjs) fails CI if this drifts.
+ */
+// User-facing copy carries NO raw Chain IDs (chain-id-leak guard): the CLI prints `cause` /
+// `nextAction` / `reading` verbatim to any workspace's terminal, so an ID here would leak our
+// internal governance refs cross-tenant. The governing entry (the no-flip-threshold decision) is
+// cited in code comments only, never in these strings.
+const UNPINNED = 'threshold unpinned — pin against the live distribution';
+function pct(n) {
+    return n === null ? 'n/a' : `${(n * 100).toFixed(0)}%`;
+}
+function ms(n) {
+    if (n === null)
+        return 'n/a';
+    const h = n / (1000 * 60 * 60);
+    if (h < 1)
+        return `${(n / (1000 * 60)).toFixed(0)}m`;
+    if (h < 48)
+        return `${h.toFixed(1)}h`;
+    return `${(h / 24).toFixed(1)}d`;
+}
+/**
+ * M1 — retrieval truth-state mix. The no-domain-share flip (INS-1775 floor) is UNPINNED, so the
+ * status is `awaiting` whenever there is data to judge (we never invent the 50% floor). With zero
+ * serves it is `unmeasured` (nothing served yet). The named cause for a high no-domain share is
+ * "domains unratified".
+ */
+export function diagnoseM1(m1) {
+    const reading = `served=${m1.mix.total} · audited=${pct(m1.auditedShare)} · draft=${pct(m1.draftShare)} · ` +
+        `no-domain=${pct(m1.noDomainShare)} (window ${ms(m1.windowMs)})`;
+    if (m1.mix.total === 0) {
+        return {
+            metric: 'M1',
+            label: 'Retrieval truth-state mix',
+            status: 'unmeasured',
+            reading,
+            cause: 'no governance served in the window yet — nothing to classify',
+            nextAction: 'drive an orient/start_pb serve, then re-read',
+        };
+    }
+    return {
+        metric: 'M1',
+        label: 'Retrieval truth-state mix',
+        status: 'awaiting',
+        reading,
+        cause: `no-domain-share floor ${UNPINNED}`,
+        // INS-1775 records the ≈57% no-domain baseline — cited here in a comment, not the user string.
+        nextAction: 'pin the no-domain floor (≈57% measured baseline); if no-domain stays high, domains are unratified → ratify the inferred-domain binding entries',
+    };
+}
+/**
+ * M2 — ranking agreement (tests the unify integrity). This one HAS a clean structural signal:
+ * post-unify, full parity (divergentBuckets === 0) is the EXPECTED steady state — that's `ok`.
+ * A non-zero divergence IS the regression signal — `degraded` — and the M2-magnitude flip stays
+ * unpinned, but the structural ok/degraded does not need a number (0 vs non-0 is exact).
+ */
+export function diagnoseM2(m2) {
+    const reading = `divergentBuckets=${m2.divergentBuckets} · fullParity=${m2.fullParity}${m2.task ? ` · task="${m2.task}"` : ''}`;
+    if (m2.fullParity && m2.divergentBuckets === 0) {
+        return {
+            metric: 'M2',
+            label: 'Ranking agreement (unify integrity)',
+            status: 'ok',
+            reading,
+            cause: 'orient ↔ start_pb render identical set+order+tier — the unify holds',
+            nextAction: '',
+        };
+    }
+    return {
+        metric: 'M2',
+        label: 'Ranking agreement (unify integrity)',
+        status: 'degraded',
+        reading,
+        cause: 'the two surfaces re-forked — one is selecting/ordering governance outside the shared ranker',
+        // The ranking-unify tension is TEN-2431 — cited in the comment, kept out of the user string.
+        nextAction: 'diff getOrientEntries vs getBindingGovernanceView; restore the shared ranker as the single source',
+    };
+}
+/**
+ * M3 — draft-to-SSOT rate. The in-session-ratify floor (ASM-45 rolling-20 window) is UNPINNED,
+ * so a judged reading is `awaiting`. Zero captures in the window → `unmeasured`.
+ */
+export function diagnoseM3(m3) {
+    const reading = `captured=${m3.capturedCount} · in-session=${pct(m3.inSessionRatifiedRate)} · ` +
+        `ever=${pct(m3.everRatifiedRate)} (over ${m3.sessionsConsidered}/${m3.sessionWindow} sessions)`;
+    if (m3.capturedCount === 0) {
+        return {
+            metric: 'M3',
+            label: 'Draft-to-SSOT rate',
+            status: 'unmeasured',
+            reading,
+            cause: 'no captures in the rolling session window — nothing to rate',
+            nextAction: 'capture in-session (pb capture), then re-read after the human accepts in Cortex',
+        };
+    }
+    return {
+        metric: 'M3',
+        label: 'Draft-to-SSOT rate',
+        status: 'awaiting',
+        reading,
+        // ASM-45 (the draft-graveyard hypothesis + rolling-20-session design) governs this metric —
+        // cited in comments; the user strings stay ID-free.
+        cause: `in-session ratify floor ${UNPINNED} (rolling-20-session design)`,
+        nextAction: 'pin the in-session floor (X); if rate is below it, the draft-graveyard is confirmed → accept/promote captures in Cortex',
+    };
+}
+/**
+ * M4 — first-time-good (rework proxy). DEFERRED (TEN-2433) and ABSENT from the data payload.
+ * ALWAYS surfaced as an explicit `awaiting` tile — never a fake green, never a number. (Pure —
+ * takes no input; the tile is standing.)
+ */
+export function diagnoseM4() {
+    return {
+        metric: 'M4',
+        // The baseline-arm evidence sprint is EXP-19 (kept out of the user-facing label per the
+        // chain-id-leak guard; the entry id still rides nextAction, which is not a user-facing sink).
+        label: 'First-time-good (value)',
+        status: 'awaiting',
+        reading: 'no baseline arm yet — renders only as a PB-vs-baseline delta, never a lone number',
+        // The served↔rework git/CI join is deferred (TEN-2433); the baseline arm comes from the
+        // paired blind-judged A/B sprint (EXP-19). Both cited in comments, kept out of the user copy.
+        cause: 'awaiting baseline — the served↔rework join is not built; deferred from the data layer',
+        nextAction: 'run the paired blind-judged A/B sprint to populate the baseline arm',
+    };
+}
+/**
+ * M5 — projection staleness, computed as LOCAL-PULL drift at the CLI (DEC-1284). The staleness-age
+ * flip is UNPINNED, so a determinable reading is `awaiting`. When the local `.productbrain/`
+ * projection (or the server materialization) is unavailable, the status is `unmeasured` with the
+ * reason — fail-soft, never a fake ok.
+ */
+export function diagnoseM5(m5) {
+    if (m5.unavailableReason || m5.localProjectionMtime === null) {
+        return {
+            metric: 'M5',
+            label: 'Projection staleness (local-pull drift)',
+            status: 'unmeasured',
+            reading: m5.unavailableReason ?? 'local .productbrain/ projection not found',
+            cause: 'cannot stat the local projection — local-pull drift is undeterminable here',
+            nextAction: 'run from a worktree with a materialized .productbrain/ (pb handshake), then re-read',
+        };
+    }
+    // The local projection exists, but with NO server materialization (e.g. missing/expired
+    // setup_receipt) there is no reference to diff against — the local-pull DRIFT (server−local,
+    // this metric's whole definition) is undeterminable. Report `unmeasured` (honesty over flattery)
+    // rather than `awaiting` with a `local-lag=n/a` that implies the drift is merely awaiting a
+    // threshold. local-age is still surfaced as the one signal we can honestly read.
+    if (m5.serverMaterializedAt === null || m5.localLagMs === null) {
+        return {
+            metric: 'M5',
+            label: 'Projection staleness (local-pull drift)',
+            status: 'unmeasured',
+            reading: `local-age=${ms(m5.localAgeMs)} · server materialization: none (drift undeterminable)`,
+            cause: 'no server materialization to diff against — local-pull drift (server−local) cannot be computed',
+            nextAction: 'materialize the projection server-side (pb handshake), then re-read to measure drift',
+        };
+    }
+    const lag = m5.localLagMs;
+    const age = m5.localAgeMs;
+    const reading = `local-lag=${ms(lag)} (server−local) · local-age=${ms(age)}`;
+    return {
+        metric: 'M5',
+        label: 'Projection staleness (local-pull drift)',
+        status: 'awaiting',
+        reading,
+        cause: `staleness-age threshold ${UNPINNED}; this is the one metric where PB can be staler than the never-drifting CLAUDE.md file`,
+        nextAction: 're-run pb handshake to re-pull the projection if the lag/age looks high',
+    };
+}
+/**
+ * M5 (server view) — the Cortex page has NO local filesystem, so it cannot compute the spec's
+ * local-pull drift (DEC-1284). It reads only the server-side projection-generation building block
+ * (`materialization.latestMaterializedAt` / age) the public action already returns — adding NO new
+ * truth (spec §2d). This is deliberately a DIFFERENT, HONEST framing from `diagnoseM5`: it is
+ * SERVER-generation age, never claimed to be the local-pull staleness the CLI measures. The
+ * staleness-age flip is UNPINNED → `awaiting` when there is a materialization; `unmeasured` when
+ * the workspace has never materialized.
+ */
+export function diagnoseM5FromServer(materialization) {
+    if (materialization.latestMaterializedAt === null) {
+        return {
+            metric: 'M5',
+            label: 'Projection staleness (server generation age)',
+            status: 'unmeasured',
+            reading: 'no materialization receipt yet — the projection has never been generated server-side',
+            cause: 'nothing to age — the workspace has not materialized its projection',
+            nextAction: 'run pb handshake to materialize the projection, then re-read',
+        };
+    }
+    const age = materialization.materializationAgeMs;
+    return {
+        metric: 'M5',
+        label: 'Projection staleness (server generation age)',
+        status: 'awaiting',
+        reading: `server-generation age=${ms(age)} (browser view: local-pull drift is CLI-only)`,
+        cause: `staleness-age threshold ${UNPINNED}; this is the one metric where PB can be staler than the never-drifting CLAUDE.md file`,
+        nextAction: 're-run pb handshake to re-generate the projection if the age looks high',
+    };
+}
+/**
+ * The STANDING coaching/moat-quality `unmeasured` line (TEN-2377). It is NOT a tile with a number —
+ * it is a permanent honesty marker so four green tiles are never read as "the moat is healthy".
+ */
+export function diagnoseCoachingMoat() {
+    return {
+        metric: 'MOAT',
+        label: 'Coaching / moat quality',
+        status: 'unmeasured',
+        // The standing-unmeasured tension is TEN-2377; the real instrument is ASM-46's
+        // blind-padding-rate test. Both cited in comments, kept out of the user-facing strings.
+        reading: 'structurally unmeasured',
+        cause: 'the coach skips decision/standard/business-rule (the WHY-moat types) — a counter would flatter the board',
+        nextAction: 'do NOT read four green tiles as a healthy moat; the real instrument is the blind-padding-rate test',
+    };
+}
+/**
+ * diagnose — the whole mapping: data-layer payload + CLI-computed M5 local-drift → per-metric
+ * diagnoses + the standing M4-awaiting + coaching-unmeasured lines. Pure.
+ */
+export function diagnose(payload, m5) {
+    return {
+        m1: diagnoseM1(payload.m1),
+        m2: diagnoseM2(payload.m2),
+        m3: diagnoseM3(payload.m3),
+        m4: diagnoseM4(),
+        m5: diagnoseM5(m5),
+        moat: diagnoseCoachingMoat(),
+    };
+}
+/**
+ * diagnoseFromServer — the Cortex-page mapping: it has the public action payload but NO local fs,
+ * so M5 is the server-generation-age view (`diagnoseM5FromServer`) rather than the CLI local-pull
+ * drift. Everything else is identical to `diagnose`. Pure, browser-safe.
+ */
+export function diagnoseFromServer(payload) {
+    return {
+        m1: diagnoseM1(payload.m1),
+        m2: diagnoseM2(payload.m2),
+        m3: diagnoseM3(payload.m3),
+        m4: diagnoseM4(),
+        m5: diagnoseM5FromServer(payload.materialization),
+        moat: diagnoseCoachingMoat(),
+    };
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/scoreboard/diagnose.js.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * 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).
+ */
+export {};
+//# sourceMappingURL=diagnose.test.d.ts.map

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

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

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