aether-code 0.43.1 → 0.43.3

package/src/repl.js

@@ -1,408 +1,441 @@
-// Interactive REPL — Claude-CLI-style. Launched when `aether-code` is run
-// without a task argument.
-
-import path from "node:path";
-import { runAgent } from "./agent.js";
-import { fetchBalance, AetherError } from "./api.js";
-import { runSetup } from "./setup.js";
-import { c, errorLine, turnStats } from "./render.js";
-import { autoUpdate } from "./update-check.js";
-import { promptBox, EXIT_SIGNAL } from "./box-input.js";
-
-const VERSION = "0.43.1";
-const MODEL_NAME = "Aether Core";
-
-const MODEL_ALIASES = {
-  core: { id: null, name: "Aether Core" },
-  gemma: { id: null, name: "Aether Core" },
-  ultra: { id: "claude-opus-4-6", name: "Aether Ultra" },
-  opus: { id: "claude-opus-4-6", name: "Aether Ultra" },
-};
-
-const SHORTCUTS = `
-  ${c.cyan("/help")}       Show this help
-  ${c.cyan("/exit")}       Exit (or Ctrl+C twice)
-  ${c.cyan("/clear")}      Clear conversation history
-  ${c.cyan("/balance")}    Show credit balance
-  ${c.cyan("/cwd")} ${c.gray("[path]")}     Show or change working directory
-  ${c.cyan("/yes")}        Toggle auto-accept mode (skip confirmations)
-  ${c.cyan("/turns")} ${c.gray("<n>")}      Set max agent turns per prompt (default 25)
-  ${c.cyan("/model")} ${c.gray("[name]")}   Switch model ${c.gray("(core | ultra)")}
-
-${c.dim("Anything else is sent as your next message. History persists until /clear.")}
-`;
-
-const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
-
-function getVisibleRows() {
-  let rows = process.stdout.rows || 24;
-  if (process.platform === "win32" && !process.env.WT_SESSION && rows > 60) {
-    rows = 24;
-  }
-  return rows;
-}
-
-function pushPromptToBottom(contentLines) {
-  const visibleRows = getVisibleRows();
-  const promptHeight = 4;
-  const gap = Math.max(0, visibleRows - contentLines - promptHeight);
-  if (gap > 0) process.stdout.write("\n".repeat(gap));
-}
-
-function drawStaticPrompt(startRow, state) {
-  const termCols = process.stdout.columns || 80;
-  const ruleStr = `\x1b[36m${"─".repeat(Math.max(0, termCols))}\x1b[0m`;
-  const modeStr = state.autoYes ? "auto-accept" : "confirm writes";
-  const blkFn = (code) => `\x1b[${code}m \x1b[0m`;
-  const statusBar = blkFn("48;2;209;107;52") + blkFn("48;2;0;178;169") +
-    `\x1b[2m ${modeStr} \xB7 /help for shortcuts \xB7 @file to include\x1b[0m`;
-  process.stdout.write(
-    `\x1b[${startRow};1H` +
-    ruleStr + "\n" +
-    `\x1b[2m> \x1b[0m` + "\n" +
-    ruleStr + "\n" +
-    statusBar,
-  );
-}
-
-export async function runRepl({ cwd: initialCwd, autoYes: initialAutoYes, unsafePaths: initialUnsafePaths, maxTurns: initialMaxTurns, model: initialModel = null, mcpManager = null }) {
-  const initialAlias = Object.values(MODEL_ALIASES).find((a) => a.id === initialModel);
-  const state = {
-    cwd: initialCwd,
-    autoYes: !!initialAutoYes,
-    unsafePaths: !!initialUnsafePaths,
-    maxTurns: initialMaxTurns ?? 25,
-    model: initialModel ?? null,
-    modelName: initialAlias?.name ?? MODEL_NAME,
-    messages: [],
-    balance: null,
-    sessionCredits: 0,
-    sessionIn: 0,
-    sessionOut: 0,
-  };
-
-  const updatePromise = autoUpdate().catch(() => null);
-
-  let needsSetup = false;
-  try {
-    const me = await fetchBalance();
-    state.balance = me.balance;
-    state.plan = me.plan || "FREE";
-  } catch (err) {
-    if (err instanceof AetherError && (err.code === "NO_API_KEY" || err.status === 401)) {
-      needsSetup = true;
-    } else {
-      console.log(c.gray(`(could not fetch balance: ${err.message})`));
-    }
-  }
-
-  if (needsSetup) {
-    const ok = await runSetup();
-    if (!ok) {
-      console.log(c.gray("Aborting — no valid API key."));
-      process.exit(1);
-    }
-    try {
-      const me = await fetchBalance();
-      state.balance = me.balance;
-      state.plan = me.plan || "FREE";
-    } catch { /* tolerate */ }
-  }
-
-  // Clear screen — clean start, no leftover shell text (matches Claude Code)
-  process.stdout.write("\x1b[2J\x1b[H");
-
-  const bannerLineCount = printBanner(state);
-
-  const updateMsg = await updatePromise;
-  let extraLines = 0;
-  if (updateMsg) { console.log(updateMsg); extraLines++; }
-
-  pushPromptToBottom(bannerLineCount + extraLines);
-
-  const inputHistory = [];
-
-  const handlePromptResize = () => {
-    const vr = getVisibleRows();
-    process.stdout.write("\x1b[2J\x1b[H");
-    printBanner(state);
-    process.stdout.write(`\x1b[${Math.max(1, vr - 3)};1H`);
-  };
-
-  while (true) {
-    const raw = await promptBox({ history: inputHistory, mode: state.autoYes ? "auto-yes" : "review", suppressEcho: true, onResize: handlePromptResize });
-    if (raw === EXIT_SIGNAL) { console.log(c.gray("bye.")); return; }
-    const line = (raw ?? "").trim();
-    if (!line) continue;
-
-    inputHistory.push(line);
-
-    if (line.startsWith("/") || line === "?") {
-      const handled = await handleSlash(line, state);
-      if (handled === "exit") return;
-      continue;
-    }
-
-    // Build banner + echo as one buffer, write atomically (no flash, no garbling)
-    const bLines = buildBannerLines(state);
-    const echoDisplay = line.length > 200 ? line.slice(0, 197) + "..." : line;
-    const echoCols = process.stdout.columns || 80;
-    const echoLen = echoDisplay.length + 2;
-    const echoPad = Math.max(0, echoCols - echoLen);
-    const echoBar = `\x1b[48;5;236m  ${echoDisplay}${" ".repeat(echoPad)}\x1b[0m`;
-
-    const vr = getVisibleRows();
-    let scrollEnd = Math.max(4, vr - 4);
-    let promptRow = scrollEnd + 1;
-
-    // Clear screen, print banner + echo, draw static prompt at bottom,
-    // then set scroll region so agent output stays above the prompt.
-    process.stdout.write(
-      "\x1b[r" +
-      "\x1b[2J\x1b[H" +
-      bLines.join("\n") + "\n" + echoBar + "\n",
-    );
-    drawStaticPrompt(promptRow, state);
-
-    const agentRow = Math.min(bLines.length + 2, scrollEnd);
-    process.stdout.write(`\x1b[1;${scrollEnd}r\x1b[${agentRow};1H`);
-
-    const onResize = () => {
-      const newVr = getVisibleRows();
-      const newScrollEnd = Math.max(4, newVr - 4);
-      const newPromptRow = newScrollEnd + 1;
-      process.stdout.write(
-        "\x1b7" +
-        "\x1b[r" +
-        `\x1b[${promptRow};1H\x1b[J`,
-      );
-      drawStaticPrompt(newPromptRow, state);
-      process.stdout.write(
-        `\x1b[1;${newScrollEnd}r` +
-        "\x1b8",
-      );
-      scrollEnd = newScrollEnd;
-      promptRow = newPromptRow;
-    };
-    process.stdout.on("resize", onResize);
-
-    const t0 = Date.now();
-    let result;
-    try {
-      result = await runAgent({
-        initialPrompt: line,
-        priorMessages: state.messages.length > 0 ? state.messages : undefined,
-        cwd: state.cwd,
-        autoYes: state.autoYes,
-        unsafePaths: state.unsafePaths,
-        model: state.model,
-        maxTurns: state.maxTurns,
-        mcpManager,
-      });
-    } finally {
-      process.stdout.removeListener("resize", onResize);
-      process.stdout.write("\x1b[r");
-    }
-    const elapsed = Date.now() - t0;
-
-    state.sessionCredits += result.totalCredits ?? 0;
-    state.sessionIn += result.totalIn ?? 0;
-    state.sessionOut += result.totalOut ?? 0;
-    if (typeof result.balance === "number") state.balance = result.balance;
-    if (result.messages) state.messages = result.messages;
-
-    if (!result.ok && result.error) {
-      console.log("\n" + errorLine(result.error.message || String(result.error)));
-    }
-
-    const stats = turnStats({
-      elapsed,
-      tokensIn: 0,
-      tokensOut: 0,
-      tools: 0,
-      credits: result.totalCredits ?? 0,
-    });
-    if (stats) console.log(stats);
-    console.log("");
-
-    // Position cursor at prompt area for the interactive prompt
-    process.stdout.write(`\x1b[${promptRow};1H\x1b[J`);
-  }
-}
-
-/* ───────── slash commands ───────── */
-
-async function handleSlash(line, state) {
-  const [cmd, ...rest] = line.replace(/^\//, "").split(/\s+/);
-  const arg = rest.join(" ").trim();
-
-  switch ((cmd || "").toLowerCase()) {
-    case "":
-    case "help":
-    case "?":
-      console.log(SHORTCUTS);
-      break;
-    case "exit":
-    case "quit":
-    case "q":
-      console.log(c.gray("bye."));
-      return "exit";
-    case "clear":
-      state.messages = [];
-      state.sessionCredits = 0;
-      state.sessionIn = 0;
-      state.sessionOut = 0;
-      console.log(c.gray("Conversation cleared."));
-      break;
-    case "balance": {
-      try {
-        const me = await fetchBalance();
-        state.balance = me.balance;
-        state.plan = me.plan || "FREE";
-        console.log(
-          c.cyan(`balance: ${me.balance.toLocaleString()} credits`) +
-            c.gray(` \xB7 plan: ${me.plan || "FREE"} (${me.planCredits ?? 0} plan + ${me.topupCredits ?? 0} topup)`),
-        );
-      } catch (err) {
-        console.log(errorLine(err.message || String(err)));
-      }
-      break;
-    }
-    case "cwd":
-      if (arg) {
-        const next = path.resolve(arg);
-        try {
-          process.chdir(next);
-          state.cwd = next;
-          console.log(c.gray(`cwd -> ${state.cwd}`));
-        } catch (err) {
-          console.log(errorLine(err.message));
-        }
-      } else {
-        console.log(c.gray(`cwd: ${state.cwd}`));
-      }
-      break;
-    case "yes":
-      state.autoYes = !state.autoYes;
-      console.log(c.gray(`auto-yes: ${state.autoYes ? "on (writes/shells will skip y/N)" : "off"}`));
-      break;
-    case "turns": {
-      const n = parseInt(arg, 10);
-      if (!Number.isFinite(n) || n < 1 || n > 200) {
-        console.log(errorLine(`/turns expects 1..200, got "${arg}"`));
-      } else {
-        state.maxTurns = n;
-        console.log(c.gray(`max turns: ${state.maxTurns}`));
-      }
-      break;
-    }
-    case "model": {
-      const key = (arg || "").trim().toLowerCase();
-      if (!key) {
-        console.log(c.gray(`model: ${state.modelName}`));
-        console.log(c.gray("switch with /model core | ultra   (ultra=Opus — premium, need credits)"));
-      } else if (MODEL_ALIASES[key]) {
-        state.model = MODEL_ALIASES[key].id;
-        state.modelName = MODEL_ALIASES[key].name;
-        const premium = state.model !== null;
-        console.log(
-          c.gray(`model -> ${c.cyan(state.modelName)}`) +
-            (premium ? c.gray("  (premium — needs purchased credits, else falls back to Core)") : ""),
-        );
-      } else {
-        console.log(errorLine(`Unknown model "${key}". Try: core, ultra`));
-      }
-      break;
-    }
-    default:
-      console.log(errorLine(`Unknown command: /${cmd}. Type ${c.cyan("/help")} for shortcuts.`));
-  }
-  return null;
-}
-
-/* ───────── banner (two-column like Claude Code) ───────── */
-
-const shortenPath = (p, max) => (p.length <= max ? p : "..." + p.slice(p.length - max + 3));
-
-function padRight(str, width) {
-  const visible = stripAnsi(str).length;
-  const need = Math.max(0, width - visible);
-  return str + " ".repeat(need);
-}
-
-function centerIn(str, width) {
-  const visible = stripAnsi(str).length;
-  if (visible >= width) return str;
-  const left = Math.floor((width - visible) / 2);
-  return " ".repeat(left) + str;
-}
-
-function buildBannerLines(state) {
-  const cols = process.stdout.columns || 80;
-  const credits = state.balance != null ? `${state.balance.toLocaleString()} credits` : "";
-  const plan = state.plan && state.plan !== "FREE" ? state.plan : "";
-
-  const blk = (code) => `\x1b[${code}m \x1b[0m`;
-  const O = blk("48;2;209;107;52");
-  const W = blk("48;2;255;255;255");
-  const T = blk("48;2;0;178;169");
-
-  const modelParts = [state.modelName];
-  if (credits) modelParts.push(credits);
-  if (plan) modelParts.push(c.cyan(plan));
-  const modelLine = modelParts.join(c.dim(" \xB7 "));
-
-  const ruleW = cols - 2;
-  const leftW = Math.min(Math.floor(cols * 0.5), 45);
-  const twoCol = cols >= 70;
-
-  const titleText = " Aether Code v" + VERSION + " ";
-  const titleRuleRight = Math.max(0, ruleW - 3 - titleText.length);
-  const topRule = c.cyan("╭─" + titleText + "─".repeat(titleRuleRight) + "╮");
-
-  const VL = c.cyan("│");
-  const lines = [];
-
-  lines.push("");
-  lines.push(" " + topRule);
-
-  const bottomRule = c.cyan(" ╰" + "─".repeat(ruleW) + "╯");
-
-  if (twoCol) {
-    const row = (left, right) => {
-      lines.push(" " + VL + padRight(left, leftW) + " " + VL + " " + padRight(right, Math.max(0, ruleW - leftW - 4)) + VL);
-    };
-
-    row("", "");
-    row(centerIn(`${O}${T}${O}`, leftW), c.bold("Tips"));
-    row(centerIn(`${T}${O}${T}`, leftW), c.dim("Ask Aether to build, debug, or refactor code"));
-    row(centerIn(`${O}${T}${O}`, leftW), c.dim("Use /help for shortcuts and /balance for credits"));
-    row("", c.dim("Type @ to include file paths or image paths"));
-    row(centerIn(c.bold("/model") + c.dim(":") + c.cyan(state.modelName.toLowerCase().replace("aether ", "")), leftW), "");
-    row(centerIn(modelLine, leftW), "");
-    row("", "");
-    row(centerIn(c.dim("cwd: " + shortenPath(state.cwd, 40)), leftW), "");
-    row("", "");
-  } else {
-    const srow = (content) => {
-      lines.push(" " + VL + " " + padRight(content, Math.max(0, ruleW - 2)) + VL);
-    };
-    srow("");
-    srow(centerIn(`${O}${T}${O}`, ruleW - 2));
-    srow(centerIn(`${T}${O}${T}`, ruleW - 2));
-    srow(centerIn(`${O}${T}${O}`, ruleW - 2));
-    srow("");
-    srow(centerIn(modelLine, ruleW - 2));
-    srow(centerIn(c.dim(shortenPath(state.cwd, 50)), ruleW - 2));
-    srow("");
-  }
-
-  lines.push(bottomRule);
-  return lines;
-}
-
-function printBanner(state) {
-  const lines = buildBannerLines(state);
-  for (const l of lines) console.log(l);
-  return lines.length;
-}
+// Interactive REPL — Claude-CLI-style. Launched when `aether-code` is run
+// without a task argument.
+//
+// Behaviors:
+//   - Banner on startup (version, model, balance, cwd, mode)
+//   - Persistent message history across prompts within the session
+//   - Slash commands: /help, /exit, /clear, /balance, /cwd, /yes, /turns
+//   - Bottom status line is rendered after each turn
+//   - Ctrl+C: first press cancels in-progress turn, second press exits
+
+import fs from "node:fs";
+import path from "node:path";
+import { runAgent } from "./agent.js";
+import { fetchBalance, AetherError } from "./api.js";
+import { runSetup } from "./setup.js";
+import { c, errorLine, boxLines, sideBySide } from "./render.js";
+import { checkForUpdate } from "./update-check.js";
+import { promptBox, EXIT_SIGNAL } from "./box-input.js";
+import { getVersion } from "./version.js";
+import {
+  generateSessionId, saveSession, loadSession, listSessions,
+  findRecentSession, deleteSession, extractSummary, formatAge,
+} from "./sessions.js";
+import { scanProjectQuick, generateProjectIndex } from "./project-context.js";
+
+const VERSION = getVersion();
+const MODEL_NAME = "Aether Core";
+
+// /model aliases → { id, name }. id=null = server default (gemma / Aether Core).
+// Premium models are gated SERVER-SIDE: if you haven't purchased credits, the
+// server transparently uses Core instead — selecting one here can't bypass that.
+const MODEL_ALIASES = {
+  core: { id: null, name: "Aether Core" },
+  gemma: { id: null, name: "Aether Core" },
+  ultra: { id: "claude-opus-4-6", name: "Aether Ultra" },
+  opus: { id: "claude-opus-4-6", name: "Aether Ultra" },
+};
+
+const SHORTCUTS = `
+  ${c.cyan("/help")}      Show this help
+  ${c.cyan("/exit")}      Exit (or Ctrl+C twice)
+  ${c.cyan("/clear")}     Clear conversation history (start fresh)
+  ${c.cyan("/balance")}   Refresh and show credit balance
+  ${c.cyan("/cwd")} ${c.gray("[path]")}    Show or change working directory
+  ${c.cyan("/yes")}       Toggle auto-approve mode (skip y/N prompts)
+  ${c.cyan("/turns")} ${c.gray("<n>")}     Set max turns per prompt (default 25)
+  ${c.cyan("/model")} ${c.gray("[core|ultra]")}  Show or switch model (ultra=Opus — premium)
+  ${c.cyan("/init")}      Deep-scan project → generate .aether/context.md
+  ${c.cyan("/sessions")}  List saved sessions for this directory
+  ${c.cyan("/resume")} ${c.gray("[id]")}   Resume a saved session (default: most recent)
+  ${c.cyan("/new")}       Start a fresh session (save current first)
+
+${c.gray("Anything else is sent to the agent as your next message.")}
+${c.gray("Sessions auto-save — close the terminal and come back later.")}
+`;
+
+export async function runRepl({ cwd: initialCwd, autoYes: initialAutoYes, unsafePaths: initialUnsafePaths, maxTurns: initialMaxTurns, model: initialModel = null, mcpManager = null }) {
+  const initialAlias = Object.values(MODEL_ALIASES).find((a) => a.id === initialModel);
+  const state = {
+    cwd: initialCwd,
+    autoYes: !!initialAutoYes,
+    unsafePaths: !!initialUnsafePaths,
+    maxTurns: initialMaxTurns ?? 25,
+    model: initialModel ?? null,
+    modelName: initialAlias?.name ?? MODEL_NAME,
+    messages: [],
+    balance: null,
+    sessionCredits: 0,
+    sessionIn: 0,
+    sessionOut: 0,
+    sessionId: generateSessionId(initialCwd),
+    turnCount: 0,
+  };
+
+  const updatePromise = checkForUpdate().catch(() => null);
+
+  let needsSetup = false;
+  try {
+    const me = await fetchBalance();
+    state.balance = me.balance;
+    state.plan = me.plan;
+  } catch (err) {
+    if (err instanceof AetherError && (err.code === "NO_API_KEY" || err.status === 401)) {
+      needsSetup = true;
+    } else {
+      console.log(c.gray(`(could not fetch balance: ${err.message})`));
+    }
+  }
+
+  if (needsSetup) {
+    const ok = await runSetup();
+    if (!ok) {
+      console.log(c.gray("Aborting — no valid API key."));
+      process.exit(1);
+    }
+    try {
+      const me = await fetchBalance();
+      state.balance = me.balance;
+      state.plan = me.plan;
+    } catch { /* tolerate */ }
+  }
+
+  // Check for a resumable session before printing the banner
+  let resumed = false;
+  try {
+    const recent = findRecentSession(state.cwd);
+    if (recent && recent.messageCount >= 2) {
+      const full = loadSession(recent.id);
+      if (full && full.messages?.length >= 2) {
+        console.log(
+          c.gray(`\n  Found session from ${formatAge(recent.updatedAt)} — `) +
+          c.cyan(extractSummary(full.messages) || "(no summary)"),
+        );
+        console.log(c.gray("  Resuming automatically. Use /new to start fresh.\n"));
+        state.sessionId = full.id;
+        state.messages = full.messages;
+        state.sessionCredits = full.credits ?? 0;
+        state.sessionIn = full.tokensIn ?? 0;
+        state.sessionOut = full.tokensOut ?? 0;
+        state.turnCount = full.turnCount ?? 0;
+        if (full.model !== undefined) state.model = full.model;
+        if (full.modelName) state.modelName = full.modelName;
+        resumed = true;
+      }
+    }
+  } catch { /* non-fatal */ }
+
+  // Project quick-scan for banner
+  let projectLine = "";
+  try {
+    projectLine = scanProjectQuick(state.cwd);
+  } catch { /* non-fatal */ }
+
+  printBanner(state, projectLine, resumed);
+  const updateNudge = await updatePromise;
+  if (updateNudge) console.log(updateNudge + "\n");
+
+  const inputHistory = [];
+
+  while (true) {
+    const raw = await promptBox({ history: inputHistory });
+    if (raw === EXIT_SIGNAL) {
+      autoSave(state);
+      console.log(c.gray("bye."));
+      return;
+    }
+    const line = (raw ?? "").trim();
+    if (!line) continue;
+
+    inputHistory.push(line);
+
+    if (line.startsWith("/") || line === "?") {
+      const handled = await handleSlash(line, state);
+      if (handled === "exit") {
+        autoSave(state);
+        return;
+      }
+      printStatusLine(state);
+      continue;
+    }
+
+    state.turnCount++;
+    const result = await runAgent({
+      initialPrompt: line,
+      priorMessages: state.messages.length > 0 ? state.messages : undefined,
+      cwd: state.cwd,
+      autoYes: state.autoYes,
+      unsafePaths: state.unsafePaths,
+      model: state.model,
+      maxTurns: state.maxTurns,
+      mcpManager,
+    });
+
+    state.sessionCredits += result.totalCredits ?? 0;
+    state.sessionIn += result.totalIn ?? 0;
+    state.sessionOut += result.totalOut ?? 0;
+    if (typeof result.balance === "number") state.balance = result.balance;
+    if (result.messages) state.messages = result.messages;
+
+    if (!result.ok && result.error) {
+      console.log("\n" + errorLine(result.error.message || String(result.error)));
+    }
+
+    autoSave(state);
+    printStatusLine(state);
+  }
+}
+
+function autoSave(state) {
+  if (state.messages.length < 2) return;
+  try {
+    saveSession({
+      id: state.sessionId,
+      cwd: state.cwd,
+      model: state.model,
+      modelName: state.modelName,
+      messages: state.messages,
+      credits: state.sessionCredits,
+      tokensIn: state.sessionIn,
+      tokensOut: state.sessionOut,
+      turnCount: state.turnCount,
+      summary: extractSummary(state.messages),
+    });
+  } catch { /* non-fatal — don't kill the session over a save failure */ }
+}
+
+/* ───────── slash commands ───────── */
+
+async function handleSlash(line, state) {
+  const [cmd, ...rest] = line.replace(/^\//, "").split(/\s+/);
+  const arg = rest.join(" ").trim();
+
+  switch ((cmd || "").toLowerCase()) {
+    case "":
+    case "help":
+    case "?":
+      console.log(SHORTCUTS);
+      break;
+    case "exit":
+    case "quit":
+    case "q":
+      console.log(c.gray("bye."));
+      return "exit";
+    case "clear":
+      state.messages = [];
+      state.sessionCredits = 0;
+      state.sessionIn = 0;
+      state.sessionOut = 0;
+      console.log(c.gray("Conversation cleared."));
+      break;
+    case "balance": {
+      try {
+        const me = await fetchBalance();
+        state.balance = me.balance;
+        state.plan = me.plan;
+        console.log(
+          c.cyan(`balance: ${me.balance.toLocaleString()} credits`) +
+            c.gray(` · plan: ${me.plan} (${me.planCredits} plan + ${me.topupCredits} topup)`),
+        );
+      } catch (err) {
+        console.log(errorLine(err.message || String(err)));
+      }
+      break;
+    }
+    case "cwd":
+      if (arg) {
+        const next = path.resolve(arg);
+        try {
+          process.chdir(next);
+          state.cwd = next;
+          console.log(c.gray(`cwd → ${state.cwd}`));
+        } catch (err) {
+          console.log(errorLine(err.message));
+        }
+      } else {
+        console.log(c.gray(`cwd: ${state.cwd}`));
+      }
+      break;
+    case "yes":
+      state.autoYes = !state.autoYes;
+      console.log(c.gray(`auto-yes: ${state.autoYes ? "on (writes/shells will skip y/N)" : "off"}`));
+      break;
+    case "turns": {
+      const n = parseInt(arg, 10);
+      if (!Number.isFinite(n) || n < 1 || n > 200) {
+        console.log(errorLine(`/turns expects 1..200, got "${arg}"`));
+      } else {
+        state.maxTurns = n;
+        console.log(c.gray(`max turns: ${state.maxTurns}`));
+      }
+      break;
+    }
+    case "model": {
+      const key = (arg || "").trim().toLowerCase();
+      if (!key) {
+        console.log(c.gray(`model: ${state.modelName}`));
+        console.log(c.gray("switch with /model core | ultra   (ultra=Opus — premium, need credits)"));
+      } else if (MODEL_ALIASES[key]) {
+        state.model = MODEL_ALIASES[key].id;
+        state.modelName = MODEL_ALIASES[key].name;
+        const premium = state.model !== null;
+        console.log(
+          c.gray(`model → ${c.cyan(state.modelName)}`) +
+            (premium ? c.gray("  (premium — needs purchased credits, else falls back to Core)") : ""),
+        );
+      } else {
+        console.log(errorLine(`Unknown model "${key}". Try: core, ultra`));
+      }
+      break;
+    }
+    case "init": {
+      console.log(c.gray("Scanning project..."));
+      try {
+        const content = generateProjectIndex(state.cwd);
+        const dir = path.join(state.cwd, ".aether");
+        fs.mkdirSync(dir, { recursive: true });
+        const filePath = path.join(dir, "context.md");
+        fs.writeFileSync(filePath, content, "utf8");
+        const lineCount = content.split("\n").length;
+        console.log(c.green("●") + " " + c.bold(`.aether/context.md`) + c.gray(` generated (${lineCount} lines)`));
+        console.log(c.gray("  The agent now reads this on every turn. Edit it freely to add project-specific notes."));
+        // Add to .gitignore if not already there
+        const gitignorePath = path.join(state.cwd, ".gitignore");
+        try {
+          const existing = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, "utf8") : "";
+          if (!existing.includes(".aether/")) {
+            fs.appendFileSync(gitignorePath, `\n# Aether agent context\n.aether/\n`, "utf8");
+            console.log(c.gray("  Added .aether/ to .gitignore"));
+          }
+        } catch { /* non-fatal */ }
+      } catch (err) {
+        console.log(errorLine(`/init failed: ${err.message}`));
+      }
+      break;
+    }
+    case "sessions": {
+      const sessions = listSessions(state.cwd);
+      if (sessions.length === 0) {
+        console.log(c.gray("No saved sessions for this directory."));
+      } else {
+        console.log(c.bold("Saved sessions") + c.gray(` (${state.cwd})`));
+        for (const s of sessions.slice(0, 10)) {
+          const active = s.id === state.sessionId ? c.cyan(" ← current") : "";
+          const summary = s.summary || "(no summary)";
+          const truncated = summary.length > 60 ? summary.slice(0, 57) + "..." : summary;
+          console.log(
+            `  ${c.gray(formatAge(s.updatedAt).padEnd(8))} ` +
+            `${c.gray(s.id.slice(0, 16))}  ` +
+            `${truncated}` +
+            `${c.gray(` · ${s.turnCount} turns`)}` +
+            active,
+          );
+        }
+        if (sessions.length > 10) {
+          console.log(c.gray(`  ... and ${sessions.length - 10} more`));
+        }
+        console.log(c.gray("\nUse /resume <id-prefix> to load one."));
+      }
+      break;
+    }
+    case "resume": {
+      const target = (arg || "").trim();
+      let session = null;
+      if (target) {
+        const sessions = listSessions(state.cwd);
+        const match = sessions.find((s) => s.id.startsWith(target));
+        if (match) session = loadSession(match.id);
+        if (!session) {
+          console.log(errorLine(`No session matching "${target}" found.`));
+          break;
+        }
+      } else {
+        const recent = findRecentSession(state.cwd);
+        if (recent) session = loadSession(recent.id);
+        if (!session) {
+          console.log(errorLine("No recent session to resume. Use /sessions to list."));
+          break;
+        }
+      }
+      autoSave(state);
+      state.sessionId = session.id;
+      state.messages = session.messages ?? [];
+      state.sessionCredits = session.credits ?? 0;
+      state.sessionIn = session.tokensIn ?? 0;
+      state.sessionOut = session.tokensOut ?? 0;
+      state.turnCount = session.turnCount ?? 0;
+      if (session.model !== undefined) state.model = session.model;
+      if (session.modelName) state.modelName = session.modelName;
+      const summary = extractSummary(session.messages) || "(no summary)";
+      console.log(c.gray(`Resumed: `) + c.cyan(summary));
+      console.log(c.gray(`  ${state.messages.length} messages · ${state.turnCount} turns · ${formatAge(session.updatedAt)}`));
+      break;
+    }
+    case "new": {
+      autoSave(state);
+      state.sessionId = generateSessionId(state.cwd);
+      state.messages = [];
+      state.sessionCredits = 0;
+      state.sessionIn = 0;
+      state.sessionOut = 0;
+      state.turnCount = 0;
+      console.log(c.gray("New session started. Previous session saved."));
+      break;
+    }
+    default:
+      console.log(errorLine(`Unknown command: /${cmd}. Type ${c.cyan("/help")} for shortcuts.`));
+  }
+  return null;
+}
+
+/* ───────── banner + status ───────── */
+
+const visLen = (s) => s.replace(/\x1b\[[0-9;]*m/g, "").length;
+const shortenPath = (p, max) => (p.length <= max ? p : "..." + p.slice(p.length - max + 3));
+
+// Short, hand-curated highlights shown in the "What's new" box. Update with
+// notable releases — keep it to ~3 lines so it balances the banner height.
+const WHATS_NEW = [
+  "Session persistence — close & resume",
+  "Project auto-understanding on startup",
+  "Live thinking spinner + loop guard",
+];
+
+function printBanner(state, projectLine = "", resumed = false) {
+  const mode = state.autoYes ? (state.unsafePaths ? "skip-permissions" : "auto-yes") : "review mode";
+  const credits = state.balance != null ? `${state.balance.toLocaleString()} credits` : "";
+  const leftLines = [
+    c.bold(c.magenta("aether")) + c.gray("  ·  ") + c.bold(state.modelName) + c.gray("   v" + VERSION),
+    c.gray("uncensored AI coding agent"),
+    c.gray((credits ? credits + " · " : "") + mode),
+    c.gray(shortenPath(state.cwd, 52)),
+  ];
+  if (projectLine) {
+    leftLines.push(c.gray("project: " + (projectLine.length > 48 ? projectLine.slice(0, 45) + "..." : projectLine)));
+  }
+  if (resumed) {
+    leftLines.push(c.cyan("↻ resumed session") + c.gray(` · ${state.turnCount} turns · ${state.messages.length} msgs`));
+  }
+  const left = boxLines(leftLines, { color: c.magenta, padX: 2 });
+  const right = boxLines(
+    [c.bold(c.cyan("What's new")), ...WHATS_NEW.map((s) => c.gray("• " + s))],
+    { color: c.cyan, padX: 2 },
+  );
+
+  console.log("");
+  const cols = process.stdout.columns || 80;
+  if (cols >= visLen(left[0]) + visLen(right[0]) + 4) {
+    console.log(sideBySide(left, right, 3));
+  } else {
+    console.log(left.join("\n"));
+  }
+  console.log("");
+}
+
+function printStatusLine(state) {
+  const parts = [];
+  if (state.balance != null) parts.push(`${state.balance.toLocaleString()} credits`);
+  parts.push(state.autoYes ? "skip-permissions" : "review mode");
+  if (state.messages.length > 0) parts.push(`${state.messages.length} msgs`);
+  console.log(c.dim(parts.join(" · ")));
+}