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

package/dist/lib/conversation-engine.js

@@ -0,0 +1,112 @@
+/**
+ * Conversation engine — topic evaluation, XML directive builder, post-processing.
+ * WP-304: Coach pattern — LLM judges topic completion, heuristic backup.
+ *
+ * The engine evaluates topic completion and builds XML directives.
+ * It does NOT generate content — that's the LLM's job.
+ */
+/**
+ * Minimum user words before topic skipping is allowed.
+ * Below this threshold, the conversation is too thin for quality extraction —
+ * keep asking even if LLM signals say the topic is covered.
+ */
+const MIN_WORDS_FOR_SKIP = 20;
+/**
+ * Check if a topic should be skipped because its signal is already present.
+ * Only skips if we have enough content for quality extraction (>= 20 words).
+ */
+export function shouldSkipTopic(topic, signals, totalUserWords) {
+    if (topic.skipIfSignal === null)
+        return false;
+    if (totalUserWords < MIN_WORDS_FOR_SKIP)
+        return false;
+    return signals[topic.skipIfSignal] === true;
+}
+/**
+ * Evaluate whether the current topic is complete.
+ * Priority: skip > LLM judgment > heuristic backup > forced > continue.
+ */
+export function evaluateTopic(topic, state, llmSaidComplete) {
+    // 1. Skip: signal already present from earlier topics (only if enough content)
+    if (shouldSkipTopic(topic, state.signals, state.totalUserWords)) {
+        return { complete: true, forced: false, skip: true };
+    }
+    const exchanges = state.topicExchanges[topic.id] ?? 0;
+    // 2. LLM says complete (require at least 1 exchange to prevent premature completion)
+    if (llmSaidComplete && exchanges >= 1) {
+        return { complete: true, forced: false, skip: false };
+    }
+    // 3. Heuristic backup: signal detected even if LLM didn't say complete
+    if (topic.heuristicSignal && state.signals[topic.heuristicSignal] === true && exchanges >= 1) {
+        return { complete: true, forced: false, skip: false };
+    }
+    // 4. Forced: max exchanges hit
+    if (exchanges >= topic.maxExchanges) {
+        return { complete: true, forced: true, skip: false };
+    }
+    // 5. Continue
+    return { complete: false, forced: false, skip: false };
+}
+/**
+ * Build the XML topic directive to inject into the system prompt.
+ * Renders <topic> with goal/behaviour/criteria, plus <accumulated_context>
+ * with completed Q&A pairs from earlier topics.
+ */
+export function buildTopicDirective(topic, topicIndex, totalTopics, completedQA, workspaceName) {
+    let xml = `
+<topic id="${topic.id}" index="${topicIndex + 1}" of="${totalTopics}">
+  <goal>${topic.goal}</goal>
+  <behaviour>${topic.behaviour}</behaviour>
+  <criteria>${topic.criteria}</criteria>
+</topic>`;
+    if (completedQA.length > 0) {
+        xml += '\n\n<accumulated_context>';
+        for (const qa of completedQA) {
+            xml += `\n  <topic_qa id="${qa.topicId}">`;
+            xml += `\n    <question>${qa.question}</question>`;
+            xml += `\n    <answer>${qa.answer}</answer>`;
+            xml += '\n  </topic_qa>';
+        }
+        xml += '\n</accumulated_context>';
+    }
+    return xml;
+}
+// ── Post-processing ─────────────────────────────────────────────────────────
+const BANNED_PATTERNS = [
+    /\bsounds like\b/gi,
+    /\bit sounds like\b/gi,
+    /\bsounds\s+(?:ambitious|exciting|fascinating|impressive|intriguing|interesting|amazing|complex|like)\b/gi,
+    /\bintriguing\b/gi,
+    // Anti-paraphrase: strip "When you say X," and "You mentioned X," prefixes
+    /^when you (?:say|mention|talk about)\b[^.?!]{0,60}[,]\s*/i,
+    /^you mentioned\b[^.?!]{0,60}[,]\s*/i,
+];
+/**
+ * Strip banned patterns the LLM produces despite prompt instructions.
+ * Safety net — Gemini Flash at temp 0.3 still produces these ~15% of the time.
+ */
+export function sanitizeResponse(text) {
+    let cleaned = text;
+    for (const pattern of BANNED_PATTERNS) {
+        cleaned = cleaned.replace(pattern, '');
+    }
+    // Clean up double spaces and leading punctuation from removals
+    return cleaned.replace(/\s{2,}/g, ' ').replace(/^\s*[.,]\s*/, '').trim();
+}
+/**
+ * Detect if a response is too similar to recent ones (refusal loop).
+ * Uses Jaccard similarity on word sets.
+ */
+export function isTooSimilar(newMsg, recentMsgs, threshold = 0.6) {
+    const newWords = new Set(newMsg.toLowerCase().split(/\s+/));
+    for (const prev of recentMsgs.slice(-2)) {
+        const prevWords = new Set(prev.toLowerCase().split(/\s+/));
+        const intersection = new Set([...newWords].filter((w) => prevWords.has(w)));
+        const union = new Set([...newWords, ...prevWords]);
+        if (union.size > 0 && intersection.size / union.size > threshold) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=conversation-engine.js.map

package/dist/lib/conversation-engine.js.map

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

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

@@ -0,0 +1,59 @@
+/**
+ * Conversation types — state and signal types for coach-pattern conversations.
+ * WP-304: LLM owns content, CLI owns flow.
+ *
+ * Pattern: Deterministic Shell, Stochastic Core.
+ * - CLI defines topics with goal/behaviour/criteria (deterministic)
+ * - LLM generates conversation content and judges criteria (stochastic)
+ * - CLI evaluates with heuristic backup and decides when to advance
+ */
+/** A completed topic's question-answer pair, accumulated as context for later topics. */
+export interface TopicQA {
+    topicId: string;
+    question: string;
+    answer: string;
+}
+/** Conversation state — the CLI's accumulated view of the conversation. */
+export interface ConversationState {
+    /** All messages so far. */
+    messages: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    /** Number of user messages total. */
+    userMessageCount: number;
+    /** Total user words total. */
+    totalUserWords: number;
+    /** Exchange count per topic (coach pattern) or phase (legacy). */
+    topicExchanges: Record<string, number>;
+    /** @deprecated Alias for topicExchanges — used by legacy phase engine until Slice 3. */
+    phaseExchanges: Record<string, number>;
+    /** Which topics have been completed. */
+    completedTopics: Set<string>;
+    /** @deprecated Alias for completedTopics — used by legacy phase engine until Slice 3. */
+    completedPhases: Set<string>;
+    /** Current topic ID. */
+    currentTopicId: string;
+    /** @deprecated Alias for currentTopicId — used by legacy phase engine until Slice 3. */
+    currentPhaseId: string;
+    /** Completed topic Q&A pairs — accumulated context for later topics. */
+    completedQA: TopicQA[];
+    /** Heuristic signals detected from user messages. */
+    signals: ConversationSignals;
+    /** Count of consecutive refusals/non-answers. */
+    refusalStreak: number;
+}
+/** Signals detected from user messages — heuristic + LLM-reported. */
+export interface ConversationSignals {
+    /** User described what they're building. */
+    mentionedProduct: boolean;
+    /** User described a problem, pain point, or challenge. */
+    mentionedChallenge: boolean;
+    /** User mentioned why they're trying Product Brain. */
+    mentionedWhyPB: boolean;
+    /** User gave at least one substantive answer (>= 15 words). */
+    hasSubstantiveAnswer: boolean;
+    /** Number of user messages with >= 8 words. */
+    substantiveMessageCount: number;
+}
+//# sourceMappingURL=conversation-phases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-phases.d.ts","sourceRoot":"","sources":["../../src/lib/conversation-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEjE,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IAEvB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,wCAAwC;IACxC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,yFAAyF;IACzF,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE7B,wBAAwB;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;IAEvB,wEAAwE;IACxE,WAAW,EAAE,OAAO,EAAE,CAAC;IAEvB,qDAAqD;IACrD,OAAO,EAAE,mBAAmB,CAAC;IAE7B,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAE1B,0DAA0D;IAC1D,kBAAkB,EAAE,OAAO,CAAC;IAE5B,uDAAuD;IACvD,cAAc,EAAE,OAAO,CAAC;IAExB,+DAA+D;IAC/D,oBAAoB,EAAE,OAAO,CAAC;IAE9B,+CAA+C;IAC/C,uBAAuB,EAAE,MAAM,CAAC;CACjC"}

package/dist/lib/conversation-phases.js

@@ -0,0 +1,11 @@
+/**
+ * Conversation types — state and signal types for coach-pattern conversations.
+ * WP-304: LLM owns content, CLI owns flow.
+ *
+ * Pattern: Deterministic Shell, Stochastic Core.
+ * - CLI defines topics with goal/behaviour/criteria (deterministic)
+ * - LLM generates conversation content and judges criteria (stochastic)
+ * - CLI evaluates with heuristic backup and decides when to advance
+ */
+export {};
+//# sourceMappingURL=conversation-phases.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-phases.js","sourceRoot":"","sources":["../../src/lib/conversation-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/lib/conversation-signals.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Conversation signal detection — heuristic pattern matching on user text.
+ * WP-304: CLI-side signal detection as backup/validation for LLM-reported signals.
+ *
+ * These are intentionally loose. False positives advance the conversation
+ * (fine — user gave a relevant answer). False negatives mean one more turn
+ * in the phase (also fine — maxExchanges caps prevent loops).
+ */
+import type { ConversationSignals } from './conversation-phases.js';
+/**
+ * Detect signals from user messages using regex heuristics.
+ * Returns accumulated signals across all user messages.
+ *
+ * Thresholds are intentionally strict — we'd rather ask one more question
+ * than advance on a vague answer. maxExchanges is the safety valve.
+ */
+export declare function detectSignals(messages: Array<{
+    role: string;
+    content: string;
+}>): ConversationSignals;
+/**
+ * Merge LLM-reported signals into heuristic signals.
+ * LLM signals are additive — once true, always true.
+ */
+export declare function mergeSignals(heuristic: ConversationSignals, llmSignals: {
+    describedProduct?: boolean;
+    describedProblem?: boolean;
+    answeredWhyPB?: boolean;
+}): ConversationSignals;
+//# sourceMappingURL=conversation-signals.d.ts.map

package/dist/lib/conversation-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-signals.d.ts","sourceRoot":"","sources":["../../src/lib/conversation-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AA4BpE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,mBAAmB,CAgBrG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9F,mBAAmB,CAOrB"}

package/dist/lib/conversation-signals.js

@@ -0,0 +1,64 @@
+/**
+ * Conversation signal detection — heuristic pattern matching on user text.
+ * WP-304: CLI-side signal detection as backup/validation for LLM-reported signals.
+ *
+ * These are intentionally loose. False positives advance the conversation
+ * (fine — user gave a relevant answer). False negatives mean one more turn
+ * in the phase (also fine — maxExchanges caps prevent loops).
+ */
+const PRODUCT_PATTERNS = [
+    /\b(?:building|making|creating|working on|developing)\b/i,
+    /\b(?:app|platform|tool|product|service|saas|api|system|software)\b/i,
+];
+const CHALLENGE_PATTERNS = [
+    /\b(?:hard|hardest|difficult|challeng|struggling?|pain|problem|frustrat|broken|mess)\b/i,
+    /\b(?:don'?t know|can'?t figure|losing track|forget|lost context|outdated|rot)\b/i,
+    /\b(?:hate|annoying|waste|slow|manual|tedious)\b/i,
+];
+const WHY_PB_PATTERNS = [
+    /\b(?:product brain|brain)\b/i,
+    /\b(?:context|memory|decisions?|knowledge|source of truth|ssot)\b/i,
+    /\b(?:ai|llm|claude|cursor|copilot|agent)\b.*\b(?:context|remember|forget|know)\b/i,
+    /\b(?:remember|forget|consistent|prompt)\b.*\b(?:ai|llm|agent|tool)\b/i,
+    // Broader: user describes the problem PB solves without naming PB
+    /\b(?:re-?explain|repeat myself|start from (?:zero|scratch)|re-?tell)\b/i,
+    /\b(?:docs?|documentation|md files?)\b.*\b(?:outdated|stale|rot|drift|wrong|maintain)\b/i,
+    /\b(?:cost|waste|spend)\b.*\b(?:tokens?|context|time)\b.*\b(?:re-?explain|repeat|maintain)\b/i,
+];
+function countWords(text) {
+    return text.trim().split(/\s+/).filter(Boolean).length;
+}
+/**
+ * Detect signals from user messages using regex heuristics.
+ * Returns accumulated signals across all user messages.
+ *
+ * Thresholds are intentionally strict — we'd rather ask one more question
+ * than advance on a vague answer. maxExchanges is the safety valve.
+ */
+export function detectSignals(messages) {
+    const userMessages = messages.filter((m) => m.role === 'user');
+    return {
+        // Product mention requires BOTH a pattern match AND enough words to be meaningful.
+        // "a cool app" matches the pattern but isn't substantive — need at least 10 words.
+        mentionedProduct: userMessages.some((m) => PRODUCT_PATTERNS.some((p) => p.test(m.content)) && countWords(m.content) >= 10),
+        mentionedChallenge: userMessages.some((m) => CHALLENGE_PATTERNS.some((p) => p.test(m.content))),
+        mentionedWhyPB: userMessages.some((m) => WHY_PB_PATTERNS.some((p) => p.test(m.content))),
+        // Substantive = enough detail to extract something meaningful from
+        hasSubstantiveAnswer: userMessages.some((m) => countWords(m.content) >= 15),
+        // Count messages with real content (not just "me" or "yes")
+        substantiveMessageCount: userMessages.filter((m) => countWords(m.content) >= 8).length,
+    };
+}
+/**
+ * Merge LLM-reported signals into heuristic signals.
+ * LLM signals are additive — once true, always true.
+ */
+export function mergeSignals(heuristic, llmSignals) {
+    return {
+        ...heuristic,
+        mentionedProduct: heuristic.mentionedProduct || (llmSignals.describedProduct ?? false),
+        mentionedChallenge: heuristic.mentionedChallenge || (llmSignals.describedProblem ?? false),
+        mentionedWhyPB: heuristic.mentionedWhyPB || (llmSignals.answeredWhyPB ?? false),
+    };
+}
+//# sourceMappingURL=conversation-signals.js.map

package/dist/lib/conversation-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-signals.js","sourceRoot":"","sources":["../../src/lib/conversation-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,gBAAgB,GAAG;IACvB,yDAAyD;IACzD,qEAAqE;CACtE,CAAC;AAEF,MAAM,kBAAkB,GAAG;IACzB,wFAAwF;IACxF,kFAAkF;IAClF,kDAAkD;CACnD,CAAC;AAEF,MAAM,eAAe,GAAG;IACtB,8BAA8B;IAC9B,mEAAmE;IACnE,mFAAmF;IACnF,uEAAuE;IACvE,kEAAkE;IAClE,yEAAyE;IACzE,yFAAyF;IACzF,8FAA8F;CAC/F,CAAC;AAEF,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkD;IAC9E,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAE/D,OAAO;QACL,mFAAmF;QACnF,mFAAmF;QACnF,gBAAgB,EAAE,YAAY,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CACtF;QACD,kBAAkB,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/F,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACxF,mEAAmE;QACnE,oBAAoB,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3E,4DAA4D;QAC5D,uBAAuB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;KACvF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,SAA8B,EAC9B,UAA+F;IAE/F,OAAO;QACL,GAAG,SAAS;QACZ,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,gBAAgB,IAAI,KAAK,CAAC;QACtF,kBAAkB,EAAE,SAAS,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,gBAAgB,IAAI,KAAK,CAAC;QAC1F,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,CAAC,UAAU,CAAC,aAAa,IAAI,KAAK,CAAC;KAChF,CAAC;AACJ,CAAC"}

package/dist/lib/deployment.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Convex / gateway deployment classification for CLI banners and admin seed gates.
+ *
+ * Convex uses "Development (Cloud)" vs "Production" for deployments; the CLI must not
+ * treat every non-localhost URL as "production" (WP-312 follow-up).
+ *
+ * Extend PRODUCTION_HOSTS / DEV_CLOUD_HOSTS when new team deployments are provisioned.
+ */
+/** Loopback — local Convex dev UI / tunnel only. */
+export type DeploymentTier = 'local' | 'prod' | 'dev-cloud' | 'cloud';
+export declare function parseHostname(siteUrl: string): string;
+export declare function classifyDeployment(siteUrl: string): DeploymentTier;
+/**
+ * Whether admin seed destructive paths should show confirmation + `--confirm` in CI.
+ * False for loopback and known dev-cloud Convex deployments only.
+ */
+export declare function requiresAdminDestructiveConfirmation(siteUrl: string): boolean;
+/** Title for clack `note()` before confirm (prod vs unknown remote). */
+export declare function confirmRiskNoteTitle(siteUrl: string): string;
+export declare function seedRunConfirmMessage(siteUrl: string, manifestName: string): string;
+export declare function seedAllConfirmMessage(siteUrl: string): string;
+export declare function seedMultiselectConfirmMessage(siteUrl: string, count: number): string;
+//# sourceMappingURL=deployment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/lib/deployment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;AAwBtE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAMlE;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7E;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAInF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpF"}

package/dist/lib/deployment.js

@@ -0,0 +1,78 @@
+/**
+ * Convex / gateway deployment classification for CLI banners and admin seed gates.
+ *
+ * Convex uses "Development (Cloud)" vs "Production" for deployments; the CLI must not
+ * treat every non-localhost URL as "production" (WP-312 follow-up).
+ *
+ * Extend PRODUCTION_HOSTS / DEV_CLOUD_HOSTS when new team deployments are provisioned.
+ */
+const LOCAL_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]']);
+/**
+ * Customer / team production hosts (gateway, prod Convex deployment, public API).
+ * Destructive admin seeds use production-style confirmation + red [PROD] banner.
+ */
+const PRODUCTION_HOSTS = new Set([
+    'gateway.productbrain.io',
+    'data.productbrain.io',
+    'api.productbrain.io',
+    /** Convex Production deployment (dashboard label). */
+    'terrific-penguin-60.convex.site',
+]);
+/**
+ * Convex **Development (Cloud)** deployments — real cloud DB, not customer prod.
+ * No prod-style gate; banner shows [DEV·CLOUD].
+ */
+const DEV_CLOUD_HOSTS = new Set([
+    'trustworthy-kangaroo-277.convex.site',
+]);
+export function parseHostname(siteUrl) {
+    try {
+        return new URL(siteUrl).hostname;
+    }
+    catch {
+        return siteUrl;
+    }
+}
+export function classifyDeployment(siteUrl) {
+    const host = parseHostname(siteUrl);
+    if (LOCAL_HOSTS.has(host))
+        return 'local';
+    if (PRODUCTION_HOSTS.has(host))
+        return 'prod';
+    if (DEV_CLOUD_HOSTS.has(host))
+        return 'dev-cloud';
+    return 'cloud';
+}
+/**
+ * Whether admin seed destructive paths should show confirmation + `--confirm` in CI.
+ * False for loopback and known dev-cloud Convex deployments only.
+ */
+export function requiresAdminDestructiveConfirmation(siteUrl) {
+    const t = classifyDeployment(siteUrl);
+    return t !== 'local' && t !== 'dev-cloud';
+}
+/** Title for clack `note()` before confirm (prod vs unknown remote). */
+export function confirmRiskNoteTitle(siteUrl) {
+    const t = classifyDeployment(siteUrl);
+    if (t === 'prod')
+        return '⚠  Production';
+    if (t === 'cloud')
+        return '⚠  Remote deployment';
+    return '⚠  Confirm';
+}
+export function seedRunConfirmMessage(siteUrl, manifestName) {
+    return classifyDeployment(siteUrl) === 'prod'
+        ? `Run ${manifestName} on production?`
+        : `Run ${manifestName} on this remote deployment?`;
+}
+export function seedAllConfirmMessage(siteUrl) {
+    return classifyDeployment(siteUrl) === 'prod'
+        ? 'Run ALL seed operations on production?'
+        : 'Run ALL seed operations on this remote deployment?';
+}
+export function seedMultiselectConfirmMessage(siteUrl, count) {
+    return classifyDeployment(siteUrl) === 'prod'
+        ? `Run ${count} operation(s) on PRODUCTION?`
+        : `Run ${count} operation(s) on this remote deployment?`;
+}
+//# sourceMappingURL=deployment.js.map

package/dist/lib/deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../src/lib/deployment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS;IACvC,yBAAyB;IACzB,sBAAsB;IACtB,qBAAqB;IACrB,sDAAsD;IACtD,iCAAiC;CAClC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS;IACtC,sCAAsC;CACvC,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC;IAClD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAAC,OAAe;IAClE,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,WAAW,CAAC;AAC5C,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,eAAe,CAAC;IACzC,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,sBAAsB,CAAC;IACjD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,YAAoB;IACzE,OAAO,kBAAkB,CAAC,OAAO,CAAC,KAAK,MAAM;QAC3C,CAAC,CAAC,OAAO,YAAY,iBAAiB;QACtC,CAAC,CAAC,OAAO,YAAY,6BAA6B,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,kBAAkB,CAAC,OAAO,CAAC,KAAK,MAAM;QAC3C,CAAC,CAAC,wCAAwC;QAC1C,CAAC,CAAC,oDAAoD,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAe,EAAE,KAAa;IAC1E,OAAO,kBAAkB,CAAC,OAAO,CAAC,KAAK,MAAM;QAC3C,CAAC,CAAC,OAAO,KAAK,8BAA8B;QAC5C,CAAC,CAAC,OAAO,KAAK,0CAA0C,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Deployment classification — banners and admin seed gates.
+ */
+export {};
+//# sourceMappingURL=deployment.test.d.ts.map

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

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

package/dist/lib/deployment.test.js

@@ -0,0 +1,54 @@
+/**
+ * Deployment classification — banners and admin seed gates.
+ */
+import { describe, it, expect } from 'vitest';
+import { classifyDeployment, confirmRiskNoteTitle, parseHostname, requiresAdminDestructiveConfirmation, seedAllConfirmMessage, seedRunConfirmMessage, } from './deployment.js';
+describe('parseHostname', () => {
+    it('parses hostname from https URL', () => {
+        expect(parseHostname('https://trustworthy-kangaroo-277.convex.site')).toBe('trustworthy-kangaroo-277.convex.site');
+    });
+});
+describe('classifyDeployment', () => {
+    it('classifies loopback as local', () => {
+        expect(classifyDeployment('http://localhost:5176')).toBe('local');
+        expect(classifyDeployment('http://127.0.0.1:3000')).toBe('local');
+        expect(classifyDeployment('http://[::1]:3000')).toBe('local');
+    });
+    it('classifies known dev-cloud Convex deployment', () => {
+        expect(classifyDeployment('https://trustworthy-kangaroo-277.convex.site')).toBe('dev-cloud');
+    });
+    it('classifies gateway and prod Convex as prod', () => {
+        expect(classifyDeployment('https://gateway.productbrain.io')).toBe('prod');
+        expect(classifyDeployment('https://terrific-penguin-60.convex.site')).toBe('prod');
+        expect(classifyDeployment('https://api.productbrain.io')).toBe('prod');
+    });
+    it('classifies unknown remote as cloud', () => {
+        expect(classifyDeployment('https://other-team-xyz.convex.site')).toBe('cloud');
+    });
+});
+describe('requiresAdminDestructiveConfirmation', () => {
+    it('is false for local and dev-cloud only', () => {
+        expect(requiresAdminDestructiveConfirmation('http://localhost:3000')).toBe(false);
+        expect(requiresAdminDestructiveConfirmation('https://trustworthy-kangaroo-277.convex.site')).toBe(false);
+        expect(requiresAdminDestructiveConfirmation('https://gateway.productbrain.io')).toBe(true);
+        expect(requiresAdminDestructiveConfirmation('https://unknown.convex.site')).toBe(true);
+    });
+});
+describe('confirmRiskNoteTitle', () => {
+    it('matches tier', () => {
+        expect(confirmRiskNoteTitle('https://gateway.productbrain.io')).toContain('Production');
+        expect(confirmRiskNoteTitle('https://other.convex.site')).toContain('Remote');
+    });
+});
+describe('seed confirm copy', () => {
+    it('uses production wording only for prod tier', () => {
+        expect(seedRunConfirmMessage('https://gateway.productbrain.io', 'seed:knowledge')).toContain('production');
+        expect(seedRunConfirmMessage('https://trustworthy-kangaroo-277.convex.site', 'seed:knowledge')).toContain('remote deployment');
+        expect(seedRunConfirmMessage('https://unknown.convex.site', 'seed:knowledge')).toContain('remote deployment');
+    });
+    it('seed all message follows tier', () => {
+        expect(seedAllConfirmMessage('https://gateway.productbrain.io')).toContain('production');
+        expect(seedAllConfirmMessage('https://unknown.convex.site')).toContain('remote deployment');
+    });
+});
+//# sourceMappingURL=deployment.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.test.js","sourceRoot":"","sources":["../../src/lib/deployment.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,oCAAoC,EACpC,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,aAAa,CAAC,8CAA8C,CAAC,CAAC,CAAC,IAAI,CACxE,sCAAsC,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,kBAAkB,CAAC,8CAA8C,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,kBAAkB,CAAC,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3E,MAAM,CAAC,kBAAkB,CAAC,yCAAyC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnF,MAAM,CAAC,kBAAkB,CAAC,6BAA6B,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,kBAAkB,CAAC,oCAAoC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,oCAAoC,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClF,MAAM,CAAC,oCAAoC,CAAC,8CAA8C,CAAC,CAAC,CAAC,IAAI,CAC/F,KAAK,CACN,CAAC;QACF,MAAM,CAAC,oCAAoC,CAAC,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3F,MAAM,CAAC,oCAAoC,CAAC,6BAA6B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;QACtB,MAAM,CAAC,oBAAoB,CAAC,iCAAiC,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACxF,MAAM,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,qBAAqB,CAAC,iCAAiC,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAC1F,YAAY,CACb,CAAC;QACF,MAAM,CAAC,qBAAqB,CAAC,8CAA8C,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CACvG,mBAAmB,CACpB,CAAC;QACF,MAAM,CAAC,qBAAqB,CAAC,6BAA6B,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CACtF,mBAAmB,CACpB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,qBAAqB,CAAC,iCAAiC,CAAC,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACzF,MAAM,CAAC,qBAAqB,CAAC,6BAA6B,CAAC,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CLIError — structured error taxonomy for the Product Brain CLI.
+ *
+ * WP-302 Slice 0: Error Taxonomy + Commander Migration.
+ * WP-302 Slice 2: Profile error codes added.
+ * Every CLI error carries a machine-readable code, category, and actionable guidance.
+ * The global error handler in index.ts formats these for JSON or human output.
+ */
+/** Error categories — groups of related failure modes. */
+export type ErrorCategory = 'auth' | 'network' | 'config' | 'validation' | 'session' | 'profile' | 'internal';
+/** Known error codes — extend as new failure modes are discovered. */
+export declare const ErrorCode: {
+    readonly AUTH_MISSING: "AUTH_MISSING";
+    readonly AUTH_INVALID: "AUTH_INVALID";
+    readonly AUTH_DENIED: "AUTH_DENIED";
+    readonly NETWORK_UNREACHABLE: "NETWORK_UNREACHABLE";
+    readonly NETWORK_TIMEOUT: "NETWORK_TIMEOUT";
+    readonly CONFIG_MISSING: "CONFIG_MISSING";
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly SESSION_REQUIRED: "SESSION_REQUIRED";
+    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+    readonly PROFILE_NOT_FOUND: "PROFILE_NOT_FOUND";
+    readonly PROFILE_ALREADY_EXISTS: "PROFILE_ALREADY_EXISTS";
+    readonly PROFILE_IS_ACTIVE: "PROFILE_IS_ACTIVE";
+    readonly PROFILE_IS_LAST: "PROFILE_IS_LAST";
+    readonly PROFILE_NAME_INVALID: "PROFILE_NAME_INVALID";
+    readonly NON_INTERACTIVE: "NON_INTERACTIVE";
+    readonly INTERNAL: "INTERNAL";
+};
+export type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Structured CLI error with machine-readable fields.
+ *
+ * Usage:
+ *   throw new CLIError('No API key configured', {
+ *     code: ErrorCode.AUTH_MISSING,
+ *     category: 'auth',
+ *     guidance: 'Run `pb login` to configure your API key.',
+ *   });
+ */
+export declare class CLIError extends Error {
+    readonly code: ErrorCodeValue;
+    readonly category: ErrorCategory;
+    readonly guidance?: string;
+    constructor(message: string, options?: {
+        code?: ErrorCodeValue;
+        category?: ErrorCategory;
+        guidance?: string;
+    });
+    /** Serialize for JSON error output. */
+    toJSON(): {
+        error: string;
+        code: string;
+        category: string;
+        guidance?: string;
+    };
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9G,sEAAsE;AACtE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;CAyBZ,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAExE;;;;;;;;;GASG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,cAAc,CAAC;QACtB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IASH,uCAAuC;IACvC,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAQ/E"}

package/dist/lib/errors.js

@@ -0,0 +1,67 @@
+/**
+ * CLIError — structured error taxonomy for the Product Brain CLI.
+ *
+ * WP-302 Slice 0: Error Taxonomy + Commander Migration.
+ * WP-302 Slice 2: Profile error codes added.
+ * Every CLI error carries a machine-readable code, category, and actionable guidance.
+ * The global error handler in index.ts formats these for JSON or human output.
+ */
+/** Known error codes — extend as new failure modes are discovered. */
+export const ErrorCode = {
+    // Auth
+    AUTH_MISSING: 'AUTH_MISSING',
+    AUTH_INVALID: 'AUTH_INVALID',
+    AUTH_DENIED: 'AUTH_DENIED',
+    // Network
+    NETWORK_UNREACHABLE: 'NETWORK_UNREACHABLE',
+    NETWORK_TIMEOUT: 'NETWORK_TIMEOUT',
+    // Config
+    CONFIG_MISSING: 'CONFIG_MISSING',
+    CONFIG_INVALID: 'CONFIG_INVALID',
+    // Session
+    SESSION_REQUIRED: 'SESSION_REQUIRED',
+    // Validation
+    VALIDATION_FAILED: 'VALIDATION_FAILED',
+    // Profile (WP-302 S2)
+    PROFILE_NOT_FOUND: 'PROFILE_NOT_FOUND',
+    PROFILE_ALREADY_EXISTS: 'PROFILE_ALREADY_EXISTS',
+    PROFILE_IS_ACTIVE: 'PROFILE_IS_ACTIVE',
+    PROFILE_IS_LAST: 'PROFILE_IS_LAST',
+    PROFILE_NAME_INVALID: 'PROFILE_NAME_INVALID',
+    // Interactive
+    NON_INTERACTIVE: 'NON_INTERACTIVE',
+    // Internal
+    INTERNAL: 'INTERNAL',
+};
+/**
+ * Structured CLI error with machine-readable fields.
+ *
+ * Usage:
+ *   throw new CLIError('No API key configured', {
+ *     code: ErrorCode.AUTH_MISSING,
+ *     category: 'auth',
+ *     guidance: 'Run `pb login` to configure your API key.',
+ *   });
+ */
+export class CLIError extends Error {
+    code;
+    category;
+    guidance;
+    constructor(message, options) {
+        super(message);
+        this.name = 'CLIError';
+        this.code = options?.code ?? ErrorCode.INTERNAL;
+        this.category = options?.category ?? 'internal';
+        this.guidance = options?.guidance;
+    }
+    /** Serialize for JSON error output. */
+    toJSON() {
+        return {
+            error: this.message,
+            code: this.code,
+            category: this.category,
+            ...(this.guidance ? { guidance: this.guidance } : {}),
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,sEAAsE;AACtE,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO;IACP,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,UAAU;IACV,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,SAAS;IACT,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,UAAU;IACV,gBAAgB,EAAE,kBAAkB;IACpC,aAAa;IACb,iBAAiB,EAAE,mBAAmB;IACtC,sBAAsB;IACtB,iBAAiB,EAAE,mBAAmB;IACtC,sBAAsB,EAAE,wBAAwB;IAChD,iBAAiB,EAAE,mBAAmB;IACtC,eAAe,EAAE,iBAAiB;IAClC,oBAAoB,EAAE,sBAAsB;IAC5C,cAAc;IACd,eAAe,EAAE,iBAAiB;IAClC,WAAW;IACX,QAAQ,EAAE,UAAU;CACZ,CAAC;AAIX;;;;;;;;;GASG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAiB;IACrB,QAAQ,CAAgB;IACxB,QAAQ,CAAU;IAE3B,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,UAAU,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACpC,CAAC;IAED,uCAAuC;IACvC,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC;CACF"}