mini-coder 0.5.2 → 0.5.4

package/README.md

@@ -59,32 +59,34 @@ Plugins can add more tools, but the core stays intentionally small.
 
 ## Commands
 
-| Command      | Description                                                            |
-| ------------ | ---------------------------------------------------------------------- |
-| `/model`     | Switch models. Persists as the global default.                         |
-| `/session`   | List and resume sessions scoped to the current working directory.      |
-| `/new`       | Start a fresh session and reset cumulative usage counters.             |
-| `/fork`      | Copy the conversation into a new session and continue independently.   |
-| `/undo`      | Remove the last conversational turn (does not revert file changes).    |
-| `/reasoning` | Toggle thinking visibility. Persisted and restored on launch.          |
-| `/verbose`   | Toggle verbose shell rendering plus edit previews/errors in the log.   |
-| `/login`     | Interactive OAuth login for supported providers.                       |
-| `/logout`    | Clear saved OAuth credentials for a logged-in provider.                |
-| `/effort`    | Set reasoning effort: low, medium, high, or xhigh.                     |
-| `/help`      | List commands, loaded AGENTS.md files, discovered skills, and plugins. |
+| Command      | Description                                                                                            |
+| ------------ | ------------------------------------------------------------------------------------------------------ |
+| `/model`     | Switch models and save the choice as the global default.                                               |
+| `/session`   | Open the session picker for the current working directory.                                             |
+| `/new`       | Start a fresh session and reset the running token and cost totals.                                     |
+| `/fork`      | Fork the current chat into a new session, keep the original, and add a UI-only `Forked session.` note. |
+| `/undo`      | Remove the last conversational turn without touching filesystem changes.                               |
+| `/reasoning` | Show or hide model thinking. The setting is saved and restored on launch.                              |
+| `/verbose`   | Expand shell output plus edit previews and edit errors in the conversation log.                        |
+| `/login`     | Sign in with a supported OAuth provider.                                                               |
+| `/logout`    | Remove saved OAuth credentials for a logged-in provider.                                               |
+| `/effort`    | Choose low, medium, high, or xhigh reasoning effort.                                                   |
+| `/help`      | Show commands, current toggles, loaded AGENTS.md files, skills, and plugins.                           |
 
 ## Key bindings
 
-| Key           | Action                                            |
-| ------------- | ------------------------------------------------- |
-| `Enter`       | Submit message                                    |
-| `Shift+Enter` | Insert newline                                    |
-| `Escape`      | Interrupt current turn, preserve partial response |
-| `Tab`         | File path autocomplete (or command filter on `/`) |
-| `Ctrl+R`      | Search global raw input history                   |
-| `Ctrl+C`      | Graceful exit                                     |
-| `Ctrl+D`      | Graceful exit (EOF, when input is empty)          |
-| `:q`          | Graceful exit                                     |
+| Key           | Action                                                                                                     |
+| ------------- | ---------------------------------------------------------------------------------------------------------- |
+| `Enter`       | Submit message                                                                                             |
+| `Shift+Enter` | Insert newline                                                                                             |
+| `Escape`      | Dismiss the overlay without changing the draft; otherwise interrupt the running turn; otherwise do nothing |
+| `Tab`         | Autocomplete a path, or open the command picker when the draft starts with `/`                             |
+| `Ctrl+R`      | Search global raw input history                                                                            |
+| `Ctrl+C`      | Graceful exit                                                                                              |
+| `Ctrl+D`      | Graceful exit when the input is empty                                                                      |
+| `:q`          | Graceful exit                                                                                              |
+| `Ctrl+Z`      | Suspend the process                                                                                        |
+| Mouse wheel   | Scroll conversation history                                                                                |
 
 ## Headless one-shot mode
 
@@ -95,10 +97,12 @@ $ mc -p "summarize this repo"
 $ printf '%s\n' 'fix the failing tests' | mc
 ```
 
-- Enabled when `-p/--prompt` is provided or when stdin/stdout is not a TTY.
-- Reuses the same input parsing rules as the interactive UI for plain text, `/skill:name`, and standalone image paths.
-- Streams newline-delimited JSON events to stdout.
-- Interactive slash commands such as `/model` and `/help` are not available in headless mode.
+- Starts when `-p/--prompt` is provided or when stdin or stdout is not a TTY.
+- If stdout is redirected but stdin is still interactive, pass `-p`; headless mode will not fall back to an interactive prompt.
+- Uses the same parser as the TUI for plain text, `/skill:name`, and standalone image paths.
+- Writes raw NDJSON events to stdout for text deltas, tool activity, final messages, and `done` / `error` / `aborted` outcomes.
+- Headless runs still persist like normal sessions and show up in `/session` history for that working directory.
+- Interactive slash commands such as `/model`, `/session`, and `/help` are not available in headless mode.
 
 ## Docs
 

package/bun.lock

@@ -5,9 +5,9 @@
     "": {
       "name": "mini-coder",
       "dependencies": {
-        "@cel-tui/components": "^0.6.2",
-        "@cel-tui/core": "^0.6.2",
-        "@cel-tui/types": "^0.6.2",
+        "@cel-tui/components": "0.7.2",
+        "@cel-tui/core": "0.7.2",
+        "@cel-tui/types": "0.7.2",
         "@mariozechner/pi-ai": "^0.66.1",
       },
       "devDependencies": {
@@ -108,11 +108,11 @@
 
     "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.4.11", "", { "os": "win32", "cpu": "x64" }, "sha512-A8D3JM/00C2KQgUV3oj8Ba15EHEYwebAGCy5Sf9GAjr5Y3+kJIYOiESoqRDeuRZueuMdCsbLZIUqmPhpYXJE9A=="],
 
-    "@cel-tui/components": ["@cel-tui/components@0.6.2", "", { "dependencies": { "@cel-tui/core": "0.6.2", "@cel-tui/types": "0.6.2", "lextide": "^0.1.0", "yoctomarkdown": "^0.1.0" }, "peerDependencies": { "typescript": ">=5.0.0" } }, "sha512-FYR7lX3/gPAyEkfMuyVapdxfO0e9OIw4lmdIUF2Tw7QszkpV4MAkEoB3G2oUY6UZyxJCSCKLBPvLzwu5uxaDgw=="],
+    "@cel-tui/components": ["@cel-tui/components@0.7.2", "", { "dependencies": { "@cel-tui/core": "0.7.2", "@cel-tui/types": "0.7.2", "lextide": "^0.2.1", "yoctomarkdown": "^0.1.0" }, "peerDependencies": { "typescript": ">=5.0.0" } }, "sha512-RHq7G/lS6A733l534cSStQp+cJECkxZZWrLghbPHwGBsSeDdJ2MkrQm+02roh6EH/N40ZAYjQqplq8acRrnFFQ=="],
 
-    "@cel-tui/core": ["@cel-tui/core@0.6.2", "", { "dependencies": { "@cel-tui/types": "0.6.2", "get-east-asian-width": "^1.5.0" }, "peerDependencies": { "typescript": ">=5.0.0" } }, "sha512-KJQdDMPbwLE211Hvn75jUKEvHiKTtQ7iVGJiiOpG+s4DjhnpySBXWO0hReMxe5NR2NPls7wmze1dBZ8/MXqVXA=="],
+    "@cel-tui/core": ["@cel-tui/core@0.7.2", "", { "dependencies": { "@cel-tui/types": "0.7.2", "get-east-asian-width": "^1.5.0" }, "peerDependencies": { "typescript": ">=5.0.0" } }, "sha512-Y5qdI9Zoa77Olq/LD+vqf3j0hyCRJYkkTkIdUfQplSDSUJS5NM+VSnxcQ8RCUNmrIsHeLmmAPHYsBsS1WMWk1w=="],
 
-    "@cel-tui/types": ["@cel-tui/types@0.6.2", "", { "peerDependencies": { "typescript": ">=5.0.0" } }, "sha512-JsJdo20KmgtC67QlG/ZrZyGi0xNJBKd3G6kM/yN/6/hk8a86P+1k1jqtSUjcZ4E9x1v9IXqPk6QelU7kLyOV1A=="],
+    "@cel-tui/types": ["@cel-tui/types@0.7.2", "", { "peerDependencies": { "typescript": ">=5.0.0" } }, "sha512-XEmYkGqtBMOXI/DKLopv5OL7d5/8ybkj1OpJO4weWPyx4Y6VY9pYFaj8zYhVaFSQZcB23/yoA+DPYi0kOgoZhQ=="],
 
     "@google/genai": ["@google/genai@1.48.0", "", { "dependencies": { "google-auth-library": "^10.3.0", "p-retry": "^4.6.2", "protobufjs": "^7.5.4", "ws": "^8.18.0" }, "peerDependencies": { "@modelcontextprotocol/sdk": "^1.25.2" }, "optionalPeers": ["@modelcontextprotocol/sdk"] }, "sha512-plonYK4ML2PrxsRD9SeqmFt76eREWkQdPCglOA6aYDzL1AAbE+7PUnT54SvpWGfws13L0AZEqGSpL7+1IPnTxQ=="],
 
@@ -342,7 +342,7 @@
 
     "lefthook-windows-x64": ["lefthook-windows-x64@2.1.5", "", { "os": "win32", "cpu": "x64" }, "sha512-yiAh8qxml6uqy10jDxOdN9fOQpyLxBFY1fgCEAhn7sVJYmJKRhjqSBwZX6LG5MQjzr29KStrIdw7TR3lf3rT7Q=="],
 
-    "lextide": ["lextide@0.1.0", "", {}, "sha512-i1fx9SzultDOIgVtFt/vBOeyFaGYCNLT6OcdqOLRfWL9p6aTQsq8JQ+8LpJ4T7znWNjfjLqUU6dK5g2kXhSq3A=="],
+    "lextide": ["lextide@0.2.1", "", {}, "sha512-fP7liS0LoNJz2EF6G7+K21yvB58bJEjaTrsDcPi4Qv7xZynB9NzjY44N6tFK6SJaECHIUqF2kcWbWQ84hPfmlg=="],
 
     "long": ["long@5.3.2", "", {}, "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA=="],
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mini-coder",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "A small, fast CLI coding agent",
   "module": "src/index.ts",
   "type": "module",
@@ -18,9 +18,9 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@cel-tui/components": "^0.6.2",
-    "@cel-tui/core": "^0.6.2",
-    "@cel-tui/types": "^0.6.2",
+    "@cel-tui/components": "^0.7.2",
+    "@cel-tui/core": "^0.7.2",
+    "@cel-tui/types": "^0.7.2",
     "@mariozechner/pi-ai": "^0.66.1"
   },
   "devDependencies": {

package/src/agent.ts

@@ -525,19 +525,26 @@ async function executeToolCall(
 
   let result: ToolExecResult;
   try {
-    result = await handler(
-      toolCall.arguments,
-      opts.cwd,
-      opts.signal,
-      (partial) => {
-        opts.onEvent?.({
-          type: "tool_delta",
-          toolCallId: toolCall.id,
-          name: toolCall.name,
-          result: partial,
-        });
-      },
-    );
+    if (opts.signal?.aborted) {
+      result = toolErrorResult(
+        toolCall.name,
+        new Error("This operation was aborted"),
+      );
+    } else {
+      result = await handler(
+        toolCall.arguments,
+        opts.cwd,
+        opts.signal,
+        (partial) => {
+          opts.onEvent?.({
+            type: "tool_delta",
+            toolCallId: toolCall.id,
+            name: toolCall.name,
+            result: partial,
+          });
+        },
+      );
+    }
   } catch (error) {
     result = toolErrorResult(toolCall.name, error);
   }
@@ -592,8 +599,17 @@ function appendToolResultMessage(
 export async function runAgentLoop(
   opts: RunAgentOpts,
 ): Promise<AgentLoopResult> {
-  const { db, sessionId, turn, messages, signal, onEvent, toolHandlers, cwd } =
-    opts;
+  const {
+    db,
+    sessionId,
+    turn,
+    model,
+    messages,
+    signal,
+    onEvent,
+    toolHandlers,
+    cwd,
+  } = opts;
 
   while (true) {
     const assistantMessage = await streamAssistantMessage(opts);
@@ -633,6 +649,13 @@ export async function runAgentLoop(
       );
 
       if (signal?.aborted) {
+        onEvent?.({
+          type: "aborted",
+          message: buildIncompleteAssistantMessage(
+            { model, signal },
+            assistantMessage,
+          ),
+        });
         return { messages, stopReason: "aborted" };
       }
     }

package/src/git.ts

@@ -61,6 +61,51 @@ async function run(
   return trim ? out.trim() : out;
 }
 
+function getErrorStringProperty(
+  error: unknown,
+  key: string,
+): string | undefined {
+  if (typeof error !== "object" || error === null) {
+    return undefined;
+  }
+
+  const value = Reflect.get(error, key);
+  return typeof value === "string" ? value : undefined;
+}
+
+function isMissingGitError(error: unknown): boolean {
+  const code = getErrorStringProperty(error, "code");
+  if (code !== "ENOENT") {
+    return false;
+  }
+
+  const message = getErrorStringProperty(error, "message");
+  return (
+    typeof message === "string" &&
+    message.includes('Executable not found in $PATH: "git"')
+  );
+}
+
+async function safeRun(
+  runGit: (
+    args: string[],
+    cwd: string,
+    trim?: boolean,
+  ) => Promise<string | null>,
+  args: string[],
+  cwd: string,
+  trim = true,
+): Promise<string | null> {
+  try {
+    return await runGit(args, cwd, trim);
+  } catch (error) {
+    if (isMissingGitError(error)) {
+      return null;
+    }
+    throw error;
+  }
+}
+
 function isUntrackedStatus(
   indexStatus: string,
   workingTreeStatus: string,
@@ -145,8 +190,8 @@ export function parseGitAheadBehind(output: string): {
  * Gather the current git state for a directory.
  *
  * Runs several fast git commands in parallel to collect branch, working
- * tree status, and ahead/behind counts. Returns `null` if the directory
- * is not inside a git repository.
+ * tree status, and ahead/behind counts. Returns `null` if git is not
+ * installed or the directory is not inside a git repository.
  *
  * @param cwd - The directory to query (can be a subdirectory of the repo).
  * @param opts - Optional runtime overrides used by tests.
@@ -165,18 +210,23 @@ export async function getGitState(
   const exec = opts?.run ?? run;
 
   // Check if we're in a repo and get the root
-  const root = await exec(["rev-parse", "--show-toplevel"], cwd);
+  const root = await safeRun(exec, ["rev-parse", "--show-toplevel"], cwd);
   if (root === null) return null;
 
   // Run remaining commands in parallel
   const [branch, upstream, status, revList] = await Promise.all([
-    exec(["branch", "--show-current"], cwd),
-    exec(
+    safeRun(exec, ["branch", "--show-current"], cwd),
+    safeRun(
+      exec,
       ["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{upstream}"],
       cwd,
     ),
-    exec(["status", "--porcelain"], cwd, false),
-    exec(["rev-list", "--left-right", "--count", "HEAD...@{upstream}"], cwd),
+    safeRun(exec, ["status", "--porcelain"], cwd, false),
+    safeRun(
+      exec,
+      ["rev-list", "--left-right", "--count", "HEAD...@{upstream}"],
+      cwd,
+    ),
   ]);
 
   const { staged, modified, untracked } = parseGitStatus(status ?? "");

package/src/prompt.ts

@@ -225,6 +225,7 @@ Workflow: **inspect with shell → mutate with edit → verify with shell**.
 
 - Think first: before any tool call, decide all files and information you need.
 - Early in the task, look for acceptance criteria in tests, verifier scripts, eval scripts, examples, and expected-output files. Do not rely on the task text alone when machine-checkable criteria are available.
+- Before relying on a binary, interpreter, or CLI helper you have not yet confirmed, probe availability with focused checks such as \`command -v <tool>\`, \`<tool> --version\`, or \`python3 -m pip --version\`, then adapt to what is actually installed.
 - Batch reads: if you need multiple files, read them together in parallel rather than one at a time.
 - Only make sequential calls when a later call genuinely depends on an earlier result.
 
@@ -233,13 +234,15 @@ Workflow: **inspect with shell → mutate with edit → verify with shell**.
 - Be concise. Friendly coding teammate tone.
 - After making changes: lead with a quick explanation of what changed and why, then suggest logical next steps if any.
 - Don't dump large file contents you've written — reference file paths.
-- When suggesting multiple options, use numbered lists so the user can reply with a number.
+- When discussing multiple options, use numbered lists so the user can reply with a number without turning it into a questionnaire.
 - If asked for a review, focus on bugs, risks, regressions, and missing tests. Findings first, ordered by severity.
 
 # Persistence
 
 - Carry work through to completion within the current turn. Don't stop at analysis or partial fixes.
 - Once the contract is clear, create the required artifact early, then iterate and improve it. Do not spend most of the turn exploring.
+- Run the narrowest verifier or test as soon as there is a plausible first implementation or artifact. Do not delay the first verification run until the end.
+- When verification is down to a small number of failures, stop broad exploration and focus only on the remaining failing assertions or exact contract gaps until the last detail passes.
 - If you encounter an error, diagnose and fix it rather than reporting it and stopping.
 - Before concluding, run the smallest targeted verification that checks the exact contract: required files exist, names and signatures match, outputs are in the required format, and no forbidden extra artifacts were left behind.
 - Avoid excessive looping: if you're re-reading or re-editing the same files without progress, stop and ask the user.`;

package/src/session.ts

@@ -160,6 +160,8 @@ const EMPTY_ASSISTANT_USAGE: AssistantMessage["usage"] = {
   },
 };
 
+const SQLITE_BUSY_TIMEOUT_MS = 1_000;
+
 /** Row shape returned by `SELECT * FROM prompt_history`. */
 type PromptHistoryRow = {
   id: number;
@@ -253,6 +255,7 @@ CREATE INDEX IF NOT EXISTS idx_prompt_history_created_at ON prompt_history(creat
 export function openDatabase(path: string): Database {
   const db = new Database(path);
   db.run("PRAGMA journal_mode = WAL");
+  db.run(`PRAGMA busy_timeout = ${SQLITE_BUSY_TIMEOUT_MS}`);
   db.run("PRAGMA foreign_keys = ON");
   db.exec(SCHEMA);
   return db;
@@ -709,6 +712,31 @@ export function getAssistantUsage(
   };
 }
 
+function runInImmediateTransaction<T>(db: Database, callback: () => T): T {
+  if (db.inTransaction) {
+    return callback();
+  }
+
+  db.run("BEGIN IMMEDIATE");
+  try {
+    const result = callback();
+    db.run("COMMIT");
+    return result;
+  } catch (error) {
+    if (db.inTransaction) {
+      try {
+        db.run("ROLLBACK");
+      } catch (rollbackError) {
+        throw new AggregateError(
+          [error, rollbackError],
+          "Failed to roll back SQLite transaction",
+        );
+      }
+    }
+    throw error;
+  }
+}
+
 /**
  * Append a UI-only message to a session's history.
  *
@@ -790,25 +818,27 @@ export function appendMessage(
   message: PersistedMessage,
   turn?: number,
 ): number | null {
-  const now = Date.now();
-
-  let effectiveTurn: number | null;
-  if (isUiMessage(message)) {
-    effectiveTurn = null;
-  } else if (turn !== undefined) {
-    effectiveTurn = turn;
-  } else {
-    const row = db.query<MaxTurnRow, [string]>(SQL.maxTurn).get(sessionId);
-    effectiveTurn = (row?.max_turn ?? 0) + 1;
-  }
+  return runInImmediateTransaction(db, () => {
+    const now = Date.now();
+
+    let effectiveTurn: number | null;
+    if (isUiMessage(message)) {
+      effectiveTurn = null;
+    } else if (turn !== undefined) {
+      effectiveTurn = turn;
+    } else {
+      const row = db.query<MaxTurnRow, [string]>(SQL.maxTurn).get(sessionId);
+      effectiveTurn = (row?.max_turn ?? 0) + 1;
+    }
 
-  db.run(
-    "INSERT INTO messages (session_id, turn, data, created_at) VALUES (?, ?, ?, ?)",
-    [sessionId, effectiveTurn, JSON.stringify(message), now],
-  );
-  db.run("UPDATE sessions SET updated_at = ? WHERE id = ?", [now, sessionId]);
+    db.run(
+      "INSERT INTO messages (session_id, turn, data, created_at) VALUES (?, ?, ?, ?)",
+      [sessionId, effectiveTurn, JSON.stringify(message), now],
+    );
+    db.run("UPDATE sessions SET updated_at = ? WHERE id = ?", [now, sessionId]);
 
-  return effectiveTurn;
+    return effectiveTurn;
+  });
 }
 
 /**