steward-cli 0.26.1 → 0.28.0

package/dist/cli.js

@@ -41285,7 +41285,7 @@ var require_dist = __commonJS(function(exports) {
 });
 
 // src/app/app.ts
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync21 } from "node:fs";
 
 // src/packages/tui/src/engine/HistoryStore.ts
 class HistoryStore {
@@ -42874,8 +42874,8 @@ function resolveThemeColor(color, isBg = false) {
   if (color === "dim" || color === "ansi(dim)") {
     return isBg ? (s) => s : (s) => source_default.dim(s);
   }
-  if (color.startsWith("ansi(") && color.endsWith(")")) {
-    const name = color.slice(5, -1).trim();
+  if (color.startsWith("ansi(") && color.endsWith(")") || color.startsWith("ansi:")) {
+    const name = color.startsWith("ansi:") ? color.slice(5).trim() : color.slice(5, -1).trim();
     if (name === "reset" || name === "none" || name === "transparent" || name === "default") {
       return (s) => s;
     }
@@ -43062,48 +43062,122 @@ var draculaTheme = {
     default: "rgb(248,248,242)"
   }
 };
+var darkDaltonizedTheme = {
+  text: "rgb(255,255,255)",
+  muted: "rgb(153,153,153)",
+  subtle: "rgb(80,80,80)",
+  brand: "rgb(255,153,51)",
+  info: "rgb(153,204,255)",
+  success: "rgb(51,153,255)",
+  warning: "rgb(255,204,0)",
+  error: "rgb(255,102,102)",
+  permission: "rgb(153,204,255)",
+  selected: "rgb(153,204,255)",
+  current: "rgb(255,204,0)",
+  promptBorder: "rgb(136,136,136)",
+  rule: "rgb(102,153,153)",
+  userChevron: "rgb(136,136,136)",
+  userBg: "rgb(55,55,55)",
+  diffAddBg: "rgb(0,68,102)",
+  diffDelBg: "rgb(102,0,0)",
+  diffAddFg: "rgb(0,119,179)",
+  diffDelFg: "rgb(179,0,0)",
+  syntax: {
+    keyword: "rgb(255,178,102)",
+    string: "rgb(153,204,255)",
+    number: "rgb(255,255,102)",
+    literal: "rgb(255,255,102)",
+    comment: "rgb(153,153,153)",
+    function: "rgb(178,102,255)",
+    type: "rgb(255,153,51)",
+    variable: "rgb(255,178,102)",
+    tag: "rgb(102,178,255)",
+    attr: "rgb(153,204,255)",
+    meta: "rgb(178,102,255)",
+    addition: "rgb(102,178,255)",
+    deletion: "rgb(255,102,102)",
+    default: "rgb(255,255,255)"
+  }
+};
+var lightDaltonizedTheme = {
+  text: "rgb(0,0,0)",
+  muted: "rgb(102,102,102)",
+  subtle: "rgb(175,175,175)",
+  brand: "rgb(255,153,51)",
+  info: "rgb(51,102,255)",
+  success: "rgb(0,102,153)",
+  warning: "rgb(255,153,0)",
+  error: "rgb(204,0,0)",
+  permission: "rgb(51,102,255)",
+  selected: "rgb(51,102,255)",
+  current: "rgb(255,153,0)",
+  promptBorder: "rgb(153,153,153)",
+  rule: "rgb(51,102,102)",
+  userChevron: "rgb(153,153,153)",
+  userBg: "rgb(220,220,220)",
+  diffAddBg: "rgb(153,204,255)",
+  diffDelBg: "rgb(255,204,204)",
+  diffAddFg: "rgb(51,102,204)",
+  diffDelFg: "rgb(153,51,51)",
+  syntax: {
+    keyword: "rgb(204,0,0)",
+    string: "rgb(0,102,204)",
+    number: "rgb(0,102,204)",
+    literal: "rgb(0,102,204)",
+    comment: "rgb(102,102,102)",
+    function: "rgb(128,0,128)",
+    type: "rgb(255,128,0)",
+    variable: "rgb(255,128,0)",
+    tag: "rgb(0,102,204)",
+    attr: "rgb(0,102,204)",
+    meta: "rgb(128,0,128)",
+    addition: "rgb(0,102,153)",
+    deletion: "rgb(204,0,0)",
+    default: "rgb(0,0,0)"
+  }
+};
 var darkAnsiTheme = {
-  text: "default",
-  muted: "dim",
-  subtle: "dim",
-  brand: "ansi(yellow)",
-  info: "ansi(cyan)",
-  success: "ansi(green)",
-  warning: "ansi(yellow)",
-  error: "ansi(red)",
-  permission: "ansi(blue)",
-  selected: "ansi(blue)",
-  current: "ansi(yellow)",
-  promptBorder: "dim",
-  rule: "dim",
-  userChevron: "dim",
+  text: "ansi(whiteBright)",
+  muted: "ansi(white)",
+  subtle: "ansi(white)",
+  brand: "ansi(redBright)",
+  info: "ansi(blueBright)",
+  success: "ansi(greenBright)",
+  warning: "ansi(yellowBright)",
+  error: "ansi(redBright)",
+  permission: "ansi(blueBright)",
+  selected: "ansi(blueBright)",
+  current: "ansi(yellowBright)",
+  promptBorder: "ansi(white)",
+  rule: "ansi(cyanBright)",
+  userChevron: "ansi(white)",
   userBg: "ansi(bgBlackBright)",
   diffAddBg: "default",
   diffDelBg: "default",
-  diffAddFg: "ansi(green)",
-  diffDelFg: "ansi(red)",
+  diffAddFg: "ansi(greenBright)",
+  diffDelFg: "ansi(redBright)",
   syntax: {
-    keyword: "ansi(red)",
+    keyword: "ansi(redBright)",
     string: "ansi(cyan)",
     number: "ansi(cyan)",
     literal: "ansi(cyan)",
     comment: "ansi(gray)",
-    function: "ansi(magenta)",
-    type: "ansi(yellow)",
-    variable: "ansi(yellow)",
-    tag: "ansi(green)",
+    function: "ansi(magentaBright)",
+    type: "ansi(yellowBright)",
+    variable: "ansi(yellowBright)",
+    tag: "ansi(greenBright)",
     attr: "ansi(cyan)",
-    meta: "ansi(blue)",
-    addition: "ansi(green)",
-    deletion: "ansi(red)",
-    default: "ansi(white)"
+    meta: "ansi(blueBright)",
+    addition: "ansi(greenBright)",
+    deletion: "ansi(redBright)",
+    default: "ansi(whiteBright)"
   }
 };
 var lightAnsiTheme = {
-  text: "default",
-  muted: "dim",
-  subtle: "dim",
-  brand: "ansi(yellow)",
+  text: "ansi(black)",
+  muted: "ansi(blackBright)",
+  subtle: "ansi(blackBright)",
+  brand: "ansi(redBright)",
   info: "ansi(blue)",
   success: "ansi(green)",
   warning: "ansi(yellow)",
@@ -43111,14 +43185,14 @@ var lightAnsiTheme = {
   permission: "ansi(blue)",
   selected: "ansi(blue)",
   current: "ansi(yellow)",
-  promptBorder: "dim",
-  rule: "dim",
-  userChevron: "dim",
+  promptBorder: "ansi(white)",
+  rule: "ansi(cyan)",
+  userChevron: "ansi(blackBright)",
   userBg: "ansi(bgWhiteBright)",
   diffAddBg: "default",
   diffDelBg: "default",
-  diffAddFg: "ansi(green)",
-  diffDelFg: "ansi(red)",
+  diffAddFg: "ansi(greenBright)",
+  diffDelFg: "ansi(redBright)",
   syntax: {
     keyword: "ansi(red)",
     string: "ansi(blue)",
@@ -43133,7 +43207,44 @@ var lightAnsiTheme = {
     meta: "ansi(blue)",
     addition: "ansi(green)",
     deletion: "ansi(red)",
-    default: "default"
+    default: "ansi(black)"
+  }
+};
+var noColorTheme = {
+  text: "rgb(255,255,255)",
+  muted: "rgb(255,255,255)",
+  subtle: "rgb(255,255,255)",
+  brand: "rgb(255,255,255)",
+  info: "rgb(255,255,255)",
+  success: "rgb(255,255,255)",
+  warning: "rgb(255,255,255)",
+  error: "rgb(255,255,255)",
+  permission: "rgb(255,255,255)",
+  selected: "rgb(255,255,255)",
+  current: "rgb(255,255,255)",
+  promptBorder: "rgb(255,255,255)",
+  rule: "rgb(255,255,255)",
+  userChevron: "rgb(255,255,255)",
+  userBg: "default",
+  diffAddBg: "default",
+  diffDelBg: "default",
+  diffAddFg: "rgb(255,255,255)",
+  diffDelFg: "rgb(255,255,255)",
+  syntax: {
+    keyword: "rgb(255,255,255)",
+    string: "rgb(255,255,255)",
+    number: "rgb(255,255,255)",
+    literal: "rgb(255,255,255)",
+    comment: "rgb(255,255,255)",
+    function: "rgb(255,255,255)",
+    type: "rgb(255,255,255)",
+    variable: "rgb(255,255,255)",
+    tag: "rgb(255,255,255)",
+    attr: "rgb(255,255,255)",
+    meta: "rgb(255,255,255)",
+    addition: "rgb(255,255,255)",
+    deletion: "rgb(255,255,255)",
+    default: "rgb(255,255,255)"
   }
 };
 var builtInThemes = [
@@ -43151,6 +43262,20 @@ var builtInThemes = [
     theme: lightTheme,
     source: "built-in"
   },
+  {
+    name: "dark-daltonized",
+    label: "Dark Daltonized",
+    description: "Color-blind friendly dark theme adjusted for deuteranopia",
+    theme: darkDaltonizedTheme,
+    source: "built-in"
+  },
+  {
+    name: "light-daltonized",
+    label: "Light Daltonized",
+    description: "Color-blind friendly light theme adjusted for deuteranopia",
+    theme: lightDaltonizedTheme,
+    source: "built-in"
+  },
   {
     name: "dracula",
     label: "Dracula",
@@ -43171,6 +43296,13 @@ var builtInThemes = [
     description: "16-color ANSI light palette respecting terminal colors",
     theme: lightAnsiTheme,
     source: "built-in"
+  },
+  {
+    name: "no-color",
+    label: "No Color",
+    description: "Monochrome pure white palette with no color styling",
+    theme: noColorTheme,
+    source: "built-in"
   }
 ];
 var registry = new Map;
@@ -43185,7 +43317,8 @@ function findTheme(query) {
   const q = query.trim().toLowerCase().replace(/^["']|["']$/g, "");
   if (!q)
     return;
-  return listThemes().find((t) => t.name.toLowerCase() === q || t.label.toLowerCase() === q || t.label.toLowerCase().startsWith(q));
+  const normalizedQ = q.replace(/[\s-_]+/g, "");
+  return listThemes().find((t) => t.name.toLowerCase() === q || t.label.toLowerCase() === q || t.label.toLowerCase().startsWith(q) || t.name.replace(/[\s-_]+/g, "") === normalizedQ || t.label.toLowerCase().replace(/[\s-_]+/g, "") === normalizedQ);
 }
 function setActiveTheme(name) {
   if (registry.has(name)) {
@@ -56001,7 +56134,7 @@ import { isIP } from "node:net";
 // package.json
 var package_default = {
   name: "steward-cli",
-  version: "0.26.1",
+  version: "0.28.0",
   description: "Interactive AI engineering assistant for the terminal.",
   author: "sapirrior",
   license: "MIT",
@@ -59464,6 +59597,19 @@ class AgentSession {
   }
 }
 
+// src/app/commands/bug/index.ts
+var bugCommand = {
+  name: "bug",
+  description: "Report issues or submit feedback to GitHub",
+  usage: "/bug",
+  async execute(_args, _context) {
+    return {
+      handled: true,
+      message: "Report issues or feedback to https://github.com/sapirrior/steward/issues"
+    };
+  }
+};
+
 // src/app/commands/clear/index.ts
 var clearCommand = {
   name: "clear",
@@ -59556,6 +59702,427 @@ var copyCommand = {
   }
 };
 
+// src/app/commands/export/index.ts
+import { spawn as spawn4 } from "node:child_process";
+import { existsSync as existsSync18, mkdirSync as mkdirSync10, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname7, isAbsolute as isAbsolute8, resolve as resolve11 } from "node:path";
+function stripAnsi2(str) {
+  return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
+}
+function stripLogoFromLine(str) {
+  return str.replace(/^[ ▄▀▙█▟▝▘]{6,8}\s*/, "");
+}
+async function copyToClipboard2(text) {
+  const isTermux = Boolean(process.env.TERMUX_VERSION || existsSync18("/data/data/com.termux/files/usr/bin/termux-clipboard-set"));
+  const [cmd, ...args] = isTermux ? ["termux-clipboard-set"] : process.platform === "darwin" ? ["pbcopy"] : process.platform === "win32" ? ["clip.exe"] : process.env.WAYLAND_DISPLAY ? ["wl-copy"] : ["xclip", "-selection", "clipboard"];
+  const sendOSC52 = () => {
+    try {
+      process.stdout.write(`\x1B]52;c;${Buffer.from(text, "utf8").toString("base64")}\x07`);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  return new Promise((resolvePromise) => {
+    let resolved = false;
+    const finish = (ok) => {
+      if (resolved)
+        return;
+      resolved = true;
+      clearTimeout(timer);
+      resolvePromise(ok || sendOSC52());
+    };
+    const timer = setTimeout(() => finish(false), 1200);
+    try {
+      const proc = spawn4(cmd, args, { stdio: ["pipe", "ignore", "ignore"] });
+      proc.on("error", () => finish(false));
+      proc.on("close", (code) => finish(code === 0));
+      proc.stdin?.on("error", () => finish(false));
+      proc.stdin?.end(text);
+    } catch {
+      finish(false);
+    }
+  });
+}
+function formatToolArgs(args) {
+  if (!args || typeof args !== "object")
+    return "";
+  if (args.command)
+    return String(args.command);
+  if (args.path || args.filePath || args.targetFile) {
+    return String(args.path || args.filePath || args.targetFile);
+  }
+  if (args.pattern)
+    return String(args.pattern);
+  if (args.url)
+    return String(args.url);
+  if (args.query)
+    return String(args.query);
+  const firstVal = Object.values(args)[0];
+  if (typeof firstVal === "string")
+    return firstVal;
+  return "";
+}
+function formatToolOutput(output) {
+  if (output === undefined || output === null)
+    return [];
+  let text = "";
+  if (typeof output === "string") {
+    text = output;
+  } else if (typeof output === "object") {
+    text = output.message || output.output || JSON.stringify(output);
+  } else {
+    text = String(output);
+  }
+  const lines = text.split(/\r?\n/).filter((l) => l.trim().length > 0);
+  if (lines.length === 0)
+    return [];
+  const preview = lines.slice(0, 5);
+  return preview.map((l, idx) => idx === 0 ? `  └ ${l}` : `    ${l}`);
+}
+function generateTranscriptFromSession(sessionData, cwd = process.cwd()) {
+  const model = sessionData.model;
+  const modelTag = model ? `${model.provider}/${model.modelId}` : "ai/model";
+  const lines = [`Steward`, `${modelTag} · API Usage Billing`, `${cwd}`, ``];
+  const turns = sessionData.turns ?? [];
+  for (let turnIdx = 0;turnIdx < turns.length; turnIdx++) {
+    const turn = turns[turnIdx];
+    if (turnIdx > 0) {
+      lines.push(``);
+    }
+    const messages = turn.messages ?? [];
+    for (const msg of messages) {
+      if (msg.role === "user") {
+        const text = typeof msg.content === "string" ? msg.content : Array.isArray(msg.content) ? msg.content.map((c) => c.text || "").join(`
+`) : "";
+        lines.push(`❯ ${text}`);
+        lines.push(``);
+      } else if (msg.role === "assistant") {
+        if (Array.isArray(msg.content)) {
+          for (const block of msg.content) {
+            if (block.type === "thinking" && block.thinking) {
+              lines.push(`  Thought for ${Math.max(1, Math.round(block.thinking.length / 500))}s`);
+              lines.push(``);
+            } else if (block.type === "tool-call") {
+              const argPreview = formatToolArgs(block.arguments);
+              lines.push(`● ${block.name}${argPreview ? `(${argPreview})` : "()"}`);
+            } else if (block.type === "text" && block.text) {
+              const textLines = block.text.trim().split(/\r?\n/);
+              for (let i = 0;i < textLines.length; i++) {
+                lines.push(i === 0 ? `● ${textLines[i]}` : `  ${textLines[i]}`);
+              }
+              lines.push(``);
+            }
+          }
+        } else if (typeof msg.content === "string" && msg.content.trim()) {
+          const textLines = msg.content.trim().split(/\r?\n/);
+          for (let i = 0;i < textLines.length; i++) {
+            lines.push(i === 0 ? `● ${textLines[i]}` : `  ${textLines[i]}`);
+          }
+          lines.push(``);
+        }
+      } else if (msg.role === "tool") {
+        if (Array.isArray(msg.content)) {
+          for (const toolRes of msg.content) {
+            const formatted = formatToolOutput(toolRes.output);
+            for (const l of formatted) {
+              lines.push(l);
+            }
+          }
+          lines.push(``);
+        }
+      }
+    }
+    if (turn.timestamp) {
+      const timeStr = new Date(turn.timestamp).toLocaleTimeString([], {
+        hour: "2-digit",
+        minute: "2-digit"
+      });
+      lines.push(`✻ Done · ${timeStr}`);
+    }
+  }
+  return lines.join(`
+`).trim() + `
+`;
+}
+var exportCommand = {
+  name: "export",
+  description: "Exports the exact 1:1 UI conversation text to the clipboard or a file",
+  usage: "/export [filename]",
+  async execute(args, context) {
+    if (context.session.isBusy) {
+      return { handled: true, message: "Cannot export while the agent is generating a response." };
+    }
+    let transcript = "";
+    if (typeof context.getScreenLines === "function") {
+      const screenLines = context.getScreenLines();
+      if (screenLines && screenLines.length > 0) {
+        transcript = screenLines.map((l) => stripLogoFromLine(stripAnsi2(l))).join(`
+`).trim() + `
+`;
+      }
+    }
+    if (!transcript.trim()) {
+      const sessionData = context.session.session;
+      transcript = generateTranscriptFromSession(sessionData, context.cwd || process.cwd());
+    }
+    if (!transcript.trim()) {
+      return { handled: true, message: "No conversation messages found to export." };
+    }
+    const targetArg = args.join(" ").trim();
+    if (!targetArg) {
+      await copyToClipboard2(transcript);
+      return {
+        handled: true,
+        message: "Copied conversation transcript to clipboard."
+      };
+    }
+    try {
+      const cwd = context.cwd || process.cwd();
+      const filePath = isAbsolute8(targetArg) ? targetArg : resolve11(cwd, targetArg);
+      const targetPath = filePath.endsWith(".txt") || filePath.endsWith(".md") ? filePath : `${filePath}.txt`;
+      mkdirSync10(dirname7(targetPath), { recursive: true });
+      writeFileSync4(targetPath, transcript, "utf-8");
+      return {
+        handled: true,
+        message: `Conversation transcript exported to ${targetPath}`
+      };
+    } catch (err) {
+      return {
+        handled: true,
+        message: `Failed to export transcript: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
+  }
+};
+
+// src/app/commands/init/index.ts
+import { existsSync as existsSync19, mkdirSync as mkdirSync11, readFileSync as readFileSync14, writeFileSync as writeFileSync5 } from "node:fs";
+import { basename, join as join17 } from "node:path";
+function generateAgentsMd(cwd) {
+  const projectName = basename(cwd);
+  let stack = "General";
+  let commandsSection = "- `make test`: Run test suite";
+  if (existsSync19(join17(cwd, "package.json"))) {
+    try {
+      const pkg = JSON.parse(readFileSync14(join17(cwd, "package.json"), "utf-8"));
+      const scripts = pkg.scripts ? Object.keys(pkg.scripts) : [];
+      stack = "Node.js / TypeScript";
+      if (scripts.length > 0) {
+        commandsSection = scripts.map((s) => `- \`npm run ${s}\` (or \`bun run ${s}\`)`).join(`
+`);
+      }
+    } catch {
+      stack = "Node.js";
+    }
+  } else if (existsSync19(join17(cwd, "Cargo.toml"))) {
+    stack = "Rust";
+    commandsSection = "- `cargo build`: Build project\n- `cargo test`: Run tests";
+  } else if (existsSync19(join17(cwd, "pyproject.toml")) || existsSync19(join17(cwd, "requirements.txt"))) {
+    stack = "Python";
+    commandsSection = "- `pytest`: Run tests\n- `python main.py`: Run application";
+  } else if (existsSync19(join17(cwd, "go.mod"))) {
+    stack = "Go";
+    commandsSection = "- `go build ./...`: Build packages\n- `go test ./...`: Run test suite";
+  }
+  return `# AGENTS.md
+
+Operational guidelines and architectural context for AI engineering assistants working in \`${projectName}\`.
+
+## 1. Project Overview & Tech Stack
+
+- **Project:** \`${projectName}\`
+- **Primary Stack:** ${stack}
+
+## 2. Common Commands
+
+${commandsSection}
+
+## 3. Architecture & Guidelines
+
+- **Code Style:** Follow established project formatting and idioms.
+- **Verification:** Run relevant tests before finalizing changes.
+- **Safety:** Verify file paths and permissions before applying destructive edits.
+`;
+}
+var DUMMY_HOOKS_JSON = JSON.stringify({
+  version: 1,
+  hooks: {
+    SessionStart: [
+      {
+        name: "sample-session-start",
+        command: 'echo "Steward session started"',
+        enabled: false,
+        description: "Runs when a session starts or resumes"
+      }
+    ],
+    BeforeToolUse: [
+      {
+        name: "sample-tool-guard",
+        command: 'echo "Checking tool call"',
+        matcher: "bash",
+        enabled: false,
+        description: "Runs before specific tool executions"
+      }
+    ]
+  }
+}, null, 2);
+var initCommand = {
+  name: "init",
+  description: "Initializes project with AGENTS.md, .steward/hooks.json, and .agents/ directory",
+  usage: "/init",
+  async execute(_args, context) {
+    const cwd = context.cwd || process.cwd();
+    const created = [];
+    const skipped = [];
+    try {
+      const agentsMdPath = join17(cwd, "AGENTS.md");
+      if (!existsSync19(agentsMdPath)) {
+        writeFileSync5(agentsMdPath, generateAgentsMd(cwd), "utf-8");
+        created.push("AGENTS.md");
+      } else {
+        skipped.push("AGENTS.md (already exists)");
+      }
+      const stewardDir = join17(cwd, ".steward");
+      if (!existsSync19(stewardDir)) {
+        mkdirSync11(stewardDir, { recursive: true });
+      }
+      const hooksPath = join17(stewardDir, "hooks.json");
+      if (!existsSync19(hooksPath)) {
+        writeFileSync5(hooksPath, DUMMY_HOOKS_JSON, "utf-8");
+        created.push(".steward/hooks.json");
+      } else {
+        skipped.push(".steward/hooks.json (already exists)");
+      }
+      const skillsDir = join17(cwd, ".agents", "skills");
+      if (!existsSync19(skillsDir)) {
+        mkdirSync11(skillsDir, { recursive: true });
+        created.push(".agents/skills/");
+      } else {
+        skipped.push(".agents/skills/ (already exists)");
+      }
+      const summaryParts = [];
+      if (created.length > 0) {
+        summaryParts.push(`Created: ${created.join(", ")}`);
+      }
+      if (skipped.length > 0) {
+        summaryParts.push(`Preserved: ${skipped.join(", ")}`);
+      }
+      return {
+        handled: true,
+        message: `Project initialized successfully!
+${summaryParts.join(`
+`)}`
+      };
+    } catch (err) {
+      return {
+        handled: true,
+        message: `Failed to initialize project: ${err instanceof Error ? err.message : String(err)}`
+      };
+    }
+  }
+};
+
+// src/app/commands/usage/index.ts
+function formatNumber(num) {
+  return (num ?? 0).toLocaleString();
+}
+function formatDuration(isoDateString) {
+  if (!isoDateString)
+    return "0s";
+  const start = new Date(isoDateString).getTime();
+  if (isNaN(start))
+    return "0s";
+  const elapsedSec = Math.max(0, Math.floor((Date.now() - start) / 1000));
+  const hrs = Math.floor(elapsedSec / 3600);
+  const mins = Math.floor(elapsedSec % 3600 / 60);
+  const secs = elapsedSec % 60;
+  if (hrs > 0)
+    return `${hrs}h ${mins}m ${secs}s`;
+  if (mins > 0)
+    return `${mins}m ${secs}s`;
+  return `${secs}s`;
+}
+function estimateUniversalCost(usage, modelId, provider) {
+  const p = provider.toLowerCase();
+  const m = modelId.toLowerCase();
+  if (p === "ollama" || m.includes("local")) {
+    return "$0.00 USD [Local / Offline]";
+  }
+  const isLightweight = m.includes("flash") || m.includes("mini") || m.includes("haiku") || m.includes("8b") || m.includes("deepseek");
+  const inputPerMillion = isLightweight ? 0.15 : 3;
+  const outputPerMillion = isLightweight ? 0.6 : 15;
+  const cachePerMillion = isLightweight ? 0.075 : 0.3;
+  const baseCost = usage.inputTokens * inputPerMillion / 1e6;
+  const outputCost = usage.outputTokens * outputPerMillion / 1e6;
+  const cacheCost = (usage.cacheReadTokens ?? 0) * cachePerMillion / 1e6;
+  const total = baseCost + outputCost + cacheCost;
+  if (total === 0) {
+    return "$0.00 USD [estimated]";
+  }
+  const formatted = total < 0.005 ? "< $0.01" : `$${total.toFixed(2)}`;
+  return `~${formatted} USD [estimated benchmark]`;
+}
+var usageCommand = {
+  name: "usage",
+  description: "Displays token usage metrics and statistics for the current session",
+  usage: "/usage",
+  async execute(_args, context) {
+    const sessionData = context.session.session;
+    const model = context.session.getModel();
+    const usage = context.session.getUsage();
+    const turns = sessionData?.turns ?? [];
+    const turnsCount = turns.length;
+    let toolCallsCount = 0;
+    for (const turn of turns) {
+      if (Array.isArray(turn.messages)) {
+        let turnToolCalls = 0;
+        let turnToolMessages = 0;
+        for (const msg of turn.messages) {
+          if (msg.role === "assistant" && Array.isArray(msg.content)) {
+            turnToolCalls += msg.content.filter((c) => c?.type === "tool-call").length;
+          } else if (msg.role === "tool") {
+            turnToolMessages++;
+          }
+        }
+        toolCallsCount += turnToolCalls > 0 ? turnToolCalls : turnToolMessages;
+      }
+    }
+    const duration = formatDuration(sessionData?.createdAt);
+    const costEstimate = estimateUniversalCost(usage, model.modelId, model.provider);
+    const lines = [
+      `Session Usage & Analytics:`,
+      `• Active Model: ${model.modelId} (${model.provider}${model.effort !== "medium" ? `, effort: ${model.effort}` : ""})`,
+      `• Session Duration: ${duration}`,
+      `• Activity: ${formatNumber(turnsCount)} turns (${formatNumber(toolCallsCount)} tool executions)`,
+      ``,
+      `Token Breakdown:`,
+      `• Input Tokens: ${formatNumber(usage.inputTokens)}`,
+      `• Output Tokens: ${formatNumber(usage.outputTokens)}`
+    ];
+    if (usage.reasoningTokens && usage.reasoningTokens > 0) {
+      lines.push(`• Reasoning Tokens: ${formatNumber(usage.reasoningTokens)}`);
+    }
+    if (usage.cacheReadTokens && usage.cacheReadTokens > 0) {
+      const totalIn = (usage.inputTokens || 0) + (usage.cacheReadTokens || 0);
+      const hitRate = totalIn > 0 ? Math.round(usage.cacheReadTokens / totalIn * 100) : 0;
+      lines.push(`• Cache Read Tokens: ${formatNumber(usage.cacheReadTokens)} (${hitRate}% hit rate)`);
+    }
+    if (usage.cacheWriteTokens && usage.cacheWriteTokens > 0) {
+      lines.push(`• Cache Write Tokens: ${formatNumber(usage.cacheWriteTokens)}`);
+    }
+    lines.push(`• Total Tokens: ${formatNumber(usage.totalTokens)}`);
+    lines.push(``);
+    lines.push(`Estimated Cost:`);
+    lines.push(`• Session Spend: ${costEstimate}`);
+    return {
+      handled: true,
+      message: lines.join(`
+`)
+    };
+  }
+};
+
 // src/app/commands/effort/index.ts
 var EFFORT_HELP = `Reasoning Effort Levels:
   none   : disable reasoning/thinking
@@ -60025,7 +60592,11 @@ class CommandRegistry {
   }
 }
 var builtInCommands = [
+  bugCommand,
+  initCommand,
   copyCommand,
+  exportCommand,
+  usageCommand,
   rewindCommand,
   modelCommand,
   loginCommand,
@@ -62174,7 +62745,7 @@ var pn = x.lex;
 
 // src/packages/tui/src/format/highlight.ts
 var import_cli_highlight = __toESM(require_dist(), 1);
-import { extname, basename } from "node:path";
+import { extname, basename as basename2 } from "node:path";
 var EXTENSION_MAP = {
   ".ts": "typescript",
   ".tsx": "typescript",
@@ -62219,7 +62790,7 @@ var FILENAME_MAP = {
 function detectLanguageFromPath(filePath) {
   if (!filePath)
     return;
-  const name = basename(filePath).toLowerCase();
+  const name = basename2(filePath).toLowerCase();
   if (FILENAME_MAP[name])
     return FILENAME_MAP[name];
   const ext = extname(filePath).toLowerCase();
@@ -63778,11 +64349,12 @@ function renderToolDetail(detail, targetWidth, expanded = false) {
 }
 
 // src/app/ui/utils/message-formatter.ts
-function formatSystemMessage(content) {
+function formatSlashCommandOutput(content) {
   const rawLines = content.split(`
 `);
-  return rawLines.map((l, i) => i === 0 ? `  ${c.muted("└ ")}${c.permission(l)}` : `    ${c.permission(l)}`);
+  return rawLines.map((l, i) => i === 0 ? `  ${c.muted("└ ")}${l}` : `    ${l}`);
 }
+var formatSystemMessage = formatSlashCommandOutput;
 function formatAssistantMessage(content) {
   const lines = [];
   if (content) {
@@ -64151,13 +64723,13 @@ class UpdateCheckerService {
   }
 }
 // src/app/utils/open-url.ts
-import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync18 } from "node:fs";
+import { spawn as spawn5 } from "node:child_process";
+import { existsSync as existsSync20 } from "node:fs";
 function openUrl(url) {
   const platform = process.platform;
   try {
-    if (process.env.TERMUX_VERSION || existsSync18("/data/data/com.termux/files/usr/bin/termux-open-url")) {
-      const child = spawn4("termux-open-url", [url], {
+    if (process.env.TERMUX_VERSION || existsSync20("/data/data/com.termux/files/usr/bin/termux-open-url")) {
+      const child = spawn5("termux-open-url", [url], {
         detached: true,
         stdio: "ignore"
       });
@@ -64165,7 +64737,7 @@ function openUrl(url) {
       return;
     }
     if (platform === "win32") {
-      const child = spawn4("cmd.exe", ["/c", "start", '""', url], {
+      const child = spawn5("cmd.exe", ["/c", "start", '""', url], {
         detached: true,
         stdio: "ignore"
       });
@@ -64173,14 +64745,14 @@ function openUrl(url) {
       return;
     }
     if (platform === "darwin") {
-      const child = spawn4("open", [url], {
+      const child = spawn5("open", [url], {
         detached: true,
         stdio: "ignore"
       });
       child.unref();
       return;
     }
-    const child = spawn4("xdg-open", [url], {
+    const child = spawn5("xdg-open", [url], {
       detached: true,
       stdio: "ignore"
     });
@@ -65965,7 +66537,7 @@ async function applyCommandResult(text, cmdResult, ctx) {
     return true;
   }
   if (cmdResult.message) {
-    ctx.engine.commit("system", formatSystemMessage(cmdResult.message));
+    ctx.engine.commit("system", formatSlashCommandOutput(cmdResult.message));
   }
   const updatedModel = ctx.session.getModel();
   ctx.header.render();
@@ -65974,7 +66546,7 @@ async function applyCommandResult(text, cmdResult, ctx) {
 }
 
 // src/app/utils/bash.ts
-import { spawn as spawn5 } from "node:child_process";
+import { spawn as spawn6 } from "node:child_process";
 async function executeDirectBash(options) {
   const { command, cwd = process.cwd(), abortSignal, onChunk } = options;
   const { shell, args } = getPlatformShell();
@@ -65987,7 +66559,7 @@ async function executeDirectBash(options) {
     let output = "";
     let isSettled = false;
     try {
-      child = spawn5(shell, childArgs, {
+      child = spawn6(shell, childArgs, {
         cwd,
         env: process.env,
         stdio: ["pipe", "pipe", "pipe"],
@@ -66206,7 +66778,7 @@ class TUIApp {
       source: this.session.session.turns.length > 0 ? "resume" : "startup"
     });
     const logPath = getSessionLogPath(this.session.session.date, this.session.session.id);
-    if (this.session.session.turns.length > 0 || existsSync19(logPath)) {
+    if (this.session.session.turns.length > 0 || existsSync21(logPath)) {
       renderTranscript(this.engine, this.session.session, this.header);
     } else {
       this.engine.commit("header", this.header.render());
@@ -66312,7 +66884,8 @@ class TUIApp {
     if (defaultCommandRegistry.isCommand(text)) {
       const cmdResult = await defaultCommandRegistry.execute(text, {
         session: this.session,
-        cwd: this.cwd
+        cwd: this.cwd,
+        getScreenLines: () => this.engine.history.getEntries().filter((e) => e.kind !== "logo").flatMap((e) => e.lines)
       });
       await applyCommandResult(text, cmdResult, {
         engine: this.engine,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "steward-cli",
-  "version": "0.26.1",
+  "version": "0.28.0",
   "description": "Interactive AI engineering assistant for the terminal.",
   "license": "MIT",
   "author": "sapirrior",