archondev 2.19.4 → 2.19.5

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   showExecutionPreferences,
   showPreferences,
   showUsageDetails
-} from "./chunk-K3XN7PN6.js";
+} from "./chunk-KETUHDUE.js";
 import {
   a11yBadge,
   a11yCheck,
@@ -47,13 +47,13 @@ import {
   parallelRunWaves,
   parallelSchedule,
   parallelStatus
-} from "./chunk-3UOMLERV.js";
+} from "./chunk-KDWIKBM2.js";
 import {
   DependencyParser,
   EnvironmentConfigLoader,
   EnvironmentValidator,
   execute
-} from "./chunk-HQBF3VTN.js";
+} from "./chunk-X5ZZCJBQ.js";
 import {
   cloudCancel,
   cloudLogs,
@@ -61,12 +61,12 @@ import {
 } from "./chunk-EBHHIUCB.js";
 import {
   list
-} from "./chunk-C4HVI2NJ.js";
+} from "./chunk-W6TYXCZA.js";
 import {
   listLocalAtoms,
   loadAtom,
   plan
-} from "./chunk-IKMCIWK3.js";
+} from "./chunk-OTODLPY4.js";
 import "./chunk-PCTP3LKJ.js";
 import "./chunk-PJRQI5UN.js";
 import {
@@ -2777,6 +2777,7 @@ async function start(options = {}) {
     console.log(chalk6.dim("  \u2022 ") + chalk6.bold("BYOK (FREE)") + chalk6.dim(" - Unlimited usage with your own API keys"));
     console.log(chalk6.dim("  \u2022 ") + chalk6.bold("Managed Plan") + chalk6.dim(" - Just 10% fee on AI costs, zero setup"));
     console.log(chalk6.cyan("\u2192 Run ") + chalk6.bold("'archon upgrade'") + chalk6.cyan(" to unlock unlimited access"));
+    console.log(chalk6.dim("\u2192 Model preferences: archon preferences"));
   }
   if (currentTier === "CREDITS" && config.accessToken) {
     try {
@@ -2832,7 +2833,13 @@ async function start(options = {}) {
         } else {
           console.log(chalk6.dim(`Add credits: archon credits add`));
         }
-        console.log(chalk6.dim(`View details: archon credits  |  Switch tier: archon upgrade`));
+        console.log(chalk6.dim(`View details: archon credits  |  Switch tier: archon upgrade  |  Models: archon preferences`));
+        if (usageStats.balance <= 0) {
+          const topUpNow = await promptYesNo("Balance is $0. Add credits now?", true);
+          if (topUpNow) {
+            await handleTierSetup("CREDITS");
+          }
+        }
       }
     } catch {
     }
@@ -3185,7 +3192,7 @@ async function handleNewProject(cwd, _state) {
   }
   if (intent.mode === "ad_hoc" && intent.confidence >= 0.7) {
     console.log(chalk6.dim("\n> Got it! Creating a task for this...\n"));
-    const { plan: plan2 } = await import("./plan-7M27X3OD.js");
+    const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
     await plan2(initialResponse, {});
     return;
   }
@@ -3196,32 +3203,42 @@ async function handleNewProject(cwd, _state) {
   }
   if (needsClarification(intent)) {
     console.log();
-    console.log(chalk6.dim("I'm not sure what you're looking for. Are you..."));
+    console.log(chalk6.dim("I'm not sure yet. You can tell me in plain language, or use shortcuts:"));
     console.log();
-    console.log(`  ${chalk6.cyan("1")}) ${chalk6.bold("Building something new")} \u2014 a complete app, system, or project`);
-    console.log(`  ${chalk6.cyan("2")}) ${chalk6.bold("Doing a specific task")} \u2014 fix, add, refactor, analyze`);
-    console.log(`  ${chalk6.cyan("3")}) ${chalk6.bold("Just exploring")} \u2014 show me what ArchonDev can do`);
+    console.log(`  ${chalk6.cyan("1")}) ${chalk6.bold("Build something new")}`);
+    console.log(`  ${chalk6.cyan("2")}) ${chalk6.bold("Do a specific task")}`);
+    console.log(`  ${chalk6.cyan("3")}) ${chalk6.bold("Explore project/status")}`);
     console.log();
-    const clarification = await promptWithCommands("Enter choice (1-3)");
-    switch (clarification.trim()) {
-      case "1":
-        await runConversationalInterview(cwd, initialResponse);
-        break;
-      case "2":
-        console.log(chalk6.dim("\n> Creating a task for this...\n"));
-        const { plan: plan2 } = await import("./plan-7M27X3OD.js");
-        await plan2(initialResponse, {});
-        break;
-      case "3":
-      default:
-        await showNewProjectMenu(cwd);
+    const clarification = await promptWithCommands("What are you trying to do?", { allowMultiline: true });
+    const trimmed = clarification.trim();
+    if (trimmed === "1") {
+      await runConversationalInterview(cwd, initialResponse);
+      return;
+    }
+    if (trimmed === "2") {
+      console.log(chalk6.dim("\n> Creating a task for this...\n"));
+      const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
+      await plan2(initialResponse, {});
+      return;
+    }
+    if (trimmed === "3") {
+      await showNewProjectMenu(cwd);
+      return;
+    }
+    if (trimmed) {
+      const handled = await handleFreeformJourneyInput(cwd, trimmed);
+      if (handled) {
+        return;
+      }
     }
+    await showNewProjectMenu(cwd);
     return;
   }
   await runConversationalInterview(cwd, initialResponse);
 }
 async function showNewProjectMenu(cwd) {
   console.log(chalk6.bold("What would you like to do?\n"));
+  console.log(chalk6.dim("You can type naturally (recommended) or use a shortcut number:\n"));
   console.log(`  ${chalk6.cyan("1")}) ${chalk6.bold("Start interview")} \u2014 I'll ask questions to understand your project`);
   console.log(`  ${chalk6.cyan("2")}) ${chalk6.bold("Quick start")} \u2014 Just create basic governance files`);
   console.log(`  ${chalk6.cyan("3")}) ${chalk6.bold("Plan a task")} \u2014 Create an atom for a specific task`);
@@ -3239,7 +3256,7 @@ async function showNewProjectMenu(cwd) {
     case "3": {
       const description = await promptWithCommands("Describe what you want to do", { allowMultiline: true });
       if (description.trim()) {
-        const { plan: plan2 } = await import("./plan-7M27X3OD.js");
+        const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
         await plan2(description, {});
       }
       break;
@@ -3247,7 +3264,13 @@ async function showNewProjectMenu(cwd) {
     case "q":
       process.exit(0);
     default:
-      console.log(chalk6.yellow("Invalid choice. Please try again."));
+      if (choice.trim()) {
+        const handled = await handleFreeformJourneyInput(cwd, choice);
+        if (handled) {
+          return;
+        }
+      }
+      console.log(chalk6.yellow("I did not catch that. Try again or describe what you want in plain language."));
       await showNewProjectMenu(cwd);
   }
 }
@@ -3293,6 +3316,7 @@ async function runExploreFlow(cwd) {
   console.log();
   console.log(chalk6.green("\u2713 Analysis complete! I'm ready to work on this project.\n"));
   console.log(chalk6.bold("What would you like to do next?\n"));
+  console.log(chalk6.dim("You can describe it naturally, or use shortcuts:\n"));
   console.log(`  ${chalk6.cyan("1")}) ${chalk6.bold("Plan a task")} \u2014 Tell me what to implement, fix, or change`);
   console.log(`  ${chalk6.cyan("2")}) ${chalk6.bold("Review code")} \u2014 Run AI-powered code review`);
   if (!projectInfo.hasArchitecture) {
@@ -3305,7 +3329,7 @@ async function runExploreFlow(cwd) {
     case "1": {
       const description = await promptWithCommands("Describe what you want to do", { allowMultiline: true });
       if (description.trim()) {
-        const { plan: plan2 } = await import("./plan-7M27X3OD.js");
+        const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
         await plan2(description, {});
       }
       break;
@@ -3320,6 +3344,15 @@ async function runExploreFlow(cwd) {
       break;
     case "q":
       process.exit(0);
+    default:
+      if (choice.trim()) {
+        const handled = await handleFreeformJourneyInput(cwd, choice);
+        if (handled) {
+          return;
+        }
+      }
+      console.log(chalk6.yellow("I did not catch that. Tell me what you want to do next."));
+      await showMainMenu();
   }
 }
 async function gatherProjectInfo(cwd) {
@@ -3567,7 +3600,7 @@ ${state.forbiddenPatterns?.length ? `- **Forbidden patterns:** ${state.forbidden
   if (continueChoice) {
     const description = await promptWithCommands("Describe what you want to build first", { allowMultiline: true });
     if (description.trim()) {
-      const { plan: plan2 } = await import("./plan-7M27X3OD.js");
+      const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
       await plan2(description, {});
     }
   }
@@ -3621,7 +3654,7 @@ async function handleAdaptExisting(cwd, state) {
   }
   if (intent.mode === "ad_hoc" && intent.confidence >= 0.7) {
     console.log(chalk6.dim("\n> Got it! Creating a task for this...\n"));
-    const { plan: plan2 } = await import("./plan-7M27X3OD.js");
+    const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
     await plan2(response, {});
     return;
   }
@@ -3630,11 +3663,18 @@ async function handleAdaptExisting(cwd, state) {
     await runConversationalInterview(cwd, response);
     return;
   }
+  if (response.trim()) {
+    const handled = await handleFreeformJourneyInput(cwd, response);
+    if (handled) {
+      return;
+    }
+  }
   await showAdaptExistingMenu(cwd, state);
 }
 async function showAdaptExistingMenu(cwd, state) {
   console.log();
   console.log(chalk6.bold("What would you like to do?\n"));
+  console.log(chalk6.dim("You can type naturally (recommended) or use a shortcut number:\n"));
   console.log(`  ${chalk6.cyan("1")}) ${chalk6.bold("Analyze project")} \u2014 Scan and summarize the codebase`);
   console.log(`  ${chalk6.cyan("2")}) ${chalk6.bold("Plan a task")} \u2014 Create an implementation plan for something specific`);
   console.log(`  ${chalk6.cyan("3")}) ${chalk6.bold("Code review")} \u2014 Review code for issues`);
@@ -3652,7 +3692,7 @@ async function showAdaptExistingMenu(cwd, state) {
     case "2": {
       const description = await promptWithCommands("Describe what you want to do", { allowMultiline: true });
       if (description.trim()) {
-        const { plan: plan2 } = await import("./plan-7M27X3OD.js");
+        const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
         await plan2(description, {});
       }
       break;
@@ -3671,7 +3711,13 @@ async function showAdaptExistingMenu(cwd, state) {
     case "q":
       process.exit(0);
     default:
-      console.log(chalk6.yellow("Invalid choice. Please try again."));
+      if (choice.trim()) {
+        const handled = await handleFreeformJourneyInput(cwd, choice);
+        if (handled) {
+          return;
+        }
+      }
+      console.log(chalk6.yellow("I did not catch that. Try again or describe what you want in plain language."));
       await showAdaptExistingMenu(cwd, state);
   }
 }
@@ -3736,6 +3782,13 @@ async function handleContinueSession(cwd, state) {
   if (state.hasReviewDb) {
     await showReviewProgress(cwd);
   }
+  const response = await promptWithCommands("What would you like to do next? (press Enter for options)", { allowMultiline: true });
+  if (response.trim()) {
+    const handled = await handleFreeformJourneyInput(cwd, response);
+    if (handled) {
+      return;
+    }
+  }
   await showMainMenu();
 }
 function checkForHandoff(cwd) {
@@ -3800,31 +3853,40 @@ async function showMainMenu() {
   }
   console.log(chalk6.dim('  (Type "upgrade" or "help" anytime)'));
   console.log();
-  const selected = await promptWithCommands("Enter choice", { allowMultiline: true });
+  const selected = await promptWithCommands("Tell me what you want to do (or enter a shortcut)", { allowMultiline: true });
   const choice = choices.find((c) => c.key === selected.toLowerCase());
   if (choice) {
     await choice.action();
   } else if (selected.trim()) {
-    const freeform = selected.trim();
-    const intent = detectUserIntent(freeform);
-    if (intent.mode === "explore" && intent.confidence >= 0.7) {
-      console.log(chalk6.dim("\n> Got it! Analyzing the project...\n"));
-      await runExploreFlow(cwd);
-      return;
-    }
-    if (intent.mode === "app_builder" && intent.confidence >= 0.7) {
-      console.log(chalk6.dim("\n> Let me understand your project better...\n"));
-      await runConversationalInterview(cwd, freeform);
-      return;
+    const handled = await handleFreeformJourneyInput(cwd, selected.trim());
+    if (!handled) {
+      console.log(chalk6.yellow("I did not catch that. Try describing your goal in one sentence."));
+      await showMainMenu();
     }
-    console.log(chalk6.dim("\n> Got it! Creating a task for this...\n"));
-    const { plan: plan2 } = await import("./plan-7M27X3OD.js");
-    await plan2(freeform, {});
   } else {
     console.log(chalk6.yellow("Invalid choice. Please try again."));
     await showMainMenu();
   }
 }
+async function handleFreeformJourneyInput(cwd, input) {
+  const freeform = input.trim();
+  if (!freeform) return false;
+  const intent = detectUserIntent(freeform);
+  if (intent.mode === "explore" && intent.confidence >= 0.7) {
+    console.log(chalk6.dim("\n> Got it! Analyzing the project...\n"));
+    await runExploreFlow(cwd);
+    return true;
+  }
+  if (intent.mode === "app_builder" && intent.confidence >= 0.7) {
+    console.log(chalk6.dim("\n> Let me understand your project better...\n"));
+    await runConversationalInterview(cwd, freeform);
+    return true;
+  }
+  console.log(chalk6.dim("\n> Got it! Creating a task for this...\n"));
+  const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
+  await plan2(freeform, {});
+  return true;
+}
 async function showReviewProgress(cwd) {
   try {
     const { ReviewDatabase } = await import("./code-review-GJVBZPZA.js");
@@ -3844,20 +3906,20 @@ async function showReviewProgress(cwd) {
   }
 }
 async function planTask() {
-  const { plan: plan2 } = await import("./plan-7M27X3OD.js");
+  const { plan: plan2 } = await import("./plan-7SCZH7EA.js");
   const description = await promptWithCommands("Describe what you want to build", { allowMultiline: true });
   if (description.trim()) {
     await plan2(description, {});
   }
 }
 async function listAtoms() {
-  const { list: list2 } = await import("./list-Q4HLHQJI.js");
+  const { list: list2 } = await import("./list-SKRHIZ5T.js");
   await list2({});
 }
 async function executeNext() {
-  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-7M27X3OD.js");
+  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-7SCZH7EA.js");
   const { analyzeProject, getComplexityDescription, getModeDescription } = await import("./orchestration-HIF3KP25.js");
-  const { loadExecutionPreferences } = await import("./preferences-SFXRVXT3.js");
+  const { loadExecutionPreferences } = await import("./preferences-YOSAIHGM.js");
   const cwd = process.cwd();
   const atoms = await listLocalAtoms2();
   const pendingAtoms = atoms.filter((a) => a.status === "READY" || a.status === "IN_PROGRESS");
@@ -3926,11 +3988,11 @@ async function executeNext() {
         }
       }
       if (selectedMode === "parallel-cloud") {
-        const { parallelExecuteCloud: parallelExecuteCloud2 } = await import("./parallel-QLKYSZZ3.js");
+        const { parallelExecuteCloud: parallelExecuteCloud2 } = await import("./parallel-KRBYFJ4O.js");
         await parallelExecuteCloud2(runIds);
         return;
       }
-      const { parallelExecute } = await import("./parallel-QLKYSZZ3.js");
+      const { parallelExecute } = await import("./parallel-KRBYFJ4O.js");
       await parallelExecute(runIds);
       return;
     }
@@ -3938,7 +4000,7 @@ async function executeNext() {
   const atomId = await prompt("Enter atom ID to execute (or press Enter for first pending)");
   const targetId = atomId.trim() || pendingAtoms[0]?.id;
   if (targetId) {
-    const { execute: execute2 } = await import("./execute-JAHXFYXL.js");
+    const { execute: execute2 } = await import("./execute-DBNVIJ3P.js");
     await execute2(targetId, {});
   } else {
     console.log(chalk6.yellow("No atom to execute."));
@@ -3956,7 +4018,7 @@ async function viewStatus() {
   await status2();
 }
 async function settingsMenu() {
-  const { interactiveSettings } = await import("./preferences-SFXRVXT3.js");
+  const { interactiveSettings } = await import("./preferences-YOSAIHGM.js");
   await interactiveSettings();
   await showMainMenu();
 }
@@ -3970,6 +4032,7 @@ async function reviewCode() {
     console.log();
   }
   console.log(chalk6.bold("\nCode Review Options:\n"));
+  console.log(chalk6.dim("You can type naturally (recommended) or use a shortcut:\n"));
   console.log(`  ${chalk6.cyan("1")}) Analyze project`);
   console.log(`  ${chalk6.cyan("2")}) Show review status`);
   console.log(`  ${chalk6.cyan("3")}) Review next file`);
@@ -3977,8 +4040,9 @@ async function reviewCode() {
   console.log(`  ${chalk6.cyan("5")}) Run AI review on all pending`);
   console.log(`  ${chalk6.cyan("b")}) Back to main menu`);
   console.log();
-  const choice = await prompt("Enter choice");
-  switch (choice.toLowerCase()) {
+  const raw = await promptWithCommands("What do you want to do?", { allowMultiline: true });
+  const choice = resolveReviewChoice(raw);
+  switch (choice) {
     case "1": {
       const { reviewAnalyze: reviewAnalyze2 } = await import("./review-BXESOS5R.js");
       await reviewAnalyze2();
@@ -4008,7 +4072,13 @@ async function reviewCode() {
       await showMainMenu();
       return;
     default:
-      console.log(chalk6.yellow("Invalid choice."));
+      if (raw.trim()) {
+        const handled = await handleFreeformJourneyInput(cwd, raw.trim());
+        if (handled) {
+          return;
+        }
+      }
+      console.log(chalk6.yellow("I did not catch that. Tell me what review action you want."));
   }
   await reviewCode();
 }
@@ -4123,8 +4193,9 @@ async function showWebChecksMenu() {
   console.log(`  ${chalk6.cyan("7")}) Set prompt mode (ask/always/never)`);
   console.log(`  ${chalk6.cyan("b")}) Back to main menu`);
   console.log();
-  const choice = await promptWithCommands("Enter choice");
-  switch (choice.toLowerCase()) {
+  const raw = await promptWithCommands("What do you want to do?", { allowMultiline: true });
+  const choice = resolveWebChecksChoice(raw);
+  switch (choice) {
     case "1":
       await runWebChecksSuite();
       break;
@@ -4159,14 +4230,21 @@ async function showWebChecksMenu() {
       console.log(`  ${chalk6.cyan("2")}) Always run automatically`);
       console.log(`  ${chalk6.cyan("3")}) Never prompt`);
       console.log();
-      const modeChoice = await promptWithCommands("Select prompt mode");
+      const modeChoiceRaw = await promptWithCommands("Set mode (ask / always / never)");
+      const modeChoice = resolvePromptModeChoice(modeChoiceRaw);
       if (modeChoice === "1") await setWebPromptMode(cwd, "ask");
       if (modeChoice === "2") await setWebPromptMode(cwd, "always");
       if (modeChoice === "3") await setWebPromptMode(cwd, "never");
       break;
     }
     default:
-      break;
+      if (raw.trim()) {
+        const handled = await handleFreeformJourneyInput(cwd, raw.trim());
+        if (handled) {
+          return;
+        }
+      }
+      console.log(chalk6.yellow("I did not catch that. Tell me which web check you want."));
   }
   if (choice.toLowerCase() !== "b") {
     await showWebChecksMenu();
@@ -4228,10 +4306,24 @@ function promptChoice(question, options, defaultKey) {
       input: process.stdin,
       output: process.stdout
     });
-    rl.question(`  ${chalk6.dim("Enter choice")}: `, (answer) => {
+    rl.question(`  ${chalk6.dim("Enter choice or describe what you want")}: `, (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed) {
+        const direct = options.find((opt) => opt.key.toLowerCase() === trimmed.toLowerCase());
+        if (direct) {
+          resolve(direct.key);
+          return;
+        }
+        const normalized = trimmed.toLowerCase();
+        const keywordMatch = options.find((opt) => {
+          const labelWords = opt.label.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
+          return labelWords.some((w) => w.length > 3 && normalized.includes(w));
+        });
+        if (keywordMatch) {
+          resolve(keywordMatch.key);
+          return;
+        }
         resolve(trimmed);
         return;
       }
@@ -4243,11 +4335,44 @@ function promptChoice(question, options, defaultKey) {
     });
   });
 }
+function resolveReviewChoice(input) {
+  const normalized = input.trim().toLowerCase();
+  if (!normalized) return "";
+  if (normalized === "1" || normalized.includes("analy")) return "1";
+  if (normalized === "2" || normalized.includes("status")) return "2";
+  if (normalized === "3" || normalized.includes("next")) return "3";
+  if (normalized === "4" || normalized.includes("list")) return "4";
+  if (normalized === "5" || normalized.includes("run") || normalized.includes("all pending")) return "5";
+  if (normalized === "b" || normalized.includes("back")) return "b";
+  return normalized;
+}
+function resolveWebChecksChoice(input) {
+  const normalized = input.trim().toLowerCase();
+  if (!normalized) return "";
+  if (normalized === "1" || normalized.includes("all") && normalized.includes("check")) return "1";
+  if (normalized === "2" || normalized.includes("access") || normalized.includes("a11y")) return "2";
+  if (normalized === "3" || normalized.includes("seo")) return "3";
+  if (normalized === "4" || normalized.includes("geo") && normalized.includes("audit")) return "4";
+  if (normalized === "5" || normalized.includes("geo") && normalized.includes("identity")) return "5";
+  if (normalized === "6" || normalized.includes("geo") && normalized.includes("schema")) return "6";
+  if (normalized === "7" || normalized.includes("prompt mode") || normalized.includes("mode")) return "7";
+  if (normalized === "b" || normalized.includes("back")) return "b";
+  return normalized;
+}
+function resolvePromptModeChoice(input) {
+  const normalized = input.trim().toLowerCase();
+  if (!normalized) return "";
+  if (normalized === "1" || normalized.includes("ask")) return "1";
+  if (normalized === "2" || normalized.includes("always")) return "2";
+  if (normalized === "3" || normalized.includes("never")) return "3";
+  return normalized;
+}
 
 // src/cli/credits.ts
 import chalk7 from "chalk";
 import ora from "ora";
 import open from "open";
+import readline2 from "readline";
 function getSupabaseClient(accessToken) {
   return createAuthedSupabaseClient(SUPABASE_URL, SUPABASE_ANON_KEY, accessToken);
 }
@@ -4277,12 +4402,21 @@ async function showCredits() {
       console.log(`  Atoms:   ${profile.atoms_used_this_month}/10,000 this month`);
       console.log();
       console.log(chalk7.dim("  Upgrade to Credits tier: archon credits add"));
+      printCreditsNextAction("FREE");
     } else if (profile.tier === "CREDITS") {
       console.log();
       console.log(chalk7.dim("  Add more credits: archon credits add"));
+      printCreditsNextAction("CREDITS");
+      if (balance < 5) {
+        const addNow = await promptYesNo2("Balance is low. Add credits now?", false);
+        if (addNow) {
+          await addCredits({ amount: "10" });
+        }
+      }
     } else if (profile.tier === "BYOK") {
       console.log();
       console.log(chalk7.dim("  Using your own API keys - no credit charges"));
+      printCreditsNextAction("BYOK");
     }
     console.log();
   } catch (err2) {
@@ -4341,11 +4475,41 @@ async function addCredits(options = {}) {
     } catch {
       console.log(chalk7.yellow("  Could not open browser. Please visit the URL above."));
     }
+    console.log(chalk7.bold("\nNext best action:"));
+    console.log(chalk7.dim(`  \u2022 Complete payment in browser, then run ${chalk7.cyan("archon credits")} to verify balance.`));
+    console.log(chalk7.dim(`  \u2022 Continue work with ${chalk7.cyan('archon plan "..."')} or ${chalk7.cyan("archon execute <ATOM-ID>")}.`));
   } catch (err2) {
     spinner.fail("Error preparing checkout");
     console.error(err2);
   }
 }
+function printCreditsNextAction(tier) {
+  console.log(chalk7.bold("  Next best action:"));
+  if (tier === "CREDITS") {
+    console.log(chalk7.dim(`    \u2022 Keep at least $5 balance to avoid interruptions during plan/execute.`));
+  } else if (tier === "BYOK") {
+    console.log(chalk7.dim(`    \u2022 Manage provider keys with ${chalk7.cyan("archon keys add/list/remove")}.`));
+  } else {
+    console.log(chalk7.dim(`    \u2022 Upgrade to BYOK or Credits with ${chalk7.cyan("archon upgrade")}.`));
+  }
+}
+function promptYesNo2(question, defaultValue) {
+  return new Promise((resolve) => {
+    const rl = readline2.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    const hint = defaultValue ? "(Y/n)" : "(y/N)";
+    rl.question(`${chalk7.cyan("?")} ${question} ${hint}: `, (answer) => {
+      rl.close();
+      if (answer.trim() === "") {
+        resolve(defaultValue);
+      } else {
+        resolve(answer.toLowerCase().startsWith("y"));
+      }
+    });
+  });
+}
 async function showHistory(options = {}) {
   const spinner = ora("Fetching usage history...").start();
   try {
@@ -6225,7 +6389,7 @@ async function githubDisconnect() {
 
 // src/cli/interview.ts
 import chalk13 from "chalk";
-import readline2 from "readline";
+import readline3 from "readline";
 import ora3 from "ora";
 import { existsSync as existsSync13, readFileSync as readFileSync5, writeFileSync, mkdirSync as mkdirSync2 } from "fs";
 import { join as join13 } from "path";
@@ -6333,7 +6497,7 @@ async function interview(options = {}) {
       console.log(chalk13.red(`   \u2022 ${error}`));
     }
     console.log();
-    const fix = await promptYesNo2("Would you like to go back and fix these?", true);
+    const fix = await promptYesNo3("Would you like to go back and fix these?", true);
     if (fix) {
       await interview({ ...options, phase: 1 });
       return;
@@ -6371,7 +6535,7 @@ async function interview(options = {}) {
         console.log(`   \u2022 ${feature.name}`);
       }
       console.log();
-      const acceptDeferrals = await promptYesNo2(
+      const acceptDeferrals = await promptYesNo3(
         `Move ${challengeResult.featuresToDefer.length} feature(s) to post-MVP?`,
         true
       );
@@ -6392,7 +6556,7 @@ async function interview(options = {}) {
     if (criticalCount > 0) {
       console.log(chalk13.red(`
 \u26A0\uFE0F  ${criticalCount} critical issue(s) detected.`));
-      const proceed = await promptYesNo2("Proceed anyway?", false);
+      const proceed = await promptYesNo3("Proceed anyway?", false);
       if (!proceed) {
         saveDraft(cwd, constitution);
         console.log(chalk13.dim("\nDraft saved. Address the issues and run `archon interview` again.\n"));
@@ -6410,7 +6574,7 @@ async function interview(options = {}) {
     saveDraft(cwd, constitution);
     return;
   }
-  const confirmFreeze = await promptYesNo2("Freeze this Constitution and start building?", true);
+  const confirmFreeze = await promptYesNo3("Freeze this Constitution and start building?", true);
   if (!confirmFreeze) {
     saveDraft(cwd, constitution);
     console.log(chalk13.dim("\nDraft saved. Run `archon interview` to continue.\n"));
@@ -6491,7 +6655,7 @@ async function promptQuestion(question) {
 }
 function prompt2(question) {
   return new Promise((resolve) => {
-    const rl = readline2.createInterface({
+    const rl = readline3.createInterface({
       input: process.stdin,
       output: process.stdout
     });
@@ -6502,9 +6666,9 @@ function prompt2(question) {
     });
   });
 }
-function promptYesNo2(question, defaultValue) {
+function promptYesNo3(question, defaultValue) {
   return new Promise((resolve) => {
-    const rl = readline2.createInterface({
+    const rl = readline3.createInterface({
       input: process.stdin,
       output: process.stdout
     });
@@ -6615,7 +6779,7 @@ async function generateAtoms(options = {}) {
   const prdPath = options.output ?? join13(cwd, "prd.json");
   const prdContent = formatAsPrdJson(result, constitution);
   if (existsSync13(prdPath)) {
-    const overwrite = await promptYesNo2("prd.json already exists. Overwrite?", false);
+    const overwrite = await promptYesNo3("prd.json already exists. Overwrite?", false);
     if (!overwrite) {
       console.log(chalk13.dim("Cancelled. Existing prd.json preserved."));
       return;
@@ -6637,7 +6801,7 @@ import chalk14 from "chalk";
 import { existsSync as existsSync14, rmSync } from "fs";
 import { readFile as readFile8, writeFile as writeFile6 } from "fs/promises";
 import { join as join14 } from "path";
-import readline3 from "readline";
+import readline4 from "readline";
 var ARCHON_FILES = [
   ".archon/",
   "prd.json",
@@ -6679,7 +6843,7 @@ async function eject(options = {}) {
   }
   console.log();
   if (!options.force) {
-    const confirmed = await promptYesNo3("This will permanently remove ArchonDev from your project. Continue?", false);
+    const confirmed = await promptYesNo4("This will permanently remove ArchonDev from your project. Continue?", false);
     if (!confirmed) {
       console.log(chalk14.dim("Eject cancelled."));
       return;
@@ -6844,9 +7008,9 @@ async function ejectDryRun() {
   console.log();
   console.log(chalk14.dim('Run "archon eject" to proceed.'));
 }
-function promptYesNo3(question, defaultValue) {
+function promptYesNo4(question, defaultValue) {
   return new Promise((resolve) => {
-    const rl = readline3.createInterface({
+    const rl = readline4.createInterface({
       input: process.stdin,
       output: process.stdout
     });
@@ -6868,7 +7032,7 @@ import { execSync as execSync4 } from "child_process";
 import { existsSync as existsSync15 } from "fs";
 import { readFile as readFile9, writeFile as writeFile7 } from "fs/promises";
 import { join as join15 } from "path";
-import readline4 from "readline";
+import readline5 from "readline";
 async function findAtomCommits(limit = 50) {
   const cwd = process.cwd();
   try {
@@ -6966,7 +7130,7 @@ async function revertCommand(atomIdOrHash, options = {}) {
   } catch {
   }
   if (!options.force) {
-    const confirmed = await promptYesNo4("Revert this atom commit?", false);
+    const confirmed = await promptYesNo5("Revert this atom commit?", false);
     if (!confirmed) {
       console.log(chalk15.dim("Revert cancelled."));
       return;
@@ -7033,9 +7197,9 @@ async function revertableAtoms() {
   console.log();
   console.log(chalk15.dim("To revert: archon revert <atom-id>"));
 }
-function promptYesNo4(question, defaultValue) {
+function promptYesNo5(question, defaultValue) {
   return new Promise((resolve) => {
-    const rl = readline4.createInterface({
+    const rl = readline5.createInterface({
       input: process.stdin,
       output: process.stdout
     });