@productbrain/cli 0.1.0-beta.5 → 0.1.0-beta.5060

package/dist/lib/onboarding.js

@@ -0,0 +1,358 @@
+/**
+ * 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 { FEEDBACK_SUBMIT_HINT } from '../formatters/session.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`);
+    // WP-584 S4 (FEAT-1389 folded in): teach the feedback verb + behaviour-not-content rule at
+    // the natural end-of-onboarding beat — reuses the SAME constant session start already prints,
+    // never a fourth independent copy of this sentence.
+    process.stdout.write(`  ${FEEDBACK_SUBMIT_HINT}\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`);
+    // WP-584 S4 (FEAT-1389 folded in): same teaching beat as the LLM-mode close above — the
+    // fallback path is a real onboarding completion too, not a degraded one that skips it.
+    process.stdout.write(`  ${FEEDBACK_SUBMIT_HINT}\n\n`);
+    trackEvent('setup_completed', { mode: 'fallback', capturedCount });
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/lib/onboarding.js.map

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

package/dist/lib/parseFields.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Parse --field key=value pairs into a data object.
+ * Splits on first `=` only to handle values containing `=`.
+ *
+ * Sweep finding #9: `-f`/`--field` is already REPEATABLE at the Commander layer
+ * (index.ts: `(val, prev) => [...prev, val]`) — that is this CLI's existing, documented
+ * convention for a multi-select/array field (e.g. a role's `capabilities`,
+ * `type: 'multi-select'` server-side). But this function silently let the LAST occurrence of a
+ * repeated key clobber every earlier one (`data[key] = value` unconditionally), so
+ * `-f capabilities=contribute -f capabilities=approve` sent only the string `"approve"` — never
+ * an array, and silently dropping `contribute` besides. The server then rejects a bare string
+ * against an array-typed field ("rejects non-array input"). Fixed by accumulating repeated keys
+ * into an array instead of overwriting — a single-occurrence key (the overwhelming majority of
+ * calls, e.g. the documented `rationale="..."` example) is completely unaffected: no comma
+ * heuristics, no schema round-trip, no behavior change for free text that happens to contain a
+ * comma.
+ */
+export declare function parseFields(fields: string[]): Record<string, unknown>;
+//# sourceMappingURL=parseFields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseFields.d.ts","sourceRoot":"","sources":["../../src/lib/parseFields.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BrE"}

package/dist/lib/parseFields.js

@@ -0,0 +1,49 @@
+import { CLIError, ErrorCode } from './errors.js';
+/**
+ * Parse --field key=value pairs into a data object.
+ * Splits on first `=` only to handle values containing `=`.
+ *
+ * Sweep finding #9: `-f`/`--field` is already REPEATABLE at the Commander layer
+ * (index.ts: `(val, prev) => [...prev, val]`) — that is this CLI's existing, documented
+ * convention for a multi-select/array field (e.g. a role's `capabilities`,
+ * `type: 'multi-select'` server-side). But this function silently let the LAST occurrence of a
+ * repeated key clobber every earlier one (`data[key] = value` unconditionally), so
+ * `-f capabilities=contribute -f capabilities=approve` sent only the string `"approve"` — never
+ * an array, and silently dropping `contribute` besides. The server then rejects a bare string
+ * against an array-typed field ("rejects non-array input"). Fixed by accumulating repeated keys
+ * into an array instead of overwriting — a single-occurrence key (the overwhelming majority of
+ * calls, e.g. the documented `rationale="..."` example) is completely unaffected: no comma
+ * heuristics, no schema round-trip, no behavior change for free text that happens to contain a
+ * comma.
+ */
+export function parseFields(fields) {
+    const data = {};
+    for (const field of fields) {
+        const eqIndex = field.indexOf('=');
+        if (eqIndex === -1) {
+            throw new CLIError(`Invalid --field format: "${field}". Expected key=value.`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Use --field key=value (split on first "=").',
+            });
+        }
+        const key = field.slice(0, eqIndex).trim();
+        const value = field.slice(eqIndex + 1).trim();
+        if (!key) {
+            throw new CLIError(`Invalid --field format: "${field}". Key cannot be empty.`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Provide a non-empty key before the "=" sign.',
+            });
+        }
+        if (Object.prototype.hasOwnProperty.call(data, key)) {
+            const existing = data[key];
+            data[key] = Array.isArray(existing) ? [...existing, value] : [existing, value];
+        }
+        else {
+            data[key] = value;
+        }
+    }
+    return data;
+}
+//# sourceMappingURL=parseFields.js.map

package/dist/lib/parseFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFields.js","sourceRoot":"","sources":["../../src/lib/parseFields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,MAAgB;IAC3C,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC,4BAA4B,KAAK,wBAAwB,EAAE;gBAC7E,IAAI,EAAE,SAAS,CAAC,iBAAiB;gBACjC,QAAQ,EAAE,YAAY;gBACtB,QAAQ,EAAE,6CAA6C;aACvD,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;YACV,MAAM,IAAI,QAAQ,CAAC,4BAA4B,KAAK,yBAAyB,EAAE;gBAC9E,IAAI,EAAE,SAAS,CAAC,iBAAiB;gBACjC,QAAQ,EAAE,YAAY;gBACtB,QAAQ,EAAE,8CAA8C;aACxD,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAkB,EAAE,KAAK,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/lib/previewBanner.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from 'commander';
+/**
+ * Print a loud PREVIEW banner to stderr when pb is bound to a throwaway preview.
+ *
+ * This is intentionally synchronous and never throws: it must not disrupt command
+ * execution, JSON stdout, or the root command lifecycle.
+ */
+export declare function printPreviewBanner(actionCommand: Command): void;
+//# sourceMappingURL=previewBanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"previewBanner.d.ts","sourceRoot":"","sources":["../../src/lib/previewBanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,OAAO,GAAG,IAAI,CAiB/D"}

package/dist/lib/previewBanner.js

@@ -0,0 +1,37 @@
+import { getPreviewBinding } from './config.js';
+import { bold, yellow } from './style.js';
+/** Top-level Chain-write commands that need the throwaway-writes advisory. */
+const PREVIEW_WRITE_COMMANDS = new Set([
+    'capture',
+    'update',
+    'verify',
+    'promote',
+    'relate',
+    'unrelate',
+    'ingest',
+    'accept',
+    'reject',
+]);
+/**
+ * Print a loud PREVIEW banner to stderr when pb is bound to a throwaway preview.
+ *
+ * This is intentionally synchronous and never throws: it must not disrupt command
+ * execution, JSON stdout, or the root command lifecycle.
+ */
+export function printPreviewBanner(actionCommand) {
+    try {
+        const binding = getPreviewBinding();
+        if (!binding)
+            return;
+        const name = binding.workspaceName ?? 'preview';
+        process.stderr.write(yellow(bold(`⚠ PREVIEW ${name} — writes are throwaway. npm run pb:real to return to the real Chain`)) + '\n');
+        const isTopLevel = actionCommand.parent?.name() === 'pb';
+        if (isTopLevel && PREVIEW_WRITE_COMMANDS.has(actionCommand.name())) {
+            process.stderr.write('  → real learnings belong in the real Chain. Switch back with: npm run pb:real\n');
+        }
+    }
+    catch {
+        // Never let the banner crash the CLI.
+    }
+}
+//# sourceMappingURL=previewBanner.js.map

package/dist/lib/previewBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewBanner.js","sourceRoot":"","sources":["../../src/lib/previewBanner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1C,8EAA8E;AAC9E,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAsB;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,IAAI,SAAS,CAAC;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,sEAAsE,CAAC,CAAC,GAAG,IAAI,CAC7G,CAAC;QACF,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;QACzD,IAAI,UAAU,IAAI,sBAAsB,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kFAAkF,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;AACH,CAAC"}

package/dist/lib/productbrain-files.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The .productbrain file-contract brain (WP-471 / WP-3, DEC-1382 / DEC-1383).
+ * Pure classification + gitignore exposure logic; all I/O is injected so the
+ * core is deterministic and testable. Git ignore-status is a cross-check, not
+ * the primary classifier — classification comes from DESCRIPTORS (what pb
+ * writes); only a present-but-undescribed entry falls back to ignore-status.
+ */
+/** What a .productbrain path IS — drives display grouping AND gitignore expectation. */
+export type FileKind = 'pb-secret' | 'pb-owned' | 'committed' | 'local';
+/** gitignore expectation → drives the exposure warning + --fix. */
+export type GitignoreRule = 'must' | 'should' | 'no';
+/** A declared pb write-target. Descriptors NEVER declare 'committed' (that is the residual). */
+export interface FileDescriptor {
+    /** Path relative to .productbrain/ (a dir ends with '/'). */
+    pattern: string;
+    kind: Exclude<FileKind, 'committed'>;
+    /** "what writes this" — human answer. */
+    writer: string;
+    /** "when" — human trigger. */
+    when: string;
+    gitignore: GitignoreRule;
+    /** FUTURE headroom (skill/hook/playbook packages); ships no machinery now. */
+    portable?: boolean;
+}
+export interface ClassifiedFile {
+    path: string;
+    kind: FileKind;
+    writer: string;
+    when: string;
+    present: boolean;
+    gitignored: boolean | null;
+    exposed: boolean;
+}
+/** The pb-owned write-targets. Annotation of what pb writes — NOT the per-repo file list. */
+export declare const DESCRIPTORS: FileDescriptor[];
+export interface ClassifyDeps {
+    /** Entries present directly under .productbrain/ (dirs suffixed with '/'). */
+    presentEntries: string[];
+    /** Is `.productbrain/<entry>` gitignored? null when git is unavailable. */
+    isIgnored: (relUnderRepo: string) => boolean | null;
+}
+/**
+ * Classify the full contract: every descriptor (present or absent) plus any
+ * present-but-undescribed entry. Pure — no fs/git here.
+ */
+export declare function classifyTree(deps: ClassifyDeps): ClassifiedFile[];
+/**
+ * Resolve the .productbrain root. Prefer a git toplevel that carries a .productbrain
+ * (isToplevel=true — the only root safe for --fix writes). Else the config-anchored root
+ * (lib/config.ts:73; isToplevel=false — findProjectRoot can walk ABOVE the git toplevel, so
+ * --fix must refuse). Else null → not a pb project. `git` = git reachable. Never throws.
+ */
+export declare function resolvePbRoot(cwd?: string): {
+    root: string | null;
+    git: boolean;
+    isToplevel: boolean;
+};
+/**
+ * Is `.productbrain/<rel>` tracked in git's index? A TRACKED file is never ignored regardless
+ * of .gitignore, so an exposed pb-secret that is tracked cannot be sealed by --fix (appending a
+ * line) — it needs `git rm --cached`. `git ls-files -- <path>` prints the path when tracked,
+ * nothing when not. Git unavailable → null. Never throws.
+ */
+export declare function makeGitTrackedChecker(root: string): (rel: string) => boolean | null;
+/** Entries directly under <root>/.productbrain; dirs suffixed with '/'. [] if absent. */
+export declare function listProductbrainEntries(root: string): string[];
+/**
+ * Per-path git ignore-status checker. Uses execFileSync (argv array, NO shell) so a
+ * malicious .productbrain filename like `$(...)` is passed to git literally, never evaluated.
+ * `git check-ignore <path>` exits 0 when ignored (composing ALL .gitignore files), exit 1 when
+ * not — a non-zero exit is NOT an error here. Git unavailable (ENOENT / status 128) → null. Never throws.
+ */
+export declare function makeGitIgnoreChecker(root: string): (rel: string) => boolean | null;
+export interface Exposure {
+    path: string;
+    kind: FileKind;
+    severity: 'high' | 'mild';
+}
+/** Present must/should descriptors that are not gitignored → exposures. */
+export declare function detectExposures(rows: ClassifiedFile[]): Exposure[];
+/** .gitignore lines for must/should descriptors not currently ignored (preemptive). */
+export declare function planGitignoreLines(rows: ClassifiedFile[]): string[];
+/** Idempotent append to <root>/.gitignore. dryRun → compute only. A line already present is
+ * skipped, never duplicated. A path that stays exposed despite its line — a negation rule
+ * (root-anchored, or a lower-level .productbrain/.gitignore git gives precedence, overriding it)
+ * — is NOT out-appended here (that only grows the file unboundedly and can't beat a nested file);
+ * the caller re-probes git after the write and reports any such path via stillExposed. */
+export declare function applyGitignoreFix(root: string, lines: string[], opts: {
+    dryRun: boolean;
+}): {
+    added: string[];
+    skipped: string[];
+};
+//# sourceMappingURL=productbrain-files.d.ts.map

package/dist/lib/productbrain-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"productbrain-files.d.ts","sourceRoot":"","sources":["../../src/lib/productbrain-files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,wFAAwF;AACxF,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;AACxE,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;AAErD,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACrC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,6FAA6F;AAC7F,eAAO,MAAM,WAAW,EAAE,cAAc,EAevC,CAAC;AAIF,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,2EAA2E;IAC3E,SAAS,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,EAAE,CAoCjE;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAsB,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAoBrH;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CASnF;AAED,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAmBlF;AAED,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAAE;AAEtF,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,QAAQ,EAAE,CAIlE;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAKnE;AAED;;;;0FAI0F;AAC1F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBlI"}