@productbrain/cli 0.1.0-beta.7 → 0.1.0-beta.71

package/dist/commands/codex-prep.js

@@ -0,0 +1,122 @@
+/**
+ * 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 { convexCall } 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 convexCall('chain.getOrientView', { task });
+    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.currentBet)
+            lines.push(`**Current bet:** ${sc.currentBet}`);
+        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 bets
+    if (view.activeBets && view.activeBets.length > 0) {
+        lines.push('## Active Bets');
+        lines.push('');
+        for (const bet of view.activeBets) {
+            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 { convexCall } 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 convexCall('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 convexCall('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: () => convexCall('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: () => convexCall('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-integration.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Integration tests for pb connect — full E2E flow (FEAT-958 S5).
+ * Covers: token validation -> redemption -> key save -> wizard -> handshake.
+ * All external deps (fs, fetch, wizard, handshake) are mocked.
+ */
+export {};
+//# sourceMappingURL=connect-integration.test.d.ts.map

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

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

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

@@ -0,0 +1,200 @@
+/**
+ * Integration tests for pb connect — full E2E flow (FEAT-958 S5).
+ * Covers: token validation -> redemption -> key save -> wizard -> handshake.
+ * All external deps (fs, fetch, wizard, handshake) are mocked.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// Mock modules BEFORE imports
+const mockFetch = vi.fn();
+global.fetch = mockFetch;
+const mockCreateProfile = vi.fn();
+const mockListProfiles = vi.fn(() => []);
+vi.mock('fs', () => ({
+    mkdirSync: vi.fn(),
+    writeFileSync: vi.fn(),
+    existsSync: vi.fn(() => false),
+    readFileSync: vi.fn(() => {
+        throw new Error('ENOENT');
+    }),
+}));
+vi.mock('../lib/constants.js', () => ({
+    resolveAppUrl: () => 'https://test.convex.site',
+    resolveSiteUrl: () => 'https://gateway.productbrain.io',
+    DEFAULT_SITE_URL: 'https://gateway.productbrain.io',
+    resolveConnectRedeemUrl: (cli) => {
+        if (cli?.trim())
+            return cli.trim().replace(/\/$/, '');
+        const fromEnv = process.env.PB_CONNECT_GATEWAY_URL?.trim();
+        if (fromEnv)
+            return fromEnv.replace(/\/$/, '');
+        const fromConvex = process.env.CONVEX_SITE_URL?.trim();
+        if (fromConvex)
+            return fromConvex.replace(/\/$/, '');
+        return 'https://gateway.productbrain.io';
+    },
+}));
+vi.mock('../lib/spinner.js', () => ({
+    withSpinner: async (_msg, fn) => fn(),
+}));
+let clackSelectCallCount = 0;
+vi.mock('@clack/prompts', () => ({
+    select: vi.fn(async () => {
+        clackSelectCallCount++;
+        // First two calls are continue gates, third is "What's next?" menu
+        return clackSelectCallCount <= 2 ? 'continue' : 'start';
+    }),
+    isCancel: vi.fn(() => false),
+}));
+vi.mock('../lib/profiles.js', () => ({
+    createProfile: (...args) => mockCreateProfile(...args),
+    listProfiles: () => mockListProfiles(),
+}));
+vi.mock('./handshake.js', () => ({
+    runHandshake: vi.fn(async () => { }),
+}));
+// Import function under test and mocked modules
+import { runConnect } from './connect.js';
+import { writeFileSync } from 'fs';
+import { runHandshake } from './handshake.js';
+import { CLIError } from '../lib/errors.js';
+import * as clack from '@clack/prompts';
+// Suppress console output
+const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+const stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+const originalEnv = { ...process.env };
+const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+describe('pb connect — integration', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        consoleSpy.mockClear();
+        stdoutSpy.mockClear();
+        stderrSpy.mockClear();
+        clackSelectCallCount = 0;
+        process.env.CONVEX_SITE_URL = 'https://test.convex.site';
+        delete process.env.PB_ENV;
+        delete process.env.PB_CONNECT_GATEWAY_URL;
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+    it('happy path: full connect flow', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_test123',
+                workspaceId: 'ws1',
+                workspaceName: 'Test WS',
+            }),
+        });
+        await runConnect(token);
+        // fetch called with CONVEX_SITE_URL + /auth/redeem-connect-token
+        expect(mockFetch).toHaveBeenCalledWith('https://test.convex.site/auth/redeem-connect-token', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ token }),
+        }));
+        // Profile created with slugified workspace name
+        expect(mockCreateProfile).toHaveBeenCalledWith('test-ws', 'pb_sk_test123', expect.any(String));
+        // useProfile NOT called — connect doesn't hijack global profile
+        // Project config written
+        expect(writeFileSync).toHaveBeenCalled();
+        // Handshake called with no surface filtering (writes all)
+        expect(runHandshake).toHaveBeenCalledWith({
+            quiet: true,
+        });
+        // Interactive prompts were called (continue gates + what's next menu)
+        expect(clack.select).toHaveBeenCalled();
+    });
+    it('token rejection stops flow — wizard and handshake not called', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: false,
+            status: 400,
+            json: async () => ({
+                error: {
+                    code: 'invalid_token',
+                    message: 'Token expired',
+                },
+            }),
+        });
+        await expect(runConnect(token)).rejects.toThrow(CLIError);
+        // Handshake and prompts should NOT have been called
+        expect(runHandshake).not.toHaveBeenCalled();
+        expect(clack.select).not.toHaveBeenCalled();
+    });
+    it('invalid token format never hits server', async () => {
+        await expect(runConnect('bad_token')).rejects.toThrow(CLIError);
+        // fetch should NOT have been called
+        expect(mockFetch).not.toHaveBeenCalled();
+    });
+    it('handshake failure is non-fatal', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_test456',
+                workspaceId: 'ws2',
+                workspaceName: 'WS Two',
+            }),
+        });
+        // Make handshake throw
+        vi.mocked(runHandshake).mockRejectedValueOnce(new Error('Handshake network error'));
+        // runConnect should NOT throw despite handshake failure
+        await expect(runConnect(token)).resolves.toBeUndefined();
+        // Handshake was called (and failed gracefully)
+        expect(runHandshake).toHaveBeenCalledOnce();
+    });
+    it('clack cancel on continue gate exits with 130', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_cancel',
+                workspaceId: 'ws3',
+                workspaceName: 'Cancel WS',
+            }),
+        });
+        // Make isCancel return true on the first select call
+        vi.mocked(clack.isCancel).mockReturnValueOnce(true);
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => { throw new Error('process.exit'); });
+        await expect(runConnect(token)).rejects.toThrow('process.exit');
+        expect(exitSpy).toHaveBeenCalledWith(130);
+        exitSpy.mockRestore();
+    });
+    it('includes deployment hint in error when token is invalid', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: false,
+            status: 400,
+            json: async () => ({
+                error: { code: 'invalid_token', message: 'Token expired' },
+            }),
+        });
+        let caught;
+        try {
+            await runConnect(token);
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(CLIError);
+        expect(caught.guidance).toContain('Tried gateway:');
+        expect(caught.guidance).toContain('CONVEX_SITE_URL');
+        expect(caught.guidance).toContain('--gateway');
+    });
+    it('uses CONVEX_SITE_URL for redeem when set', async () => {
+        process.env.CONVEX_SITE_URL = 'https://my-dev.convex.site';
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_convex',
+                workspaceId: 'ws-convex',
+                workspaceName: 'Convex WS',
+            }),
+        });
+        await runConnect(token);
+        expect(mockFetch).toHaveBeenCalledWith('https://my-dev.convex.site/auth/redeem-connect-token', expect.objectContaining({ method: 'POST' }));
+    });
+});
+//# sourceMappingURL=connect-integration.test.js.map

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

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

package/dist/commands/connect.d.ts

@@ -0,0 +1,21 @@
+/**
+ * pb connect — redeem a short-lived connect token to save an API key locally.
+ *
+ * Part of FEAT-958 Path C: Onboarding flow.
+ * Token is obtained from an onboarding link (e.g., email, QR code).
+ * S1 endpoint: POST /auth/redeem-connect-token
+ * S2 (this): CLI command to parse token, redeem, and save key locally.
+ * S3: Wizard flow (surface detection + trust level).
+ * S4: Final handshake (pb handshake).
+ */
+export interface ConnectOptions {
+    /** Override redeem gateway (`pb connect --gateway`). */
+    gateway?: string;
+}
+/**
+ * Main entrypoint for `pb connect <token>`.
+ * Validates token format, redeems it via /auth/redeem-connect-token,
+ * saves the key, and runs the wizard (S3).
+ */
+export declare function runConnect(token: string, options?: ConnectOptions): Promise<void>;
+//# sourceMappingURL=connect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiNH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmG3F"}