@productbrain/cli 0.1.0-beta.99 → 0.1.0-beta.9900

package/dist/lib/method-registry.js

@@ -1,6 +1,15 @@
 /**
  * method-registry.ts — load pb method registry (WP-310 E4).
- * Chain-first with bundled fallback. Used during handshake when manifest is present.
+ *
+ * Loads the BUNDLED registry JSON. Used during handshake when a manifest is present.
+ *
+ * History (TEN-2783): this used to be "Chain-first with bundled fallback", attempting a
+ * `chain.getMethodRegistry` gateway call before falling back. That route was never registered in
+ * the gateway (absent from `packages/kernel-client/src/generated/routes.generated.ts`), so the
+ * call threw on every handshake since introduction and the bundled path was ALWAYS the real one.
+ * The dead attempt was removed so the bundled registry is the honest, single primary — no
+ * misleading `source: 'chain'` that could never occur, no orphan `chain.getMethodRegistry` call
+ * for the called-route gate to carve out.
  */
 import { readFileSync } from 'fs';
 import { join } from 'path';
@@ -21,32 +30,11 @@ function isStaleFn(generatedAt) {
     return now - generated > FRESHNESS_DAYS * 24 * 60 * 60 * 1000;
 }
 /**
- * Load the pb method registry.
- *
- * @param methodSource - from manifest.method_source: 'chain' | 'bundled' | undefined
- * @param chainFetch   - function that calls a Chain API endpoint (kernelCall signature)
+ * Load the pb method registry from the bundled JSON.
  *
- * Resolution order:
- *   - 'bundled' → skip Chain, load bundled JSON
- *   - 'chain' or undefined → try Chain first; on error fall through to bundled
+ * Async to preserve the caller's `.catch(() => null)` on a read failure (missing/corrupt bundle).
  */
-export async function loadMethodRegistry(methodSource, chainFetch) {
-    // Explicitly bundled — skip Chain attempt
-    if (methodSource === 'bundled') {
-        const registry = loadBundled();
-        return { registry, source: 'bundled', stale: isStaleFn(registry.generatedAt) };
-    }
-    // method_source: 'chain' or undefined — try Chain first
-    try {
-        const data = await chainFetch('chain.getMethodRegistry', {});
-        if (data && typeof data === 'object' && 'methods' in data) {
-            return { registry: data, source: 'chain', stale: false };
-        }
-    }
-    catch {
-        // Chain unreachable or returned unexpected shape — fall through to bundled
-    }
-    // Bundled fallback
+export async function loadMethodRegistry() {
     const registry = loadBundled();
     return { registry, source: 'bundled', stale: isStaleFn(registry.generatedAt) };
 }

package/dist/lib/method-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"method-registry.js","sourceRoot":"","sources":["../../src/lib/method-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAqBpC,iGAAiG;AACjG,wFAAwF;AACxF,wGAAwG;AACxG,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,CAAC,CAAC;AAC/F,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAAC,WAAmB;IACpC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,GAAG,GAAG,SAAS,GAAG,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAChE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAA6C,EAC7C,UAA2E;IAE3E,0CAA0C;IAC1C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;IACjF,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YAC1D,OAAO,EAAE,QAAQ,EAAE,IAAsB,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;IAC7E,CAAC;IAED,mBAAmB;IACnB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;AACjF,CAAC"}
+{"version":3,"file":"method-registry.js","sourceRoot":"","sources":["../../src/lib/method-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAsBpC,iGAAiG;AACjG,wFAAwF;AACxF,wGAAwG;AACxG,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,CAAC,CAAC;AAC/F,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAAC,WAAmB;IACpC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,GAAG,GAAG,SAAS,GAAG,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;AACjF,CAAC"}

package/dist/lib/normalizeMaterializedFilename.d.ts

@@ -0,0 +1,28 @@
+/**
+ * normalizeMaterializedFilename — WP-379 S5b
+ *
+ * Produces a lowercase, slug-friendly filename from an asset name.
+ * Used by findLeftoverProjections/findLeftoverCursorSkills to compare on-disk filenames (which
+ * may have been projected with a non-normalized case) against the canonical lowercase form
+ * that handshake now writes.
+ *
+ * Contract:
+ *   - Output is lowercase.
+ *   - Non-alphanumeric, non-dot characters are replaced with hyphens.
+ *   - Leading dots (hidden-file convention) are stripped.
+ *   - Multiple consecutive hyphens are collapsed to a single hyphen.
+ *   - Leading and trailing hyphens are trimmed.
+ *   - Unicode characters that don't map to ASCII letters/digits are dropped.
+ *   - Idempotent: applying the function twice yields the same result.
+ *   - Empty input → empty output.
+ *
+ * Chain: WP-379 S5b.
+ */
+/**
+ * Normalize a materializedFilename to its canonical lowercase slug form.
+ *
+ * @param name  The raw filename (e.g. "Setup-ProductBrain.mdc").
+ * @returns     The normalized filename (e.g. "setup-productbrain.mdc").
+ */
+export declare function normalizeMaterializedFilename(name: string): string;
+//# sourceMappingURL=normalizeMaterializedFilename.d.ts.map

package/dist/lib/normalizeMaterializedFilename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeMaterializedFilename.d.ts","sourceRoot":"","sources":["../../src/lib/normalizeMaterializedFilename.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkClE"}

package/dist/lib/normalizeMaterializedFilename.js

@@ -0,0 +1,56 @@
+/**
+ * normalizeMaterializedFilename — WP-379 S5b
+ *
+ * Produces a lowercase, slug-friendly filename from an asset name.
+ * Used by findLeftoverProjections/findLeftoverCursorSkills to compare on-disk filenames (which
+ * may have been projected with a non-normalized case) against the canonical lowercase form
+ * that handshake now writes.
+ *
+ * Contract:
+ *   - Output is lowercase.
+ *   - Non-alphanumeric, non-dot characters are replaced with hyphens.
+ *   - Leading dots (hidden-file convention) are stripped.
+ *   - Multiple consecutive hyphens are collapsed to a single hyphen.
+ *   - Leading and trailing hyphens are trimmed.
+ *   - Unicode characters that don't map to ASCII letters/digits are dropped.
+ *   - Idempotent: applying the function twice yields the same result.
+ *   - Empty input → empty output.
+ *
+ * Chain: WP-379 S5b.
+ */
+/**
+ * Normalize a materializedFilename to its canonical lowercase slug form.
+ *
+ * @param name  The raw filename (e.g. "Setup-ProductBrain.mdc").
+ * @returns     The normalized filename (e.g. "setup-productbrain.mdc").
+ */
+export function normalizeMaterializedFilename(name) {
+    if (!name)
+        return '';
+    // 1. Strip leading dots (hidden-file prefix, e.g. ".cursor/rules/.hidden.mdc").
+    //    We only strip a single leading dot cluster at the start of the basename,
+    //    not dots that are part of extensions or internal names.
+    const stripped = name.startsWith('.') ? name.replace(/^\.+/, '') : name;
+    if (!stripped)
+        return '';
+    // 2. Lowercase the entire name (covers ASCII + Unicode basic-latin).
+    const lowered = stripped.toLowerCase();
+    // 3. Normalize Unicode: decompose then remove non-ASCII code points that
+    //    didn't map cleanly (e.g. accented chars become their base form via NFD
+    //    decomposition, then the combining diacritics are removed).
+    //    NFKD decomposes ligatures and compatibility forms as well.
+    const ascii = lowered
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '') // strip combining diacritics
+        .replace(/[^\x00-\x7F]/g, ''); // drop remaining non-ASCII
+    // 4. Replace any sequence of non-alphanumeric + non-dot characters with a
+    //    single hyphen.  We preserve dots so that ".mdc" and ".md" extensions
+    //    are maintained in the output.
+    const slugged = ascii.replace(/[^a-z0-9.]+/g, '-');
+    // 5. Collapse consecutive hyphens → single hyphen.
+    const collapsed = slugged.replace(/-{2,}/g, '-');
+    // 6. Trim leading and trailing hyphens.
+    const trimmed = collapsed.replace(/^-+|-+$/g, '');
+    return trimmed;
+}
+//# sourceMappingURL=normalizeMaterializedFilename.js.map

package/dist/lib/normalizeMaterializedFilename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeMaterializedFilename.js","sourceRoot":"","sources":["../../src/lib/normalizeMaterializedFilename.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,gFAAgF;IAChF,8EAA8E;IAC9E,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,qEAAqE;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEvC,yEAAyE;IACzE,4EAA4E;IAC5E,gEAAgE;IAChE,gEAAgE;IAChE,MAAM,KAAK,GAAG,OAAO;SAClB,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,6BAA6B;SACnD,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAG,2BAA2B;IAE9D,0EAA0E;IAC1E,0EAA0E;IAC1E,mCAAmC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAEnD,mDAAmD;IACnD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAEjD,wCAAwC;IACxC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/normalizeMaterializedFilename.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * normalizeMaterializedFilename unit tests — WP-379 S5b.
+ *
+ * Contract assertions:
+ *   - Setup-ProductBrain.mdc → setup-productbrain.mdc
+ *   - Already-normalized input is idempotent
+ *   - Unicode chars that map to ASCII (via NFKD) retain base form; others dropped
+ *   - Leading dot stripped; file is otherwise preserved
+ *   - Empty input returns empty string
+ *   - Extension dots are preserved
+ *   - Non-alphanumeric sequences → single hyphen
+ *
+ * Chain: WP-379 S5b.
+ */
+export {};
+//# sourceMappingURL=normalizeMaterializedFilename.test.d.ts.map

package/dist/lib/normalizeMaterializedFilename.test.d.ts.map

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

package/dist/lib/normalizeMaterializedFilename.test.js

@@ -0,0 +1,90 @@
+/**
+ * normalizeMaterializedFilename unit tests — WP-379 S5b.
+ *
+ * Contract assertions:
+ *   - Setup-ProductBrain.mdc → setup-productbrain.mdc
+ *   - Already-normalized input is idempotent
+ *   - Unicode chars that map to ASCII (via NFKD) retain base form; others dropped
+ *   - Leading dot stripped; file is otherwise preserved
+ *   - Empty input returns empty string
+ *   - Extension dots are preserved
+ *   - Non-alphanumeric sequences → single hyphen
+ *
+ * Chain: WP-379 S5b.
+ */
+import { describe, expect, it } from 'vitest';
+import { normalizeMaterializedFilename } from './normalizeMaterializedFilename.js';
+describe('normalizeMaterializedFilename', () => {
+    // ── Primary contract test (from bet spec) ───────────────────────────────────
+    it('Setup-ProductBrain.mdc → setup-productbrain.mdc', () => {
+        expect(normalizeMaterializedFilename('Setup-ProductBrain.mdc')).toBe('setup-productbrain.mdc');
+    });
+    // ── Idempotency ──────────────────────────────────────────────────────────────
+    it('already-normalized input is idempotent', () => {
+        const normalized = 'setup-productbrain.mdc';
+        expect(normalizeMaterializedFilename(normalized)).toBe(normalized);
+    });
+    it('applying twice produces the same result', () => {
+        const input = 'My Rule File.md';
+        const once = normalizeMaterializedFilename(input);
+        const twice = normalizeMaterializedFilename(once);
+        expect(once).toBe(twice);
+    });
+    // ── Uppercase handling ────────────────────────────────────────────────────────
+    it('lowercases all ASCII letters', () => {
+        expect(normalizeMaterializedFilename('CHAIN-RULES.mdc')).toBe('chain-rules.mdc');
+    });
+    it('mixed case with spaces → lowercase with hyphens', () => {
+        expect(normalizeMaterializedFilename('My Custom Rule.md')).toBe('my-custom-rule.md');
+    });
+    // ── Unicode normalization ─────────────────────────────────────────────────────
+    it('accented chars via NFKD → base ASCII (é → e)', () => {
+        expect(normalizeMaterializedFilename('Régle.md')).toBe('regle.md');
+    });
+    it('non-ASCII chars that cannot normalize → dropped', () => {
+        // Chinese chars don't map to ASCII — they're dropped, hyphens collapsed.
+        const result = normalizeMaterializedFilename('设置规则.md');
+        // No Chinese remains; just the extension part
+        expect(result).toBe('.md');
+    });
+    it('ligature "fi" decomposes to "fi"', () => {
+        // NFKD decomposes fi (fi ligature, U+FB01) to 'f' + 'i'
+        expect(normalizeMaterializedFilename('file.md')).toBe('file.md');
+    });
+    // ── Leading dots ──────────────────────────────────────────────────────────────
+    it('single leading dot is stripped', () => {
+        expect(normalizeMaterializedFilename('.hidden-rule.md')).toBe('hidden-rule.md');
+    });
+    it('multiple leading dots are stripped', () => {
+        expect(normalizeMaterializedFilename('..doubly-hidden.md')).toBe('doubly-hidden.md');
+    });
+    it('dot-only input returns empty string', () => {
+        expect(normalizeMaterializedFilename('.')).toBe('');
+    });
+    it('extension dot mid-name is preserved', () => {
+        // "foo.bar.mdc" → "foo.bar.mdc"
+        expect(normalizeMaterializedFilename('foo.bar.mdc')).toBe('foo.bar.mdc');
+    });
+    // ── Empty input ──────────────────────────────────────────────────────────────
+    it('empty string returns empty string', () => {
+        expect(normalizeMaterializedFilename('')).toBe('');
+    });
+    // ── Special character sequences ───────────────────────────────────────────────
+    it('multiple consecutive spaces → single hyphen', () => {
+        expect(normalizeMaterializedFilename('a   b.md')).toBe('a-b.md');
+    });
+    it('underscores replaced with hyphens', () => {
+        expect(normalizeMaterializedFilename('my_rule_file.mdc')).toBe('my-rule-file.mdc');
+    });
+    it('leading and trailing hyphens are trimmed', () => {
+        expect(normalizeMaterializedFilename('-foo-')).toBe('foo');
+    });
+    it('mixed special chars collapse to single hyphen', () => {
+        expect(normalizeMaterializedFilename('foo!@#bar.mdc')).toBe('foo-bar.mdc');
+    });
+    // ── No extension ────────────────────────────────────────────────────────────
+    it('name without extension is normalized', () => {
+        expect(normalizeMaterializedFilename('MyRule')).toBe('myrule');
+    });
+});
+//# sourceMappingURL=normalizeMaterializedFilename.test.js.map

package/dist/lib/normalizeMaterializedFilename.test.js.map

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

package/dist/lib/notice-marker.d.ts

@@ -0,0 +1,3 @@
+/** Returns true exactly once per (channel, session/day). Never throws. */
+export declare function claimNotice(channel: 'agent' | 'human'): boolean;
+//# sourceMappingURL=notice-marker.d.ts.map

package/dist/lib/notice-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notice-marker.d.ts","sourceRoot":"","sources":["../../src/lib/notice-marker.ts"],"names":[],"mappings":"AA+KA,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAsB/D"}

package/dist/lib/notice-marker.js

@@ -0,0 +1,223 @@
+/**
+ * Once-per-session (agent) / once-per-day (human) notice claim via O_EXCL.
+ * First process to create the marker wins (returns true => may print). All others,
+ * and any error, fail OPEN to no-print (return false). A per-marker O_EXCL lock
+ * serializes stale-marker eviction against that claim. Markers expire by key
+ * (session id rotates per session; daily key rolls per UTC day) and by age, except
+ * that a losing claim heartbeats the current marker so a renewed session survives
+ * the sweep. DEC-2.
+ */
+import { openSync, closeSync, existsSync, linkSync, mkdirSync, statSync, readdirSync, unlinkSync, utimesSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { readSession } from './session.js';
+const CONFIG_DIR = join(homedir(), '.config', 'productbrain');
+// Non-current session residue becomes stale after one server expiry lease. The
+// same ID can be renewed, so claimNotice heartbeats the locked current marker.
+// Lease source: convex/intelligence/agentSessions.ts MAX_SESSION_DURATION_MS.
+const SESSION_STALE_MS = 8 * 60 * 60 * 1000;
+const DAILY_STALE_MS = 7 * 24 * 60 * 60 * 1000;
+// Lock actions contain only synchronous local filesystem calls. A one-minute
+// lease bounds crash residue while leaving ample headroom for a live holder.
+const LOCK_STALE_MS = 60 * 1000;
+const LOCK_PREFIX = '.notice-marker-lock-';
+const LOCK_RECLAIM_SUFFIX = '.reclaim';
+const LOCK_PIN_SUFFIX = '.target';
+function utcDateStamp() {
+    const d = new Date();
+    const p = (n) => String(n).padStart(2, '0');
+    return `${d.getUTCFullYear()}${p(d.getUTCMonth() + 1)}${p(d.getUTCDate())}`;
+}
+/** Channel keys are independent so the human throttle never dedups the agent one. */
+function markerKey(channel) {
+    if (channel === 'human')
+        return `notice-human-${utcDateStamp()}`;
+    const session = readSession();
+    // If no active session, fall back to a daily key so the per-day throttle still holds.
+    return session?.sessionId ? `notice-session-${session.sessionId}` : `notice-agent-daily-${utcDateStamp()}`;
+}
+function markerRetentionMs(name) {
+    if (name.startsWith('notice-session-'))
+        return SESSION_STALE_MS;
+    if (name.startsWith('notice-human-') || name.startsWith('notice-agent-daily-')) {
+        return DAILY_STALE_MS;
+    }
+    return null;
+}
+function markerLockPath(name) {
+    return join(CONFIG_DIR, `${LOCK_PREFIX}${name}`);
+}
+function cleanupStaleRecovery(lockPath, now) {
+    const reclaimPath = `${lockPath}${LOCK_RECLAIM_SUFFIX}`;
+    const pinPath = `${reclaimPath}${LOCK_PIN_SUFFIX}`;
+    try {
+        if (now - statSync(reclaimPath).mtimeMs <= LOCK_STALE_MS)
+            return;
+        try {
+            unlinkSync(pinPath);
+        }
+        catch { /* absent or unavailable identity pin */ }
+        unlinkSync(reclaimPath);
+        return;
+    }
+    catch { /* absent, fresh, or unavailable recovery election */ }
+    try {
+        if (now - statSync(pinPath).mtimeMs > LOCK_STALE_MS)
+            unlinkSync(pinPath);
+    }
+    catch { /* absent or unavailable orphan identity pin */ }
+}
+/**
+ * Reclaim one expired lock without a pathname-only unlink race. O_EXCL elects
+ * one reclaimer; its hard link pins the exact stale file instance to remove.
+ */
+function reclaimStaleLock(lockPath, now) {
+    const reclaimPath = `${lockPath}${LOCK_RECLAIM_SUFFIX}`;
+    const pinPath = `${reclaimPath}${LOCK_PIN_SUFFIX}`;
+    let reclaimFd;
+    let observed;
+    try {
+        observed = statSync(lockPath);
+        if (now - observed.mtimeMs <= LOCK_STALE_MS)
+            return false;
+        cleanupStaleRecovery(lockPath, now);
+        reclaimFd = openSync(reclaimPath, 'wx');
+        closeSync(reclaimFd);
+    }
+    catch {
+        return false;
+    }
+    try {
+        linkSync(lockPath, pinPath);
+        const pinned = statSync(pinPath);
+        if (observed.dev !== pinned.dev || observed.ino !== pinned.ino)
+            return false;
+        const current = statSync(lockPath);
+        if (current.dev !== pinned.dev || current.ino !== pinned.ino)
+            return false;
+        unlinkSync(lockPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        try {
+            unlinkSync(pinPath);
+        }
+        catch { /* bounded by the next stale sweep */ }
+        try {
+            unlinkSync(reclaimPath);
+        }
+        catch { /* bounded by the next stale sweep */ }
+    }
+}
+function acquireMarkerLock(name) {
+    const lockPath = markerLockPath(name);
+    try {
+        return openSync(lockPath, 'wx');
+    }
+    catch {
+        if (!reclaimStaleLock(lockPath, Date.now()))
+            return null;
+        try {
+            return openSync(lockPath, 'wx');
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function withMarkerLock(name, action) {
+    const lockPath = markerLockPath(name);
+    const lockFd = acquireMarkerLock(name);
+    if (lockFd === null)
+        return null;
+    try {
+        closeSync(lockFd);
+        return action();
+    }
+    finally {
+        try {
+            unlinkSync(lockPath);
+        }
+        catch { /* best-effort lock release */ }
+    }
+}
+function cleanupAbandonedMarkerLocks(names, now) {
+    for (const name of names) {
+        if (!name.startsWith(LOCK_PREFIX))
+            continue;
+        if (name.endsWith(LOCK_RECLAIM_SUFFIX)) {
+            cleanupStaleRecovery(join(CONFIG_DIR, name.slice(0, -LOCK_RECLAIM_SUFFIX.length)), now);
+            continue;
+        }
+        if (name.endsWith(`${LOCK_RECLAIM_SUFFIX}${LOCK_PIN_SUFFIX}`))
+            continue;
+        const path = join(CONFIG_DIR, name);
+        try {
+            if (now - statSync(path).mtimeMs <= LOCK_STALE_MS)
+                continue;
+            reclaimStaleLock(path, now);
+        }
+        catch {
+            // Lock recovery is best-effort and isolated per file, like marker GC.
+        }
+    }
+}
+function cleanupOldNoticeMarkers(currentName) {
+    let names;
+    try {
+        names = readdirSync(CONFIG_DIR);
+    }
+    catch {
+        return;
+    }
+    const now = Date.now();
+    cleanupAbandonedMarkerLocks(names, now);
+    for (const name of names) {
+        if (name === currentName)
+            continue;
+        const staleAfterMs = markerRetentionMs(name);
+        if (staleAfterMs === null)
+            continue;
+        withMarkerLock(name, () => {
+            try {
+                const p = join(CONFIG_DIR, name);
+                if (now - statSync(p).mtimeMs > staleAfterMs)
+                    unlinkSync(p);
+            }
+            catch {
+                // A marker can disappear or become unavailable while the sweep runs.
+                // Keep cleanup best-effort without skipping the remaining files.
+            }
+        });
+    }
+}
+/** Returns true exactly once per (channel, session/day). Never throws. */
+export function claimNotice(channel) {
+    const name = markerKey(channel);
+    const path = join(CONFIG_DIR, name);
+    try {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+        return withMarkerLock(name, () => {
+            cleanupOldNoticeMarkers(name);
+            if (existsSync(path)) {
+                // A live server session can be renewed under the same ID. Refreshing the
+                // marker on each suppressed notice keeps that active session out of GC.
+                try {
+                    const now = new Date();
+                    utimesSync(path, now, now);
+                }
+                catch { /* the existing claim still wins */ }
+                return false;
+            }
+            closeSync(openSync(path, 'wx')); // 'wx' = O_EXCL: throws EEXIST if present
+            return true;
+        }) ?? false;
+    }
+    catch {
+        return false; // already claimed, or fs error => fail open to no-print
+    }
+}
+//# sourceMappingURL=notice-marker.js.map

package/dist/lib/notice-marker.js.map

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

package/dist/lib/onboarding-path-b.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-path-b.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding-path-b.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAIL,KAAK,oBAAoB,EAG1B,MAAM,wBAAwB,CAAC;AAEhC,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyK7E;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAClC,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAUtB;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI9C"}
+{"version":3,"file":"onboarding-path-b.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding-path-b.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAIL,KAAK,oBAAoB,EAG1B,MAAM,wBAAwB,CAAC;AAehC,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyK7E;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAClC,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAStB;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI9C"}

package/dist/lib/onboarding-path-b.js

@@ -7,6 +7,18 @@ import { ask } from './prompts.js';
 import { bold, dim, green, icons } from './style.js';
 import { trackEvent } from './telemetry.js';
 import { extractionToEntries, batchCaptureEntries, countWords, } from './onboarding-shared.js';
+/**
+ * `onboarding.chat`'s server handler (convex/intelligence/onboardingChat.ts) deliberately
+ * types `extraction` as `Record<string, unknown>` — a dynamically-built "backward-compat"
+ * bridge object (its own comment: "Path B reads .extraction.vision, .extraction.tensions,
+ * etc."), not a mistake. `vision` is unconditionally seeded (`{ vision: '' }`, line ~350)
+ * before any conditional field is added, so it's always present as a string — matching
+ * `OnboardingExtraction.vision: string` (required). Cast at the boundary rather than loosen
+ * the shared client-side type (PR #398, Lane C S3c annotation pass).
+ */
+function asOnboardingExtraction(extraction) {
+    return extraction;
+}
 export async function runOnboardingPathB(workspaceName) {
     trackEvent('setup_started', { mode: 'llm', path: 'B' });
     const messages = [];
@@ -69,7 +81,7 @@ export async function runOnboardingPathB(workspaceName) {
     ]);
     // Store first extraction if available
     if (extractResult.status === 'fulfilled' && extractResult.value?.extraction) {
-        lastExtraction = extractResult.value.extraction;
+        lastExtraction = asOnboardingExtraction(extractResult.value.extraction) ?? null;
     }
     // Show follow-up question
     if (followUpResult.status === 'fulfilled' && followUpResult.value?.content) {
@@ -90,7 +102,7 @@ export async function runOnboardingPathB(workspaceName) {
                         mode: 'extract',
                     });
                     if (result2?.extraction) {
-                        lastExtraction = mergeExtractions(lastExtraction, result2.extraction);
+                        lastExtraction = mergeExtractions(lastExtraction, asOnboardingExtraction(result2.extraction) ?? { vision: '' });
                     }
                 }
                 catch {
@@ -113,7 +125,7 @@ export async function runOnboardingPathB(workspaceName) {
                     mode: 'extract',
                 });
                 if (finalExtract?.extraction) {
-                    lastExtraction = finalExtract.extraction;
+                    lastExtraction = asOnboardingExtraction(finalExtract.extraction) ?? null;
                 }
             }
             catch {
@@ -156,7 +168,6 @@ export function mergeExtractions(first, second) {
     return {
         vision: second.vision || first.vision,
         audience: second.audience || first.audience,
-        techStack: dedupe([...(first.techStack ?? []), ...(second.techStack ?? [])]),
         keyTerms: dedupe([...(first.keyTerms ?? []), ...(second.keyTerms ?? [])]),
         keyDecisions: dedupe([...(first.keyDecisions ?? []), ...(second.keyDecisions ?? [])]),
         tensions: dedupe([...(first.tensions ?? []), ...(second.tensions ?? [])]),
@@ -165,18 +176,13 @@ export function mergeExtractions(first, second) {
 export function dedupe(arr) {
     return [...new Set(arr.map((s) => s.toLowerCase()))].map((lower) => arr.find((s) => s.toLowerCase() === lower) ?? lower);
 }
-/** Governance proof — show binding governance from captured knowledge via resolveTaskStartup. */
+/** Governance proof — show the steering context resolveTaskStartup finds for the captured vision.
+ *  TASK-556 (WP-777, DEC-1889): the old binding-governance buckets are not shown; they are not
+ *  the rules that bind a session (the served rule lists are). */
 async function showGovernanceProof(vision) {
     try {
         const result = await kernelCall('chain.resolveTaskStartup', { task: vision });
-        const governance = result?.bindingGovernance;
-        const steering = result?.steeringContext ?? [];
-        const allItems = [
-            ...(governance?.principles ?? []),
-            ...(governance?.standards ?? []),
-            ...(governance?.businessRules ?? []),
-            ...steering.slice(0, 3),
-        ].filter((i) => i.name);
+        const allItems = (result?.steeringContext ?? []).filter((i) => i.name);
         if (allItems.length > 0) {
             process.stdout.write(`\n  ${bold('Your product knowledge is now wired in:')}\n\n`);
             for (const item of allItems.slice(0, 4)) {
@@ -191,8 +197,26 @@ async function showGovernanceProof(vision) {
     catch {
         // Governance proof is best-effort — fall back to orient-based proof
         try {
-            const orient = await kernelCall('orient', { brief: true });
-            const items = orient?.sections?.flatMap((s) => s.items ?? []).filter((i) => i.name) ?? [];
+            // `'orient'` is not a real gateway route (never existed in the registry — this call
+            // has been throwing on every invocation, silently caught by the enclosing catch below,
+            // PR #397-class bug found via S3c annotation). Fixed to the real route,
+            // `chain.getOrientView`, whose return shape has no `.sections` — the closest real
+            // analog for "a few named items to display" is `taskContext.context` (entries with a
+            // `.name` field, same shape `chain.resolveTaskStartup`'s steeringContext
+            // items above use).
+            // `renderMode` is the telemetry-attribution axis, not a formatting hint (convex/
+            // agentKnowledge/orientView.ts / convex/http.ts): 'json' means "agent-surface machine
+            // payload" and feeds the OBJ-51 scoreboard denominator via governanceRenderedJson.
+            // This onboarding fallback is a genuinely interactive, human-facing CLI flow (styled
+            // stdout text, `ask()` prompts) — 'json' here would mislabel it as agent traffic and
+            // contaminate that metric. 'pretty' is documented as exactly "interactive human TTY"
+            // and carries no governanceRenderedJson, staying correctly uninstrumented (Codex P2,
+            // PR #398 review).
+            const orient = await kernelCall('chain.getOrientView', {
+                task: vision,
+                renderMode: 'pretty',
+            });
+            const items = (orient?.taskContext?.context ?? []).filter((i) => i.name);
             if (items.length > 0) {
                 process.stdout.write(`\n  ${bold("Here's how your product brain will use this:")}\n\n`);
                 for (const item of items.slice(0, 5)) {