agentsmd-medic 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 weugit
+
+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

@@ -1,3 +1,306 @@
-# Temporary Holding Version
+# agentsmd-medic
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Lint [AGENTS.md](https://agents.md) files: the instruction files AI coding agents read from a repository.
+
+[![CI](https://github.com/weugit/agentsmd-medic/actions/workflows/ci.yml/badge.svg)](https://github.com/weugit/agentsmd-medic/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/agentsmd-medic)](https://www.npmjs.com/package/agentsmd-medic)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+agentsmd-medic checks those instructions before an agent follows them. It flags empty files, broken links, paths and commands that are not in the repo, mixed package managers, unfinished placeholders, and credential-shaped strings. It is a TypeScript ESM CLI with no runtime dependencies.
+
+The npm package is not published yet. See [Install](#install).
+
+## Why
+
+[AGENTS.md](https://agents.md) is the open format read by OpenAI Codex, Cursor, GitHub Copilot, and others. Codex merges `AGENTS.md` files from the repository root down to the working directory. A closer file takes precedence. `AGENTS.override.md` overrides. Project docs are capped at 32 KiB by default via `project_doc_max_bytes`.
+
+Stale paths, stale commands, leaked secrets, and contradictions do not fail the agent run. They silently degrade what the agent does. This linter checks the files on your machine and prints a report. It does not upload them.
+
+## Install
+
+After the package is on npm:
+
+```bash
+npx agentsmd-medic
+npm install -D agentsmd-medic
+```
+
+It is not published yet. Until then, clone the repository and run the built CLI:
+
+```bash
+git clone https://github.com/weugit/agentsmd-medic.git
+cd agentsmd-medic
+npm ci && npm run build && node bin/agentsmd-medic.js
+```
+
+Node.js 20 or newer is required.
+
+## Usage
+
+```text
+agentsmd-medic [options] [path...]
+```
+
+A path that is a file is linted directly. A path that is a directory is searched recursively for `AGENTS.md` and `AGENTS.override.md`. The default path is `.`.
+
+```text
+agentsmd-medic doctor [options] [dir]
+```
+
+`doctor` reports which instruction files each agent actually loads for `dir` (default: the working directory). It walks from that directory up to the git root: the nearest ancestor that contains `.git`, or `dir` itself when there is none. Home-directory files (`~/.codex`, `~/.claude`, and similar) are not scanned. The first positional argument `doctor` selects the subcommand. A path such as `./doctor` is still linted.
+
+| Agent | What doctor reports |
+| --- | --- |
+| OpenAI Codex | For each directory from the git root down to `dir`, `AGENTS.override.md` if it is present, otherwise `AGENTS.md`. Files are concatenated from the root toward the leaf. The report notes the default 32 KiB cap (`project_doc_max_bytes`) and warns when the combined size exceeds it. |
+| Claude Code | `CLAUDE.md` and `CLAUDE.local.md` on that path. Claude Code does not read `AGENTS.md` unless a `CLAUDE.md` imports it with an `@AGENTS.md`, `@./AGENTS.md`, or other relative `@` path. The report warns `AGENTS.md is ignored by Claude Code: no CLAUDE.md imports it` when `AGENTS.md` exists and no `CLAUDE.md` imports it, including when there is no `CLAUDE.md` at all. `CLAUDE.local.md` is called out as personal, git-ignored, and able to override shared instructions. |
+| Cursor | `AGENTS.md` at the root and in nested directories, `.cursor/rules/*.mdc`, and legacy `.cursorrules` (deprecated). |
+| GitHub Copilot | `.github/copilot-instructions.md`, `.github/instructions/*.instructions.md`, and `AGENTS.md`. |
+| Gemini CLI | `GEMINI.md` by default. `AGENTS.md` only when `context.fileName` includes it. The report warns when only `AGENTS.md` exists. |
+
+Text output is grouped per agent and uses `✔` and `⚠` markers. `--color` and `--no-color` apply the same way as for lint output. `--json` (or `--format json`) prints a versioned document (`version`, `command`, `directory`, `root`, and one entry per agent with `files`, `notes`, and `warnings`). `--format github` is a usage error. `doctor` exits 0 when the directory can be read, including when the report contains warnings. A missing path, a file path, or more than one directory exits 2.
+
+Behaviors change as agents ship updates. The snapshot and the doc links live in `src/agents.ts`.
+
+| Flag | Meaning |
+| --- | --- |
+| `-c, --config <file>` | Config file. When omitted, the working directory is searched for `.agentsmd-medic.json`, then `agentsmd-medic.config.json`. |
+| `--format <format>` | `text` (default), `json`, or `github`. |
+| `--json` | Alias for `--format json`. When both are set, the last one wins. |
+| `--max-warnings <n>` | Exit 1 when the warning count is greater than `<n>`. `<n>` is an integer ≥ 0. Without this flag, warnings do not change the exit code. |
+| `--color` | Force colored text output. |
+| `--no-color` | Disable colored text output. |
+| `-q, --quiet` | Hide warnings in text output. Hidden warnings are left out of the summary. They still count toward the exit code. |
+| `--list-rules` | Print each rule id, its default severity, and its description, then exit. |
+| `-h, --help` | Show help and exit. |
+| `-v, --version` | Show the version number and exit. |
+
+Color defaults to on when stdout is a TTY and `NO_COLOR` is unset. `--color` and `--no-color` override that, and the last one wins. Color applies to text output only.
+
+`--format github` prints one [GitHub Actions workflow command](https://docs.github.com/en/actions/reference/workflow-commands-for-github-actions) per diagnostic (`::error` or `::warning` with `file`, `line`, `col`, and `title`). `--format json` prints a versioned document (`version`, `root`, counts, and per-file diagnostics) for editors and scripts.
+
+### Exit codes
+
+| Code | Meaning |
+| --- | --- |
+| 0 | No errors, and warnings do not exceed `--max-warnings`. `doctor` exits 0 when the directory can be read, including when the report contains warnings. |
+| 1 | One or more errors, or more warnings than `--max-warnings`. |
+| 2 | Usage error, invalid config, or a path that does not exist. The message is written to stderr and prefixed with `agentsmd-medic: `. |
+
+## Example output
+
+This report is the real output of `node bin/agentsmd-medic.js --no-color` in a temporary directory (exit code 1). The directory contained only the two files below.
+
+`package.json`:
+
+```json
+{
+  "name": "example",
+  "private": true,
+  "scripts": {
+    "test": "node --test"
+  }
+}
+```
+
+`AGENTS.md`:
+
+```md
+# Project notes
+
+Install dependencies with `npm run compile`, then start `pnpm dev`.
+
+The schema is in `src/schema.ts`.
+
+Read [the missing guide](docs/guide.md) and jump to [Setup](#setup).
+
+## Tasks
+
+## Tasks
+
+TODO: describe the tasks.
+
+api_key: "correcthorsebatterystaple"
+```
+
+```text
+AGENTS.md
+   3:28  warning  Script `compile` is not defined in package.json.                                                            no-missing-scripts
+   3:58  warning  Instructions mix npm and pnpm; agents may run the wrong one.                                                consistent-package-manager
+   3:58  warning  Script `dev` is not defined in package.json.                                                                no-missing-scripts
+   5:19  warning  Referenced path `src/schema.ts` does not exist                                                              no-missing-paths
+   7:6   error    Broken link: "docs/guide.md" (resolved to docs/guide.md) does not exist.                                    no-broken-links
+   7:53  error    Anchor "#setup" does not match any heading in this file.                                                    no-broken-links
+   9:1   warning  Section "Tasks" is empty.                                                                                   no-empty-section
+  11:1   warning  Duplicate heading "Tasks" (first defined on line 9); merge the sections to avoid conflicting instructions.  no-duplicate-heading
+  13:1   warning  Placeholder text "TODO" found; agents may follow it literally.                                              no-placeholder
+  15:1   error    Possible API key found ("corr…"); remove it and rotate the credential.                                      no-secrets
+
+✖ 10 problems (3 errors, 7 warnings)
+```
+
+## Rules
+
+Default severities come from the rule objects in `src/rules/`. Override them in config with `error`, `warn`, or `off`.
+
+| Rule | Default | Description |
+| --- | --- | --- |
+| `no-empty-file` | error | The file must contain some instructions. |
+| `require-heading` | warn | Use at least one Markdown heading so agents (and humans) can navigate sections. |
+| `max-size` | warn | Keep the file within the size agents actually read, using a CJK-aware token estimate. |
+| `no-empty-section` | warn | Headings should be followed by content before the next heading of the same or higher level. |
+| `no-duplicate-heading` | warn | Sibling sections should not share a heading; duplicated sections often carry conflicting instructions. |
+| `no-placeholder` | warn | Flag unfinished placeholder text (TODO, TBD, lorem ipsum, &lt;insert ...&gt;). |
+| `no-broken-links` | error | Relative links and in-page anchors must resolve. |
+| `no-missing-paths` | warn | File paths in inline code should exist in the repository. |
+| `no-missing-scripts` | warn | Package scripts and Make targets mentioned in commands should exist. |
+| `no-secrets` | error | Instruction files must not embed credentials or secret tokens. |
+| `consistent-package-manager` | warn | Commands should use one package manager, the one the repository locks. |
+
+`no-broken-links` checks relative links and in-page anchors. External URLs are left alone. `no-missing-paths` checks inline code that looks like a repository path. `no-missing-scripts` checks `npm run` scripts (and `pnpm` / `yarn` / `bun` script invocations) against the nearest `package.json`, and `make` targets against a Makefile. `no-secrets` reports a short prefix of a match and asks you to rotate the credential. `max-size` compares UTF-8 bytes with `maxBytes` (default 32768) and a token estimate with `maxTokens` (default 8000). Each Han, Hiragana, Katakana, Hangul, and fullwidth character counts as one token. Other text counts as characters / 4. When those characters are more than 20% of the non-whitespace characters and the file exceeds `maxBytes`, the message notes that CJK text uses 3 bytes per character in UTF-8 and reaches the 32 KiB cap with ~11k characters.
+
+Discovery always skips these directory names: `.git`, `node_modules`, `.hg`, `.svn`, `dist`, `build`, `coverage`, `.next`, `.turbo`, `vendor`, `.venv`, `venv`, `__pycache__`, and `target`.
+
+## Configuration
+
+Put one of these files in the working directory. The first match wins:
+
+1. `.agentsmd-medic.json`
+2. `agentsmd-medic.config.json`
+
+```json
+{
+  "rules": {
+    "no-secrets": "error",
+    "max-size": "warn",
+    "no-placeholder": "off"
+  },
+  "ignore": ["fixtures", "docs/drafts"],
+  "maxBytes": 32768,
+  "maxTokens": 8000
+}
+```
+
+| Field | Meaning |
+| --- | --- |
+| `rules` | Map of rule id to `error`, `warn`, or `off`. Unknown ids are a usage error (exit 2). |
+| `ignore` | Directory names or path prefixes, relative to the lint root, to skip while searching. A value without a slash matches any path segment. A value with a slash matches that path or anything under it. |
+| `maxBytes` | Soft size limit in bytes. Default `32768` (32 KiB). Must be a positive number. |
+| `maxTokens` | Soft token budget. CJK and fullwidth characters count as one token; other text is characters / 4. Default `8000`. Must be a positive number. |
+
+Pass `-c` / `--config` to use a different file. If that path cannot be read, the CLI exits 2.
+
+### Inline disable comments
+
+In an `AGENTS.md` file:
+
+```text
+<!-- agentsmd-medic-disable -->
+<!-- agentsmd-medic-disable rule-a, rule-b -->
+<!-- agentsmd-medic-disable-next-line -->
+<!-- agentsmd-medic-disable-next-line rule-a, rule-b -->
+```
+
+`agentsmd-medic-disable` disables every rule, or the named rules, for the whole file. `agentsmd-medic-disable-next-line` does the same for the next non-blank line. Comments inside fenced code blocks are not treated as directives, so an example in a fence does not silence a real finding.
+
+## Use in CI
+
+The composite action in this repository checks out its own source, installs it, builds it, and lints the caller workspace. Pin `v0` after the first release. That tag is force-moved onto each 0.x release. Leaving `version` empty (the default) builds the action's checked-out source, so the action does not need the npm package.
+
+```yaml
+name: AGENTS.md
+on: [push, pull_request]
+permissions:
+  contents: read
+jobs:
+  agentsmd:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: weugit/agentsmd-medic@v0
+        with:
+          path: .
+          # config: .agentsmd-medic.json
+          # max-warnings: "0"   # -1, the default, does not fail on warnings
+          format: github
+          # version: "0.1.0"   # empty builds the checked-out action source
+```
+
+| Input | Default | Meaning |
+| --- | --- | --- |
+| `path` | `.` | File or directory to lint. |
+| `config` | empty | Config file. Empty uses the default search. |
+| `max-warnings` | `-1` | Fail when warnings exceed this integer. `-1` means unlimited. |
+| `format` | `github` | `text`, `json`, or `github`. |
+| `version` | empty | npm version to run. Empty builds the action source. |
+
+The same check after the package is published, without the action:
+
+```yaml
+- uses: actions/checkout@v4
+- uses: actions/setup-node@v4
+  with:
+    node-version: 22
+- run: npx agentsmd-medic --format github
+```
+
+`npx agentsmd-medic` works only once the package is on npm. Until then, use the action with an empty `version`, or the clone-and-build install above.
+
+## Programmatic API
+
+The package is ESM. Import it after `npm run build`, or from the published package once that exists. Types are in `dist/index.d.ts`.
+
+```js
+import { formatText, lint } from "agentsmd-medic";
+
+const result = await lint({ cwd: process.cwd(), paths: ["."] });
+process.stdout.write(formatText(result, { color: false }));
+if (result.errorCount > 0) process.exitCode = 1;
+```
+
+| Export | Role |
+| --- | --- |
+| `lint({ cwd, paths?, configPath? })` | Load config, discover files, and return a `LintResult`. `configPath` is set on the result when a config file was read. Missing paths throw. Unknown rule ids throw `ConfigError`. |
+| `lintFiles(files, root, config)` | Lint already-resolved files. |
+| `lintText(source, { file, root, config })` | Lint one document from a string. Returns `Diagnostic[]`. |
+| `formatText(result, { color?, quiet? })` | Text report. |
+| `formatJson(result)` | JSON report (`version: 1`). |
+| `formatGithub(result, cwd)` | GitHub Actions workflow commands. Paths are relative to `cwd`. |
+| `loadConfig(root, explicitPath?)` | Returns `{ config, path? }`. |
+| `DEFAULT_CONFIG` | `{ rules: {}, ignore: [], maxBytes: 32768, maxTokens: 8000 }`. |
+| `CONFIG_FILE_NAMES` | `[".agentsmd-medic.json", "agentsmd-medic.config.json"]`. |
+| `AGENT_FILE_NAMES` | `["AGENTS.md", "AGENTS.override.md"]`. |
+| `findAgentFiles(root, ignore?)` | Recursive discovery. |
+| `rules`, `ruleMap` | Built-in rules, in report order, and a map keyed by id. |
+| `parseMarkdown(source)`, `slugify(text)` | The small Markdown scan the rules use. |
+| `main(argv, io?)` | CLI entry. Resolves to exit code 0, 1, or 2. |
+| `diagnose(dir, displayPath?)` | Build a doctor report for `dir`. |
+| `formatDoctorText(report, { color? })` | Text doctor report. |
+| `formatDoctorJson(report)` | JSON doctor report (`version: 1`, `command: "doctor"`). |
+| `AGENTS` | Documented agent behaviors and documentation URLs. |
+| `CODEX_PROJECT_DOC_MAX_BYTES` | Default Codex cap, `32768`. |
+| `ConfigError` | Thrown for invalid config. |
+| `DoctorUsageError` | Thrown when `doctor` is given a missing path or a file. |
+
+Types exported from the package include `Severity`, `RuleSetting`, `Diagnostic`, `Config`, `Rule`, `RuleContext`, `LintResult`, and `FileResult`.
+
+## Roadmap
+
+`agentsmd-medic doctor` reports which instruction files Codex, Claude Code, Cursor, GitHub Copilot, and Gemini CLI load, including nested `AGENTS.md` files and `AGENTS.override.md`. See [Usage](#usage).
+
+Not implemented yet:
+
+- Autofix.
+- SARIF output.
+- A pre-commit hook.
+- Editor integration.
+- Semantic conflict detection (instructions that disagree, beyond duplicate headings and mixed package managers).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, scripts, and how to add a rule. The code of conduct is [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). Security reports go through [private advisories](https://github.com/weugit/agentsmd-medic/security/advisories/new) ([SECURITY.md](SECURITY.md)).
+
+This repository's own [AGENTS.md](AGENTS.md) is linted in CI. `README.md` and `CONTRIBUTING.md` are not.
+
+## License
+
+[MIT](LICENSE). Copyright (c) 2026 weugit.

package/bin/agentsmd-medic.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { main } from "../dist/cli.js";
+
+main(process.argv.slice(2)).then(
+  (code) => {
+    process.exitCode = code;
+  },
+  (err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exitCode = 2;
+  },
+);

package/dist/agents.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Documented instruction-file behavior for coding agents.
+ *
+ * These behaviors change as agents ship updates. Treat this module as a snapshot
+ * of the public docs, not a guarantee of what a future release reads. Check the
+ * linked page when a doctor report looks wrong. Doctor does not read home-directory
+ * files (`~/.codex`, `~/.claude`, `~/.gemini`, and similar).
+ *
+ * - OpenAI Codex: https://developers.openai.com/codex/guides/agents-md
+ * - Claude Code: https://code.claude.com/docs/en/memory
+ * - Cursor: https://cursor.com/docs/rules
+ * - GitHub Copilot: https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot
+ * - Gemini CLI: https://geminicli.com/docs/cli/gemini-md
+ */
+/** Default `project_doc_max_bytes`. Codex stops adding project docs at this size. */
+export declare const CODEX_PROJECT_DOC_MAX_BYTES: number;
+/** Printed when AGENTS.md is present and no CLAUDE.md imports it. */
+export declare const CLAUDE_AGENTS_IGNORED = "AGENTS.md is ignored by Claude Code: no CLAUDE.md imports it";
+/** Printed when CLAUDE.local.md is on the path from the repo root to the directory. */
+export declare const CLAUDE_LOCAL_WARNING = "CLAUDE.local.md exists (personal, git-ignored, may override shared instructions).";
+/** Printed when a legacy .cursorrules file is present. */
+export declare const CURSOR_LEGACY_WARNING = "Legacy .cursorrules is deprecated. Cursor recommends .cursor/rules/*.mdc instead.";
+/**
+ * Printed when the directory has AGENTS.md and Gemini would not load it.
+ * Gemini reads GEMINI.md unless `context.fileName` says otherwise.
+ */
+export declare const GEMINI_ONLY_AGENTS_WARNING = "Gemini CLI reads GEMINI.md by default and loads AGENTS.md only when context.fileName includes it. Only AGENTS.md exists here.";
+export interface AgentInfo {
+    id: "codex" | "claude" | "cursor" | "copilot" | "gemini";
+    name: string;
+    docsUrl: string;
+    /** What doctor checks, in one sentence. */
+    loads: string;
+}
+export declare const AGENTS: readonly AgentInfo[];
+export declare function agentInfo(id: AgentInfo["id"]): AgentInfo;

package/dist/agents.js

@@ -0,0 +1,67 @@
+/**
+ * Documented instruction-file behavior for coding agents.
+ *
+ * These behaviors change as agents ship updates. Treat this module as a snapshot
+ * of the public docs, not a guarantee of what a future release reads. Check the
+ * linked page when a doctor report looks wrong. Doctor does not read home-directory
+ * files (`~/.codex`, `~/.claude`, `~/.gemini`, and similar).
+ *
+ * - OpenAI Codex: https://developers.openai.com/codex/guides/agents-md
+ * - Claude Code: https://code.claude.com/docs/en/memory
+ * - Cursor: https://cursor.com/docs/rules
+ * - GitHub Copilot: https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot
+ * - Gemini CLI: https://geminicli.com/docs/cli/gemini-md
+ */
+/** Default `project_doc_max_bytes`. Codex stops adding project docs at this size. */
+export const CODEX_PROJECT_DOC_MAX_BYTES = 32 * 1024;
+/** Printed when AGENTS.md is present and no CLAUDE.md imports it. */
+export const CLAUDE_AGENTS_IGNORED = "AGENTS.md is ignored by Claude Code: no CLAUDE.md imports it";
+/** Printed when CLAUDE.local.md is on the path from the repo root to the directory. */
+export const CLAUDE_LOCAL_WARNING = "CLAUDE.local.md exists (personal, git-ignored, may override shared instructions).";
+/** Printed when a legacy .cursorrules file is present. */
+export const CURSOR_LEGACY_WARNING = "Legacy .cursorrules is deprecated. Cursor recommends .cursor/rules/*.mdc instead.";
+/**
+ * Printed when the directory has AGENTS.md and Gemini would not load it.
+ * Gemini reads GEMINI.md unless `context.fileName` says otherwise.
+ */
+export const GEMINI_ONLY_AGENTS_WARNING = "Gemini CLI reads GEMINI.md by default and loads AGENTS.md only when context.fileName includes it. Only AGENTS.md exists here.";
+export const AGENTS = [
+    {
+        id: "codex",
+        name: "OpenAI Codex",
+        docsUrl: "https://developers.openai.com/codex/guides/agents-md",
+        loads: "From the git root down to the directory, AGENTS.override.md if that directory has one, otherwise AGENTS.md. Files are concatenated from the root toward the leaf and capped by project_doc_max_bytes (32 KiB by default).",
+    },
+    {
+        id: "claude",
+        name: "Claude Code",
+        docsUrl: "https://code.claude.com/docs/en/memory",
+        loads: "CLAUDE.md and CLAUDE.local.md on the path from the git root to the directory. AGENTS.md is included only when a CLAUDE.md line imports it (@AGENTS.md, @./AGENTS.md, or another relative path to AGENTS.md).",
+    },
+    {
+        id: "cursor",
+        name: "Cursor",
+        docsUrl: "https://cursor.com/docs/rules",
+        loads: "AGENTS.md at the repo root and in nested directories, .cursor/rules/*.mdc files, and legacy .cursorrules (deprecated).",
+    },
+    {
+        id: "copilot",
+        name: "GitHub Copilot",
+        docsUrl: "https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot",
+        loads: ".github/copilot-instructions.md, .github/instructions/*.instructions.md, and AGENTS.md.",
+    },
+    {
+        id: "gemini",
+        name: "Gemini CLI",
+        docsUrl: "https://geminicli.com/docs/cli/gemini-md",
+        loads: "GEMINI.md by default. AGENTS.md only when settings set context.fileName to include it.",
+    },
+];
+const AGENT_BY_ID = new Map(AGENTS.map((agent) => [agent.id, agent]));
+export function agentInfo(id) {
+    const info = AGENT_BY_ID.get(id);
+    if (!info)
+        throw new Error(`Unknown agent: ${id}`);
+    return info;
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,qFAAqF;AACrF,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,CAAC;AAErD,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,8DAA8D,CAAC;AAEpG,uFAAuF;AACvF,MAAM,CAAC,MAAM,oBAAoB,GAAG,mFAAmF,CAAC;AAExH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,mFAAmF,CAAC;AAEzH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GACrC,+HAA+H,CAAC;AAUlI,MAAM,CAAC,MAAM,MAAM,GAAyB;IAC1C;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EACH,2NAA2N;KAC9N;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,wCAAwC;QACjD,KAAK,EACH,8MAA8M;KACjN;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,+BAA+B;QACxC,KAAK,EAAE,wHAAwH;KAChI;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,sGAAsG;QAC/G,KAAK,EAAE,yFAAyF;KACjG;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,0CAA0C;QACnD,KAAK,EAAE,wFAAwF;KAChG;CACF,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAEtE,MAAM,UAAU,SAAS,CAAC,EAAmB;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,16 @@
+interface Io {
+    stdout: {
+        write(s: string): unknown;
+        isTTY?: boolean;
+    };
+    stderr: {
+        write(s: string): unknown;
+    };
+    cwd: string;
+    env?: Record<string, string | undefined>;
+}
+/**
+ * Run the CLI. Returns a process exit code: 0 ok, 1 findings, 2 usage or config error.
+ */
+export declare function main(argv: string[], io?: Io): Promise<number>;
+export {};