@autonoma-ai/planner 0.1.4 → 0.1.5

package/dist/index.js

@@ -84,6 +84,195 @@ var init_model = __esm({
   }
 });
 
+// src/core/analytics.ts
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { join as join5 } from "path";
+import { homedir as homedir3 } from "os";
+import { randomUUID } from "crypto";
+function resolveKey() {
+  return (process.env.AUTONOMA_POSTHOG_KEY ?? POSTHOG_PUBLIC_KEY).trim();
+}
+function resolveHost() {
+  return (process.env.AUTONOMA_POSTHOG_HOST ?? DEFAULT_HOST).replace(/\/+$/, "");
+}
+function trackingDisabled() {
+  const v = process.env.DONT_TRACK;
+  return v === "1" || v === "true";
+}
+function getIdentity() {
+  const id = process.env.AUTONOMA_DISTINCT_ID?.trim();
+  return id && id.length > 0 ? id : void 0;
+}
+function getDeviceId() {
+  if (cachedDeviceId) return cachedDeviceId;
+  try {
+    cachedDeviceId = readFileSync3(DEVICE_ID_PATH, "utf-8").trim();
+    if (cachedDeviceId) return cachedDeviceId;
+  } catch {
+  }
+  cachedDeviceId = randomUUID();
+  try {
+    mkdirSync2(AUTONOMA_HOME3, { recursive: true });
+    writeFileSync2(DEVICE_ID_PATH, cachedDeviceId, { encoding: "utf-8", mode: 384 });
+  } catch {
+  }
+  return cachedDeviceId;
+}
+function isEnabled() {
+  if (enabled === null) {
+    enabled = !trackingDisabled() && resolveKey().length > 0;
+  }
+  return enabled;
+}
+function track(event, properties = {}) {
+  if (!isEnabled()) return;
+  const identity = getIdentity();
+  const body = JSON.stringify({
+    api_key: resolveKey(),
+    event,
+    distinct_id: identity ?? getDeviceId(),
+    properties: {
+      ...properties,
+      run_id: RUN_ID,
+      // Only build a person profile when we have a real identity from the app,
+      // so the CLI joins the existing funnel person instead of creating a new one.
+      $process_person_profile: identity != null,
+      cli_version: process.env.npm_package_version
+    }
+  });
+  const promise = fetch(`${resolveHost()}/capture/`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body
+  }).catch(() => {
+  }).finally(() => pending.delete(promise));
+  pending.add(promise);
+}
+function trackError(error, properties = {}, handled = true) {
+  const err = error instanceof Error ? error : new Error(String(error));
+  track("$exception", {
+    ...properties,
+    $exception_list: [
+      {
+        type: err.name,
+        value: err.message,
+        mechanism: { handled, synthetic: !(error instanceof Error) }
+      }
+    ],
+    error_stack: err.stack
+  });
+}
+async function flushAnalytics(timeoutMs = 1500) {
+  if (pending.size === 0) return;
+  await Promise.race([
+    Promise.allSettled([...pending]),
+    new Promise((resolve5) => setTimeout(resolve5, timeoutMs))
+  ]);
+}
+var AUTONOMA_HOME3, DEVICE_ID_PATH, POSTHOG_PUBLIC_KEY, DEFAULT_HOST, RUN_ID, cachedDeviceId, enabled, pending;
+var init_analytics = __esm({
+  "src/core/analytics.ts"() {
+    "use strict";
+    init_esm_shims();
+    AUTONOMA_HOME3 = join5(homedir3(), ".autonoma");
+    DEVICE_ID_PATH = join5(AUTONOMA_HOME3, ".device-id");
+    POSTHOG_PUBLIC_KEY = "phc_mUOwUj62r8vyiisFPvXLC3G5RftETIBMnKNSHqTBdka";
+    DEFAULT_HOST = "https://us.i.posthog.com";
+    RUN_ID = randomUUID();
+    cachedDeviceId = null;
+    enabled = null;
+    pending = /* @__PURE__ */ new Set();
+  }
+});
+
+// src/core/errors.ts
+import { APICallError, RetryError, LoadAPIKeyError, InvalidPromptError, NoSuchModelError } from "ai";
+function sleep(ms) {
+  return new Promise((resolve5) => setTimeout(resolve5, ms));
+}
+function formatException(err) {
+  if (!(err instanceof Error)) return String(err);
+  let out = err.stack ?? `${err.name}: ${err.message}`;
+  if (err.cause != null) {
+    out += `
+Caused by: ${formatException(err.cause)}`;
+  }
+  return out;
+}
+function classifyAgentError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const msg = message.toLowerCase();
+  if (msg.includes("timed out") || msg.includes("timeout") || msg.includes("abort")) {
+    return "timeout";
+  }
+  if (APICallError.isInstance(err)) {
+    if (err.statusCode != null && FATAL_STATUS_CODES.has(err.statusCode)) return "fatal";
+    return "transient";
+  }
+  if (LoadAPIKeyError.isInstance(err) || InvalidPromptError.isInstance(err) || NoSuchModelError.isInstance(err)) {
+    return "fatal";
+  }
+  if (RetryError.isInstance(err)) {
+    if (err.reason === "errorNotRetryable" && err.lastError !== err) {
+      return classifyAgentError(err.lastError);
+    }
+    return "transient";
+  }
+  if (TRANSIENT_MESSAGE_PATTERNS.some((pattern) => msg.includes(pattern))) {
+    return "transient";
+  }
+  return "transient";
+}
+var FATAL_STATUS_CODES, TRANSIENT_MESSAGE_PATTERNS;
+var init_errors = __esm({
+  "src/core/errors.ts"() {
+    "use strict";
+    init_esm_shims();
+    FATAL_STATUS_CODES = /* @__PURE__ */ new Set([400, 401, 403, 404, 422]);
+    TRANSIENT_MESSAGE_PATTERNS = [
+      "econnreset",
+      "econnrefused",
+      "etimedout",
+      "socket hang up",
+      "fetch failed",
+      "network",
+      "overloaded",
+      "rate limit",
+      "too many requests",
+      "429",
+      "500",
+      "502",
+      "503",
+      "529"
+    ];
+  }
+});
+
+// src/core/notify.ts
+import { platform } from "os";
+import { execFile } from "child_process";
+function notify(title, message) {
+  process.stderr.write("\x07");
+  const os = platform();
+  if (os === "darwin") {
+    execFile(
+      "osascript",
+      ["-e", `display notification "${message.replace(/"/g, '\\"')}" with title "${title.replace(/"/g, '\\"')}"`],
+      () => {
+      }
+    );
+  } else if (os === "linux") {
+    execFile("notify-send", [title, message], () => {
+    });
+  }
+}
+var init_notify = __esm({
+  "src/core/notify.ts"() {
+    "use strict";
+    init_esm_shims();
+  }
+});
+
 // src/core/display.ts
 function formatArgs(input, keys) {
   const parts = [];
@@ -243,6 +432,13 @@ import {
   hasToolCall,
   stepCountIs
 } from "ai";
+function formatRetryGuidance(guidance) {
+  if (!guidance?.trim()) return "";
+  return `
+A previous attempt at this task did not complete successfully. The user provided this guidance for the retry:
+"${guidance.trim()}"
+`;
+}
 function buildDefaultStepLogger(agentId, maxSteps) {
   const logger = createStepLogger(agentId, maxSteps);
   return {
@@ -302,26 +498,49 @@ async function runAgent(config, prompt, extractResult) {
         onStepFinish: buildStepHandler(config)
       });
       try {
-        await agent.generate({
-          messages: [{ role: "user", content: prompt }],
+        const messages = [{ role: "user", content: prompt }];
+        let generation = await agent.generate({
+          messages,
           timeout: { stepMs: stepTimeout }
         });
+        let nudges = 0;
+        while (extractResult() === void 0 && nudges < MAX_NUDGES) {
+          nudges++;
+          console.log(
+            `  ${YELLOW5}[${config.id}] agent stopped without finishing \u2014 nudging (${nudges}/${MAX_NUDGES})...${RESET8}`
+          );
+          track("cli_agent_nudged", { agent: config.id, nudge: nudges });
+          messages.push(...generation.response.messages);
+          messages.push({ role: "user", content: NUDGE_PROMPT });
+          generation = await agent.generate({
+            messages,
+            timeout: { stepMs: stepTimeout }
+          });
+        }
         return extractResult();
       } catch (err) {
+        const errorClass = classifyAgentError(err);
+        if (errorClass === "fatal") throw err;
         const msg = err instanceof Error ? err.message : String(err);
-        const isTimeout = msg.includes("timed out") || msg.includes("timeout") || msg.includes("abort");
-        if (!isTimeout) throw err;
-        console.log(`  ${YELLOW5}[${config.id}] step timed out after ${stepTimeout / 1e3}s${RESET8}`);
+        if (errorClass === "timeout") {
+          console.log(`  ${YELLOW5}[${config.id}] step timed out after ${stepTimeout / 1e3}s${RESET8}`);
+        } else {
+          console.log(`  ${YELLOW5}[${config.id}] provider error: ${msg}${RESET8}`);
+        }
+        track("cli_agent_retryable_error", { agent: config.id, error_class: errorClass, retry });
         if (retry < RETRIES_BEFORE_FALLBACK - 1) {
           console.log(
             `  ${YELLOW5}[${config.id}] retrying (${retry + 1}/${RETRIES_BEFORE_FALLBACK})...${RESET8}`
           );
+          if (errorClass === "transient") {
+            await sleep(Math.min(2e3 * 2 ** retry, 1e4));
+          }
           continue;
         }
         if (modelIdx < modelsToTry.length - 1) {
           const nextModel = FALLBACK_MODELS[modelIdx];
           console.log(
-            `  ${YELLOW5}[${config.id}] ${RETRIES_BEFORE_FALLBACK} timeouts, switching to ${nextModel}${RESET8}`
+            `  ${YELLOW5}[${config.id}] ${RETRIES_BEFORE_FALLBACK} failed attempts, switching to ${nextModel}${RESET8}`
           );
           break;
         }
@@ -331,12 +550,14 @@ async function runAgent(config, prompt, extractResult) {
   }
   return extractResult();
 }
-var FALLBACK_MODELS, RETRIES_BEFORE_FALLBACK, STEP_TIMEOUT_MS;
+var FALLBACK_MODELS, RETRIES_BEFORE_FALLBACK, STEP_TIMEOUT_MS, MAX_NUDGES, NUDGE_PROMPT;
 var init_agent = __esm({
   "src/core/agent.ts"() {
     "use strict";
     init_esm_shims();
+    init_analytics();
     init_display();
+    init_errors();
     init_model();
     FALLBACK_MODELS = [
       "moonshotai/kimi-k2.6",
@@ -345,6 +566,8 @@ var init_agent = __esm({
     ];
     RETRIES_BEFORE_FALLBACK = 3;
     STEP_TIMEOUT_MS = 12e4;
+    MAX_NUDGES = 2;
+    NUDGE_PROMPT = "You stopped before completing the task. The task is only complete once the finish tool has been called and succeeded. If your last finish call returned an error, fix exactly what it reported. Otherwise, continue where you left off and call the finish tool when done.";
   }
 });
 
@@ -412,7 +635,7 @@ var init_gitignore = __esm({
 });
 
 // src/tools/bash.ts
-import { execFile as execFile2 } from "child_process";
+import { execFile as execFile3 } from "child_process";
 import { promisify as promisify2 } from "util";
 import { tool } from "ai";
 import { z } from "zod";
@@ -479,7 +702,7 @@ var init_bash = __esm({
   "src/tools/bash.ts"() {
     "use strict";
     init_esm_shims();
-    execFileAsync2 = promisify2(execFile2);
+    execFileAsync2 = promisify2(execFile3);
     CHAINING_OPERATORS = /;|&&|\|\||`|\$\(|>>|<<|&\s*$/;
     DEFAULT_ALLOWED = /* @__PURE__ */ new Set([
       "git",
@@ -540,7 +763,7 @@ var init_glob = __esm({
 });
 
 // src/tools/grep.ts
-import { execFile as execFile3 } from "child_process";
+import { execFile as execFile4 } from "child_process";
 import { promisify as promisify3 } from "util";
 import { tool as tool3 } from "ai";
 import { z as z3 } from "zod";
@@ -585,7 +808,7 @@ var init_grep = __esm({
   "src/tools/grep.ts"() {
     "use strict";
     init_esm_shims();
-    execFileAsync3 = promisify3(execFile3);
+    execFileAsync3 = promisify3(execFile4);
     inputSchema3 = z3.object({
       pattern: z3.string().describe("Regex pattern to search for in file contents"),
       glob: z3.string().optional().describe("Glob to filter files (e.g. '*.ts')"),
@@ -1062,31 +1285,6 @@ var init_pages_finder = __esm({
   }
 });
 
-// src/core/notify.ts
-import { platform } from "os";
-import { execFile as execFile4 } from "child_process";
-function notify(title, message) {
-  process.stderr.write("\x07");
-  const os = platform();
-  if (os === "darwin") {
-    execFile4(
-      "osascript",
-      ["-e", `display notification "${message.replace(/"/g, '\\"')}" with title "${title.replace(/"/g, '\\"')}"`],
-      () => {
-      }
-    );
-  } else if (os === "linux") {
-    execFile4("notify-send", [title, message], () => {
-    });
-  }
-}
-var init_notify = __esm({
-  "src/core/notify.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
 // src/core/review.ts
 import * as p3 from "@clack/prompts";
 import { access } from "fs/promises";
@@ -1540,7 +1738,7 @@ async function runKBGenerator(input) {
   let result;
   const tracker = new PageTracker();
   const { logger, onStepFinish } = buildDefaultStepLogger("kb", 150);
-  const contextBlock = input.projectContext ? "\n" + formatContext(input.projectContext) + "\n" : "";
+  const contextBlock = (input.projectContext ? "\n" + formatContext(input.projectContext) + "\n" : "") + formatRetryGuidance(input.retryGuidance);
   const pages = input.projectContext?.pages;
   if (pages?.length) {
     tracker.register(pages.map((p10) => p10.path));
@@ -1644,7 +1842,7 @@ Call page_coverage to see current state. When done with changes, call finish aga
   return reviewed ?? {
     success: false,
     artifacts: [],
-    summary: "KB generator did not produce a result"
+    summary: "KB generator agent stopped without producing AUTONOMA.md"
   };
 }
 var PageTracker;
@@ -2211,7 +2409,7 @@ async function runEntityAudit(input) {
     preRegisteredCount = detection.models.length;
   }
   const { logger, onStepFinish } = buildDefaultStepLogger("entity-audit", 200);
-  const contextBlock = input.projectContext ? "\n" + formatContext(input.projectContext) + "\n" : "";
+  const contextBlock = (input.projectContext ? "\n" + formatContext(input.projectContext) + "\n" : "") + formatRetryGuidance(input.retryGuidance);
   const preRegBlock = preRegisteredCount > 0 ? `
 ## Pre-registered models (${preRegisteredCount} found via ${detection.framework} schema at ${detection.schemaFile})
 
@@ -2260,11 +2458,13 @@ write_file already targets the output directory \u2014 use just the filename.`;
     },
     onStepFinish
   };
+  let agentError;
   try {
     await runAgent(agentConfig, prompt, () => result);
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`Entity audit agent error: ${message}`);
+    agentError = err instanceof Error ? err.message : String(err);
+    console.error(`Entity audit agent error:
+${formatException(err)}`);
   }
   logger.summary();
   if (!result && tracker.auditedModels.size > 0) {
@@ -2316,7 +2516,7 @@ When done with changes, call finish again.`;
   return reviewed ?? {
     success: false,
     artifacts: [],
-    summary: "Entity audit did not produce a result"
+    summary: agentError ? `Entity audit failed: ${agentError}` : "Entity audit agent stopped without producing entity-audit.md"
   };
 }
 var ModelTracker;
@@ -2325,6 +2525,7 @@ var init_entity_audit = __esm({
     "use strict";
     init_esm_shims();
     init_agent();
+    init_errors();
     init_context();
     init_model();
     init_review();
@@ -2653,7 +2854,7 @@ async function runScenarioRecipe(input) {
   const model = getModel(input.modelId);
   let result;
   const { logger, onStepFinish } = buildDefaultStepLogger("scenario", 40);
-  const contextBlock = input.projectContext ? "\n" + formatContext(input.projectContext) + "\n" : "";
+  const contextBlock = (input.projectContext ? "\n" + formatContext(input.projectContext) + "\n" : "") + formatRetryGuidance(input.retryGuidance);
   const requiredEntities = await parseEntityNames(input.outputDir);
   const entityListBlock = requiredEntities.length > 0 ? `
 ## Required entities (${requiredEntities.length} total \u2014 ALL must appear in the scenario)
@@ -2726,7 +2927,7 @@ When done with changes, call finish again.`;
   return reviewed ?? {
     success: false,
     artifacts: [],
-    summary: "Scenario recipe agent did not produce a result"
+    summary: "Scenario agent stopped without producing scenarios.md"
   };
 }
 async function feedbackToScenario(input, feedback) {
@@ -2920,7 +3121,8 @@ async function rankEntitiesByImportance(models, auditMarkdown, model) {
     return new Map(reconciled.order.map((name, i) => [name, i]));
   } catch (err) {
     console.warn(
-      `[recipe-builder] Importance ranking failed, falling back to alphabetical order: ${err instanceof Error ? err.message : String(err)}`
+      `[recipe-builder] Importance ranking failed, falling back to alphabetical order:
+${formatException(err)}`
     );
     return /* @__PURE__ */ new Map();
   }
@@ -2930,6 +3132,7 @@ var init_entity_relevance = __esm({
   "src/agents/04-recipe-builder/entity-relevance.ts"() {
     "use strict";
     init_esm_shims();
+    init_errors();
     rankedSchema = z13.object({
       ranked: z13.array(z13.string()).describe("Every entity name, ordered most-important first.")
     });
@@ -3478,7 +3681,8 @@ async function testUpDown(entityName, entityIndex, totalEntities, sdkConfig, rec
     try {
       upResult = await up(sdkConfig, recipe, testRunId);
     } catch (err) {
-      p5.log.error(`UP request failed: ${err instanceof Error ? err.message : String(err)}`);
+      p5.log.error(`UP request failed:
+${formatException(err)}`);
       const action = await promptOnFailure(entityName, null);
       if (action === "skip") return "skip";
       if (action === "retry") continue;
@@ -3506,7 +3710,8 @@ async function testUpDown(entityName, entityIndex, totalEntities, sdkConfig, rec
       try {
         downResult = await down(sdkConfig, refsToken);
       } catch (err) {
-        p5.log.error(`DOWN request failed: ${err instanceof Error ? err.message : String(err)}`);
+        p5.log.error(`DOWN request failed:
+${formatException(err)}`);
         const action = await promptOnFailure(entityName, null);
         if (action === "skip") return "skip";
         if (action === "retry") continue;
@@ -3707,6 +3912,7 @@ var init_entity_loop = __esm({
     "use strict";
     init_esm_shims();
     init_agent();
+    init_errors();
     init_tools();
     init_ask_user();
     init_gitignore();
@@ -3809,7 +4015,8 @@ async function teardown(sdkConfig, refsToken, successMessage) {
   try {
     downResult = await down(sdkConfig, refsToken);
   } catch (err) {
-    p6.log.error(`Full DOWN request failed: ${err instanceof Error ? err.message : String(err)}`);
+    p6.log.error(`Full DOWN request failed:
+${formatException(err)}`);
     return false;
   }
   if (!downResult.ok) {
@@ -3847,7 +4054,8 @@ async function runFullValidation(state, _models, outputDir, model) {
     try {
       upResult = await up(sdkConfig, fullRecipe, testRunId);
     } catch (err) {
-      p6.log.error(`Full UP request failed: ${err instanceof Error ? err.message : String(err)}`);
+      p6.log.error(`Full UP request failed:
+${formatException(err)}`);
       notify("Autonoma", "Full validation UP failed, action needed");
       const action = await p6.select({
         message: "What would you like to do?",
@@ -3934,6 +4142,7 @@ var init_full_validation = __esm({
     init_esm_shims();
     init_notify();
     init_agent();
+    init_errors();
     init_tools();
     init_highlight();
     init_state();
@@ -5543,7 +5752,7 @@ ${scenariosMd}
   const preseedContext = existingState ? "" : await preseedQueue(state, input.projectRoot, input.pages, features ?? void 0);
   const resumeContext = existingState ? `
 You are RESUMING a previous run. ${existingState.summary().tested} nodes tested, ${existingState.summary().totalTests} tests written. Call next_node to continue.` : "";
-  const contextBlock = input.projectContext ? "\n" + formatContext(input.projectContext) + "\n" : "";
+  const contextBlock = (input.projectContext ? "\n" + formatContext(input.projectContext) + "\n" : "") + formatRetryGuidance(input.retryGuidance);
   let prompt = `Generate E2E test cases by processing every node in the queue.
 ${contextBlock}${kbContext}${resumeContext}${preseedContext}
 
@@ -5608,8 +5817,8 @@ Do NOT try to finish early. Process EVERY node via next_node until it returns do
     try {
       await runAgent(agentConfig, prompt, () => result);
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      console.log(`  [chunk] Agent error (will retry next chunk): ${message}`);
+      console.log(`  [chunk] Agent error (will retry next chunk):
+${formatException(err)}`);
     }
     totalSteps += CHUNK_STEPS;
     if (result) break;
@@ -5970,8 +6179,8 @@ Write 5-8 journey tests using the write_test tool with folder "journeys". Then c
   try {
     await runAgent(config, journeyPrompt, () => journeyResult);
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`Journey generator error: ${message}`);
+    console.error(`Journey generator error:
+${formatException(err)}`);
   }
   logger.summary();
   return journeyState.allTestPaths().length;
@@ -5982,6 +6191,7 @@ var init_test_generator = __esm({
     "use strict";
     init_esm_shims();
     init_agent();
+    init_errors();
     init_context();
     init_display();
     init_gitignore();
@@ -6197,86 +6407,10 @@ function restoreTerminal() {
   process.stdout.write(SHOW_CURSOR);
 }
 
-// src/core/analytics.ts
-init_esm_shims();
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
-import { join as join5 } from "path";
-import { homedir as homedir3 } from "os";
-import { randomUUID } from "crypto";
-var AUTONOMA_HOME3 = join5(homedir3(), ".autonoma");
-var DEVICE_ID_PATH = join5(AUTONOMA_HOME3, ".device-id");
-var POSTHOG_PUBLIC_KEY = "phc_mUOwUj62r8vyiisFPvXLC3G5RftETIBMnKNSHqTBdka";
-var DEFAULT_HOST = "https://us.i.posthog.com";
-function resolveKey() {
-  return (process.env.AUTONOMA_POSTHOG_KEY ?? POSTHOG_PUBLIC_KEY).trim();
-}
-function resolveHost() {
-  return (process.env.AUTONOMA_POSTHOG_HOST ?? DEFAULT_HOST).replace(/\/+$/, "");
-}
-function trackingDisabled() {
-  const v = process.env.DONT_TRACK;
-  return v === "1" || v === "true";
-}
-function getIdentity() {
-  const id = process.env.AUTONOMA_DISTINCT_ID?.trim();
-  return id && id.length > 0 ? id : void 0;
-}
-var RUN_ID = randomUUID();
-var cachedDeviceId = null;
-function getDeviceId() {
-  if (cachedDeviceId) return cachedDeviceId;
-  try {
-    cachedDeviceId = readFileSync3(DEVICE_ID_PATH, "utf-8").trim();
-    if (cachedDeviceId) return cachedDeviceId;
-  } catch {
-  }
-  cachedDeviceId = randomUUID();
-  try {
-    mkdirSync2(AUTONOMA_HOME3, { recursive: true });
-    writeFileSync2(DEVICE_ID_PATH, cachedDeviceId, { encoding: "utf-8", mode: 384 });
-  } catch {
-  }
-  return cachedDeviceId;
-}
-var enabled = null;
-function isEnabled() {
-  if (enabled === null) {
-    enabled = !trackingDisabled() && resolveKey().length > 0;
-  }
-  return enabled;
-}
-var pending = /* @__PURE__ */ new Set();
-function track(event, properties = {}) {
-  if (!isEnabled()) return;
-  const identity = getIdentity();
-  const body = JSON.stringify({
-    api_key: resolveKey(),
-    event,
-    distinct_id: identity ?? getDeviceId(),
-    properties: {
-      ...properties,
-      run_id: RUN_ID,
-      // Only build a person profile when we have a real identity from the app,
-      // so the CLI joins the existing funnel person instead of creating a new one.
-      $process_person_profile: identity != null,
-      cli_version: process.env.npm_package_version
-    }
-  });
-  const promise = fetch(`${resolveHost()}/capture/`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body
-  }).catch(() => {
-  }).finally(() => pending.delete(promise));
-  pending.add(promise);
-}
-async function flushAnalytics(timeoutMs = 1500) {
-  if (pending.size === 0) return;
-  await Promise.race([
-    Promise.allSettled([...pending]),
-    new Promise((resolve5) => setTimeout(resolve5, timeoutMs))
-  ]);
-}
+// src/index.ts
+init_analytics();
+init_errors();
+init_notify();
 
 // src/core/upload.ts
 init_esm_shims();
@@ -6287,11 +6421,11 @@ import { glob } from "glob";
 
 // src/core/git.ts
 init_esm_shims();
-import { execFile } from "child_process";
+import { execFile as execFile2 } from "child_process";
 import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import { join as join6 } from "path";
 import { promisify } from "util";
-var execFileAsync = promisify(execFile);
+var execFileAsync = promisify(execFile2);
 var GIT_INFO_FILE = ".git-info.json";
 async function git(projectRoot, args) {
   try {
@@ -6506,7 +6640,7 @@ var STEP_INTROS = {
   recipeBuilder: "Helping you wire up small helpers that create and clean up test data in your own database. We give you a copy-paste guide for each one and test it live against your app running locally - you deploy later, once everything passes.",
   testGenerator: "Writing the actual end-to-end tests, covering every page and feature with depth proportional to its complexity."
 };
-async function runStep(step, outputDir, state, config, projectContext, nonInteractive) {
+async function runStep(step, outputDir, state, config, projectContext, nonInteractive, retryGuidance) {
   const label = STEP_LABELS[step];
   p9.note(STEP_INTROS[step], `Step: ${label}`);
   const stepStartedAt = Date.now();
@@ -6539,7 +6673,8 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
           outputDir,
           modelId: config.modelId,
           projectContext,
-          nonInteractive
+          nonInteractive,
+          retryGuidance
         });
         break;
       }
@@ -6550,7 +6685,8 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
           outputDir,
           modelId: config.modelId,
           projectContext,
-          nonInteractive
+          nonInteractive,
+          retryGuidance
         });
         break;
       }
@@ -6562,7 +6698,8 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
           modelId: config.modelId,
           config,
           projectContext,
-          nonInteractive
+          nonInteractive,
+          retryGuidance
         });
         break;
       }
@@ -6574,7 +6711,8 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
           modelId: config.modelId,
           config,
           projectContext,
-          nonInteractive
+          nonInteractive,
+          retryGuidance
         });
         break;
       }
@@ -6588,7 +6726,8 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
           config,
           projectContext,
           nonInteractive,
-          pages
+          pages,
+          retryGuidance
         });
         break;
       }
@@ -6600,6 +6739,7 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
       } else {
         state = await markStep(outputDir, state, step, "failed");
         p9.log.error(`Failed: ${label} \u2014 ${result.summary}`);
+        trackError(new Error(result.summary), { step, source: "step_result" });
       }
     } else {
       state = await markStep(outputDir, state, step, "done");
@@ -6609,6 +6749,9 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
     state = await markStep(outputDir, state, step, "failed");
     const message = err instanceof Error ? err.message : String(err);
     p9.log.error(`Failed: ${label} \u2014 ${message}`);
+    console.error(`\x1B[2m${formatException(err)}\x1B[0m`);
+    p9.log.info("If you report this, please include the error output above.");
+    trackError(err, { step, source: "step_exception" });
   }
   track("cli_step_completed", {
     step,
@@ -6617,6 +6760,37 @@ async function runStep(step, outputDir, state, config, projectContext, nonIntera
   });
   return state;
 }
+async function promptStepFailure(label) {
+  notify("Autonoma", `${label} failed \u2014 action needed`);
+  const action = await p9.select({
+    message: "This step failed. What would you like to do?",
+    options: [
+      { value: "retry", label: "Retry this step", hint: "Run it again from the top" },
+      { value: "guidance", label: "Retry with guidance", hint: "Tell the agent what went wrong or what to focus on" },
+      { value: "exit", label: "Stop here (progress saved)", hint: "Resume later with --resume" }
+    ]
+  });
+  if (p9.isCancel(action) || action === "exit") return { kind: "exit" };
+  if (action === "retry") return { kind: "retry" };
+  const guidance = await p9.text({
+    message: "What should the agent do differently?",
+    placeholder: "e.g. the part that failed, or what to focus on"
+  });
+  if (p9.isCancel(guidance)) return { kind: "exit" };
+  const trimmed = guidance.trim();
+  return { kind: "retry", guidance: trimmed || void 0 };
+}
+async function runStepWithRecovery(step, outputDir, state, config, projectContext, nonInteractive) {
+  let guidance;
+  while (true) {
+    state = await runStep(step, outputDir, state, config, projectContext, nonInteractive, guidance);
+    if (state.steps[step] !== "failed" || nonInteractive) return state;
+    const action = await promptStepFailure(STEP_LABELS[step]);
+    if (action.kind === "exit") return state;
+    guidance = action.guidance;
+    track("cli_step_retried", { step, with_guidance: guidance != null });
+  }
+}
 async function showStatus(outputDir) {
   const state = await loadState(outputDir);
   console.log("\nPipeline Status:");
@@ -6794,7 +6968,13 @@ or reveal hidden files (macOS: Cmd+Shift+. ) to see it.`,
       p9.log.error("Cannot run test generation yet \u2014 the scenario recipe step must complete first.");
       return;
     }
-    state = await runStep(targetStep, outputDir, state, config, projectContext, nonInteractive);
+    state = await runStepWithRecovery(targetStep, outputDir, state, config, projectContext, nonInteractive);
+    if (state.steps[targetStep] === "failed") {
+      const retryCommand = `autonoma-planner --step ${targetStep}` + (args.project ? ` --project ${args.project}` : "");
+      p9.log.warn(`Your progress is saved. To retry this step, run:
+  ${retryCommand}`);
+      process.exitCode = 1;
+    }
     p9.outro("Done");
     return;
   }
@@ -6812,12 +6992,15 @@ or reveal hidden files (macOS: Cmd+Shift+. ) to see it.`,
   try {
     for (let i = startIdx; i < steps.length; i++) {
       const step = steps[i];
-      state = await runStep(step, outputDir, state, config, projectContext, nonInteractive);
+      state = await runStepWithRecovery(step, outputDir, state, config, projectContext, nonInteractive);
       if (state.steps[step] === "paused") {
         break;
       }
       if (state.steps[step] === "failed") {
         p9.log.error("Pipeline stopped due to failure.");
+        p9.log.warn(`Your progress is saved. To retry this step, run:
+  ${resumeCommand}`);
+        process.exitCode = 1;
         break;
       }
       const skipConfirmAfter = ["pagesFinder"];
@@ -6850,14 +7033,17 @@ Continue?`
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       p9.log.error(`Failed to upload artifacts: ${message}`);
+      console.error(`\x1B[2m${formatException(err)}\x1B[0m`);
       p9.log.info(`Your artifacts are saved in ${outputDir}. Re-run the CLI to retry the upload.`);
       track("cli_artifacts_upload_failed", { message });
+      trackError(err, { source: "artifact_upload" });
     }
   }
   p9.outro("Done");
 }
 main().then(() => flushAnalytics()).catch(async (err) => {
   console.error(err);
+  trackError(err, { source: "uncaught" }, false);
   await flushAnalytics();
   process.exit(1);
 });