@metaharness/devops 0.1.1 → 0.1.2
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 +38 -4
- package/package.json +8 -6
package/README.md
CHANGED
|
@@ -1,5 +1,39 @@
|
|
|
1
1
|
# MetaHarness: devops vertical
|
|
2
2
|
|
|
3
|
+
<!-- ruv-seo:start (ADR-356) -->
|
|
4
|
+
MetaHarness example — Claude Code incident-response vertical with responder, runbook-runner, escalator, postmortem agents.
|
|
5
|
+
|
|
6
|
+
**Supported environments:** Node.js 20+ on Linux, macOS and Windows. The scaffold runs `npx metaharness@latest`, so the first run needs network access. This is the `@metaharness/devops` path from [`metaharness`](https://www.npmjs.com/package/metaharness): the same scaffold as `npx metaharness new my-bot`, plus this example's files.
|
|
7
|
+
|
|
8
|
+
## Quickstart
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
npx @metaharness/devops my-bot
|
|
12
|
+
npx -y -p metaharness harness doctor my-bot | tail -1
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Expected output (npm notices removed, temp path shortened to `./`):
|
|
16
|
+
|
|
17
|
+
```text
|
|
18
|
+
Scaffolded my-bot into ./my-bot
|
|
19
|
+
Files: 26
|
|
20
|
+
Manifest: ./my-bot/.harness/manifest.json
|
|
21
|
+
|
|
22
|
+
Next: cd my-bot && npm install
|
|
23
|
+
Then: npm run doctor
|
|
24
|
+
Run: claude -p --plugin-dir my-bot "page: <your incident here>"
|
|
25
|
+
Result: HEALTHY (./my-bot)
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
**Next:** [`@metaharness/darwin`](https://www.npmjs.com/package/@metaharness/darwin) — evolve the scaffolded harness against its own tests instead of hand-tuning it.
|
|
29
|
+
<!-- ruv-seo:end -->
|
|
30
|
+
|
|
31
|
+
## Reference
|
|
32
|
+
|
|
33
|
+
> ⚠️ **Illustrative output.** Transcripts and validation/run output shown in this README are
|
|
34
|
+
> representative examples, not captured from a specific run — actual output depends on your
|
|
35
|
+
> environment, models, and inputs. Run the commands to see real results.
|
|
36
|
+
|
|
3
37
|
A ready-made multi-agent scaffold for incident response on top of Claude Code. It provisions four specialized agents — `responder`, `runbook-runner`, `escalator`, and `postmortem` — wired together with tiered model routing, project-scoped settings, and a `harness doctor` health check. Use it to bootstrap an on-call assistant that triages alerts, executes runbooks, escalates when stuck, and writes the postmortem afterward.
|
|
4
38
|
|
|
5
39
|
This scaffold is for SREs, platform engineers, and on-call developers who want a working incident-response harness in one command instead of assembling agents, prompts, and config by hand. It is NOT a hosted service, an alerting system, or a replacement for PagerDuty / Opsgenie / Grafana OnCall — it is the Claude Code layer that sits next to those tools.
|
|
@@ -8,7 +42,7 @@ This scaffold is for SREs, platform engineers, and on-call developers who want a
|
|
|
8
42
|
|
|
9
43
|
```bash
|
|
10
44
|
npx @metaharness/devops@latest my-bot
|
|
11
|
-
cd my-bot && npm install &&
|
|
45
|
+
cd my-bot && npm install && npm run doctor
|
|
12
46
|
```
|
|
13
47
|
|
|
14
48
|
Then launch Claude Code against the scaffold:
|
|
@@ -26,14 +60,14 @@ claude -p --plugin-dir my-bot "page: api-gateway 5xx spike, last 10m"
|
|
|
26
60
|
- `.claude/settings.json` — project-scoped Claude Code config with allow-listed tools (Read, Grep, Glob, Bash for read-only commands).
|
|
27
61
|
- `mcp.json` — pre-wired MCP server stubs for log search and metrics queries; edit to point at your stack.
|
|
28
62
|
- `runbooks/` — example runbook templates the `runbook-runner` agent consumes.
|
|
29
|
-
- `package.json` with a `harness` bin shim so `
|
|
63
|
+
- `package.json` with a `harness` bin shim so `npm run doctor` and `npm run validate` work out of the box.
|
|
30
64
|
|
|
31
65
|
## Advanced
|
|
32
66
|
|
|
33
67
|
Run the bundled doctor to verify the scaffold is healthy:
|
|
34
68
|
|
|
35
69
|
```bash
|
|
36
|
-
$
|
|
70
|
+
$ npm run doctor
|
|
37
71
|
[harness] node: v20.11.1 ok
|
|
38
72
|
[harness] claude code: detected
|
|
39
73
|
[harness] agents: 4 found (responder, runbook-runner, escalator, postmortem)
|
|
@@ -45,7 +79,7 @@ ok
|
|
|
45
79
|
Validate the agent frontmatter and tier assignments:
|
|
46
80
|
|
|
47
81
|
```bash
|
|
48
|
-
$
|
|
82
|
+
$ npm run validate
|
|
49
83
|
[harness] agents/responder.md tier=sonnet tools=Read,Grep,Bash ok
|
|
50
84
|
[harness] agents/runbook-runner.md tier=haiku tools=Read,Bash ok
|
|
51
85
|
[harness] agents/escalator.md tier=sonnet tools=Read,WebFetch ok
|
package/package.json
CHANGED
|
@@ -1,13 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@metaharness/devops",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "MetaHarness example — Claude Code incident-response vertical with responder, runbook-runner, escalator, postmortem agents (npx @metaharness/devops my-bot)",
|
|
5
|
-
"homepage": "https://
|
|
5
|
+
"homepage": "https://ruv.io",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
8
|
-
"url": "https://github.com/ruvnet/
|
|
8
|
+
"url": "https://github.com/ruvnet/metaharness.git",
|
|
9
9
|
"directory": "examples-packages/devops"
|
|
10
10
|
},
|
|
11
|
+
"bugs": {
|
|
12
|
+
"url": "https://github.com/ruvnet/metaharness/issues"
|
|
13
|
+
},
|
|
11
14
|
"license": "MIT",
|
|
12
15
|
"author": "rUv <ruv@ruv.net>",
|
|
13
16
|
"type": "module",
|
|
@@ -23,14 +26,13 @@
|
|
|
23
26
|
"keywords": [
|
|
24
27
|
"metaharness",
|
|
25
28
|
"agent-harness",
|
|
26
|
-
"agent-harness-generator",
|
|
27
29
|
"devops",
|
|
28
|
-
"vertical",
|
|
29
30
|
"claude-code",
|
|
30
31
|
"ai-agent",
|
|
31
32
|
"mcp",
|
|
32
33
|
"npx",
|
|
33
|
-
"scaffold"
|
|
34
|
+
"scaffold",
|
|
35
|
+
"agent-scaffold"
|
|
34
36
|
],
|
|
35
37
|
"publishConfig": {
|
|
36
38
|
"access": "public"
|