Menu
7-section repo readiness report from `metaharness genome <path>`. Returns repo_type / agent_topology / risk_score / mcp_surface / test_confidence / publish_readiness. Pure-read; degrades gracefully (ADR-150).
One-command drift detection. Composes audit-list + oia-audit + audit-trend into a single primitive — finds the most recent audit in `metaharness-audit` namespace, runs a fresh audit against the current repo, diffs them via ADR-152 §3.1 similarity, and alerts when structural distance crosses `--threshold`. Iter 53 of ADR-150 deep integration.
ADR-152 — weighted similarity between two harness fingerprints (genome + score JSON). Returns overall score in [0,1] plus per-component breakdown (cosine over 9 numerics, categorical agreement over 4 enums, jaccard over agent_topology). Unblocks ADR-151 §3.2 Recommender, §3.3 Drift Detection, §3.5 Plugin Compat. Pure-TS, no `@metaharness/*` dep — preserves ADR-150's four architectural constraints.
Composite Phase-2 audit worker (ADR-150). Bundles harness oia-manifest + threat-model + mcp-scan into one timestamped audit record stored in the `metaharness-audit` memory namespace. Designed for cron-scheduled drift detection.
Static security scan of a harness's declared MCP surface via `harness mcp-scan <path>`. Reads `.mcp/servers.json` + `.harness/claims.json`. Pure-read, no dispatch. Exits 1 on findings at or above `--fail-on` severity.
Scaffold a custom AI agent harness via `metaharness new <name> --template <id> --host <id>`. Defaults to DRY-RUN (no writes) unless --confirm is passed. Refuses to write to the calling repo root or anywhere inside it. Honors ADR-150 architectural constraint + ruflo's "destructive-action confirmation" pattern.
5-dimension harness readiness scorecard from `metaharness score <path>`. Returns harnessFit / compileConfidence / taskCoverage / toolSafety / memoryUsefulness + estCostPerRunUsd + scaffoldReady. Pure-read; subprocess invocation; degrades gracefully when MetaHarness is absent (ADR-150 architectural constraint).
| name | harness-genome |
| description | 7-section repo readiness report from `metaharness genome <path>`. Returns repo_type / agent_topology / risk_score / mcp_surface / test_confidence / publish_readiness. Pure-read; degrades gracefully (ADR-150). |
| argument-hint | [--path .] [--alert-on-risk-above 0.5] [--format table|json] |
| allowed-tools | Bash |
Companion to harness-score. Where score is a 5-dimension numeric
scorecard, genome is a 7-section categorical/numeric report covering
repo type, agent topology recommendations, risk score (0-1), MCP
surface area, test confidence (0-1), and publish readiness (0-1).
Implementation: scripts/genome.mjs.
npx metaharness genome <path> --json (60s hard timeout).{ repo_type, agent_topology[], risk_score, mcp_surface, test_confidence, publish_readiness }.--alert-on-risk-above N: exit 1 when risk_score > N.{
"repo_type": "node_mcp_ci",
"agent_topology": ["maintainer", "tester", "security", "release"],
"risk_score": 0.27,
"mcp_surface": "remote",
"test_confidence": 0.8,
"publish_readiness": 0.9
}
Ruflo's risk_score: 0.27 is low (good). publish_readiness: 0.9 is
high. The mcp_surface: "remote" reflects that ruflo's MCP servers are
hosted, not bundled.
agent_topology recommendations
drift away from a deliberate architecture choice.--alert-on-risk-above 0.5 fails the build when the repo's
risk profile crosses a threshold.harness-score — numeric readinessharness-mcp-scan — static MCP security findingsharness-threat-model — enterprise-review-grade threat model