@metaharness/support 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rUv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# MetaHarness: support vertical
+
+A ready-made customer-support multi-agent template for Claude Code. Scaffolds a four-agent pipeline — triager, KB-searcher, responder, escalator — wired with tier-routed model selection, shared memory, and the MCP servers a support workflow actually needs. It is opinionated about pipeline shape and agent boundaries; it is not a hosted product, not a ticketing system, and not a CRM. You bring the knowledge base, the inbox, and the escalation channel; the scaffold gives you the agents and the glue.
+
+## Quickstart
+
+```bash
+npx @metaharness/support@latest my-bot
+cd my-bot && npm install && harness doctor
+```
+
+`harness doctor` checks Node, the Claude CLI, MCP server reachability, and the agent files. Fix anything red before sending traffic.
+
+## What you get
+
+- `agents/triager.md` — classifies inbound tickets by intent, urgency, and product area. **Tier: haiku** (cheap, high-volume).
+- `agents/kb-searcher.md` — semantic search over your knowledge base via the memory MCP server. **Tier: haiku**.
+- `agents/responder.md` — drafts the customer reply grounded in KB hits, handles tone and policy. **Tier: sonnet**.
+- `agents/escalator.md` — decides when to hand off to a human, writes the internal handoff note, redacts PII. **Tier: opus** (judgment-heavy, low-volume).
+- `mcp.json` — preconfigured MCP servers: memory (KB + conversation state), filesystem (transcripts), and a stub `tickets` server you point at your real ticketing backend.
+- `settings.json` — Claude Code permissions allowlist tuned for read-mostly support work plus the write paths the responder and escalator need.
+- `CLAUDE.md` — pipeline contract: who messages whom via `SendMessage`, what each agent must hand off, the escalation policy.
+
+## Advanced
+
+Validate the scaffold structure:
+
+```bash
+harness validate
+# ok agents/triager.md
+# ok agents/kb-searcher.md
+# ok agents/responder.md
+# ok agents/escalator.md
+# ok mcp.json
+# ok settings.json
+```
+
+Run a one-shot ticket through the pipeline headless, no interactive session:
+
+```bash
+claude -p --plugin-dir my-bot "Triage and respond to ticket #4821: 'Refund still not received after 10 days'"
+# triager  -> intent=refund_status, urgency=high
+# kb-searcher -> 3 KB hits (refund SLA, escalation policy, billing contact)
+# responder -> drafted reply (412 tokens)
+# escalator -> human handoff required: refund > 7 days
+```
+
+Swap the KB backend by editing `mcp.json`'s `memory` entry — point it at your existing AgentDB, a Postgres+pgvector store, or any MCP-compatible memory server. The agent prompts use the MCP tool surface, not a hardcoded backend.
+
+Override an agent's tier without editing prompts — set `tier: opus` in the agent's frontmatter and the responder will route through Opus instead of Sonnet on next run.
+
+## FAQ
+
+**Q: Does this connect to Zendesk / Intercom / Front out of the box?**
+A: No. The `tickets` MCP server in `mcp.json` is a stub. Replace its `command` with an MCP server that wraps your real ticketing API, or write a thin adapter — the agents only call MCP tools, not vendor SDKs.
+
+**Q: Where does the knowledge base live?**
+A: Wherever you point the `memory` MCP server. The default config uses a local AgentDB store at `./data/kb`. Index your KB once with `harness kb ingest <path>` (the scaffold ships the ingest script) and the kb-searcher agent will find it.
+
+**Q: Can I run this without the escalator agent?**
+A: Yes. Delete `agents/escalator.md` and remove the escalator handoff line in `CLAUDE.md`. The responder will then be the terminal node and you lose the human-handoff policy — wire one in your ticketing system instead.
+
+## License
+
+MIT. Built on metaharness (https://www.npmjs.com/package/metaharness).
+
+## Deep-dive
+
+Full explainer gist: https://gist.github.com/ruvnet/97a386e2c52cf15c6ec6d33386386180

package/bin/scaffold.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import process from 'node:process';
+
+const args = process.argv.slice(2);
+const name = args[0] && !args[0].startsWith('-') ? args[0] : 'my-bot';
+const extra = (args[0] && !args[0].startsWith('-') ? args.slice(1) : args)
+  .map((a) => (/\s/.test(a) ? `"${a.replace(/"/g, '\\"')}"` : a))
+  .join(' ');
+
+const cmd = [
+  'npx',
+  '--yes',
+  'metaharness@latest',
+  name,
+  '--template',
+  'vertical:support',
+  '--host',
+  'claude-code',
+  '--force',
+  extra,
+]
+  .filter(Boolean)
+  .join(' ');
+
+try {
+  execSync(cmd, { stdio: 'inherit' });
+} catch (err) {
+  console.error(`\nmetaharness failed: ${err.message || err}`);
+  process.exit(typeof err.status === 'number' ? err.status : 1);
+}
+
+console.log(`\nScaffolded support harness at ./${name}`);
+console.log(`Next: cd ${name} && npm install && harness doctor`);
+console.log(`Then: claude -p --plugin-dir ${name} "Triage ticket: <paste ticket here>"`);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@metaharness/support",
+  "version": "0.1.0",
+  "description": "MetaHarness example — customer-support multi-agent template (triager, KB-searcher, responder, escalator) for Claude Code. npx @metaharness/support my-bot",
+  "homepage": "https://github.com/ruvnet/agent-harness-generator/tree/main/examples-packages/support",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/agent-harness-generator.git",
+    "directory": "examples-packages/support"
+  },
+  "license": "MIT",
+  "author": "rUv <ruv@ruv.net>",
+  "type": "module",
+  "bin": "./bin/scaffold.mjs",
+  "files": [
+    "bin/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "smoke": "node --check bin/scaffold.mjs"
+  },
+  "keywords": [
+    "metaharness",
+    "agent-harness",
+    "agent-harness-generator",
+    "support",
+    "vertical",
+    "claude-code",
+    "ai-agent",
+    "mcp",
+    "npx",
+    "scaffold"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}