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

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 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

@@ -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

@@ -1,19 +1,17 @@
 /**
- * Onboarding conversation — LLM-powered natural conversation for new workspaces.
- * WP-304 Slice 0: Single-turn proof of concept.
- * WP-304 Slice 1: Multi-turn conversation + extraction + auto-capture.
+ * 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: multi-turn chat, extraction, and auto-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.
- * Asks 3 hardcoded questions and maps answers to the same capture pipeline.
  */
 export declare function runFallbackOnboarding(workspaceName: string): Promise<void>;
 //# sourceMappingURL=onboarding.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgLH;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyLpF;AAmCD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DhF"}
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0BH;;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"}