terminal-jarvis 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,93 @@
+# Terminal Jarvis
+
+Terminal Jarvis is being simplified into a small Rust CLI that switches between
+coding-agent harnesses through data contracts instead of hard-coded tool logic.
+
+The v0.1 line is a breaking minor revision focused on the harness catalog,
+local release checks, and compact distribution surfaces.
+
+## Quick Start
+
+```bash
+cargo run -- list
+cargo run -- show codex
+cargo run -- plan codex headless
+cargo run -- use opencode
+cargo run -- current
+```
+
+Run the verification gate with:
+
+```bash
+scripts/verify.sh
+```
+
+Run the stronger local gate with security and package checks:
+
+```bash
+scripts/local-ci.sh
+```
+
+Exercise the local release asset shape without tagging or publishing:
+
+```bash
+scripts/local-cd.sh --check-auth
+```
+
+## Development Environment
+
+Prefer a remote or disposable Linux workspace for Terminal Jarvis development:
+Codespaces, a short-lived VM/container, or an SSH development host. Coding-agent
+harnesses install binaries, inspect repositories, and can run delegated commands,
+so avoid testing new harness plans directly on a daily-driver machine.
+
+Keep provider tokens scoped to the work, mount only the repositories being
+tested, and treat `headless`, `install`, `update`, and `yolo` capability plans as
+commands to review before execution.
+
+## New Layout
+
+```text
+terminal-jarvis/
+├── docs/           # redesign notes and migration guidance
+├── harnesses/      # data contracts for coding-agent harness capabilities
+├── src/            # slim Rust CLI
+└── tests/          # behavior and contract tests
+```
+
+The initial catalog promotes 25 coding-agent harnesses into a shared descriptor
+shape. Each harness owns the same capability folders:
+
+```text
+harnesses/<harness>/{download,update,headless,version,stats,models,security,yolo,ui}/index.toml
+```
+
+The CLI loads those files, validates that every harness exposes the full
+capability contract, prints setup guidance, stores the active harness, and can
+run a selected capability command when the user asks for it.
+
+Auth setup is tracked at the harness level. A harness can require no key, one of
+several provider keys, or all listed keys. That keeps setup guidance accurate
+without forcing users to configure every provider a tool supports.
+
+## Design Goals
+
+- Keep Rust source files at 100 lines or fewer.
+- Keep dependencies at zero until a dependency proves its value.
+- Keep user context local and explicit.
+- Prefer harness data over Rust conditionals.
+- Keep the v0.1 root easy to inspect while this minor revision breaks old
+  interfaces deliberately.
+- Aim for 90 percent or better line coverage and mutation score as the CLI
+  stabilizes.
+
+## Release Path
+
+Cargo is the active development surface. Minimal npm and Homebrew source-build
+surfaces are included for smoke testing, while `scripts/package-release.sh`
+builds versioned archives, checksums, npm staging files, and generated Homebrew
+formula output. Tagged releases use `.github/workflows/cd-multiplatform.yml` to
+publish the crate, GitHub release assets, Homebrew tap update, and npm package.
+
+See [docs/release-plan.md](docs/release-plan.md) for the v0.1 release checklist and
+auth boundaries.

package/bin/terminal-jarvis

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+const { existsSync } = require("node:fs");
+const { dirname, resolve } = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const args = process.argv.slice(2);
+const here = dirname(__filename);
+const repo = resolve(here, "../../..");
+const candidates = [
+  process.env.TERMINAL_JARVIS_BIN,
+  resolve(here, "terminal-jarvis-bin"),
+  resolve(repo, "target/release/terminal-jarvis"),
+  resolve(repo, "target/debug/terminal-jarvis"),
+].filter(Boolean);
+
+for (const binary of candidates) {
+  if (existsSync(binary)) {
+    const result = spawnSync(binary, args, { stdio: "inherit" });
+    process.exit(result.status ?? 1);
+  }
+}
+
+if (existsSync(resolve(repo, "Cargo.toml"))) {
+  const result = spawnSync("cargo", ["run", "--quiet", "--", ...args], {
+    cwd: repo,
+    stdio: "inherit",
+  });
+  process.exit(result.status ?? 1);
+}
+
+console.error("terminal-jarvis binary is missing; reinstall or set TERMINAL_JARVIS_BIN");
+process.exit(1);

package/harnesses/aider/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Aider from its documented distribution channel."
+command = "uv"
+args = ["tool", "install", "--force", "--python", "python3.12", "--with", "pip", "aider-chat@latest"]

package/harnesses/aider/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Aider headless invocation options."
+command = "aider"
+args = ["--help"]

package/harnesses/aider/index.toml

@@ -0,0 +1,6 @@
+name = "aider"
+display = "Aider"
+description = "AI pair programming assistant that edits code in your local git repository"
+binary = "aider"
+env_mode = "any"
+env = ["OPENROUTER_API_KEY", "OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GEMINI_API_KEY", "AZURE_API_KEY"]

package/harnesses/aider/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Aider model selection command surface."
+command = "aider"
+args = ["--help"]

package/harnesses/aider/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Aider security and auth command surface."
+command = "aider"
+args = ["--help"]

package/harnesses/aider/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Aider local status and usage command surface."
+command = "aider"
+args = ["--help"]

package/harnesses/aider/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Aider interface."
+command = "aider"
+args = []

package/harnesses/aider/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update Aider without interactive setup flows."
+command = "uv"
+args = ["tool", "upgrade", "aider-chat"]

package/harnesses/aider/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print or verify the installed Aider version."
+command = "sh"
+args = ["-c", "aider --version"]

package/harnesses/aider/yolo/index.toml

@@ -0,0 +1,3 @@
+summary = "Dangerous mode is not normalized for Aider yet."
+command = "sh"
+args = ["-c", "echo danger yolo mode is not configured for aider; exit 1"]

package/harnesses/amp/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Amp from its documented distribution channel."
+command = "npm"
+args = ["install", "-g", "@sourcegraph/amp"]

package/harnesses/amp/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Amp headless invocation options."
+command = "amp"
+args = ["--help"]

package/harnesses/amp/index.toml

@@ -0,0 +1,6 @@
+name = "amp"
+display = "Amp"
+description = "Sourcegraph's AI-powered code assistant with advanced context awareness"
+binary = "amp"
+env_mode = "any"
+env = ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "AMP_API_KEY"]

package/harnesses/amp/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Amp model selection command surface."
+command = "amp"
+args = ["--help"]

package/harnesses/amp/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Amp security and auth command surface."
+command = "amp"
+args = ["--help"]

package/harnesses/amp/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Amp local status and usage command surface."
+command = "amp"
+args = ["--help"]

package/harnesses/amp/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Amp interface."
+command = "amp"
+args = []

package/harnesses/amp/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update Amp without interactive setup flows."
+command = "npm"
+args = ["update", "-g", "@sourcegraph/amp"]

package/harnesses/amp/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print or verify the installed Amp version."
+command = "sh"
+args = ["-c", "amp --version"]

package/harnesses/amp/yolo/index.toml

@@ -0,0 +1,3 @@
+summary = "Dangerous mode is not normalized for Amp yet."
+command = "sh"
+args = ["-c", "echo danger yolo mode is not configured for amp; exit 1"]

package/harnesses/claude/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Claude from its documented distribution channel."
+command = "sh"
+args = ["-c", "curl -fsSL https://claude.ai/install.sh | bash"]

package/harnesses/claude/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Claude headless invocation options."
+command = "claude"
+args = ["--help"]

package/harnesses/claude/index.toml

@@ -0,0 +1,6 @@
+name = "claude"
+display = "Claude"
+description = "Anthropic's Claude for code assistance"
+binary = "claude"
+env_mode = "any"
+env = ["ANTHROPIC_API_KEY", "CLAUDE_API_KEY"]

package/harnesses/claude/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Claude model selection command surface."
+command = "claude"
+args = ["--help"]

package/harnesses/claude/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Claude security and auth command surface."
+command = "claude"
+args = ["--help"]

package/harnesses/claude/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Claude local status and usage command surface."
+command = "claude"
+args = ["--help"]

package/harnesses/claude/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Claude interface."
+command = "claude"
+args = []

package/harnesses/claude/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update Claude without interactive setup flows."
+command = "claude"
+args = ["update"]

package/harnesses/claude/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print or verify the installed Claude version."
+command = "sh"
+args = ["-c", "claude --version"]

package/harnesses/claude/yolo/index.toml

@@ -0,0 +1,3 @@
+summary = "Dangerous mode is not normalized for Claude yet."
+command = "sh"
+args = ["-c", "echo danger yolo mode is not configured for claude; exit 1"]

package/harnesses/code/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Code from its documented distribution channel."
+command = "npm"
+args = ["install", "-g", "@just-every/code"]

package/harnesses/code/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Code headless invocation options."
+command = "coder"
+args = ["--help"]

package/harnesses/code/index.toml

@@ -0,0 +1,6 @@
+name = "code"
+display = "Code"
+description = "Fork of Codex AI - multi-provider coding agent"
+binary = "coder"
+env_mode = "any"
+env = ["OPENAI_API_KEY"]

package/harnesses/code/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Code model selection command surface."
+command = "coder"
+args = ["--help"]

package/harnesses/code/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Code security and auth command surface."
+command = "coder"
+args = ["--help"]

package/harnesses/code/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Code local status and usage command surface."
+command = "coder"
+args = ["--help"]

package/harnesses/code/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Code interface."
+command = "coder"
+args = []

package/harnesses/code/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update Code without interactive setup flows."
+command = "npm"
+args = ["update", "-g", "@just-every/code"]

package/harnesses/code/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print or verify the installed Code version."
+command = "sh"
+args = ["-c", "coder --version"]

package/harnesses/code/yolo/index.toml

@@ -0,0 +1,3 @@
+summary = "Dangerous mode is not normalized for Code yet."
+command = "sh"
+args = ["-c", "echo danger yolo mode is not configured for code; exit 1"]

package/harnesses/codex/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Codex with npm without sudo."
+command = "npm"
+args = ["install", "-g", "@openai/codex"]

package/harnesses/codex/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Run Codex in a headless command mode when the CLI supports it."
+command = "codex"
+args = ["exec"]

package/harnesses/codex/index.toml

@@ -0,0 +1,6 @@
+name = "codex"
+display = "OpenAI Codex"
+description = "OpenAI coding agent CLI"
+binary = "codex"
+env_mode = "any"
+env = ["OPENAI_API_KEY", "CODEX_API_KEY"]

package/harnesses/codex/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Show local Codex help until model listing is normalized."
+command = "codex"
+args = ["--help"]

package/harnesses/codex/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Codex sandbox and approval settings before running."
+command = "codex"
+args = ["--help"]

package/harnesses/codex/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Show local Codex help until a stable stats command is defined."
+command = "codex"
+args = ["--help"]

package/harnesses/codex/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Codex terminal UI."
+command = "codex"
+args = []

package/harnesses/codex/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update the npm-installed Codex package without interactive auth."
+command = "npm"
+args = ["update", "-g", "@openai/codex"]

package/harnesses/codex/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print the installed Codex version."
+command = "codex"
+args = ["--version"]

package/harnesses/codex/yolo/index.toml

@@ -0,0 +1,3 @@
+summary = "Dangerous mode: bypass Codex approvals and sandboxing."
+command = "codex"
+args = ["--dangerously-bypass-approvals-and-sandbox"]

package/harnesses/copilot/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Copilot from its documented distribution channel."
+command = "npm"
+args = ["install", "-g", "@github/copilot"]

package/harnesses/copilot/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Copilot headless invocation options."
+command = "copilot"
+args = ["--help"]

package/harnesses/copilot/index.toml

@@ -0,0 +1,6 @@
+name = "copilot"
+display = "Copilot"
+description = "GitHub Copilot CLI - AI pair programming directly in your terminal"
+binary = "copilot"
+env_mode = "any"
+env = ["GITHUB_TOKEN", "GH_TOKEN"]

package/harnesses/copilot/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Copilot model selection command surface."
+command = "copilot"
+args = ["--help"]

package/harnesses/copilot/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Copilot security and auth command surface."
+command = "copilot"
+args = ["--help"]

package/harnesses/copilot/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Copilot local status and usage command surface."
+command = "copilot"
+args = ["--help"]

package/harnesses/copilot/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Copilot interface."
+command = "copilot"
+args = []

package/harnesses/copilot/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update Copilot without interactive setup flows."
+command = "npm"
+args = ["update", "-g", "@github/copilot"]

package/harnesses/copilot/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print or verify the installed Copilot version."
+command = "sh"
+args = ["-c", "copilot --version"]

package/harnesses/copilot/yolo/index.toml

@@ -0,0 +1,3 @@
+summary = "Dangerous mode is not normalized for Copilot yet."
+command = "sh"
+args = ["-c", "echo danger yolo mode is not configured for copilot; exit 1"]

package/harnesses/crush/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Crush from its documented distribution channel."
+command = "npm"
+args = ["install", "-g", "@charmland/crush"]

package/harnesses/crush/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Crush headless invocation options."
+command = "crush"
+args = ["--help"]

package/harnesses/crush/index.toml

@@ -0,0 +1,6 @@
+name = "crush"
+display = "Crush"
+description = "Charm's multi-model AI assistant with LSP"
+binary = "crush"
+env_mode = "any"
+env = ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "CHARM_API_KEY"]

package/harnesses/crush/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Crush model selection command surface."
+command = "crush"
+args = ["--help"]

package/harnesses/crush/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Crush security and auth command surface."
+command = "crush"
+args = ["--help"]

package/harnesses/crush/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Crush local status and usage command surface."
+command = "crush"
+args = ["--help"]

package/harnesses/crush/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Crush interface."
+command = "crush"
+args = []

package/harnesses/crush/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update Crush without interactive setup flows."
+command = "npm"
+args = ["update", "-g", "@charmland/crush"]

package/harnesses/crush/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print or verify the installed Crush version."
+command = "sh"
+args = ["-c", "crush --version"]

package/harnesses/crush/yolo/index.toml

@@ -0,0 +1,3 @@
+summary = "Dangerous mode is not normalized for Crush yet."
+command = "sh"
+args = ["-c", "echo danger yolo mode is not configured for crush; exit 1"]

package/harnesses/cursor-agent/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Cursor Agent from its documented distribution channel."
+command = "pip"
+args = ["install", "cursor-agent-tools"]

package/harnesses/cursor-agent/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Cursor Agent headless invocation options."
+command = "cursor-agent"
+args = ["--help"]

package/harnesses/cursor-agent/index.toml

@@ -0,0 +1,6 @@
+name = "cursor-agent"
+display = "Cursor Agent"
+description = "AI agent replicating Cursor's capabilities in the CLI"
+binary = "cursor-agent"
+env_mode = "any"
+env = ["OPENAI_API_KEY", "ANTHROPIC_API_KEY"]

package/harnesses/cursor-agent/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Cursor Agent model selection command surface."
+command = "cursor-agent"
+args = ["--help"]

package/harnesses/cursor-agent/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Cursor Agent security and auth command surface."
+command = "cursor-agent"
+args = ["--help"]

package/harnesses/cursor-agent/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Cursor Agent local status and usage command surface."
+command = "cursor-agent"
+args = ["--help"]

package/harnesses/cursor-agent/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Cursor Agent interface."
+command = "cursor-agent"
+args = []

package/harnesses/cursor-agent/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update Cursor Agent without interactive setup flows."
+command = "pip"
+args = ["install", "--upgrade", "cursor-agent-tools"]

package/harnesses/cursor-agent/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print or verify the installed Cursor Agent version."
+command = "sh"
+args = ["-c", "cursor-agent --help"]

package/harnesses/cursor-agent/yolo/index.toml

@@ -0,0 +1,3 @@
+summary = "Dangerous mode is not normalized for Cursor Agent yet."
+command = "sh"
+args = ["-c", "echo danger yolo mode is not configured for cursor-agent; exit 1"]

package/harnesses/droid/download/index.toml

@@ -0,0 +1,3 @@
+summary = "Install Droid from its documented distribution channel."
+command = "sh"
+args = ["-c", "curl -fsSL https://app.factory.ai/cli | sh"]

package/harnesses/droid/headless/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Droid headless invocation options."
+command = "droid"
+args = ["--help"]

package/harnesses/droid/index.toml

@@ -0,0 +1,6 @@
+name = "droid"
+display = "Droid"
+description = "Factory AI's Droid - Automated coding engineer"
+binary = "droid"
+env_mode = "any"
+env = ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "FACTORY_API_KEY"]

package/harnesses/droid/models/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Droid model selection command surface."
+command = "droid"
+args = ["--help"]

package/harnesses/droid/security/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Droid security and auth command surface."
+command = "droid"
+args = ["--help"]

package/harnesses/droid/stats/index.toml

@@ -0,0 +1,3 @@
+summary = "Review Droid local status and usage command surface."
+command = "droid"
+args = ["--help"]

package/harnesses/droid/ui/index.toml

@@ -0,0 +1,3 @@
+summary = "Open the interactive Droid interface."
+command = "droid"
+args = []

package/harnesses/droid/update/index.toml

@@ -0,0 +1,3 @@
+summary = "Update Droid without interactive setup flows."
+command = "droid"
+args = ["update"]

package/harnesses/droid/version/index.toml

@@ -0,0 +1,3 @@
+summary = "Print or verify the installed Droid version."
+command = "sh"
+args = ["-c", "droid --version"]