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

package/dist/commands/chain-walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-walk.js","sourceRoot":"","sources":["../../src/commands/chain-walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAwB,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAKlC;IACC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEpD,qBAAqB;IACrB,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACzD,MAAM,IAAI,QAAQ,CAAC,uBAAuB,SAAS,IAAI,EAAE;YACvD,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,mCAAmC;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB;IACjB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAErD,MAAM,aAAa,CAAkB;QACnC,EAAE,EAAE,GAAG,EAAE,CACP,UAAU,CAAkB,qBAAqB,EAAE;YACjD,OAAO;YACP,SAAS;YACT,OAAO,EAAE,YAAY;YACrB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC;KAC1F,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/changes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * pb changes --since <duration> — detect entries and relations modified recently.
+ * BET-239 Slice 0: change detection pipeline.
+ *
+ * Duration format: 1h, 6h, 1d, 7d, 30d (numeric + h/d suffix).
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+export declare function runChanges(options: {
+    since: string;
+}): Promise<void>;
+//# sourceMappingURL=changes.d.ts.map

package/dist/commands/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/commands/changes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB1E"}

package/dist/commands/changes.js

@@ -0,0 +1,46 @@
+/**
+ * pb changes --since <duration> — detect entries and relations modified recently.
+ * BET-239 Slice 0: change detection pipeline.
+ *
+ * Duration format: 1h, 6h, 1d, 7d, 30d (numeric + h/d suffix).
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal)
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatChanges } from '../formatters/changes.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+/** Parse a human-friendly duration string into milliseconds. */
+function parseDuration(input) {
+    const match = input.match(/^(\d+)(h|d)$/i);
+    if (!match)
+        return null;
+    const value = parseInt(match[1], 10);
+    const unit = match[2].toLowerCase();
+    if (unit === 'h')
+        return value * 3_600_000;
+    if (unit === 'd')
+        return value * 86_400_000;
+    return null;
+}
+export async function runChanges(options) {
+    const config = await getConfigOrGuide(() => runChanges(options));
+    if (!config)
+        return;
+    const durationMs = parseDuration(options.since);
+    if (durationMs === null) {
+        throw new CLIError(`Invalid duration: "${options.since}".`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Use format: 1h, 6h, 1d, 7d, 30d (numeric + h/d suffix).',
+        });
+    }
+    const sinceTimestamp = Date.now() - durationMs;
+    await runCliCommand({
+        fn: () => kernelCall('chain.changeDetection', {
+            since: sinceTimestamp,
+        }),
+        formatPretty: (result) => formatChanges(result, options.since),
+    });
+}
+//# sourceMappingURL=changes.js.map

package/dist/commands/changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../src/commands/changes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,gEAAgE;AAChE,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IAC3C,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,KAAK,GAAG,UAAU,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACzD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAChB,sBAAsB,OAAO,CAAC,KAAK,IAAI,EACvC;YACE,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,yDAAyD;SACpE,CACF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;IAE/C,MAAM,aAAa,CAAgB;QACjC,EAAE,EAAE,GAAG,EAAE,CACP,UAAU,CAAgB,uBAAuB,EAAE;YACjD,KAAK,EAAE,cAAc;SACtB,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/codex-prep.d.ts

@@ -0,0 +1,13 @@
+/**
+ * pb codex-prep — pre-bake task-specific governance context for Codex.
+ * Generates .codex/task-context.md with orient view formatted for offline agents.
+ */
+import type { OrientViewFromApi } from './orient.js';
+export interface CodexPrepOptions {
+    task: string;
+    dryRun?: boolean;
+    full?: boolean;
+}
+export declare function runCodexPrep(options: CodexPrepOptions): Promise<void>;
+export declare function formatCodexTaskContext(view: OrientViewFromApi, task: string): string;
+//# sourceMappingURL=codex-prep.d.ts.map

package/dist/commands/codex-prep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-prep.d.ts","sourceRoot":"","sources":["../../src/commands/codex-prep.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC3E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAyFpF"}

package/dist/commands/codex-prep.js

@@ -0,0 +1,125 @@
+/**
+ * pb codex-prep — pre-bake task-specific governance context for Codex.
+ * Generates .codex/task-context.md with orient view formatted for offline agents.
+ */
+import { mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+export async function runCodexPrep(options) {
+    const config = await getConfigOrGuide(() => runCodexPrep(options));
+    if (!config)
+        return;
+    const cwd = process.cwd();
+    const task = options.task.trim();
+    if (!task) {
+        throw new CLIError('Task description is required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb codex-prep <task description>',
+        });
+    }
+    process.stderr.write(`Fetching governance context for: "${task}"...\n`);
+    const orientView = await kernelCall('chain.getOrientView', {
+        task,
+        tier: options.full ? 'full' : 'standard',
+    });
+    const content = formatCodexTaskContext(orientView, task);
+    if (options.dryRun) {
+        process.stdout.write(content);
+        return;
+    }
+    const codexDir = join(cwd, '.codex');
+    const outPath = join(codexDir, 'task-context.md');
+    mkdirSync(codexDir, { recursive: true });
+    writeFileSync(outPath, content);
+    process.stderr.write(`Written: .codex/task-context.md\n`);
+    process.stderr.write(`Tip: Reference this file in your Codex task prompt.\n`);
+}
+export function formatCodexTaskContext(view, task) {
+    const lines = [];
+    const timestamp = new Date().toISOString();
+    lines.push(`<!-- Generated by pb codex-prep — ${timestamp} -->`);
+    lines.push('');
+    lines.push('# Task Context for Codex');
+    lines.push('');
+    lines.push(`**Task:** ${task}`);
+    lines.push(`**Workspace stage:** ${view.stage}`);
+    lines.push('');
+    // Strategic context
+    const sc = view.strategicContext;
+    if (sc) {
+        if (sc.currentWorkPackage)
+            lines.push(`**Current work package:** ${sc.currentWorkPackage}`);
+        if (sc.activeBetCount > 0)
+            lines.push(`**Active bets:** ${sc.activeBetCount}`);
+        if (sc.activeTensionCount > 0)
+            lines.push(`**Open tensions:** ${sc.activeTensionCount}`);
+        lines.push('');
+    }
+    // Governance
+    const gov = view.governance;
+    if (gov) {
+        if (gov.standards.length > 0) {
+            lines.push('## Applicable Standards');
+            lines.push('');
+            for (const s of gov.standards) {
+                lines.push(`- **${s.entryId ?? ''}** ${s.name}${s.preview ? `: ${s.preview}` : ''}`);
+            }
+            lines.push('');
+        }
+        if (gov.businessRules.length > 0) {
+            lines.push('## Business Rules');
+            lines.push('');
+            for (const br of gov.businessRules) {
+                lines.push(`- **${br.entryId ?? ''}** ${br.name}${br.preview ? `: ${br.preview}` : ''}`);
+            }
+            lines.push('');
+        }
+        if (gov.principles.length > 0) {
+            lines.push('## Principles');
+            lines.push('');
+            for (const p of gov.principles) {
+                lines.push(`- **${p.entryId ?? ''}** ${p.name}${p.preview ? `: ${p.preview}` : ''}`);
+            }
+            lines.push('');
+        }
+    }
+    // Task-specific context
+    if (view.taskContext && view.taskContext.context.length > 0) {
+        lines.push('## Task-Relevant Chain Entries');
+        lines.push('');
+        for (const entry of view.taskContext.context) {
+            lines.push(`- **${entry.entryId ?? ''}** [${entry.collectionSlug ?? ''}] ${entry.name}`);
+        }
+        lines.push('');
+    }
+    // Startup context (task-shaped)
+    if (view.startup) {
+        if (view.startup.steeringContext.length > 0) {
+            lines.push('## Steering Context');
+            lines.push('');
+            for (const entry of view.startup.steeringContext) {
+                lines.push(`- **${entry.entryId ?? ''}** [${entry.collectionSlug ?? ''}] ${entry.name}${entry.preview ? `: ${entry.preview}` : ''}`);
+            }
+            lines.push('');
+        }
+    }
+    // Active work packages
+    if (view.activeWorkPackages && view.activeWorkPackages.length > 0) {
+        lines.push('## Active Work Packages');
+        lines.push('');
+        for (const bet of view.activeWorkPackages) {
+            lines.push(`- **${bet.entryId ?? ''}** ${bet.name} (${bet.status})`);
+        }
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+    lines.push('> This context was generated by `pb codex-prep`. It is a snapshot — governance');
+    lines.push('> entries (standards, business rules) are stable; bet status may have changed.');
+    lines.push('> Respect standards and business rules as constraints on implementation.');
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=codex-prep.js.map

package/dist/commands/codex-prep.js.map

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

package/dist/commands/collections.d.ts

@@ -0,0 +1,22 @@
+/**
+ * pb collections — inspect and audit workspace collection registry.
+ * BET-280 Slice 1: CLI surface for system_collection_definitions SSOT (STD-101).
+ * Chain: BET-280, STD-101 (derive from system, never hardcode), DEC-299 (JSON-default output).
+ *
+ * Subcommands:
+ *   pb collections list         — table: slug, name, field count, icon
+ *   pb collections get <slug>   — full collection detail
+ *   pb collections audit        — health report: classification, icon, displayHints, schema gaps
+ */
+export declare function runCollectionsList(): Promise<void>;
+export declare function runCollectionsGet(options: {
+    slug: string;
+}): Promise<void>;
+export declare function runCollectionsAudit(): Promise<void>;
+/**
+ * BET-288 Slice 5: Export all system_collection_definitions with full classification metadata.
+ * Outputs raw JSON (no pretty formatting — designed for piping/diffing).
+ * Admin only (enforced by the HTTP route).
+ */
+export declare function runCollectionsExport(): Promise<void>;
+//# sourceMappingURL=collections.d.ts.map

package/dist/commands/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/commands/collections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBxD;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhF;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQzD;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ1D"}

package/dist/commands/collections.js

@@ -0,0 +1,77 @@
+/**
+ * pb collections — inspect and audit workspace collection registry.
+ * BET-280 Slice 1: CLI surface for system_collection_definitions SSOT (STD-101).
+ * Chain: BET-280, STD-101 (derive from system, never hardcode), DEC-299 (JSON-default output).
+ *
+ * Subcommands:
+ *   pb collections list         — table: slug, name, field count, icon
+ *   pb collections get <slug>   — full collection detail
+ *   pb collections audit        — health report: classification, icon, displayHints, schema gaps
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { runCliCommand } from '../lib/runner.js';
+import { formatCollectionList, formatCollectionDescribe, formatCollectionAudit, } from '../formatters/collections.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+export async function runCollectionsList() {
+    const config = await getConfigOrGuide(() => runCollectionsList());
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: async () => {
+            const rawCollections = await kernelCall('chain.listCollections', {});
+            const collections = (rawCollections ?? []).map((c) => ({
+                slug: c.slug,
+                name: c.name,
+                description: c.description,
+                fieldCount: (c.fields ?? []).length,
+                icon: c.icon,
+            }));
+            return { collections, total: collections.length };
+        },
+        formatPretty: (result) => formatCollectionList(result),
+    });
+}
+export async function runCollectionsGet(options) {
+    const config = await getConfigOrGuide(() => runCollectionsGet(options));
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: async () => {
+            const result = await kernelCall('chain.getCollection', { slug: options.slug });
+            if (!result) {
+                throw new CLIError(`Collection '${options.slug}' not found.`, {
+                    code: ErrorCode.VALIDATION_FAILED,
+                    category: 'validation',
+                    guidance: `Run 'pb collections list' to see available collections.`,
+                });
+            }
+            return result;
+        },
+        formatPretty: (result) => formatCollectionDescribe(result),
+    });
+}
+export async function runCollectionsAudit() {
+    const config = await getConfigOrGuide(() => runCollectionsAudit());
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('chain.auditCollections', {}),
+        formatPretty: (result) => formatCollectionAudit(result),
+    });
+}
+/**
+ * BET-288 Slice 5: Export all system_collection_definitions with full classification metadata.
+ * Outputs raw JSON (no pretty formatting — designed for piping/diffing).
+ * Admin only (enforced by the HTTP route).
+ */
+export async function runCollectionsExport() {
+    const config = await getConfigOrGuide(() => runCollectionsExport());
+    if (!config)
+        return;
+    await runCliCommand({
+        fn: () => kernelCall('chain.exportDefinitions', {}),
+        formatPretty: (result) => JSON.stringify(result, null, 2),
+    });
+}
+//# sourceMappingURL=collections.js.map

package/dist/commands/collections.js.map

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

package/dist/commands/connect-config.test.d.ts

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

package/dist/commands/connect-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-config.test.d.ts","sourceRoot":"","sources":["../../src/commands/connect-config.test.ts"],"names":[],"mappings":""}

package/dist/commands/connect-config.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdirSync, writeFileSync, readFileSync, rmSync } from 'fs';
+import { resolve } from 'path';
+import { tmpdir } from 'os';
+// connect.js imports the Ink screens + handoff helpers; mock them so importing connect.js stays
+// side-effect-free (matches connect.test.ts / connect-integration.test.ts). We deliberately do
+// NOT mock `fs` — saveProjectConfig is real-filesystem logic and these tests assert on real files.
+vi.mock('./connect-screens.js', () => ({ runConnectScreens: vi.fn(async () => { }) }));
+vi.mock('./connect-handoff.js', () => ({
+    detectHandoffMarkers: vi.fn(() => ({})),
+    resolveHandoff: vi.fn(() => null),
+    printHandoff: vi.fn(),
+}));
+import { saveProjectConfig } from './connect.js';
+describe('saveProjectConfig redirect detection (real fs)', () => {
+    let repo;
+    const prevCwd = process.cwd();
+    beforeEach(() => {
+        repo = resolve(tmpdir(), `pb-connect-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(resolve(repo, '.productbrain'), { recursive: true });
+        process.chdir(repo);
+    });
+    afterEach(() => {
+        process.chdir(prevCwd);
+        rmSync(repo, { recursive: true, force: true });
+    });
+    it('returns previousProfile=null on first connect', () => {
+        const r = saveProjectConfig('https://x.convex.site', 'workspace-a');
+        expect(r.previousProfile).toBeNull();
+        expect(JSON.parse(readFileSync(resolve(repo, '.productbrain', 'config.local.json'), 'utf8')).profile).toBe('workspace-a');
+    });
+    it('reports the prior profile when redirecting to a different workspace', () => {
+        writeFileSync(resolve(repo, '.productbrain', 'config.local.json'), JSON.stringify({ profile: 'workspace-a' }));
+        const r = saveProjectConfig('https://y.convex.site', 'workspace-b');
+        expect(r.previousProfile).toBe('workspace-a');
+        expect(JSON.parse(readFileSync(resolve(repo, '.productbrain', 'config.local.json'), 'utf8')).profile).toBe('workspace-b');
+    });
+    it('reports null when re-connecting the same workspace', () => {
+        writeFileSync(resolve(repo, '.productbrain', 'config.local.json'), JSON.stringify({ profile: 'workspace-a' }));
+        const r = saveProjectConfig('https://x.convex.site', 'workspace-a');
+        expect(r.previousProfile).toBeNull();
+    });
+});
+//# sourceMappingURL=connect-config.test.js.map

package/dist/commands/connect-config.test.js.map

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

package/dist/commands/connect-context.d.ts

@@ -0,0 +1,45 @@
+/**
+ * connect-context — non-UI orchestration for the post-connect wizard.
+ *
+ * Extracted from connect-screens.tsx so the seed-readiness poll + context
+ * handshake can be tested without rendering Ink. The screens render purely from
+ * the result of prepareConnectContext().
+ *
+ * Chain: WP-433 (pb connect handoff), WP-439 S4 (strict-by-default handshake),
+ * WP-379 S3b (async seed polling).
+ */
+import { type HealthGap } from './handshake.js';
+export interface ConnectContext {
+    /** True when the context handshake threw (context files may be incomplete). */
+    handshakeFailed: boolean;
+    /** Handshake error message, when handshakeFailed. */
+    handshakeError?: string;
+    /** Non-empty when starter-setup seeds were still pending after the poll. */
+    seedGaps?: ReadonlyArray<HealthGap>;
+    /**
+     * Adapter files PB left untouched because they already existed without its
+     * auto-gen marker (you authored them). The screen relays these so a user with
+     * a pre-existing CLAUDE.md is not falsely told it was synced (TEN-2107).
+     * Undefined = nothing skipped.
+     */
+    skippedFiles?: ReadonlyArray<string>;
+}
+/**
+ * Prepare the workspace context after `pb connect` redeems a token:
+ *
+ * 1. Poll until starter-setup seeds are ready FIRST. The handshake fetches
+ *    seeded setup-asset bodies (skills/rules); on a fresh workspace those seeds
+ *    land asynchronously (WP-379 S3b), so running the handshake before they are
+ *    ready makes its body fetch fail.
+ * 2. Run the handshake LENIENT. This is an automatic onboarding handshake — it
+ *    follows the precedent set for the automatic refresh at session close
+ *    (session.ts, WP-439 S4): automatic runs must not hard-fail on a body-fetch
+ *    error; orphaned assets are surfaced when the user runs `pb handshake`
+ *    directly. Strict-by-default is for that direct command, not for the silent
+ *    post-connect refresh.
+ *
+ * Never throws — failures are captured in the returned object for the screen to
+ * render.
+ */
+export declare function prepareConnectContext(): Promise<ConnectContext>;
+//# sourceMappingURL=connect-context.d.ts.map

package/dist/commands/connect-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-context.d.ts","sourceRoot":"","sources":["../../src/commands/connect-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,eAAe,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACpC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAkCrE"}

package/dist/commands/connect-context.js

@@ -0,0 +1,64 @@
+/**
+ * connect-context — non-UI orchestration for the post-connect wizard.
+ *
+ * Extracted from connect-screens.tsx so the seed-readiness poll + context
+ * handshake can be tested without rendering Ink. The screens render purely from
+ * the result of prepareConnectContext().
+ *
+ * Chain: WP-433 (pb connect handoff), WP-439 S4 (strict-by-default handshake),
+ * WP-379 S3b (async seed polling).
+ */
+import { runHandshake, pollUntilSeedsReady } from './handshake.js';
+/**
+ * Prepare the workspace context after `pb connect` redeems a token:
+ *
+ * 1. Poll until starter-setup seeds are ready FIRST. The handshake fetches
+ *    seeded setup-asset bodies (skills/rules); on a fresh workspace those seeds
+ *    land asynchronously (WP-379 S3b), so running the handshake before they are
+ *    ready makes its body fetch fail.
+ * 2. Run the handshake LENIENT. This is an automatic onboarding handshake — it
+ *    follows the precedent set for the automatic refresh at session close
+ *    (session.ts, WP-439 S4): automatic runs must not hard-fail on a body-fetch
+ *    error; orphaned assets are surfaced when the user runs `pb handshake`
+ *    directly. Strict-by-default is for that direct command, not for the silent
+ *    post-connect refresh.
+ *
+ * Never throws — failures are captured in the returned object for the screen to
+ * render.
+ */
+export async function prepareConnectContext() {
+    // 1. Wait for seeds to be ready before the handshake consumes them.
+    // probe-failed (network/auth) is non-blocking — no seeds warning when the
+    // health endpoint is simply unreachable.
+    let seedGaps;
+    try {
+        const seedResult = await pollUntilSeedsReady();
+        if (seedResult.status === 'seeds-pending') {
+            seedGaps = seedResult.gaps;
+        }
+        // seeds-ready and probe-failed both leave seedGaps undefined (no warning).
+    }
+    catch {
+        // Future-proofing: pollUntilSeedsReady does not throw today (its probe
+        // catches everything into 'probe-failed'); this guards that contract drifting.
+    }
+    // 2. Run handshake lenient — capture failure for display rather than aborting.
+    let handshakeFailed = false;
+    let handshakeError;
+    let skippedFiles;
+    try {
+        const report = await runHandshake({ force: false, apply: true, quiet: true, lenient: true });
+        // userOwnedSkipped = adapter files that already existed without PB's auto-gen
+        // marker, so the handshake left them untouched. Relay them so the screen does
+        // not falsely report them as synced (TEN-2107). These are NOT drift (TEN-2150).
+        if (report?.userOwnedSkipped && report.userOwnedSkipped.length > 0) {
+            skippedFiles = report.userOwnedSkipped;
+        }
+    }
+    catch (err) {
+        handshakeFailed = true;
+        handshakeError = err instanceof Error ? err.message : String(err);
+    }
+    return { handshakeFailed, handshakeError, seedGaps, skippedFiles };
+}
+//# sourceMappingURL=connect-context.js.map

package/dist/commands/connect-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-context.js","sourceRoot":"","sources":["../../src/commands/connect-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAkB,MAAM,gBAAgB,CAAC;AAkBnF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,oEAAoE;IACpE,0EAA0E;IAC1E,yCAAyC;IACzC,IAAI,QAA8C,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC/C,IAAI,UAAU,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YAC1C,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,CAAC;QACD,2EAA2E;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,+EAA+E;IACjF,CAAC;IAED,+EAA+E;IAC/E,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,cAAkC,CAAC;IACvC,IAAI,YAA+C,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7F,8EAA8E;QAC9E,8EAA8E;QAC9E,gFAAgF;QAChF,IAAI,MAAM,EAAE,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnE,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACzC,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAe,GAAG,IAAI,CAAC;QACvB,cAAc,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AACrE,CAAC"}

package/dist/commands/connect-context.test.d.ts

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

package/dist/commands/connect-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-context.test.d.ts","sourceRoot":"","sources":["../../src/commands/connect-context.test.ts"],"names":[],"mappings":""}

package/dist/commands/connect-context.test.js

@@ -0,0 +1,110 @@
+/**
+ * Tests for prepareConnectContext — the non-UI orchestration behind the
+ * post-connect wizard (seed-readiness poll + context handshake).
+ *
+ * Root cause (P1): `pb connect`'s automatic handshake ran STRICT and BEFORE the
+ * seed-readiness poll. On a fresh workspace (seeds still landing async) or with
+ * an orphan setup-asset body, the handshake's body fetch failed and — being
+ * strict (WP-439 S4) — threw, surfacing only a dim "⚠ Context sync skipped" and
+ * leaving CLAUDE.md / rules unwritten. WP-439 S4 made the automatic refresh at
+ * session close LENIENT (session.ts) for exactly this reason; connect's automatic
+ * refresh follows that same precedent.
+ *
+ * Fix: poll seeds ready FIRST, then run the handshake LENIENT.
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+vi.mock('./handshake.js', () => ({
+    runHandshake: vi.fn(async () => { }),
+    pollUntilSeedsReady: vi.fn(async () => ({ status: 'seeds-ready' })),
+}));
+import * as handshake from './handshake.js';
+import { prepareConnectContext } from './connect-context.js';
+const runHandshake = vi.mocked(handshake.runHandshake);
+const pollUntilSeedsReady = vi.mocked(handshake.pollUntilSeedsReady);
+const PENDING_GAPS = [
+    { kind: 'starter-setup-missing', severity: 'warn', message: 'Starter setup seeds are still running.' },
+];
+describe('prepareConnectContext', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-ready' });
+        runHandshake.mockResolvedValue(undefined);
+    });
+    it('runs the handshake in lenient mode (matches session.ts automatic-handshake policy)', async () => {
+        await prepareConnectContext();
+        expect(runHandshake).toHaveBeenCalledTimes(1);
+        expect(runHandshake).toHaveBeenCalledWith(expect.objectContaining({ force: false, apply: true, quiet: true, lenient: true }));
+    });
+    it('waits for seeds to be ready BEFORE running the handshake', async () => {
+        const order = [];
+        pollUntilSeedsReady.mockImplementation(async () => {
+            order.push('poll');
+            return { status: 'seeds-ready' };
+        });
+        runHandshake.mockImplementation(async () => {
+            order.push('handshake');
+            return undefined;
+        });
+        await prepareConnectContext();
+        expect(order).toEqual(['poll', 'handshake']);
+    });
+    it('surfaces seed gaps when starter setup is still pending', async () => {
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-pending', gaps: PENDING_GAPS });
+        const result = await prepareConnectContext();
+        expect(result.seedGaps).toEqual(PENDING_GAPS);
+        expect(result.handshakeFailed).toBe(false);
+    });
+    it('reports no seed gaps when seeds are ready', async () => {
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-ready' });
+        const result = await prepareConnectContext();
+        expect(result.seedGaps).toBeUndefined();
+    });
+    it('reports no seed gaps when the health probe fails (non-blocking)', async () => {
+        pollUntilSeedsReady.mockResolvedValue({ status: 'probe-failed', error: 'network down' });
+        const result = await prepareConnectContext();
+        expect(result.seedGaps).toBeUndefined();
+    });
+    it('captures a handshake failure without throwing', async () => {
+        runHandshake.mockRejectedValue(new Error('boom'));
+        const result = await prepareConnectContext();
+        expect(result.handshakeFailed).toBe(true);
+        expect(result.handshakeError).toBe('boom');
+    });
+    it('surfaces seed gaps AND a handshake failure together (fresh-workspace worst case)', async () => {
+        // Seeds time out, then the lenient handshake still throws on a genuinely
+        // orphaned body — both signals must surface independently.
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-pending', gaps: PENDING_GAPS });
+        runHandshake.mockRejectedValue(new Error('orphan body'));
+        const result = await prepareConnectContext();
+        expect(result.seedGaps).toEqual(PENDING_GAPS);
+        expect(result.handshakeFailed).toBe(true);
+        expect(result.handshakeError).toBe('orphan body');
+    });
+    it('reports success when the handshake completes', async () => {
+        const result = await prepareConnectContext();
+        expect(result.handshakeFailed).toBe(false);
+        expect(result.handshakeError).toBeUndefined();
+    });
+    it('surfaces files PB left untouched (user-owned files without the auto-gen marker)', async () => {
+        // TEN-2107: the handshake skips files the user authored (no auto-gen marker)
+        // and reports them as userOwnedSkipped. The connect screen must relay these so
+        // a user with a pre-existing CLAUDE.md is not falsely told "synced". These are
+        // never treated as drift (TEN-2150).
+        runHandshake.mockResolvedValue({
+            filesWritten: ['AGENTS.md'],
+            filesSkipped: [
+                { path: 'CLAUDE.md', reason: 'user-owned — left untouched (pb won\'t overwrite your file)' },
+            ],
+            userOwnedSkipped: ['CLAUDE.md'],
+        });
+        const result = await prepareConnectContext();
+        expect(result.skippedFiles).toEqual(['CLAUDE.md']);
+        expect(result.handshakeFailed).toBe(false);
+    });
+    it('reports no skipped files when PB wrote (or refreshed) everything', async () => {
+        // Default mock resolves an empty/undefined report → nothing left untouched.
+        const result = await prepareConnectContext();
+        expect(result.skippedFiles).toBeUndefined();
+    });
+});
+//# sourceMappingURL=connect-context.test.js.map