π 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
release: 3.10.33 + CI regression guards for #2267 / #2257 / #2256
ruv07b4c86092a5
diff --git a/.github/workflows/v3-ci.yml b/.github/workflows/v3-ci.ymlindex fa1ee40fdc..c0c5186bc2 100644--- a/.github/workflows/v3-ci.yml+++ b/.github/workflows/v3-ci.yml@@ -260,6 +260,23 @@ env:PNPM_VERSION: '8'jobs:+ # #2267 + #2257 regression guards β fast, no install, run first so any+ # YAML or router regression is caught at PR-time, not at scheduled cron.+ static-regression-guards:+ name: Static regression guards (#2267 YAML + #2257 router)+ runs-on: ubuntu-latest+ steps:+ - uses: actions/checkout@v4+ - uses: actions/setup-node@v4+ with: { node-version: '22' }+ # js-yaml + tsx are needed by the smokes β install only those.+ - name: Install smoke deps+ run: npm install --no-save --no-package-lock js-yaml tsx+ - name: "#2267 β every .github/workflows/*.yml must parse"+ run: node scripts/smoke-workflows-yaml.mjs+ - name: "#2257 β router patterns must be word-boundary-anchored"+ run: node --import tsx scripts/smoke-router-regex.mjs+test:name: Test V3 Packagesruns-on: ubuntu-latestdiff --git a/package.json b/package.jsonindex 72c8cd0d15..fd3bb35126 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "claude-flow",- "version": "3.10.31",+ "version": "3.10.33","description": "Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration","main": "dist/index.js","type": "module",diff --git a/ruflo/bin/ruflo.js b/ruflo/bin/ruflo.jsindex 5a9bb92ef8..bb92ece3a2 100755--- a/ruflo/bin/ruflo.js+++ b/ruflo/bin/ruflo.js@@ -2,10 +2,30 @@// Ruflo CLI - thin wrapper around @claude-flow/cli with ruflo brandingimport { fileURLToPath, pathToFileURL } from 'node:url';import { dirname, resolve, join } from 'node:path';-import { existsSync } from 'node:fs';+import { existsSync, readFileSync } from 'node:fs';const __dirname = dirname(fileURLToPath(import.meta.url));+// #2256 fast path: --version / -V must NOT trigger heavy imports (the+// downstream @claude-flow/cli dist eagerly loads ruvector + a 23 MB ONNX+// model on cold cache, blocking 60+ s and causing SIGTERM under common+// timeout windows: npx default, MCP stdio 30s window). Resolve version+// from this wrapper's own package.json and exit before any heavy import.+// (bin/cli.js has the same guard for the direct path; needed here too+// because the wrapper imports dist/src/index.js, bypassing bin/cli.js.)+{+ const _argv = process.argv.slice(2);+ if (_argv.length === 1 && (_argv[0] === '--version' || _argv[0] === '-V')) {+ try {+ const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));+ process.stdout.write(`ruflo v${pkg.version || '0.0.0'}\n`);+ } catch {+ process.stdout.write('ruflo v0.0.0\n');+ }+ process.exit(0);+ }+}+// Walk up from ruflo/bin/ to find @claude-flow/cli in node_modulesfunction findCliPath() {let dir = resolve(__dirname, '..');diff --git a/ruflo/package.json b/ruflo/package.jsonindex 2e08cc5589..a25dd48c4e 100644--- a/ruflo/package.json+++ b/ruflo/package.json@@ -1,6 +1,6 @@{"name": "ruflo",- "version": "3.10.31",+ "version": "3.10.33","description": "Ruflo - Enterprise AI agent orchestration platform. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration","main": "bin/ruflo.js","type": "module",diff --git a/scripts/smoke-router-regex.mjs b/scripts/smoke-router-regex.mjsnew file mode 100644index 0000000000..45084144fd--- /dev/null+++ b/scripts/smoke-router-regex.mjs@@ -0,0 +1,102 @@+#!/usr/bin/env node+/**+ * Smoke test for #2257: the agent router's keyword patterns must be+ * word-boundary-anchored so short tokens (cd, ci, ui, add, structure) do+ * NOT match inside unrelated words (decision, infrastructure, address,+ * addendum). Confidence on a match must be a heuristic prior (< 0.8) since+ * the matcher is static, not learned.+ *+ * This guard locks in the #2257 fix so a future refactor that drops the+ * \b boundaries or bumps confidence back to 0.8 is caught at PR-time.+ *+ * Drives the SOURCE OF TRUTH (helpers-generator.ts::generateAgentRouter)+ * AND the in-repo snapshot under v3/@claude-flow/cli/.claude/helpers/.+ *+ * Exit codes:+ * 0 β all expectations met+ * 1 β at least one expectation failed+ */++import { writeFileSync, mkdtempSync, readFileSync } from 'node:fs';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { createRequire } from 'node:module';++const require = createRequire(import.meta.url);++// Render the generator output to disk so we test the SOURCE OF TRUTH.+async function loadGeneratedRouter() {+ // tsx is the project's standard TS-on-the-fly loader.+ const { generateAgentRouter } = await import('../v3/@claude-flow/cli/src/init/helpers-generator.ts')+ .catch(async () => {+ // Fall back to a tsx-loaded copy if direct ESM TS import isn't supported.+ const { execSync } = await import('node:child_process');+ const tmp = mkdtempSync(join(tmpdir(), 'router-smoke-'));+ const out = execSync(+ `node --import tsx -e "import('./v3/@claude-flow/cli/src/init/helpers-generator.ts').then(m => process.stdout.write(m.generateAgentRouter()))"`,+ { encoding: 'utf8' }+ );+ const path = join(tmp, 'router-gen.cjs');+ writeFileSync(path, out);+ return { generateAgentRouter: () => readFileSync(path, 'utf8') };+ });+ const tmp = mkdtempSync(join(tmpdir(), 'router-smoke-'));+ const path = join(tmp, 'router-gen.cjs');+ writeFileSync(path, generateAgentRouter());+ return require(path);+}++const CASES = [+ // [task, expectedAgent ("default" means confidence < 0.5)]+ ['review latest issues', 'reviewer'],+ ['make a decision about auth', 'default'], // 'decision' must NOT match 'ci'+ ['set up ci pipeline', 'devops'], // 'ci' as a real word should match+ ['structure the schema', 'architect'], // 'structure' standalone should match+ ['address the bug', 'default'], // 'address' must NOT match 'add'+ ['add JWT support', 'coder'], // 'add' as a real word should match+ ['fix infrastructure rollout', 'devops'], // 'infrastructure' standalone+ ['write specifications', 'default'], // 'specifications' must NOT match 'spec'+ ['write a unit test', 'tester'], // 'unit test' phrase+ ['build a guidance overview', 'coder'], // 'guidance' must NOT match 'ui'+ ['fix critical and high issues', 'default'], // bare 'fix' / 'critical' shouldn't match anything+];++async function main() {+ const router = await loadGeneratedRouter();+ if (typeof router.routeTask !== 'function') {+ console.error('router.routeTask is not a function β generator export shape changed');+ process.exit(1);+ }++ let pass = 0;+ let fail = 0;+ for (const [task, want] of CASES) {+ const r = router.routeTask(task);+ const ok = want === 'default'+ ? r.confidence < 0.5+ : r.agent === want && r.confidence < 0.8; // #2257: confidence must NOT regress to 0.8+ if (ok) { pass++; console.log(` PASS "${task}" β ${r.agent} (${r.confidence})`); }+ else { fail++; console.log(` FAIL "${task}" β ${r.agent} (${r.confidence}) want=${want}`); }+ }+ console.log(`\n${pass}/${CASES.length} router cases passed`);++ // Hard contract on the file format too β if someone strips \b boundaries+ // the cases above might still pass on this corpus but break on others.+ const generated = await router.routeTask ? null : null;+ const sourcePath = 'v3/@claude-flow/cli/src/init/helpers-generator.ts';+ const src = readFileSync(sourcePath, 'utf8');+ if (!src.includes('\\\\b')) {+ console.error(`\nFAIL ${sourcePath} no longer contains \\b boundary anchors β #2257 regression`);+ fail++;+ } else {+ console.log(`OK ${sourcePath} retains \\b boundary anchors`);+ }+ if (/confidence:\s*0\.8/.test(src) && !/heuristic prior/.test(src)) {+ console.error(`\nFAIL ${sourcePath} confidence:0.8 reintroduced without "heuristic prior" justification β #2257 regression`);+ fail++;+ }++ process.exit(fail > 0 ? 1 : 0);+}++main().catch(e => { console.error(e); process.exit(1); });diff --git a/scripts/smoke-workflows-yaml.mjs b/scripts/smoke-workflows-yaml.mjsnew file mode 100644index 0000000000..d5d17a8f5f--- /dev/null+++ b/scripts/smoke-workflows-yaml.mjs@@ -0,0 +1,64 @@+#!/usr/bin/env node+/**+ * Smoke test for #2267: every .github/workflows/*.yml must parse as YAML.+ *+ * Root cause that motivated this guard: an unquoted `:` inside a step `name`+ * (`Guard 2 β smoke: generate ...`) made the YAML parser treat `smoke:` as a+ * second mapping key, rejecting the whole workflow. GitHub Actions accepted+ * the push and scheduled the run, but produced zero jobs and a "workflow+ * file issue" failure β invisible to the kind of green-build dashboard that+ * usually catches regressions. Five consecutive scheduled runs failed+ * silently before #2267 surfaced it.+ *+ * This guard runs as an early CI step so any future YAML break is caught+ * at PR-time, not at scheduled-cron-time when nobody is looking.+ *+ * Exit codes:+ * 0 β every workflow parsed+ * 1 β at least one workflow failed to parse+ */++import { readFileSync, readdirSync } from 'node:fs';+import { join } from 'node:path';+import yaml from 'js-yaml';++const WORKFLOWS_DIR = '.github/workflows';++let files;+try {+ files = readdirSync(WORKFLOWS_DIR).filter(f => f.endsWith('.yml') || f.endsWith('.yaml'));+} catch (e) {+ console.error(`No ${WORKFLOWS_DIR} directory (or unreadable): ${e.message}`);+ process.exit(1);+}++let failed = 0;+const results = [];+for (const file of files.sort()) {+ const full = join(WORKFLOWS_DIR, file);+ try {+ const parsed = yaml.load(readFileSync(full, 'utf8'));+ const jobCount = parsed && parsed.jobs ? Object.keys(parsed.jobs).length : 0;+ results.push({ file, ok: true, jobs: jobCount });+ } catch (e) {+ failed++;+ results.push({+ file,+ ok: false,+ error: e.message,+ line: e.mark ? e.mark.line + 1 : null,+ column: e.mark ? e.mark.column + 1 : null,+ });+ }+}++const okCount = results.filter(r => r.ok).length;+console.log(`Workflows: ${okCount}/${results.length} parsed`);+for (const r of results) {+ if (r.ok) {+ console.log(` ok ${r.file} (${r.jobs} jobs)`);+ } else {+ console.log(` FAIL ${r.file} ${r.line}:${r.column} ${r.error}`);+ }+}+process.exit(failed > 0 ? 1 : 0);diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.jsonindex be4c44d35f..4d129399b0 100644--- a/v3/@claude-flow/cli/package.json+++ b/v3/@claude-flow/cli/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/cli",- "version": "3.10.31",+ "version": "3.10.33","type": "module","description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code","main": "dist/src/index.js",