@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.
- package/README.md +14 -7
- package/dist/index.cjs +375 -316
- 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
|
|
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.
|
|
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)
|