π 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
feat(metaharness): pull in @metaharness/turn-credit + fix stale router/darwin pins (#2958)
rUvf35c545fbe92
diff --git a/.github/workflows/no-cli-optdep-bloat-2561.yml b/.github/workflows/no-cli-optdep-bloat-2561.ymlindex 1e0c657e16..9c52d3d670 100644--- a/.github/workflows/no-cli-optdep-bloat-2561.yml+++ b/.github/workflows/no-cli-optdep-bloat-2561.yml@@ -55,7 +55,16 @@ jobs:// no lifecycle scripts, zero transitive deps β measured 753ms to// cold-install all three into an empty dir on 2026-08-10). That// profile is the opposite of the #2561 native/wasm trees.- const CLI_MAX = 10;+ // Raised 10 β 13 for @metaharness/turn-credit (ADR-248, added+ // 2026-08-10): 64.9K unpacked, zero transitive deps, no lifecycle+ // scripts, measured ~110ms cold-install β same profile as+ // darwin/flywheel/radio. The prior bump left the budget exactly+ // at the post-PR count (10 == 10, zero slack), which meant the+ // very next unrelated optional-dep addition would trip this+ // guard for no reason connected to #2561; this bump leaves 2+ // slots of real headroom (11 declared today, budget 13) rather+ // than repeating that mistake.+ const CLI_MAX = 13;const RUFLO_MAX = 0;// Specific packages proven to trigger the cold-npx timeout indiff --git a/scripts/check-metaharness-pins.mjs b/scripts/check-metaharness-pins.mjsindex cab6ef3a1d..6827edc553 100644--- a/scripts/check-metaharness-pins.mjs+++ b/scripts/check-metaharness-pins.mjs@@ -20,11 +20,12 @@// a clean `npm install` actually materializes them; an optional PEER// dependency is never auto-installed, which is how a fresh ruflo install// shipped with zero MetaHarness packages on disk.-// - metaharness β the umbrella / MCP subprocess CLI (npx path; peer ok)-// - @metaharness/router β neural-router.ts dynamic import (peer ok β triple-gated)-// - @metaharness/darwin β Darwin evolve / GEPA subprocess (must be installable)-// - @metaharness/flywheel β receipt/gate interop (must be installable)-// - @metaharness/radio β coordination-policy optimizer (must be installable)+// - metaharness β the umbrella / MCP subprocess CLI (npx path; peer ok)+// - @metaharness/router β neural-router.ts dynamic import (peer ok β triple-gated)+// - @metaharness/darwin β Darwin evolve / GEPA subprocess (must be installable)+// - @metaharness/flywheel β receipt/gate interop (must be installable)+// - @metaharness/radio β coordination-policy optimizer (must be installable)+// - @metaharness/turn-credit β recursive turn-level credit assignment, ADR-248 (must be installable)// Plus a lock-step check: the MH_DARWIN_PIN constant in distill-oracle.ts (used// for the Tier-1 oracle's `npx @metaharness/darwin@<pin>` calls) must satisfy// the declared @metaharness/darwin range, so the two can't drift apart.@@ -106,6 +107,7 @@ async function main() {{ name: '@metaharness/darwin', installable: true },{ name: '@metaharness/flywheel', installable: true },{ name: '@metaharness/radio', installable: true },+ { name: '@metaharness/turn-credit', installable: true },];const pins = WATCHED.map((w) => ({ ...w, ...declaredRange(pkg, w.name) }));@@ -141,11 +143,14 @@ async function main() {if (ARGS.requireInstalled) {const cliDir = dirname(CLI_PKG);// Advertised symbol contract per package β verified against the real- // published artifacts (darwin 0.8.3 / flywheel 0.1.10 / radio 0.1.0).+ // published artifacts (darwin 0.9.0 / flywheel 0.1.10 / radio 0.1.0 / turn-credit 0.1.0).const API_CONTRACT = {'@metaharness/darwin': ['evolve', 'RefineMutator', 'summarizeFailedTraces'],'@metaharness/flywheel': ['runFlywheelGenerations', 'meetsPromotionRule', 'makeSigner', 'verifyReplayBundle', 'sequentialEvidence', 'withSequentialEvidence'],'@metaharness/radio': ['RadioBus', 'runProtocol', 'runSim'],+ // PAPER_DEFAULTS/GOVERNED_DEFAULTS are exported consts, not functions β+ // excluded here since this contract only asserts `typeof === 'function'`.+ '@metaharness/turn-credit': ['processTrajectory', 'creditByLabel', 'evidenceFromLogProbs', 'buildCreditReceiptPayload'],};for (const [pkgName, symbols] of Object.entries(API_CONTRACT)) {try {diff --git a/scripts/metaharness-clean-install-test.mjs b/scripts/metaharness-clean-install-test.mjsindex abc63ebdaf..047ec90353 100644--- a/scripts/metaharness-clean-install-test.mjs+++ b/scripts/metaharness-clean-install-test.mjs@@ -31,12 +31,13 @@ const CLI_PKG = join(HERE, '..', 'v3', '@claude-flow', 'cli', 'package.json');const FORMAT = process.argv.includes('--format') && process.argv[process.argv.indexOf('--format') + 1] === 'json' ? 'json' : 'table';// Advertised symbol contract per package β verified against the real published-// artifacts (darwin 0.8.3 / flywheel 0.1.10 / radio 0.1.0). Keep in sync with-// the --require-installed check in check-metaharness-pins.mjs.+// artifacts (darwin 0.9.0 / flywheel 0.1.10 / radio 0.1.0 / turn-credit 0.1.0).+// Keep in sync with the --require-installed check in check-metaharness-pins.mjs.const API_CONTRACT = {'@metaharness/darwin': ['evolve', 'RefineMutator', 'summarizeFailedTraces'],'@metaharness/flywheel': ['runFlywheelGenerations', 'meetsPromotionRule', 'makeSigner', 'verifyReplayBundle', 'sequentialEvidence', 'withSequentialEvidence'],'@metaharness/radio': ['RadioBus', 'runProtocol', 'runSim'],+ '@metaharness/turn-credit': ['processTrajectory', 'creditByLabel', 'evidenceFromLogProbs', 'buildCreditReceiptPayload'],};async function main() {diff --git a/v3/@claude-flow/cli/__tests__/services/distill-oracle.test.ts b/v3/@claude-flow/cli/__tests__/services/distill-oracle.test.tsindex 05d87dbd98..9b5fb587f7 100644--- a/v3/@claude-flow/cli/__tests__/services/distill-oracle.test.ts+++ b/v3/@claude-flow/cli/__tests__/services/distill-oracle.test.ts@@ -19,6 +19,7 @@ import {hasMechanicalSpec,resolveRemote,createSshOracleRunner,+ MH_DARWIN_PIN,type Trajectory,type OracleRunner,type CommandExec,diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.jsonindex d1dcf3ea5a..ebbf3f7c66 100644--- a/v3/@claude-flow/cli/package.json+++ b/v3/@claude-flow/cli/package.json@@ -123,16 +123,17 @@"@agntcy/slim-bindings": "2.0.0-alpha.5","@napi-rs/keyring": "1.3.0","@claude-flow/memory": "^3.0.0-alpha.21",- "@metaharness/darwin": "~0.8.3",+ "@metaharness/darwin": "~0.9.0","@metaharness/flywheel": "~0.1.10","@metaharness/radio": "~0.1.0",+ "@metaharness/turn-credit": "~0.1.0","agentdb": "^3.0.0-alpha.17","agentic-flow": "^3.0.0-alpha.1","better-sqlite3": "^12.9.0","ruvector": "^0.2.27"},"peerDependencies": {- "@metaharness/router": "^0.3.2",+ "@metaharness/router": "^0.4.0","metaharness": "^0.4.1"},"peerDependenciesMeta": {diff --git a/v3/@claude-flow/cli/src/commands/doctor.ts b/v3/@claude-flow/cli/src/commands/doctor.tsindex 39b348aed9..59e5d4fd1e 100644--- a/v3/@claude-flow/cli/src/commands/doctor.ts+++ b/v3/@claude-flow/cli/src/commands/doctor.ts@@ -1844,7 +1844,7 @@ async function checkMetaharnessDeclaredPackages(): Promise<HealthCheck> {name: NAME,status: 'fail',message: 'no @metaharness/* packages declared in optionalDependencies β the dependency contract regressed (peer-only declarations are never installed)',- fix: 'Restore @metaharness/darwin, @metaharness/flywheel, @metaharness/radio to optionalDependencies in @claude-flow/cli',+ fix: 'Restore @metaharness/darwin, @metaharness/flywheel, @metaharness/radio, @metaharness/turn-credit to optionalDependencies in @claude-flow/cli',};}diff --git a/v3/@claude-flow/cli/src/commands/neural.ts b/v3/@claude-flow/cli/src/commands/neural.tsindex f8578377ea..2c0d6acd1d 100644--- a/v3/@claude-flow/cli/src/commands/neural.ts+++ b/v3/@claude-flow/cli/src/commands/neural.ts@@ -1990,7 +1990,7 @@ const routerTrainCommand: Command = {try {mh = await import(metaharnessRouterPkg);} catch {- output.printError('@metaharness/router is not installed. `npm install @metaharness/router@^0.3.2` then re-run.');+ output.printError('@metaharness/router is not installed. `npm install @metaharness/router@^0.4.0` then re-run.');return { success: false, exitCode: 1 };}const { neuralRouterStatus } = await import('../ruvector/neural-router.js');diff --git a/v3/@claude-flow/cli/src/services/distill-oracle.ts b/v3/@claude-flow/cli/src/services/distill-oracle.tsindex f3bc648aa6..f0bcce4b01 100644--- a/v3/@claude-flow/cli/src/services/distill-oracle.ts+++ b/v3/@claude-flow/cli/src/services/distill-oracle.ts@@ -52,7 +52,7 @@ import {// scripts/check-metaharness-pins.mjs watch this constant for drift. Kept in// lock-step with the optionalDependencies pin in package.json and the plugin// darwin cache (versioned by the plugin's own `~0.8.0` pin in _darwin.mjs).-export const MH_DARWIN_PIN = '0.8.3';+export const MH_DARWIN_PIN = '0.9.0';// ββ Provenance βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββdiff --git a/v3/pnpm-lock.yaml b/v3/pnpm-lock.yamlindex 73feaca485..451071fdc5 100644--- a/v3/pnpm-lock.yaml+++ b/v3/pnpm-lock.yaml@@ -139,8 +139,8 @@ importers:specifier: ^2.2.5version: 2.2.5'@metaharness/router':- specifier: ^0.3.2- version: 0.3.2+ specifier: ^0.4.0+ version: 0.4.0'@noble/ed25519':specifier: 2.3.0version: 2.3.0@@ -191,14 +191,17 @@ importers:specifier: ^3.0.0-alpha.21version: link:../memory'@metaharness/darwin':- specifier: ~0.8.3- version: 0.8.3+ specifier: ~0.9.0+ version: 0.9.0'@metaharness/flywheel':specifier: ~0.1.10version: 0.1.10'@metaharness/radio':specifier: ~0.1.0version: 0.1.0+ '@metaharness/turn-credit':+ specifier: ~0.1.0+ version: 0.1.0'@napi-rs/keyring':specifier: 1.3.0version: 1.3.0@@ -1755,8 +1758,8 @@ packages:hasBin: truedev: false- /@metaharness/[email protected]:- resolution: {integrity: sha512-v5Ph7y9U6nqfvWajOjJiSuQDjPwvCKwOui793cSGUxIYUcfMoVoMzDfEDxOczFU61z0UUd7lD0I1b2zl+eYnag==}+ /@metaharness/[email protected]:+ resolution: {integrity: sha512-X/u0sI4QNFi/YUhcQwZ2hcmthgc3H3n4PdPoKMbAE/y+rUWOQCS9oc1wqCcUysBN5K0jHV7U+3QApdMFvwKvRQ==}engines: {node: '>=20.0.0'}hasBin: truerequiresBuild: true@@ -1779,8 +1782,8 @@ packages:hasBin: truedev: false- /@metaharness/[email protected]:- resolution: {integrity: sha512-LQElU6mUrWd3ffJ5bwoonEIgw7oFQZpwZaehffyl/Pg+iozpRjIBPEXdb4uTOBnKH+yPiTEWKc+h9AiZr9Os9w==}+ /@metaharness/[email protected]:+ resolution: {integrity: sha512-VOfjHM7AMWwDH41AAMHOHFbH1r898xJqhqyE3G/r8OAxxrMgujX2SZsYkj/eXfBEmoPMhDVRkuO2abxvzCgEUA==}engines: {node: '>=20.0.0'}peerDependencies:'@ruvector/tiny-dancer': ^0.1.21@@ -1789,6 +1792,13 @@ packages:optional: truedev: false+ /@metaharness/[email protected]:+ resolution: {integrity: sha512-A752c0eEYEVodBB8HLOaSvcUMA65TX6/Cru2apZ7EE7aL2FSO74GFbgFWPo85bgqgNuMjhHkl/kG+lkC0TunNA==}+ engines: {node: '>=20.0.0'}+ requiresBuild: true+ dev: false+ optional: true+/@metaharness/[email protected]:resolution: {integrity: sha512-GSg0APPAbRK93OzrzlE+R8hfEK+I5+Zhmh0Z28RC9Mk5/MjhPo3shqINO7ye8VPGYHIO4rars9FwCWbe/V4cEQ==}engines: {node: '>=20.0.0'}@@ -7501,8 +7511,6 @@ packages:peerDependencies:typescript: '>=5.0.0'peerDependenciesMeta:- agentic-flow:- optional: truetypescript:optional: truedependencies:@@ -12285,9 +12293,6 @@ packages:resolution: {integrity: sha512-GGIyOiFaG+TUra3JIfkI/zGP8yZYLPQ0pl1bH+ODjiX57sPhrLU5sQJn1y9bDKZUFYkX1crlrPfSYt0BKKdkog==}requiresBuild: true- peerDependenciesMeta:- node-gyp:- optional: truedependencies:bindings: 1.5.0node-addon-api: 7.1.1