Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

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.yml
index 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 Packages
runs-on: ubuntu-latest
diff --git a/package.json b/package.json
index 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.js
index 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 branding
import { 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_modules
function findCliPath() {
let dir = resolve(__dirname, '..');
diff --git a/ruflo/package.json b/ruflo/package.json
index 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.mjs
new file mode 100644
index 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.mjs
new file mode 100644
index 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.json
index 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",