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

package/dist/lib/normalizeMaterializedFilename.js

@@ -0,0 +1,56 @@
+/**
+ * normalizeMaterializedFilename — WP-379 S5b
+ *
+ * Produces a lowercase, slug-friendly filename from an asset name.
+ * Used by resolveProjectionCollision to compare on-disk filenames (which may
+ * have been projected with a non-normalized case) against the canonical
+ * lowercase form that handshake now writes.
+ *
+ * Contract:
+ *   - Output is lowercase.
+ *   - Non-alphanumeric, non-dot characters are replaced with hyphens.
+ *   - Leading dots (hidden-file convention) are stripped.
+ *   - Multiple consecutive hyphens are collapsed to a single hyphen.
+ *   - Leading and trailing hyphens are trimmed.
+ *   - Unicode characters that don't map to ASCII letters/digits are dropped.
+ *   - Idempotent: applying the function twice yields the same result.
+ *   - Empty input → empty output.
+ *
+ * Chain: WP-379 S5b.
+ */
+/**
+ * Normalize a materializedFilename to its canonical lowercase slug form.
+ *
+ * @param name  The raw filename (e.g. "Setup-ProductBrain.mdc").
+ * @returns     The normalized filename (e.g. "setup-productbrain.mdc").
+ */
+export function normalizeMaterializedFilename(name) {
+    if (!name)
+        return '';
+    // 1. Strip leading dots (hidden-file prefix, e.g. ".cursor/rules/.hidden.mdc").
+    //    We only strip a single leading dot cluster at the start of the basename,
+    //    not dots that are part of extensions or internal names.
+    const stripped = name.startsWith('.') ? name.replace(/^\.+/, '') : name;
+    if (!stripped)
+        return '';
+    // 2. Lowercase the entire name (covers ASCII + Unicode basic-latin).
+    const lowered = stripped.toLowerCase();
+    // 3. Normalize Unicode: decompose then remove non-ASCII code points that
+    //    didn't map cleanly (e.g. accented chars become their base form via NFD
+    //    decomposition, then the combining diacritics are removed).
+    //    NFKD decomposes ligatures and compatibility forms as well.
+    const ascii = lowered
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '') // strip combining diacritics
+        .replace(/[^\x00-\x7F]/g, ''); // drop remaining non-ASCII
+    // 4. Replace any sequence of non-alphanumeric + non-dot characters with a
+    //    single hyphen.  We preserve dots so that ".mdc" and ".md" extensions
+    //    are maintained in the output.
+    const slugged = ascii.replace(/[^a-z0-9.]+/g, '-');
+    // 5. Collapse consecutive hyphens → single hyphen.
+    const collapsed = slugged.replace(/-{2,}/g, '-');
+    // 6. Trim leading and trailing hyphens.
+    const trimmed = collapsed.replace(/^-+|-+$/g, '');
+    return trimmed;
+}
+//# sourceMappingURL=normalizeMaterializedFilename.js.map

package/dist/lib/normalizeMaterializedFilename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeMaterializedFilename.js","sourceRoot":"","sources":["../../src/lib/normalizeMaterializedFilename.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,gFAAgF;IAChF,8EAA8E;IAC9E,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,qEAAqE;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEvC,yEAAyE;IACzE,4EAA4E;IAC5E,gEAAgE;IAChE,gEAAgE;IAChE,MAAM,KAAK,GAAG,OAAO;SAClB,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,6BAA6B;SACnD,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAG,2BAA2B;IAE9D,0EAA0E;IAC1E,0EAA0E;IAC1E,mCAAmC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAEnD,mDAAmD;IACnD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAEjD,wCAAwC;IACxC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/normalizeMaterializedFilename.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * normalizeMaterializedFilename unit tests — WP-379 S5b.
+ *
+ * Contract assertions:
+ *   - Setup-ProductBrain.mdc → setup-productbrain.mdc
+ *   - Already-normalized input is idempotent
+ *   - Unicode chars that map to ASCII (via NFKD) retain base form; others dropped
+ *   - Leading dot stripped; file is otherwise preserved
+ *   - Empty input returns empty string
+ *   - Extension dots are preserved
+ *   - Non-alphanumeric sequences → single hyphen
+ *
+ * Chain: WP-379 S5b.
+ */
+export {};
+//# sourceMappingURL=normalizeMaterializedFilename.test.d.ts.map

package/dist/lib/normalizeMaterializedFilename.test.d.ts.map

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

package/dist/lib/normalizeMaterializedFilename.test.js

@@ -0,0 +1,90 @@
+/**
+ * normalizeMaterializedFilename unit tests — WP-379 S5b.
+ *
+ * Contract assertions:
+ *   - Setup-ProductBrain.mdc → setup-productbrain.mdc
+ *   - Already-normalized input is idempotent
+ *   - Unicode chars that map to ASCII (via NFKD) retain base form; others dropped
+ *   - Leading dot stripped; file is otherwise preserved
+ *   - Empty input returns empty string
+ *   - Extension dots are preserved
+ *   - Non-alphanumeric sequences → single hyphen
+ *
+ * Chain: WP-379 S5b.
+ */
+import { describe, expect, it } from 'vitest';
+import { normalizeMaterializedFilename } from './normalizeMaterializedFilename.js';
+describe('normalizeMaterializedFilename', () => {
+    // ── Primary contract test (from bet spec) ───────────────────────────────────
+    it('Setup-ProductBrain.mdc → setup-productbrain.mdc', () => {
+        expect(normalizeMaterializedFilename('Setup-ProductBrain.mdc')).toBe('setup-productbrain.mdc');
+    });
+    // ── Idempotency ──────────────────────────────────────────────────────────────
+    it('already-normalized input is idempotent', () => {
+        const normalized = 'setup-productbrain.mdc';
+        expect(normalizeMaterializedFilename(normalized)).toBe(normalized);
+    });
+    it('applying twice produces the same result', () => {
+        const input = 'My Rule File.md';
+        const once = normalizeMaterializedFilename(input);
+        const twice = normalizeMaterializedFilename(once);
+        expect(once).toBe(twice);
+    });
+    // ── Uppercase handling ────────────────────────────────────────────────────────
+    it('lowercases all ASCII letters', () => {
+        expect(normalizeMaterializedFilename('CHAIN-RULES.mdc')).toBe('chain-rules.mdc');
+    });
+    it('mixed case with spaces → lowercase with hyphens', () => {
+        expect(normalizeMaterializedFilename('My Custom Rule.md')).toBe('my-custom-rule.md');
+    });
+    // ── Unicode normalization ─────────────────────────────────────────────────────
+    it('accented chars via NFKD → base ASCII (é → e)', () => {
+        expect(normalizeMaterializedFilename('Régle.md')).toBe('regle.md');
+    });
+    it('non-ASCII chars that cannot normalize → dropped', () => {
+        // Chinese chars don't map to ASCII — they're dropped, hyphens collapsed.
+        const result = normalizeMaterializedFilename('设置规则.md');
+        // No Chinese remains; just the extension part
+        expect(result).toBe('.md');
+    });
+    it('ligature "fi" decomposes to "fi"', () => {
+        // NFKD decomposes fi (fi ligature, U+FB01) to 'f' + 'i'
+        expect(normalizeMaterializedFilename('file.md')).toBe('file.md');
+    });
+    // ── Leading dots ──────────────────────────────────────────────────────────────
+    it('single leading dot is stripped', () => {
+        expect(normalizeMaterializedFilename('.hidden-rule.md')).toBe('hidden-rule.md');
+    });
+    it('multiple leading dots are stripped', () => {
+        expect(normalizeMaterializedFilename('..doubly-hidden.md')).toBe('doubly-hidden.md');
+    });
+    it('dot-only input returns empty string', () => {
+        expect(normalizeMaterializedFilename('.')).toBe('');
+    });
+    it('extension dot mid-name is preserved', () => {
+        // "foo.bar.mdc" → "foo.bar.mdc"
+        expect(normalizeMaterializedFilename('foo.bar.mdc')).toBe('foo.bar.mdc');
+    });
+    // ── Empty input ──────────────────────────────────────────────────────────────
+    it('empty string returns empty string', () => {
+        expect(normalizeMaterializedFilename('')).toBe('');
+    });
+    // ── Special character sequences ───────────────────────────────────────────────
+    it('multiple consecutive spaces → single hyphen', () => {
+        expect(normalizeMaterializedFilename('a   b.md')).toBe('a-b.md');
+    });
+    it('underscores replaced with hyphens', () => {
+        expect(normalizeMaterializedFilename('my_rule_file.mdc')).toBe('my-rule-file.mdc');
+    });
+    it('leading and trailing hyphens are trimmed', () => {
+        expect(normalizeMaterializedFilename('-foo-')).toBe('foo');
+    });
+    it('mixed special chars collapse to single hyphen', () => {
+        expect(normalizeMaterializedFilename('foo!@#bar.mdc')).toBe('foo-bar.mdc');
+    });
+    // ── No extension ────────────────────────────────────────────────────────────
+    it('name without extension is normalized', () => {
+        expect(normalizeMaterializedFilename('MyRule')).toBe('myrule');
+    });
+});
+//# sourceMappingURL=normalizeMaterializedFilename.test.js.map

package/dist/lib/normalizeMaterializedFilename.test.js.map

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

package/dist/lib/onboarding-path-b.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Path B — Facilitator-pattern onboarding (2 exchanges max).
+ * WP-304: Shorter flow, silent extraction, auto-capture, governance proof.
+ */
+import { type OnboardingExtraction } from './onboarding-shared.js';
+export declare function runOnboardingPathB(workspaceName: string): Promise<void>;
+/** Merge two extractions — second takes precedence for scalar fields, arrays concatenate. */
+export declare function mergeExtractions(first: OnboardingExtraction | null, second: OnboardingExtraction): OnboardingExtraction;
+export declare function dedupe(arr: string[]): string[];
+//# sourceMappingURL=onboarding-path-b.d.ts.map

package/dist/lib/onboarding-path-b.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-path-b.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding-path-b.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAIL,KAAK,oBAAoB,EAG1B,MAAM,wBAAwB,CAAC;AAEhC,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyK7E;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAClC,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAUtB;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI9C"}

package/dist/lib/onboarding-path-b.js

@@ -0,0 +1,214 @@
+/**
+ * Path B — Facilitator-pattern onboarding (2 exchanges max).
+ * WP-304: Shorter flow, silent extraction, auto-capture, governance proof.
+ */
+import { kernelCall } from './client.js';
+import { ask } from './prompts.js';
+import { bold, dim, green, icons } from './style.js';
+import { trackEvent } from './telemetry.js';
+import { extractionToEntries, batchCaptureEntries, countWords, } from './onboarding-shared.js';
+export async function runOnboardingPathB(workspaceName) {
+    trackEvent('setup_started', { mode: 'llm', path: 'B' });
+    const messages = [];
+    let totalUserWords = 0;
+    let lastExtraction = null;
+    // Exchange 1: Opening question
+    let greeting;
+    try {
+        const result = await kernelCall('onboarding.chat', {
+            messages: [],
+            workspaceName,
+            style: 'facilitator',
+            turnNumber: 1,
+            totalUserWords: 0,
+        });
+        if (!result?.content) {
+            await runPathBFallback(workspaceName);
+            return;
+        }
+        greeting = result.content;
+    }
+    catch {
+        await runPathBFallback(workspaceName);
+        return;
+    }
+    process.stdout.write(`\n  ${greeting}\n\n`);
+    messages.push({ role: 'assistant', content: greeting });
+    // Get user's first answer
+    let userInput;
+    try {
+        userInput = await ask({
+            message: 'You',
+            placeholder: '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()) {
+        process.stdout.write(`\n  ${dim('No problem — explore with')} ${bold('pb orient -b')} ${dim('or capture with')} ${bold('pb capture')}\n\n`);
+        return;
+    }
+    messages.push({ role: 'user', content: userInput });
+    totalUserWords += countWords(userInput);
+    // Silent extraction after first answer (parallel with follow-up)
+    const [followUpResult, extractResult] = await Promise.allSettled([
+        kernelCall('onboarding.chat', {
+            messages,
+            workspaceName,
+            style: 'facilitator',
+            turnNumber: 2,
+            totalUserWords,
+        }),
+        kernelCall('onboarding.chat', {
+            messages,
+            workspaceName,
+            mode: 'extract',
+        }),
+    ]);
+    // Store first extraction if available
+    if (extractResult.status === 'fulfilled' && extractResult.value?.extraction) {
+        lastExtraction = extractResult.value.extraction;
+    }
+    // Show follow-up question
+    if (followUpResult.status === 'fulfilled' && followUpResult.value?.content) {
+        const followUp = followUpResult.value.content;
+        process.stdout.write(`\n  ${followUp}\n\n`);
+        messages.push({ role: 'assistant', content: followUp });
+        // Get second answer
+        try {
+            const secondInput = await ask({ message: 'You', placeholder: '' });
+            if (secondInput.trim()) {
+                messages.push({ role: 'user', content: secondInput });
+                totalUserWords += countWords(secondInput);
+                // Second extraction — merge with first
+                try {
+                    const result2 = await kernelCall('onboarding.chat', {
+                        messages,
+                        workspaceName,
+                        mode: 'extract',
+                    });
+                    if (result2?.extraction) {
+                        lastExtraction = mergeExtractions(lastExtraction, result2.extraction);
+                    }
+                }
+                catch {
+                    // Use first extraction if second fails
+                }
+            }
+        }
+        catch {
+            // User cancelled — use what we have
+        }
+    }
+    // Content floor — need at least something to extract
+    if (totalUserWords < 5 || !lastExtraction?.vision) {
+        // Try one final extraction if we don't have one
+        if (!lastExtraction?.vision && messages.filter((m) => m.role === 'user').length > 0) {
+            try {
+                const finalExtract = await kernelCall('onboarding.chat', {
+                    messages,
+                    workspaceName,
+                    mode: 'extract',
+                });
+                if (finalExtract?.extraction) {
+                    lastExtraction = finalExtract.extraction;
+                }
+            }
+            catch {
+                // Nothing to do
+            }
+        }
+        if (!lastExtraction?.vision) {
+            process.stdout.write(`\n  ${dim('No problem — add knowledge anytime with')} ${bold('pb capture')}\n\n`);
+            trackEvent('setup_completed', { path: 'B', capturedCount: 0, reason: 'insufficient_content' });
+            return;
+        }
+    }
+    trackEvent('first_capture_prompted', { mode: 'llm', path: 'B' });
+    // Auto-capture — no approval UI in Path B
+    const allEntries = extractionToEntries(lastExtraction);
+    const entriesToCapture = allEntries
+        .filter((e) => e.name.trim().split(/\s+/).length >= 2 || e.collection === 'glossary')
+        .slice(0, 5);
+    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;
+    }
+    const { capturedCount, errors } = 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: 'llm', path: 'B', count: capturedCount });
+    }
+    if (errors.length > 0) {
+        process.stdout.write(`\n  ${dim(`${errors.length} couldn't be saved.`)}\n`);
+    }
+    // Governance proof moment — show how captured knowledge participates in governance
+    await showGovernanceProof(lastExtraction.vision);
+    process.stdout.write(`  ${dim('Explore with')} ${bold('pb orient -b')} ${dim('or add more with')} ${bold('pb capture')}\n\n`);
+    trackEvent('setup_completed', { path: 'B', capturedCount });
+}
+/** Merge two extractions — second takes precedence for scalar fields, arrays concatenate. */
+export function mergeExtractions(first, second) {
+    if (!first)
+        return second;
+    return {
+        vision: second.vision || first.vision,
+        audience: second.audience || first.audience,
+        techStack: dedupe([...(first.techStack ?? []), ...(second.techStack ?? [])]),
+        keyTerms: dedupe([...(first.keyTerms ?? []), ...(second.keyTerms ?? [])]),
+        keyDecisions: dedupe([...(first.keyDecisions ?? []), ...(second.keyDecisions ?? [])]),
+        tensions: dedupe([...(first.tensions ?? []), ...(second.tensions ?? [])]),
+    };
+}
+export function dedupe(arr) {
+    return [...new Set(arr.map((s) => s.toLowerCase()))].map((lower) => arr.find((s) => s.toLowerCase() === lower) ?? lower);
+}
+/** Governance proof — show binding governance from captured knowledge via resolveTaskStartup. */
+async function showGovernanceProof(vision) {
+    try {
+        const result = await kernelCall('chain.resolveTaskStartup', { task: vision });
+        const governance = result?.bindingGovernance;
+        const steering = result?.steeringContext ?? [];
+        const allItems = [
+            ...(governance?.principles ?? []),
+            ...(governance?.standards ?? []),
+            ...(governance?.businessRules ?? []),
+            ...steering.slice(0, 3),
+        ].filter((i) => i.name);
+        if (allItems.length > 0) {
+            process.stdout.write(`\n  ${bold('Your product knowledge is now wired in:')}\n\n`);
+            for (const item of allItems.slice(0, 4)) {
+                process.stdout.write(`    ${dim(icons.dot)} ${item.name}\n`);
+            }
+            if (allItems.length > 4) {
+                process.stdout.write(`    ${dim(`...and ${allItems.length - 4} more`)}\n`);
+            }
+            process.stdout.write('\n');
+        }
+    }
+    catch {
+        // Governance proof is best-effort — fall back to orient-based proof
+        try {
+            const orient = await kernelCall('orient', { brief: true });
+            const items = orient?.sections?.flatMap((s) => s.items ?? []).filter((i) => i.name) ?? [];
+            if (items.length > 0) {
+                process.stdout.write(`\n  ${bold("Here's how your product brain will use this:")}\n\n`);
+                for (const item of items.slice(0, 5)) {
+                    process.stdout.write(`    ${dim(icons.dot)} ${item.name}\n`);
+                }
+                process.stdout.write('\n');
+            }
+        }
+        catch {
+            // Both proofs failed — skip silently
+        }
+    }
+}
+/** Deterministic fallback when LLM is unavailable. Dynamic import avoids circular dependency with onboarding.ts. */
+async function runPathBFallback(workspaceName) {
+    const { runFallbackOnboarding } = await import('./onboarding.js');
+    await runFallbackOnboarding(workspaceName);
+}
+//# sourceMappingURL=onboarding-path-b.js.map

package/dist/lib/onboarding-path-b.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * Onboarding conversation phases — the 5-phase arc for first-time setup.
+ * WP-304: Each phase has a directive (what the LLM should do) and exit criteria (what the CLI checks).
+ */
+import type { ConversationPhase } from './conversation-phases.js';
+export declare const ONBOARDING_PHASES: ConversationPhase[];
+/** Check if user wants to skip the conversation. */
+export declare function userWantsToSkip(text: string): boolean;
+//# sourceMappingURL=onboarding-phases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-phases.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding-phases.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EA4GhD,CAAC;AAKF,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/lib/onboarding-phases.js

@@ -0,0 +1,120 @@
+/**
+ * Onboarding conversation phases — the 5-phase arc for first-time setup.
+ * WP-304: Each phase has a directive (what the LLM should do) and exit criteria (what the CLI checks).
+ */
+export const ONBOARDING_PHASES = [
+    {
+        id: 'greet',
+        directive: `Your job: Say hello and ask what they're building. One sentence. No fluff.
+Example: "Hey! What are you building?"
+Do NOT ask multiple questions. Do NOT explain Product Brain yet.`,
+        exitCriteria: [
+            {
+                name: 'greeting_sent',
+                check: (s) => s.phaseExchanges['greet'] !== undefined && (s.phaseExchanges['greet'] ?? 0) >= 0,
+                required: true,
+            },
+        ],
+        maxExchanges: 1,
+    },
+    {
+        id: 'explore',
+        directive: `Your job: Learn what they're building. Get specific.
+If they gave a vague answer ("something big", "a tool", "an app"), pick one concrete detail and dig in.
+Ask who uses it, what it actually does, or how it works today.
+Good questions: "Who's using it?" / "What does it replace?" / "How does that work today?"
+Bad questions: "What domain are you operating in?" / "Can you elaborate on that?"
+Do NOT ask why they're trying Product Brain yet.
+One question only.`,
+        exitCriteria: [
+            {
+                name: 'user_mentioned_product',
+                check: (s) => s.signals.mentionedProduct,
+                required: true,
+            },
+            {
+                name: 'has_substantive_answer',
+                check: (s) => s.signals.hasSubstantiveAnswer,
+                required: true,
+            },
+        ],
+        maxExchanges: 3,
+    },
+    {
+        id: 'deepen',
+        directive: `Your job: Understand what's hard about what they're building.
+Pick ONE specific thing they mentioned and ask what breaks or why it's hard. Be direct and short.
+Good: "What breaks when the agent doesn't have that context?" / "Where does the rework hit hardest?"
+Bad: "What makes it hard to ensure X?" / "Can you tell me more about the challenges?"
+Do NOT ask why they're trying Product Brain yet.
+One question only.`,
+        exitCriteria: [
+            {
+                name: 'user_mentioned_challenge',
+                check: (s) => s.signals.mentionedChallenge,
+                required: false,
+            },
+            {
+                name: 'min_2_substantive_messages',
+                check: (s) => s.signals.substantiveMessageCount >= 2,
+                required: true,
+            },
+        ],
+        maxExchanges: 2,
+    },
+    {
+        id: 'why_pb',
+        directive: `Your job: Ask what made them try Product Brain. Be direct.
+Examples: "What made you try Product Brain?" or "What problem are you hoping Product Brain solves?"
+Do NOT summarize or synthesize yet.
+One question only.`,
+        exitCriteria: [
+            {
+                name: 'user_answered_why_pb',
+                check: (s) => s.signals.mentionedWhyPB,
+                required: false,
+            },
+            {
+                name: 'min_total_words_25',
+                check: (s) => s.totalUserWords >= 25,
+                required: true,
+            },
+            {
+                name: 'min_3_substantive_messages',
+                check: (s) => s.signals.substantiveMessageCount >= 3,
+                required: true,
+            },
+        ],
+        maxExchanges: 2,
+    },
+    {
+        id: 'bridge',
+        directive: `Your job: Bridge the conversation to Product Brain's value. Speak as Product Brain (first person "I").
+Keep it SHORT — 2-3 sentences max. Do NOT list bullet items. The CLI will handle showing examples.
+
+Structure:
+1. One sentence connecting their problem to what you (PB) do. Use first person.
+2. One sentence showing you understood something specific they said.
+
+Good example: "I can remember all of that across your AI sessions — so next time you open your AI tools, they already know about the decision rot problem and your cashflow automation. No more re-explaining."
+Bad example: "Product Brain can help — it remembers context. Here's what I'd save: * item 1 * item 2 * item 3"
+
+Do NOT list items. Do NOT use bullet points or asterisks. The CLI shows examples separately.
+This is a STATEMENT. Do NOT ask a question. Do NOT end with a question mark.`,
+        exitCriteria: [
+            {
+                name: 'bridge_delivered',
+                check: (s) => (s.phaseExchanges['bridge'] ?? 0) >= 1,
+                required: true,
+            },
+        ],
+        maxExchanges: 1,
+    },
+];
+/** 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-phases.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-phases.js","sourceRoot":"","sources":["../../src/lib/onboarding-phases.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAAwB;IACpD;QACE,EAAE,EAAE,OAAO;QACX,SAAS,EAAE;;iEAEkD;QAC7D,YAAY,EAAE;YACZ;gBACE,IAAI,EAAE,eAAe;gBACrB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;gBAC9F,QAAQ,EAAE,IAAI;aACf;SACF;QACD,YAAY,EAAE,CAAC;KAChB;IACD;QACE,EAAE,EAAE,SAAS;QACb,SAAS,EAAE;;;;;;mBAMI;QACf,YAAY,EAAE;YACZ;gBACE,IAAI,EAAE,wBAAwB;gBAC9B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB;gBACxC,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,IAAI,EAAE,wBAAwB;gBAC9B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB;gBAC5C,QAAQ,EAAE,IAAI;aACf;SACF;QACD,YAAY,EAAE,CAAC;KAChB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE;;;;;mBAKI;QACf,YAAY,EAAE;YACZ;gBACE,IAAI,EAAE,0BAA0B;gBAChC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB;gBAC1C,QAAQ,EAAE,KAAK;aAChB;YACD;gBACE,IAAI,EAAE,4BAA4B;gBAClC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,IAAI,CAAC;gBACpD,QAAQ,EAAE,IAAI;aACf;SACF;QACD,YAAY,EAAE,CAAC;KAChB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE;;;mBAGI;QACf,YAAY,EAAE;YACZ;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc;gBACtC,QAAQ,EAAE,KAAK;aAChB;YACD;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE;gBACpC,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,IAAI,EAAE,4BAA4B;gBAClC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,IAAI,CAAC;gBACpD,QAAQ,EAAE,IAAI;aACf;SACF;QACD,YAAY,EAAE,CAAC;KAChB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE;;;;;;;;;;;6EAW8D;QACzE,YAAY,EAAE;YACZ;gBACE,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;gBACpD,QAAQ,EAAE,IAAI;aACf;SACF;QACD,YAAY,EAAE,CAAC;KAChB;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-shared.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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).
+ */
+/** @deprecated Use CaptureEntry[] directly — LLM now outputs entry-shaped data. */
+export interface OnboardingExtraction {
+    vision: string;
+    audience?: string | null;
+    techStack?: string[] | null;
+    keyTerms?: string[] | null;
+    keyDecisions?: string[] | null;
+    tensions?: string[] | null;
+}
+/** Result from chain.createEntry. */
+export interface CreateEntryResult {
+    entryId: string;
+    collection: string;
+    name: string;
+    status: string;
+}
+/** A single entry to capture. */
+export interface CaptureEntry {
+    collection: string;
+    name: string;
+    description: string;
+    typeLabel: string;
+}
+/** Result from the onboarding.chat action — chat mode. */
+export interface OnboardingChatResult {
+    content: string;
+    /** Coach pattern (Path A): whether the LLM judged the current topic's criteria as met. */
+    topicComplete?: boolean;
+    /** @deprecated Path B facilitator only. */
+    phase?: string;
+    signals?: {
+        describedProduct?: boolean;
+        describedProblem?: boolean;
+        answeredWhyPB?: boolean;
+        quotableFragments?: string[];
+    } | null;
+}
+/** Result from the onboarding.chat action — extract mode. */
+export interface OnboardingExtractResult {
+    entries: CaptureEntry[];
+    /** @deprecated Backward-compat for Path B. Remove when Path B migrates to entries[]. */
+    extraction?: OnboardingExtraction;
+}
+export declare function truncate(str: string, maxLen: number): string;
+export declare function firstNWords(str: string, n: number): string;
+export declare function countWords(text: string): number;
+/**
+ * Validate and clean LLM-extracted entries. The LLM outputs entry-shaped data directly;
+ * this function validates shape, deduplicates, and caps the result.
+ */
+export declare function validateExtractedEntries(entries: unknown[]): CaptureEntry[];
+/** @deprecated Use validateExtractedEntries instead — kept for backward compat during migration. */
+export declare function extractionToEntries(extracted: OnboardingExtraction): CaptureEntry[];
+/**
+ * Display one entry example with schema structure.
+ * Shows typeLabel (from LLM), name, and description in a clean format.
+ */
+export declare function displayEntryExample(entry: CaptureEntry): void;
+/**
+ * Batch-capture entries via MCP chain.createEntry.
+ * Returns count of captured entries and any error messages.
+ */
+export declare function batchCaptureEntries(entries: CaptureEntry[]): Promise<{
+    capturedCount: number;
+    errors: string[];
+}>;
+/**
+ * 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 declare function showCapturedSummary(entries: CaptureEntry[], capturedCount: number): void;
+//# sourceMappingURL=onboarding-shared.d.ts.map