@productbrain/cli 0.1.0-beta.9 → 0.1.0-beta.9000

package/dist/lib/onboarding-shared.js

@@ -0,0 +1,208 @@
+/**
+ * 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 the MCP server's former extractionToBatchEntries per DEC-522 (that module,
+ * start-interview.ts, was deleted as dead code — see git history / TEN-2754's PR for the
+ * removal). Copy-and-own: CLI uses 120-char truncate limits (vs MCP's former 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 ──────────────────────────────────────
+// P3b U0b (TASK-427, WP-780, TEN-3855): audiences removed — retired, no repoint.
+// PR #1126 review round 2 (Codex, PRRT_kwDORS4ils6l5QN4): architecture removed too — same
+// retirement (dev-system-collections.json), no repoint.
+const VALID_COLLECTIONS = new Set(['strategy', 'glossary', 'decisions', 'tensions']);
+/** WP-770 why-producers (TASK-360, DEC-1787): the why-required canonicalKeys' collection
+ *  slugs, scoped to onboarding's own four VALID_COLLECTIONS (glossary/tensions are not
+ *  why-required) — a local subset, not an import of convex/lib/whyPolicy's canonicalKey list,
+ *  since onboarding validates by collection slug, not canonicalKey (BR-108 copy-and-own). */
+export const WHY_REQUIRED_ONBOARDING_COLLECTIONS = new Set(['strategy', 'decisions']);
+/**
+ * Shape/dedup/cap an LLM-extracted entry list, split into what to capture and what to skip.
+ * WP-770 why-producers ruling (TASK-360, TEN-3918): onboarding never invents a why — copying
+ * `description` into `why` is filler (what/that), not a reason (why). A why-required kind
+ * (strategy, decisions) the LLM extracted WITHOUT its own `why` is not captured; it is
+ * reported as skipped so the user can add the reason themselves via `pb capture`.
+ */
+function classifyExtractedEntries(entries) {
+    if (!Array.isArray(entries))
+        return { entries: [], skipped: [] };
+    const seen = new Set();
+    const validated = [];
+    const skipped = [];
+    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() : '';
+        const why = typeof e.why === 'string' && e.why.trim() ? e.why.trim() : undefined;
+        // 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) — WP-770 why-producers round 4 (TASK-360,
+        // PRRT_kwDORS4ils6mNX-n): `seen` is marked only once a row is ACCEPTED below, never on a
+        // skip, so a later duplicate that DOES supply a why can still replace an earlier skipped
+        // same-named row instead of being silently deduped away against it.
+        const key = name.toLowerCase();
+        if (seen.has(key))
+            continue;
+        if (WHY_REQUIRED_ONBOARDING_COLLECTIONS.has(collection) && !why) {
+            skipped.push({ name: truncate(name, 120), collection });
+            continue;
+        }
+        seen.add(key);
+        validated.push({
+            collection,
+            name: truncate(name, 120),
+            description,
+            typeLabel: typeLabel || collection, // fallback to collection if LLM omits
+            ...(why ? { why } : {}),
+        });
+    }
+    return { entries: validated.slice(0, 7), skipped };
+}
+/**
+ * Validate and clean LLM-extracted entries. The LLM outputs entry-shaped data directly;
+ * this function validates shape, deduplicates, and caps the result. A why-required entry
+ * with no LLM-supplied `why` is never in this list — see `findSkippedForMissingWhy`.
+ */
+export function validateExtractedEntries(entries) {
+    return classifyExtractedEntries(entries).entries;
+}
+/** The why-required entries `validateExtractedEntries` left out for lack of a `why` — report
+ *  these to the user ("skipped, needs a why: <name>") instead of silently dropping them. */
+export function findSkippedForMissingWhy(entries) {
+    return classifyExtractedEntries(entries).skipped;
+}
+/** @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",
+        });
+    }
+    // P3b U0b (TASK-427, WP-780, TEN-3855): the audiences emission is removed — retired, no
+    // repoint. extracted.audience (the field itself, and mergeExtractions' handling of it) stays
+    // declared: OnboardingExtraction is already @deprecated in full, and no reader is left to
+    // populate it now that this is gone — dead, but harmless, and out of this slice's named scope.
+    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 captured = [];
+    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).
+                // WP-770 why-producers (TASK-360): `why` rides along when the entry genuinely has one (classifyExtractedEntries never invents one).
+                data: { description: entry.description, ...(entry.why ? { why: entry.why } : {}) },
+            });
+            capturedCount++;
+            captured.push(entry);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            errors.push(`${entry.name}: ${msg}`);
+        }
+    }
+    return { capturedCount, captured, 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

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

package/dist/lib/onboarding-shared.test.d.ts

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

package/dist/lib/onboarding-shared.test.d.ts.map

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

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

@@ -0,0 +1,131 @@
+/**
+ * WP-770 why-producers (TASK-360, TEN-3918) ruling: onboarding never invents a why. A
+ * why-required extracted entry (strategy, decisions) with no LLM-supplied `why` is not
+ * captured by validateExtractedEntries — it is reported by findSkippedForMissingWhy instead
+ * of being filled with a copy of `description` (a description is what/that, not why).
+ * Onboarding batch capture is blocked on TEN-3886 (no `pb` in a worktree), so this proves the
+ * payload shape only — not a live capture.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { validateExtractedEntries, findSkippedForMissingWhy, batchCaptureEntries } from './onboarding-shared';
+const kernelCallWithSessionMock = vi.fn();
+vi.mock('./client.js', () => ({
+    kernelCallWithSession: (...args) => kernelCallWithSessionMock(...args),
+}));
+describe('validateExtractedEntries — why-required skip rule', () => {
+    it('captures a why-required entry when the LLM supplied its own `why`', () => {
+        const entries = validateExtractedEntries([
+            { collection: 'decisions', name: 'Adopt X over Y', description: 'We chose X', why: 'X scales better' },
+        ]);
+        expect(entries).toHaveLength(1);
+        expect(entries[0].why).toBe('X scales better');
+    });
+    it('does NOT capture a why-required entry with no `why` — never fabricates one from description', () => {
+        const entries = validateExtractedEntries([
+            { collection: 'strategy', name: 'Product Vision', description: 'Automate bank transactions' },
+        ]);
+        expect(entries).toHaveLength(0);
+    });
+    it('captures a non-why-required entry (tensions) with no `why` — the field stays absent, never filled', () => {
+        const entries = validateExtractedEntries([
+            { collection: 'tensions', name: 'Two teams diverge', description: 'Team A and Team B disagree on X' },
+        ]);
+        expect(entries).toHaveLength(1);
+        expect(entries[0].why).toBeUndefined();
+    });
+});
+describe('findSkippedForMissingWhy', () => {
+    it('reports a why-required entry with no `why` as skipped', () => {
+        const skipped = findSkippedForMissingWhy([
+            { collection: 'strategy', name: 'Product Vision', description: 'Automate bank transactions' },
+        ]);
+        expect(skipped).toEqual([{ name: 'Product Vision', collection: 'strategy' }]);
+    });
+    it('does not report an entry that has a `why`, or a non-why-required entry', () => {
+        const skipped = findSkippedForMissingWhy([
+            { collection: 'decisions', name: 'Adopt X', description: 'We chose X', why: 'X scales better' },
+            { collection: 'tensions', name: 'Two teams diverge', description: 'disagree' },
+        ]);
+        expect(skipped).toEqual([]);
+    });
+    it('does not double-count an entry already dropped for invalid shape (empty name/description)', () => {
+        const skipped = findSkippedForMissingWhy([
+            { collection: 'strategy', name: '', description: 'Automate bank transactions' },
+        ]);
+        expect(skipped).toEqual([]);
+    });
+});
+describe('chat→entries path — exact shape the fixed extraction schema now emits (Codex P1 PRRT_kwDORS4ils6mNFUa)', () => {
+    it('why present (a real string, not null): captured, with why threaded through', () => {
+        const entries = validateExtractedEntries([
+            { collection: 'decisions', name: 'Chose Dropbox over S3', description: 'moves files to Dropbox', typeLabel: 'A decision', why: 'the team already uses it daily' },
+        ]);
+        expect(entries).toHaveLength(1);
+        expect(entries[0].why).toBe('the team already uses it daily');
+        const skipped = findSkippedForMissingWhy([
+            { collection: 'decisions', name: 'Chose Dropbox over S3', description: 'moves files to Dropbox', typeLabel: 'A decision', why: 'the team already uses it daily' },
+        ]);
+        expect(skipped).toEqual([]);
+    });
+    it('why absent as the literal `null` the strict schema always emits: skipped, reported — never treated as a truthy string', () => {
+        const entries = validateExtractedEntries([
+            { collection: 'strategy', name: 'Automated invoice matching', description: 'connects to Revolut and matches by confidence score', typeLabel: 'What you\'re building', why: null },
+        ]);
+        expect(entries).toHaveLength(0);
+        const skipped = findSkippedForMissingWhy([
+            { collection: 'strategy', name: 'Automated invoice matching', description: 'connects to Revolut and matches by confidence score', typeLabel: 'What you\'re building', why: null },
+        ]);
+        expect(skipped).toEqual([{ name: 'Automated invoice matching', collection: 'strategy' }]);
+    });
+    it('why: null on a non-why-required kind (glossary/tensions) is fine — captured, never skipped', () => {
+        const entries = validateExtractedEntries([
+            { collection: 'tensions', name: 'Manual review when confidence is low', description: 'have to manually review in a triage queue', typeLabel: 'A challenge', why: null },
+        ]);
+        expect(entries).toHaveLength(1);
+        expect(entries[0].why).toBeUndefined();
+    });
+});
+describe('batchCaptureEntries — `why` in the create payload', () => {
+    it('includes `why` in the chain.createEntry data payload when the entry has one', async () => {
+        kernelCallWithSessionMock.mockResolvedValueOnce({ entryId: 'DEC-1' });
+        await batchCaptureEntries([
+            { collection: 'decisions', name: 'Adopt X', description: 'We chose X', typeLabel: 'Decision', why: 'X scales better' },
+        ]);
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntry', expect.objectContaining({
+            data: { description: 'We chose X', why: 'X scales better' },
+        }));
+    });
+    it('omits `why` from the data payload when the entry has none', async () => {
+        kernelCallWithSessionMock.mockResolvedValueOnce({ entryId: 'TEN-1' });
+        await batchCaptureEntries([
+            { collection: 'tensions', name: 'Two teams diverge', description: 'disagree', typeLabel: 'Tension' },
+        ]);
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntry', expect.objectContaining({
+            data: { description: 'disagree' },
+        }));
+    });
+});
+describe('classifyExtractedEntries — seen-tracking (WP-770 why-producers round 4, TASK-360, PRRT_kwDORS4ils6mNX-n)', () => {
+    it('a later duplicate name WITH a why replaces an earlier skipped same-named row instead of being deduped against it', () => {
+        const entries = validateExtractedEntries([
+            { collection: 'decisions', name: 'Adopt X over Y', description: 'We chose X' }, // no why: skipped
+            { collection: 'decisions', name: 'Adopt X over Y', description: 'We chose X', why: 'X scales better' }, // same name, now with why
+        ]);
+        expect(entries).toHaveLength(1);
+        expect(entries[0].why).toBe('X scales better');
+        const skipped = findSkippedForMissingWhy([
+            { collection: 'decisions', name: 'Adopt X over Y', description: 'We chose X' },
+            { collection: 'decisions', name: 'Adopt X over Y', description: 'We chose X', why: 'X scales better' },
+        ]);
+        expect(skipped).toEqual([{ name: 'Adopt X over Y', collection: 'decisions' }]);
+    });
+    it('a genuine duplicate (both accepted, same why-having name) still dedupes to one entry', () => {
+        const entries = validateExtractedEntries([
+            { collection: 'decisions', name: 'Adopt X', description: 'We chose X', why: 'X scales better' },
+            { collection: 'decisions', name: 'Adopt X', description: 'Different desc', why: 'A different reason' },
+        ]);
+        expect(entries).toHaveLength(1);
+        expect(entries[0].why).toBe('X scales better'); // first-accepted wins
+    });
+});
+//# sourceMappingURL=onboarding-shared.test.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,57 @@
+/**
+ * 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 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,21 @@
+/**
+ * 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. Neither FALLBACK_QUESTIONS asks for a
+ * reason (only "what" and "what's the challenge"), so a strategy entry here never has one —
+ * WP-770 why-producers ruling (TASK-360, DEC-1792, PRRT_kwDORS4ils6mNX-o): never copy the
+ * answer into `why` as filler; skip the why-required strategy entry and report it instead of
+ * capturing it without a reason (tensions is not why-required, so it always captures).
+ */
+export declare function runFallbackOnboarding(workspaceName: string): Promise<void>;
+//# sourceMappingURL=onboarding.d.ts.map

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

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