@productbrain/cli 0.1.0-beta.35 → 0.1.0-beta.3508

package/dist/lib/upgrade-runner.js

@@ -0,0 +1,110 @@
+import { spawn } from 'node:child_process';
+import { basename, dirname } from 'node:path';
+import { CLIError, ErrorCode } from './errors.js';
+import { UPGRADE_COMMAND } from './constants.js';
+import { trackEvent } from './telemetry.js';
+import { writeUpgradePendingSentinel } from './update-check.js';
+function pathSegments(path) {
+    const segments = [];
+    let current = path;
+    while (current && current !== dirname(current)) {
+        segments.push(basename(current).toLowerCase());
+        current = dirname(current);
+    }
+    return segments;
+}
+export function detectInstallChannel(execPath = process.execPath, env = process.env) {
+    const ua = env.npm_config_user_agent?.toLowerCase() ?? '';
+    if (ua.startsWith('pnpm'))
+        return 'pnpm';
+    if (ua.startsWith('yarn'))
+        return 'yarn';
+    if (ua.startsWith('bun'))
+        return 'bun';
+    if (ua.startsWith('npm'))
+        return 'npm';
+    const segments = pathSegments(execPath);
+    if (segments.some((s) => s.includes('pnpm')))
+        return 'pnpm';
+    if (segments.some((s) => s.includes('yarn')))
+        return 'yarn';
+    if (segments.some((s) => s.includes('bun')))
+        return 'bun';
+    if (segments.some((s) => s.includes('homebrew') || s === 'brew' || s === 'cellar'))
+        return 'brew';
+    if (segments.some((s) => s.includes('npm') || s === 'node_modules'))
+        return 'npm';
+    return 'unknown';
+}
+export function buildUpgradeCommand(channel, version) {
+    const spec = version ? `@productbrain/cli@${version}` : '@productbrain/cli@beta';
+    switch (channel) {
+        case 'pnpm':
+            return { channel, command: 'pnpm', args: ['add', '-g', spec], display: `pnpm add -g ${spec}` };
+        case 'yarn':
+            return { channel, command: 'yarn', args: ['global', 'add', spec], display: `yarn global add ${spec}` };
+        case 'bun':
+            return { channel, command: 'bun', args: ['add', '-g', spec], display: `bun add -g ${spec}` };
+        case 'brew':
+            return { channel, command: 'brew', args: ['upgrade', 'productbrain'], display: 'brew upgrade productbrain' };
+        case 'npm':
+        case 'unknown':
+            return { channel, command: 'npm', args: ['install', '-g', spec], display: version ? `npm install -g ${spec}` : UPGRADE_COMMAND };
+    }
+}
+function failureGuidance(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes('eacces') || lower.includes('permission denied')) {
+        return 'Permission denied during global install. Use a Node version manager, fix the global npm prefix, or rerun the install command with the permissions your system requires.';
+    }
+    if (process.platform === 'win32' && (lower.includes('eperm') || lower.includes('busy') || lower.includes('locked'))) {
+        return 'Windows could not replace the active pb executable. Close terminals running pb, then rerun the upgrade command.';
+    }
+    return 'Run the displayed upgrade command manually, then retry pb doctor.';
+}
+export function spawnUpgrade(channel = detectInstallChannel(), options = {}) {
+    const spec = buildUpgradeCommand(channel, options.version);
+    const output = [];
+    trackEvent('cli.upgrade.initiated', { channel: spec.channel });
+    return new Promise((resolve, reject) => {
+        const child = spawn(spec.command, spec.args, {
+            env: options.env ?? process.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const emit = (chunk) => {
+            const text = chunk.toString();
+            for (const line of text.split(/\r?\n/).filter(Boolean)) {
+                output.push(line);
+                options.onOutput?.(line);
+            }
+        };
+        child.stdout?.on('data', emit);
+        child.stderr?.on('data', emit);
+        child.on('error', (err) => {
+            const message = err.message || `Failed to spawn ${spec.display}`;
+            trackEvent('cli.upgrade.failed', { channel: spec.channel, reason: err.code ?? 'spawn_error' });
+            reject(new CLIError(`Upgrade failed: ${message}`, {
+                code: ErrorCode.UPGRADE_FAILED,
+                category: 'internal',
+                guidance: failureGuidance(message),
+            }));
+        });
+        child.on('close', (code) => {
+            const exitCode = code ?? 1;
+            if (exitCode !== 0) {
+                const message = output.slice(-4).join('\n') || `${spec.display} exited with code ${exitCode}`;
+                trackEvent('cli.upgrade.failed', { channel: spec.channel, exitCode });
+                reject(new CLIError(`Upgrade failed: ${message}`, {
+                    code: ErrorCode.UPGRADE_FAILED,
+                    category: 'internal',
+                    guidance: failureGuidance(message),
+                }));
+                return;
+            }
+            writeUpgradePendingSentinel(options.version);
+            trackEvent('cli.upgrade.succeeded', { channel: spec.channel });
+            resolve({ channel: spec.channel, command: spec.display, exitCode, output });
+        });
+    });
+}
+//# sourceMappingURL=upgrade-runner.js.map

package/dist/lib/upgrade-runner.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * 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?
+ */
+export type Surface = 'cursor' | 'claude-code' | 'vscode';
+/**
+ * Detect if Cursor is installed.
+ * Checks: `which cursor` or common macOS/Windows install paths.
+ * Returns: true if found, false otherwise.
+ */
+export declare function detectCursor(): boolean;
+/**
+ * Detect if Claude Code (VS Code extension) is installed.
+ * Checks: ~/.vscode/extensions for `anthropic.claude-*` directory.
+ * Returns: true if found, false otherwise.
+ */
+export declare function detectClaudeCode(): boolean;
+/**
+ * Detect if VS Code is installed.
+ * Checks: `which code` or common install paths.
+ * Returns: true if found, false otherwise.
+ */
+export declare function detectVSCode(): boolean;
+/**
+ * Detect all installed AI tools.
+ * Returns: array of detected surface IDs (empty if none found).
+ */
+export declare function detectSurfaces(): Promise<Surface[]>;
+/**
+ * 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 declare function confirmSurfaces(detected: Surface[]): Promise<Surface[]>;
+/**
+ * Run the full surface detection + confirmation flow.
+ * Returns: user-confirmed surfaces.
+ */
+export declare function runSurfaceWizard(): Promise<Surface[]>;
+/**
+ * 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 declare function mapSurfacesToTargets(surfaces: Surface[]): string[];
+//# sourceMappingURL=wizard-surfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-surfaces.d.ts","sourceRoot":"","sources":["../../src/lib/wizard-surfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,CAAC;AA0B1D;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAYtC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAW1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAWtC;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAQzD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA2B7E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAsB3D;AASD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CASlE"}

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