@productbrain/cli 0.1.0-beta.71 → 0.1.0-beta.75

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

@@ -2,7 +2,7 @@
  * Path B — Facilitator-pattern onboarding (2 exchanges max).
  * WP-304: Shorter flow, silent extraction, auto-capture, governance proof.
  */
-import { convexCall } from './client.js';
+import { kernelCall } from './client.js';
 import { ask } from './prompts.js';
 import { bold, dim, green, icons } from './style.js';
 import { trackEvent } from './telemetry.js';
@@ -15,7 +15,7 @@ export async function runOnboardingPathB(workspaceName) {
     // Exchange 1: Opening question
     let greeting;
     try {
-        const result = await convexCall('onboarding.chat', {
+        const result = await kernelCall('onboarding.chat', {
             messages: [],
             workspaceName,
             style: 'facilitator',
@@ -54,14 +54,14 @@ export async function runOnboardingPathB(workspaceName) {
     totalUserWords += countWords(userInput);
     // Silent extraction after first answer (parallel with follow-up)
     const [followUpResult, extractResult] = await Promise.allSettled([
-        convexCall('onboarding.chat', {
+        kernelCall('onboarding.chat', {
             messages,
             workspaceName,
             style: 'facilitator',
             turnNumber: 2,
             totalUserWords,
         }),
-        convexCall('onboarding.chat', {
+        kernelCall('onboarding.chat', {
             messages,
             workspaceName,
             mode: 'extract',
@@ -84,7 +84,7 @@ export async function runOnboardingPathB(workspaceName) {
                 totalUserWords += countWords(secondInput);
                 // Second extraction — merge with first
                 try {
-                    const result2 = await convexCall('onboarding.chat', {
+                    const result2 = await kernelCall('onboarding.chat', {
                         messages,
                         workspaceName,
                         mode: 'extract',
@@ -107,7 +107,7 @@ export async function runOnboardingPathB(workspaceName) {
         // Try one final extraction if we don't have one
         if (!lastExtraction?.vision && messages.filter((m) => m.role === 'user').length > 0) {
             try {
-                const finalExtract = await convexCall('onboarding.chat', {
+                const finalExtract = await kernelCall('onboarding.chat', {
                     messages,
                     workspaceName,
                     mode: 'extract',
@@ -168,7 +168,7 @@ export function dedupe(arr) {
 /** Governance proof — show binding governance from captured knowledge via resolveTaskStartup. */
 async function showGovernanceProof(vision) {
     try {
-        const result = await convexCall('chain.resolveTaskStartup', { task: vision });
+        const result = await kernelCall('chain.resolveTaskStartup', { task: vision });
         const governance = result?.bindingGovernance;
         const steering = result?.steeringContext ?? [];
         const allItems = [
@@ -191,7 +191,7 @@ async function showGovernanceProof(vision) {
     catch {
         // Governance proof is best-effort — fall back to orient-based proof
         try {
-            const orient = await convexCall('orient', { brief: true });
+            const orient = await kernelCall('orient', { brief: true });
             const items = orient?.sections?.flatMap((s) => s.items ?? []).filter((i) => i.name) ?? [];
             if (items.length > 0) {
                 process.stdout.write(`\n  ${bold("Here's how your product brain will use this:")}\n\n`);

package/dist/lib/onboarding-shared.js

@@ -6,7 +6,7 @@
  * Copy-and-own: CLI uses 120-char truncate limits (vs MCP's 80). Shared package deferred.
  * Duplicated due to monorepo import boundary (BR-108).
  */
-import { convexCallWithSession } from './client.js';
+import { kernelCallWithSession } from './client.js';
 import { bold, cyan, dim, icons } from './style.js';
 // ── String helpers ─────────────────────────────────────────────────────────
 export function truncate(str, maxLen) {
@@ -154,7 +154,7 @@ export async function batchCaptureEntries(entries) {
     const errors = [];
     for (const entry of entries) {
         try {
-            await convexCallWithSession('chain.createEntry', {
+            await kernelCallWithSession('chain.createEntry', {
                 collectionSlug: entry.collection,
                 name: entry.name,
                 status: 'active',

package/dist/lib/onboarding.js

@@ -6,7 +6,7 @@
  * Convex onboardingChat action for conversation and extraction,
  * then chain.createEntry for batch-capture.
  */
-import { convexCall } from './client.js';
+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';
@@ -46,7 +46,7 @@ export async function runOnboardingConversation(workspaceName) {
     const openingDirective = buildTopicDirective(firstTopic, 0, ONBOARDING_TOPICS.length, [], workspaceName);
     let greeting;
     try {
-        const result = await convexCall('onboarding.chat', {
+        const result = await kernelCall('onboarding.chat', {
             messages: [],
             workspaceName,
             phaseDirective: openingDirective,
@@ -128,7 +128,7 @@ export async function runOnboardingConversation(workspaceName) {
         const topicDirective = buildTopicDirective(topic, currentTopicIndex, ONBOARDING_TOPICS.length, state.completedQA, workspaceName);
         let topicComplete = false;
         try {
-            const result = await convexCall('onboarding.chat', {
+            const result = await kernelCall('onboarding.chat', {
                 messages: state.messages,
                 workspaceName,
                 phaseDirective: topicDirective,
@@ -194,7 +194,7 @@ export async function runOnboardingConversation(workspaceName) {
     }
     let entriesToCapture;
     try {
-        const result = await convexCall('onboarding.chat', {
+        const result = await kernelCall('onboarding.chat', {
             messages: state.messages,
             workspaceName,
             mode: 'extract',

package/dist/lib/state.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CLI setup state resolution — determines where the user is in the setup journey
+ * and what render tier to use for output.
+ *
+ * WP-325 S1: Foundation utilities consumed by S2 (index.ts) and S3 (connect.ts).
+ * No callers wired in this slice — this is the shared substrate.
+ *
+ * Stage model:
+ *   unconfigured     → no API key found anywhere
+ *   authenticated    → API key present, but workspace unreachable (offline or not yet connected)
+ *   workspace-bound  → key + workspace reachable, but no active session
+ *   active           → key + workspace + active session
+ */
+/** Four-stage setup journey from cold start to active use. */
+export type SetupStage = 'unconfigured' | 'authenticated' | 'workspace-bound' | 'active';
+export interface SetupState {
+    stage: SetupStage;
+    /** Human-readable list of what is still missing. Empty when stage === 'active'. */
+    missingSteps: string[];
+    /** Single most important next command to run. */
+    nextAction: string;
+    /** Workspace name — populated when workspace probe succeeds. */
+    workspaceName?: string;
+    /** Total entry count from the workspace — populated when workspace probe succeeds. */
+    entryCount?: number;
+    /** Whether a write session is currently active. */
+    sessionActive?: boolean;
+}
+/** Output render tier for the current runtime context. */
+export type RenderTier = 'json' | 'plain' | 'ink';
+/**
+ * Determine the user's current setup stage and surface what's missing.
+ *
+ * Resolution order mirrors the config cascade (getConfigSafe → probeWorkspace → readSession).
+ * Each step is attempted only if the previous one succeeded, matching how the system
+ * actually behaves when a command runs.
+ *
+ * Network calls: probeWorkspace() makes one lightweight orient call. If the caller is in a
+ * context where network is unavailable, this returns 'authenticated' rather than throwing.
+ */
+export declare function resolveSetupState(): Promise<SetupState>;
+/**
+ * Determine the appropriate output rendering tier for the current process context.
+ *
+ * Priority:
+ *   json  → isJsonMode() is true (explicit --json flag or non-TTY piped output)
+ *   plain → stdout is not a TTY (but isJsonMode() was false — e.g. --pretty on a pipe)
+ *   ink   → interactive TTY, Ink React rendering is safe
+ */
+export declare function detectRenderTier(): RenderTier;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/lib/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAEzF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,mFAAmF;IACnF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAMlD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CA2C7D;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAI7C"}

package/dist/lib/state.js

@@ -0,0 +1,90 @@
+/**
+ * CLI setup state resolution — determines where the user is in the setup journey
+ * and what render tier to use for output.
+ *
+ * WP-325 S1: Foundation utilities consumed by S2 (index.ts) and S3 (connect.ts).
+ * No callers wired in this slice — this is the shared substrate.
+ *
+ * Stage model:
+ *   unconfigured     → no API key found anywhere
+ *   authenticated    → API key present, but workspace unreachable (offline or not yet connected)
+ *   workspace-bound  → key + workspace reachable, but no active session
+ *   active           → key + workspace + active session
+ */
+import { getConfigSafe } from './config.js';
+import { probeWorkspace } from './workspace-probe.js';
+import { readSession } from './session.js';
+import { isJsonMode } from './runner.js';
+// ---------------------------------------------------------------------------
+// resolveSetupState
+// ---------------------------------------------------------------------------
+/**
+ * Determine the user's current setup stage and surface what's missing.
+ *
+ * Resolution order mirrors the config cascade (getConfigSafe → probeWorkspace → readSession).
+ * Each step is attempted only if the previous one succeeded, matching how the system
+ * actually behaves when a command runs.
+ *
+ * Network calls: probeWorkspace() makes one lightweight orient call. If the caller is in a
+ * context where network is unavailable, this returns 'authenticated' rather than throwing.
+ */
+export async function resolveSetupState() {
+    // Step 1 — is an API key configured?
+    const configResult = getConfigSafe();
+    if (!configResult.ok) {
+        return {
+            stage: 'unconfigured',
+            missingSteps: ['API key not found'],
+            nextAction: 'pb login',
+        };
+    }
+    // Step 2 — can we reach the workspace?
+    const wsInfo = await probeWorkspace();
+    if (!wsInfo) {
+        return {
+            stage: 'authenticated',
+            missingSteps: ['Workspace not connected or unreachable'],
+            nextAction: 'pb connect',
+        };
+    }
+    // Step 3 — is there an active write session?
+    const session = readSession();
+    if (!session) {
+        return {
+            stage: 'workspace-bound',
+            missingSteps: ['No active write session'],
+            nextAction: 'pb session start',
+            workspaceName: wsInfo.name,
+            entryCount: wsInfo.entryCount,
+            sessionActive: false,
+        };
+    }
+    // All steps satisfied — fully active
+    return {
+        stage: 'active',
+        missingSteps: [],
+        nextAction: 'pb orient -b',
+        workspaceName: wsInfo.name,
+        entryCount: wsInfo.entryCount,
+        sessionActive: true,
+    };
+}
+// ---------------------------------------------------------------------------
+// detectRenderTier
+// ---------------------------------------------------------------------------
+/**
+ * Determine the appropriate output rendering tier for the current process context.
+ *
+ * Priority:
+ *   json  → isJsonMode() is true (explicit --json flag or non-TTY piped output)
+ *   plain → stdout is not a TTY (but isJsonMode() was false — e.g. --pretty on a pipe)
+ *   ink   → interactive TTY, Ink React rendering is safe
+ */
+export function detectRenderTier() {
+    if (isJsonMode())
+        return 'json';
+    if (!process.stdout.isTTY)
+        return 'plain';
+    return 'ink';
+}
+//# sourceMappingURL=state.js.map

package/dist/lib/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/lib/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0BzC,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,qCAAqC;IACrC,MAAM,YAAY,GAAG,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,YAAY,EAAE,CAAC,mBAAmB,CAAC;YACnC,UAAU,EAAE,UAAU;SACvB,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,YAAY,EAAE,CAAC,wCAAwC,CAAC;YACxD,UAAU,EAAE,YAAY;SACzB,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,CAAC,yBAAyB,CAAC;YACzC,UAAU,EAAE,kBAAkB;YAC9B,aAAa,EAAE,MAAM,CAAC,IAAI;YAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,cAAc;QAC1B,aAAa,EAAE,MAAM,CAAC,IAAI;QAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,IAAI;KACpB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,UAAU,EAAE;QAAE,OAAO,MAAM,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/workspace-probe.js

@@ -5,14 +5,14 @@
  * Design: lightweight orient call to detect workspace reachability. Returns structured
  * workspace info on success, null on any failure (network, auth, offline).
  */
-import { convexCall } from './client.js';
+import { kernelCall } from './client.js';
 /**
  * Attempt to detect workspace connectivity via a lightweight API call.
  * Returns workspace info on success, null on any failure.
  */
 export async function probeWorkspace() {
     try {
-        const result = await convexCall('orient', { brief: true });
+        const result = await kernelCall('orient', { brief: true });
         const name = result?.workspace?.name || 'unknown';
         // Sum entry counts from orient sections if available
         let entryCount;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productbrain/cli",
-  "version": "0.1.0-beta.71",
+  "version": "0.1.0-beta.75",
   "description": "Product Brain — Chain knowledge and write-back CLI",
   "type": "module",
   "bin": {