π 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
// _redblue.mjs β invocation helper for `@metaharness/redblue`.
//
// Sibling of `_darwin.mjs` / `_harness.mjs`. Targets the `redblue` binary
// from the standalone `@metaharness/redblue@~0.1.4` package. Shared plumbing
// (degraded classification, versioned cache install, degraded emitter) lives
// in `_invoke.mjs`; what stays here is the genuinely-redblue part: the
// node-direct invocation rationale below.
//
// Subcommands surfaced (matches redblue 0.1.x):
// - `redblue init [--out redblue.yaml]`
// - `redblue run [--config redblue.yaml] [--tests N] [--patch] [--mock-judge] [--out report.json]`
// - `redblue attack <prompt|tools|data|all> [--count N]`
// - `redblue patch [--config redblue.yaml] [--mock-judge]`
// - `redblue report --in report.json`
//
// UPSTREAM BUG WORKAROUND
// -----------------------
// @metaharness/[email protected]'s CLI bootstrap is:
// const isMain = import.meta.url === `file://${process.argv[1]}`;
// if (isMain) { dispatch(...) }
// When npx links `redblue` β `dist/cli/index.js`, process.argv[1] is the
// symlink path but import.meta.url is the resolved real path, so the
// check fails silently β the binary exits 0 with no output, no file,
// no error. Darwin's CLI doesn't suffer this (calls main() unconditionally).
//
// Workaround: install the package once into a ruflo-owned cache dir
// (~/.ruflo/redblue-cache-<pin>, via _invoke.ensureCachedInstall) and invoke
// `node <abs_path>/dist/cli/index.js` directly. argv[1] then equals the real
// path and isMain becomes true.
//
// Track upstream fix at: github.com/ruvnet/agent-harness-generator/issues
// (file separately β when fixed, we could go back to a bin-shim pattern,
// though the node-direct cached path is now the family-wide standard anyway).
//
// INSTALLED COPY FIRST (#3366): an @metaharness/redblue already on disk that
// satisfies the pin (a ruflo 3.42.4 install carries 0.1.4, via metaharness /
// ruvector) is used before the cache install, same order as _harness.mjs /
// _darwin.mjs. Previously the first call always ran `npm install` into the
// cache even with that copy present.
// Whichever copy is chosen, its CLI path is realpath'd
// (_invoke.resolvePackageBin / realpathSync): a pnpm-symlinked package dir,
// or a cache base under a symlink such as macOS /tmp -> /private/tmp, would
// otherwise hit the same isMain mismatch described above.
//
// CONTRACT (matches runMetaharness/runDarwin):
// - returns `{ stdout, stderr, exitCode, durationMs, degraded, reason? }`
// - subprocess hard timeout (default 120s; --mock-judge runs are seconds)
// - on install failure / MODULE_NOT_FOUND / network failure, returns
// `degraded: true, reason: 'metaharness-redblue-not-available'`
// - never throws β ADR-150 graceful-degradation rule #3
//
// SAFETY NOTE
// redblue itself enforces hard safety boundaries in `src/config/safety.ts`
// (no real creds, no live targets, no shell, no eval, no arbitrary network).
// This wrapper does NOT relax those β it only forwards argv with shell:false.
// `--mock-judge` is the $0 CI path; the real model judge gates on
// $OPENROUTER_API_KEY. The wrapper never puts a key in argv. When that
// variable is unset but the plugin option `openrouterApiKey` (sensitive,
// ADR-506) is, the child gets it as OPENROUTER_API_KEY in its environment.
import { spawnSync } from 'node:child_process';
import { realpathSync } from 'node:fs';
import { homedir } from 'node:os';
import { join } from 'node:path';
import {
classifyDegraded,
ensureCachedInstall,
findLocalPackageDir,
makeDegradedEmitter,
resolvePackageBin,
} from './_invoke.mjs';
import { readSecret } from './_secret.mjs';
const DEFAULT_TIMEOUT_MS = 120_000;
// Pinned semver range. Bump in lock-step with optionalDependencies in
// @claude-flow/cli/package.json + ruflo/package.json.
const REDBLUE_PKG = '@metaharness/redblue';
const REDBLUE_PIN_VERSION = '~0.1.4';
const REDBLUE_PIN = `${REDBLUE_PKG}@${REDBLUE_PIN_VERSION}`;
const REASON_PREFIX = 'metaharness-redblue';
/** The child environment, with OPENROUTER_API_KEY filled from the plugin option when the variable is unset (ADR-506). */
export function judgeEnv(env) {
if (env.OPENROUTER_API_KEY) return env;
const key = readSecret('openrouterApiKey', [], env);
return key ? { ...env, OPENROUTER_API_KEY: key } : env;
}
// Cache dir is versioned by the pin so bumping REDBLUE_PIN_VERSION
// invalidates stale installs (handled inside ensureCachedInstall). The
// resolved layout matches the pre-consolidation helper so existing caches
// keep serving.
const CLI_REL_PATH = join('dist', 'cli', 'index.js');
/**
* Sync invocation. `redblue` runs are bounded by `max_cost_usd` and
* `max_runtime_minutes` from the config, so sync is fine for the CLI
* wrapper. The default --mock-judge fixture path completes in seconds.
*/
export function runRedblue(args, opts = {}) {
const start = Date.now();
const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
// 0. An installed copy satisfying the pin β free, no npm (#3366).
// fromCwd:false: the resolved bin is SPAWNED with argv that comes from
// MCP input, so only ruflo's own tree is searched, never the tool's cwd
// or its ancestors (see findLocalPackageDir in _invoke.mjs).
const localDir = findLocalPackageDir(REDBLUE_PKG, REDBLUE_PIN_VERSION, { fromCwd: false });
const localCli = localDir ? resolvePackageBin(localDir, 'redblue') : null;
// 1. Otherwise ensure redblue is installed in our cache dir (one-time install).
const install = localCli ? { ok: true, cliPath: localCli } : ensureCachedInstall({
pkg: REDBLUE_PKG,
pinVersion: REDBLUE_PIN_VERSION,
cliRelPath: CLI_REL_PATH,
});
if (!install.ok) {
return {
stdout: install.stdout ?? '',
stderr: install.stderr ?? install.error ?? '',
exitCode: 127,
durationMs: Date.now() - start,
degraded: true,
reason: install.reason === 'install-failed'
? `${REASON_PREFIX}-not-available`
: `${REASON_PREFIX}-${install.reason}`,
};
}
// 2. Invoke `<this node> <real-path-to-cli> <args>` so upstream's isMain
// check succeeds (argv[1] matches import.meta.url) β realpath'd, see
// header. process.execPath + shell:false, like _darwin/_harness: the
// argv carries MCP-supplied values (--config / --out / --in), and with
// shell:true on win32 Node hands cmd.exe one unquoted string, so a value
// such as `x.yaml & whoami` would run as a command (and a path with a
// space β `C:\Program Files\β¦` β would break). node needs no shell.
let cliPath = install.cliPath;
try { cliPath = realpathSync(cliPath); } catch { /* missing β node's MODULE_NOT_FOUND β degraded below */ }
const r = spawnSync(process.execPath, [cliPath, ...args], {
stdio: ['ignore', 'pipe', 'pipe'],
encoding: 'utf-8',
timeout: timeoutMs,
cwd: opts.cwd,
env: judgeEnv({ ...process.env, ...(opts.env || {}) }),
shell: false,
});
const durationMs = Date.now() - start;
const stdout = r.stdout || '';
const stderr = r.stderr || '';
const classified = classifyDegraded(stderr, r.status, REASON_PREFIX);
if (classified.degraded) {
return {
stdout, stderr,
exitCode: r.status ?? 127,
durationMs,
degraded: true,
reason: classified.reason,
};
}
return {
stdout, stderr,
exitCode: r.status ?? 0,
durationMs,
degraded: false,
};
}
/**
* Match the existing `emit*DegradedJsonAndExit` shape used by sibling
* scripts so MCP tool consumers see one contract. Exit 0 β ADR-150
* architectural constraint #3.
*/
export const emitRedblueDegradedJsonAndExit = makeDegradedEmitter(REDBLUE_PKG, REDBLUE_PIN_VERSION);
export const REDBLUE_VERSION_PIN = REDBLUE_PIN;
export const REDBLUE_CACHE_DIR = join(
homedir(), '.ruflo', `redblue-cache-${REDBLUE_PIN_VERSION.replace(/[~^]/g, '')}`,
);