@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.1000

package/dist/lib/deployment.test.js

@@ -0,0 +1,54 @@
+/**
+ * Deployment classification — banners and admin seed gates.
+ */
+import { describe, it, expect } from 'vitest';
+import { classifyDeployment, confirmRiskNoteTitle, parseHostname, requiresAdminDestructiveConfirmation, seedAllConfirmMessage, seedRunConfirmMessage, } from './deployment.js';
+describe('parseHostname', () => {
+    it('parses hostname from https URL', () => {
+        expect(parseHostname('https://trustworthy-kangaroo-277.convex.site')).toBe('trustworthy-kangaroo-277.convex.site');
+    });
+});
+describe('classifyDeployment', () => {
+    it('classifies loopback as local', () => {
+        expect(classifyDeployment('http://localhost:5176')).toBe('local');
+        expect(classifyDeployment('http://127.0.0.1:3000')).toBe('local');
+        expect(classifyDeployment('http://[::1]:3000')).toBe('local');
+    });
+    it('classifies known dev-cloud Convex deployment', () => {
+        expect(classifyDeployment('https://trustworthy-kangaroo-277.convex.site')).toBe('dev-cloud');
+    });
+    it('classifies gateway and prod Convex as prod', () => {
+        expect(classifyDeployment('https://gateway.productbrain.io')).toBe('prod');
+        expect(classifyDeployment('https://terrific-penguin-60.convex.site')).toBe('prod');
+        expect(classifyDeployment('https://api.productbrain.io')).toBe('prod');
+    });
+    it('classifies unknown remote as cloud', () => {
+        expect(classifyDeployment('https://other-team-xyz.convex.site')).toBe('cloud');
+    });
+});
+describe('requiresAdminDestructiveConfirmation', () => {
+    it('is false for local and dev-cloud only', () => {
+        expect(requiresAdminDestructiveConfirmation('http://localhost:3000')).toBe(false);
+        expect(requiresAdminDestructiveConfirmation('https://trustworthy-kangaroo-277.convex.site')).toBe(false);
+        expect(requiresAdminDestructiveConfirmation('https://gateway.productbrain.io')).toBe(true);
+        expect(requiresAdminDestructiveConfirmation('https://unknown.convex.site')).toBe(true);
+    });
+});
+describe('confirmRiskNoteTitle', () => {
+    it('matches tier', () => {
+        expect(confirmRiskNoteTitle('https://gateway.productbrain.io')).toContain('Production');
+        expect(confirmRiskNoteTitle('https://other.convex.site')).toContain('Remote');
+    });
+});
+describe('seed confirm copy', () => {
+    it('uses production wording only for prod tier', () => {
+        expect(seedRunConfirmMessage('https://gateway.productbrain.io', 'seed:knowledge')).toContain('production');
+        expect(seedRunConfirmMessage('https://trustworthy-kangaroo-277.convex.site', 'seed:knowledge')).toContain('remote deployment');
+        expect(seedRunConfirmMessage('https://unknown.convex.site', 'seed:knowledge')).toContain('remote deployment');
+    });
+    it('seed all message follows tier', () => {
+        expect(seedAllConfirmMessage('https://gateway.productbrain.io')).toContain('production');
+        expect(seedAllConfirmMessage('https://unknown.convex.site')).toContain('remote deployment');
+    });
+});
+//# sourceMappingURL=deployment.test.js.map

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

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,61 @@
+/**
+ * CLIError — structured error taxonomy for the Product Brain CLI.
+ *
+ * WP-302 Slice 0: Error Taxonomy + Commander Migration.
+ * WP-302 Slice 2: Profile error codes added.
+ * Every CLI error carries a machine-readable code, category, and actionable guidance.
+ * The global error handler in index.ts formats these for JSON or human output.
+ */
+/** Error categories — groups of related failure modes. */
+export type ErrorCategory = 'auth' | 'network' | 'config' | 'validation' | 'session' | 'profile' | 'internal';
+/** Known error codes — extend as new failure modes are discovered. */
+export declare const ErrorCode: {
+    readonly AUTH_MISSING: "AUTH_MISSING";
+    readonly AUTH_INVALID: "AUTH_INVALID";
+    readonly AUTH_DENIED: "AUTH_DENIED";
+    readonly NETWORK_UNREACHABLE: "NETWORK_UNREACHABLE";
+    readonly NETWORK_TIMEOUT: "NETWORK_TIMEOUT";
+    readonly CONFIG_MISSING: "CONFIG_MISSING";
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly SESSION_REQUIRED: "SESSION_REQUIRED";
+    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+    /** Kernel / MCP quality gate (e.g. verify-before-commit). */
+    readonly QUALITY_GATE_BLOCKED: "QUALITY_GATE_BLOCKED";
+    readonly PROFILE_NOT_FOUND: "PROFILE_NOT_FOUND";
+    readonly PROFILE_ALREADY_EXISTS: "PROFILE_ALREADY_EXISTS";
+    readonly PROFILE_IS_ACTIVE: "PROFILE_IS_ACTIVE";
+    readonly PROFILE_IS_LAST: "PROFILE_IS_LAST";
+    readonly PROFILE_NAME_INVALID: "PROFILE_NAME_INVALID";
+    readonly NON_INTERACTIVE: "NON_INTERACTIVE";
+    readonly UPGRADE_FAILED: "UPGRADE_FAILED";
+    readonly INTERNAL: "INTERNAL";
+};
+export type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Structured CLI error with machine-readable fields.
+ *
+ * Usage:
+ *   throw new CLIError('No API key configured', {
+ *     code: ErrorCode.AUTH_MISSING,
+ *     category: 'auth',
+ *     guidance: 'Run `pb login` to configure your API key.',
+ *   });
+ */
+export declare class CLIError extends Error {
+    readonly code: ErrorCodeValue;
+    readonly category: ErrorCategory;
+    readonly guidance?: string;
+    constructor(message: string, options?: {
+        code?: ErrorCodeValue;
+        category?: ErrorCategory;
+        guidance?: string;
+    });
+    /** Serialize for JSON error output. */
+    toJSON(): {
+        error: string;
+        code: string;
+        category: string;
+        guidance?: string;
+    };
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9G,sEAAsE;AACtE,eAAO,MAAM,SAAS;;;;;;;;;;IAepB,6DAA6D;;;;;;;;;;CAarD,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAExE;;;;;;;;;GASG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,cAAc,CAAC;QACtB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IASH,uCAAuC;IACvC,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAQ/E"}

package/dist/lib/errors.js

@@ -0,0 +1,70 @@
+/**
+ * CLIError — structured error taxonomy for the Product Brain CLI.
+ *
+ * WP-302 Slice 0: Error Taxonomy + Commander Migration.
+ * WP-302 Slice 2: Profile error codes added.
+ * Every CLI error carries a machine-readable code, category, and actionable guidance.
+ * The global error handler in index.ts formats these for JSON or human output.
+ */
+/** Known error codes — extend as new failure modes are discovered. */
+export const ErrorCode = {
+    // Auth
+    AUTH_MISSING: 'AUTH_MISSING',
+    AUTH_INVALID: 'AUTH_INVALID',
+    AUTH_DENIED: 'AUTH_DENIED',
+    // Network
+    NETWORK_UNREACHABLE: 'NETWORK_UNREACHABLE',
+    NETWORK_TIMEOUT: 'NETWORK_TIMEOUT',
+    // Config
+    CONFIG_MISSING: 'CONFIG_MISSING',
+    CONFIG_INVALID: 'CONFIG_INVALID',
+    // Session
+    SESSION_REQUIRED: 'SESSION_REQUIRED',
+    // Validation
+    VALIDATION_FAILED: 'VALIDATION_FAILED',
+    /** Kernel / MCP quality gate (e.g. verify-before-commit). */
+    QUALITY_GATE_BLOCKED: 'QUALITY_GATE_BLOCKED',
+    // Profile (WP-302 S2)
+    PROFILE_NOT_FOUND: 'PROFILE_NOT_FOUND',
+    PROFILE_ALREADY_EXISTS: 'PROFILE_ALREADY_EXISTS',
+    PROFILE_IS_ACTIVE: 'PROFILE_IS_ACTIVE',
+    PROFILE_IS_LAST: 'PROFILE_IS_LAST',
+    PROFILE_NAME_INVALID: 'PROFILE_NAME_INVALID',
+    // Interactive
+    NON_INTERACTIVE: 'NON_INTERACTIVE',
+    // Internal
+    UPGRADE_FAILED: 'UPGRADE_FAILED',
+    INTERNAL: 'INTERNAL',
+};
+/**
+ * Structured CLI error with machine-readable fields.
+ *
+ * Usage:
+ *   throw new CLIError('No API key configured', {
+ *     code: ErrorCode.AUTH_MISSING,
+ *     category: 'auth',
+ *     guidance: 'Run `pb login` to configure your API key.',
+ *   });
+ */
+export class CLIError extends Error {
+    code;
+    category;
+    guidance;
+    constructor(message, options) {
+        super(message);
+        this.name = 'CLIError';
+        this.code = options?.code ?? ErrorCode.INTERNAL;
+        this.category = options?.category ?? 'internal';
+        this.guidance = options?.guidance;
+    }
+    /** Serialize for JSON error output. */
+    toJSON() {
+        return {
+            error: this.message,
+            code: this.code,
+            category: this.category,
+            ...(this.guidance ? { guidance: this.guidance } : {}),
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,sEAAsE;AACtE,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO;IACP,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,UAAU;IACV,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,SAAS;IACT,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,UAAU;IACV,gBAAgB,EAAE,kBAAkB;IACpC,aAAa;IACb,iBAAiB,EAAE,mBAAmB;IACtC,6DAA6D;IAC7D,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB;IACtB,iBAAiB,EAAE,mBAAmB;IACtC,sBAAsB,EAAE,wBAAwB;IAChD,iBAAiB,EAAE,mBAAmB;IACtC,eAAe,EAAE,iBAAiB;IAClC,oBAAoB,EAAE,sBAAsB;IAC5C,cAAc;IACd,eAAe,EAAE,iBAAiB;IAClC,WAAW;IACX,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;CACZ,CAAC;AAIX;;;;;;;;;GASG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAiB;IACrB,QAAQ,CAAgB;IACxB,QAAQ,CAAU;IAE3B,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,UAAU,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACpC,CAAC;IAED,uCAAuC;IACvC,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC;CACF"}

package/dist/lib/experiment.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Experiment assignment — deterministic path selection for A/B experiments.
+ * WP-304: Dormant until PB_EXPERIMENT_304=1. When active, overrides PB_ONBOARDING_PATH.
+ */
+export type ExperimentPath = 'A' | 'B';
+/**
+ * Deterministic assignment based on workspace ID.
+ * FNV-1a hash mod 2 — same workspace always gets the same path.
+ */
+export declare function assignOnboardingPath(workspaceId: string): ExperimentPath;
+/** Check if the WP-304 experiment is active. */
+export declare function isExperimentActive(): boolean;
+/**
+ * FNV-1a hash — fast, deterministic, good distribution for short strings.
+ * Returns a positive 32-bit integer.
+ */
+export declare function fnv1aHash(str: string): number;
+//# sourceMappingURL=experiment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.d.ts","sourceRoot":"","sources":["../../src/lib/experiment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAExE;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C"}

package/dist/lib/experiment.js

@@ -0,0 +1,28 @@
+/**
+ * Experiment assignment — deterministic path selection for A/B experiments.
+ * WP-304: Dormant until PB_EXPERIMENT_304=1. When active, overrides PB_ONBOARDING_PATH.
+ */
+/**
+ * Deterministic assignment based on workspace ID.
+ * FNV-1a hash mod 2 — same workspace always gets the same path.
+ */
+export function assignOnboardingPath(workspaceId) {
+    return fnv1aHash(workspaceId) % 2 === 0 ? 'A' : 'B';
+}
+/** Check if the WP-304 experiment is active. */
+export function isExperimentActive() {
+    return process.env.PB_EXPERIMENT_304 === '1';
+}
+/**
+ * FNV-1a hash — fast, deterministic, good distribution for short strings.
+ * Returns a positive 32-bit integer.
+ */
+export function fnv1aHash(str) {
+    let hash = 0x811c9dc5; // FNV offset basis
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = (hash * 0x01000193) >>> 0; // FNV prime, keep as unsigned 32-bit
+    }
+    return hash >>> 0;
+}
+//# sourceMappingURL=experiment.js.map

package/dist/lib/experiment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.js","sourceRoot":"","sources":["../../src/lib/experiment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACtD,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,IAAI,GAAG,UAAU,CAAC,CAAC,mBAAmB;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,qCAAqC;IACzE,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/lib/format.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared formatting utilities for the CLI.
+ * Single source of truth for display helpers used across commands.
+ */
+/**
+ * Format an ISO timestamp into a human-friendly elapsed string.
+ * e.g. "just now", "5m ago", "3h ago", "2d ago"
+ */
+export declare function formatElapsed(isoDate: string): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAarD"}

package/dist/lib/format.js

@@ -0,0 +1,27 @@
+/**
+ * Shared formatting utilities for the CLI.
+ * Single source of truth for display helpers used across commands.
+ */
+/**
+ * Format an ISO timestamp into a human-friendly elapsed string.
+ * e.g. "just now", "5m ago", "3h ago", "2d ago"
+ */
+export function formatElapsed(isoDate) {
+    try {
+        const ms = Date.now() - new Date(isoDate).getTime();
+        const minutes = Math.floor(ms / 60000);
+        if (minutes < 1)
+            return 'just now';
+        if (minutes < 60)
+            return `${minutes}m ago`;
+        const hours = Math.floor(minutes / 60);
+        if (hours < 24)
+            return `${hours}h ago`;
+        const days = Math.floor(hours / 24);
+        return `${days}d ago`;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;QACvC,IAAI,OAAO,GAAG,CAAC;YAAE,OAAO,UAAU,CAAC;QACnC,IAAI,OAAO,GAAG,EAAE;YAAE,OAAO,GAAG,OAAO,OAAO,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACvC,IAAI,KAAK,GAAG,EAAE;YAAE,OAAO,GAAG,KAAK,OAAO,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACpC,OAAO,GAAG,IAAI,OAAO,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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,32 @@
+/**
+ * method-registry.ts — load pb method registry (WP-310 E4).
+ * Chain-first with bundled fallback. Used during handshake when manifest is present.
+ */
+export interface RegistryMethod {
+    name: string;
+    usage: string;
+    description: string;
+}
+export interface MethodRegistry {
+    version: string;
+    generatedAt: string;
+    methods: RegistryMethod[];
+}
+export interface RegistryLoadResult {
+    registry: MethodRegistry;
+    source: 'chain' | 'bundled';
+    /** true when source is 'bundled' and generatedAt is older than FRESHNESS_DAYS */
+    stale: boolean;
+}
+/**
+ * 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)
+ *
+ * Resolution order:
+ *   - 'bundled' → skip Chain, load bundled JSON
+ *   - 'chain' or undefined → try Chain first; on error fall through to bundled
+ */
+export declare function loadMethodRegistry(methodSource: 'chain' | 'bundled' | undefined, chainFetch: (fn: string, args: Record<string, unknown>) => Promise<unknown>): 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;;;GAGG;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,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,iFAAiF;IACjF,KAAK,EAAE,OAAO,CAAC;CAChB;AAoBD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,EAC7C,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1E,OAAO,CAAC,kBAAkB,CAAC,CAoB7B"}