@productbrain/cli 0.1.0-beta.1131 → 0.1.0-beta.11318

package/dist/lib/onboarding-shared.js

@@ -1,174 +0,0 @@
-/**
- * Shared onboarding utilities — types, extraction mapping, batch capture, retrieval proof.
- * WP-304: Extracted from onboarding.ts to support both Path A and future Path B.
- *
- * DIVERGED from packages/mcp-server/src/tools/start-interview.ts:extractionToBatchEntries per DEC-522.
- * Copy-and-own: CLI uses 120-char truncate limits (vs MCP's 80). Shared package deferred.
- * Duplicated due to monorepo import boundary (BR-108).
- */
-import { kernelCallWithSession } from './client.js';
-import { bold, cyan, dim, icons } from './style.js';
-// ── String helpers ─────────────────────────────────────────────────────────
-export function truncate(str, maxLen) {
-    if (str.length <= maxLen)
-        return str;
-    const truncated = str.slice(0, maxLen);
-    const lastSpace = truncated.lastIndexOf(' ');
-    return lastSpace > maxLen * 0.6 ? truncated.slice(0, lastSpace) : truncated;
-}
-export function firstNWords(str, n) {
-    return str.split(/\s+/).slice(0, n).join(' ');
-}
-export function countWords(text) {
-    return text.trim().split(/\s+/).filter(Boolean).length;
-}
-// ── Extraction → Entries Validation ──────────────────────────────────────
-const VALID_COLLECTIONS = new Set(['strategy', 'audiences', 'architecture', 'glossary', 'decisions', 'tensions']);
-/**
- * Validate and clean LLM-extracted entries. The LLM outputs entry-shaped data directly;
- * this function validates shape, deduplicates, and caps the result.
- */
-export function validateExtractedEntries(entries) {
-    if (!Array.isArray(entries))
-        return [];
-    const seen = new Set();
-    const validated = [];
-    for (const entry of entries) {
-        if (!entry || typeof entry !== 'object')
-            continue;
-        const e = entry;
-        const collection = typeof e.collection === 'string' ? e.collection : '';
-        const name = typeof e.name === 'string' ? e.name.trim() : '';
-        const description = typeof e.description === 'string' ? e.description.trim() : '';
-        const typeLabel = typeof e.typeLabel === 'string' ? e.typeLabel.trim() : '';
-        // Validate required fields
-        if (!name || !description || !VALID_COLLECTIONS.has(collection))
-            continue;
-        // Skip single-word names (except glossary)
-        if (name.split(/\s+/).length < 2 && collection !== 'glossary')
-            continue;
-        // Dedup by name (case-insensitive)
-        const key = name.toLowerCase();
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        validated.push({
-            collection,
-            name: truncate(name, 120),
-            description,
-            typeLabel: typeLabel || collection, // fallback to collection if LLM omits
-        });
-    }
-    return validated.slice(0, 7);
-}
-/** @deprecated Use validateExtractedEntries instead — kept for backward compat during migration. */
-export function extractionToEntries(extracted) {
-    const entries = [];
-    if (extracted.vision?.trim()) {
-        entries.push({
-            collection: 'strategy',
-            name: 'Product Vision',
-            description: extracted.vision,
-            typeLabel: "What you're building",
-        });
-    }
-    if (extracted.audience) {
-        entries.push({
-            collection: 'audiences',
-            name: firstNWords(extracted.audience, 6),
-            description: extracted.audience,
-            typeLabel: "Who it's for",
-        });
-    }
-    if (extracted.keyTerms?.length) {
-        for (const term of extracted.keyTerms) {
-            const alreadyAdded = entries.some((e) => e.collection === 'glossary' && e.name.toLowerCase() === term.toLowerCase());
-            if (!alreadyAdded) {
-                entries.push({
-                    collection: 'glossary',
-                    name: term,
-                    description: `Core domain term: ${term}`,
-                    typeLabel: 'A term worth remembering',
-                });
-            }
-        }
-    }
-    if (extracted.keyDecisions?.length) {
-        for (const decision of extracted.keyDecisions) {
-            entries.push({
-                collection: 'decisions',
-                name: truncate(decision, 120),
-                description: decision,
-                typeLabel: 'A decision you\'ve made',
-            });
-        }
-    }
-    if (extracted.tensions?.length) {
-        for (const tension of extracted.tensions) {
-            entries.push({
-                collection: 'tensions',
-                name: truncate(tension, 120),
-                description: tension,
-                typeLabel: 'A challenge you\'re facing',
-            });
-        }
-    }
-    return entries;
-}
-// ── Display helpers ───────────────────────────────────────────────────────
-/**
- * Display one entry example with schema structure.
- * Shows typeLabel (from LLM), name, and description in a clean format.
- */
-export function displayEntryExample(entry) {
-    process.stdout.write(`    ${cyan(entry.typeLabel)}\n`);
-    process.stdout.write(`    ${bold(entry.name)}\n`);
-    if (entry.description !== entry.name) {
-        process.stdout.write(`    ${dim(entry.description)}\n`);
-    }
-    process.stdout.write('\n');
-}
-// ── Batch capture ─────────────────────────────────────────────────────────
-/**
- * Batch-capture entries via MCP chain.createEntry.
- * Returns count of captured entries and any error messages.
- */
-export async function batchCaptureEntries(entries) {
-    let capturedCount = 0;
-    const errors = [];
-    for (const entry of entries) {
-        try {
-            await kernelCallWithSession('chain.createEntry', {
-                collectionSlug: entry.collection,
-                name: entry.name,
-                // DEC-896 / BR-76: omit status — server resolves from governanceMode (Open→active, else draft).
-                data: { description: entry.description },
-            });
-            capturedCount++;
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            errors.push(`${entry.name}: ${msg}`);
-        }
-    }
-    return { capturedCount, errors };
-}
-// ── Captured proof ────────────────────────────────────────────────────────
-/**
- * Show deterministic proof of what was captured — displays the entries that were just saved.
- * Guaranteed to show content (no network call that can fail or return empty).
- * Satisfies BR-141: "First-session flow MUST end with retrieval demonstration."
- */
-export function showCapturedSummary(entries, capturedCount) {
-    if (capturedCount === 0 || entries.length === 0)
-        return;
-    process.stdout.write(`\n  ${bold('Your AI tools will now remember:')}\n\n`);
-    for (const entry of entries.slice(0, 5)) {
-        process.stdout.write(`    ${dim(icons.dot)} ${entry.name}\n`);
-    }
-    if (entries.length > 5) {
-        process.stdout.write(`    ${dim(`...and ${entries.length - 5} more`)}\n`);
-    }
-    process.stdout.write('\n');
-}
-//# sourceMappingURL=onboarding-shared.js.map

package/dist/lib/onboarding-shared.js.map

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

package/dist/lib/onboarding-topics.d.ts

@@ -1,27 +0,0 @@
-/**
- * Onboarding conversation topics — coach pattern for first-time setup.
- * WP-304: Each topic has goal/behaviour/criteria. LLM judges completion,
- * heuristic signals are backup. Topics auto-skip when content is already covered.
- */
-import type { ConversationSignals } from './conversation-phases.js';
-/** A conversation topic with coaching directives and completion criteria. */
-export interface OnboardingTopic {
-    /** Unique topic identifier. */
-    id: string;
-    /** What we're trying to learn from this topic. */
-    goal: string;
-    /** How the LLM should behave during this topic. */
-    behaviour: string;
-    /** When this topic is complete — the LLM judges this. */
-    criteria: string;
-    /** Max exchanges before forced advancement. Safety valve. */
-    maxExchanges: number;
-    /** If this signal is already true, skip this topic entirely. Null = always run. */
-    skipIfSignal: keyof ConversationSignals | null;
-    /** Heuristic backup: if this signal is true, topic is complete even if LLM disagrees. */
-    heuristicSignal: keyof ConversationSignals | null;
-}
-export declare const ONBOARDING_TOPICS: OnboardingTopic[];
-/** Check if user wants to skip the conversation. */
-export declare function userWantsToSkip(text: string): boolean;
-//# sourceMappingURL=onboarding-topics.d.ts.map

package/dist/lib/onboarding-topics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"onboarding-topics.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding-topics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IAEjB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IAErB,mFAAmF;IACnF,YAAY,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;IAE/C,yFAAyF;IACzF,eAAe,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;CACnD;AAED,eAAO,MAAM,iBAAiB,EAAE,eAAe,EA4C9C,CAAC;AAKF,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/lib/onboarding-topics.js

@@ -1,57 +0,0 @@
-/**
- * Onboarding conversation topics — coach pattern for first-time setup.
- * WP-304: Each topic has goal/behaviour/criteria. LLM judges completion,
- * heuristic signals are backup. Topics auto-skip when content is already covered.
- */
-export const ONBOARDING_TOPICS = [
-    {
-        id: 'why_here',
-        goal: 'Understand what brought this person to Product Brain. Follow wherever they go — product, problem, context, or all three.',
-        behaviour: `Open with: "Hey, what brings you to Product Brain?"
-Then follow what's interesting. If they describe a product, get curious about it.
-If they describe a problem, lean in. If they're vague, ask the one thing you'd most want to know.
-Never ask more than one question. Never explain what Product Brain does — they know enough to be here.`,
-        criteria: `The user has said something genuine — anything beyond "I don't know" or "just checking it out."
-A complete sentence about their work, their problem, or their situation meets criteria.
-Criteria is NOT met if the user gave only a non-answer (one word, "not sure", "just exploring").`,
-        maxExchanges: 3,
-        skipIfSignal: null,
-        heuristicSignal: 'hasSubstantiveAnswer',
-    },
-    {
-        id: 'what_they_build',
-        goal: 'Understand concretely what this person is building — specific enough to explain to someone else in one sentence.',
-        behaviour: `Pick one concrete noun or verb from their last answer and go one level deeper.
-Ask about who uses it, what it replaces, or how it works today — whichever fits what they said.
-Never name the category back at them ("so an AI tool?").
-Never ask them to "elaborate" or "tell me more."
-One direct question only.`,
-        criteria: `The user has described what they're building with enough specificity that you could explain it in one sentence to someone who wasn't in this conversation.
-Vague answers ("a tool", "an app", "something with AI") do NOT meet criteria.
-A described function, a named user group, or a concrete workflow DOES.`,
-        maxExchanges: 2,
-        skipIfSignal: 'mentionedProduct',
-        heuristicSignal: 'mentionedProduct',
-    },
-    {
-        id: 'what_is_hard',
-        goal: "Understand what's actually hard or broken right now — the friction that brought them here.",
-        behaviour: `Pick one specific thing they mentioned building and ask what breaks, what slows them down, or what they're not happy with.
-Be concrete and direct: "What breaks when X?" or "Where does the rework happen?"
-Not: "What challenges do you face?" or "What's the hardest part?" (too generic).
-One question only.`,
-        criteria: `The user has described a specific friction, pain, or failure mode in their own words.
-"It's hard" or "there are problems" does NOT meet criteria.
-A named workflow that breaks, a named cost, or a described workaround DOES.`,
-        maxExchanges: 2,
-        skipIfSignal: 'mentionedChallenge',
-        heuristicSignal: 'mentionedChallenge',
-    },
-];
-/** User wants to skip — detected by regex on user input. */
-const SKIP_PATTERNS = [/\b(?:skip|done|that'?s it|wrap up|let'?s go|finish|end)\b/i];
-/** Check if user wants to skip the conversation. */
-export function userWantsToSkip(text) {
-    return SKIP_PATTERNS.some((p) => p.test(text));
-}
-//# sourceMappingURL=onboarding-topics.js.map

package/dist/lib/onboarding-topics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"onboarding-topics.js","sourceRoot":"","sources":["../../src/lib/onboarding-topics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,0HAA0H;QAChI,SAAS,EAAE;;;uGAGwF;QACnG,QAAQ,EAAE;;iGAEmF;QAC7F,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,sBAAsB;KACxC;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,kHAAkH;QACxH,SAAS,EAAE;;;;0BAIW;QACtB,QAAQ,EAAE;;uEAEyD;QACnE,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,kBAAkB;QAChC,eAAe,EAAE,kBAAkB;KACpC;IACD;QACE,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,4FAA4F;QAClG,SAAS,EAAE;;;mBAGI;QACf,QAAQ,EAAE;;4EAE8D;QACxE,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,oBAAoB;QAClC,eAAe,EAAE,oBAAoB;KACtC;CACF,CAAC;AAEF,4DAA4D;AAC5D,MAAM,aAAa,GAAG,CAAC,4DAA4D,CAAC,CAAC;AAErF,oDAAoD;AACpD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/onboarding.d.ts

@@ -1,17 +0,0 @@
-/**
- * Onboarding conversation — coach-pattern LLM conversation for new workspaces.
- * WP-304: Topics with goal/behaviour/criteria. LLM judges completion, heuristic backup.
- *
- * Uses @clack/prompts (WP-303 S1) and the MCP gateway to call the
- * Convex onboardingChat action for conversation and extraction,
- * then chain.createEntry for batch-capture.
- */
-/**
- * Run the onboarding conversation: topic-by-topic coach pattern, extraction, and auto-capture.
- */
-export declare function runOnboardingConversation(workspaceName: string): Promise<void>;
-/**
- * Deterministic fallback when LLM is unavailable.
- */
-export declare function runFallbackOnboarding(workspaceName: string): Promise<void>;
-//# sourceMappingURL=onboarding.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsTpF;AAUD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEhF"}

package/dist/lib/onboarding.js

@@ -1,350 +0,0 @@
-/**
- * Onboarding conversation — coach-pattern LLM conversation for new workspaces.
- * WP-304: Topics with goal/behaviour/criteria. LLM judges completion, heuristic backup.
- *
- * Uses @clack/prompts (WP-303 S1) and the MCP gateway to call the
- * Convex onboardingChat action for conversation and extraction,
- * then chain.createEntry for batch-capture.
- */
-import { kernelCall } from './client.js';
-import { ask, confirm, select } from './prompts.js';
-import { bold, dim, green, icons } from './style.js';
-import { trackEvent } from './telemetry.js';
-import { detectSignals, mergeSignals } from './conversation-signals.js';
-import { evaluateTopic, buildTopicDirective, sanitizeResponse, shouldSkipTopic, isTooSimilar } from './conversation-engine.js';
-import { ONBOARDING_TOPICS, userWantsToSkip } from './onboarding-topics.js';
-import { countWords, validateExtractedEntries, displayEntryExample, showCapturedSummary, batchCaptureEntries, truncate, firstNWords, } from './onboarding-shared.js';
-/** Hard cap on total exchanges across all topics. */
-const MAX_TOTAL_EXCHANGES = 10;
-// ── Main conversation ───────────────────────────────────────────────────────
-/**
- * Run the onboarding conversation: topic-by-topic coach pattern, extraction, and auto-capture.
- */
-export async function runOnboardingConversation(workspaceName) {
-    trackEvent('setup_started', { mode: 'llm' });
-    // Initialize conversation state
-    const state = {
-        messages: [],
-        userMessageCount: 0,
-        totalUserWords: 0,
-        topicExchanges: {},
-        completedTopics: new Set(),
-        currentTopicId: ONBOARDING_TOPICS[0].id,
-        completedQA: [],
-        // Legacy aliases — kept for type compat during transition
-        phaseExchanges: {},
-        completedPhases: new Set(),
-        currentPhaseId: ONBOARDING_TOPICS[0].id,
-        signals: detectSignals([]),
-        refusalStreak: 0,
-    };
-    let totalExchanges = 0;
-    let emptyAttempts = 0;
-    const recentAssistantMessages = [];
-    // Step 1: Get the LLM's opening (topic 1 generates the greeting)
-    const firstTopic = ONBOARDING_TOPICS[0];
-    const openingDirective = buildTopicDirective(firstTopic, 0, ONBOARDING_TOPICS.length, [], workspaceName);
-    let greeting;
-    try {
-        const result = await kernelCall('onboarding.chat', {
-            messages: [],
-            workspaceName,
-            phaseDirective: openingDirective,
-            turnNumber: 1,
-            totalUserWords: 0,
-            refusalStreak: 0,
-        });
-        if (!result?.content) {
-            await runFallbackOnboarding(workspaceName);
-            return;
-        }
-        greeting = sanitizeResponse(result.content);
-    }
-    catch {
-        await runFallbackOnboarding(workspaceName);
-        return;
-    }
-    process.stdout.write(`\n  ${greeting}\n\n`);
-    state.messages.push({ role: 'assistant', content: greeting });
-    recentAssistantMessages.push(greeting);
-    // Step 2: Topic-by-topic conversation loop
-    let currentTopicIndex = 0;
-    while (currentTopicIndex < ONBOARDING_TOPICS.length && totalExchanges < MAX_TOTAL_EXCHANGES) {
-        const topic = ONBOARDING_TOPICS[currentTopicIndex];
-        state.currentTopicId = topic.id;
-        // DEBUG: trace loop state
-        if (process.env.PB_DEBUG) {
-            console.error(`[DEBUG] topic=${topic.id} idx=${currentTopicIndex} exchanges=${totalExchanges} words=${state.totalUserWords} skip=${shouldSkipTopic(topic, state.signals, state.totalUserWords)}`);
-        }
-        // Skip check: if the signal for this topic is already present AND we have enough content
-        if (shouldSkipTopic(topic, state.signals, state.totalUserWords)) {
-            state.completedTopics.add(topic.id);
-            currentTopicIndex++;
-            continue;
-        }
-        // Get user input
-        let userInput;
-        try {
-            userInput = await ask({
-                message: 'You',
-                placeholder: totalExchanges === 0 ? 'Tell me about your product...' : '',
-            });
-        }
-        catch {
-            process.stdout.write(`\n  ${dim('No worries! Run')} ${bold('pb capture')} ${dim('anytime to add knowledge.')}\n\n`);
-            return;
-        }
-        if (!userInput.trim()) {
-            emptyAttempts++;
-            if (emptyAttempts >= 2) {
-                process.stdout.write(`\n  ${dim('No worries — run')} ${bold('pb capture')} ${dim('anytime to teach your AI tools more.')}\n\n`);
-                return;
-            }
-            process.stdout.write(`  ${dim('Just hit Enter again to skip, or type anything to continue.')}\n\n`);
-            continue;
-        }
-        emptyAttempts = 0;
-        // Check if user wants to skip
-        if (userWantsToSkip(userInput) && state.totalUserWords > 10) {
-            break;
-        }
-        // Update state
-        state.messages.push({ role: 'user', content: userInput });
-        state.userMessageCount++;
-        state.totalUserWords += countWords(userInput);
-        state.topicExchanges[topic.id] = (state.topicExchanges[topic.id] ?? 0) + 1;
-        totalExchanges++;
-        // Detect refusals (very short non-answers)
-        const wordCount = countWords(userInput);
-        if (wordCount <= 2) {
-            state.refusalStreak++;
-        }
-        else {
-            state.refusalStreak = 0;
-        }
-        // Update heuristic signals
-        state.signals = detectSignals(state.messages);
-        // Get LLM response with topic directive
-        const topicDirective = buildTopicDirective(topic, currentTopicIndex, ONBOARDING_TOPICS.length, state.completedQA, workspaceName);
-        let topicComplete = false;
-        try {
-            const result = await kernelCall('onboarding.chat', {
-                messages: state.messages,
-                workspaceName,
-                phaseDirective: topicDirective,
-                turnNumber: totalExchanges + 1,
-                totalUserWords: state.totalUserWords,
-                refusalStreak: state.refusalStreak,
-            });
-            if (result?.content) {
-                // Merge LLM-reported signals with heuristic signals
-                if (result.signals) {
-                    state.signals = mergeSignals(state.signals, result.signals);
-                }
-                // Read LLM's topic completion judgment
-                topicComplete = result.topicComplete ?? false;
-                // Post-process response
-                let displayMessage = sanitizeResponse(result.content);
-                // Detect repetition — if too similar, bump refusal streak for next call
-                if (isTooSimilar(displayMessage, recentAssistantMessages)) {
-                    state.refusalStreak++;
-                }
-                process.stdout.write(`\n  ${displayMessage}\n\n`);
-                state.messages.push({ role: 'assistant', content: displayMessage });
-                recentAssistantMessages.push(displayMessage);
-            }
-        }
-        catch (err) {
-            // LLM call failed — try to continue with what we have
-            if (process.env.PB_DEBUG)
-                console.error(`[DEBUG] LLM catch, breaking. Error:`, err);
-            break;
-        }
-        // Evaluate topic completion: LLM judgment + heuristic backup + forced advancement
-        const evalResult = evaluateTopic(topic, state, topicComplete);
-        if (process.env.PB_DEBUG) {
-            console.error(`[DEBUG] eval: complete=${evalResult.complete} forced=${evalResult.forced} skip=${evalResult.skip} topicComplete=${topicComplete} topicExchanges=${state.topicExchanges[topic.id]}`);
-        }
-        if (evalResult.complete) {
-            // Accumulate the last Q&A for context in later topics
-            const lastAssistant = recentAssistantMessages[recentAssistantMessages.length - 1] ?? '';
-            state.completedQA.push({
-                topicId: topic.id,
-                question: lastAssistant,
-                answer: userInput,
-            });
-            state.completedTopics.add(topic.id);
-            currentTopicIndex++;
-        }
-        // else: stay in current topic, loop again
-    }
-    // Hard floor: barely any content — offer manual capture
-    // Threshold: 3 words means basically no real content. Previous threshold of 10
-    // was too aggressive — 3 short answers can be valid (e.g., "a finance app" + "me" = 4 words).
-    if (state.totalUserWords < 3 && state.userMessageCount > 0) {
-        process.stdout.write(`\n  ${dim('No problem — you can add knowledge at your own pace with')} ${bold('pb capture')}\n\n`);
-        trackEvent('setup_completed', { capturedCount: 0, reason: 'insufficient_content' });
-        return;
-    }
-    trackEvent('first_capture_prompted', { mode: 'llm', exchanges: totalExchanges });
-    // Step 3: Extract structured data from conversation
-    if (state.messages.filter((m) => m.role === 'user').length === 0) {
-        process.stdout.write(`\n  ${dim('No worries! Run')} ${bold('pb capture')} ${dim('anytime to add knowledge.')}\n\n`);
-        return;
-    }
-    let entriesToCapture;
-    try {
-        const result = await kernelCall('onboarding.chat', {
-            messages: state.messages,
-            workspaceName,
-            mode: 'extract',
-        });
-        if (!result?.entries?.length) {
-            process.stdout.write(`\n  ${dim("Couldn't organize your answers just yet. Try")} ${bold('pb capture')} ${dim('to add knowledge manually.')}\n\n`);
-            return;
-        }
-        entriesToCapture = validateExtractedEntries(result.entries).slice(0, 5);
-    }
-    catch {
-        process.stdout.write(`\n  ${dim("Couldn't organize your answers just yet. Try")} ${bold('pb capture')} ${dim('to add knowledge manually.')}\n\n`);
-        return;
-    }
-    if (entriesToCapture.length === 0) {
-        process.stdout.write(`\n  ${dim('Nothing to save yet. Try')} ${bold('pb capture')} ${dim('to add knowledge manually.')}\n\n`);
-        return;
-    }
-    // Step 4: Show ONE example with schema, offer to browse more
-    const itemCount = entriesToCapture.length;
-    process.stdout.write(`\n  From this conversation, I'd remember ${bold(String(itemCount))} item${itemCount === 1 ? '' : 's'}.\n`);
-    process.stdout.write(`  Here's an example:\n\n`);
-    displayEntryExample(entriesToCapture[0]);
-    let exampleIndex = 1;
-    let shouldSave = false;
-    // eslint-disable-next-line no-constant-condition
-    while (true) {
-        const hasMoreExamples = exampleIndex < entriesToCapture.length;
-        const options = [
-            { value: 'save', label: 'Save all to my product brain', hint: `${itemCount} item${itemCount === 1 ? '' : 's'}` },
-        ];
-        if (hasMoreExamples) {
-            options.push({ value: 'another', label: 'Show another example' });
-        }
-        options.push({ value: 'skip', label: 'Not right now' });
-        let choice;
-        try {
-            choice = await select({
-                message: '',
-                options,
-            });
-        }
-        catch {
-            process.stdout.write(`\n  ${dim('No problem — run')} ${bold('pb capture')} ${dim('anytime.')}\n\n`);
-            return;
-        }
-        if (choice === 'skip') {
-            process.stdout.write(`\n  ${dim('No problem — run')} ${bold('pb capture')} ${dim('anytime to add more.')}\n\n`);
-            return;
-        }
-        if (choice === 'save') {
-            shouldSave = true;
-            break;
-        }
-        if (choice === 'another') {
-            displayEntryExample(entriesToCapture[exampleIndex]);
-            exampleIndex++;
-        }
-    }
-    if (!shouldSave)
-        return;
-    // Step 5: Batch-capture entries
-    const { capturedCount, errors } = await batchCaptureEntries(entriesToCapture);
-    // Step 6: Report results
-    if (capturedCount > 0) {
-        process.stdout.write(`\n  ${green(icons.pass)} Saved ${capturedCount} item${capturedCount === 1 ? '' : 's'} to your product brain.\n`);
-        trackEvent('capture_completed', { mode: 'llm', count: capturedCount });
-    }
-    if (errors.length > 0) {
-        process.stdout.write(`\n  ${dim(`${errors.length} couldn't be saved.`)}\n`);
-    }
-    // Step 7: Deterministic proof + closing
-    showCapturedSummary(entriesToCapture, capturedCount);
-    process.stdout.write(`  ${dim('Run')} ${bold('pb capture')} ${dim('anytime to teach your AI tools more.')}\n\n`);
-    trackEvent('setup_completed', { capturedCount });
-}
-// ── Deterministic fallback ──────────────────────────────────────────��─────
-const FALLBACK_QUESTIONS = [
-    { message: 'What are you building?', placeholder: 'A tool for...' },
-    { message: 'Who is it for?', placeholder: 'Developers, designers, teams...' },
-    { message: "What's the biggest challenge right now?", placeholder: 'Scaling, onboarding, pricing...' },
-];
-/**
- * Deterministic fallback when LLM is unavailable.
- */
-export async function runFallbackOnboarding(workspaceName) {
-    trackEvent('setup_started', { mode: 'fallback' });
-    process.stdout.write(`\n  ${bold(`Let me learn about ${workspaceName}.`)} ${dim('(Quick — 3 questions)')}\n\n`);
-    const answers = [];
-    for (const q of FALLBACK_QUESTIONS) {
-        try {
-            const answer = await ask({ message: q.message, placeholder: q.placeholder });
-            if (answer.trim())
-                answers.push(answer.trim());
-        }
-        catch {
-            break;
-        }
-    }
-    if (answers.length === 0) {
-        process.stdout.write(`\n  ${dim('No worries! Add knowledge anytime with')} ${bold('pb capture')}\n\n`);
-        return;
-    }
-    trackEvent('first_capture_prompted', { mode: 'fallback' });
-    const entriesToCapture = [];
-    if (answers[0]) {
-        entriesToCapture.push({
-            collection: 'strategy',
-            name: 'Product Vision',
-            description: answers[0],
-            typeLabel: "What you're building",
-        });
-    }
-    if (answers[1]) {
-        entriesToCapture.push({
-            collection: 'audiences',
-            name: firstNWords(answers[1], 6),
-            description: answers[1],
-            typeLabel: "Who it's for",
-        });
-    }
-    if (answers[2]) {
-        entriesToCapture.push({
-            collection: 'tensions',
-            name: truncate(answers[2], 120),
-            description: answers[2],
-            typeLabel: "A challenge you're facing",
-        });
-    }
-    // Show extraction
-    process.stdout.write('\n');
-    for (const entry of entriesToCapture) {
-        displayEntryExample(entry);
-    }
-    let approved;
-    try {
-        approved = await confirm({ message: 'Ready to save these to your product brain?', initialValue: true });
-    }
-    catch {
-        return;
-    }
-    if (!approved)
-        return;
-    const { capturedCount } = await batchCaptureEntries(entriesToCapture);
-    if (capturedCount > 0) {
-        process.stdout.write(`\n  ${green(icons.pass)} Saved ${capturedCount} item${capturedCount === 1 ? '' : 's'} to your product brain.\n`);
-        trackEvent('capture_completed', { mode: 'fallback', count: capturedCount });
-    }
-    showCapturedSummary(entriesToCapture, capturedCount);
-    process.stdout.write(`  ${dim('Run')} ${bold('pb capture')} ${dim('anytime to teach your AI tools more.')}\n\n`);
-    trackEvent('setup_completed', { mode: 'fallback', capturedCount });
-}
-//# sourceMappingURL=onboarding.js.map