archondev 2.19.2 → 2.19.3

package/README.md

@@ -77,6 +77,7 @@ pnpm exec tsx scripts/init-governance-db.ts
 | `archon credits` | View credit balance |
 | `archon credits add` | Purchase credits |
 | `archon credits budget` | Set monthly budget and alerts |
+| `archon usage` | Usage by period and model (BYOK/Credits) |
 | `archon keys add <provider>` | Add your own API key — BYOK (Bring Your Own Key) |
 | `archon keys list` | Show configured API keys by provider |
 | `archon preferences` | Interactive settings menu (billing, models, keys, usage) |
@@ -117,6 +118,7 @@ pnpm exec tsx scripts/init-governance-db.ts
 
 **Notes:**  
 - Credits tier shows your balance and per‑model usage on startup; use `archon credits` for full details and history.  
+- BYOK shows per‑model usage and cost by today/week/month/year in `archon preferences` → “View usage details.”  
 - You can paste multi‑line requests into interactive prompts; Archon captures them as a single response.
 
 **Tip:** Use `archon plan --edit` to adjust title and acceptance criteria before planning.

package/dist/{chunk-QTBRLNZQ.js → chunk-4NP2AVJD.js}

@@ -6,7 +6,7 @@ import {
 import {
   listLocalAtoms,
   loadAtom
-} from "./chunk-ACFMKTDL.js";
+} from "./chunk-4VIBRFVY.js";
 import {
   loadConfig
 } from "./chunk-SVU7MLG6.js";

package/dist/{chunk-ACFMKTDL.js → chunk-4VIBRFVY.js}

@@ -851,6 +851,13 @@ async function plan(description, options) {
         requirements.length = 0;
       }
     }
+    const classification = classifyTaskIntent({
+      description,
+      requirements,
+      references,
+      deliverableTarget: deliverableTarget ?? void 0
+    });
+    const isContentOnlyTask = classification.kind === "content";
     console.log(chalk.dim("Creating atom from description..."));
     const atomInput = parseAtomDescription(description, options, requirements);
     const atom = createAtom(atomInput, {
@@ -872,6 +879,26 @@ async function plan(description, options) {
 Atom created: ${atom.externalId}`));
     console.log(chalk.dim(`Title: ${atom.title}`));
     console.log(chalk.dim(`Acceptance Criteria: ${atom.acceptanceCriteria.length} items`));
+    if (isContentOnlyTask) {
+      console.log(chalk.blue("\nContent task detected. Creating a lightweight plan (no adversarial loop)."));
+      atom.plan = buildContentPlan({
+        description,
+        requirements,
+        referencedFiles: references,
+        deliverableTarget,
+        missingFiles
+      });
+      atom.status = "READY";
+      await saveAtom(atom);
+      console.log(chalk.green(`
+\u2705 Atom saved: ${atom.externalId}`));
+      console.log(chalk.dim(`Status: ${atom.status}`));
+      console.log(chalk.dim(`
+Next steps:`));
+      console.log(chalk.dim(`  - Execute: archon execute ${atom.externalId}`));
+      console.log(chalk.dim(`  - View: archon show ${atom.externalId}`));
+      return;
+    }
     let apiKey = process.env["ANTHROPIC_API_KEY"];
     if (!apiKey) {
       const keyManager = new KeyManager();
@@ -926,8 +953,56 @@ Atom saved: ${atom.externalId}`));
           }
         }
       }
+      const shouldAutoFallback = shouldFallbackToContentPlan({
+        classification,
+        description,
+        issues: planResult.iterations.flatMap(
+          (iteration) => iteration.validation.passed ? [] : iteration.validation.issues.map((issue) => issue.message)
+        )
+      });
+      if (shouldAutoFallback) {
+        console.log(chalk.blue("\nTask looks content-focused. Switching to lightweight plan."));
+        atom.plan = buildContentPlan({
+          description,
+          requirements,
+          referencedFiles: references,
+          deliverableTarget,
+          missingFiles
+        });
+        atom.status = "READY";
+        await saveAtom(atom);
+        console.log(chalk.green(`
+\u2705 Atom saved: ${atom.externalId}`));
+        console.log(chalk.dim(`Status: ${atom.status}`));
+        console.log(chalk.dim(`
+Next steps:`));
+        console.log(chalk.dim(`  - Execute: archon execute ${atom.externalId}`));
+        console.log(chalk.dim(`  - View: archon show ${atom.externalId}`));
+        return;
+      }
       const answer2 = await prompt.ask("\nSave as draft anyway? (y/N): ");
-      if (answer2.toLowerCase() !== "y") {
+      const normalized = answer2.toLowerCase();
+      if (normalized.includes("wrong") || normalized.includes("content") || normalized.includes("not a code")) {
+        console.log(chalk.blue("\nReclassifying as content task and creating a lightweight plan."));
+        atom.plan = buildContentPlan({
+          description,
+          requirements,
+          referencedFiles: references,
+          deliverableTarget,
+          missingFiles
+        });
+        atom.status = "READY";
+        await saveAtom(atom);
+        console.log(chalk.green(`
+\u2705 Atom saved: ${atom.externalId}`));
+        console.log(chalk.dim(`Status: ${atom.status}`));
+        console.log(chalk.dim(`
+Next steps:`));
+        console.log(chalk.dim(`  - Execute: archon execute ${atom.externalId}`));
+        console.log(chalk.dim(`  - View: archon show ${atom.externalId}`));
+        return;
+      }
+      if (normalized !== "y") {
         console.log(chalk.dim("Atom discarded."));
         return;
       }
@@ -1029,6 +1104,100 @@ function extractNumberedRequirements(description) {
   }
   return requirements;
 }
+function extractNumberedSteps(description) {
+  const steps = [];
+  const lines = description.split("\n");
+  for (const line of lines) {
+    const match = line.match(/^\s*(\d+)[\).]\s+(.+)$/);
+    if (match && match[2]) {
+      steps.push(match[2].trim());
+    }
+  }
+  return steps;
+}
+function classifyTaskIntent(input) {
+  const text = `${input.description}
+${input.requirements.join("\n")}`.toLowerCase();
+  const signals = [];
+  let contentScore = 0;
+  let codeScore = 0;
+  const contentCues = [
+    /story|storytelling|storyboard|capsule|lesson|outline|narrative|plot|arc|character|conflict/,
+    /illustration|visual|image|diagram|slides?|deck/,
+    /write|draft|summarize|summarise|rewrite|edit|revise|polish/,
+    /teach|teaching|curriculum|learning objectives?|lesson plan/
+  ];
+  const codeCues = [
+    /api|endpoint|server|backend|frontend|cli|database|schema|migration/,
+    /typescript|javascript|python|go|rust|java|c\+\+|react|node/,
+    /implement|refactor|compile|build|deploy|test|lint|ci/
+  ];
+  for (const cue of contentCues) {
+    if (cue.test(text)) {
+      contentScore += 2;
+      signals.push(`content:${cue.source}`);
+    }
+  }
+  for (const cue of codeCues) {
+    if (cue.test(text)) {
+      codeScore += 2;
+      signals.push(`code:${cue.source}`);
+    }
+  }
+  const references = [...input.references];
+  if (input.deliverableTarget) references.push(input.deliverableTarget);
+  const contentRefs = references.filter((ref) => /\.(md|markdown|txt|rtf|pdf|png|jpg|jpeg|gif|svg|webp)$/i.test(ref));
+  const codeRefs = references.filter((ref) => /\.(ts|tsx|js|jsx|mjs|cjs|py|go|rs|java|kt|cpp|c|h|sql|json|yml|yaml)$/i.test(ref));
+  if (contentRefs.length > 0 && codeRefs.length === 0) {
+    contentScore += 2;
+    signals.push("content:refs");
+  }
+  if (codeRefs.length > 0) {
+    codeScore += 2;
+    signals.push("code:refs");
+  }
+  let kind = "mixed";
+  let confidence = "low";
+  if (contentScore >= 4 && contentScore >= codeScore + 2) {
+    kind = "content";
+    confidence = contentScore >= 6 ? "high" : "medium";
+  } else if (codeScore >= 4 && codeScore >= contentScore + 2) {
+    kind = "code";
+    confidence = codeScore >= 6 ? "high" : "medium";
+  }
+  return { kind, confidence, contentScore, codeScore, signals };
+}
+function shouldFallbackToContentPlan(input) {
+  if (input.classification.kind === "content") return true;
+  const text = input.description.toLowerCase();
+  const issueText = input.issues.join(" ").toLowerCase();
+  const contentLike = /story|storytelling|capsule|lesson|outline|storyboard|illustration|visual|image/.test(text);
+  const engineeringBlockers = /api|pipeline|module|interfaces|schema|database|timeout|rate limit|retry|cache|rollback|tests?/.test(issueText);
+  if (contentLike && engineeringBlockers && input.classification.contentScore >= input.classification.codeScore) {
+    return true;
+  }
+  return false;
+}
+function buildContentPlan(input) {
+  const stepsFromNumbering = extractNumberedSteps(input.description);
+  const stepsFromRequirements = input.requirements.map((req) => `Create: ${req}`);
+  const steps = stepsFromNumbering.length > 0 ? stepsFromNumbering : stepsFromRequirements.length > 0 ? stepsFromRequirements : ["Draft a clear outline", "Write the content", "Review and refine", "Finalize deliverable"];
+  const files = /* @__PURE__ */ new Set();
+  input.referencedFiles.forEach((f) => files.add(f));
+  if (input.deliverableTarget) files.add(input.deliverableTarget);
+  const risks = [];
+  if (input.missingFiles.length > 0) {
+    risks.push(`Missing inputs: ${input.missingFiles.join(", ")}`);
+  }
+  risks.push("Source material may be incomplete; validate against lesson content.");
+  return {
+    steps,
+    files_to_modify: Array.from(files),
+    dependencies: [],
+    risks,
+    estimated_complexity: steps.length > 6 ? "MEDIUM" : "LOW"
+  };
+}
 function extractReferencedFiles(description) {
   const references = /* @__PURE__ */ new Set();
   const barePattern = /\b[\w./-]+\.(md|txt|json|yaml|yml|png|jpg|jpeg|gif|svg|pdf)\b/gi;

package/dist/{chunk-YA562WHL.js → chunk-6G4S6B5M.js}

@@ -1,6 +1,6 @@
 import {
   listLocalAtoms
-} from "./chunk-ACFMKTDL.js";
+} from "./chunk-4VIBRFVY.js";
 
 // src/cli/list.ts
 import chalk from "chalk";

package/dist/{chunk-OREGEFTF.js → chunk-F7U5AURY.js}

@@ -6,7 +6,7 @@ import {
 import {
   UsageRecorder,
   loadAtom
-} from "./chunk-ACFMKTDL.js";
+} from "./chunk-4VIBRFVY.js";
 import {
   transitionAtom
 } from "./chunk-PCTP3LKJ.js";
@@ -4793,7 +4793,7 @@ function createPrompt() {
 }
 async function execute(atomId, options) {
   if (options.parallel && options.parallel.length > 0) {
-    const { parallelExecute } = await import("./parallel-23VQYK7H.js");
+    const { parallelExecute } = await import("./parallel-5Z2X2FDD.js");
     const allAtomIds = [atomId, ...options.parallel];
     await parallelExecute(allAtomIds, { skipGates: options.skipGates === true });
     return;

package/dist/{chunk-CTWVQ6F3.js → chunk-K3XN7PN6.js}

@@ -1,3 +1,6 @@
+import {
+  createAuthedSupabaseClient
+} from "./chunk-Q3GIFHIQ.js";
 import {
   findModel,
   getAllActiveModels,
@@ -15,6 +18,10 @@ import {
 import {
   login
 } from "./chunk-F4OUCZPN.js";
+import {
+  SUPABASE_ANON_KEY,
+  SUPABASE_URL
+} from "./chunk-M4LGRTLC.js";
 import {
   getApiUrl,
   getAuthToken,
@@ -783,7 +790,7 @@ async function interactiveSettings() {
       await interactiveSettings();
       break;
     case "4":
-      await viewUsageDetails();
+      await showUsageDetails();
       await interactiveSettings();
       break;
     case "5":
@@ -1083,11 +1090,12 @@ async function manageApiKeys() {
     await addKey(provider);
   }
 }
-async function viewUsageDetails() {
+async function showUsageDetails() {
   console.log(chalk.bold("\n-- Usage Details --\n"));
   const spinner = ora("Loading usage data...").start();
   const config = await loadConfig();
   const authToken = getAuthToken(config);
+  const authId = config.userId;
   if (!authToken) {
     spinner.fail("Not logged in");
     return;
@@ -1103,36 +1111,112 @@ async function viewUsageDetails() {
       return;
     }
     const data = await response.json();
-    console.log(chalk.blue("Current Billing Period:"));
-    console.log(`  ${data.periodStart} to ${data.periodEnd}`);
-    console.log();
-    console.log(chalk.blue("Token Usage:"));
-    console.log(`  Input:  ${formatTokens(data.totalInputTokens)} tokens`);
-    console.log(`  Output: ${formatTokens(data.totalOutputTokens)} tokens`);
-    console.log(`  Total:  ${formatTokens(data.totalInputTokens + data.totalOutputTokens)} tokens`);
-    console.log();
-    console.log(chalk.blue("Cost:"));
-    console.log(`  Base Cost:      ${formatCost(data.totalBaseCost)}`);
-    if (data.tier === "CREDITS") {
-      const withFee = data.totalBaseCost * 1.1;
-      console.log(`  With 10% Fee:   ${formatCost(withFee)}`);
-    } else if (data.tier === "BYOK") {
-      console.log(chalk.dim("  (Paid directly to your provider)"));
-    }
-    if (data.byModel && Object.keys(data.byModel).length > 0) {
-      console.log();
-      console.log(chalk.blue("By Model:"));
-      for (const [model, stats] of Object.entries(data.byModel)) {
-        const modelInfo = findModel(model);
-        const name = modelInfo?.name ?? model;
-        console.log(`  ${name}: ${formatTokens(stats.inputTokens + stats.outputTokens)} tokens (${formatCost(stats.cost)})`);
+    if (data.tier === "BYOK") {
+      if (!authId) {
+        console.log(chalk.yellow("Unable to resolve user ID for usage details."));
+        return;
       }
-    }
-    if (data.byOperation && Object.keys(data.byOperation).length > 0) {
+      const supabase = createAuthedSupabaseClient(SUPABASE_URL, SUPABASE_ANON_KEY, authToken);
+      const { data: profileRow, error: profileError } = await supabase.from("user_profiles").select("id").eq("auth_id", authId).single();
+      if (profileError || !profileRow?.id) {
+        console.log(chalk.yellow("Unable to resolve profile for usage details."));
+        return;
+      }
+      const profileId = profileRow.id;
+      const now = /* @__PURE__ */ new Date();
+      const yearStart = new Date(now.getFullYear(), 0, 1);
+      const { data: usageRows, error } = await supabase.from("token_usage").select("model, input_tokens, output_tokens, base_cost, created_at").eq("user_id", profileId).gte("created_at", yearStart.toISOString()).lte("created_at", now.toISOString());
+      if (error || !usageRows) {
+        console.log(chalk.yellow("Unable to fetch BYOK usage data."));
+        return;
+      }
+      const rows = usageRows;
+      const startOfToday = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+      const startOfWeek = new Date(now.getFullYear(), now.getMonth(), now.getDate() - now.getDay());
+      const startOfMonth = new Date(now.getFullYear(), now.getMonth(), 1);
+      const periods = [
+        { label: "Today", start: startOfToday, end: now },
+        { label: "Week to Date (Sun\u2013Sat)", start: startOfWeek, end: now },
+        { label: "Month to Date", start: startOfMonth, end: now },
+        { label: "Year to Date", start: yearStart, end: now }
+      ];
+      const aggregate = (start, end) => {
+        let totalInputTokens = 0;
+        let totalOutputTokens = 0;
+        let totalCost = 0;
+        const byModelMap = /* @__PURE__ */ new Map();
+        for (const row of rows) {
+          const ts = new Date(row.created_at);
+          if (ts < start || ts > end) continue;
+          totalInputTokens += row.input_tokens;
+          totalOutputTokens += row.output_tokens;
+          totalCost += row.base_cost;
+          const existing = byModelMap.get(row.model);
+          if (existing) {
+            existing.inputTokens += row.input_tokens;
+            existing.outputTokens += row.output_tokens;
+            existing.cost += row.base_cost;
+          } else {
+            byModelMap.set(row.model, {
+              inputTokens: row.input_tokens,
+              outputTokens: row.output_tokens,
+              cost: row.base_cost
+            });
+          }
+        }
+        const byModel = Array.from(byModelMap.entries()).map(([model, stats]) => ({ model, ...stats })).sort((a, b) => b.cost - a.cost);
+        return { totalInputTokens, totalOutputTokens, totalCost, byModel };
+      };
+      console.log(chalk.blue("BYOK Usage (local time):"));
+      for (const period of periods) {
+        const summary = aggregate(period.start, period.end);
+        console.log();
+        console.log(chalk.bold(`${period.label}:`));
+        console.log(`  ${period.start.toLocaleDateString()} \u2192 ${period.end.toLocaleDateString()}`);
+        console.log(`  Tokens: ${formatTokens(summary.totalInputTokens + summary.totalOutputTokens)} (in ${formatTokens(summary.totalInputTokens)} / out ${formatTokens(summary.totalOutputTokens)})`);
+        console.log(`  Cost:   ${formatCost(summary.totalCost)} ${chalk.dim("(paid directly to provider)")}`);
+        if (summary.byModel.length > 0) {
+          console.log(chalk.dim("  By Model:"));
+          for (const model of summary.byModel) {
+            const modelInfo = findModel(model.model);
+            const name = modelInfo?.name ?? model.model;
+            const tokenTotal = model.inputTokens + model.outputTokens;
+            console.log(`    ${name}: ${formatTokens(tokenTotal)} tokens (${formatCost(model.cost)})`);
+          }
+        } else {
+          console.log(chalk.dim("  No usage recorded."));
+        }
+      }
+    } else {
+      console.log(chalk.blue("Current Billing Period:"));
+      console.log(`  ${data.periodStart} to ${data.periodEnd}`);
+      console.log();
+      console.log(chalk.blue("Token Usage:"));
+      console.log(`  Input:  ${formatTokens(data.totalInputTokens)} tokens`);
+      console.log(`  Output: ${formatTokens(data.totalOutputTokens)} tokens`);
+      console.log(`  Total:  ${formatTokens(data.totalInputTokens + data.totalOutputTokens)} tokens`);
       console.log();
-      console.log(chalk.blue("By Operation:"));
-      for (const [op, stats] of Object.entries(data.byOperation)) {
-        console.log(`  ${op}: ${formatTokens(stats.tokenCount)} tokens (${formatCost(stats.cost)})`);
+      console.log(chalk.blue("Cost:"));
+      console.log(`  Base Cost:      ${formatCost(data.totalBaseCost)}`);
+      if (data.tier === "CREDITS") {
+        const withFee = data.totalBaseCost * 1.1;
+        console.log(`  With 10% Fee:   ${formatCost(withFee)}`);
+      }
+      if (data.byModel && data.byModel.length > 0) {
+        console.log();
+        console.log(chalk.blue("By Model:"));
+        for (const stats of data.byModel) {
+          const modelInfo = findModel(stats.model);
+          const name = modelInfo?.name ?? stats.model;
+          console.log(`  ${name}: ${formatTokens(stats.inputTokens + stats.outputTokens)} tokens (${formatCost(stats.cost)})`);
+        }
+      }
+      if (data.byOperation && data.byOperation.length > 0) {
+        console.log();
+        console.log(chalk.blue("By Operation:"));
+        for (const stats of data.byOperation) {
+          console.log(`  ${stats.operation}: ${formatTokens(stats.tokenCount)} tokens (${formatCost(stats.cost)})`);
+        }
       }
     }
   } catch {
@@ -1151,5 +1235,6 @@ export {
   setPreference,
   resetPreferences,
   listModels,
-  interactiveSettings
+  interactiveSettings,
+  showUsageDetails
 };

package/dist/{execute-ZTJGSRBW.js → execute-ST5ES4XI.js}

@@ -1,8 +1,8 @@
 import {
   execute
-} from "./chunk-OREGEFTF.js";
+} from "./chunk-F7U5AURY.js";
 import "./chunk-EBHHIUCB.js";
-import "./chunk-ACFMKTDL.js";
+import "./chunk-4VIBRFVY.js";
 import "./chunk-PCTP3LKJ.js";
 import "./chunk-PJRQI5UN.js";
 import "./chunk-EIEU3IIY.js";

package/dist/index.js

@@ -26,8 +26,9 @@ import {
   setExecutionPreference,
   setPreference,
   showExecutionPreferences,
-  showPreferences
-} from "./chunk-CTWVQ6F3.js";
+  showPreferences,
+  showUsageDetails
+} from "./chunk-K3XN7PN6.js";
 import {
   a11yBadge,
   a11yCheck,
@@ -46,13 +47,13 @@ import {
   parallelRunWaves,
   parallelSchedule,
   parallelStatus
-} from "./chunk-QTBRLNZQ.js";
+} from "./chunk-4NP2AVJD.js";
 import {
   DependencyParser,
   EnvironmentConfigLoader,
   EnvironmentValidator,
   execute
-} from "./chunk-OREGEFTF.js";
+} from "./chunk-F7U5AURY.js";
 import {
   cloudCancel,
   cloudLogs,
@@ -60,12 +61,12 @@ import {
 } from "./chunk-EBHHIUCB.js";
 import {
   list
-} from "./chunk-YA562WHL.js";
+} from "./chunk-6G4S6B5M.js";
 import {
   listLocalAtoms,
   loadAtom,
   plan
-} from "./chunk-ACFMKTDL.js";
+} from "./chunk-4VIBRFVY.js";
 import "./chunk-PCTP3LKJ.js";
 import "./chunk-PJRQI5UN.js";
 import {
@@ -3184,7 +3185,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-HCYXLSSD.js");
+    const { plan: plan2 } = await import("./plan-XPUDPLT2.js");
     await plan2(initialResponse, {});
     return;
   }
@@ -3208,7 +3209,7 @@ async function handleNewProject(cwd, _state) {
         break;
       case "2":
         console.log(chalk6.dim("\n> Creating a task for this...\n"));
-        const { plan: plan2 } = await import("./plan-HCYXLSSD.js");
+        const { plan: plan2 } = await import("./plan-XPUDPLT2.js");
         await plan2(initialResponse, {});
         break;
       case "3":
@@ -3238,7 +3239,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-HCYXLSSD.js");
+        const { plan: plan2 } = await import("./plan-XPUDPLT2.js");
         await plan2(description, {});
       }
       break;
@@ -3304,7 +3305,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-HCYXLSSD.js");
+        const { plan: plan2 } = await import("./plan-XPUDPLT2.js");
         await plan2(description, {});
       }
       break;
@@ -3566,7 +3567,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-HCYXLSSD.js");
+      const { plan: plan2 } = await import("./plan-XPUDPLT2.js");
       await plan2(description, {});
     }
   }
@@ -3620,7 +3621,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-HCYXLSSD.js");
+    const { plan: plan2 } = await import("./plan-XPUDPLT2.js");
     await plan2(response, {});
     return;
   }
@@ -3651,7 +3652,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-HCYXLSSD.js");
+        const { plan: plan2 } = await import("./plan-XPUDPLT2.js");
         await plan2(description, {});
       }
       break;
@@ -3799,10 +3800,26 @@ async function showMainMenu() {
   }
   console.log(chalk6.dim('  (Type "upgrade" or "help" anytime)'));
   console.log();
-  const selected = await promptWithCommands("Enter choice");
+  const selected = await promptWithCommands("Enter choice", { 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;
+    }
+    console.log(chalk6.dim("\n> Got it! Creating a task for this...\n"));
+    const { plan: plan2 } = await import("./plan-XPUDPLT2.js");
+    await plan2(freeform, {});
   } else {
     console.log(chalk6.yellow("Invalid choice. Please try again."));
     await showMainMenu();
@@ -3827,20 +3844,20 @@ async function showReviewProgress(cwd) {
   }
 }
 async function planTask() {
-  const { plan: plan2 } = await import("./plan-HCYXLSSD.js");
+  const { plan: plan2 } = await import("./plan-XPUDPLT2.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-REPLUXJF.js");
+  const { list: list2 } = await import("./list-GVC7CI5U.js");
   await list2({});
 }
 async function executeNext() {
-  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-HCYXLSSD.js");
+  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-XPUDPLT2.js");
   const { analyzeProject, getComplexityDescription, getModeDescription } = await import("./orchestration-HIF3KP25.js");
-  const { loadExecutionPreferences } = await import("./preferences-OAOZCZGR.js");
+  const { loadExecutionPreferences } = await import("./preferences-SFXRVXT3.js");
   const cwd = process.cwd();
   const atoms = await listLocalAtoms2();
   const pendingAtoms = atoms.filter((a) => a.status === "READY" || a.status === "IN_PROGRESS");
@@ -3909,11 +3926,11 @@ async function executeNext() {
         }
       }
       if (selectedMode === "parallel-cloud") {
-        const { parallelExecuteCloud: parallelExecuteCloud2 } = await import("./parallel-23VQYK7H.js");
+        const { parallelExecuteCloud: parallelExecuteCloud2 } = await import("./parallel-5Z2X2FDD.js");
         await parallelExecuteCloud2(runIds);
         return;
       }
-      const { parallelExecute } = await import("./parallel-23VQYK7H.js");
+      const { parallelExecute } = await import("./parallel-5Z2X2FDD.js");
       await parallelExecute(runIds);
       return;
     }
@@ -3921,7 +3938,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-ZTJGSRBW.js");
+    const { execute: execute2 } = await import("./execute-ST5ES4XI.js");
     await execute2(targetId, {});
   } else {
     console.log(chalk6.yellow("No atom to execute."));
@@ -3939,7 +3956,7 @@ async function viewStatus() {
   await status2();
 }
 async function settingsMenu() {
-  const { interactiveSettings } = await import("./preferences-OAOZCZGR.js");
+  const { interactiveSettings } = await import("./preferences-SFXRVXT3.js");
   await interactiveSettings();
   await showMainMenu();
 }
@@ -8243,6 +8260,9 @@ creditsCommand.command("audit").description("Show billing audit log (immutable r
 creditsCommand.action(async () => {
   await showCredits();
 });
+program.command("usage").description("Show usage by period and model").action(async () => {
+  await showUsageDetails();
+});
 var preferencesCommand = program.command("preferences").description("Manage default model preferences");
 preferencesCommand.command("set <key> <model>").description("Set a model preference (fast-model, thinking-model, primary-adversarial, secondary-adversarial)").action(async (key, model) => {
   await setPreference(key, model);

package/dist/{list-REPLUXJF.js → list-GVC7CI5U.js}

@@ -1,7 +1,7 @@
 import {
   list
-} from "./chunk-YA562WHL.js";
-import "./chunk-ACFMKTDL.js";
+} from "./chunk-6G4S6B5M.js";
+import "./chunk-4VIBRFVY.js";
 import "./chunk-PCTP3LKJ.js";
 import "./chunk-PJRQI5UN.js";
 import "./chunk-EIEU3IIY.js";

package/dist/{parallel-23VQYK7H.js → parallel-5Z2X2FDD.js}

@@ -6,9 +6,9 @@ import {
   parallelRunWaves,
   parallelSchedule,
   parallelStatus
-} from "./chunk-QTBRLNZQ.js";
+} from "./chunk-4NP2AVJD.js";
 import "./chunk-EBHHIUCB.js";
-import "./chunk-ACFMKTDL.js";
+import "./chunk-4VIBRFVY.js";
 import "./chunk-PCTP3LKJ.js";
 import "./chunk-PJRQI5UN.js";
 import "./chunk-EIEU3IIY.js";

package/dist/{plan-HCYXLSSD.js → plan-XPUDPLT2.js}

@@ -3,7 +3,7 @@ import {
   loadAtom,
   parseAtomDescription,
   plan
-} from "./chunk-ACFMKTDL.js";
+} from "./chunk-4VIBRFVY.js";
 import "./chunk-PCTP3LKJ.js";
 import "./chunk-PJRQI5UN.js";
 import "./chunk-EIEU3IIY.js";

package/dist/{preferences-OAOZCZGR.js → preferences-SFXRVXT3.js}

@@ -6,8 +6,10 @@ import {
   setExecutionPreference,
   setPreference,
   showExecutionPreferences,
-  showPreferences
-} from "./chunk-CTWVQ6F3.js";
+  showPreferences,
+  showUsageDetails
+} from "./chunk-K3XN7PN6.js";
+import "./chunk-Q3GIFHIQ.js";
 import "./chunk-UFR2LX6G.js";
 import "./chunk-TFSHS7EN.js";
 import "./chunk-RDG5BUED.js";
@@ -24,5 +26,6 @@ export {
   setExecutionPreference,
   setPreference,
   showExecutionPreferences,
-  showPreferences
+  showPreferences,
+  showUsageDetails
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archondev",
-  "version": "2.19.2",
+  "version": "2.19.3",
   "description": "Local-first AI-powered development governance system",
   "main": "dist/index.js",
   "bin": {