π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
docs(claude-md): MetaHarness Integration section β make ADR-150 discoverable (iter 22)
ruv025f3d358e40
diff --git a/CLAUDE.md b/CLAUDE.mdindex 475079fbb5..e52d57b499 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -1105,6 +1105,78 @@ export const LIVE_REGISTRY_CID = 'NEW_CID_FROM_PINATA';curl -s "https://gateway.pinata.cloud/ipfs/{NEW_CID}" | jq '.totalPlugins'```+## MetaHarness Integration (ADR-150)++Ruflo integrates with the upstream `metaharness` / `@metaharness/*` ecosystem as a sibling agent-harness scaffolding system (same author, designed around ruflo's primitives). Both `metaharness` and `@metaharness/router` are in `optionalDependencies` β never required at runtime.++### Architectural constraint (load-bearing)++**Ruflo remains operational if every MetaHarness package is removed.** Four rules:+1. **Removable**: `npm ls --without @metaharness/*` must still produce a working CLI+2. **Optional in package.json**: `@metaharness/*` packages MUST be in `optionalDependencies`, never in `dependencies`+3. **Graceful degradation**: every code path that touches MetaHarness catches `MODULE_NOT_FOUND` and falls back+4. **CI gate**: `.github/workflows/no-metaharness-smoke.yml` enforces all three by static grep + runtime drill on every PR++### Command + tool surface++```bash+# CLI subcommands (npx ruflo metaharness β¦)+npx ruflo metaharness score # 5-dim readiness scorecard+npx ruflo metaharness genome # 7-section categorical report+npx ruflo metaharness mcp-scan --fail-on high # static security findings+npx ruflo metaharness threat-model # enterprise threat report+npx ruflo metaharness oia-audit --alert-on-worst high+ # composite weekly audit β memory+npx ruflo metaharness audit-list --since 30d # enumerate audit records+npx ruflo metaharness audit-trend \ # diff two audits (drift)+ --baseline-key <a> --current-key <b> --alert-on-worsening+npx ruflo metaharness mint --name foo --template vertical:coding --confirm++# Dedicated command+npx ruflo eject --name my-harness # lift ruflo project β standalone harness+ # dry-run by default; refuses in-repo target++# Doctor health check+npx ruflo doctor --component metaharness # report metaharness availability + version++# MCP tools (callable by Claude Code agents)+mcp__claude-flow__metaharness_score+mcp__claude-flow__metaharness_genome+mcp__claude-flow__metaharness_mcp_scan+mcp__claude-flow__metaharness_threat_model+mcp__claude-flow__metaharness_oia_audit+mcp__claude-flow__metaharness_audit_list+mcp__claude-flow__metaharness_audit_trend+```++### Routing integration (ADR-148/149)++`@metaharness/router@~0.3.2` is wired as the cost-optimal model router behind the `CLAUDE_FLOW_ROUTER_NEURAL=1` triple-gate. The `routedBy` field on every routing decision carries `'metaharness-knn' | 'metaharness-krr' | 'fastgrnn'` when the neural path is active.++### SelfEvolvingRouter parallel-logging (ADR-150 Phase 2)++When `CLAUDE_FLOW_ROUTER_PARALLEL_LOG=1` is set, every `route()` call writes a paired-decision row (bandit pick + neural-augmented pick + outcome) to `.swarm/router-parallel.jsonl`. Analyze with:++```bash+node plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs \+ --input .swarm/router-parallel.jsonl --strict+```++The 3-criteria AND-gate from ADR-150 review-round-1: `quality > 2% AND cost < 1% AND latency < 5%`. Exit 1 in `--strict` mode if any criterion fails β promotion gate.++### CI workflows++- `metaharness-ci.yml` β score / mcp-scan / router-compat / eject-dryrun jobs on every PR touching `plugins/ruflo-metaharness/**`+- `no-metaharness-smoke.yml` β enforces the four architectural-constraint rules above on every PR+- `oia-audit-weekly.yml` β Sundays 04:17 UTC, runs composite audit, uploads 90-day artifact++### Cross-references++- [ADR-150](v3/docs/adr/ADR-150-metaharness-integration-surfaces.md) β decision + implementation notes+- [Issue #2399](https://github.com/ruvnet/ruflo/issues/2399) β phase tracker+- [Research gist](https://gist.github.com/ruvnet/19d166ff9acf368c9da4172d91ac9113) β graded evidence+- Upstream: `github.com/ruvnet/agent-harness-generator`+## Optional Plugins (20 Available)Plugins are distributed via IPFS and can be installed with the CLI. Browse and install from the official registry:diff --git a/plugins/ruflo-metaharness/scripts/smoke.sh b/plugins/ruflo-metaharness/scripts/smoke.shindex 8a11fa8b1d..91aea0b164 100755--- a/plugins/ruflo-metaharness/scripts/smoke.sh+++ b/plugins/ruflo-metaharness/scripts/smoke.sh@@ -170,6 +170,24 @@ if (!od.metaharness) { console.error('missing metaharness in optionalDependencieif (j.dependencies && j.dependencies.metaharness) { console.error('metaharness leaked into dependencies'); process.exit(1); }" 2>/dev/null && ok || bad "ruflo wrapper missing metaharness optionalDep"+step "17n. CLAUDE.md documents MetaHarness integration (ADR-150 discoverability β iter 22)"+F="$ROOT/../../CLAUDE.md"+miss=""+[[ -f "$F" ]] || miss="$miss claude-md-missing"+grep -q "^## MetaHarness Integration (ADR-150)" "$F" || miss="$miss no-section-header"+# Architectural constraint anchor+grep -q "Ruflo remains operational if every MetaHarness package is removed" "$F" || miss="$miss no-constraint-quote"+# All 4 rules documented+grep -q "no-metaharness-smoke.yml" "$F" || miss="$miss no-ci-gate-ref"+# Command surface + tool surface enumerated+grep -q "npx ruflo metaharness score" "$F" || miss="$miss no-cli-example"+grep -q "mcp__claude-flow__metaharness_" "$F" || miss="$miss no-mcp-tool-list"+# Routing + parallel-log integration both mentioned+grep -q "CLAUDE_FLOW_ROUTER_NEURAL\|CLAUDE_FLOW_ROUTER_PARALLEL_LOG" "$F" || miss="$miss no-routing-flags"+# 3-criteria gate+grep -q "quality > 2% AND cost < 1% AND latency < 5%" "$F" || miss="$miss no-3-criteria-gate"+[[ -z "$miss" ]] && ok || bad "$miss"+step "17m. metaharness MCP tools registered (ADR-150 deepest integration β iter 20)"F="$ROOT/../../v3/@claude-flow/cli/src/mcp-tools/metaharness-tools.ts"miss=""