@merittdev/horus 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,355 @@
+<p align="center">
+  <img src="https://meritt-dev-assets.s3.eu-central-1.amazonaws.com/public/horus-logo-dark-20260614171147.svg" width="72" alt="Horus" />
+</p>
+
+# Horus
+
+**Understand what happened.**
+
+Open-source incident investigation. Horus connects Elasticsearch, Grafana, MongoDB, BullMQ, and source intelligence into deterministic reports — installable today.
+
+CLI-only. Read-only against production systems. Horus never writes to your infrastructure.
+
+**Website:** [horus.sh](https://horus.sh) · **Source:** [github.com/meritt-dev/horus](https://github.com/meritt-dev/horus)
+
+```bash
+curl -fsSL https://horus.sh/install.sh | bash
+npm install -g @merittdev/horus
+brew install meritt-dev/tap/horus
+```
+
+Homebrew tap is live through meritt-dev/tap.
+
+---
+
+## What Horus does
+
+Horus reads from your existing systems and reconstructs the incident through evidence, correlation, and ranked hypotheses.
+
+It does not dump thousands of logs. It connects runtime signals to source context and returns a **deterministic report** — suspected causes (ranked), hypotheses, evidence, gaps, and next actions. Evidence before inference. Optional `--ai` adds an Anthropic narrative on top.
+
+Every incident leaves evidence.
+
+## What Horus is not
+
+| | |
+|---|---|
+| **Monitoring** | Detects problems |
+| **Observability** | Shows signals |
+| **Horus** | Reconstructs what happened |
+
+Horus is not another dashboard, alerting tool, or log viewer. It sits on top of the systems you already use.
+
+> Monitoring detects. Observability shows. Horus reconstructs.
+
+## Getting started
+
+```bash
+horus setup
+horus init
+horus index
+horus connect elasticsearch   # optional runtime connectors
+horus investigate "checkout latency spike"
+horus investigations          # list saved IDs
+horus replay <id>
+horus postmortem <id>
+```
+
+Horus source intelligence requires a local code-graph host (the curl installer attempts to install it). Postgres is required for the audit store.
+
+## How it works
+
+**Evidence in. Explanation out.**
+
+| Runtime + Source | Investigation Engine | Investigation Report |
+|---|---|---|
+| Elasticsearch logs | Correlation | Suspected causes (ranked) |
+| Grafana metrics | Timeline | Hypotheses + confidence |
+| MongoDB state | Cause ranking | Evidence + gaps |
+| BullMQ queues | | Next actions |
+| Source graph + git | | |
+
+Pipeline: **Evidence → Correlation → Hypotheses → Timeline → Report**
+
+## Sources Horus investigates
+
+Elasticsearch · Grafana · MongoDB · BullMQ · Git changes · Source graph · Queue map · Ownership
+
+Trace reconstruction is not shipped yet. Connectors are read-only and project-scoped.
+
+## Example output (illustrative)
+
+```bash
+horus investigate \
+  --project atlas-payments \
+  --env production \
+  "checkout latency spike"
+```
+
+```text
+# Investigation inv-347
+Hint: checkout latency spike
+
+## Suspected causes (ranked)
+1. [0.82 / high] Redis connection pool exhaustion [↑ queue]
+
+## Hypotheses
+  [supported] [0.78] queue: backlog growth preceded latency spike
+
+## Evidence gaps
+  - queue runtime state: worker heartbeat unavailable
+
+## Evidence
+- ev-01 [elasticsearch/error] Request timeout increase
+- ev-04 [bullmq/queue] checkout-jobs backlog growth
+
+## Next actions
+- Inspect worker concurrency changes in deploy #784
+```
+
+## Principles
+
+**Read-only** — Horus never writes to your production systems.
+
+**Deterministic first** — The engine is deterministic; optional `--ai` adds an Anthropic narrative.
+
+**Local-first** — Connectors read from your own clusters, not a hosted black box.
+
+**Project-scoped** — Every investigation belongs to a specific project and environment.
+
+## Capabilities
+
+Installable today. More connectors and AI providers are in progress.
+
+**Today**
+
+- Elasticsearch logs
+- Grafana metrics
+- MongoDB state
+- BullMQ queue evidence
+- Source intelligence (code graph)
+- Timeline generation
+- Evidence correlation
+- Investigation replay
+- Postmortem drafts
+
+**Coming next**
+
+- Kubernetes evidence
+- Distributed trace reconstruction
+- Slack evidence ingestion
+- Local AI provider execution
+
+---
+
+## Architecture
+
+Horus is organized in four layers:
+
+**Source Intelligence**
+
+- Horus source intelligence backend — code graph, semantic search, impact analysis, ownership.
+
+**Runtime Evidence**
+
+- **Elasticsearch** — logs → synthesized error-signature evidence
+- **MongoDB** — application/operational state
+- **Grafana** — metrics via its datasource proxy
+- **Redis / BullMQ** — queue runtime state
+- **Git** — change history, ownership signals
+
+**Investigation** (deterministic)
+
+- **Queue Stitcher** — connects producer `queue.add(...)` to consumer `@Processor` handlers
+- **Timeline Engine** — orders evidence into a sequence of events
+- **Correlation Engine** — connects evidence across sources into incident threads
+
+**Presentation**
+
+- **Deterministic investigation report** — evidence, timeline, hypotheses, gap analysis, next actions
+- **Optional AI narrative** — a later layer on top of the deterministic report
+
+### Source intelligence is built into Horus
+
+**Source intelligence is the expected intelligence layer used by Horus** — not an optional integration. Semantic search, impact analysis, ownership signals, change detection, and the process graph live in the Horus source intelligence backend; Horus does not duplicate them.
+
+The **only** code-intelligence gap Horus owns is **queue-boundary stitching**: the source graph terminates around `queue.add(...)` and doesn't connect a producer to the consumer's `@Processor`. The stitcher synthesizes those producer → queue → worker edges.
+
+> If the Horus source intelligence backend is unavailable, Horus can still collect runtime evidence, but source context, impact analysis, change analysis, and queue stitching become degraded.
+
+Horus talks to the source intelligence backend over **HTTP/MCP only** (no CLI shell-outs for queries). Run `horus index` in a repository to start and register its source intelligence host.
+
+## Configuration
+
+The config model separates **code** from **runtime**:
+
+- **Code belongs to the project** — `repositories[]`, each served by its own source intelligence host.
+- **Runtime belongs to the environment** — `environments[].connectors` (Elasticsearch, MongoDB, Grafana, Redis/BullMQ).
+
+```ts
+// config/horus.config.ts
+export default defineConfig({
+  projects: [
+    {
+      name: 'atlas-payments',
+      repositories: [
+        {
+          name: 'atlas-payments',
+          path: '/repos/atlas-payments',
+          source: { hostUrl: 'http://127.0.0.1:8420' },
+        },
+      ],
+      environments: [
+        {
+          name: 'production',
+          readOnly: true,
+          connectors: {
+            elasticsearch: {
+              indexPattern: 'atlas-payments-prod-*',
+              serviceName: 'atlas-payments-prod',
+            },
+            mongodb: {
+              database: 'atlas_payments_prod',
+              collections: ['orders', 'payments', 'workers'],
+            },
+            grafana: {},
+          },
+        },
+      ],
+    },
+  ],
+  database: {
+    url: process.env.DATABASE_URL ?? 'postgresql://horus:horus@localhost:5433/horus',
+  },
+});
+```
+
+**No connector runs without an explicit project/env scope** — there are no global connector defaults.
+
+**Secrets are never committed.** Connector credentials are read from environment variables at runtime. Keep them in a gitignored file (e.g. `~/.horus.env`) and `source` it before running. For a full reference on which Horus files to commit and which to gitignore, see **[docs/gitignore-guide.md](./docs/gitignore-guide.md)**.
+
+## Install
+
+See **[docs/install.md](./docs/install.md)** for full install, update, and uninstall instructions.
+
+```bash
+curl -fsSL https://horus.sh/install.sh | bash
+npm install -g @merittdev/horus
+brew install meritt-dev/tap/horus
+horus --version
+horus setup
+```
+
+The curl installer downloads the Horus CLI from GitHub Releases and attempts to install the Horus source intelligence backend. All three channels install the same `horus` binary.
+
+### What the installer installs
+
+| Component | Role | Required |
+| --- | --- | --- |
+| **Horus CLI** | The `horus` command | Yes |
+| **Horus source intelligence backend** | Enables `horus index`, `horus explain`, `horus changes`, `horus architecture` | Optional |
+
+### Prerequisites
+
+| Requirement | Role |
+| --- | --- |
+| Node.js 22+ | Horus CLI runtime (the installed binary needs Node.js) |
+| Postgres 16 | Investigation audit store — run locally via `docker compose up -d` or use a managed instance |
+| Python 3.11+ + uv/pip | Required only for the Horus source intelligence backend |
+
+The installer **does not** configure Elasticsearch, MongoDB, Grafana, Redis, or any production system. Runtime connectors are added per-project after install via `horus connect`.
+
+### Direct download (without the curl installer)
+
+```bash
+# Replace vX.Y.Z with the current release tag
+curl -fsSL https://github.com/meritt-dev/horus/releases/download/v0.1.0/horus-v0.1.0 -o horus
+chmod +x horus
+sudo mv horus /usr/local/bin/horus
+horus --version
+```
+
+To **update** to a newer version, re-run the installer — it overwrites the binary and leaves your config untouched. To **uninstall**, see **[docs/install.md#uninstall](./docs/install.md#uninstall)**.
+
+If something goes wrong after install, see **[docs/troubleshooting.md](./docs/troubleshooting.md)**.
+
+## Local development
+
+```bash
+pnpm install
+docker compose up -d                  # Postgres 16 on localhost:5433
+pnpm build                            # builds apps/horus/dist/index.cjs
+
+# Per repository: start the source intelligence host and stitch queue boundaries
+horus index
+
+source ~/.horus.env
+
+node apps/horus/dist/index.cjs status
+```
+
+**Verify the full v0.1 user path (init → investigate → replay → postmortem):**
+
+```bash
+# No-services startup check (version, help, doctor):
+./scripts/smoke-test.sh apps/horus/dist/index.cjs
+
+# Full end-to-end flow (requires Postgres from docker compose up -d):
+./scripts/e2e-smoke.sh apps/horus/dist/index.cjs
+```
+
+```bash
+horus --help
+horus help <command>
+horus investigate --help
+```
+
+### Core commands
+
+| Command | What it does |
+| --- | --- |
+| `horus status [--project --env]` | Per-project/env connector-health matrix |
+| `horus index --project <p> --env <e>` | Build the queue map (stitcher) for a project |
+| `horus investigate --project <p> --env <e> "<hint>"` | Full deterministic investigation report |
+| `horus logs [service] --project <p> --env <e>` | Error-signature evidence (`--raw` for lines) |
+| `horus state --project <p> --env <e>` | MongoDB application-state evidence (read-only) |
+| `horus metrics [hint] --project <p> --env <e>` | Grafana metrics evidence |
+| `horus explain <symbol>` · `blast-radius` · `architecture` · `what-changed` | Source-aware code intelligence (requires source intelligence backend) |
+
+## Local project workflow (git-style)
+
+A repo carries a `.horus/config.json` (discovered by walking up from the working directory, like `.git`), and a global registry (`~/.horus/registry.json`) lets `--name` resolve a project from anywhere.
+
+```bash
+horus setup
+
+cd /repos/atlas-payments
+horus index
+
+horus investigate "checkout latency spike"
+horus investigate --name atlas-payments "checkout latency spike"
+horus projects
+```
+
+`horus index` reuses an already-running source intelligence host when one is healthy. Runtime connectors are added to the env block of `.horus/config.json` afterwards.
+
+## Layout
+
+```
+packages/
+  core/         evidence model, config schema + project/env resolution, version pins
+  connectors/   provider contracts + source intelligence (HTTP/MCP) · Elasticsearch · Grafana · MongoDB · Git
+  stitcher/     queue-boundary stitcher
+  db/           Drizzle schema + migrations (plain Postgres, no pgvector)
+  engine/       deterministic investigation pipeline (timeline, correlation, hypotheses, gaps)
+  cli/          commander CLI
+apps/horus/     composition root (bundled bin)
+config/         horus.config.ts
+```
+
+## Foundation
+
+- TypeScript monorepo (pnpm + Turborepo)
+- Postgres + Drizzle — semantic search delegated to source intelligence backend
+- Built-in **Horus source intelligence backend**, over HTTP/MCP only
+- Project/environment-scoped connectors; read-only against production

package/dist/index.cjs

@@ -50314,7 +50314,7 @@ init_cjs_shims();
 
 // ../../packages/core/src/version.ts
 init_cjs_shims();
-var HORUS_VERSION = "0.1.0";
+var HORUS_VERSION = "0.1.2";
 var PINNED_AXON_VERSION = "1.0.1";
 var PINNED_SOURCE_VERSION = PINNED_AXON_VERSION;
 
@@ -67040,6 +67040,22 @@ async function runIndex(opts) {
           `  investigate: horus investigate --name ${name} "<hint>"  (or from this repo: horus investigate "<hint>")`
         )
       );
+    } else if (spawned && !configuredHost) {
+      const existingPath = discoverLocalConfig(root);
+      if (existingPath) {
+        const file = readLocalConfig(existingPath);
+        const project = file.project;
+        const repos = project["repositories"];
+        if (repos && repos.length > 0) {
+          repos[0]["source"] = { hostUrl };
+        }
+        writeLocalConfig(root, file);
+        registerProject(label, root, existingPath);
+        console.log(`${import_picocolors3.default.green("\u2713")} Indexed ${import_picocolors3.default.bold(label)} \u2014 source host registered at ${hostUrl}`);
+        console.log(import_picocolors3.default.dim(`  ${existingPath}`));
+      } else {
+        console.log(`${import_picocolors3.default.green("\u2713")} Indexed ${import_picocolors3.default.bold(label)} ${import_picocolors3.default.dim("(queue map refreshed)")}`);
+      }
     } else {
       console.log(
         `${import_picocolors3.default.green("\u2713")} Indexed ${import_picocolors3.default.bold(label)} ${import_picocolors3.default.dim("(queue map refreshed)")}`
@@ -67435,20 +67451,23 @@ function factorRuntimeSignals(items, now) {
   const timestamps = items.filter((e) => e.timestamp !== void 0).map((e) => new Date(e.timestamp).getTime()).sort((a, b2) => b2 - a);
   const newestTs = timestamps[0];
   if (newestTs !== void 0) {
-    const ageMs = nowMs - newestTs;
-    if (ageMs <= 36e5) {
-      recencyDelta = 0.05;
-      recencyReason = "Evidence from within the last hour";
-    } else if (ageMs <= 864e5) {
-      recencyDelta = 0.02;
-      recencyReason = "Evidence from within the last 24 hours";
-    } else if (ageMs <= 2592e5) {
-    } else if (ageMs <= 6048e5) {
-      recencyDelta = -0.02;
-      recencyReason = "Most recent evidence is 3\u20137 days old \u2014 may predate this incident";
-    } else {
-      recencyDelta = -0.05;
-      recencyReason = "Most recent evidence is over 7 days old \u2014 likely predates this incident";
+    const rawAgeMs = nowMs - newestTs;
+    const ageMs = rawAgeMs < 0 ? rawAgeMs >= -3e5 ? 0 : null : rawAgeMs;
+    if (ageMs !== null) {
+      if (ageMs <= 36e5) {
+        recencyDelta = 0.05;
+        recencyReason = "Evidence from within the last hour";
+      } else if (ageMs <= 864e5) {
+        recencyDelta = 0.02;
+        recencyReason = "Evidence from within the last 24 hours";
+      } else if (ageMs <= 2592e5) {
+      } else if (ageMs <= 6048e5) {
+        recencyDelta = -0.02;
+        recencyReason = "Most recent evidence is 3\u20137 days old \u2014 may predate this incident";
+      } else {
+        recencyDelta = -0.05;
+        recencyReason = "Most recent evidence is over 7 days old \u2014 likely predates this incident";
+      }
     }
   }
   let recurrenceDelta = 0;
@@ -71906,6 +71925,36 @@ async function runReplay(id, opts) {
     const fmt = opts.format ?? "text";
     const out = fmt === "json" ? reportToJSON(report) : fmt === "markdown" || fmt === "md" ? reportToMarkdown(report) : renderReport2(report);
     console.log(out);
+    if (opts.ai && fmt !== "json") {
+      const narrativeInput = buildNarrativeInput(report);
+      const provider = new AnthropicNarrativeProvider({ model: opts.aiModel });
+      const { output, fromProvider, validationErrors } = await renderNarrative(narrativeInput, { provider });
+      if (!fromProvider) {
+        console.error(import_picocolors13.default.yellow("[ai] Provider unavailable \u2014 deterministic output shown above."));
+        if (validationErrors?.length) {
+          console.error(import_picocolors13.default.dim(`    ${validationErrors[0]}`));
+        }
+      } else {
+        const sep = "\u2500".repeat(60);
+        console.log(`
+${sep}`);
+        console.log(import_picocolors13.default.bold("AI Narrative"));
+        console.log(sep);
+        console.log(import_picocolors13.default.bold("What:"), output.what);
+        console.log(import_picocolors13.default.bold("Why:"), output.why);
+        if (output.whereNext.length > 0) {
+          console.log(import_picocolors13.default.bold("Next steps:"));
+          for (const step of output.whereNext) {
+            console.log(`  \u2022 ${step}`);
+          }
+        }
+        if (output.citations.length > 0) {
+          console.log(import_picocolors13.default.dim(`
+Cited evidence: ${output.citations.map((c) => c.evidenceId).join(", ")}`));
+        }
+        console.log(import_picocolors13.default.dim(`AI confidence: ${(output.confidence * 100).toFixed(0)}%`));
+      }
+    }
   } finally {
     await sql2.end();
   }
@@ -71963,7 +72012,39 @@ async function runPostmortem(id, opts) {
       }
       report = migrateReport(row.report);
     }
-    const content = generatePostmortem(report);
+    let content = generatePostmortem(report);
+    if (opts.aiSummary) {
+      const narrativeInput = buildNarrativeInput(report);
+      const provider = new AnthropicNarrativeProvider({ model: opts.aiModel });
+      const { output, fromProvider, validationErrors } = await renderNarrative(narrativeInput, { provider });
+      if (!fromProvider) {
+        content += `
+
+## AI Summary
+
+_AI summary unavailable: ${validationErrors?.[0] ?? "provider error"}_
+`;
+      } else {
+        content += "\n\n## AI Summary\n\n";
+        content += `**What happened:** ${output.what}
+
+`;
+        content += `**Why:** ${output.why}
+`;
+        if (output.whereNext.length > 0) {
+          content += "\n**Next steps:**\n";
+          for (const step of output.whereNext) {
+            content += `- ${step}
+`;
+          }
+        }
+        if (output.citations.length > 0) {
+          content += `
+**Cited evidence:** ${output.citations.map((c) => c.evidenceId).join(", ")}
+`;
+        }
+      }
+    }
     if (opts.output) {
       const outputPath = (0, import_node_path7.resolve)(opts.output);
       if ((0, import_node_fs6.existsSync)(outputPath) && !opts.force) {
@@ -72517,7 +72598,7 @@ async function runInit(opts) {
     const name = opts.name ?? (0, import_node_path8.basename)(root);
     const envName = opts.env ?? "production";
     const repo = { name, path: root };
-    if (opts.axon) repo["axon"] = { hostUrl: opts.axon };
+    if (opts.source) repo["source"] = { hostUrl: opts.source };
     const file = {
       version: 1,
       project: {
@@ -72531,9 +72612,9 @@ async function runInit(opts) {
     console.log(`${import_picocolors23.default.green("\u2713")} Initialized Horus project ${import_picocolors23.default.bold(name)}`);
     console.log(import_picocolors23.default.dim(`  config:     ${configPath}`));
     console.log(import_picocolors23.default.dim(`  registered: horus investigate --name ${name} "<hint>"`));
-    if (!opts.axon) {
+    if (!opts.source) {
       console.log(
-        import_picocolors23.default.dim("  no source-intelligence host set \u2014 run `horus index` to analyze + host, or pass --axon <url>")
+        import_picocolors23.default.dim("  no source-intelligence host set \u2014 run `horus index` to analyze + host, or pass --source <url>")
       );
     }
     console.log(
@@ -73301,7 +73382,7 @@ async function runDoctor(opts) {
       const project = file.project;
       const repos = project["repositories"];
       const hasHost = repos?.some(
-        (r) => r["axon"]?.["hostUrl"]
+        (r) => r["source"]?.["hostUrl"] ?? r["axon"]?.["hostUrl"]
       );
       if (hasHost) {
         checks.push({ label: "Source-intelligence host", status: "pass", detail: "configured" });
@@ -73310,7 +73391,7 @@ async function runDoctor(opts) {
           label: "Source-intelligence host",
           status: "warn",
           detail: "not configured",
-          next: "run `horus index` to analyze this repo and start a host, or pass --axon <url> to `horus init`"
+          next: "run `horus index` to analyze this repo and start a host, or pass --source <url> to `horus init`"
         });
       }
     } catch {
@@ -73566,7 +73647,7 @@ function configTemplate(name, repoPath) {
     repositories: [{
       name: '${name}',
       path: '${repoPath}',
-      axon: { hostUrl: 'http://127.0.0.1:8420' },
+      source: { hostUrl: 'http://127.0.0.1:8420' },
     }],
     environments: [{
       name: 'production',
@@ -73828,9 +73909,14 @@ Examples:
   program2.command("setup").description("Verify prerequisites (source-intelligence backend + Postgres) and guide any fixes").option("-c, --config <path>", "path to horus.config.ts").action(async (opts) => {
     process.exitCode = await runSetup(opts);
   });
-  program2.command("init").description("Create a local .horus/config.json for this repo and register it").option("--name <name>", "project name (default: repo directory name)").option("--env <name>", "environment name (default: production)").option("--axon <url>", "Source-intelligence host URL for this repo (e.g. http://127.0.0.1:8420)").option("--path <dir>", "repository root (default: nearest git root, else cwd)").action(
+  program2.command("init").description("Create a local .horus/config.json for this repo and register it").option("--name <name>", "project name (default: repo directory name)").option("--env <name>", "environment name (default: production)").option("--source <url>", "source-intelligence host URL for this repo (e.g. http://127.0.0.1:8420)").addOption(new Option("--axon <url>", "deprecated alias for --source").hideHelp()).option("--path <dir>", "repository root (default: nearest git root, else cwd)").action(
     async (opts) => {
-      process.exitCode = await runInit(opts);
+      process.exitCode = await runInit({
+        name: opts.name,
+        env: opts.env,
+        source: opts.source ?? opts.axon,
+        path: opts.path
+      });
     }
   ).addHelpText("after", `
 Examples:
@@ -73995,23 +74081,27 @@ Examples:
   horus investigations
   horus investigations -n 20
 `);
-  program2.command("replay <id>").description("Re-render a saved investigation from the audit store (no re-query)").option("-c, --config <path>", "path to horus.config.ts").option("--format <fmt>", "text | markdown | json", "text").action(async (id, opts) => {
-    process.exitCode = await runReplay(id, { config: opts.config, format: opts.format });
+  program2.command("replay <id>").description("Re-render a saved investigation from the audit store (no re-query)").option("-c, --config <path>", "path to horus.config.ts").option("--format <fmt>", "text | markdown | json", "text").option("--ai", "enrich report with AI narrative (requires ANTHROPIC_API_KEY; falls back to deterministic on failure)").option("--ai-model <model>", "AI model for --ai (default: claude-opus-4-8)").action(async (id, opts) => {
+    process.exitCode = await runReplay(id, { config: opts.config, format: opts.format, ai: opts.ai, aiModel: opts.aiModel });
   }).addHelpText("after", `
 Examples:
   horus replay <id>
   horus replay <id> --format markdown
   horus replay <id> --format json
+  horus replay <id> --ai
+  horus replay <id> --ai --ai-model claude-sonnet-4-6
 
   (Use 'horus investigations' to list saved investigation ids.)
 `);
-  program2.command("postmortem <id>").description("Draft an editable incident postmortem from a saved investigation").option("-c, --config <path>", "path to horus.config.ts").option("--output <path>", "write Markdown to a file instead of printing to stdout").option("--force", "overwrite the output file if it already exists").action(async (id, opts) => {
-    process.exitCode = await runPostmortem(id, { config: opts.config, output: opts.output, force: opts.force });
+  program2.command("postmortem <id>").description("Draft an editable incident postmortem from a saved investigation").option("-c, --config <path>", "path to horus.config.ts").option("--output <path>", "write Markdown to a file instead of printing to stdout").option("--force", "overwrite the output file if it already exists").option("--ai-summary", "append an AI-generated summary section (requires ANTHROPIC_API_KEY; falls back gracefully)").option("--ai-model <model>", "AI model for --ai-summary (default: claude-opus-4-8)").action(async (id, opts) => {
+    process.exitCode = await runPostmortem(id, { config: opts.config, output: opts.output, force: opts.force, aiSummary: opts.aiSummary, aiModel: opts.aiModel });
   }).addHelpText("after", `
 Examples:
   horus postmortem <id>
   horus postmortem <id> --output ./postmortem.md
   horus postmortem <id> --output ./postmortem.md --force
+  horus postmortem <id> --ai-summary
+  horus postmortem <id> --output ./postmortem.md --ai-summary --ai-model claude-sonnet-4-6
 
   (Use 'horus investigations' to list saved investigation ids.)
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@merittdev/horus",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local-first, source-aware production-incident investigation engine",
   "type": "module",
   "bin": {
@@ -13,7 +13,8 @@
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "tsup && vitest run --passWithNoTests",
-    "prepublishOnly": "tsup"
+    "prepublishOnly": "tsup",
+    "prepack": "cp ../../README.md README.md"
   },
   "engines": {
     "node": ">=22"