@merittdev/horus 0.11.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +14 -7
  2. package/dist/index.cjs +375 -316
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  **Understand what happened.**
8
8
 
9
- Open-source incident investigation. Horus connects Elasticsearch, Sentry, Grafana, MongoDB, Postgres, Redis, BullMQ, and source intelligence into deterministic reports — installable today.
9
+ Open-source incident investigation. Horus connects Elasticsearch, Sentry, Grafana, MongoDB, Postgres, Redis (incl. BullMQ queues), Axiom logs, and source intelligence into deterministic reports — installable today.
10
10
 
11
11
  CLI-only. Read-only against production systems. Horus never writes to your infrastructure.
12
12
 
@@ -63,7 +63,7 @@ Horus source intelligence requires a local code-graph host (the curl installer a
63
63
 
64
64
  | Runtime + Source | Investigation Engine | Investigation Report |
65
65
  |---|---|---|
66
- | Elasticsearch logs · Sentry errors | Correlation | Suspected causes (ranked) |
66
+ | Elasticsearch · Axiom logs · Sentry errors | Correlation | Suspected causes (ranked) |
67
67
  | Grafana metrics | Timeline | Hypotheses + confidence |
68
68
  | MongoDB · Postgres · Redis state | Cause ranking | Evidence + gaps |
69
69
  | BullMQ queue runtime | | Next actions |
@@ -73,7 +73,7 @@ Pipeline: **Evidence → Correlation → Hypotheses → Timeline → Report**
73
73
 
74
74
  ## Sources Horus investigates
75
75
 
76
- Elasticsearch · Sentry · Grafana · MongoDB · Postgres · Redis · BullMQ · Git changes · Source graph · Queue map · Ownership
76
+ Elasticsearch · Sentry · Grafana · MongoDB · Postgres · Redis · BullMQ · Axiom · Git changes · Source graph · Queue map · Ownership
77
77
 
78
78
  Trace reconstruction is not shipped yet. Connectors are read-only and project-scoped.
79
79
 
@@ -124,6 +124,7 @@ Installable today. More connectors and AI providers are in progress.
124
124
  **Today**
125
125
 
126
126
  - Elasticsearch logs
127
+ - Axiom logs
127
128
  - Sentry errors
128
129
  - Grafana metrics
129
130
  - MongoDB / Postgres / Redis state
@@ -149,11 +150,12 @@ Horus is organized in four layers:
149
150
 
150
151
  **Source Intelligence**
151
152
 
152
- - Horus source intelligence backend — code graph, semantic search, impact analysis, ownership.
153
+ - Horus source intelligence backend — code graph, semantic search, impact analysis, ownership across TypeScript/JavaScript and Python (tree-sitter).
153
154
 
154
155
  **Runtime Evidence**
155
156
 
156
157
  - **Elasticsearch** — logs → synthesized error-signature evidence
158
+ - **Axiom** — structured logs (APL) → synthesized error-signature evidence, same path as Elasticsearch
157
159
  - **Sentry** — grouped exceptions (issues) → same error-signature / direct-seed path as logs
158
160
  - **MongoDB / Postgres** — application/operational state
159
161
  - **Grafana** — metrics via its datasource proxy
@@ -186,7 +188,7 @@ Horus talks to the source intelligence backend over **HTTP/MCP only** (no CLI sh
186
188
  The config model separates **code** from **runtime**:
187
189
 
188
190
  - **Code belongs to the project** — `repositories[]`, each served by its own source intelligence host.
189
- - **Runtime belongs to the environment** — `environments[].connectors` (Elasticsearch, Sentry, MongoDB, Postgres, Grafana, Redis/BullMQ).
191
+ - **Runtime belongs to the environment** — `environments[].connectors` (Elasticsearch, Sentry, MongoDB, Postgres, Grafana, Redis/BullMQ, Axiom).
190
192
 
191
193
  ```ts
192
194
  // config/horus.config.ts
@@ -265,7 +267,7 @@ The installer **does not** configure Elasticsearch, MongoDB, Grafana, Redis, or
265
267
 
266
268
  ```bash
267
269
  # Replace vX.Y.Z with the current release tag
268
- curl -fsSL https://github.com/meritt-dev/horus/releases/download/v0.1.0/horus-v0.1.0 -o horus
270
+ curl -fsSL https://github.com/meritt-dev/horus/releases/download/v0.12.0/horus-v0.12.0 -o horus
269
271
  chmod +x horus
270
272
  sudo mv horus /usr/local/bin/horus
271
273
  horus --version
@@ -311,12 +313,17 @@ horus investigate --help
311
313
  | Command | What it does |
312
314
  | --- | --- |
313
315
  | `horus status [--project --env]` | Per-project/env connector-health matrix |
316
+ | `horus connect <type>` | Add/update a runtime connector — `elasticsearch` / `mongodb` / `postgres` / `sentry` / `axiom` / `grafana` / `redis` (plus `ai` to configure an AI provider) |
314
317
  | `horus index --project <p> --env <e>` | Build the queue map (stitcher) for a project |
318
+ | `horus hosts [--reap]` | List source-intelligence hosts and live status; `--reap` stops orphaned hosts |
319
+ | `horus stop [--all]` | Stop this repo's source-intelligence host (`--all` stops every host) |
315
320
  | `horus investigate --project <p> --env <e> "<hint>"` | Full deterministic investigation report |
316
321
  | `horus logs [service] --project <p> --env <e>` | Error-signature evidence (`--raw` for lines) |
317
322
  | `horus state --project <p> --env <e>` | MongoDB application-state evidence (read-only) |
318
323
  | `horus metrics [hint] --project <p> --env <e>` | Grafana metrics evidence |
319
324
  | `horus explain <symbol>` · `blast-radius` · `architecture` · `what-changed` | Source-aware code intelligence (requires source intelligence backend) |
325
+ | `horus memory <show\|add\|list\|link\|...>` | Inspect/author deterministic incident memory; `memory link` adds `supersedes` / `contradicts` / `recurs-with` edges |
326
+ | `horus feedback <id> [--resolved] [--note] [--cause]` | Record outcome feedback on an investigation (improves Horus) |
320
327
 
321
328
  ## Local project workflow (git-style)
322
329
 
@@ -340,7 +347,7 @@ horus projects
340
347
  ```
341
348
  packages/
342
349
  core/ evidence model, config schema + project/env resolution, version pins
343
- connectors/ provider contracts + source intelligence (HTTP/MCP) · Elasticsearch · Grafana · MongoDB · Git
350
+ connectors/ provider contracts + source intelligence (HTTP/MCP) · Elasticsearch · Sentry · Axiom · Grafana · MongoDB · Postgres · Redis · BullMQ · application-state · Git
344
351
  stitcher/ queue-boundary stitcher
345
352
  db/ Drizzle schema + migrations (plain Postgres, no pgvector)
346
353
  engine/ deterministic investigation pipeline (timeline, correlation, hypotheses, gaps)