@takara-ai/miru-code 1.9.0 → 1.10.0

package/README.md

@@ -1,6 +1,6 @@
 # Miru (見る)
 
-[![CI](https://github.com/takara-ai/miru-code/actions/workflows/ci.yml/badge.svg)](https://github.com/takara-ai/miru-code/actions/workflows/ci.yml) [![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE) [![bun](https://img.shields.io/badge/runtime-bun%201.1%2B-black)](https://bun.sh)
+[![CI](https://github.com/takara-ai/miru-code/actions/workflows/ci.yml/badge.svg)](https://github.com/takara-ai/miru-code/actions/workflows/ci.yml) [![coverage](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Ftakara-ai%2Fmiru-code%2Fmain%2Fdocs%2Fcoverage-badge.json)](https://github.com/takara-ai/miru-code/actions/workflows/ci.yml) [![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE) [![bun](https://img.shields.io/badge/runtime-bun%201.1%2B-black)](https://bun.sh)
 
 
 **Hybrid code search for AI coding agents.** Find code by meaning, not grep.
@@ -48,10 +48,9 @@ Plugin installs don't carry full CLI parity — what each one gives you depends
 | `miru` / Caveman / STE skills | ✅ | ✅ | ✅ |
 | Dedicated sub-agent (`miru:miru-code`) | ✅ | — | — |
 | Benchmark mode toggle (`/plugin configure`) | ✅ | — | — |
-| Search hooks | — | — | — |
 | Credentials | own plugin-scoped dir | own plugin-scoped dir | n/a |
 
-`—` means the IDE's plugin schema has no equivalent mechanism to port these to (not a packaging gap we can close): Codex's and Cursor's plugin manifests have no `agents` or `userConfig` fields, so the dedicated sub-agent and the benchmark toggle are Claude-Code-only. Search hooks aren't shipped to any plugin — they're slated for removal from Miru entirely (tracked internally), so not worth packaging.
+`—` means the IDE's plugin schema has no equivalent mechanism to port these to (not a packaging gap we can close): Codex's and Cursor's plugin manifests have no `agents` or `userConfig` fields, so the dedicated sub-agent and the benchmark toggle are Claude-Code-only.
 
 **Credentials are plugin-scoped, not shared with your CLI install.** Claude Code and Codex plugins each store auth in their own IDE-managed data directory (survives plugin updates, removed on uninstall). This means `miru setup` done via the CLI does **not** carry over to a plugin install, or vice versa — each authenticates independently on first use (interactive device-code login bootstraps automatically). If you use both the CLI and a plugin, you'll sign in twice.
 
@@ -92,7 +91,7 @@ Interactive TUI — **↑↓** move, **space** toggle, **a** all, **enter** conf
 | Instructions                  | Search policy in `CLAUDE.md` / `AGENTS.md` / `GEMINI.md`            |
 | Sub-agent                     | Dedicated `miru-code` agent file                                    |
 | Cursor rules                  | Always-on `.cursor/rules/miru-code.mdc` (Cursor only)               |
-| Search hooks *(experimental)* | Block built-in Grep/Glob and redirect to Miru MCP                   |
+| Old Miru hooks                | Removes stale search hooks from older releases                       |
 | Caveman *(experimental)*      | On-demand chat compression skill (`/caveman`)                       |
 | STE writing *(experimental)*  | On-demand clear technical English for docs (`/ste`)                 |
 
@@ -106,18 +105,18 @@ miru uninstall   # remove miru config
 **Supported:** Cursor · Claude Code · Gemini CLI · Kiro · OpenCode · GitHub Copilot · Codex · VS Code · Visual Studio (Windows) · Windsurf / Devin Desktop
 
 
-| IDE            | MCP                                   | Instructions / rules            | Hooks *(experimental)*                            | Caveman *(experimental)*                            | STE *(experimental)*                         |
-| -------------- | ------------------------------------- | ------------------------------- | ------------------------------------------------- | --------------------------------------------------- | -------------------------------------------- |
-| Cursor         | `~/.cursor/mcp.json`                  | `~/.cursor/rules/miru-code.mdc` | `~/.cursor/hooks.json`                            | `~/.agents/skills/caveman/SKILL.md`                 | `~/.agents/skills/ste/SKILL.md`              |
-| Claude Code    | `~/.claude.json`                      | `~/.claude/CLAUDE.md`           | `~/.claude/settings.json`                         | `~/.claude/skills/caveman/SKILL.md`                 | `~/.claude/skills/ste/SKILL.md`              |
-| Gemini CLI     | `~/.gemini/settings.json`             | `~/.gemini/GEMINI.md`           | `~/.gemini/settings.json` (`BeforeTool`)          | `~/.agents/skills/caveman/SKILL.md`                 | `~/.agents/skills/ste/SKILL.md`              |
-| Kiro           | `~/.kiro/settings/mcp.json`           | `~/.kiro/steering/miru.md`      | `~/.kiro/settings/hooks.json`                     | `~/.kiro/skills/caveman/SKILL.md`                   | `~/.kiro/skills/ste/SKILL.md`                |
-| OpenCode       | `$XDG_CONFIG_HOME/opencode/opencode.json(c)` *(else `~/.config/opencode/…`)* | `…/AGENTS.md` | `…/plugins/miru-search-guard.ts` | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md` |
-| GitHub Copilot | `~/.copilot/mcp-config.json`          | —                               | `~/.copilot/hooks/miru-search.json`               | `~/.agents/skills/caveman/SKILL.md`                 | `~/.agents/skills/ste/SKILL.md`              |
-| Codex          | `~/.codex/config.toml`                | `~/.codex/AGENTS.md`            | `~/.codex/hooks.json`                             | `~/.agents/skills/caveman/SKILL.md`                 | `~/.agents/skills/ste/SKILL.md`              |
-| VS Code        | `…/Code/User/mcp.json`                | —                               | `~/.copilot/hooks/miru-search.json`               | `~/.agents/skills/caveman/SKILL.md`                 | `~/.agents/skills/ste/SKILL.md`              |
-| Visual Studio  | `%USERPROFILE%\.mcp.json`             | —                               | `~/.copilot/hooks/miru-search.json`               | `~/.agents/skills/caveman/SKILL.md`                 | `~/.agents/skills/ste/SKILL.md`              |
-| Windsurf       | —                                     | —                               | `~/.codeium/windsurf/hooks.json`                  | `~/.agents/skills/caveman/SKILL.md`                 | `~/.agents/skills/ste/SKILL.md`              |
+| IDE            | MCP                                   | Instructions / rules            | Caveman *(experimental)*            | STE *(experimental)*                    |
+| -------------- | ------------------------------------- | ------------------------------- | ----------------------------------- | --------------------------------------- |
+| Cursor         | `~/.cursor/mcp.json`                  | `~/.cursor/rules/miru-code.mdc` | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md`         |
+| Claude Code    | `~/.claude.json`                      | `~/.claude/CLAUDE.md`           | `~/.claude/skills/caveman/SKILL.md` | `~/.claude/skills/ste/SKILL.md`         |
+| Gemini CLI     | `~/.gemini/settings.json`             | `~/.gemini/GEMINI.md`           | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md`         |
+| Kiro           | `~/.kiro/settings/mcp.json`           | `~/.kiro/steering/miru.md`      | `~/.kiro/skills/caveman/SKILL.md`   | `~/.kiro/skills/ste/SKILL.md`           |
+| OpenCode       | `$XDG_CONFIG_HOME/opencode/opencode.json(c)` *(else `~/.config/opencode/…`)* | `…/AGENTS.md` | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md` |
+| GitHub Copilot | `~/.copilot/mcp-config.json`          | —                               | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md`         |
+| Codex          | `~/.codex/config.toml`                | `~/.codex/AGENTS.md`            | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md`         |
+| VS Code        | `…/Code/User/mcp.json`                | —                               | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md`         |
+| Visual Studio  | `%USERPROFILE%\.mcp.json`             | —                               | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md`         |
+| Windsurf       | —                                     | —                               | `~/.agents/skills/caveman/SKILL.md` | `~/.agents/skills/ste/SKILL.md`         |
 
 
 ### Plugin packaging
@@ -128,11 +127,11 @@ miru uninstall   # remove miru config
 
 Current limitation:
 
-- these plugin manifests still launch the published Miru runtime through `bunx @takara-ai/miru-code`
+- these plugin manifests launch the published Miru runtime through `bunx @takara-ai/miru-code@latest mcp`
 - that means local source edits do not affect plugin behavior until a package version is published
 - and a fully self-contained “no Bun required” plugin install is still future work
 
-### Search hooks
+### On-demand skills
 
 Sub-agent files are also written where supported (see `miru install` plan). Windsurf hooks only *(experimental)* — no MCP entry yet. Caveman is an on-demand Agent Skill (default off): invoke with `/caveman` or “talk like caveman”; stop with “normal mode”. Invocation UI varies by IDE (`/caveman`, `$caveman`, `@caveman`, etc.). Most IDEs share `~/.agents/skills/caveman/SKILL.md` (including Copilot / VS Code / Visual Studio); Claude Code and Kiro keep vendor-native skill dirs. Ownership is tracked on the shared path so uninstalling one IDE keeps the skill while another still owns it; selecting all owners removes it once. STE is an on-demand Agent Skill (default off): invoke with `/ste` or “de-slop this”; keep articles and complete sentences. Most IDEs share `~/.agents/skills/ste/` the same way (ownership via `miru-owners.json`); Claude Code and Kiro keep vendor-native STE dirs.
 
@@ -158,17 +157,6 @@ Off by default at install time. Enable Caveman in the installer for any supporte
 
 </details>
 
-<details>
-<summary>Search hooks <em>(experimental)</em></summary>
-
-Search hooks are **experimental** — behavior and IDE support may change between releases.
-
-Hooks run `miru hook-guard` before built-in search tools execute. They **block** conceptual Grep/Glob/SemanticSearch and shell `rg`/`grep`/`find`, and tell the agent to use Miru MCP `search` (or `locate` for exact literals) instead. Exact literal lookups (e.g. `REDIS_HOST`, a symbol name) still pass through.
-
-Hooks are **off by default** at install time. Enable them in the installer if you want built-in Grep/Glob redirected to Miru MCP.
-
-</details>
-
 **Team sub-agent in a repo** (optional):
 
 ```bash
@@ -189,14 +177,14 @@ miru find-related src/auth.ts 42 ./src
 Terminal output is human-readable; use `--json` for scripts. One-off without installing:
 
 ```bash
-bunx @takara-ai/miru-code search "auth middleware" ./src
+bunx @takara-ai/miru-code@latest search "auth middleware" ./src
 ```
 
 ---
 
 ## MCP tools
 
-When wired via `miru install`, the MCP server exposes `search`, `locate`, `expand`, and `find_related`. `read_benchmark` appears only in [benchmark mode](#benchmark-mode). Pass the **project root** as `repo` for local workspaces (or an `https://` git URL). The index is built on the first call and cached for the session.
+When wired via `miru install`, the MCP server exposes `search`, `locate`, `expand`, and `find_related`. `read_benchmark` appears only in [benchmark mode](#benchmark-mode). `repo` is optional: it defaults to the server's startup directory. Set it for another repo, or if your MCP client starts elsewhere. The index is built on the first call and cached for the session.
 
 
 | Tool             | When to use                                                                             |
@@ -210,11 +198,13 @@ When wired via `miru install`, the MCP server exposes `search`, `locate`, `expan
 
 ### Workflow
 
-1. **`search`** with `query` + `repo` — returns compact snippets (~±15 lines) and relevance scores.
-2. If a hit has **`truncated: true`**, call **`expand`** with `file_path`, `anchor_line`, and `repo` — not another search or a full-file read.
-3. To trace similar patterns elsewhere, call **`find_related`** with the same `file_path`, `anchor_line`, and `repo`.
+1. **`search`** with `query` — returns compact snippets (~±15 lines) and relevance scores.
+2. If a hit has **`truncated: true`**, call **`expand`** with `file_path` and `anchor_line` — not another search or a full-file read.
+3. To trace similar patterns elsewhere, call **`find_related`** with the same `file_path` and `anchor_line`.
 4. Use your editor's **Read** on `absolute_path` only when editing or when `expand` still lacks context.
 
+Keep `repo` on follow-up calls when set.
+
 Prefer these tools over Grep, Glob, or SemanticSearch when Miru MCP is connected — hooks and instructions enforce that when enabled.
 
 Local repo hits include `absolute_path` for one-click navigation. Parameter reference is below under [MCP parameters](#mcp-parameters).
@@ -235,10 +225,11 @@ MCP watches local files and updates the index incrementally. Package upgrades in
 
 Miru chunks source in tiers: **AST** (tree-sitter, default) → **structural** heuristics → **line** splits.
 
-**AST chunking** — 22 languages (syntax-aware boundaries via vendored `web-tree-sitter` grammars):
+**AST chunking** — 26 languages (syntax-aware boundaries via vendored `web-tree-sitter` grammars):
 
 | Language | Typical extensions |
 |----------|-------------------|
+| astro | `.astro` |
 | bash | `.sh`, `.bash`, `.zsh` |
 | c | `.c` |
 | cpp | `.cpp`, `.h`, `.hpp`, etc. |
@@ -246,10 +237,10 @@ Miru chunks source in tiers: **AST** (tree-sitter, default) → **structural** h
 | css | `.css` |
 | dart | `.dart` |
 | elixir | `.ex`, `.exs` |
-| embeddedtemplate | ERB-style templates |
+| embeddedtemplate | `.erb`, `.ejs` |
 | go | `.go` |
 | haskell | `.hs` |
-| html | `.html` |
+| html | `.html`, `.htm` |
 | java | `.java` |
 | javascript | `.js`, `.jsx`, `.mjs`, `.cjs` |
 | json | `.json` |
@@ -260,17 +251,20 @@ Miru chunks source in tiers: **AST** (tree-sitter, default) → **structural** h
 | rust | `.rs` |
 | scala | `.scala` |
 | solidity | `.sol` |
+| sql | `.sql` |
+| svelte | `.svelte` |
 | typescript | `.ts`, `.tsx`, `.mts`, `.cts` |
+| vue | `.vue` |
 
 **Structural fallback** (brace/indent heuristics when AST is unavailable): python, go, typescript, javascript, cpp, c.
 
-**Line fallback:** everything else that gets indexed (kotlin, swift, vue, sql, etc.) — still searchable, coarser chunks.
+**Line fallback:** everything else that gets indexed (kotlin, swift, etc.) — still searchable, coarser chunks.
 
 Set `MIRU_AST_CHUNKING=0` to disable AST and use structural → lines only.
 
 ## CLI reference
 
-Run `miru -h` for the command list, or `miru <command> -h` for details.
+Run `miru` in a terminal or `miru -h` for the command list, or `miru <command> -h` for details.
 
 | Command                                  | Purpose                                                                           |
 | ----------------------------------------- | --------------------------------------------------------------------------------- |
@@ -284,8 +278,7 @@ Run `miru -h` for the command list, or `miru <command> -h` for details.
 | `miru benchmark on/off/status/clear`     | Toggle MCP benchmark mode / clear report                                          |
 | `miru init --agent <id>`                 | Project-local sub-agent                                                           |
 | `miru clear [path]`                      | Drop index cache (use after big CLI-only refactors)                               |
-| `miru hook-guard`                        | PreToolUse hook entrypoint *(experimental)*; used by installers, reads JSON stdin |
-| `miru`                                   | Start MCP server (`--benchmark` for comparisons)                                  |
+| `miru mcp`                               | Start MCP server (`--benchmark` for comparisons)                                  |
 
 
 CLI uses hyphens (`find-related`); MCP tool names use underscores (`find_related`).
@@ -367,7 +360,7 @@ Override with `MIRU_BENCHMARK_HISTORY_PATH`. Append-only JSONL of compact token
 | Param            | Required | Notes                                   |
 | ---------------- | -------- | --------------------------------------- |
 | `query`          | yes      | Natural language or code query          |
-| `repo`           | yes      | Project root or git URL                 |
+| `repo`           | no       | Startup directory by default; set for another repo |
 | `include`        | no       | Gitignore-style glob patterns; only matching files are searched (same as `locate.include`) |
 | `exclude`        | no       | Gitignore-style glob patterns; matching files are skipped (same as `locate.exclude`) |
 | `dedupe_by_file` | no       | Keep best hit per file (default `true`) |
@@ -379,7 +372,7 @@ Override with `MIRU_BENCHMARK_HISTORY_PATH`. Append-only JSONL of compact token
 | Param         | Required | Notes                                                                               |
 | ------------- | -------- | ----------------------------------------------------------------------------------- |
 | `literal`     | yes      | Exact substring to find                                                             |
-| `repo`        | yes      | Project root or git URL                                                             |
+| `repo`        | no       | Startup directory by default; set for another repo                                |
 | `include`     | no       | Gitignore-style glob patterns; only matching files are searched                    |
 | `exclude`     | no       | Gitignore-style glob patterns; matching files are skipped                          |
 | `mode`        | no       | `count` · `locations` · `lines` (default). Prefer `count`/`locations` when possible |
@@ -394,7 +387,7 @@ Override with `MIRU_BENCHMARK_HISTORY_PATH`. Append-only JSONL of compact token
 | ------------------ | -------- | --------------------------------------------------------------------- |
 | `file_path`        | yes      | From hit `file_path` or `absolute_path` (local repos)                 |
 | `anchor_line`      | yes      | From the search hit (`anchor_line` when truncated, else `start_line`) |
-| `repo`             | yes      | Same repo as the search                                               |
+| `repo`             | no       | Same repo as the search, if set                                        |
 | `before` / `after` | no       | Extra chunks before/after anchor (default 1 each)                     |
 
 
@@ -405,7 +398,7 @@ Override with `MIRU_BENCHMARK_HISTORY_PATH`. Append-only JSONL of compact token
 | ------------- | -------- | -------------------------------------------- |
 | `file_path`   | yes      | From a search hit                            |
 | `anchor_line` | yes      | From the search hit                          |
-| `repo`        | yes      | Same repo as the search                      |
+| `repo`        | no       | Same repo as the search, if set              |
 
 
 `**read_benchmark**` *(benchmark mode only)*
@@ -422,16 +415,18 @@ Override with `MIRU_BENCHMARK_HISTORY_PATH`. Append-only JSONL of compact token
 {
   "miru": {
     "command": "miru",
-    "args": []
+    "args": ["mcp"]
   }
 }
 ```
 
-For benchmark mode, set `"args": ["--benchmark"]` (or append that flag). Prefer `miru benchmark on` after a normal install — it updates every agent config.
+For benchmark mode, set `"args": ["mcp", "--benchmark"]` (or append the flag). Prefer `miru benchmark on` after a normal install — it updates every agent config.
 
 Run `miru setup` once so the server can load credentials from `credentials.json`. If the MCP server starts in an interactive terminal without stored credentials, it will start device login automatically.
 
-Use `bunx` + `@takara-ai/miru-code` if `miru` is not global. Wrapper key varies by IDE (`mcpServers`, `servers`, or `mcp`).
+Use `bunx` + `@takara-ai/miru-code@latest` if `miru` is not global. The installer uses this command so each new MCP server launch can pick up a published version without a global update. A running server keeps its current version until restarted. Wrapper key varies by IDE (`mcpServers`, `servers`, or `mcp`).
+
+Older headless MCP configs that launch `miru` without a subcommand, with or without MCP flags, continue to work. Run `miru install` again to update managed entries to the explicit `mcp` subcommand, then restart your coding agent. For manual MCP configs, add `mcp` after the executable or package name.
 
 ## Developing
 

package/docs/coverage-badge.json

@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "label": "coverage",
+  "message": "100.0%",
+  "color": "brightgreen"
+}

package/grammars/manifest.json

@@ -2,6 +2,7 @@
   "version": 1,
   "runtime": "web-tree-sitter@^0.26.9",
   "languages": {
+    "astro": "tree-sitter-astro.wasm",
     "bash": "tree-sitter-bash.wasm",
     "c": "tree-sitter-c.wasm",
     "cpp": "tree-sitter-cpp.wasm",
@@ -23,9 +24,13 @@
     "rust": "tree-sitter-rust.wasm",
     "scala": "tree-sitter-scala.wasm",
     "solidity": "tree-sitter-solidity.wasm",
-    "typescript": "tree-sitter-typescript.wasm"
+    "sql": "tree-sitter-sql.wasm",
+    "svelte": "tree-sitter-svelte.wasm",
+    "typescript": "tree-sitter-typescript.wasm",
+    "vue": "tree-sitter-vue.wasm"
   },
   "files": [
+    "tree-sitter-astro.wasm",
     "tree-sitter-bash.wasm",
     "tree-sitter-c.wasm",
     "tree-sitter-c_sharp.wasm",
@@ -50,7 +55,10 @@
     "tree-sitter-rust.wasm",
     "tree-sitter-scala.wasm",
     "tree-sitter-solidity.wasm",
+    "tree-sitter-sql.wasm",
+    "tree-sitter-svelte.wasm",
     "tree-sitter-tsx.wasm",
-    "tree-sitter-typescript.wasm"
+    "tree-sitter-typescript.wasm",
+    "tree-sitter-vue.wasm"
   ]
 }

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@takara-ai/miru-code",
-  "version": "1.9.0",
+  "version": "1.10.0",
+  "mcpName": "ai.takara/miru",
   "description": "Miru (見る) — hybrid code search for agents. Bun, TypeScript, Takara embeddings.",
   "type": "module",
   "license": "MIT",
@@ -50,13 +51,15 @@
     "miru": "bun run src/cli.ts",
     "mcp": "bun run src/cli.ts",
     "test": "bun test",
+    "coverage": "bun test --coverage --coverage-reporter=lcov",
+    "coverage:badge": "bun run coverage && bun run scripts/update-coverage-badge.ts",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "prepare": "bun run scripts/install-git-hooks.ts",
     "build:kiro-plugin": "bun run scripts/build-kiro-plugin.ts",
     "vendor-grammars": "bun run scripts/vendor-grammars.ts",
-    "prepublishOnly": "bun run vendor-grammars && bun run typecheck && bun test",
+    "prepublishOnly": "bun run typecheck && bun test",
     "benchmark:ab": "bun run scripts/search-ab-local.ts",
     "benchmark:ab-multi": "bun run scripts/search-ab-multi.ts",
     "benchmark:codesearchnet-compression": "bun run scripts/benchmark-codesearchnet-compression.ts",
@@ -83,13 +86,17 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.1",
+    "@derekstride/tree-sitter-sql": "^0.3.11",
     "@huggingface/tokenizers": "^0.1.3",
+    "@tree-sitter-grammars/tree-sitter-svelte": "^1.0.2",
     "@types/bun": "^1.3.14",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
+    "tree-sitter-astro": "github:virchau13/tree-sitter-astro#213f6e6",
     "tree-sitter-bash": "^0.25.1",
     "tree-sitter-c": "^0.24.1",
     "tree-sitter-c-sharp": "^0.23.5",
+    "tree-sitter-cli": "^0.27.0",
     "tree-sitter-cpp": "^0.23.4",
     "tree-sitter-css": "^0.25.0",
     "tree-sitter-dart": "^1.0.0",
@@ -109,6 +116,7 @@
     "tree-sitter-scala": "^0.24.0",
     "tree-sitter-solidity": "^1.2.13",
     "tree-sitter-typescript": "^0.23.2",
+    "tree-sitter-vue": "github:tree-sitter-grammars/tree-sitter-vue#ce8011a",
     "typescript": "^6.0.3"
   }
 }

package/src/agents.ts

@@ -38,9 +38,9 @@ const AGENT_NATIVE_TOOLS: Record<AgentId, NativeToolNames> = {
   },
 };
 
-export function agentDestination(agent: AgentId): string {
+export function agentDestination(agent: AgentId, cwd = "."): string {
   const baseDir = agent === "copilot" ? ".github" : `.${agent}`;
-  return join(baseDir, "agents", "miru-code.md");
+  return join(cwd, baseDir, "agents", "miru-code.md");
 }
 
 export async function loadAgentTemplate(agent: AgentId): Promise<string> {
@@ -51,9 +51,9 @@ export async function loadAgentTemplate(agent: AgentId): Promise<string> {
 
 export async function writeAgentFile(
   agent: AgentId,
-  options: { force?: boolean } = {},
+  options: { force?: boolean; cwd?: string } = {},
 ): Promise<string> {
-  const dest = agentDestination(agent);
+  const dest = agentDestination(agent, options.cwd);
   const existing = await Bun.file(dest).exists();
   if (existing && !options.force) {
     throw new Error(`${dest} already exists. Run with --force to overwrite.`);

package/src/auth/device.ts

@@ -205,30 +205,31 @@ export async function checkDeviceAuthorizationOnce(
 
 export async function pollDeviceAuthorization(
   start: DeviceAuthorizationStart,
-  options?: { config?: DeviceAuthConfig; fetchImpl?: typeof fetch },
+  options?: {
+    config?: DeviceAuthConfig;
+    fetchImpl?: typeof fetch;
+    sleepImpl?: (ms: number) => Promise<void>;
+  },
 ): Promise<DeviceAuthorizationTokens> {
   const deadline = Date.now() + start.expiresIn * 1000;
   let intervalMs = start.interval * 1000;
 
   while (Date.now() < deadline) {
-    await sleep(intervalMs);
+    await (options?.sleepImpl ?? sleep)(intervalMs);
 
     const check = await checkDeviceAuthorizationOnce(start, options);
-    if (check.status === "success") {
-      return check.tokens;
-    }
-    if (check.status === "pending") {
-      continue;
-    }
-    if (check.status === "slow_down") {
-      intervalMs += 5_000;
-      continue;
-    }
-    if (check.status === "denied") {
-      throw new Error("Device login was denied.");
-    }
-    if (check.status === "expired") {
-      throw new Error("Device login expired before it was completed.");
+    switch (check.status) {
+      case "success":
+        return check.tokens;
+      case "pending":
+        continue;
+      case "slow_down":
+        intervalMs += 5_000;
+        continue;
+      case "denied":
+        throw new Error("Device login was denied.");
+      case "expired":
+        throw new Error("Device login expired before it was completed.");
     }
   }
 
@@ -284,15 +285,19 @@ export function deviceCredentialsNeedRefresh(credentials: StoredDeviceCodeCreden
   return expiresAt <= Date.now() + EXPIRY_SKEW_MS;
 }
 
-export function openBrowserForDeviceLogin(url: string): boolean {
+export function openBrowserForDeviceLogin(
+  url: string,
+  platform: NodeJS.Platform = process.platform,
+  spawn: typeof Bun.spawn = Bun.spawn,
+): boolean {
   const command =
-    process.platform === "darwin"
+    platform === "darwin"
       ? ["open", url]
-      : process.platform === "win32"
+      : platform === "win32"
         ? ["cmd", "/c", "start", "", url]
         : ["xdg-open", url];
   try {
-    const proc = Bun.spawn(command, {
+    const proc = spawn(command, {
       stdin: "ignore",
       stdout: "ignore",
       stderr: "ignore",

package/src/auth/providers.ts

@@ -20,10 +20,19 @@ export interface AuthenticateOptions {
   interactive?: boolean;
 }
 
-async function promptApiKey(): Promise<string> {
+export interface AuthProviderDependencies {
+  promptHidden?: typeof promptHidden;
+  validateApiKey?: typeof validateEmbeddingApiKey;
+  promptConfirm?: typeof promptConfirm;
+  startDeviceAuthorization?: typeof startDeviceAuthorization;
+  pollDeviceAuthorization?: typeof pollDeviceAuthorization;
+  openBrowser?: (url: string) => boolean;
+}
+
+async function promptApiKey(promptHiddenImpl: typeof promptHidden = promptHidden): Promise<string> {
   let key = "";
   while (!key) {
-    key = await promptHidden("Takara API key (input hidden): ", process.stderr);
+    key = await promptHiddenImpl("Takara API key (input hidden): ", process.stderr);
     if (!key) {
       warn("API key cannot be empty.");
     }
@@ -43,12 +52,13 @@ async function resolveAuthMode(options: AuthenticateOptions): Promise<AuthMode>
 
 async function authenticateWithApiKey(
   options: AuthenticateOptions,
+  dependencies: AuthProviderDependencies,
 ): Promise<AuthenticatedCredentials> {
-  const apiKey = options.apiKey ?? (await promptApiKey());
+  const apiKey = options.apiKey ?? (await promptApiKey(dependencies.promptHidden));
   if (!options.skipValidation) {
     const spinner = new Spinner("Validating API key");
     spinner.start();
-    const result = await validateEmbeddingApiKey({ apiKey });
+    const result = await (dependencies.validateApiKey ?? validateEmbeddingApiKey)({ apiKey });
     if (!result.valid) {
       spinner.stop();
       throw new Error(result.message);
@@ -60,19 +70,20 @@ async function authenticateWithApiKey(
 
 async function authenticateWithDeviceCode(
   options: AuthenticateOptions,
+  dependencies: AuthProviderDependencies,
 ): Promise<AuthenticatedCredentials> {
   writeStderr("");
   const spinner = new Spinner("Authenticating");
   spinner.start();
   try {
-    const start = await startDeviceAuthorization();
+    const start = await (dependencies.startDeviceAuthorization ?? startDeviceAuthorization)();
     const verificationUrl = start.verificationUriComplete ?? start.verificationUri;
 
     const shouldOpenBrowser =
       options.interactive &&
       (process.env.MIRU_OPEN_BROWSER === undefined || process.env.MIRU_OPEN_BROWSER === "1");
     if (shouldOpenBrowser) {
-      openBrowserForDeviceLogin(verificationUrl);
+      (dependencies.openBrowser ?? openBrowserForDeviceLogin)(verificationUrl);
     }
 
     let visit = dim(`  Visit ${verificationUrl}`);
@@ -81,7 +92,7 @@ async function authenticateWithDeviceCode(
     }
     spinner.follow(visit);
 
-    const tokens = await pollDeviceAuthorization(start);
+    const tokens = await (dependencies.pollDeviceAuthorization ?? pollDeviceAuthorization)(start);
     spinner.succeed("");
     return {
       kind: "device_code",
@@ -95,9 +106,12 @@ async function authenticateWithDeviceCode(
     spinner.stop();
     if (options.allowManualFallback && options.interactive) {
       warn(err instanceof Error ? err.message : String(err));
-      const fallback = await promptConfirm("Enter an API key instead?", true);
+      const fallback = await (dependencies.promptConfirm ?? promptConfirm)(
+        "Enter an API key instead?",
+        true,
+      );
       if (fallback) {
-        return authenticateWithApiKey(options);
+        return authenticateWithApiKey(options, dependencies);
       }
     }
     throw err;
@@ -106,10 +120,11 @@ async function authenticateWithDeviceCode(
 
 export async function authenticateWithProvider(
   options: AuthenticateOptions,
+  dependencies: AuthProviderDependencies = {},
 ): Promise<AuthenticatedCredentials> {
   const mode = await resolveAuthMode(options);
   if (mode === "device_code") {
-    return authenticateWithDeviceCode(options);
+    return authenticateWithDeviceCode(options, dependencies);
   }
-  return authenticateWithApiKey(options);
+  return authenticateWithApiKey(options, dependencies);
 }

package/src/benchmark/compare.ts

@@ -49,9 +49,6 @@ function firstGrepMatchLine(hit: GrepFileHit | undefined): number | null {
 }
 
 function expandLineSpan(chunks: { start_line: number; end_line: number }[]): number {
-  if (chunks.length === 0) {
-    return 0;
-  }
   const start = Math.min(...chunks.map((c) => c.start_line));
   const end = Math.max(...chunks.map((c) => c.end_line));
   return end - start + 1;
@@ -74,9 +71,6 @@ async function readLineWindowTokens(
   try {
     const text = await readFile(absPath, "utf-8");
     const lines = text.split("\n");
-    if (lines.length === 0) {
-      return 0;
-    }
     const half = Math.max(1, Math.floor(lineSpan / 2));
     const start = Math.max(1, centerLine - half);
     const end = Math.min(lines.length, centerLine + half);
@@ -127,9 +121,6 @@ function topKOverlapPct(miruFiles: string[], grepFiles: string[]): number {
     return 100;
   }
   const union = new Set([...miruFiles, ...grepFiles]);
-  if (union.size === 0) {
-    return 0;
-  }
   const overlap = miruFiles.filter((file) => grepFiles.includes(file)).length;
   return Math.round((overlap / union.size) * 100);
 }
@@ -169,9 +160,11 @@ export async function benchmarkSearchComparison(options: {
   /** Keep only the best hit per file (default true). Matches MCP `dedupe_by_file`. */
   dedupeByFile?: boolean;
   relevant?: string[];
+  dependencies?: { grepSearch?: typeof grepSearch };
 }): Promise<{ benchmark: SearchBenchmarkBlock; results: SearchResult[] }> {
   const { query, repoPath, index, topK, relevant } = options;
   const dedupeByFile = options.dedupeByFile !== false;
+  const searchGrep = options.dependencies?.grepSearch ?? grepSearch;
   const parallelStart = performance.now();
 
   const miruPromise = (async () => {
@@ -194,7 +187,7 @@ export async function benchmarkSearchComparison(options: {
 
   const grepSearchPromise = (async () => {
     const started = performance.now();
-    const grep = await grepSearch(repoPath, query, topK);
+    const grep = await searchGrep(repoPath, query, topK);
     return { grep, latencyMs: performance.now() - started };
   })();