@productbrain/cli 0.1.0-beta.15 → 0.1.0-beta.1522

package/dist/lib/wizard-surfaces.js

@@ -0,0 +1,176 @@
+/**
+ * Surface detection — identify installed AI tools (Cursor, Claude Code, VS Code).
+ * Part of FEAT-958 Path C: Onboarding wizard (S3).
+ * Q1: Which AI tools do you use?
+ */
+import { execSync } from 'child_process';
+import { existsSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import * as clack from '@clack/prompts';
+const SURFACES = {
+    cursor: {
+        id: 'cursor',
+        label: 'Cursor',
+        hint: "We'll add .cursor/rules/ with your product context",
+    },
+    'claude-code': {
+        id: 'claude-code',
+        label: 'Claude Code',
+        hint: "We'll create CLAUDE.md with your product context",
+    },
+    vscode: {
+        id: 'vscode',
+        label: 'VS Code',
+        hint: "We'll add .github/copilot-instructions.md",
+    },
+};
+/**
+ * Detect if Cursor is installed.
+ * Checks: `which cursor` or common macOS/Windows install paths.
+ * Returns: true if found, false otherwise.
+ */
+export function detectCursor() {
+    try {
+        // Try 'which cursor'
+        execSync('which cursor', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        // Check macOS common path
+        if (existsSync('/Applications/Cursor.app'))
+            return true;
+        // Check Windows common path
+        if (existsSync(join(process.env.APPDATA || '', 'Cursor')))
+            return true;
+        return false;
+    }
+}
+/**
+ * Detect if Claude Code (VS Code extension) is installed.
+ * Checks: ~/.vscode/extensions for `anthropic.claude-*` directory.
+ * Returns: true if found, false otherwise.
+ */
+export function detectClaudeCode() {
+    const extensionsPath = join(homedir(), '.vscode', 'extensions');
+    if (!existsSync(extensionsPath))
+        return false;
+    try {
+        // List directories in extensions folder
+        const dirs = readdirSync(extensionsPath);
+        return dirs.some((dir) => dir.startsWith('anthropic.claude-'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect if VS Code is installed.
+ * Checks: `which code` or common install paths.
+ * Returns: true if found, false otherwise.
+ */
+export function detectVSCode() {
+    try {
+        execSync('which code', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        // Check macOS common path
+        if (existsSync('/Applications/Visual Studio Code.app'))
+            return true;
+        // Check Windows common path
+        if (existsSync(join(process.env.ProgramFiles || '', 'Microsoft VS Code')))
+            return true;
+        return false;
+    }
+}
+/**
+ * Detect all installed AI tools.
+ * Returns: array of detected surface IDs (empty if none found).
+ */
+export async function detectSurfaces() {
+    const detected = [];
+    if (detectCursor())
+        detected.push('cursor');
+    if (detectClaudeCode())
+        detected.push('claude-code');
+    if (detectVSCode())
+        detected.push('vscode');
+    return detected;
+}
+/**
+ * Prompt user to confirm/modify detected surfaces.
+ * Uses multiselect with auto-detected items pre-checked.
+ * Returns: user-selected surfaces (can be a subset or addition to detected).
+ */
+export async function confirmSurfaces(detected) {
+    const allSurfaces = Object.keys(SURFACES);
+    // Format options for multiselect
+    const options = allSurfaces.map((surface) => ({
+        value: surface,
+        label: SURFACES[surface].label,
+        hint: SURFACES[surface].hint,
+    }));
+    // Hint for multiselect UX
+    console.log('  (Use space to select, enter to confirm)\n');
+    // Use multiselect with detected items as initialValues
+    const result = await clack.multiselect({
+        message: 'Where do you code?',
+        options,
+        initialValues: detected,
+        required: detected.length > 0, // At least one must be selected if any were detected
+    });
+    // Handle cancel
+    if (clack.isCancel(result)) {
+        process.exit(130);
+    }
+    return result.sort();
+}
+/**
+ * Run the full surface detection + confirmation flow.
+ * Returns: user-confirmed surfaces.
+ */
+export async function runSurfaceWizard() {
+    const detected = await detectSurfaces();
+    if (detected.length === 0) {
+        console.log('⚠ No AI tools detected.');
+        console.log('');
+        console.log('ProductBrain integrates with:');
+        for (const surface of Object.values(SURFACES)) {
+            console.log(`  • ${surface.label} — ${surface.hint}`);
+        }
+        console.log('');
+        console.log('Install one of these tools and try again.');
+        console.log('For now, skipping surface configuration.');
+        return [];
+    }
+    // Detected surfaces found — let user confirm/modify
+    console.log(`✓ Detected: ${detected.map((s) => SURFACES[s].label).join(', ')}`);
+    console.log('');
+    const confirmed = await confirmSurfaces(detected);
+    return confirmed;
+}
+/** Map wizard Surface IDs to handshake TargetName IDs */
+const SURFACE_TO_TARGET = {
+    cursor: 'cursor',
+    'claude-code': 'claude',
+    vscode: 'copilot',
+};
+/**
+ * Map wizard-detected surfaces to handshake target names.
+ * Always includes 'codex' (batch/CI tool, not user-detected).
+ * Returns empty array if surfaces is empty (no filtering).
+ */
+export function mapSurfacesToTargets(surfaces) {
+    if (surfaces.length === 0)
+        return []; // empty = no filtering
+    const targets = new Set();
+    for (const s of surfaces) {
+        const t = SURFACE_TO_TARGET[s];
+        if (t)
+            targets.add(t);
+    }
+    targets.add('codex'); // always include batch target
+    return [...targets];
+}
+//# sourceMappingURL=wizard-surfaces.js.map

package/dist/lib/wizard-surfaces.js.map

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

package/dist/lib/wizard-surfaces.test.d.ts

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

package/dist/lib/wizard-surfaces.test.d.ts.map

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

package/dist/lib/wizard-surfaces.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { execSync } from 'child_process';
+import { existsSync, readdirSync } from 'fs';
+vi.mock('child_process', () => ({ execSync: vi.fn() }));
+vi.mock('fs', () => {
+    const mod = {
+        existsSync: vi.fn(() => false),
+        readdirSync: vi.fn(() => []),
+    };
+    return { ...mod, default: mod };
+});
+vi.mock('os', () => ({ homedir: vi.fn(() => '/mock-home') }));
+vi.mock('path', async () => {
+    const actual = await vi.importActual('path');
+    return actual;
+});
+vi.mock('@clack/prompts', () => ({
+    multiselect: vi.fn(),
+    isCancel: vi.fn(() => false),
+}));
+import { detectCursor, detectClaudeCode, detectVSCode, detectSurfaces, mapSurfacesToTargets } from './wizard-surfaces.js';
+beforeEach(() => {
+    vi.clearAllMocks();
+    // Reset defaults: execSync throws, existsSync returns false, readdirSync returns []
+    vi.mocked(execSync).mockImplementation(() => {
+        throw new Error('not found');
+    });
+    vi.mocked(existsSync).mockReturnValue(false);
+    vi.mocked(readdirSync).mockReturnValue([]);
+});
+describe('detectCursor', () => {
+    it('returns true when `which cursor` succeeds', () => {
+        vi.mocked(execSync).mockReturnValueOnce(Buffer.from('/usr/local/bin/cursor'));
+        expect(detectCursor()).toBe(true);
+    });
+    it('returns true when execSync throws but /Applications/Cursor.app exists', () => {
+        vi.mocked(execSync).mockImplementation(() => {
+            throw new Error('not found');
+        });
+        vi.mocked(existsSync).mockImplementation((p) => {
+            if (p === '/Applications/Cursor.app')
+                return true;
+            return false;
+        });
+        expect(detectCursor()).toBe(true);
+    });
+    it('returns false when both which and path checks fail', () => {
+        expect(detectCursor()).toBe(false);
+    });
+});
+describe('detectClaudeCode', () => {
+    it('returns true when extensions dir contains anthropic.claude-*', () => {
+        vi.mocked(existsSync).mockImplementation((p) => {
+            if (String(p).includes('.vscode/extensions'))
+                return true;
+            return false;
+        });
+        // detectClaudeCode uses require('fs').readdirSync internally
+        vi.mocked(readdirSync).mockReturnValue(['anthropic.claude-1.0.0']);
+        expect(detectClaudeCode()).toBe(true);
+    });
+    it('returns false when extensions dir does not exist', () => {
+        vi.mocked(existsSync).mockReturnValue(false);
+        expect(detectClaudeCode()).toBe(false);
+    });
+});
+describe('detectVSCode', () => {
+    it('returns true when `which code` succeeds', () => {
+        vi.mocked(execSync).mockReturnValueOnce(Buffer.from('/usr/local/bin/code'));
+        expect(detectVSCode()).toBe(true);
+    });
+    it('returns false when all checks fail', () => {
+        expect(detectVSCode()).toBe(false);
+    });
+});
+describe('detectSurfaces', () => {
+    it('returns detected surfaces for cursor + vscode', async () => {
+        // execSync: first call (cursor) succeeds, second call (claude-code existsSync) fails,
+        // third call (vscode) succeeds
+        let callCount = 0;
+        vi.mocked(execSync).mockImplementation(() => {
+            callCount++;
+            // Call 1: 'which cursor' — succeed
+            if (callCount === 1)
+                return Buffer.from('/usr/local/bin/cursor');
+            // Call 2: 'which code' — succeed
+            if (callCount === 2)
+                return Buffer.from('/usr/local/bin/code');
+            throw new Error('not found');
+        });
+        // existsSync: extensions dir doesn't exist (so claude-code is false)
+        vi.mocked(existsSync).mockReturnValue(false);
+        const result = await detectSurfaces();
+        expect(result).toEqual(['cursor', 'vscode']);
+    });
+});
+describe('mapSurfacesToTargets', () => {
+    it('maps cursor to cursor', () => {
+        const targets = mapSurfacesToTargets(['cursor']);
+        expect(targets).toContain('cursor');
+    });
+    it('maps claude-code to claude', () => {
+        const targets = mapSurfacesToTargets(['claude-code']);
+        expect(targets).toContain('claude');
+    });
+    it('maps vscode to copilot', () => {
+        const targets = mapSurfacesToTargets(['vscode']);
+        expect(targets).toContain('copilot');
+    });
+    it('always includes codex for non-empty input', () => {
+        const targets = mapSurfacesToTargets(['cursor']);
+        expect(targets).toContain('codex');
+    });
+    it('returns empty array for empty input', () => {
+        const targets = mapSurfacesToTargets([]);
+        expect(targets).toEqual([]);
+    });
+    it('maps multiple surfaces correctly', () => {
+        const targets = mapSurfacesToTargets(['cursor', 'claude-code', 'vscode']);
+        expect(targets).toContain('cursor');
+        expect(targets).toContain('claude');
+        expect(targets).toContain('copilot');
+        expect(targets).toContain('codex');
+        expect(targets).toHaveLength(4);
+    });
+});
+//# sourceMappingURL=wizard-surfaces.test.js.map

package/dist/lib/wizard-surfaces.test.js.map

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

package/dist/lib/wizard-trust.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Trust level selection — reuses handshake --init logic.
+ * Part of FEAT-958 Path C: Onboarding wizard (S3).
+ * Q2: How much context should ProductBrain see?
+ */
+export type TrustLevel = 'basic' | 'intermediate' | 'full';
+/**
+ * Prompt user to select trust level.
+ * Defaults to 'intermediate'.
+ * Returns: selected trust level.
+ */
+export declare function askTrustLevel(): Promise<TrustLevel>;
+/**
+ * Get the description for a trust level.
+ * Used for display/confirmation messages.
+ */
+export declare function getTrustLevelDescription(level: TrustLevel): string;
+/**
+ * Validate trust level string.
+ * Returns: error message if invalid, undefined if valid.
+ */
+export declare function validateTrustLevel(level: string): string | undefined;
+/**
+ * Get all trust levels (for help text, etc).
+ */
+export declare function getTrustLevels(): Array<{
+    value: TrustLevel;
+    label: string;
+    description: string;
+}>;
+//# sourceMappingURL=wizard-trust.d.ts.map

package/dist/lib/wizard-trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-trust.d.ts","sourceRoot":"","sources":["../../src/lib/wizard-trust.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,MAAM,CAAC;AAyB3D;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAWzD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKpE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAMjG"}

package/dist/lib/wizard-trust.js

@@ -0,0 +1,66 @@
+/**
+ * Trust level selection — reuses handshake --init logic.
+ * Part of FEAT-958 Path C: Onboarding wizard (S3).
+ * Q2: How much context should ProductBrain see?
+ */
+import { select as promptSelect } from './prompts.js';
+const TRUST_LEVELS = {
+    basic: {
+        label: 'Basic',
+        description: 'Only entry names and titles (minimal context)',
+    },
+    intermediate: {
+        label: 'Intermediate',
+        description: 'Names, descriptions, and relations (recommended)',
+    },
+    full: {
+        label: 'Full',
+        description: 'Complete context including custom fields',
+    },
+};
+// Explicit ordering — determines menu numbering
+const TRUST_KEYS = ['basic', 'intermediate', 'full'];
+/**
+ * Prompt user to select trust level.
+ * Defaults to 'intermediate'.
+ * Returns: selected trust level.
+ */
+export async function askTrustLevel() {
+    const result = await promptSelect({
+        message: 'How much context should ProductBrain see?',
+        options: TRUST_KEYS.map((key) => ({
+            value: key,
+            label: TRUST_LEVELS[key].label,
+            hint: TRUST_LEVELS[key].description,
+        })),
+    });
+    return result;
+}
+/**
+ * Get the description for a trust level.
+ * Used for display/confirmation messages.
+ */
+export function getTrustLevelDescription(level) {
+    return TRUST_LEVELS[level].description;
+}
+/**
+ * Validate trust level string.
+ * Returns: error message if invalid, undefined if valid.
+ */
+export function validateTrustLevel(level) {
+    if (!TRUST_KEYS.includes(level)) {
+        return `Invalid trust level "${level}". Valid options: ${TRUST_KEYS.join(', ')}`;
+    }
+    return undefined;
+}
+/**
+ * Get all trust levels (for help text, etc).
+ */
+export function getTrustLevels() {
+    return TRUST_KEYS.map((key) => ({
+        value: key,
+        label: TRUST_LEVELS[key].label,
+        description: TRUST_LEVELS[key].description,
+    }));
+}
+//# sourceMappingURL=wizard-trust.js.map

package/dist/lib/wizard-trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-trust.js","sourceRoot":"","sources":["../../src/lib/wizard-trust.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AAStD,MAAM,YAAY,GAAyC;IACzD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,+CAA+C;KAC7D;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,kDAAkD;KAChE;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,0CAA0C;KACxD;CACF,CAAC;AAEF,gDAAgD;AAChD,MAAM,UAAU,GAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAa;QAC5C,OAAO,EAAE,2CAA2C;QACpD,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAChC,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK;YAC9B,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW;SACpC,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAiB;IACxD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAmB,CAAC,EAAE,CAAC;QAC9C,OAAO,wBAAwB,KAAK,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK;QAC9B,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW;KAC3C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/lib/wizard-trust.test.d.ts

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

package/dist/lib/wizard-trust.test.d.ts.map

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

package/dist/lib/wizard-trust.test.js

@@ -0,0 +1,32 @@
+import { describe, it, expect } from 'vitest';
+import { validateTrustLevel, getTrustLevelDescription, getTrustLevels, } from './wizard-trust.js';
+describe('Trust Level Validation', () => {
+    it('should validate correct trust levels', () => {
+        expect(validateTrustLevel('basic')).toBeUndefined();
+        expect(validateTrustLevel('intermediate')).toBeUndefined();
+        expect(validateTrustLevel('full')).toBeUndefined();
+    });
+    it('should reject invalid trust levels', () => {
+        const result = validateTrustLevel('invalid');
+        expect(result).toBeDefined();
+        expect(result).toContain('Invalid trust level');
+    });
+    it('should return descriptions for trust levels', () => {
+        const basic = getTrustLevelDescription('basic');
+        expect(basic).toContain('names and titles');
+        const intermediate = getTrustLevelDescription('intermediate');
+        expect(intermediate).toContain('descriptions');
+        const full = getTrustLevelDescription('full');
+        expect(full).toContain('custom fields');
+    });
+    it('should return all trust levels', () => {
+        const levels = getTrustLevels();
+        expect(levels).toHaveLength(3);
+        expect(levels.map((l) => l.value)).toEqual(['basic', 'intermediate', 'full']);
+    });
+    it('should have valid TrustLevel type', () => {
+        const level = 'intermediate';
+        expect(level).toBe('intermediate');
+    });
+});
+//# sourceMappingURL=wizard-trust.test.js.map

package/dist/lib/wizard-trust.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-trust.test.js","sourceRoot":"","sources":["../../src/lib/wizard-trust.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GAEf,MAAM,mBAAmB,CAAC;AAE3B,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACpD,MAAM,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC3D,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAE5C,MAAM,YAAY,GAAG,wBAAwB,CAAC,cAAc,CAAC,CAAC;QAC9D,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAE/C,MAAM,IAAI,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAe,cAAc,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/workspace-probe.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared workspace probe utility — single source of truth for workspace connectivity check.
+ * Used by both `pb init` and the no-args dashboard in `index.ts`.
+ *
+ * Design: lightweight orient call to detect workspace reachability. Returns structured
+ * workspace info on success, null on any failure (network, auth, offline).
+ */
+/**
+ * Attempt to detect workspace connectivity via a lightweight API call.
+ * Returns workspace info on success, null on any failure.
+ *
+ * Uses resolveWorkspace (registered in http.ts) rather than orient, which is
+ * not exposed on the HTTP gateway — orient is MCP-server-only.
+ */
+export declare function probeWorkspace(): Promise<{
+    name: string;
+    entryCount?: number;
+} | null>;
+//# sourceMappingURL=workspace-probe.d.ts.map

package/dist/lib/workspace-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-probe.d.ts","sourceRoot":"","sources":["../../src/lib/workspace-probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAQ5F"}

package/dist/lib/workspace-probe.js

@@ -0,0 +1,27 @@
+/**
+ * Shared workspace probe utility — single source of truth for workspace connectivity check.
+ * Used by both `pb init` and the no-args dashboard in `index.ts`.
+ *
+ * Design: lightweight orient call to detect workspace reachability. Returns structured
+ * workspace info on success, null on any failure (network, auth, offline).
+ */
+import { kernelCall } from './client.js';
+/**
+ * Attempt to detect workspace connectivity via a lightweight API call.
+ * Returns workspace info on success, null on any failure.
+ *
+ * Uses resolveWorkspace (registered in http.ts) rather than orient, which is
+ * not exposed on the HTTP gateway — orient is MCP-server-only.
+ */
+export async function probeWorkspace() {
+    try {
+        const result = await kernelCall('resolveWorkspace', {});
+        if (!result)
+            return null;
+        return { name: result.name || 'unknown' };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=workspace-probe.js.map

package/dist/lib/workspace-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-probe.js","sourceRoot":"","sources":["../../src/lib/workspace-probe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAA0C,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACjG,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/workspaceVocabCache.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 5-minute TTL cache for workspace vocabulary context (WP-436 S2).
+ *
+ * Purpose (R2 mitigation): the CLI resolves vocabulary labels on every invocation.
+ * Without a cache, each `pb orient` / `pb get` / `pb capture` would call
+ * `chain.getVocabulary` — adding a Convex round-trip overhead and risking
+ * handshake-time staleness. A 5-min TTL short-circuits repeat calls within
+ * a typical session while staying fresh enough that label changes land quickly.
+ *
+ * PAT-230: the cache holds WorkspaceVocabCtx (pure data, no Convex imports here).
+ * DEC-1021: only Axis 2 (collectionLabels) lives here; Axis 1 (displayNames) is untouched.
+ *
+ * S4 note: when Cortex UI builds its `vocabularyStore`, it should mirror this
+ * contract — a keyed map by workspaceId with an expiresAt field (Cortex has
+ * direct access to workspaceId; the CLI uses apiKey as a 1:1 surrogate, since
+ * the HTTP gateway server-side injects workspaceId from authResult per
+ * convex/http.ts:675).
+ */
+import type { WorkspaceVocabCtx } from './canonicalRefs.js';
+/**
+ * Get a cached WorkspaceVocabCtx by cacheKey, or null if expired/missing.
+ * Prints a staleness warning when the entry is older than STALE_WARN_MS.
+ */
+export declare function getCachedVocabCtx(cacheKey: string): WorkspaceVocabCtx | null;
+/**
+ * Store a WorkspaceVocabCtx under cacheKey with a 5-min TTL.
+ */
+export declare function setCachedVocabCtx(cacheKey: string, ctx: WorkspaceVocabCtx): void;
+/**
+ * Explicitly invalidate a cached vocab context by cacheKey.
+ * Call this when `updateCollectionLabels` mutation succeeds (e.g. after `pb handshake`).
+ */
+export declare function invalidateVocabCtx(cacheKey: string): void;
+/**
+ * Clear all cached entries (useful for testing or `pb handshake --refresh`).
+ */
+export declare function clearVocabCache(): void;
+/**
+ * Get the cached vocab context, or fetch it via the provided async fetcher on cache miss.
+ *
+ * Usage pattern at CLI command sites:
+ * ```ts
+ * const vocabCtx = await getOrFetchVocabCtx(config.apiKey, async () => {
+ *   type VocabResult = { collectionLabels?: Record<string, unknown> };
+ *   const vocab = await kernelCall<VocabResult>('chain.getVocabulary', {});
+ *   return vocab?.collectionLabels
+ *     ? { collectionLabels: vocab.collectionLabels as WorkspaceVocabCtx['collectionLabels'] }
+ *     : null;
+ * });
+ * ```
+ *
+ * - `cacheKey`: use the API key as a surrogate for cacheKey (1:1 mapping at CLI layer).
+ * - `fetcher`: async function that resolves the vocab ctx; returns null on failure to signal
+ *   "don't cache, fall back to resolver literal". Fetcher errors are swallowed — vocabulary
+ *   labels are advisory (PAT-230 / fail-open principle).
+ *
+ * Returns WorkspaceVocabCtx on cache hit or successful fetch; undefined on error/null fetcher result.
+ */
+export declare function getOrFetchVocabCtx(cacheKey: string, fetcher: () => Promise<WorkspaceVocabCtx | null>): Promise<WorkspaceVocabCtx | undefined>;
+//# sourceMappingURL=workspaceVocabCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceVocabCache.d.ts","sourceRoot":"","sources":["../../src/lib/workspaceVocabCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAc5D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAe5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAEhF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAC/C,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAcxC"}