repotracer 1.0.0 → 2.1.0

package/README.md

@@ -1,6 +1,10 @@
 # repotracer
 
-RepoTracer is an MCP server whose `repo_scout` tool runs an isolated, read-only Luna process and returns validated source citations to Codex Sol.
+RepoTracer is an MCP server for read-only repository investigations in Codex
+and Claude Code. Its `repo_scout` tool returns a model-authored report with
+source excerpts and validated file citations. Citation validation checks that
+locations exist inside the selected repository; it does not prove the report's
+conclusions.
 
 ## Setup
 
@@ -8,50 +12,87 @@ RepoTracer is an MCP server whose `repo_scout` tool runs an isolated, read-only
 npx repotracer@latest setup
 ```
 
-The installer downloads the native binary, verifies its SHA-256 checksum, copies it to `~/.repotracer/bin/repotracer`, registers the stdio MCP server, and adds a managed routing block to `~/.codex/AGENTS.md`.
+In an interactive terminal, the v2 setup wizard lets you choose Codex, Claude
+Code, or both, then choose a scout model. Defaults are:
 
-Codex must already be installed, but you can set up RepoTracer before signing in.
-When a scout runs, RepoTracer reuses the current Codex login and provider instead
-of requiring another API key.
+- Codex parent -> Codex scout: `gpt-5.6-luna`
+- Claude Code parent -> Claude scout: `sonnet`
+
+These are defaults, not cost or quality promises. RepoTracer uses each native
+CLI's existing login. It does not require a second subscription key.
+
+For scripted setup:
 
 ```bash
-npm install -g @openai/codex
-npx repotracer@latest setup
-codex login
-repotracer doctor
+npx repotracer@latest setup --agents codex
+npx repotracer@latest setup --agents claude
+npx repotracer@latest setup --agents both --dry-run
 ```
 
-Preview without changing files:
+The Codex integration requires the `codex` executable. The Claude Code
+integration requires `claude`. Setup checks that the executable is available;
+the native CLI handles authentication when a scout runs. Restart the parent
+agent after setup.
+
+## Settings
 
 ```bash
-npx repotracer@latest setup --dry-run
+npx repotracer@latest settings
 ```
 
-RepoTracer updates automatically. Restart Codex after an update for it to take
-effect. To disable automatic updates, set `updates.automatic = false` in
-`~/.repotracer/config.toml` or set `REPOTRACER_NO_UPDATE=1`. Running
-`npx repotracer@latest setup` still updates a disabled installation.
+The TUI uses two steps. First choose the parent integrations. Then accept
+recommended models or keep saved choices. Open `Advanced` to search and
+review a different provider/model for each parent. The
+Custom API form accepts a base URL, model ID, and optional API key. Keys
+require HTTPS; unauthenticated local endpoints can use HTTP. Use the flags
+below for native model IDs. Esc and Ctrl-C cancel, and nothing is written
+before the final save.
 
-## Commands
+For automation, use explicit settings flags:
 
 ```bash
-repotracer "where is auth handled?"
-repotracer scout "trace refresh token rotation"
-repotracer doctor
-repotracer status
-repotracer uninstall --yes
+npx repotracer@latest settings --agents both \
+  --codex-scout codex --codex-model gpt-5.6-luna \
+  --claude-scout claude --claude-model sonnet
 ```
 
-## Permanent install
+Use `--dry-run` to preview changes. Parent profiles are independent.
+
+## Commands
 
 ```bash
-npm install -g repotracer
-# or
-cargo install --git https://github.com/repotracer/repotracer --locked repotracer
+npx repotracer@latest "where is authentication handled?"
+npx repotracer@latest scout "trace token refresh" --intent diagnose
+npx repotracer@latest symbols "Config" --mode references
+npx repotracer@latest serve
+npx repotracer@latest doctor
+npx repotracer@latest status
+npx repotracer@latest update
+npx repotracer@latest uninstall --yes
 ```
 
-Supported platforms: macOS arm64 and x64, Linux arm64 and x64, and Windows x64. Node.js 18 or newer.
+`serve` runs the MCP server over stdio. `symbols` performs a local syntax
+lookup without a model call. Add `--json` to `scout`, `doctor`, or `status`.
+
+The MCP tool requires `query`; `repository`, `focus`, and `investigation` are
+optional. Related follow-ups can pass the returned
+`conversation.id` as `investigation.conversation_id`. Claude uses Read, Grep,
+and Glob; Codex uses a read-only shell and optional Symbols lookup. Neither
+scout receives editing tools or external MCP servers.
+
+## Timeouts and support
+
+Warm provider processes may be retained for related work. `session.idle_secs`
+retires an inactive warm process; it is not a total request timeout. The
+optional `model.timeout_ms` limit measures stream inactivity, while
+`explorer.timeout_seconds` limits a whole investigation only in the generic
+OpenAI-compatible engine, not the native scouts. Both default to zero.
+
+Node.js 18 or newer is required for the launcher. Published native packages
+target macOS arm64 and x64, Linux arm64 and x64, and Windows x64. The v2
+release candidate has passed GitHub CI on Linux, macOS, and Windows.
 
-Read the [documentation and benchmarks](https://github.com/repotracer/repotracer).
+RepoTracer does not promise lower cost, faster completion, or a particular
+answer quality. Provider and parent-agent behavior affect each result.
 
-MIT licensed.
+MIT licensed. See the [repository documentation](https://github.com/repotracer/repotracer).

package/bin/repotracer.js

@@ -34,8 +34,24 @@ function findBinary() {
   return candidates.find(candidate => fs.existsSync(candidate)) || null;
 }
 
+function topLevelCommand(args) {
+  const valuedOptions = new Set(['--root', '--config', '--model', '--base-url']);
+  const flags = new Set(['--json', '--mock', '--verbose', '-v']);
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (valuedOptions.has(arg)) {
+      index += 1;
+    } else if (valuedOptions.has(arg.split('=')[0]) || flags.has(arg)) {
+      continue;
+    } else {
+      return arg.startsWith('-') ? null : arg;
+    }
+  }
+  return null;
+}
+
 function persistForSetup(bin, args, home = os.homedir()) {
-  if (!path.isAbsolute(bin) || !args.includes('setup') || args.includes('--dry-run')) return bin;
+  if (!path.isAbsolute(bin) || !['setup', 'settings', 'reconfigure'].includes(topLevelCommand(args)) || args.includes('--dry-run')) return bin;
 
   const name = process.platform === 'win32' ? 'repotracer.exe' : 'repotracer';
   const directory = path.join(home, '.repotracer', 'bin');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "repotracer",
-  "version": "1.0.0",
-  "description": "Get up to 60% more from your Codex limits. A cheaper model searches your repo so Codex stops burning turns on it.",
+  "version": "2.1.0",
+  "description": "Read-only repository investigations for Codex and Claude Code using a separately configured scout model.",
   "bin": {
     "repotracer": "bin/repotracer.js"
   },