@productbrain/cli 0.1.0-beta.29 → 0.1.0-beta.2914

package/dist/lib/frontmatter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * parseSetupFrontmatter — the single shared YAML-frontmatter parser for setup
+ * authoring assets (skills / rules / hooks).
+ *
+ * Unifies three previously-divergent copies that lived inline in:
+ *   - commands/handshake.ts    (parseSetupAuthoringFrontmatter)
+ *   - commands/migrate-setup.ts (parseFrontmatter)
+ *   - commands/setup-ingest.ts  (parseFrontmatter)
+ *
+ * The three were identical on scalar fields but DIVERGED on array items:
+ * handshake stripped surrounding quotes from each `- item`, the other two did
+ * not. That meant a trigger written as `- "triage: [anything]"` survived as
+ * `triage: [anything]` through handshake but as `"triage: [anything]"` through
+ * migrate/ingest — the same file produced different DB rows depending on path.
+ * This parser adopts handshake's quote-stripping as canonical for BOTH scalars
+ * and array items, closing the divergence.
+ *
+ * NOTE — intentionally out of scope: commands/method.ts and
+ * generators/portable-knowledge.ts each keep their own `parseFrontmatter`.
+ * They have different parsing semantics / return shapes and are NOT folded in.
+ *
+ * Supported shape (deliberately minimal, matching the originals):
+ *   - YAML-style `---` fences (CRLF or LF). No fence → name from H1, rest empty.
+ *   - Scalar fields: `key: value` (surrounding quotes stripped).
+ *   - Array fields: `key:` followed by indented `  - item` lines (quotes stripped).
+ *   - Multi-line `>-` block scalars are NOT expanded — the literal `>-` token is
+ *     stored as the value and continuation lines are ignored. This matches the
+ *     behavior of all three original parsers (e.g. triage.md's `description: >-`).
+ *
+ * Chain: TEN-1459 (handshake reads FS), WP-345.
+ */
+export interface ParsedSetupFrontmatter {
+    /** The frontmatter `id:` field, if present (handshake/setup-ingest use it). */
+    frontmatterId?: string;
+    /** `name:` field, falling back to the body's first H1, else ''. */
+    name: string;
+    /** `description:` field, else ''. */
+    description: string;
+    /** Everything after the closing `---` fence (the raw markdown body). */
+    body: string;
+    /** `triggers:` array (quotes stripped per item). */
+    triggers: string[];
+    /** `semanticRefs:` array (quotes stripped per item). */
+    semanticRefs: string[];
+    /** `assetKind:` field, if present (setup-ingest uses it). */
+    assetKind?: string;
+}
+/**
+ * Parse minimal YAML frontmatter from a .md file's raw contents.
+ *
+ * Returns the union of fields every setup-authoring caller needs. Callers that
+ * don't use a given field simply ignore it.
+ */
+export declare function parseSetupFrontmatter(raw: string): ParsedSetupFrontmatter;
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wDAAwD;IACxD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,CAoDzE"}

package/dist/lib/frontmatter.js

@@ -0,0 +1,92 @@
+/**
+ * parseSetupFrontmatter — the single shared YAML-frontmatter parser for setup
+ * authoring assets (skills / rules / hooks).
+ *
+ * Unifies three previously-divergent copies that lived inline in:
+ *   - commands/handshake.ts    (parseSetupAuthoringFrontmatter)
+ *   - commands/migrate-setup.ts (parseFrontmatter)
+ *   - commands/setup-ingest.ts  (parseFrontmatter)
+ *
+ * The three were identical on scalar fields but DIVERGED on array items:
+ * handshake stripped surrounding quotes from each `- item`, the other two did
+ * not. That meant a trigger written as `- "triage: [anything]"` survived as
+ * `triage: [anything]` through handshake but as `"triage: [anything]"` through
+ * migrate/ingest — the same file produced different DB rows depending on path.
+ * This parser adopts handshake's quote-stripping as canonical for BOTH scalars
+ * and array items, closing the divergence.
+ *
+ * NOTE — intentionally out of scope: commands/method.ts and
+ * generators/portable-knowledge.ts each keep their own `parseFrontmatter`.
+ * They have different parsing semantics / return shapes and are NOT folded in.
+ *
+ * Supported shape (deliberately minimal, matching the originals):
+ *   - YAML-style `---` fences (CRLF or LF). No fence → name from H1, rest empty.
+ *   - Scalar fields: `key: value` (surrounding quotes stripped).
+ *   - Array fields: `key:` followed by indented `  - item` lines (quotes stripped).
+ *   - Multi-line `>-` block scalars are NOT expanded — the literal `>-` token is
+ *     stored as the value and continuation lines are ignored. This matches the
+ *     behavior of all three original parsers (e.g. triage.md's `description: >-`).
+ *
+ * Chain: TEN-1459 (handshake reads FS), WP-345.
+ */
+/** Strip a single pair of surrounding single/double quotes. */
+function stripQuotes(value) {
+    return value.replace(/^['"]|['"]$/g, '');
+}
+/**
+ * Parse minimal YAML frontmatter from a .md file's raw contents.
+ *
+ * Returns the union of fields every setup-authoring caller needs. Callers that
+ * don't use a given field simply ignore it.
+ */
+export function parseSetupFrontmatter(raw) {
+    const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!fmMatch) {
+        // No frontmatter — derive name from H1, leave everything else empty.
+        const h1 = raw.match(/^# (.+)$/m);
+        return { name: h1?.[1] ?? '', description: '', body: raw, triggers: [], semanticRefs: [] };
+    }
+    const fmBlock = fmMatch[1];
+    const body = fmMatch[2];
+    const fields = new Map();
+    const arrayFields = new Map();
+    // Parse simple `key: value` and `key:\n  - item` YAML arrays.
+    const lines = fmBlock.split('\n');
+    let currentArrayKey = null;
+    let currentArrayValues = [];
+    for (const line of lines) {
+        const arrayItemMatch = line.match(/^\s+-\s+(.+)$/);
+        const keyValueMatch = line.match(/^(\w+):\s*(.*)$/);
+        if (arrayItemMatch && currentArrayKey) {
+            currentArrayValues.push(stripQuotes(arrayItemMatch[1].trim()));
+        }
+        else if (keyValueMatch) {
+            if (currentArrayKey) {
+                arrayFields.set(currentArrayKey, currentArrayValues);
+                currentArrayKey = null;
+                currentArrayValues = [];
+            }
+            const [, key, value] = keyValueMatch;
+            if (value.trim() === '') {
+                // Start of an array block.
+                currentArrayKey = key;
+            }
+            else {
+                fields.set(key, stripQuotes(value.trim()));
+            }
+        }
+    }
+    if (currentArrayKey) {
+        arrayFields.set(currentArrayKey, currentArrayValues);
+    }
+    return {
+        frontmatterId: fields.get('id'),
+        name: fields.get('name') ?? body.match(/^# (.+)$/m)?.[1] ?? '',
+        description: fields.get('description') ?? '',
+        body,
+        triggers: arrayFields.get('triggers') ?? [],
+        semanticRefs: arrayFields.get('semanticRefs') ?? [],
+        assetKind: fields.get('assetKind'),
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/lib/frontmatter.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * parseSetupFrontmatter regression tests.
+ *
+ * The load-bearing assertion: the array-item quote-stripping divergence between
+ * handshake (stripped) and migrate-setup / setup-ingest (did not strip) is
+ * closed. All three now route through this one function, so a trigger written
+ * as `- "triage: [anything]"` resolves to `triage: [anything]` on every path.
+ *
+ * We parse the REAL fixture `.productbrain/skills/triage.md` rather than a
+ * synthetic string so the test fails if that file's shape drifts.
+ *
+ * Chain: TEN-1459, WP-345.
+ */
+export {};
+//# sourceMappingURL=frontmatter.test.d.ts.map

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

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

package/dist/lib/frontmatter.test.js

@@ -0,0 +1,98 @@
+/**
+ * parseSetupFrontmatter regression tests.
+ *
+ * The load-bearing assertion: the array-item quote-stripping divergence between
+ * handshake (stripped) and migrate-setup / setup-ingest (did not strip) is
+ * closed. All three now route through this one function, so a trigger written
+ * as `- "triage: [anything]"` resolves to `triage: [anything]` on every path.
+ *
+ * We parse the REAL fixture `.productbrain/skills/triage.md` rather than a
+ * synthetic string so the test fails if that file's shape drifts.
+ *
+ * Chain: TEN-1459, WP-345.
+ */
+import { describe, expect, it } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { parseSetupFrontmatter } from './frontmatter.js';
+// repo root: packages/cli/src/lib → up four levels
+const here = dirname(fileURLToPath(import.meta.url));
+const repoRoot = join(here, '..', '..', '..', '..');
+const triagePath = join(repoRoot, '.productbrain', 'skills', 'triage.md');
+describe('parseSetupFrontmatter — array-quote divergence is closed', () => {
+    it('strips surrounding quotes from the triage.md `triggers` list item', () => {
+        const raw = readFileSync(triagePath, 'utf8');
+        const parsed = parseSetupFrontmatter(raw);
+        // The fixture contains a YAML list item: - "triage: [anything]"
+        // Quotes MUST be stripped (handshake's behavior, now canonical).
+        expect(parsed.triggers).toContain('triage: [anything]');
+        // And the un-stripped form must NOT survive.
+        expect(parsed.triggers).not.toContain('"triage: [anything]"');
+    });
+    it('extracts the scalar fields the callers depend on', () => {
+        const raw = readFileSync(triagePath, 'utf8');
+        const parsed = parseSetupFrontmatter(raw);
+        expect(parsed.name).toBe('triage');
+        // body is everything after the closing fence — contains the H1.
+        expect(parsed.body).toContain('# Triage');
+        // The multi-line `>-` block scalar is preserved as the literal token
+        // (the originals never expanded it; we keep that behavior).
+        expect(parsed.description).toBe('>-');
+    });
+    it('resolves the full triggers list to its canonical (quote-stripped) form', () => {
+        // The divergence is structurally gone because all three callers now invoke
+        // this one function. What that function MUST produce is asserted literally
+        // here: the quoted item `- "triage: [anything]"` strips to `triage:
+        // [anything]` while every bare item is untouched. Under the old
+        // migrate-setup / setup-ingest path the third item would have retained its
+        // quotes — so this exact array is what closes the bug, not a self-comparison.
+        const raw = readFileSync(triagePath, 'utf8');
+        const parsed = parseSetupFrontmatter(raw);
+        expect(parsed.triggers).toEqual([
+            'triage',
+            'triage this',
+            'triage: [anything]',
+            'what should I focus on?',
+            'what should I work on?',
+            'where do I start?',
+            'help me think about this',
+            'diagnose',
+        ]);
+    });
+});
+describe('parseSetupFrontmatter — boundary cases', () => {
+    it('returns empty fields and the raw body when there is no `---` fence', () => {
+        const parsed = parseSetupFrontmatter('# Heading Only\n\nbody text');
+        expect(parsed.name).toBe('Heading Only');
+        expect(parsed.description).toBe('');
+        expect(parsed.triggers).toEqual([]);
+        expect(parsed.semanticRefs).toEqual([]);
+        expect(parsed.frontmatterId).toBeUndefined();
+        expect(parsed.assetKind).toBeUndefined();
+        expect(parsed.body).toBe('# Heading Only\n\nbody text');
+    });
+    it('handles an empty frontmatter block', () => {
+        const parsed = parseSetupFrontmatter('---\n\n---\n# Title\n');
+        expect(parsed.name).toBe('Title');
+        expect(parsed.triggers).toEqual([]);
+    });
+    it('extracts id and assetKind scalar fields when present', () => {
+        const raw = [
+            '---',
+            'id: SETUP-SKILL-EXAMPLE',
+            'name: example',
+            'assetKind: skill',
+            'triggers:',
+            "  - 'quoted trigger'",
+            '  - bare trigger',
+            '---',
+            '# Example',
+        ].join('\n');
+        const parsed = parseSetupFrontmatter(raw);
+        expect(parsed.frontmatterId).toBe('SETUP-SKILL-EXAMPLE');
+        expect(parsed.assetKind).toBe('skill');
+        expect(parsed.triggers).toEqual(['quoted trigger', 'bare trigger']);
+    });
+});
+//# sourceMappingURL=frontmatter.test.js.map

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

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

package/dist/lib/glossary.d.ts

@@ -0,0 +1,19 @@
+/**
+ * glossary.ts — Key CLI terms and their definitions.
+ *
+ * Provides a static glossary of Product Brain CLI terminology,
+ * plus a formatter for TTY output.
+ *
+ * WP-302 Slice 4.
+ */
+export interface GlossaryEntry {
+    term: string;
+    definition: string;
+}
+export declare const GLOSSARY: GlossaryEntry[];
+/**
+ * Format the glossary for TTY output.
+ * Returns a multi-line string with bold terms and dimmed definitions.
+ */
+export declare function formatGlossary(): string;
+//# sourceMappingURL=glossary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../src/lib/glossary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,EAAE,aAAa,EA6BnC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAUvC"}

package/dist/lib/glossary.js

@@ -0,0 +1,53 @@
+/**
+ * glossary.ts — Key CLI terms and their definitions.
+ *
+ * Provides a static glossary of Product Brain CLI terminology,
+ * plus a formatter for TTY output.
+ *
+ * WP-302 Slice 4.
+ */
+import { bold, dim } from './style.js';
+export const GLOSSARY = [
+    {
+        term: 'workspace',
+        definition: 'Your product knowledge space. One workspace = one product.',
+    },
+    {
+        term: 'entry',
+        definition: 'A unit of product knowledge (bet, decision, tension, standard, etc.).',
+    },
+    {
+        term: 'collection',
+        definition: 'A group of related entries (work-packages, decisions, tensions, etc.).',
+    },
+    {
+        term: 'relation',
+        definition: 'A typed link between entries (part_of, depends_on, addresses, etc.).',
+    },
+    {
+        term: 'session',
+        definition: 'A tracked write session. Required before creating or updating entries.',
+    },
+    {
+        term: 'capture',
+        definition: 'Create a new entry on the Chain via pb capture.',
+    },
+    {
+        term: 'profile',
+        definition: 'A named workspace configuration with API key and endpoint.',
+    },
+];
+/**
+ * Format the glossary for TTY output.
+ * Returns a multi-line string with bold terms and dimmed definitions.
+ */
+export function formatGlossary() {
+    const lines = [];
+    const maxTermLen = Math.max(...GLOSSARY.map((g) => g.term.length));
+    for (const entry of GLOSSARY) {
+        const paddedTerm = entry.term.padEnd(maxTermLen);
+        lines.push(`  ${bold(paddedTerm)}  ${dim(entry.definition)}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=glossary.js.map

package/dist/lib/glossary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../src/lib/glossary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAOvC,MAAM,CAAC,MAAM,QAAQ,GAAoB;IACvC;QACE,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,4DAA4D;KACzE;IACD;QACE,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,uEAAuE;KACpF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,UAAU,EAAE,wEAAwE;KACrF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,sEAAsE;KACnF;IACD;QACE,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,wEAAwE;KACrF;IACD;QACE,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,iDAAiD;KAC9D;IACD;QACE,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,4DAA4D;KACzE;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/lib/hook-intents.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Hook intent model — WP-310 E3a.
+ * Defines the three pb hook intents and a composition function that returns
+ * only the hook entries not already present in existing settings.
+ *
+ * Also exposes getHookStatusForSurface (WP-310 E3b / S4) for multi-surface
+ * opt-in reporting in runHandshakeInit().
+ *
+ * Kept separate from handshake.ts so S4 (multi-surface opt-in) can import
+ * composeHooksFromIntents without pulling in the full handshake module.
+ */
+import type { SurfaceName } from '../surfaces/registry.js';
+export type HookIntent = 'session-start' | 'session-close' | 'pre-compact';
+export interface HookIntentConfig {
+    command: string;
+    statusMessage?: string;
+    hookEvent: 'SessionStart' | 'Stop' | 'PreCompact';
+}
+export declare const HOOK_INTENT_CONFIGS: Record<HookIntent, HookIntentConfig>;
+export interface HookAddition {
+    event: 'SessionStart' | 'Stop' | 'PreCompact';
+    entry: {
+        hooks: Array<{
+            type: string;
+            command: string;
+            statusMessage?: string;
+        }>;
+    };
+    label: string;
+}
+/**
+ * Returns the hook additions needed for the given intents.
+ * Only returns entries whose command is NOT already present in existingHooks.
+ *
+ * @param intents   - The hook intents to compose.
+ * @param existingHooks - The current hooks object from settings (e.g. settings.hooks ?? {}).
+ */
+export declare function composeHooksFromIntents(intents: HookIntent[], existingHooks: Record<string, unknown>): HookAddition[];
+export interface HookStatusResult {
+    writable: boolean;
+    reason: string;
+}
+/**
+ * Determines whether hook files can be written for a given surface.
+ *
+ * INS-740: Cursor and Copilot have empty hookEvents in SURFACE_REGISTRY,
+ * so no hook files are written for them. This function reports that status
+ * so runHandshakeInit() can surface an informational note to the user.
+ */
+export declare function getHookStatusForSurface(surface: SurfaceName): HookStatusResult;
+//# sourceMappingURL=hook-intents.d.ts.map

package/dist/lib/hook-intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-intents.d.ts","sourceRoot":"","sources":["../../src/lib/hook-intents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,eAAe,GAAG,aAAa,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;CACnD;AAID,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAgBpE,CAAC;AASF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;IAC9C,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACnF,KAAK,EAAE,MAAM,CAAC;CACf;AAQD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,UAAU,EAAE,EACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,YAAY,EAAE,CAyBhB;AAID,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,gBAAgB,CAS9E"}

package/dist/lib/hook-intents.js

@@ -0,0 +1,85 @@
+/**
+ * Hook intent model — WP-310 E3a.
+ * Defines the three pb hook intents and a composition function that returns
+ * only the hook entries not already present in existing settings.
+ *
+ * Also exposes getHookStatusForSurface (WP-310 E3b / S4) for multi-surface
+ * opt-in reporting in runHandshakeInit().
+ *
+ * Kept separate from handshake.ts so S4 (multi-surface opt-in) can import
+ * composeHooksFromIntents without pulling in the full handshake module.
+ */
+import { SURFACE_REGISTRY } from '../surfaces/registry.js';
+// Hook failure contract (TEN-712): all hook commands MUST end with '2>/dev/null || true'
+// so Claude Code always starts even if pb is unavailable. Never remove this suffix.
+export const HOOK_INTENT_CONFIGS = {
+    'session-start': {
+        command: 'pb session start 2>/dev/null || true',
+        statusMessage: 'Opening pb session...',
+        hookEvent: 'SessionStart',
+    },
+    'session-close': {
+        command: 'pb session close 2>/dev/null || true',
+        statusMessage: 'Closing pb session...',
+        hookEvent: 'Stop',
+    },
+    'pre-compact': {
+        command: 'pb session id > /dev/null 2>&1 && echo \'{"systemMessage": "pb session active — capture decisions/tensions before compacting: pb capture \\"DEC: ...\\""}\'  || true',
+        hookEvent: 'PreCompact',
+    },
+};
+function hasCommand(groups, cmd) {
+    return (groups ?? []).some((g) => g.hooks?.some((h) => h.command === cmd));
+}
+const INTENT_LABELS = {
+    'session-start': 'SessionStart → pb session start',
+    'session-close': 'Stop → pb session close',
+    'pre-compact': 'PreCompact → decision capture reminder',
+};
+/**
+ * Returns the hook additions needed for the given intents.
+ * Only returns entries whose command is NOT already present in existingHooks.
+ *
+ * @param intents   - The hook intents to compose.
+ * @param existingHooks - The current hooks object from settings (e.g. settings.hooks ?? {}).
+ */
+export function composeHooksFromIntents(intents, existingHooks) {
+    const additions = [];
+    for (const intent of intents) {
+        const cfg = HOOK_INTENT_CONFIGS[intent];
+        const existing = existingHooks[cfg.hookEvent];
+        if (hasCommand(existing, cfg.command))
+            continue;
+        const hookEntry = {
+            type: 'command',
+            command: cfg.command,
+        };
+        if (cfg.statusMessage !== undefined) {
+            hookEntry.statusMessage = cfg.statusMessage;
+        }
+        additions.push({
+            event: cfg.hookEvent,
+            entry: { hooks: [hookEntry] },
+            label: INTENT_LABELS[intent],
+        });
+    }
+    return additions;
+}
+/**
+ * Determines whether hook files can be written for a given surface.
+ *
+ * INS-740: Cursor and Copilot have empty hookEvents in SURFACE_REGISTRY,
+ * so no hook files are written for them. This function reports that status
+ * so runHandshakeInit() can surface an informational note to the user.
+ */
+export function getHookStatusForSurface(surface) {
+    const cap = SURFACE_REGISTRY[surface];
+    if (cap.hookEvents.length > 0) {
+        return { writable: true, reason: 'native hook events supported' };
+    }
+    return {
+        writable: false,
+        reason: `${surface} has no session hook events — run \`pb session start\` manually`,
+    };
+}
+//# sourceMappingURL=hook-intents.js.map

package/dist/lib/hook-intents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-intents.js","sourceRoot":"","sources":["../../src/lib/hook-intents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAW3D,yFAAyF;AACzF,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAyC;IACvE,eAAe,EAAE;QACf,OAAO,EAAE,sCAAsC;QAC/C,aAAa,EAAE,uBAAuB;QACtC,SAAS,EAAE,cAAc;KAC1B;IACD,eAAe,EAAE;QACf,OAAO,EAAE,sCAAsC;QAC/C,aAAa,EAAE,uBAAuB;QACtC,SAAS,EAAE,MAAM;KAClB;IACD,aAAa,EAAE;QACb,OAAO,EACL,sKAAsK;QACxK,SAAS,EAAE,YAAY;KACxB;CACF,CAAC;AAKF,SAAS,UAAU,CAAC,MAAuC,EAAE,GAAW;IACtE,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC;AAQD,MAAM,aAAa,GAA+B;IAChD,eAAe,EAAE,iCAAiC;IAClD,eAAe,EAAE,yBAAyB;IAC1C,aAAa,EAAE,wCAAwC;CACxD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAqB,EACrB,aAAsC;IAEtC,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAoC,CAAC;QAEjF,IAAI,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAEhD,MAAM,SAAS,GAA8D;YAC3E,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC;QACF,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACpC,SAAS,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;QAC9C,CAAC;QAED,SAAS,CAAC,IAAI,CAAC;YACb,KAAK,EAAE,GAAG,CAAC,SAAS;YACpB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;YAC7B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAoB;IAC1D,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;IACpE,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,GAAG,OAAO,iEAAiE;KACpF,CAAC;AACJ,CAAC"}

package/dist/lib/inferSourceDate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Synced from convex/lib/inferSourceDate.ts (FEAT-885: shared date inference, BR-108: CLI import boundary).
+ */
+/**
+ * Infer an ISO date (YYYY-MM-DD) from free-text values.
+ *
+ * Canonical source for MCP (packages/mcp-server/src/lib/inferSourceDate.ts)
+ * and CLI (packages/cli/src/lib/inferSourceDate.ts) — both are synced copies
+ * maintained by scripts/sync-convex-lib-to-mcp.mjs (FEAT-885, BR-108).
+ */
+export declare function inferSourceDate(...values: Array<string | undefined>): string | undefined;
+//# sourceMappingURL=inferSourceDate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inferSourceDate.d.ts","sourceRoot":"","sources":["../../src/lib/inferSourceDate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AAEH,wBAAgB,eAAe,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAmCxF"}

package/dist/lib/inferSourceDate.js

@@ -0,0 +1,44 @@
+/**
+ * Synced from convex/lib/inferSourceDate.ts (FEAT-885: shared date inference, BR-108: CLI import boundary).
+ */
+/**
+ * Infer an ISO date (YYYY-MM-DD) from free-text values.
+ *
+ * Canonical source for MCP (packages/mcp-server/src/lib/inferSourceDate.ts)
+ * and CLI (packages/cli/src/lib/inferSourceDate.ts) — both are synced copies
+ * maintained by scripts/sync-convex-lib-to-mcp.mjs (FEAT-885, BR-108).
+ */
+export function inferSourceDate(...values) {
+    const combined = values
+        .filter((value) => typeof value === 'string' && value.trim().length > 0)
+        .join('\n');
+    if (!combined)
+        return undefined;
+    const isoMatch = combined.match(/\b(20\d{2}-\d{2}-\d{2})\b/);
+    if (isoMatch)
+        return isoMatch[1];
+    const monthMatch = combined.match(/\b(january|february|march|april|may|june|july|august|september|october|november|december)\s+(\d{1,2})(?:st|nd|rd|th)?(?:,?\s+(20\d{2}))?\b/i);
+    if (!monthMatch)
+        return undefined;
+    const monthIndex = [
+        'january',
+        'february',
+        'march',
+        'april',
+        'may',
+        'june',
+        'july',
+        'august',
+        'september',
+        'october',
+        'november',
+        'december',
+    ].indexOf(monthMatch[1].toLowerCase());
+    if (monthIndex < 0)
+        return undefined;
+    const inferredYear = monthMatch[3] ?? combined.match(/\b(20\d{2})\b/)?.[1] ?? String(new Date().getUTCFullYear());
+    const month = String(monthIndex + 1).padStart(2, '0');
+    const day = monthMatch[2].padStart(2, '0');
+    return `${inferredYear}-${month}-${day}`;
+}
+//# sourceMappingURL=inferSourceDate.js.map

package/dist/lib/inferSourceDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferSourceDate.js","sourceRoot":"","sources":["../../src/lib/inferSourceDate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AAEH,MAAM,UAAU,eAAe,CAAC,GAAG,MAAiC;IACnE,MAAM,QAAQ,GAAG,MAAM;SACrB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACxF,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC7D,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEjC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAChC,6IAA6I,CAC7I,CAAC;IACF,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,UAAU,GAAG;QAClB,SAAS;QACT,UAAU;QACV,OAAO;QACP,OAAO;QACP,KAAK;QACL,MAAM;QACN,MAAM;QACN,QAAQ;QACR,WAAW;QACX,SAAS;QACT,UAAU;QACV,UAAU;KACV,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACvC,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAErC,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC;IAClH,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,OAAO,GAAG,YAAY,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;AAC1C,CAAC"}

package/dist/lib/method-registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * method-registry.ts — load pb method registry (WP-310 E4).
+ *
+ * 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.
+ */
+export interface RegistryMethod {
+    name: string;
+    usage: string;
+    description: string;
+}
+export interface MethodRegistry {
+    version: string;
+    generatedAt: string;
+    methods: RegistryMethod[];
+}
+export interface RegistryLoadResult {
+    registry: MethodRegistry;
+    /** Always 'bundled' — the Chain path (TEN-2783) was removed; kept as a field for report output. */
+    source: 'bundled';
+    /** true when the bundled registry's generatedAt is older than FRESHNESS_DAYS */
+    stale: boolean;
+}
+/**
+ * Load the pb method registry from the bundled JSON.
+ *
+ * Async to preserve the caller's `.catch(() => null)` on a read failure (missing/corrupt bundle).
+ */
+export declare function loadMethodRegistry(): Promise<RegistryLoadResult>;
+//# sourceMappingURL=method-registry.d.ts.map

package/dist/lib/method-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-registry.d.ts","sourceRoot":"","sources":["../../src/lib/method-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,mGAAmG;IACnG,MAAM,EAAE,SAAS,CAAC;IAClB,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAC;CAChB;AAoBD;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAGtE"}