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

package/dist/lib/workspaceVocabCache.js

@@ -0,0 +1,98 @@
+/**
+ * 5-minute TTL cache for workspace vocabulary context (WP-436 S2).
+ *
+ * Purpose (R2 mitigation): the CLI resolves vocabulary labels on every invocation.
+ * Without a cache, each `pb orient` / `pb get` / `pb capture` would call
+ * `chain.getVocabulary` — adding a Convex round-trip overhead and risking
+ * handshake-time staleness. A 5-min TTL short-circuits repeat calls within
+ * a typical session while staying fresh enough that label changes land quickly.
+ *
+ * PAT-230: the cache holds WorkspaceVocabCtx (pure data, no Convex imports here).
+ * DEC-1021: only Axis 2 (collectionLabels) lives here; Axis 1 (displayNames) is untouched.
+ *
+ * S4 note: when Cortex UI builds its `vocabularyStore`, it should mirror this
+ * contract — a keyed map by workspaceId with an expiresAt field (Cortex has
+ * direct access to workspaceId; the CLI uses apiKey as a 1:1 surrogate, since
+ * the HTTP gateway server-side injects workspaceId from authResult per
+ * convex/http.ts:675).
+ */
+const TTL_MS = 5 * 60 * 1000; // 5 minutes
+const STALE_WARN_MS = 4 * 60 * 1000; // warn after 4 minutes (1 minute before expiry)
+/** In-memory cache: cacheKey (CLI: apiKey; Cortex would use workspaceId) → CacheEntry. */
+const cache = new Map();
+/**
+ * Get a cached WorkspaceVocabCtx by cacheKey, or null if expired/missing.
+ * Prints a staleness warning when the entry is older than STALE_WARN_MS.
+ */
+export function getCachedVocabCtx(cacheKey) {
+    const entry = cache.get(cacheKey);
+    if (!entry)
+        return null;
+    const now = Date.now();
+    if (now >= entry.expiresAt) {
+        cache.delete(cacheKey);
+        return null;
+    }
+    if (now - (entry.expiresAt - TTL_MS) >= STALE_WARN_MS) {
+        // Staleness hint: labels were fetched > 4 min ago, will refresh within 1 min.
+        process.stderr.write(`[pb] Workspace vocabulary context is almost stale — will refresh on next invocation.\n`);
+    }
+    return entry.ctx;
+}
+/**
+ * Store a WorkspaceVocabCtx under cacheKey with a 5-min TTL.
+ */
+export function setCachedVocabCtx(cacheKey, ctx) {
+    cache.set(cacheKey, { ctx, expiresAt: Date.now() + TTL_MS });
+}
+/**
+ * Explicitly invalidate a cached vocab context by cacheKey.
+ * Call this when `updateCollectionLabels` mutation succeeds (e.g. after `pb handshake`).
+ */
+export function invalidateVocabCtx(cacheKey) {
+    cache.delete(cacheKey);
+}
+/**
+ * Clear all cached entries (useful for testing or `pb handshake --refresh`).
+ */
+export function clearVocabCache() {
+    cache.clear();
+}
+/**
+ * Get the cached vocab context, or fetch it via the provided async fetcher on cache miss.
+ *
+ * Usage pattern at CLI command sites:
+ * ```ts
+ * const vocabCtx = await getOrFetchVocabCtx(config.apiKey, async () => {
+ *   type VocabResult = { collectionLabels?: Record<string, unknown> };
+ *   const vocab = await kernelCall<VocabResult>('chain.getVocabulary', {});
+ *   return vocab?.collectionLabels
+ *     ? { collectionLabels: vocab.collectionLabels as WorkspaceVocabCtx['collectionLabels'] }
+ *     : null;
+ * });
+ * ```
+ *
+ * - `cacheKey`: use the API key as a surrogate for cacheKey (1:1 mapping at CLI layer).
+ * - `fetcher`: async function that resolves the vocab ctx; returns null on failure to signal
+ *   "don't cache, fall back to resolver literal". Fetcher errors are swallowed — vocabulary
+ *   labels are advisory (PAT-230 / fail-open principle).
+ *
+ * Returns WorkspaceVocabCtx on cache hit or successful fetch; undefined on error/null fetcher result.
+ */
+export async function getOrFetchVocabCtx(cacheKey, fetcher) {
+    const cached = getCachedVocabCtx(cacheKey);
+    if (cached)
+        return cached;
+    try {
+        const ctx = await fetcher();
+        if (ctx) {
+            setCachedVocabCtx(cacheKey, ctx);
+            return ctx;
+        }
+    }
+    catch {
+        // fail-open — vocabulary labels are advisory, never block the command
+    }
+    return undefined;
+}
+//# sourceMappingURL=workspaceVocabCache.js.map

package/dist/lib/workspaceVocabCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceVocabCache.js","sourceRoot":"","sources":["../../src/lib/workspaceVocabCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAC1C,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,gDAAgD;AAErF,0FAA0F;AAC1F,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAC3B,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QACtD,8EAA8E;QAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wFAAwF,CACzF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,GAAsB;IACxE,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAAgD;IAEhD,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,IAAI,GAAG,EAAE,CAAC;YACR,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACjC,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/scoreboard/diagnose.d.ts

@@ -0,0 +1,182 @@
+/**
+ * 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.
+ */
+/**
+ * Flywheel scoreboard — the DIAGNOSIS LAYER (spec §2d), SHARED SSOT.
+ *
+ * This is the layer that turns a raw number into the agent closing the loop. It is a PURE
+ * mapping (no I/O — no fs, no node, no Convex runtime) from the data-layer payload
+ * (M1/M2/M3/materialization, from the internal `scoreboard` action) PLUS the CLI-computed M5
+ * local-drift, to per-metric diagnoses: `{ status, reading, cause, nextAction }`.
+ *
+ * WHY THIS LIVES IN ITS OWN WORKSPACE PACKAGE (`@product-brain/scoreboard-core`): the diagnosis
+ * is consumed by BOTH the `pb` CLI (`packages/cli`, pretty + --json) AND the Cortex page
+ * (`src/routes/(app)/w/[slug]/scoreboard`). A shared workspace package is the repo's convention
+ * for framework-agnostic logic two non-Convex surfaces share (mirrors `@product-brain/doc-ast`).
+ * The CLI cannot import across the monorepo boundary at publish time, so it consumes this body
+ * through a committed copy guarded by a content-hash drift check (the same pattern mcp-server uses
+ * for `convex/lib/flags_core.ts` → `src/flags.ts`). The SvelteKit app imports it directly.
+ *
+ * NOTHING HERE TOUCHES fs/node/Convex — the CLI-only `computeLocalDrift` (which stats
+ * `.productbrain/`) stays in `packages/cli/src/scoreboard/localDrift.ts`. `diagnoseM5` itself is
+ * pure (it maps a LocalDriftM5 → diagnosis) and lives here; only the fs *collection* of that
+ * LocalDriftM5 is CLI-only.
+ *
+ * HONESTY OVER FLATTERY (spec §0, §2c). The hard rules this layer encodes:
+ *   - NO flip threshold is pinned yet (DEC-1282). Where a flip would decide ok/degraded, we
+ *     render `awaiting` ("threshold unpinned — pin against live distribution"), NEVER an
+ *     invented number. The RAW reading is always shown.
+ *   - M4 is DEFERRED (TEN-2433) and ABSENT from the data payload. It is surfaced as an explicit
+ *     `awaiting` tile ("awaiting baseline — run EXP-19"), NEVER a fake green.
+ *   - A STANDING `unmeasured` line for coaching/moat quality (TEN-2377): four green tiles ≠ a
+ *     healthy moat. The board must not imply moat health.
+ *   - Every `degraded`/`awaiting` carries a concrete `nextAction`.
+ *
+ * Pure + exported so the diagnosis unit tests assert the awaiting/unmeasured/degraded mapping
+ * without any network or filesystem.
+ */
+/** A metric's diagnosis status. */
+export type DiagnosisStatus = 'ok' | 'degraded' | 'awaiting' | 'unmeasured';
+export interface MetricDiagnosis {
+    /** The metric id (M1..M5) + a short human label. */
+    metric: string;
+    label: string;
+    status: DiagnosisStatus;
+    /** The raw reading, ALWAYS shown — never replaced by a verdict. */
+    reading: string;
+    /** Named cause of a degraded/awaiting/unmeasured reading (or the steady-state note). */
+    cause: string;
+    /** The concrete next action that closes the loop (empty string when status === 'ok'). */
+    nextAction: string;
+}
+export interface M1Payload {
+    mix: {
+        audited: number;
+        draft: number;
+        noDomain: number;
+        total: number;
+    };
+    noDomainShare: number | null;
+    auditedShare: number | null;
+    draftShare: number | null;
+    windowMs: number;
+    servedRowCount: number;
+}
+export interface M2Payload {
+    divergentBuckets: number;
+    fullParity: boolean;
+    task: string | null;
+}
+export interface M3Payload {
+    capturedCount: number;
+    everRatifiedCount: number;
+    inSessionRatifiedCount: number;
+    everRatifiedRate: number | null;
+    inSessionRatifiedRate: number | null;
+    sessionWindow: number;
+    sessionsConsidered: number;
+}
+export interface MaterializationPayload {
+    latestMaterializedAt: number | null;
+    materializationAgeMs: number | null;
+    now: number;
+}
+export interface ScoreboardPayload {
+    workspaceId: string;
+    generatedAt: number;
+    m1: M1Payload;
+    m2: M2Payload;
+    m3: M3Payload;
+    materialization: MaterializationPayload;
+}
+/**
+ * The CLI-computed M5 local-pull drift (A5). Produced by computeLocalDrift() (NOT the data
+ * layer — DEC-1284). `null` fields mean the local `.productbrain/` projection (or the server
+ * materialization) was unavailable; the diagnosis fails soft to `awaiting`.
+ */
+export interface LocalDriftM5 {
+    /** Newest mtime across the local `.productbrain/` projection files, ms epoch. Null = absent. */
+    localProjectionMtime: number | null;
+    /** Server-side projection generation time (materialization.latestMaterializedAt). */
+    serverMaterializedAt: number | null;
+    /** How far the local pull lags the server projection, ms (server − local). Null when undeterminable. */
+    localLagMs: number | null;
+    /** Absolute age of the local projection vs now, ms. Null when the projection is absent. */
+    localAgeMs: number | null;
+    /** Set when `.productbrain/` could not be located/stat'd — diagnosis = awaiting, not a fake ok. */
+    unavailableReason?: string;
+}
+/**
+ * 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 declare function diagnoseM1(m1: M1Payload): MetricDiagnosis;
+/**
+ * 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 declare function diagnoseM2(m2: M2Payload): MetricDiagnosis;
+/**
+ * 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 declare function diagnoseM3(m3: M3Payload): MetricDiagnosis;
+/**
+ * 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 declare function diagnoseM4(): MetricDiagnosis;
+/**
+ * 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 declare function diagnoseM5(m5: LocalDriftM5): MetricDiagnosis;
+/**
+ * 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 declare function diagnoseM5FromServer(materialization: MaterializationPayload): MetricDiagnosis;
+/**
+ * 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 declare function diagnoseCoachingMoat(): MetricDiagnosis;
+/** The full diagnosis bundle the CLI renders + emits in --json. */
+export interface ScoreboardDiagnosis {
+    m1: MetricDiagnosis;
+    m2: MetricDiagnosis;
+    m3: MetricDiagnosis;
+    m4: MetricDiagnosis;
+    m5: MetricDiagnosis;
+    /** Standing honesty marker — coaching/moat quality is unmeasured. */
+    moat: MetricDiagnosis;
+}
+/**
+ * diagnose — the whole mapping: data-layer payload + CLI-computed M5 local-drift → per-metric
+ * diagnoses + the standing M4-awaiting + coaching-unmeasured lines. Pure.
+ */
+export declare function diagnose(payload: ScoreboardPayload, m5: LocalDriftM5): ScoreboardDiagnosis;
+/**
+ * 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 declare function diagnoseFromServer(payload: ScoreboardPayload): ScoreboardDiagnosis;
+//# sourceMappingURL=diagnose.d.ts.map

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

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

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