project-athena 0.3.0 → 0.5.0

package/dist/{program-V2USHGXN.js → program-DCP526LU.js}

@@ -31,7 +31,10 @@ ${c.yellow("Interrupted.")} ${dim(getInterruptMessage())}
 `);
 }
 process.stdout.on("error", (err) => {
-  if (err.code === "EPIPE") process.exit(0);
+  if (err.code === "EPIPE") {
+    if (process.env.ATHENA_DEBUG) process.stderr.write("athena: stdout was closed by the reader (EPIPE); exiting quietly\n");
+    process.exit(0);
+  }
   throw err;
 });
 process.on("SIGINT", onSignal);
@@ -55,47 +58,75 @@ function buildProgram() {
   program.command("init").description("Analyze the project and create .athena/ knowledge").option("--agents <list>", 'Agents to configure: comma-separated ids (claude-code, cursor, codex, copilot, gemini-cli, antigravity, windsurf, cline, agents-md), "all" or "none". Default: detected agents + AGENTS.md').option("--no-agents", "Do not configure any agent integration").option("--dry-run", "Analyze and show what would be written, without writing").action(
     run(async (cmdOpts, cmd) => {
       const g = globals(cmd);
-      await (await import("./init-2V34DVRQ.js")).initCommand({ ...g, agents: typeof cmdOpts.agents === "string" ? cmdOpts.agents : void 0, noAgents: cmdOpts.agents === false, dryRun: cmdOpts.dryRun, signal: controller.signal });
+      await (await import("./init-427QR5AS.js")).initCommand({ ...g, agents: typeof cmdOpts.agents === "string" ? cmdOpts.agents : void 0, noAgents: cmdOpts.agents === false, dryRun: cmdOpts.dryRun, signal: controller.signal });
     })
   );
-  program.command("analyze").description("Re-analyze the project and refresh generated knowledge (developer edits are preserved)").option("--force", "Regenerate sections even if they were edited by hand").option("--agents <list>", "Reconfigure these agent integrations").action(run(async (o, cmd) => (await import("./analyze-F3YOILNL.js")).analyzeCommand({ ...globals(cmd), ...o, signal: controller.signal })));
-  program.command("sync").description("Review and apply knowledge updates for changes since the last analysis").option("-y, --yes", "Apply without asking").option("--dry-run", "Show the plan without writing").option("--check", "Exit with code 1 if knowledge is out of date (for CI/hooks)").option("--staged", "With --check: check the staged knowledge against the staged code (the index), ignoring untracked and unstaged changes").option("--diff", "Print full diffs of proposed document changes").option("--force", "Also regenerate sections that were edited by hand").action(run(async (o, cmd) => (await import("./sync-3ZNJDSSU.js")).syncCommand({ ...globals(cmd), ...o, signal: controller.signal })));
-  program.command("watch").description("Watch the project and propose knowledge updates as files change").option("--auto-apply", "Apply updates automatically instead of proposing them").option("--debounce <ms>", "Quiet period before checking changes (default 1500)").action(run(async (o, cmd) => (await import("./watch-USN5CQIV.js")).watchCommand({ ...globals(cmd), ...o, signal: controller.signal })));
-  program.command("context <task>").description("Show which knowledge an agent should read for a task (deterministic)").option("--full", "Print the full context an agent would receive").option("--max-chars <n>", "Character budget for selected sections").action(run(async (task, o, cmd) => (await import("./context-AH5MFHRG.js")).contextCommand(task, { ...globals(cmd), ...o, signal: controller.signal })));
-  program.command("graph").description("Inspect the project graph (packages, files, routes, entities and their relationships)").option("--build", "Rebuild the graph from the current code").option("--node <id>", "Show one node and its relationships").option("--kind <kind>", "Filter by node kind (package, file, route, entity, framework, command, infra)").option("--search <term>", "Filter nodes by name or path").action(run(async (o, cmd) => (await import("./context-AH5MFHRG.js")).graphCommand({ ...globals(cmd), ...o, signal: controller.signal })));
-  program.command("architecture").description("Summarize the project graph").action(run(async (_o, cmd) => (await import("./context-AH5MFHRG.js")).architectureCommand({ ...globals(cmd), signal: controller.signal })));
-  program.command("mcp").description("Serve Athena project intelligence over MCP (stdio) for AI agents").option("--allow-write", "Permit the update_knowledge tool to apply changes (read-only by default)").action(run(async (o, cmd) => (await import("./mcp-T2GRTEX5.js")).mcpCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("analyze").description("Re-analyze the project and refresh generated knowledge (developer edits are preserved)").option("--force", "Regenerate sections even if they were edited by hand").option("--agents <list>", "Reconfigure these agent integrations").action(run(async (o, cmd) => (await import("./analyze-AP4XJT7D.js")).analyzeCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("sync").description("Review and apply knowledge updates for changes since the last analysis").option("-y, --yes", "Apply without asking").option("--dry-run", "Show the plan without writing").option("--check", "Exit with code 1 if knowledge is out of date (for CI/hooks)").option("--staged", "With --check: check the staged knowledge against the staged code (the index), ignoring untracked and unstaged changes").option("--diff", "Print full diffs of proposed document changes").option("--force", "Also regenerate sections that were edited by hand").action(run(async (o, cmd) => (await import("./sync-GVO2VHPI.js")).syncCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("watch").description("Watch the project and propose knowledge updates as files change").option("--auto-apply", "Apply updates automatically instead of proposing them").option("--debounce <ms>", "Quiet period before checking changes (default 1500)").action(run(async (o, cmd) => (await import("./watch-TEHFO47V.js")).watchCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("context <task>").description("Show which knowledge an agent should read for a task (deterministic)").option("--full", "Print the full context an agent would receive").option("--max-chars <n>", "Character budget for selected sections").action(run(async (task, o, cmd) => (await import("./context-G5YHY3L2.js")).contextCommand(task, { ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("graph").description("Inspect the project graph (packages, files, routes, entities and their relationships)").option("--build", "Rebuild the graph from the current code").option("--node <id>", "Show one node and its relationships").option("--kind <kind>", "Filter by node kind (package, file, route, entity, framework, command, infra)").option("--search <term>", "Filter nodes by name or path").action(run(async (o, cmd) => (await import("./context-G5YHY3L2.js")).graphCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("architecture").description("Summarize the project graph").action(run(async (_o, cmd) => (await import("./context-G5YHY3L2.js")).architectureCommand({ ...globals(cmd), signal: controller.signal })));
+  program.command("mcp").description("Serve Athena project intelligence over MCP (stdio) for AI agents").option("--allow-write", "Permit the update_knowledge tool to apply changes (read-only by default)").option("--no-memory-write", "Disable the remember tool (agents cannot record unreviewed memories)").action(run(async (o, cmd) => (await import("./mcp-DWNWRGJW.js")).mcpCommand({ ...globals(cmd), ...o, signal: controller.signal })));
   const ai = program.command("ai").description("Optional AI provider integration (never required)");
-  ai.command("status", { isDefault: true }).description("Show configured and available AI providers").action(run(async (_o, cmd) => (await import("./ai-ASL4FFQ7.js")).aiStatusCommand(globals(cmd))));
-  ai.command("enrich").description("Ask the configured provider for INFERRED suggestions based on your knowledge documents").option("--docs <list>", "Documents to send (default: project,architecture,database,api)").option("--consent", "Consent to sending redacted knowledge to a remote provider for this run").option("--dry-run", "Show exactly what would be sent, and send nothing").action(run(async (o, cmd) => (await import("./ai-ASL4FFQ7.js")).aiEnrichCommand({ ...globals(cmd), ...o, signal: controller.signal })));
-  program.command("security").description("Scan dependencies with the audit tools installed for this project, and report secret findings").option("--no-audit", "Skip dependency audits (report secrets only)").option("--fail-on <severity>", "Exit 1 when a finding at or above this severity exists (critical, high, moderate, low)").option("--last", "Show the last scan instead of running a new one").option("--unrated <policy>", 'With --fail-on: "fail" (default) also fails on findings the tool did not rate (pip-audit, govulncheck); "warn" only reports them', "fail").action(run(async (o, cmd) => (await import("./security-PI4LXCOB.js")).securityCommand({ ...globals(cmd), noAudit: o.audit === false, failOn: o.failOn, unrated: o.unrated, last: o.last, signal: controller.signal })));
-  program.command("review").description("Check the current diff for facts worth reviewing, and list the project rules and checklist").option("--base <ref>", "Compare against this Git ref instead of the working tree").option("--staged", "Review only what is staged for commit (used by the pre-commit hook)").option("--no-sync", "Skip the knowledge freshness check").option("--no-fail", "Always exit 0, even when blockers are found").action(run(async (o, cmd) => (await import("./review-R3R2J5BJ.js")).reviewCommand({ ...globals(cmd), base: o.base, staged: o.staged, noSync: o.sync === false, noFail: o.fail === false, signal: controller.signal })));
-  program.command("status").description("Show knowledge health and changes since the last analysis").action(run(async (_o, cmd) => (await import("./status-6M73WX5I.js")).statusCommand({ ...globals(cmd), signal: controller.signal })));
-  program.command("doctor").description("Check the Athena installation, project and integrations").action(run(async (_o, cmd) => (await import("./doctor-RSJMLE2P.js")).doctorCommand(globals(cmd))));
+  ai.command("status", { isDefault: true }).description("Show configured and available AI providers").action(run(async (_o, cmd) => (await import("./ai-LGTLQKL4.js")).aiStatusCommand(globals(cmd))));
+  ai.command("enrich").description("Ask the configured provider for INFERRED suggestions based on your knowledge documents").option("--docs <list>", "Documents to send (default: project,architecture,database,api)").option("--consent", "Consent to sending redacted knowledge to a remote provider for this run").option("--dry-run", "Show exactly what would be sent, and send nothing").action(run(async (o, cmd) => (await import("./ai-LGTLQKL4.js")).aiEnrichCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("security").description("Scan dependencies with the audit tools installed for this project, and report secret findings").option("--no-audit", "Skip dependency audits (report secrets only)").option("--fail-on <severity>", "Exit 1 when a finding at or above this severity exists (critical, high, moderate, low)").option("--last", "Show the last scan instead of running a new one").option("--unrated <policy>", 'With --fail-on: "fail" (default) also fails on findings the tool did not rate (pip-audit, govulncheck); "warn" only reports them', "fail").action(run(async (o, cmd) => (await import("./security-JTJN3E7K.js")).securityCommand({ ...globals(cmd), noAudit: o.audit === false, failOn: o.failOn, unrated: o.unrated, last: o.last, signal: controller.signal })));
+  const scanCmds = () => import("./scan-JVKCVHPD.js");
+  program.command("scan").description("Scan for secrets, vulnerable dependencies and review issues; apply the policy, baseline and triage; evaluate the quality gate").option("--only <scanners>", "Comma-separated: secrets, deps, review (default: secrets,deps; plus review when scanning a change)").option("--base <ref>", "Scan the changes since this ref (merge-base..HEAD, like a pull request)").option("--staged", "Scan what is staged for commit").option("--changed", "Scan working-tree changes").option("-f, --format <format>", "text, json, markdown, github or sarif").option("-o, --output <file>", "Write the report to a file").option("--fail-on <severity>", "Override the gate threshold: critical, high, medium, low, info").option("--min-confidence <level>", "Override the gate confidence: high, medium, low").option("--unrated <policy>", "Override how unrated findings affect the gate: fail or warn").option("--no-baseline", "Ignore .athena/baseline.json (every finding counts as new)").option("--policy-from <ref>", "Use the policy, baseline and triage committed at this ref, and report changes to them (CI)").option("--offline", "Do not contact the network (dependency audits are skipped and reported as skipped)").option("--no-fail", "Always exit 0, even when the gate fails").option("--list-rules", "List the rules Athena knows and exit").action(run(
+    async (o, cmd) => (await scanCmds()).scanCommand({ ...globals(cmd), ...o, noBaseline: o.baseline === false, noFail: o.fail === false, signal: controller.signal })
+  ));
+  program.command("explain <ruleId>").description("Explain a rule: what it detects, why it matters and what to do").action(run(async (ruleId, _o, cmd) => (await scanCmds()).explainCommand(ruleId, globals(cmd))));
+  const baseline = program.command("baseline").description("Record existing findings so only new ones fail the gate (.athena/baseline.json)");
+  baseline.command("show", { isDefault: true }).description("Summarize the baseline").action(run(async (_o, cmd) => (await scanCmds()).baselineShowCommand(globals(cmd))));
+  baseline.command("create").description("Scan the whole project and baseline every current finding").option("--reason <text>", "Why these findings are accepted for now").option("--last", "Use the last full scan instead of scanning again").option("--offline", "Do not contact the network").option("--force", "Add to an existing baseline").action(run(async (o, cmd) => (await scanCmds()).baselineCreateCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  baseline.command("update").description("Add findings that are not in the baseline yet").option("--reason <text>", "Why these findings are accepted for now").option("--last", "Use the last full scan instead of scanning again").option("--offline", "Do not contact the network").action(run(async (o, cmd) => (await scanCmds()).baselineCreateCommand({ ...globals(cmd), ...o, update: true, signal: controller.signal })));
+  baseline.command("prune").description("Remove entries a full scan no longer reports").option("--last", "Use the last full scan instead of scanning again").option("--offline", "Do not contact the network").action(run(async (o, cmd) => (await scanCmds()).baselinePruneCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  const findings = program.command("findings").description("Inspect and triage findings from the last scan");
+  findings.command("list", { isDefault: true }).description("List active findings with their fingerprints").option("--status <status>", "open, baselined, suppressed, excluded, triaged, or a triage decision such as to-review").option("--severity <severity>", "Only this severity").option("--category <category>", "Only this category").option("--all", "Include baselined, suppressed, triaged and excluded findings").action(run(async (o, cmd) => (await scanCmds()).findingsListCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  findings.command("show <fingerprint>").description("Show one finding (a fingerprint prefix of 6+ characters is enough)").action(run(async (fp, _o, cmd) => (await scanCmds()).findingsShowCommand(fp, { ...globals(cmd), signal: controller.signal })));
+  findings.command("triage <fingerprint> <status>").description('Record a review decision: safe, false-positive, accepted-risk, fixed, to-review (or "clear")').option("--reason <text>", "Why (required; committed in .athena/triage.json)").option("--by <name>", "Who decided").action(run(async (fp, status, o, cmd) => (await scanCmds()).findingsTriageCommand(fp, status, { ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("review").description("Check the current diff for facts worth reviewing, and list the project rules and checklist").option("--base <ref>", "Compare against this Git ref instead of the working tree").option("--staged", "Review only what is staged for commit (used by the pre-commit hook)").option("--no-sync", "Skip the knowledge freshness check").option("--no-fail", "Always exit 0, even when blockers are found").action(run(async (o, cmd) => (await import("./review-VEJBPACX.js")).reviewCommand({ ...globals(cmd), base: o.base, staged: o.staged, noSync: o.sync === false, noFail: o.fail === false, signal: controller.signal })));
+  program.command("status").description("Show knowledge health and changes since the last analysis").action(run(async (_o, cmd) => (await import("./status-PO27BSOZ.js")).statusCommand({ ...globals(cmd), signal: controller.signal })));
+  program.command("doctor").description("Check the Athena installation, project and integrations").action(run(async (_o, cmd) => (await import("./doctor-L34QJ7WR.js")).doctorCommand(globals(cmd))));
   const rules = program.command("rules").description("List and edit project rules (.athena/rules.md)");
-  rules.command("list", { isDefault: true }).description("List rules with their numbers").action(run(async (_o, cmd) => (await import("./rules-4FXJUCXB.js")).rulesListCommand(globals(cmd))));
-  rules.command("add <text>").description("Add a rule").option("-s, --section <name>", "Section heading", "General").action(run(async (text, o, cmd) => (await import("./rules-4FXJUCXB.js")).rulesAddCommand(text, { ...globals(cmd), ...o })));
-  rules.command("edit <number> <text>").description("Replace the text of a rule").action(run(async (n, text, _o, cmd) => (await import("./rules-4FXJUCXB.js")).rulesEditCommand(n, text, globals(cmd))));
-  rules.command("enable <number>").description("Enable a rule").action(run(async (n, _o, cmd) => (await import("./rules-4FXJUCXB.js")).rulesEnableCommand(n, globals(cmd))));
-  rules.command("disable <number>").description("Disable a rule without deleting it").action(run(async (n, _o, cmd) => (await import("./rules-4FXJUCXB.js")).rulesDisableCommand(n, globals(cmd))));
-  rules.command("remove <number>").description("Delete a rule").action(run(async (n, _o, cmd) => (await import("./rules-4FXJUCXB.js")).rulesRemoveCommand(n, globals(cmd))));
+  rules.command("list", { isDefault: true }).description("List rules with their numbers").action(run(async (_o, cmd) => (await import("./rules-M4DLLXBL.js")).rulesListCommand(globals(cmd))));
+  rules.command("add <text>").description("Add a rule").option("-s, --section <name>", "Section heading", "General").action(run(async (text, o, cmd) => (await import("./rules-M4DLLXBL.js")).rulesAddCommand(text, { ...globals(cmd), ...o })));
+  rules.command("edit <number> <text>").description("Replace the text of a rule").action(run(async (n, text, _o, cmd) => (await import("./rules-M4DLLXBL.js")).rulesEditCommand(n, text, globals(cmd))));
+  rules.command("enable <number>").description("Enable a rule").action(run(async (n, _o, cmd) => (await import("./rules-M4DLLXBL.js")).rulesEnableCommand(n, globals(cmd))));
+  rules.command("disable <number>").description("Disable a rule without deleting it").action(run(async (n, _o, cmd) => (await import("./rules-M4DLLXBL.js")).rulesDisableCommand(n, globals(cmd))));
+  rules.command("remove <number>").description("Delete a rule").action(run(async (n, _o, cmd) => (await import("./rules-M4DLLXBL.js")).rulesRemoveCommand(n, globals(cmd))));
+  const repeat = (value, prev = []) => [...prev, ...value.split(",").map((s) => s.trim()).filter(Boolean)];
+  const mem = () => import("./memory-XBZCYQLW.js");
+  const memory = program.command("memory").description("Record, review and recall project memory (.athena/memory/)");
+  memory.command("list", { isDefault: true }).description("List memory entries with their label (FACT/INFERRED), status and staleness").option("--kind <kind>", "Only this kind (decision, gotcha, bug, convention, todo, fact)").option("--status <status>", "Only this status (unreviewed, confirmed, superseded)").option("--stale", "Only entries whose linked files changed since").action(run(async (o, cmd) => (await mem()).memoryListCommand({ ...globals(cmd), ...o })));
+  memory.command("show <id>").description("Show one entry in full: files, tags, evidence, staleness, warnings").action(run(async (id, _o, cmd) => (await mem()).memoryShowCommand(id, globals(cmd))));
+  memory.command("add").description("Record a memory as the developer (confirmed, FACT)").option("--kind <kind>", "decision, gotcha, bug, convention, todo or fact").option("--title <title>", "One-line summary").option("--details <text>", 'Longer explanation ("-" reads it from stdin)').option("--file <path>", "Linked project file (repeatable); the entry goes stale when it changes", repeat).option("--tag <tag>", "Tag (repeatable)", repeat).option("--evidence <text>", "Where this was observed (commit, issue, test, log)").option("--supersedes <id>", "Older memory this one replaces").action(run(async (o, cmd) => (await mem()).memoryAddCommand({ ...globals(cmd), ...o })));
+  memory.command("search <query>").description("Find entries whose title, details, tags or files contain the text").action(run(async (q, _o, cmd) => (await mem()).memorySearchCommand(q, globals(cmd))));
+  memory.command("recall <task...>").description("Rank the memory relevant to a task (what an agent would be given), with reasons").option("--file <path>", "File you are about to work on (repeatable)", repeat).option("--tag <tag>", "Tag to match (repeatable)", repeat).option("-n, --limit <count>", "Maximum entries (default 8)").action(run(async (task, o, cmd) => (await mem()).memoryRecallCommand(task, { ...globals(cmd), ...o })));
+  memory.command("confirm <ids...>").description("Confirm entries as FACT (and re-anchor them to the current files)").action(run(async (ids, _o, cmd) => (await mem()).memoryConfirmCommand(ids, globals(cmd))));
+  memory.command("supersede <id>").description("Mark an entry as replaced by a newer one (kept as history)").option("--by <id>", "The newer memory").action(run(async (id, o, cmd) => (await mem()).memorySupersedeCommand(id, { ...globals(cmd), ...o })));
+  memory.command("forget <ids...>").description("Delete entries").option("-y, --yes", "Skip confirmation").action(run(async (ids, o, cmd) => (await mem()).memoryForgetCommand(ids, { ...globals(cmd), ...o })));
+  memory.command("edit <id>").description("Change an entry (fields you pass replace the old values)").option("--title <title>", "New title").option("--details <text>", 'New details ("-" reads them from stdin)').option("--file <path>", "Linked files (repeatable; replaces the list)", repeat).option("--tag <tag>", "Tags (repeatable; replaces the list)", repeat).option("--evidence <text>", "New evidence").action(run(async (id, o, cmd) => (await mem()).memoryEditCommand(id, { ...globals(cmd), ...o })));
+  memory.command("stale").description("Entries whose linked files changed since they were recorded or confirmed").action(run(async (_o, cmd) => (await mem()).memoryStaleCommand(globals(cmd))));
+  memory.command("review").description("Walk through unreviewed (agent-written) entries: confirm, forget or skip").action(run(async (_o, cmd) => (await mem()).memoryReviewCommand(globals(cmd))));
   const agents = program.command("agents").description("Manage AI agent integrations");
-  agents.command("list", { isDefault: true }).description("Show supported agents and integration status").action(run(async (_o, cmd) => (await import("./agents-3HTSQGL2.js")).agentsListCommand(globals(cmd))));
-  agents.command("add <agents...>").description('Configure integrations (claude-code, cursor, codex, copilot, gemini-cli, antigravity, windsurf, cline, agents-md, or "all")').action(run(async (names, _o, cmd) => (await import("./agents-3HTSQGL2.js")).agentsAddCommand(names, globals(cmd))));
-  agents.command("remove <agents...>").description("Remove Athena-managed integration files/blocks").action(run(async (names, _o, cmd) => (await import("./agents-3HTSQGL2.js")).agentsRemoveCommand(names, globals(cmd))));
+  agents.command("list", { isDefault: true }).description("Show supported agents and integration status").action(run(async (_o, cmd) => (await import("./agents-HUJ4JXIB.js")).agentsListCommand(globals(cmd))));
+  agents.command("add <agents...>").description('Configure integrations (claude-code, cursor, codex, copilot, gemini-cli, antigravity, windsurf, cline, agents-md, or "all")').action(run(async (names, _o, cmd) => (await import("./agents-HUJ4JXIB.js")).agentsAddCommand(names, globals(cmd))));
+  agents.command("remove <agents...>").description("Remove Athena-managed integration files/blocks").action(run(async (names, _o, cmd) => (await import("./agents-HUJ4JXIB.js")).agentsRemoveCommand(names, globals(cmd))));
   const gitHook = program.command("git-hook").description("Install a Git pre-commit hook that blocks commits when knowledge is out of date");
-  gitHook.command("status", { isDefault: true }).description("Show whether the Athena pre-commit hook is installed").action(run(async (_o, cmd) => (await import("./git-hook-YZNZGAAP.js")).gitHookStatusCommand(globals(cmd))));
-  gitHook.command("install").description("Add the Athena pre-commit hook (existing hooks are kept; Athena adds a marked block)").option("--review", "Also run `athena review` and block commits with possible secrets or env files").action(run(async (o, cmd) => (await import("./git-hook-YZNZGAAP.js")).gitHookInstallCommand({ ...globals(cmd), review: o.review })));
-  gitHook.command("uninstall").description("Remove Athena's pre-commit hook or block").action(run(async (_o, cmd) => (await import("./git-hook-YZNZGAAP.js")).gitHookUninstallCommand(globals(cmd))));
-  program.command("open").description("Start (or reuse) the local web UI and open it in your browser").option("-p, --port <port>", "Port to bind (default: first free port from 7432)").option("--host <host>", "Interface to bind (default: 127.0.0.1)").option("--allow-remote", "Allow binding to a non-loopback interface").option("--no-open", "Do not launch a browser").option("--no-watch", "Do not watch the project for changes").action(run(async (o, cmd) => (await import("./open-2QSZKKUG.js")).openCommand({ ...globals(cmd), ...o, signal: controller.signal })));
-  program.command("activity").description("Show AI agent activity observed through hooks").option("-n, --limit <count>", "Number of events to show (default 30)").option("--agent <id>", "Only show events from this agent").action(run(async (o, cmd) => (await import("./activity-P4UUFHWV.js")).activityCommand({ ...globals(cmd), ...o })));
+  gitHook.command("status", { isDefault: true }).description("Show whether the Athena pre-commit hook is installed").action(run(async (_o, cmd) => (await import("./git-hook-Y7Y262F7.js")).gitHookStatusCommand(globals(cmd))));
+  gitHook.command("install").description("Add the Athena pre-commit hook (existing hooks are kept; Athena adds a marked block)").option("--review", "Also run `athena review` and block commits with possible secrets or env files").action(run(async (o, cmd) => (await import("./git-hook-Y7Y262F7.js")).gitHookInstallCommand({ ...globals(cmd), review: o.review })));
+  gitHook.command("uninstall").description("Remove Athena's pre-commit hook or block").action(run(async (_o, cmd) => (await import("./git-hook-Y7Y262F7.js")).gitHookUninstallCommand(globals(cmd))));
+  program.command("open").description("Start (or reuse) the local web UI and open it in your browser").option("-p, --port <port>", "Port to bind (default: first free port from 7432)").option("--host <host>", "Interface to bind (default: 127.0.0.1)").option("--allow-remote", "Allow binding to a non-loopback interface").option("--no-open", "Do not launch a browser").option("--no-watch", "Do not watch the project for changes").action(run(async (o, cmd) => (await import("./open-LJMOB6U2.js")).openCommand({ ...globals(cmd), ...o, signal: controller.signal })));
+  program.command("activity").description("Show AI agent activity observed through hooks").option("-n, --limit <count>", "Number of events to show (default 30)").option("--agent <id>", "Only show events from this agent").action(run(async (o, cmd) => (await import("./activity-XCHKBZTG.js")).activityCommand({ ...globals(cmd), ...o })));
   program.command("event").description("Record an agent hook event (called by AI coding agents, reads JSON on stdin)").option("--agent <id>", "Agent that fired the hook").option("--hook <name>", "Hook event name").option("--athena-hook", "Marker used to identify Athena-managed hook entries").option("--verbose-errors", "Print errors to stderr (hooks stay silent by default)").action(
     run(async (o, cmd) => {
       const g = globals(cmd);
-      await (await import("./event-TNT6CQZR.js")).eventCommand({ agent: o.agent, hook: o.hook, cwd: g.cwd, verbose: o.verboseErrors });
+      await (await import("./event-6YW6TGFI.js")).eventCommand({ agent: o.agent, hook: o.hook, cwd: g.cwd, verbose: o.verboseErrors });
     })
   );
-  program.command("clean").description("Remove .athena/ and Athena agent integrations").option("-y, --yes", "Skip confirmation").option("--keep-agents", "Keep agent integration files/blocks").action(run(async (o, cmd) => (await import("./clean-S7PKCOLM.js")).cleanCommand({ ...globals(cmd), ...o })));
+  program.command("clean").description("Remove .athena/ and Athena agent integrations").option("-y, --yes", "Skip confirmation").option("--keep-agents", "Keep agent integration files/blocks").action(run(async (o, cmd) => (await import("./clean-LQOG56AM.js")).cleanCommand({ ...globals(cmd), ...o })));
   program.command("version").description("Print the Athena version").action(run(async (_o, cmd) => {
     if (globals(cmd).json) json({ version: ATHENA_VERSION, node: process.versions.node, platform: process.platform });
     else line(ATHENA_VERSION);
@@ -145,4 +176,4 @@ export {
   buildProgram,
   main
 };
-//# sourceMappingURL=program-V2USHGXN.js.map
+//# sourceMappingURL=program-DCP526LU.js.map

package/dist/{review-R3R2J5BJ.js → review-VEJBPACX.js}

@@ -2,7 +2,8 @@
 import {
   hasBlockers,
   reviewChanges
-} from "./chunk-EF6GHOIN.js";
+} from "./chunk-C25FDXOO.js";
+import "./chunk-Y6SDMZET.js";
 import "./chunk-3IS2X2Z7.js";
 import {
   c,
@@ -22,18 +23,21 @@ import "./chunk-KBO7XRBW.js";
 import {
   planSync,
   staleForCheck
-} from "./chunk-TGJUUB44.js";
-import "./chunk-PDFQ5BFG.js";
+} from "./chunk-PZPMWCXS.js";
+import "./chunk-GU3ZX2J7.js";
 import "./chunk-GR4DL2VM.js";
-import "./chunk-SJOOXO34.js";
-import "./chunk-PANVPNYF.js";
-import "./chunk-ELKFRTZT.js";
+import "./chunk-4FETKOY3.js";
 import "./chunk-2R6PXY6Z.js";
+import "./chunk-44EGCEB2.js";
 import "./chunk-PVCIGUIT.js";
-import "./chunk-OLPSEQS5.js";
-import "./chunk-JCGDR4UV.js";
-import "./chunk-2RS6TA3D.js";
+import "./chunk-ELKFRTZT.js";
+import "./chunk-AKOI4VTD.js";
+import "./chunk-SVTEJYMS.js";
+import "./chunk-QCC4VJUH.js";
+import "./chunk-WWQ5NKEC.js";
+import "./chunk-YRIS7ZS6.js";
 import "./chunk-GHFRQAYT.js";
+import "./chunk-INT3IGMQ.js";
 import "./chunk-673EPYYH.js";
 import "./chunk-FQEGEVLY.js";
 import "./chunk-2DY4PUR4.js";
@@ -41,7 +45,6 @@ import "./chunk-IQQBAWSM.js";
 import {
   EXIT
 } from "./chunk-AD4OZCU2.js";
-import "./chunk-INT3IGMQ.js";
 import "./chunk-XW3MLHI2.js";
 import "./chunk-EUPETUWA.js";
 
@@ -112,4 +115,4 @@ ${blockers} blocker${blockers === 1 ? "" : "s"} found.`));
 export {
   reviewCommand
 };
-//# sourceMappingURL=review-R3R2J5BJ.js.map
+//# sourceMappingURL=review-VEJBPACX.js.map

package/dist/{rules-4FXJUCXB.js → rules-M4DLLXBL.js}

@@ -2,7 +2,7 @@
 import {
   getRules,
   mutateRules
-} from "./chunk-LEMPCNAY.js";
+} from "./chunk-56EXAGTM.js";
 import {
   addRule,
   removeRule,
@@ -20,8 +20,8 @@ import {
   requireProjectRoot
 } from "./chunk-XFN7UZCS.js";
 import "./chunk-KBO7XRBW.js";
-import "./chunk-OLPSEQS5.js";
-import "./chunk-JCGDR4UV.js";
+import "./chunk-AKOI4VTD.js";
+import "./chunk-WWQ5NKEC.js";
 import "./chunk-673EPYYH.js";
 import "./chunk-FQEGEVLY.js";
 import "./chunk-2DY4PUR4.js";
@@ -80,4 +80,4 @@ export {
   rulesListCommand,
   rulesRemoveCommand
 };
-//# sourceMappingURL=rules-4FXJUCXB.js.map
+//# sourceMappingURL=rules-M4DLLXBL.js.map