@ariacode/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aria Code
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,404 @@
+# @ariacode/cli
+
+<p align="center">
+  <img src="./media/aria.jpg" alt="Aria Code" />
+</p>
+
+[![Node.js >=20](https://img.shields.io/node/v/@ariacode/cli.svg)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+[![Build](https://img.shields.io/github/actions/workflow/status/ariacodeai/ariacode/ci.yml?branch=main)](https://github.com/ariacodeai/ariacode/actions)
+[![npm](https://img.shields.io/npm/v/@ariacode/cli)](https://www.npmjs.com/package/@ariacode/cli)
+
+A predictable, terminal-native coding agent for Next.js, Nest.js, Prisma and Node.js projects.
+
+Aria reads your repository, generates safe diffs with preview and tracks every mutation in a local SQLite history — no surprises.
+
+## Requirements
+
+- Node.js 20+
+- `git` (for `review` command)
+- `ripgrep` (for `search_code` tool — fast code search)
+
+## Installation
+
+```bash
+npm install -g @ariacode/cli
+```
+
+After installation the `aria` binary is available globally.
+
+## Quick Start
+
+```bash
+# Ask a question about your codebase
+aria ask "How is authentication handled in this project?"
+
+# Generate an implementation plan (read-only, no changes)
+aria plan "Add rate limiting to the API routes"
+
+# Preview a patch before applying
+aria patch "Rename GeoPage to LandingPage" --dry-run
+
+# Apply a patch with confirmation prompt
+aria patch "Add error boundary to the root layout"
+
+# Review staged git changes
+aria review
+
+# Explore an unfamiliar codebase
+aria explore
+
+# Check your environment
+aria doctor
+```
+
+## Commands
+
+### `aria ask <question>`
+
+Ask a read-only question about the repository. The agent uses `read_file`, `list_directory`, and `search_code` to explore the codebase and answer your question.
+
+```
+aria ask "<question>" [--session <id>] [--max-tokens <n>] [--quiet]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--session <id>` | Resume an existing session |
+| `--max-tokens <n>` | Override max tokens for this response |
+| `--quiet` | Suppress non-essential output |
+
+### `aria plan <goal>`
+
+Generate a structured implementation plan without making any changes. Returns steps, affected files, risks, and implementation notes.
+
+```
+aria plan "<goal>" [--session <id>] [--output <path>]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--session <id>` | Resume an existing session |
+| `--output <path>` | Save the plan as a markdown file |
+
+### `aria patch <description>`
+
+Analyze the repository, propose a unified diff, show a preview, and apply changes atomically after confirmation.
+
+```
+aria patch "<description>" [--dry-run] [--yes] [--session <id>]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--dry-run` | Preview the diff without applying changes |
+| `--yes` | Skip the confirmation prompt |
+| `--session <id>` | Resume an existing session |
+
+### `aria review`
+
+Review git changes with AI assistance. Reads staged changes by default and returns a structured review with summary, issues, and suggestions.
+
+```
+aria review [--unstaged] [--branch <base>] [--format text|json]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--unstaged` | Review unstaged changes instead of staged |
+| `--branch <base>` | Compare current branch to a base branch |
+| `--format json` | Output the review as JSON |
+
+### `aria explore`
+
+Scan the repository structure, detect frameworks and entry points, and summarize architectural patterns.
+
+```
+aria explore [--depth <n>] [--save]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--depth <n>` | Limit directory traversal depth |
+| `--save` | Save the summary to `./.aria/explore.md` |
+
+### `aria history`
+
+Inspect past sessions stored in the local SQLite database.
+
+```
+aria history [--limit <n>] [--session <id>] [--tree]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--limit <n>` | Limit the number of sessions shown |
+| `--session <id>` | Show the full log for a specific session |
+| `--tree` | Render the tool execution tree |
+
+### `aria config`
+
+View and manage configuration.
+
+```
+aria config                        # Show effective config with sources
+aria config get <key>              # Display a specific value
+aria config set <key> <value>      # Write to ~/.aria/config.toml
+aria config path                   # Show config file resolution paths
+aria config init                   # Create ./.aria.toml with defaults
+```
+
+`config set` and `config init` support `--dry-run` and `--yes`.
+
+### `aria doctor`
+
+Run environment diagnostics: Node.js version, git, ripgrep, config validity, history DB, provider API keys, and project detection.
+
+```
+aria doctor [--format text|json]
+```
+
+## Configuration
+
+Aria loads configuration from multiple sources in this precedence order (highest wins):
+
+1. CLI flags
+2. Environment variables
+3. `./.aria.toml` (project-level)
+4. `~/.aria/config.toml` (user-level)
+5. Built-in defaults
+
+### Configuration File Format
+
+```toml
+[provider]
+default = "anthropic"       # anthropic | openai | ollama | openrouter
+model = "claude-sonnet-4-6"
+max_tokens = 4096
+
+[agent]
+max_iterations = 25
+mode = "build"              # build | plan
+timeout_seconds = 120
+
+[safety]
+require_confirm_for_shell = true
+allowed_shell_commands = ["npm", "pnpm", "yarn", "npx", "git", "prisma", "tsc", "node"]
+max_file_size_kb = 1024
+max_files_per_patch = 50
+
+[ui]
+color = "auto"              # auto | always | never
+quiet = false
+
+[history]
+retain_days = 90
+```
+
+Run `aria config init` to generate a `.aria.toml` in the current directory.
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ANTHROPIC_API_KEY` | API key for Anthropic provider |
+| `OPENAI_API_KEY` | API key for OpenAI provider |
+| `OPENROUTER_API_KEY` | API key for OpenRouter provider |
+| `ARIA_PROVIDER` | Override default provider |
+| `ARIA_MODEL` | Override model name |
+| `ARIA_MAX_TOKENS` | Override max tokens |
+| `ARIA_MAX_ITERATIONS` | Override max agent iterations |
+| `ARIA_TIMEOUT_SECONDS` | Override request timeout |
+| `ARIA_COLOR` | Override color mode (`auto`/`always`/`never`) |
+| `ARIA_QUIET` | Set to `true` to suppress non-essential output |
+| `ARIA_RETAIN_DAYS` | Override session retention period |
+| `DEBUG` | Set to `1` to show stack traces on errors |
+
+## Providers
+
+Aria supports four provider backends. Anthropic is the default. OpenRouter gives you access to virtually every hosted model from a single API key.
+
+### Anthropic (default)
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+aria ask "What does this project do?"
+```
+
+| Model | ID |
+|-------|----|
+| Claude Opus 4.6 | `claude-opus-4-6` |
+| Claude Sonnet 4.6 *(default)* | `claude-sonnet-4-6` |
+| Claude Haiku 3.5 | `claude-haiku-3-5` |
+
+### OpenAI
+
+```bash
+export OPENAI_API_KEY=sk-...
+aria config set provider.default openai
+aria config set provider.model gpt-4o
+```
+
+| Model | ID |
+|-------|----|
+| GPT-5 | `gpt-5` |
+| GPT-5.1 | `gpt-5.1` |
+| GPT-4o | `gpt-4o` |
+| GPT-4o mini | `gpt-4o-mini` |
+| o3 | `o3` |
+| o4-mini | `o4-mini` |
+
+### Ollama (local, no API key required)
+
+Run any model locally — no API key needed.
+
+```bash
+# Pull a model first, then point Aria at it
+ollama pull llama4
+aria config set provider.default ollama
+aria config set provider.model llama4
+```
+
+Popular models available via `ollama pull`:
+
+| Model | ID |
+|-------|----|
+| Llama 4 | `llama4` |
+| Llama 3.3 | `llama3.3` |
+| Mistral | `mistral` |
+| Qwen 2.5 Coder | `qwen2.5-coder` |
+| DeepSeek Coder V2 | `deepseek-coder-v2` |
+| Phi-4 | `phi4` |
+| Gemma 3 | `gemma3` |
+
+See the full list at [ollama.com/library](https://ollama.com/library).
+
+### OpenRouter
+
+Access hundreds of hosted models from a single API key — including Claude, GPT, Gemini, Mistral, DeepSeek, Qwen, MiniMax, and more.
+
+```bash
+export OPENROUTER_API_KEY=sk-or-...
+aria config set provider.default openrouter
+aria config set provider.model deepseek/deepseek-r1
+```
+
+**Anthropic via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| Claude Sonnet 4.5 | `anthropic/claude-sonnet-4-5` |
+| Claude Opus 4 | `anthropic/claude-opus-4` |
+| Claude Haiku 3.5 | `anthropic/claude-haiku-3-5` |
+
+**OpenAI via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| GPT-5 | `openai/gpt-5` |
+| GPT-5.1 | `openai/gpt-5.1` |
+| GPT-4o | `openai/gpt-4o` |
+| o3 | `openai/o3` |
+| o4-mini | `openai/o4-mini` |
+
+**Google via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| Gemini 3.1 Pro | `google/gemini-3.1-pro-preview` |
+| Gemini 3.1 Flash | `google/gemini-3.1-flash-preview` |
+| Gemini 2.5 Pro | `google/gemini-2.5-pro-preview` |
+| Gemini 2.5 Flash | `google/gemini-2.5-flash-preview` |
+
+**DeepSeek via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| DeepSeek R1 | `deepseek/deepseek-r1` |
+| DeepSeek V3 | `deepseek/deepseek-chat` |
+| DeepSeek Coder V2 | `deepseek/deepseek-coder` |
+
+**Mistral via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| Mistral Large | `mistralai/mistral-large` |
+| Mistral Small | `mistralai/mistral-small` |
+| Codestral | `mistralai/codestral-2501` |
+
+**Qwen via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| Qwen3 235B | `qwen/qwen3-235b-a22b` |
+| Qwen2.5 Coder 32B | `qwen/qwen-2.5-coder-32b-instruct` |
+| QwQ 32B | `qwen/qwq-32b` |
+
+**Xiaomi MiMo via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| MiMo V2 Pro *(1T params, 1M ctx)* | `xiaomi/mimo-v2-pro` |
+| MiMo V2 Omni *(multimodal)* | `xiaomi/mimo-v2-omni` |
+| MiMo V2 Flash *(open-source, fast)* | `xiaomi/mimo-v2-flash` |
+
+**MiniMax via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| MiniMax M1 | `minimax/minimax-m1` |
+| MiniMax Text 01 | `minimax/minimax-01` |
+
+**Meta via OpenRouter**
+
+| Model | ID |
+|-------|----|
+| Llama 4 Maverick | `meta-llama/llama-4-maverick` |
+| Llama 4 Scout | `meta-llama/llama-4-scout` |
+| Llama 3.3 70B | `meta-llama/llama-3.3-70b-instruct` |
+
+See the full model catalogue at [openrouter.ai/models](https://openrouter.ai/models).
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | Generic error |
+| `2` | Invalid arguments |
+| `3` | Configuration error |
+| `4` | Provider error (e.g. missing API key) |
+| `5` | Project detection error |
+| `130` | User cancelled (Ctrl+C or declined confirmation) |
+
+## Session History
+
+Every command execution is logged to `~/.aria/history.db` (SQLite). Sessions record messages, tool executions, and mutations. The database is created automatically on first run with permissions set to `600` (user-only).
+
+View recent sessions:
+
+```bash
+aria history
+aria history --limit 10
+aria history --session <id>
+aria history --session <id> --tree
+```
+
+Sessions older than `retain_days` (default: 90) are cleaned up automatically.
+
+## Safety
+
+- All file operations are validated against the project root — no writes outside the project directory
+- Path traversal attempts (`../`) and symlink escapes are rejected
+- Shell commands are restricted to an explicit allowlist
+- `.env` files and `node_modules` are excluded from directory listings by default
+- API keys are never logged to the history database or terminal output
+- All mutations require confirmation unless `--yes` is passed
+
+## Contributing
+
+Contributions are welcome. Please open an issue or pull request at [github.com/ariacodeai/ariacode](https://github.com/ariacodeai/ariacode).
+
+## License
+
+MIT — see [LICENSE](./LICENSE)

package/dist/actions.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Command implementations for Aria Code CLI
+ *
+ * Each exported function corresponds to a CLI command and orchestrates:
+ * - Configuration loading
+ * - Project detection
+ * - Session management
+ * - Agent loop execution
+ * - Terminal output
+ */
+/**
+ * Options parsed from CLI flags for the ask command.
+ */
+export interface AskOptions {
+    /** The question to ask (required) */
+    question: string;
+    /** Resume an existing session by ID */
+    session?: string;
+    /** Override max tokens for this invocation */
+    maxTokens?: number;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+    /** Project root (defaults to process.cwd()) */
+    projectRoot?: string;
+}
+/**
+ * Execute the ask command.
+ *
+ * Flow:
+ * 1. Load configuration and detect project type          (Req 9.1)
+ * 2. Create or resume session with mode: "plan"          (Req 9.2, 9.9)
+ * 3. Build system prompt from ask.md template            (Req 9.3)
+ * 4. Expose only read-only tools                         (Req 9.4)
+ * 5. Execute agent loop                                  (Req 9.5, 9.6)
+ * 6. Render response to terminal                         (Req 9.7)
+ * 7. Persist session to database                         (Req 9.8)
+ *
+ * Requirements: 9.1, 9.2, 9.3, 9.4, 9.5, 9.6, 9.7, 9.8, 9.9
+ */
+export declare function runAsk(options: AskOptions): Promise<void>;
+/**
+ * Options parsed from CLI flags for the plan command.
+ */
+export interface PlanOptions {
+    /** The implementation goal (required) */
+    goal: string;
+    /** Resume an existing session by ID */
+    session?: string;
+    /** Save plan as markdown file at specified path */
+    output?: string;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+    /** Project root (defaults to process.cwd()) */
+    projectRoot?: string;
+}
+/**
+ * Execute the plan command.
+ *
+ * Flow:
+ * 1. Load configuration and detect project type          (Req 10.1)
+ * 2. Create or resume session with mode: "plan"          (Req 10.2, 10.8)
+ * 3. Build system prompt from plan.md template           (Req 10.3)
+ * 4. Expose only read-only tools                         (Req 10.4)
+ * 5. Execute agent loop                                  (Req 10.5)
+ * 6. Render structured plan to terminal                  (Req 10.6)
+ * 7. Save to file if --output flag provided              (Req 10.7)
+ * 8. Persist session to database                         (Req 10.8)
+ *
+ * Requirements: 10.1, 10.2, 10.3, 10.4, 10.5, 10.6, 10.7, 10.8
+ */
+export declare function runPlan(options: PlanOptions): Promise<void>;
+/**
+ * Options parsed from CLI flags for the patch command.
+ */
+export interface PatchOptions {
+    /** Description of the changes to make (required) */
+    description: string;
+    /** Preview changes without applying them */
+    dryRun?: boolean;
+    /** Skip confirmation prompt */
+    yes?: boolean;
+    /** Resume an existing session by ID */
+    session?: string;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+    /** Project root (defaults to process.cwd()) */
+    projectRoot?: string;
+}
+/**
+ * Execute the patch command.
+ *
+ * Flow:
+ * 1. Load configuration and detect project type          (Req 11.1)
+ * 2. Create session with mode: "build"                   (Req 11.2)
+ * 3. Build system prompt from patch.md template          (Req 11.3)
+ * 4. Expose read-only + mutation tools                   (Req 11.4)
+ * 5. Execute agent loop — agent calls propose_diff       (Req 11.4, 11.5)
+ * 6. Render diff preview with syntax highlighting        (Req 11.6)
+ * 7. Render mutation summary                             (Req 11.7)
+ * 8. If --dry-run, exit with code 0                      (Req 11.8, 17.3, 17.4)
+ * 9. If not --yes, prompt for confirmation               (Req 11.9, 17.5)
+ * 10. Agent calls apply_diff atomically                  (Req 11.10, 11.11, 11.12)
+ * 11. Log mutation to database                           (Req 11.11)
+ * 12. Display rollback hints                             (Req 11.12, 17.9)
+ * 13. Persist session to database                        (Req 11.13)
+ *
+ * Requirements: 11.1–11.13, 17.1–17.9
+ */
+export declare function runPatch(options: PatchOptions): Promise<void>;
+/**
+ * Options parsed from CLI flags for the review command.
+ */
+export interface ReviewOptions {
+    /** Read unstaged changes instead of staged */
+    unstaged?: boolean;
+    /** Compare current branch to specified base branch */
+    branch?: string;
+    /** Output format: "text" (default) or "json" */
+    format?: "text" | "json";
+    /** Suppress non-essential output */
+    quiet?: boolean;
+    /** Project root (defaults to process.cwd()) */
+    projectRoot?: string;
+}
+/**
+ * Structured review returned by the provider.
+ */
+export interface ReviewResult {
+    summary: string;
+    issues: Array<{
+        severity: "HIGH" | "MEDIUM" | "LOW";
+        description: string;
+    }>;
+    suggestions: string[];
+}
+/**
+ * Execute the review command.
+ *
+ * Flow:
+ * 1. Parse flags and load configuration                  (Req 12.1)
+ * 2. Detect project type                                 (Req 12.1)
+ * 3. Create session with mode: "plan"                    (Req 12.2)
+ * 4. Read git diff (staged / unstaged / branch)          (Req 12.3, 12.4, 12.5)
+ * 5. Build system prompt from review.md template         (Req 12.6)
+ * 6. Send diff + project context to provider             (Req 12.6)
+ * 7. Parse structured review (summary, issues, suggestions) (Req 12.7)
+ * 8. Render review to terminal                           (Req 12.8)
+ * 9. Output JSON if --format json                        (Req 12.9)
+ * 10. Persist session to database                        (Req 12.10)
+ *
+ * Requirements: 12.1, 12.2, 12.3, 12.4, 12.5, 12.6, 12.7, 12.8, 12.9, 12.10
+ */
+export declare function runReview(options: ReviewOptions): Promise<void>;
+/**
+ * Options parsed from CLI flags for the explore command.
+ */
+export interface ExploreOptions {
+    /** Limit directory traversal depth */
+    depth?: number;
+    /** Save exploration summary to ./.aria/explore.md */
+    save?: boolean;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+    /** Project root (defaults to process.cwd()) */
+    projectRoot?: string;
+}
+/**
+ * Execute the explore command.
+ *
+ * Flow:
+ * 1. Parse flags and load configuration                  (Req 13.1)
+ * 2. Detect project type                                 (Req 13.1)
+ * 3. Create session with mode: "plan"                    (Req 13.2)
+ * 4. Scan repository structure respecting .gitignore     (Req 13.3)
+ * 5. Detect frameworks and key configuration files       (Req 13.4)
+ * 6. Identify entry points based on project type         (Req 13.5)
+ * 7. Build system prompt from explore.md template        (Req 13.3–13.6)
+ * 8. Execute agent loop to summarize structure/patterns  (Req 13.6)
+ * 9. Render exploration summary to terminal              (Req 13.7)
+ * 10. Save to ./.aria/explore.md if --save flag          (Req 13.8)
+ * 11. Persist session to database                        (Req 13.10)
+ *
+ * Requirements: 13.1, 13.2, 13.3, 13.4, 13.5, 13.6, 13.7, 13.8, 13.9, 13.10
+ */
+export declare function runExplore(options: ExploreOptions): Promise<void>;
+/**
+ * Options parsed from CLI flags for the history command.
+ */
+export interface HistoryOptions {
+    /** Limit number of sessions listed */
+    limit?: number;
+    /** Show full log for a specific session ID */
+    session?: string;
+    /** Render tool execution tree */
+    tree?: boolean;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+    /** Project root (defaults to process.cwd()) */
+    projectRoot?: string;
+}
+/**
+ * Execute the history command.
+ *
+ * Flow:
+ * 1. If no --session flag: list recent sessions in a table  (Req 14.2, 14.3, 14.4)
+ * 2. If --session flag: display full session log            (Req 14.5)
+ * 3. If --tree flag: render tool execution tree             (Req 14.6)
+ * 4. Format timestamps in human-readable format             (Req 14.7)
+ * 5. Support pagination for large result sets               (Req 14.8)
+ *
+ * Requirements: 14.1, 14.2, 14.3, 14.4, 14.5, 14.6, 14.7, 14.8
+ */
+export declare function runHistory(options: HistoryOptions): Promise<void>;
+/**
+ * Options parsed from CLI flags for the config command.
+ */
+export interface ConfigOptions {
+    /** Subcommand: get, set, path, init */
+    subcommand?: "get" | "set" | "path" | "init";
+    /** Configuration key (for get/set) */
+    key?: string;
+    /** Configuration value (for set) */
+    value?: string;
+    /** Preview changes without writing */
+    dryRun?: boolean;
+    /** Skip confirmation prompt */
+    yes?: boolean;
+    /** Suppress non-essential output */
+    quiet?: boolean;
+    /** Project root (defaults to process.cwd()) */
+    projectRoot?: string;
+}
+/**
+ * Execute the config command.
+ *
+ * Subcommands:
+ * - (none): Display effective configuration with precedence sources  (Req 15.2)
+ * - get <key>: Display value for specified key                       (Req 15.3)
+ * - set <key> <value>: Write key-value to ~/.aria/config.toml        (Req 15.4–15.6, 15.10)
+ * - path: Display configuration file resolution paths               (Req 15.7)
+ * - init: Create ./.aria.toml with default values                   (Req 15.8, 15.9)
+ *
+ * Requirements: 15.1–15.10
+ */
+export declare function runConfig(options: ConfigOptions): Promise<void>;
+/**
+ * Options parsed from CLI flags for the doctor command.
+ */
+export interface DoctorOptions {
+    /** Output format: "text" (default) or "json" */
+    format?: "text" | "json";
+    /** Project root (defaults to process.cwd()) */
+    projectRoot?: string;
+}
+/**
+ * A single diagnostic check result.
+ */
+export interface DiagnosticCheck {
+    name: string;
+    status: "pass" | "fail" | "warn";
+    message: string;
+}
+/**
+ * Execute the doctor command.
+ *
+ * Runs a series of environment diagnostic checks and reports results.
+ * Exits with code 1 if any critical check fails.
+ *
+ * Requirements: 16.1–16.13
+ */
+export declare function runDoctor(options?: DoctorOptions): Promise<void>;