v3.12.0

camel-ai/camelv3.12.0Jun 17, 2026by ruvnet

AI Summary

This release introduces a deep integration of the metaharness ecosystem as a sibling agent-harness scaffolding system, ensuring ruflo remains operational even if metaharness packages are removed. It adds extensive new surfaces including CLI subcommands, MCP tools, and CI workflows for auditing and threat modeling, alongside significant improvements to genome similarity search and routing integration.

Key Highlights

Deep integration of the metaharness ecosystem with 4 architectural constraints (removable, optional, graceful, CI-gate).
Introduction of 10 new CLI subcommands and 9 new MCP tools for audit, threat modeling, and genome analysis.
Implementation of ADR-152 Genome Similarity Search with a pure-TS implementation and weighted blend algorithms.
Routing integration via `@metaharness/router` with neural gate and parallel logging capabilities.
Comprehensive validation suite including 117-step smoke tests and 120 MCP runtime assertions.

New Features

10 new CLI subcommands for metaharness operations (score, genome, mcp-scan, etc.).
9 new MCP tools for metaharness checks.
Dedicated `npx ruflo eject` command to lift projects into a standalone harness.
Genome Similarity Search (ADR-152 §3.1) with fastpath options for drift detection.
Routing integration with `CLAUDE_FLOW_ROUTER_NEURAL=1` and parallel logging support.

Full Release Notes

## Highlights

**ADR-150 deep integration of the metaharness ecosystem** as a sibling agent-harness scaffolding system, with 4 architectural constraints (removable / optional / graceful / CI-gate) that keep ruflo fully operational when every `@metaharness/*` package is removed.

### New surfaces

| Surface | Count | What |
|---|---|---|
| CLI subcommands | 10 | `npx ruflo metaharness {score,genome,mcp-scan,threat-model,oia-audit,audit-list,audit-trend,similarity,drift-from-history,mint}` |
| Dedicated CLI | 1 | `npx ruflo eject` — lift a ruflo project into a renamed standalone harness |
| MCP tools | 9 | `metaharness_score`, `metaharness_genome`, `metaharness_mcp_scan`, `metaharness_threat_model`, `metaharness_oia_audit`, `metaharness_audit_list`, `metaharness_audit_trend`, `metaharness_similarity`, `metaharness_drift_from_history` |
| Plugins | 1 | `plugins/ruflo-metaharness/` |
| CI workflows | 3 | `metaharness-ci`, `no-metaharness-smoke`, `oia-audit-weekly` |

### ADR-152 §3.1 Genome Similarity Search

- Pure-TS, zero `@metaharness/*` dep
- Weighted blend: cosine over 9 numerics + categorical over 4 enums + jaccard over agent_topology
- Returns `overall ∈ [0,1]` plus per-component breakdown
- 3-tier drift fastpath: slow / `--baseline-key` ~14× / `--baseline-file` ~19×

### Bundled fixes

- `#2400` — `pnpm-lock.yaml` regenerated to match `@claude-flow/cli` specifiers; unblocks main CI
- `#2390` — `--version` fast-path verified working in 3.11.0+
- `#1902/#1903/#1904` — Windows shim `ruflo-hook.cjs` for cost-tracker
- ADR-125/130 — router env vars registered as known escape hatches
- ADR-112 — `Use when…` guidance added to all 9 new MCP tool descriptions

### Routing integration (ADR-148/149)

- `@metaharness/router@~0.3.2` wired behind the `CLAUDE_FLOW_ROUTER_NEURAL=1` triple-gate
- `SelfEvolvingRouter` parallel-logging via `CLAUDE_FLOW_ROUTER_PARALLEL_LOG=1`
- 3-criteria AND-gate (quality > 2% AND cost < 1% AND latency < 5%) for promotion

## Install

```bash
npx ruflo@3.12.0          # wrapper (recommended)
npm i -g ruflo            # global install
```

## Quality

- **130+ iters** of validation hardening (lockfile drift, env-var precedence, Windows CI timeouts, pnpm workspace install, topological build, sharp postinstall, fetch-retry on ECONNRESET, eject CLI flag-routing, mcp-scan finding shape normalization, audit-trend chain timeouts, oia-audit graceful degradation, etc.)
- **117-step smoke suite** in `plugins/ruflo-metaharness/scripts/smoke.sh`
- **120 MCP runtime assertions** in `test-mcp-tools.mjs`
- **94 similarity unit assertions** in `test-similarity.mjs`
- **19 cross-reference integrity surfaces** anchoring source↔target consistency

## Compatibility

- Backward-compatible with 3.11.0 — no API surface removed
- Legacy `alpha` + `v3alpha` dist-tags continue to point at the latest stable
- All 3 packages published in lockstep: `@claude-flow/cli@3.12.0`, `claude-flow@3.12.0`, `ruflo@3.12.0`

🤖 Generated with [RuFlo](https://github.com/ruvnet/ruflo)