@productbrain/cli 0.1.0-beta.98 → 0.1.0-beta.9800

package/dist/scoreboard/diagnose.test.js

@@ -0,0 +1,288 @@
+/**
+ * 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:
+ *   - Most flip thresholds remain unpinned (DEC-1282) → judged readings are `awaiting`, never an
+ *     invented number, and the raw reading is always present. M3's in-session-ratify floor and
+ *     M5's two age floors are the pinned exception (DEC-1513, WP-525) — see below.
+ *   - M4 (WP-487 Slice 2, FEAT-1374: the organic rework meter) reports raw distribution only —
+ *     `unmeasured` with nothing served yet, `awaiting` otherwise, never a fake green, never a
+ *     causality claim.
+ *   - Coaching/moat quality is a standing `unmeasured` line (TEN-2377).
+ */
+import { describe, it, expect } from 'vitest';
+import { diagnose, diagnoseM3, diagnoseM4, diagnoseM5, diagnoseM5FromServer, diagnoseCoachingMoat, } from './diagnose.js';
+describe('diagnoseM3', () => {
+    it('is degraded when the in-session ratify rate is below the pinned floor (DEC-1513)', () => {
+        const m3 = {
+            capturedCount: 8,
+            everRatifiedCount: 3,
+            inSessionRatifiedCount: 1,
+            everRatifiedRate: 0.375,
+            inSessionRatifiedRate: 0.05, // below the 10% pinned floor
+            sessionWindow: 20,
+            sessionsConsidered: 12,
+        };
+        const d = diagnoseM3(m3);
+        expect(d.status).toBe('degraded');
+        expect(d.reading).toContain('captured=8');
+        expect(d.cause).toMatch(/pinned floor/i);
+        expect(d.cause).toMatch(/10%/);
+        expect(d.cause).not.toMatch(/awaiting founder accept|PROPOSED pin/);
+        expect(d.nextAction).toMatch(/accept\/promote/i);
+        // chain-id-leak guard: the user-facing strings carry no raw Chain IDs (DEC-1513 is cited
+        // in code comments only, per this file's header — never interpolated into the string).
+        expect(d.cause).not.toMatch(/\b[A-Z]{2,5}-\d+\b/);
+        expect(d.nextAction).not.toMatch(/\b[A-Z]{2,5}-\d+\b/);
+    });
+    it('is ok when the in-session ratify rate meets the pinned floor (DEC-1513)', () => {
+        const m3 = {
+            capturedCount: 8,
+            everRatifiedCount: 3,
+            inSessionRatifiedCount: 1,
+            everRatifiedRate: 0.375,
+            inSessionRatifiedRate: 0.125, // above the 10% pinned floor
+            sessionWindow: 20,
+            sessionsConsidered: 12,
+        };
+        const d = diagnoseM3(m3);
+        expect(d.status).toBe('ok');
+        expect(d.nextAction).toBe('');
+        expect(d.cause).toMatch(/pinned floor/i);
+    });
+    it('fails soft to awaiting when the in-session rate is undeterminable (null) despite captures', () => {
+        const m3 = {
+            capturedCount: 8,
+            everRatifiedCount: 3,
+            inSessionRatifiedCount: 1,
+            everRatifiedRate: 0.375,
+            inSessionRatifiedRate: null,
+            sessionWindow: 20,
+            sessionsConsidered: 12,
+        };
+        const d = diagnoseM3(m3);
+        expect(d.status).toBe('awaiting');
+    });
+    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');
+    });
+});
+const m4Empty = {
+    reworkJoinWindowMs: 72 * 60 * 60 * 1000,
+    lookbackWindowMs: 30 * 24 * 60 * 60 * 1000,
+    now: Date.now(),
+    servedCount: 0,
+    unattributableServedCount: 0,
+    pendingObservationCount: 0,
+    decidedCount: 0,
+    firstTimeGoodCount: 0,
+    reworkedCount: 0,
+    firstTimeGoodShare: null,
+    signalCount: 0,
+    joinedSignalCount: 0,
+    unjoinedSignalCount: 0,
+    falseAttributionRate: null,
+    byClassification: { revision: 0, ci_review_correction: 0, user_override: 0 },
+    ciReviewCorrectionAttribution: { attributable: 0, notAttributable: 0, unspecified: 0 },
+    cohort: { workspaceId: 'ws_1', taskProvidedCount: 0, taskAbsentCount: 0 },
+};
+const m4WithData = {
+    reworkJoinWindowMs: 72 * 60 * 60 * 1000,
+    lookbackWindowMs: 30 * 24 * 60 * 60 * 1000,
+    now: Date.now(),
+    servedCount: 10,
+    unattributableServedCount: 1,
+    pendingObservationCount: 2,
+    decidedCount: 7,
+    firstTimeGoodCount: 5,
+    reworkedCount: 2,
+    firstTimeGoodShare: 5 / 7,
+    signalCount: 3,
+    joinedSignalCount: 2,
+    unjoinedSignalCount: 1,
+    falseAttributionRate: 1 / 3,
+    byClassification: { revision: 2, ci_review_correction: 1, user_override: 0 },
+    ciReviewCorrectionAttribution: { attributable: 1, notAttributable: 0, unspecified: 0 },
+    cohort: { workspaceId: 'ws_1', taskProvidedCount: 2, taskAbsentCount: 1 },
+};
+describe('diagnoseM4', () => {
+    it('is unmeasured when nothing has been served in the window yet', () => {
+        const d = diagnoseM4(m4Empty);
+        expect(d.status).toBe('unmeasured');
+        expect(d.metric).toBe('M4');
+        expect(d.cause).toMatch(/nothing to join/i);
+        expect(d.nextAction).toMatch(/pb orient|pb rework report/);
+    });
+    it('is awaiting (raw distribution, no invented threshold) whenever there IS served data', () => {
+        const d = diagnoseM4(m4WithData);
+        expect(d.status).toBe('awaiting');
+        expect(d.metric).toBe('M4');
+        // The raw numbers are always shown, never replaced by a verdict.
+        expect(d.reading).toContain('first-time-good=71%');
+        expect(d.reading).toContain('false-attribution=33%');
+        expect(d.reading).toContain('served=10');
+        expect(d.reading).toContain('signals=3');
+        // No causality claim (spec §6): association only, never "caused"/"proves"/"confirms".
+        expect(d.cause).not.toMatch(/\bcaused\b|\bproves\b|\bconfirms\b/i);
+        // 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/);
+    });
+});
+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 degraded when local-age exceeds the pinned floor (DEC-1513, real: ~14.1d > 10d)', () => {
+        // 10d, not 7d: this is the LOCAL-pull instrument's own single-observation calibration
+        // (PR #477 review fix, codex P2 — a prior draft mixed local-age and server-generation-age
+        // readings as if they were one series; each instrument now gets its own honest number).
+        const DAY = 1000 * 60 * 60 * 24;
+        const m5 = {
+            localProjectionMtime: 1_000,
+            serverMaterializedAt: 2_000,
+            localLagMs: 1_000,
+            localAgeMs: 14.1 * DAY,
+        };
+        const d = diagnoseM5(m5);
+        expect(d.status).toBe('degraded');
+        expect(d.cause).toMatch(/pinned staleness floor 10d/);
+        // The CLAUDE.md-can't-drift framing is preserved.
+        expect(d.cause).toMatch(/CLAUDE\.md/);
+        expect(d.cause).not.toMatch(/awaiting founder accept|PROPOSED pin|unpinned/i);
+        expect(d.cause).not.toMatch(/\b[A-Z]{2,5}-\d+\b/);
+    });
+    it('is ok when local-age is at/under the pinned floor (DEC-1513)', () => {
+        const DAY = 1000 * 60 * 60 * 24;
+        const m5 = {
+            localProjectionMtime: 1_000,
+            serverMaterializedAt: 2_000,
+            localLagMs: 1_000,
+            localAgeMs: 5 * DAY,
+        };
+        const d = diagnoseM5(m5);
+        expect(d.status).toBe('ok');
+        expect(d.nextAction).toBe('');
+    });
+    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('diagnoseM5FromServer', () => {
+    // PR #477 review fix (codex P2): diagnoseM5 (local-pull drift) and diagnoseM5FromServer
+    // (server-generation age) are two DIFFERENT instruments, each with its own pinned floor
+    // (DEC-1513) — 7d here, 10d for diagnoseM5 above. Never a shared "trend" number.
+    it('is ok when server-generation age is under its OWN pinned floor (DEC-1513, real: ~5.1d < 7d)', () => {
+        const DAY = 1000 * 60 * 60 * 24;
+        const materialization = {
+            latestMaterializedAt: 1_000,
+            materializationAgeMs: 5.1 * DAY,
+            now: 3_000,
+        };
+        const d = diagnoseM5FromServer(materialization);
+        expect(d.status).toBe('ok');
+        expect(d.cause).toMatch(/pinned staleness floor 7d/);
+        expect(d.nextAction).toBe('');
+        expect(d.cause).not.toMatch(/\b[A-Z]{2,5}-\d+\b/);
+    });
+    it('is degraded when server-generation age exceeds its OWN pinned floor (DEC-1513)', () => {
+        const DAY = 1000 * 60 * 60 * 24;
+        const materialization = {
+            latestMaterializedAt: 1_000,
+            materializationAgeMs: 8 * DAY,
+            now: 3_000,
+        };
+        const d = diagnoseM5FromServer(materialization);
+        expect(d.status).toBe('degraded');
+        expect(d.cause).not.toMatch(/awaiting founder accept|PROPOSED pin|unpinned/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 the three metric diagnoses plus the standing moat line', () => {
+        const payload = {
+            workspaceId: 'ws_1',
+            generatedAt: Date.now(),
+            m3: {
+                capturedCount: 0,
+                everRatifiedCount: 0,
+                inSessionRatifiedCount: 0,
+                everRatifiedRate: null,
+                inSessionRatifiedRate: null,
+                sessionWindow: 20,
+                sessionsConsidered: 0,
+            },
+            m4: m4WithData,
+            materialization: { latestMaterializedAt: null, materializationAgeMs: null, now: Date.now() },
+            coherence: {
+                openConflictCount: 0,
+                openConflictsTruncated: false,
+                reviewed: 0,
+                real: 0,
+                falseAlarm: 0,
+                reviewedTruncated: false,
+                humanBar: { meets: false, lowerBound: null, reviewed: 0 },
+                openUnverdicted: 0,
+                verdictedOpenCount: 0,
+                snoozedCount: 0,
+                totalOpen: 0,
+                totalOpenAlarm: false,
+                dial: { br170Graduated: false, br170GraduatedPinned: false, coherencyMode: 'light' },
+                detectionCoverage: { bySurface: {}, scanned: 0, truncated: false },
+                contradictionOverrideRate: { overrides: 0, heldBlocks: 0, rate: null, truncated: false },
+            },
+        };
+        const m5 = {
+            localProjectionMtime: null,
+            serverMaterializedAt: null,
+            localLagMs: null,
+            localAgeMs: null,
+            unavailableReason: 'absent',
+        };
+        const bundle = diagnose(payload, m5);
+        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/floors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SYNCED from packages/scoreboard-core/src/floors.ts — DO NOT EDIT HERE.
+ * Canonical SSOT for the flywheel scoreboard diagnosis, consumed by the published `pb` CLI.
+ * 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.
+ */
+/**
+ * Pinned scoreboard floors — DEC-1513 (founder accepted 2026-07-26, WP-525 kernel truth
+ * sweep).
+ *
+ * HOW TO TUNE: edit a `value` below and open ONE PR. This file is the single place these
+ * three numbers live — `packages/scoreboard-core/src/index.ts` imports and reads them,
+ * never redefines or re-derives them. After editing, run:
+ *   node scripts/sync-scoreboard-core.mjs
+ * to re-sync the published CLI copies (packages/cli/src/scoreboard/{diagnose,floors}.ts).
+ * `npm run check:mcp-lib-drift` (part of CI) fails the PR if a copy falls out of sync.
+ *
+ * NAMED SUCCESSOR (not built): a single shared, global calibration accepted from
+ * Product-OS's OWN observed distribution (docs/evals/PRESS-RELEASE-EVAL.md) — it is NOT
+ * proven to generalize to every tenant workspace. DEC-1513 accepts these three values as
+ * the workspace-wide floor with that explicit caveat; a future PER-WORKSPACE override is
+ * the named next step, not shipped here.
+ *
+ * DEC-1282 still governs the SEMANTICS: a diagnosis is advisory-never-blocking. Pinning
+ * these floors only lets diagnoseM3/diagnoseM5/diagnoseM5FromServer compute a real
+ * ok/degraded verdict instead of `awaiting` — it does not gate, block, or fail anything.
+ */
+/** A single pinned floor: the number plus why/when/who accepted it. */
+export interface PinnedFloor {
+    /** The pinned numeric floor. */
+    value: number;
+    /** Why this number, in one line — cites the calibration evidence, never invents one. */
+    rationale: string;
+    /** When the founder accepted it (ISO date). */
+    acceptedDate: string;
+    /** The Chain decision that accepted it. */
+    decision: string;
+}
+export declare const M3_IN_SESSION_FLOOR: PinnedFloor;
+/** M5 has TWO INCOMPARABLE age instruments — see diagnoseM5 vs diagnoseM5FromServer in
+ *  index.ts. Each carries its OWN single-observation calibration; never treat one as a
+ *  proxy for the other or as two points on a shared trend. */
+export declare const M5_LOCAL_AGE_FLOOR_DAYS: PinnedFloor;
+export declare const M5_SERVER_AGE_FLOOR_DAYS: PinnedFloor;
+//# sourceMappingURL=floors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"floors.d.ts","sourceRoot":"","sources":["../../src/scoreboard/floors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC3B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,EAAE,WAOjC,CAAC;AAEF;;8DAE8D;AAC9D,eAAO,MAAM,uBAAuB,EAAE,WAOrC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,WAOtC,CAAC"}

package/dist/scoreboard/floors.js

@@ -0,0 +1,33 @@
+/**
+ * SYNCED from packages/scoreboard-core/src/floors.ts — DO NOT EDIT HERE.
+ * Canonical SSOT for the flywheel scoreboard diagnosis, consumed by the published `pb` CLI.
+ * 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.
+ */
+export const M3_IN_SESSION_FLOOR = {
+    value: 0.1,
+    rationale: "Product-OS calibration baseline (docs/evals/PRESS-RELEASE-EVAL.md): in-session ratify rate observed 0% " +
+        'in every Product-OS run so far — a conservative early bar, not derived from any other workspace\'s history.',
+    acceptedDate: '2026-07-26',
+    decision: 'DEC-1513',
+};
+/** M5 has TWO INCOMPARABLE age instruments — see diagnoseM5 vs diagnoseM5FromServer in
+ *  index.ts. Each carries its OWN single-observation calibration; never treat one as a
+ *  proxy for the other or as two points on a shared trend. */
+export const M5_LOCAL_AGE_FLOOR_DAYS = {
+    value: 10,
+    rationale: 'Product-OS calibration: one on-record local-pull-drift age reading (14.1d, Run 1, docs/evals/' +
+        "PRESS-RELEASE-EVAL.md) — a single observation, not a trend.",
+    acceptedDate: '2026-07-26',
+    decision: 'DEC-1513',
+};
+export const M5_SERVER_AGE_FLOOR_DAYS = {
+    value: 7,
+    rationale: 'Product-OS calibration: one on-record server-generation-age reading (~5.1d, Run 3\'s materialization age, ' +
+        'docs/evals/PRESS-RELEASE-EVAL.md) — a single observation, not a trend.',
+    acceptedDate: '2026-07-26',
+    decision: 'DEC-1513',
+};
+//# sourceMappingURL=floors.js.map

package/dist/scoreboard/floors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floors.js","sourceRoot":"","sources":["../../src/scoreboard/floors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoCH,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC/C,KAAK,EAAE,GAAG;IACV,SAAS,EACR,yGAAyG;QACzG,6GAA6G;IAC9G,YAAY,EAAE,YAAY;IAC1B,QAAQ,EAAE,UAAU;CACpB,CAAC;AAEF;;8DAE8D;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAgB;IACnD,KAAK,EAAE,EAAE;IACT,SAAS,EACR,+FAA+F;QAC/F,6DAA6D;IAC9D,YAAY,EAAE,YAAY;IAC1B,QAAQ,EAAE,UAAU;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAgB;IACpD,KAAK,EAAE,CAAC;IACR,SAAS,EACR,4GAA4G;QAC5G,wEAAwE;IACzE,YAAY,EAAE,YAAY;IAC1B,QAAQ,EAAE,UAAU;CACpB,CAAC"}

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

package/dist/surfaces/__tests__/adapter.test.d.ts

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