π 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
fix: tracker-sweep 2026-07-26 (v3.32.10) β 9 bugs + promo seed + follow-ups (#2788)
rUv810b13dcd6cc
diff --git a/.claude/helpers/statusline.cjs b/.claude/helpers/statusline.cjsindex 1be517a685..e4eb67dd40 100755--- a/.claude/helpers/statusline.cjs+++ b/.claude/helpers/statusline.cjs@@ -1,1060 +1,1215 @@-#!/usr/bin/env node-/**- * RuFlo V3 Statusline β delegation build (#2195)- *- * Fix for ruvnet/ruflo#2195: the previous version re-implemented all data- * readers locally using fragile file probes that missed AgentDB patterns,- * the v3/docs/adr/ ADR directory, and the real vector count.- *- * This version delegates to 'npx @claude-flow/cli hooks statusline --json'- * as the single source of truth. That command queries AgentDB directly,- * counts ADRs in both directories, and reports the real intelligence pct.- *- * ADR counting falls back to local file reads so the display still works- * without network access (counts both v3/docs/adr/ and v3/implementation/adrs/).- *- * Cache: JSON result is cached in /tmp for 10s so rapid prompt triggers- * (every keystroke in some shells) don't hammer the CLI on every call.- *- * Usage: node statusline.cjs [--json] [--compact] [--dashboard]- */--/* eslint-disable @typescript-eslint/no-var-requires */-const fs = require('fs');-const path = require('path');-const { execSync } = require('child_process');-const os = require('os');--// Configuration-const CONFIG = {- maxAgents: 15,- // Header identity defaults to project/repository name. Set `author` to- // retain the previous `git config user.name` display (#2682).- identityMode: (process.env.RUFLO_STATUSLINE_IDENTITY || 'project').toLowerCase(),- // Session-cost display. Claude Code's cost.total_cost_usd is a client-side- // estimate that "may differ from your actual bill" and reads as misleading on- // subscription plans, where token usage is not billed per dollar. These let- // each user pick what the segment means to them without changing the default.- // RUFLO_STATUSLINE_COST_SYMBOL override the leading '$' (e.g. β‘, β¬, π±);- // set to an empty string for the number alone.- // RUFLO_STATUSLINE_HIDE_COST 1/true/yes/on removes the segment entirely.- costSymbol: process.env.RUFLO_STATUSLINE_COST_SYMBOL ?? '$',- hideCost: /^(1|true|yes|on)$/i.test(process.env.RUFLO_STATUSLINE_HIDE_COST || ''),-};--const CWD = process.cwd();--// βββ Delegation cache βββββββββββββββββββββββββββββββββββββββββββ-// Cache the CLI JSON result so rapid prompt re-renders (Claude Code-// refreshes the statusline several times a second while streaming) don't-// re-invoke the CLI each time.-// #2337 bumped 10s β 60s.-// Followup for anthropics/claude-code#70200 (Windows console-flash bug β-// claude.exe spawns hook/statusline subprocesses without CREATE_NO_WINDOW,-// producing a visible cmd flash on every render): bumped 60s β 300s to-// reduce the flash rate 5x on Windows until the upstream fix ships.-// Tradeoff: stat/git counters update every 5min instead of every 1min;-// promo/insight row still rotates on its own tighter 20s promoFresh clock.-const CACHE_FILE = path.join(os.tmpdir(), 'ruflo-statusline-cache-' + require('crypto').createHash('md5').update(CWD).digest('hex').slice(0, 8) + '.json');-const CACHE_TTL_MS = 300000;--// The promo/insight row is designed to rotate on a 20s cadence (funnel/-// rotation.ts's ROTATION_SLOT_MS / funnel/promo.ts's insight-slot check β-// duplicated here as a bare number since this generated script has no-// runtime import of the funnel module; keep in sync if that constant ever-// changes). The rotation slot is only ever (re)computed SERVER-SIDE inside-// the CLI subprocess this file shells out to β so a general 60s data cache-// (correct and necessary for #2337) silently made that 20s design-// unreachable: cache.fresh stayed true across 2-3 whole rotation slots,-// so the row visibly "didn't rotate" (user report). Fix: track promo-// freshness on its OWN, tighter clock β when it lags behind the current-// slot, fall through to a real CLI call even though the REST of the-// cached data (security/swarm/system) is still within CACHE_TTL_MS. This-// does not touch or regress #2337's fix; it only adds a narrower check.-const PROMO_ROTATION_SLOT_MS = 20000;--// Persistent last-known-good promo record. Lives outside the /tmp cache so it-// survives a full cache wipe / cache write race / CLI failure combo. Written-// every time we successfully render a promo; read as a last resort so the row-// never blinks out mid-session (was: 'promo shows then hides' bug report).-const PROMO_MEMO_FILE = path.join(os.homedir(), '.ruflo', 'statusline-promo.json');-const PROMO_MEMO_TTL_MS = 6 * 60 * 60 * 1000; // 6h β long enough to bridge any hiccup, short enough that a real disable takes effect fast.--// #2337: resolve an already-installed @claude-flow/cli (or ruflo) bin so we-// can invoke it directly via `node`. The previous version called-// `npx --yes @claude-flow/cli@latest` on every uncached render, which forces-// a registry resolution + cold-start of the entire CLI per render. With-// multiple concurrent Claude Code sessions this storms the host (reporter-// saw load average 40-65 on a 12-core box).-//-// Returns EVERY existing bin/cli.js candidate, in preference order (project,-// monorepo, plugin marketplace, global node_modules including custom-prefix-// layouts like ~/.npm-global) β mirrors getPkgVersion()'s own path probing.-//-// Returns a list, not a single winner: `fs.existsSync` only proves a file is-// present, not that it actually runs. A marketplace/npx-cached install can-// exist on disk but be broken (observed in practice: a stale marketplace-// checkout whose dist/ imports a workspace package, '@claude-flow/cli-core',-// that isn't bundled there β every invocation throws ERR_MODULE_NOT_FOUND).-// Picking the first EXISTING path and never falling through meant a single-// broken install silently killed the promo row for the entire session (the-// CLI call always failed, so the memo could never refresh and eventually-// expired). getStatuslineData() now walks this whole list and tries the next-// candidate on failure, so one broken install can't permanently wedge it.-function resolveCliBinCandidates() {- const candidates = [];- try {- const home = os.homedir();- candidates.push(- path.join(home, '.claude', 'plugins', 'marketplaces', 'ruflo', 'bin', 'cli.js'),- path.join(CWD, 'node_modules', '@claude-flow', 'cli', 'bin', 'cli.js'),- path.join(CWD, 'node_modules', 'ruflo', 'bin', 'cli.js'),- path.join(CWD, 'v3', '@claude-flow', 'cli', 'bin', 'cli.js'),- );- try {- const binDir = path.dirname(process.execPath);- const globalModuleDirs = [path.join(binDir, '..', 'lib', 'node_modules'), path.join(binDir, 'node_modules')];- for (const prefix of [process.env.npm_config_prefix, process.env.PREFIX, path.join(home, '.npm-global')]) {- if (prefix) globalModuleDirs.push(path.join(prefix, 'lib', 'node_modules'));- }- for (const gm of globalModuleDirs) {- candidates.push(- path.join(gm, 'ruflo', 'bin', 'cli.js'),- path.join(gm, '@claude-flow', 'cli', 'bin', 'cli.js'),- );- }- } catch { /* ignore */ }- } catch { /* ignore */ }- return candidates.filter((p) => {- try {- if (!fs.existsSync(p)) return false;- // A candidate's bin/cli.js can exist on disk while its compiled- // dist/ never got built (Claude Code's own plugin marketplace just- // git-clones the repo β no install/build step β so every marketplace- // install is a source-only checkout by construction). Importing- // dist/src/index.js from bin/cli.js then throws MODULE_NOT_FOUND on- // every real command; only --version happens to survive it. Check- // for the compiled entrypoint too so a doomed candidate is skipped- // up front instead of wasting a spawn-and-fail on every render.- return fs.existsSync(path.join(path.dirname(p), '..', 'dist', 'src', 'index.js'));- } catch { return false; }- });-}--// Return { fresh, promoFresh, data }. 'fresh' is true only if within the TTL-// β but data is returned regardless (stale-while-revalidate). This lets us-// serve last known state (specifically the promo row) when the CLI is-// slow/unavailable, so users don't see the funnel row flicker in and out on-// cache expiry. 'promoFresh' is a SEPARATE, tighter check on the same clock-// as PROMO_ROTATION_SLOT_MS β see that constant's comment for why the promo-// row needs its own freshness bound distinct from the general 60s TTL.-function readCache() {- try {- if (fs.existsSync(CACHE_FILE)) {- const raw = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf-8'));- if (raw && raw._ts && raw.data) {- const age = Date.now() - raw._ts;- return { fresh: age < CACHE_TTL_MS, promoFresh: age < PROMO_ROTATION_SLOT_MS, data: raw.data };- }- }- } catch { /* ignore */ }- return { fresh: false, promoFresh: false, data: null };-}--function writeCache(data) {- try { fs.writeFileSync(CACHE_FILE, JSON.stringify({ _ts: Date.now(), data }), 'utf-8'); } catch { /* ignore */ }- // Also memoize any promo we saw so the row can survive future CLI hiccups.- try {- if (data && data.promo && typeof data.promo === 'object') {- fs.mkdirSync(path.dirname(PROMO_MEMO_FILE), { recursive: true, mode: 0o700 });- fs.writeFileSync(PROMO_MEMO_FILE, JSON.stringify({ _ts: Date.now(), promo: data.promo }), { encoding: 'utf-8', mode: 0o600 });- }- } catch { /* ignore */ }-}--// Last resort: read a memoized promo (up to 6h old). Used when no cache and-// no CLI response is available β the row still renders, so users don't see-// the disclosure blink out. Returns null when the memo is absent, expired,-// or malformed. Never throws.-function readPromoMemo() {- try {- if (!fs.existsSync(PROMO_MEMO_FILE)) return null;- const raw = JSON.parse(fs.readFileSync(PROMO_MEMO_FILE, 'utf-8'));- if (raw && raw._ts && (Date.now() - raw._ts) < PROMO_MEMO_TTL_MS && raw.promo) {- return raw.promo;- }- } catch { /* ignore */ }- return null;-}--/**- * Single source of truth: delegate to the CLI hooks statusline --json command.- * Falls back to a minimal static object on failure so the statusline still renders.- *- * Fix for ruflo#2195: the previous local readers returned 0 for AgentDB patterns- * (missed the .swarm/memory.db β AgentDB path), computed dddProgress wrong,- * and only counted ADRs in v3/implementation/adrs/ (missed v3/docs/adr/).- */-// Overlay the memoized promo onto any data object that's missing one. This is-// the safety net that keeps the funnel row rendered when an OLDER cached CLI-// version is picked up by npx β that older CLI succeeds but omits promo, so-// the JSON round-trips clean but without our row. We patch it back here.-function overlayMemoPromo(data) {- if (data && !data.promo) {- const memoPromo = readPromoMemo();- if (memoPromo) data.promo = memoPromo;- }- return data;-}--function getStatuslineData() {- const cache = readCache();- // Both clocks must be satisfied to skip the CLI call entirely: the general- // 60s TTL (#2337 β don't re-spawn the CLI on every rapid re-render) AND the- // tighter promo-rotation clock (this fix β don't let a still-fresh 60s- // cache silently freeze the promo/insight row across multiple 20s slots).- if (cache.fresh && cache.promoFresh) {- return applyLocalOverlays(overlayMemoPromo(cache.data));- }-- // #2337: prefer an already-installed CLI bin via direct `node` invocation β- // no npx, no registry round-trip, no @latest re-resolve per render. Try- // every candidate that actually EXISTS (not just the first) before falling- // back to `npx --prefer-offline @claude-flow/cli` (no @latest); an existing- // but broken install (e.g. a stale marketplace checkout missing a bundled- // workspace dep) must not block trying the next one.- //- // No `2>/dev/null` here (deliberately) β the execSync call below already- // sets stdio: ['pipe','pipe','pipe'], which captures/discards stderr at the- // Node level regardless of shell. The redirect was redundant on POSIX and- // actively broke every candidate on Windows: cmd.exe (execSync's default- // shell there) doesn't understand /dev/null, so the CLI delegation always- // failed, silently degrading every render to buildLocalFallback() β 0%- // intelligence and an empty promo row (the memo cache that keeps the row- // populated across CLI hiccups is only ever written from a SUCCESSFUL- // delegation, so it could never get seeded on Windows either).- const cmds = resolveCliBinCandidates()- .map((bin) => '"' + process.execPath + '" "' + bin + '" hooks statusline --json')- .concat(['npx --prefer-offline @claude-flow/cli hooks statusline --json']);- for (const cmd of cmds) {- try {- const raw = execSync(- cmd,- { encoding: 'utf-8', timeout: 8000, stdio: ['pipe', 'pipe', 'pipe'], cwd: CWD, windowsHide: true }- ).trim();- // The CLI may emit preamble lines before the JSON β find the first '{'.- const jsonStart = raw.indexOf('{');- if (jsonStart === -1) throw new Error('no JSON in CLI output');- const data = JSON.parse(raw.slice(jsonStart));- // Overlay every block the CLI JSON omits (adrs/agentdb/tests/hooks/integration)- // with real local reads, so those segments reflect actual state instead of 0.- applyLocalOverlays(data);- overlayMemoPromo(data);- writeCache(data);- return data;- } catch { /* this candidate unavailable, broken, or timed out β try the next */ }- }-- // Stale-while-revalidate: if we have any cached data, keep serving it so the- // funnel row doesn't flicker on CLI hiccups. Overlay fresh local reads for- // the segments the CLI JSON doesn't populate; the promo row survives.- if (cache.data) {- applyLocalOverlays(cache.data);- overlayMemoPromo(cache.data);- return cache.data;- }-- // Last resort: local probes + memo. Users still see the funnel row.- return overlayMemoPromo(buildLocalFallback());-}--// Count ADRs from BOTH known directories (fix for ruflo#2195: old code missed-// v3/docs/adr/ which holds ADR-088..ADR-137, i.e. 41 of the 128 total ADRs).-function getLocalADRCount() {- const adrDirs = [- path.join(CWD, 'v3', 'implementation', 'adrs'),- path.join(CWD, 'v3', 'docs', 'adr'),- path.join(CWD, 'docs', 'adrs'),- path.join(CWD, '.claude-flow', 'adrs'),- ];- let total = 0;- for (const dir of adrDirs) {- try {- if (fs.existsSync(dir)) {- const files = fs.readdirSync(dir).filter(function(f) {- return f.endsWith('.md') && (f.startsWith('ADR-') || f.startsWith('adr-') || /^\d{4}-/.test(f));- });- total += files.length;- }- } catch { /* ignore */ }- }- return { count: total, implemented: total, compliance: 0 };-}--// βββ Local overlays for segments the CLI JSON omits ββββββββββββββ-// 'hooks statusline --json' only returns user/v3Progress/security/swarm/system.-// agentdb/tests/hooks/integration are never populated, so without these overlays-// they render as a permanent 0. Each reader is cheap and degrades to zeros.--// Real AgentDB stats from the local memory DB. Vectors live in .swarm/memory.db-// (sql.js + HNSW); ruvector.db is an opaque redb store counted only toward size.-// One read-only sqlite3 query (mode=ro never takes a write lock the daemon owns).-function getLocalAgentDB() {- const result = { vectorCount: 0, dbSizeKB: 0, hasHnsw: false };- try {- let bytes = 0;- for (const f of ['.swarm/memory.db', 'ruvector.db']) {- try { bytes += fs.statSync(path.join(CWD, f)).size; } catch { /* missing */ }- }- result.dbSizeKB = Math.round(bytes / 1024);-- const memDb = path.join(CWD, '.swarm', 'memory.db');- if (fs.existsSync(memDb)) {- const Q = String.fromCharCode(34);- // Two INDEPENDENT statements -- do NOT combine into one. Coupling the- // vector count with the vector_indexes row count in a single statement- // meant that on a DB missing the vector_indexes table (older/agentdb-- // written DBs), the whole statement failed at PREPARE time (SQLite- // compiles the full SQL before running), so the valid memory_entries- // count was discarded too and the statusline showed Vectors 0 despite- // thousands of real vectors. Split so a missing table can only zero the- // HNSW flag, never the count. The init self-heal provisions the table so- // the flag recovers on the next ruflo init / MCP start.- const countSql = Q + 'SELECT COUNT(*) FROM memory_entries WHERE embedding IS NOT NULL;' + Q;- const vc = safeExec("sqlite3 'file:" + memDb + "?mode=ro' " + countSql, 1500);- if (vc) result.vectorCount = parseInt(vc, 10) || 0;- // HNSW flag: separate statement. If vector_indexes is absent, sqlite3- // exits non-zero and safeExec returns empty -- hasHnsw stays false (exact- // original semantics: at least one index-config row present).- const hnswSql = Q + 'SELECT COUNT(*) FROM vector_indexes;' + Q;- const hn = safeExec("sqlite3 'file:" + memDb + "?mode=ro' " + hnswSql, 1500);- if (hn) result.hasHnsw = (parseInt(hn, 10) || 0) > 0;- }- } catch { /* ignore */ }- return result;-}--// Count test files via a bounded directory walk (no file reads).-function getLocalTests() {- let testFiles = 0;- function countTests(dir, depth) {- if ((depth || 0) > 4) return;- try {- if (!fs.existsSync(dir)) return;- for (const e of fs.readdirSync(dir, { withFileTypes: true })) {- if (e.isDirectory() && !e.name.startsWith('.') && e.name !== 'node_modules') {- countTests(path.join(dir, e.name), (depth || 0) + 1);- } else if (e.isFile() && (e.name.includes('.test.') || e.name.includes('.spec.') || e.name.startsWith('test_') || e.name.startsWith('spec_'))) {- testFiles++;- }- }- } catch { /* ignore */ }- }- for (const d of ['tests', 'test', '__tests__', 'src', 'v3']) countTests(path.join(CWD, d));- return { testFiles, testCases: testFiles * 4 };-}--// Count configured hooks from project .claude/settings.json. Claude Code hooks-// have no enabled/disabled flag, so every configured hook counts as enabled.-function getLocalHooks() {- const result = { enabled: 0, total: 0 };- try {- const settings = readJSON(path.join(CWD, '.claude', 'settings.json'));- const hooks = settings && settings.hooks;- if (hooks && typeof hooks === 'object') {- let n = 0;- for (const ev of Object.keys(hooks)) {- const groups = hooks[ev];- if (Array.isArray(groups)) {- for (const g of groups) {- if (g && Array.isArray(g.hooks)) n += g.hooks.length;- }- }- }- result.total = n;- result.enabled = n;- }- } catch { /* ignore */ }- return result;-}--// Best-effort integration block: DB presence + locally-configured stdio MCP-// servers (project .mcp.json + global ~/.claude.json). Remote connectors are-// account-managed and not present in local config, so they are not counted.-function getLocalIntegration() {- const integration = { mcpServers: { enabled: 0, total: 0 }, hasDatabase: false };- try {- for (const f of ['.swarm/memory.db', 'ruvector.db']) {- if (fs.existsSync(path.join(CWD, f))) { integration.hasDatabase = true; break; }- }- const names = new Set();- const projMcp = readJSON(path.join(CWD, '.mcp.json'));- if (projMcp && projMcp.mcpServers) for (const k of Object.keys(projMcp.mcpServers)) names.add(k);- const claudeJson = readJSON(path.join(os.homedir(), '.claude.json'));- if (claudeJson) {- if (claudeJson.mcpServers) for (const k of Object.keys(claudeJson.mcpServers)) names.add(k);- const proj = claudeJson.projects && claudeJson.projects[CWD];- if (proj && proj.mcpServers && !Array.isArray(proj.mcpServers)) {- for (const k of Object.keys(proj.mcpServers)) names.add(k);- }- }- integration.mcpServers.total = names.size;- integration.mcpServers.enabled = names.size;- } catch { /* ignore */ }- return integration;-}--// Overlay every locally-derived block onto the CLI data (mutates in place).-function applyLocalOverlays(data) {- data.adrs = getLocalADRCount();- data.agentdb = getLocalAgentDB();- data.tests = getLocalTests();- data.hooks = getLocalHooks();- data.integration = getLocalIntegration();- return data;-}--// Minimal local fallback when the CLI is not installed or times out.-// Returns a structure that matches the CLI JSON schema so the renderer works.-function buildLocalFallback() {- const memMB = Math.floor(process.memoryUsage().heapUsed / 1024 / 1024);-- return applyLocalOverlays({- user: { name: 'user', gitBranch: '', modelName: 'Claude Code' },- v3Progress: { domainsCompleted: 0, totalDomains: 5, dddProgress: 0, patternsLearned: 0, sessionsCompleted: 0 },- security: { status: 'NONE', findings: 0, cvesFixed: 0, totalCves: 0 },- swarm: { activeAgents: 0, maxAgents: CONFIG.maxAgents, coordinationActive: false },- system: { memoryMB: memMB, contextPct: 0, intelligencePct: 0, subAgents: 0 },- lastUpdated: new Date().toISOString(),- });-}--// ANSI colors-const c = {- reset: '\x1b[0m',- bold: '\x1b[1m',- dim: '\x1b[2m',- red: '\x1b[0;31m',- green: '\x1b[0;32m',- yellow: '\x1b[0;33m',- blue: '\x1b[0;34m',- purple: '\x1b[0;35m',- cyan: '\x1b[0;36m',- brightRed: '\x1b[1;31m',- brightGreen: '\x1b[1;32m',- brightYellow: '\x1b[1;33m',- brightBlue: '\x1b[1;34m',- brightPurple: '\x1b[1;35m',- brightCyan: '\x1b[1;36m',- brightWhite: '\x1b[1;37m',-};--// Safe execSync with strict timeout (returns empty string on failure)-function safeExec(cmd, timeoutMs) {- try {- return execSync(cmd, {- encoding: 'utf-8',- timeout: timeoutMs || 2000,- stdio: ['pipe', 'pipe', 'pipe'],- // Windows: without this, every execSync spawns cmd.exe /d /s /c which- // flashes a visible console window every render (~1/min via the 60s- // cache TTL). windowsHide runs the child in a hidden window instead.- // No-op on POSIX. Fix for #2XXX (user report: "cmd prompt keeps opening").- windowsHide: true,- }).trim();- } catch {- return '';- }-}--// Safe JSON file reader (returns null on failure)-function readJSON(filePath) {- try {- if (fs.existsSync(filePath)) {- return JSON.parse(fs.readFileSync(filePath, 'utf-8'));- }- } catch { /* ignore */ }- return null;-}--// βββ Git info (pure-Node / single exec β needed for branch display) ββββββββββ--function getGitInfo() {- const result = {- name: path.basename(CWD) || 'project', gitBranch: '', modified: 0, untracked: 0,- staged: 0, ahead: 0, behind: 0,- };-- const script = [- 'git rev-parse --show-toplevel 2>/dev/null || pwd',- 'echo "---SEP---"',- 'git config user.name 2>/dev/null || echo user',- 'echo "---SEP---"',- 'git branch --show-current 2>/dev/null',- 'echo "---SEP---"',- 'git status --porcelain 2>/dev/null',- 'echo "---SEP---"',- 'git rev-list --left-right --count HEAD...@{upstream} 2>/dev/null || echo "0 0"',- ].join('; ');-- const raw = safeExec("sh -c '" + script + "'", 3000);- if (!raw) return result;-- const parts = raw.split('---SEP---').map(function(s) { return s.trim(); });- if (parts.length >= 5) {- const projectName = path.basename(parts[0] || CWD) || path.basename(CWD) || 'project';- const authorName = parts[1] || 'user';- result.name = CONFIG.identityMode === 'author' ? authorName : projectName;- result.gitBranch = parts[2] || '';-- if (parts[3]) {- for (const line of parts[3].split('\n')) {- if (!line || line.length < 2) continue;- const x = line[0], y = line[1];- if (x === '?' && y === '?') { result.untracked++; continue; }- if (x !== ' ' && x !== '?') result.staged++;- if (y !== ' ' && y !== '?') result.modified++;- }- }-- const ab = (parts[4] || '0 0').split(/\s+/);- result.ahead = parseInt(ab[0]) || 0;- result.behind = parseInt(ab[1]) || 0;- }-- return result;-}--// Detect model name from Claude config (pure file reads, no exec)-function getModelName() {- try {- const claudeConfig = readJSON(path.join(os.homedir(), '.claude.json'));- if (claudeConfig && claudeConfig.projects) {- for (const [projectPath, projectConfig] of Object.entries(claudeConfig.projects)) {- if (CWD === projectPath || CWD.startsWith(projectPath + '/')) {- const usage = projectConfig.lastModelUsage;- if (usage) {- const ids = Object.keys(usage);- if (ids.length > 0) {- let modelId = ids[ids.length - 1];- let latest = 0;- for (const id of ids) {- const ts = usage[id] && usage[id].lastUsedAt ? new Date(usage[id].lastUsedAt).getTime() : 0;- if (ts > latest) { latest = ts; modelId = id; }- }- if (modelId.includes('opus')) return 'Opus 4.8';- if (modelId.includes('sonnet')) return 'Sonnet 4.6';- if (modelId.includes('haiku')) return 'Haiku 4.5';- return modelId.split('-').slice(1, 3).join(' ');- }- }- break;- }- }- }- } catch { /* ignore */ }-- // Fallback: settings.json model field- const settings = getSettings();- if (settings && settings.model) {- const m = settings.model;- if (m.includes('opus')) return 'Opus 4.8';- if (m.includes('sonnet')) return 'Sonnet 4.6';- if (m.includes('haiku')) return 'Haiku 4.5';- }- return 'Claude Code';-}--// βββ Stdin reader (Claude Code pipes session JSON) ββββββββββββββ-// Claude Code sends session JSON via stdin. Read synchronously so the-// script works both when invoked by Claude Code (stdin has JSON) and-// when run manually from terminal (stdin is empty/tty).-let _stdinData = null;-function getStdinData() {- if (_stdinData !== undefined && _stdinData !== null) return _stdinData;- try {- if (process.stdin.isTTY) { _stdinData = null; return null; }- const chunks = [];- const buf = Buffer.alloc(4096);- let bytesRead;- try {- while ((bytesRead = fs.readSync(0, buf, 0, buf.length, null)) > 0) {- chunks.push(buf.slice(0, bytesRead));- }- } catch { /* EOF or read error */ }- const raw = Buffer.concat(chunks).toString('utf-8').trim();- _stdinData = (raw && raw.startsWith('{')) ? JSON.parse(raw) : null;- } catch {- _stdinData = null;- }- return _stdinData;-}--function getModelFromStdin() {- const data = getStdinData();- return (data && data.model && data.model.display_name) ? data.model.display_name : null;-}--function getContextFromStdin() {- const data = getStdinData();- if (data && data.context_window) {- return { usedPct: Math.floor(data.context_window.used_percentage || 0) };- }- return null;-}--function getCostFromStdin() {- const data = getStdinData();- if (data && data.cost) {- const durationMs = data.cost.total_duration_ms || 0;- const mins = Math.floor(durationMs / 60000);- const secs = Math.floor((durationMs % 60000) / 1000);- return {- costUsd: data.cost.total_cost_usd || 0,- duration: mins > 0 ? mins + 'm' + secs + 's' : secs + 's',- };- }- return null;-}--// Compares dotted-numeric version strings (e.g. "3.27.1" vs "3.27.10").-// Returns >0 if a>b, <0 if a<b, 0 if equal-as-far-as-parseable. Deliberately-// simple (no prerelease/build-metadata handling) β this only orders local-// package.json versions against each other, never anything untrusted from-// a payload, so a full semver implementation would be dead weight here.-function compareVersions(a, b) {- const pa = String(a).split('.').map((n) => parseInt(n, 10));- const pb = String(b).split('.').map((n) => parseInt(n, 10));- for (let i = 0; i < Math.max(pa.length, pb.length); i++) {- const na = Number.isFinite(pa[i]) ? pa[i] : 0;- const nb = Number.isFinite(pb[i]) ? pb[i] : 0;- if (na !== nb) return na - nb;- }- return 0;-}--// #2742: when CWD is a linked git worktree, it has no node_modules of its-// own (worktrees don't get their own `npm install`), so every CWD-relative-// probe in getPkgVersion() misses and the version silently falls back to-// the baked-in default β even though the main repo's install a few-// directories away is perfectly resolvable. A linked worktree's `.git` is-// a plain FILE (not a directory) containing `gitdir: <main>/.git/worktrees/-// <name>`; walk up from CWD to find it, parse the pointer, and strip the-// trailing `.git/worktrees/<name>` segment to recover the main repo root.-// Pure fs β no `git rev-parse` spawn (statusline renders are latency--// sensitive; this doc comment's neighbors are explicit about avoiding-// spawns in the render path).-function resolveWorktreeMainRoot() {- try {- let dir = CWD;- for (;;) {- const dotGit = path.join(dir, '.git');- if (fs.existsSync(dotGit)) {- if (fs.statSync(dotGit).isFile()) {- const contents = fs.readFileSync(dotGit, 'utf-8');- const m = contents.match(/^gitdir:\s*(.+)$/m);- const wtGitDir = m && m[1].trim();- if (wtGitDir) {- // Git writes this pointer with forward slashes even on Windows- // (a git-for-windows convention for its own internal files) β- // path.sep (backslash on win32) never matches, so normalize- // before searching rather than building an OS-specific marker.- const normalized = wtGitDir.replace(/\\/g, '/');- const marker = '/.git/worktrees/';- const idx = normalized.lastIndexOf(marker);- if (idx > 0) return normalized.slice(0, idx);- }- }- return null; // a real (non-worktree) .git dir β nothing to resolve- }- const parent = path.dirname(dir);- if (parent === dir) return null; // reached filesystem root- dir = parent;- }- } catch {- return null;- }-}--function getPkgVersion() {- // Baked in at generation time from the real running CLI's own resolved- // version (see generateStatuslineScript()'s doc comment) β correct even- // when this renders via a pure npx invocation with no local install for- // the candidate scan below to find.- let ver = "3.32.8";- try {- const home = os.homedir();- const pkgPaths = [- path.join(home, '.claude', 'plugins', 'marketplaces', 'ruflo', 'package.json'),- path.join(CWD, 'node_modules', '@claude-flow', 'cli', 'package.json'),- path.join(CWD, 'node_modules', 'ruflo', 'package.json'),- path.join(CWD, 'v3', '@claude-flow', 'cli', 'package.json'),- ];- // #2742: CWD is a linked git worktree with no node_modules of its own β- // probe the main repo's install too, so a worktree session shows the- // same version a main-repo session would.- const worktreeMainRoot = resolveWorktreeMainRoot();- if (worktreeMainRoot) {- pkgPaths.push(- path.join(worktreeMainRoot, 'node_modules', '@claude-flow', 'cli', 'package.json'),- path.join(worktreeMainRoot, 'node_modules', 'ruflo', 'package.json'),- path.join(worktreeMainRoot, 'v3', '@claude-flow', 'cli', 'package.json'),- );- }- // #2221: global installs (npm i -g ruflo) live outside CWD/node_modules, so the- // probes above all miss and the version falls back to the hard-coded default.- // Derive the global node_modules dir from the running node binary (no npm spawn β- // statusline renders often). Covers nvm/mise (bin/../lib/node_modules) and Windows- // (bin/node_modules) layouts.- try {- const binDir = path.dirname(process.execPath);- const globalModuleDirs = [path.join(binDir, '..', 'lib', 'node_modules'), path.join(binDir, 'node_modules')];- // #2221 follow-up: a custom npm prefix (e.g. ~/.npm-global) is decoupled from- // the node binary location, so the binDir-derived probes above all miss. Also- // probe the npm prefix from the environment and the common ~/.npm-global default.- for (const prefix of [process.env.npm_config_prefix, process.env.PREFIX, path.join(home, '.npm-global')]) {- if (prefix) globalModuleDirs.push(path.join(prefix, 'lib', 'node_modules'));- }- for (const gm of globalModuleDirs) {- pkgPaths.push(- path.join(gm, 'ruflo', 'package.json'),- path.join(gm, '@claude-flow', 'cli', 'package.json'),- );- }- } catch { /* ignore */ }- // Pick the HIGHEST version among every candidate that exists, not the- // first one found. The marketplace plugin path is probed first (list- // order above), but Claude Code's own plugin marketplace mechanism- // syncs on its own git-pull cadence, independent of npm publishes β a- // freshly-published npm version can sit alongside a stale marketplace- // checkout for a while (observed live: marketplace one release behind- // right after a publish). Taking the first EXISTING candidate meant the- // header could show a stale version even when a newer install (e.g.- // node_modules/@claude-flow/cli from a plain npm install) was sitting right there.- let found = false;- for (const p of pkgPaths) {- if (!fs.existsSync(p)) continue;- try {- const pkg = JSON.parse(fs.readFileSync(p, 'utf-8'));- if (pkg && typeof pkg.version === 'string' && pkg.version.length > 0) {- if (!found || compareVersions(pkg.version, ver) > 0) ver = pkg.version;- found = true;- }- } catch { /* ignore */ }- }- } catch { /* ignore */ }- return ver;-}--// βββ Rendering ββββββββββββββββββββββββββββββββββββββββββββββββββ--function progressBar(current, total) {- const width = 5;- const filled = Math.round((current / total) * width);- return '[' + 'β'.repeat(filled) + 'β'.repeat(width - filled) + ']';-}--function generateStatusline() {- const d = getStatuslineData();- const git = getGitInfo();- const modelName = getModelFromStdin() || (d.user && d.user.modelName) || 'Claude Code';- const ctxInfo = getContextFromStdin();- const costInfo = getCostFromStdin();- // Named RUFLO_VERSION (not pkgVersion) so the #1951 regression guard- // (scripts/audit-fix-invariants.mjs) can pin its presence in the emitted- // .cjs artifact β without it the header silently reverts to a hard-coded- // "RuFlo V3.5" for anyone whose install doesn't match the first probe path.- const RUFLO_VERSION = getPkgVersion();-- const progress = d.v3Progress || {};- const security = d.security || {};- const swarm = d.swarm || {};- const system = d.system || {};- const adrs = d.adrs || {};- const hooks = d.hooks || {};- const agentdb = d.agentdb || {};- const tests = d.tests || {};-- const domainsCompleted = progress.domainsCompleted || 0;- const totalDomains = progress.totalDomains || 5;- const dddProgress = progress.dddProgress || 0;- const patternsLearned = progress.patternsLearned || 0;- const activeAgents = swarm.activeAgents || 0;- const maxAgents = swarm.maxAgents || CONFIG.maxAgents;- const coordinationActive = swarm.coordinationActive || false;- const intelligencePct = system.intelligencePct || 0;- const memoryMB = system.memoryMB || 0;- const subAgents = system.subAgents || 0;- const findings = Math.max(0, security.findings || 0);- const secStatus = security.status || 'NONE';- const adrCount = adrs.count || 0;- const adrImpl = adrs.implemented || 0;- const hooksEnabled = hooks.enabled || 0;- const hooksTotal = hooks.total || 0;- const vectorCount = agentdb.vectorCount || 0;- const hasHnsw = agentdb.hasHnsw || false;- const dbSizeKB = agentdb.dbSizeKB || 0;- const testFiles = tests.testFiles || 0;- const testCases = tests.testCases || testFiles * 4;-- const lines = [];-- // 3-line design (fits Claude Code's visible statusline area β line 4+ gets- // replaced by the system guidance / input prompt line):- // Line 1 β Header (RuFlo version Β· git Β· model Β· timing Β· context Β· cost)- // Line 2 β Compressed ops (Swarm Β· Hooks Β· π§ Β· πΎ Β· Health)- // Line 3 β Promo / disclosure row (funnel surface, ADR-301)-- // βββ Line 1: header ββββββββββββββββββββββββββββββββββββββββββββ- let header = c.bold + c.brightPurple + 'β RuFlo V' + RUFLO_VERSION + ' ' + c.reset;- header += (coordinationActive ? c.brightCyan : c.dim) + 'β ' + c.brightCyan + git.name + c.reset;- if (git.gitBranch) {- header += ' ' + c.dim + 'β' + c.reset + ' ' + c.brightBlue + 'β ' + git.gitBranch + c.reset;- const changes = git.modified + git.staged + git.untracked;- if (changes > 0) {- let ind = '';- if (git.staged > 0) ind += c.brightGreen + '+' + git.staged + c.reset;- if (git.modified > 0) ind += c.brightYellow + '~' + git.modified + c.reset;- if (git.untracked > 0) ind += c.dim + '?' + git.untracked + c.reset;- header += ' ' + ind;- }- if (git.ahead > 0) header += ' ' + c.brightGreen + 'β' + git.ahead + c.reset;- if (git.behind > 0) header += ' ' + c.brightRed + 'β' + git.behind + c.reset;- }- header += ' ' + c.dim + 'β' + c.reset + ' ' + c.purple + modelName + c.reset;- const duration = costInfo ? costInfo.duration : '';- if (duration) header += ' ' + c.dim + 'β' + c.reset + ' ' + c.cyan + 'β± ' + duration + c.reset;- if (ctxInfo && ctxInfo.usedPct > 0) {- const ctxColor = ctxInfo.usedPct >= 90 ? c.brightRed : ctxInfo.usedPct >= 70 ? c.brightYellow : c.brightGreen;- header += ' ' + c.dim + 'β' + c.reset + ' ' + ctxColor + 'β ' + ctxInfo.usedPct + '% ctx' + c.reset;- }- if (!CONFIG.hideCost && costInfo && costInfo.costUsd > 0) {- header += ' ' + c.dim + 'β' + c.reset + ' ' + c.brightYellow + CONFIG.costSymbol + costInfo.costUsd.toFixed(2) + c.reset;- }- lines.push(header);-- // βββ Line 2: compressed ops ββββββββββββββββββββββββββββββββββββ- // Everything actionable in one dense row. Show only what changes what you- // do next; diagnostic detail moves to `ruflo status --verbose`.- const agentsColor = activeAgents > 0 ? c.brightGreen : c.dim;- const hooksColor = hooksEnabled > 0 ? c.brightGreen : c.dim;- const intellColor = intelligencePct >= 80 ? c.brightGreen : intelligencePct >= 40 ? c.brightYellow : c.dim;- const swarmInd = coordinationActive ? c.brightGreen + 'β' + c.reset + ' ' : c.dim + 'β' + c.reset + ' ';- const healthAllGreen = (secStatus === 'CLEAN' || secStatus === 'NONE') && findings === 0;- const opsParts = [];- opsParts.push(c.cyan + 'Swarm ' + swarmInd + agentsColor + activeAgents + c.reset + '/' + c.brightWhite + maxAgents + c.reset);- if (subAgents > 0) opsParts.push(c.brightPurple + 'π₯ ' + subAgents + c.reset);- opsParts.push(c.cyan + 'Hooks ' + hooksColor + hooksEnabled + c.reset + '/' + c.brightWhite + hooksTotal + c.reset);- opsParts.push(intellColor + 'π§ ' + intelligencePct + '%' + c.reset);- opsParts.push(c.brightCyan + 'πΎ ' + memoryMB + 'MB' + c.reset);- // Health: one glyph when green, terse copy when there's something to act on.- if (healthAllGreen) {- opsParts.push(c.brightGreen + 'π‘ β' + c.reset);- } else {- if (secStatus === 'PENDING') opsParts.push(c.brightYellow + 'π‘ scan pending' + c.reset);- else if (secStatus === 'IN_PROGRESS') opsParts.push(c.brightYellow + 'π‘ scanningβ¦' + c.reset);- else if (secStatus === 'ISSUES') opsParts.push(c.brightRed + 'π‘ findings' + c.reset);- else if (secStatus === 'STALE') opsParts.push(c.brightYellow + 'π‘ scan stale' + c.reset);- else if (secStatus !== 'NONE' && secStatus !== 'CLEAN') opsParts.push(c.brightRed + 'π‘ ' + secStatus.toLowerCase() + c.reset);- if (findings > 0) {- opsParts.push(c.brightRed + 'β ' + findings + ' finding' + (findings === 1 ? '' : 's') + c.reset);- }- }- lines.push(opsParts.join(' ' + c.dim + 'Β·' + c.reset + ' '));-- // βββ Line 3: promo / disclosure / insight βββββββββββββββββββββββ- // Colored by content kind so it reads as *what it is*, not as noise:- // disclosure β brightCyan (announcement / capability link)- // promotional β brightPurple (Cognitum sponsor spot)- // educational β yellow (a tip)- // insight β brightRed (environment/task-aware, local, actionable β- // distinct from remote content on purpose)- const promoRow = getPromoRow(d);- if (promoRow) {- const kind = (d && d.promo && d.promo.kind) || 'disclosure';- const promoColor = kind === 'promotional' ? c.brightPurple- : kind === 'educational' ? c.yellow- : kind === 'insight' ? c.brightRed- : c.brightCyan;- lines.push(promoColor + promoRow + c.reset);- }-- // Trailing blank line so Claude Code's input prompt gets breathing room- // instead of butting directly against the last statusline row.- return lines.join('\n') + '\n';-}--// βββ Funnel promo row (ADR-301) βββββββββββββββββββββββββββββββββ-// Allowlist for OSC 8 hyperlink targets. Ships in code (not in payload) so-// no message can smuggle a link to an unapproved host.-//-// The final destination hosts (cognitum.one / agentics.org) AND the-// click-redirect host are both allowlisted here: promo.ts routes every-// clickable message through the server-side click-redirect (ADR-311 Β§7)-// so promo_open + geo are captured before the 302 to the real target β-// so the OSC 8 link the renderer emits points at the redirect host, not-// the final destination directly.-const PROMO_LINK_HOSTS = new Set([- 'cognitum.one', 'www.cognitum.one', 'docs.cognitum.one',- // agentics.org β OSS foundation, distinct sponsor domain. Kept in sync- // with messages.ts ALLOWED_URL_HOSTS.- 'agentics.org', 'www.agentics.org',- // Click-redirect host (funnel.ruv.io once its TLS cert is live; the raw- // Cloud Run hostname is allowlisted too since event-transport.ts /- // message-transport.ts / attribution.ts currently point at it as a TEMP- // fallback while the domain mapping's cert provisions).- 'funnel.ruv.io',- 'cognitum-analytics-63rzcdswba-uc.a.run.app',-]);--// Emit OSC 8 hyperlinks unless the environment is known-broken. tmux mangles-// raw OSC 8 (see anthropics/claude-code#27047) β opt in via env if wrapped.-function terminalSupportsHyperlinks() {- if (process.env.CI || process.env.GITHUB_ACTIONS) return false;- if (process.env.TERM === 'dumb') return false;- if (/^(0|false|off|no)$/i.test(String(process.env.RUFLO_STATUSLINE_HYPERLINKS || ''))) return false;- if (process.env.TMUX && !process.env.RUFLO_STATUSLINE_HYPERLINKS_TMUX) return false;- return true;-}--// Wrap a label in an OSC 8 hyperlink escape sequence. Falls back to the raw-// label whenever the URL is not an allowlisted https target, when the terminal-// can't render hyperlinks, or when parsing fails β a broken link must never-// leave a raw URL or stray escape in the statusline output.-function safeTerminalLink(label, url) {- if (!terminalSupportsHyperlinks()) return label;- if (typeof url !== 'string' || url.length === 0) return label;- let parsed;- try { parsed = new URL(url); } catch { return label; }- if (parsed.protocol !== 'https:') return label;- if (!PROMO_LINK_HOSTS.has(parsed.hostname)) return label;- const cleanLabel = String(label).replace(/[\u0000-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/g, '');- if (cleanLabel.length === 0) return label;- const ESC = '\u001b';- return ESC + ']8;;' + parsed.href + ESC + '\\' + cleanLabel + ESC + ']8;;' + ESC + '\\';-}--function getPromoRow(d) {- try {- if (process.env.CI || process.env.GITHUB_ACTIONS) return null;- if (/^(0|false|off|no)$/i.test(String(process.env.RUFLO_FUNNEL || ''))) return null;- const promo = d && d.promo;- if (!promo || typeof promo.text !== 'string') return null;- // Strip control chars / ANSI / bidi overrides β promo copy is data and- // must never emit its own terminal sequences. Hard-cap length AFTER the- // strip; append an ellipsis when the cap fires so the row visibly reads- // as truncated instead of chopping a word mid-character (was: silent- // slice(0,100) that could produce output that looked like corrupt data).- const MAX_LEN = 100;- const sanitized = promo.text- .replace(/[\u0000-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/g, '')- ;- const text = (sanitized.length > MAX_LEN ? sanitized.slice(0, MAX_LEN - 1).trimEnd() + 'β¦' : sanitized).trim();- if (text.length === 0) return null;- // Split the label from the trailing "Β· manage: ruflo settings" instruction- // so each part gets styling that matches what it actually IS:- // 1. label β OSC 8 hyperlink + underline. A real clickable link.- // 2. "manage:" β dim. Just a connector word, no action implied.- // 3. "ruflo settings" β bold/bright, NOT underlined. This is a shell- // command the user TYPES, not a link they CLICK β a terminal can- // never safely execute a command from a click (that would let any- // server-served message run arbitrary commands), so we deliberately- // avoid the underline/OSC8 cues that imply "clickable". Bold+bright- // instead signals "this is the important bit β copy/type it".- // Educational tips have no manage tail and no URL β plain text through.- const manageIdx = text.indexOf(' Β· manage: ');- const label = manageIdx > 0 ? text.slice(0, manageIdx) : text;- const manageWord = manageIdx > 0 ? ' Β· manage: ' : '';- const command = manageIdx > 0 ? text.slice(manageIdx + manageWord.length) : '';- const UL_ON = '\u001b[4m';- const UL_OFF = '\u001b[24m';- const DIM_ON = '\u001b[2m';- const DIM_OFF = '\u001b[22m';- const BOLD_ON = '\u001b[1m';- const BOLD_OFF = '\u001b[22m';- const FG_BRIGHT_WHITE = '[97m';- // Reset FG to default so the caller's row-color code resumes coloring the- // rest of the row after the command portion. Without this the row-color- // escape wouldn't visibly re-apply because we already emitted an explicit FG.- const FG_DEFAULT = '[39m';- // Some hosts (Claude Code's Windows UI, cmd.exe, older mintty) don't- // render OSC 8 hyperlinks as clickable β the label just underlines and- // clicks do nothing. Append a "(domain)" suffix so the destination is- // visible/copyable everywhere. Wrap the suffix in OSC 8 too so terminals- // that DO support hyperlinks give users TWO click targets (label AND- // domain hint) instead of one β some Windows hosts render one but not- // the other depending on how the statusline row is parsed.- // Only for URLs (not educational tips), and only when the label doesn't- // already end in the domain to avoid duplication.- let visibleUrlHint = '';- if (promo.url) {- try {- const host = new URL(promo.url).hostname.replace(/^www\./, '');- // Strip the click-redirect wrapper so users see the FINAL destination,- // not funnel.ruv.io. If the URL is /v1/click/<id>?to=<encoded>, pull the target.- let displayHost = host;- try {- const to = new URL(promo.url).searchParams.get('to');- if (to) displayHost = new URL(to).hostname.replace(/^www\./, '');- } catch { /* not a click-redirect, keep the raw host */ }- if (displayHost && !label.toLowerCase().endsWith(displayHost.toLowerCase())) {- // safeTerminalLink returns the plain string if URL isn't allowlisted- // or the terminal can't do OSC 8 β either way the domain stays visible.- const clickableDomain = safeTerminalLink(displayHost, promo.url);- visibleUrlHint = DIM_ON + ' (' + clickableDomain + ')' + DIM_OFF;- }- } catch { /* malformed URL β omit hint, never break the row */ }- }- // "Entire row clickable" (user request) β wrap the whole assembled- // string in ONE OSC 8 hyperlink instead of just the label. The command- // portion keeps its bold + bright-white treatment (no underline) so it- // still VISUALLY reads as a shell command the user should type, not a- // link β but if the user clicks anywhere on the row (label, domain- // hint, connector, even the command text), the terminal opens the URL.- // Clicking DOES NOT execute the command; it just opens the target URL,- // which is safe. Terminals that ignore OSC 8 render the whole row as- // styled text and no click behavior β the previous fallback (visible- // domain suffix) still keeps the destination readable.- const wrapWholeRowInHyperlink = (assembled) => {- if (!promo.url) return assembled;- if (!terminalSupportsHyperlinks()) return assembled;- let parsed;- try { parsed = new URL(promo.url); } catch { return assembled; }- if (parsed.protocol !== 'https:') return assembled;- if (!PROMO_LINK_HOSTS.has(parsed.hostname)) return assembled;- const ESC = '';- return ESC + ']8;;' + parsed.href + ESC + '\\' + assembled + ESC + ']8;;' + ESC + '\\';- };- // Visual styling stays per-part. We only add the OSC 8 wrap around the- // combined string, so the whole row is one click target.- const labelStyled = promo.url ? UL_ON + label + UL_OFF : label;- if (!command) return wrapWholeRowInHyperlink(labelStyled + visibleUrlHint);- return wrapWholeRowInHyperlink(- labelStyled + visibleUrlHint- + DIM_ON + manageWord + DIM_OFF- + BOLD_ON + FG_BRIGHT_WHITE + command + FG_DEFAULT + BOLD_OFF- );- } catch (e) {- return null; // the promo row must never break the statusline- }-}--// JSON output β delegates to CLI for accuracy; caller can use --json flag-function generateJSON() {- const d = getStatuslineData();- const git = getGitInfo();- return Object.assign({}, d, {- user: Object.assign({ name: git.name, gitBranch: git.gitBranch }, d.user || {}),- git: { modified: git.modified, untracked: git.untracked, staged: git.staged, ahead: git.ahead, behind: git.behind },- lastUpdated: new Date().toISOString(),- });-}--// βββ Main βββββββββββββββββββββββββββββββββββββββββββββββββββββββ-if (process.argv.includes('--json')) {- console.log(JSON.stringify(generateJSON(), null, 2));-} else if (process.argv.includes('--compact')) {- console.log(JSON.stringify(generateJSON()));-} else {- console.log(generateStatusline());-}+#!/usr/bin/env node+/**+ * RuFlo V3 Statusline β delegation build (#2195)+ *+ * Fix for ruvnet/ruflo#2195: the previous version re-implemented all data+ * readers locally using fragile file probes that missed AgentDB patterns,+ * the v3/docs/adr/ ADR directory, and the real vector count.+ *+ * This version delegates to 'npx @claude-flow/cli hooks statusline --json'+ * as the single source of truth. That command queries AgentDB directly,+ * counts ADRs in both directories, and reports the real intelligence pct.+ *+ * ADR counting falls back to local file reads so the display still works+ * without network access (counts both v3/docs/adr/ and v3/implementation/adrs/).+ *+ * Cache: JSON result is cached in /tmp for 10s so rapid prompt triggers+ * (every keystroke in some shells) don't hammer the CLI on every call.+ *+ * Usage: node statusline.cjs [--json] [--compact] [--dashboard]+ */++/* eslint-disable @typescript-eslint/no-var-requires */+const fs = require('fs');+const path = require('path');+const { execSync } = require('child_process');+const os = require('os');++// Configuration+const CONFIG = {+ maxAgents: 15,+ // Header identity defaults to project/repository name. Set `author` to+ // retain the previous `git config user.name` display (#2682).+ identityMode: (process.env.RUFLO_STATUSLINE_IDENTITY || 'project').toLowerCase(),+ // Session-cost display. Claude Code's cost.total_cost_usd is a client-side+ // estimate that "may differ from your actual bill" and reads as misleading on+ // subscription plans, where token usage is not billed per dollar. These let+ // each user pick what the segment means to them without changing the default.+ // RUFLO_STATUSLINE_COST_SYMBOL override the leading '$' (e.g. β‘, β¬, π±);+ // set to an empty string for the number alone.+ // RUFLO_STATUSLINE_HIDE_COST 1/true/yes/on removes the segment entirely.+ costSymbol: process.env.RUFLO_STATUSLINE_COST_SYMBOL ?? '$',+ hideCost: /^(1|true|yes|on)$/i.test(process.env.RUFLO_STATUSLINE_HIDE_COST || ''),+};++const CWD = process.cwd();++// βββ Delegation cache βββββββββββββββββββββββββββββββββββββββββββ+// Cache the CLI JSON result so rapid prompt re-renders (Claude Code+// refreshes the statusline several times a second while streaming) don't+// re-invoke the CLI each time.+// #2337 bumped 10s β 60s.+// Followup for anthropics/claude-code#70200 (Windows console-flash bug β+// claude.exe spawns hook/statusline subprocesses without CREATE_NO_WINDOW,+// producing a visible cmd flash on every render): bumped 60s β 300s to+// reduce the flash rate 5x on Windows until the upstream fix ships.+// Tradeoff: stat/git counters update every 5min instead of every 1min;+// promo/insight row still rotates on its own tighter 20s promoFresh clock.+const CACHE_FILE = path.join(os.tmpdir(), 'ruflo-statusline-cache-' + require('crypto').createHash('md5').update(CWD).digest('hex').slice(0, 8) + '.json');+const CACHE_TTL_MS = 300000;++// The promo/insight row is designed to rotate on a 20s cadence (funnel/+// rotation.ts's ROTATION_SLOT_MS / funnel/promo.ts's insight-slot check β+// duplicated here as a bare number since this generated script has no+// runtime import of the funnel module; keep in sync if that constant ever+// changes). The rotation slot is only ever (re)computed SERVER-SIDE inside+// the CLI subprocess this file shells out to β so a general 60s data cache+// (correct and necessary for #2337) silently made that 20s design+// unreachable: cache.fresh stayed true across 2-3 whole rotation slots,+// so the row visibly "didn't rotate" (user report). Fix: track promo+// freshness on its OWN, tighter clock β when it lags behind the current+// slot, fall through to a real CLI call even though the REST of the+// cached data (security/swarm/system) is still within CACHE_TTL_MS. This+// does not touch or regress #2337's fix; it only adds a narrower check.+const PROMO_ROTATION_SLOT_MS = 20000;++// Persistent last-known-good promo record. Lives outside the /tmp cache so it+// survives a full cache wipe / cache write race / CLI failure combo. Written+// every time we successfully render a promo; read as a last resort so the row+// never blinks out mid-session (was: 'promo shows then hides' bug report).+const PROMO_MEMO_FILE = path.join(os.homedir(), '.ruflo', 'statusline-promo.json');+const PROMO_MEMO_TTL_MS = 6 * 60 * 60 * 1000; // 6h β long enough to bridge any hiccup, short enough that a real disable takes effect fast.++// #2337: resolve an already-installed @claude-flow/cli (or ruflo) bin so we+// can invoke it directly via `node`. The previous version called+// `npx --yes @claude-flow/cli@latest` on every uncached render, which forces+// a registry resolution + cold-start of the entire CLI per render. With+// multiple concurrent Claude Code sessions this storms the host (reporter+// saw load average 40-65 on a 12-core box).+//+// Returns EVERY existing bin/cli.js candidate, in preference order (project,+// monorepo, plugin marketplace, global node_modules including custom-prefix+// layouts like ~/.npm-global) β mirrors getPkgVersion()'s own path probing.+//+// Returns a list, not a single winner: `fs.existsSync` only proves a file is+// present, not that it actually runs. A marketplace/npx-cached install can+// exist on disk but be broken (observed in practice: a stale marketplace+// checkout whose dist/ imports a workspace package, '@claude-flow/cli-core',+// that isn't bundled there β every invocation throws ERR_MODULE_NOT_FOUND).+// Picking the first EXISTING path and never falling through meant a single+// broken install silently killed the promo row for the entire session (the+// CLI call always failed, so the memo could never refresh and eventually+// expired). getStatuslineData() now walks this whole list and tries the next+// candidate on failure, so one broken install can't permanently wedge it.+function resolveCliBinCandidates() {+ const candidates = [];+ try {+ const home = os.homedir();+ candidates.push(+ path.join(home, '.claude', 'plugins', 'marketplaces', 'ruflo', 'bin', 'cli.js'),+ path.join(CWD, 'node_modules', '@claude-flow', 'cli', 'bin', 'cli.js'),+ path.join(CWD, 'node_modules', 'ruflo', 'bin', 'cli.js'),+ path.join(CWD, 'v3', '@claude-flow', 'cli', 'bin', 'cli.js'),+ );+ try {+ const binDir = path.dirname(process.execPath);+ const globalModuleDirs = [path.join(binDir, '..', 'lib', 'node_modules'), path.join(binDir, 'node_modules')];+ for (const prefix of [process.env.npm_config_prefix, process.env.PREFIX, path.join(home, '.npm-global')]) {+ if (prefix) globalModuleDirs.push(path.join(prefix, 'lib', 'node_modules'));+ }+ for (const gm of globalModuleDirs) {+ candidates.push(+ path.join(gm, 'ruflo', 'bin', 'cli.js'),+ path.join(gm, '@claude-flow', 'cli', 'bin', 'cli.js'),+ );+ }+ } catch { /* ignore */ }+ } catch { /* ignore */ }+ return candidates.filter((p) => {+ try {+ if (!fs.existsSync(p)) return false;+ // A candidate's bin/cli.js can exist on disk while its compiled+ // dist/ never got built (Claude Code's own plugin marketplace just+ // git-clones the repo β no install/build step β so every marketplace+ // install is a source-only checkout by construction). Importing+ // dist/src/index.js from bin/cli.js then throws MODULE_NOT_FOUND on+ // every real command; only --version happens to survive it. Check+ // for the compiled entrypoint too so a doomed candidate is skipped+ // up front instead of wasting a spawn-and-fail on every render.+ return fs.existsSync(path.join(path.dirname(p), '..', 'dist', 'src', 'index.js'));+ } catch { return false; }+ });+}++// Return { fresh, promoFresh, data }. 'fresh' is true only if within the TTL+// β but data is returned regardless (stale-while-revalidate). This lets us+// serve last known state (specifically the promo row) when the CLI is+// slow/unavailable, so users don't see the funnel row flicker in and out on+// cache expiry. 'promoFresh' is a SEPARATE, tighter check on the same clock+// as PROMO_ROTATION_SLOT_MS β see that constant's comment for why the promo+// row needs its own freshness bound distinct from the general 60s TTL.+function readCache() {+ try {+ if (fs.existsSync(CACHE_FILE)) {+ const raw = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf-8'));+ if (raw && raw._ts && raw.data) {+ const age = Date.now() - raw._ts;+ return { fresh: age < CACHE_TTL_MS, promoFresh: age < PROMO_ROTATION_SLOT_MS, data: raw.data };+ }+ }+ } catch { /* ignore */ }+ return { fresh: false, promoFresh: false, data: null };+}++function writeCache(data) {+ try { fs.writeFileSync(CACHE_FILE, JSON.stringify({ _ts: Date.now(), data }), 'utf-8'); } catch { /* ignore */ }+ // Also memoize any promo we saw so the row can survive future CLI hiccups.+ try {+ if (data && data.promo && typeof data.promo === 'object') {+ fs.mkdirSync(path.dirname(PROMO_MEMO_FILE), { recursive: true, mode: 0o700 });+ fs.writeFileSync(PROMO_MEMO_FILE, JSON.stringify({ _ts: Date.now(), promo: data.promo }), { encoding: 'utf-8', mode: 0o600 });+ }+ } catch { /* ignore */ }+}++// Last resort: read a memoized promo (up to 6h old). Used when no cache and+// no CLI response is available β the row still renders, so users don't see+// the disclosure blink out. Returns null when the memo is absent, expired,+// or malformed. Never throws.+function readPromoMemo() {+ try {+ if (!fs.existsSync(PROMO_MEMO_FILE)) return null;+ const raw = JSON.parse(fs.readFileSync(PROMO_MEMO_FILE, 'utf-8'));+ if (raw && raw._ts && (Date.now() - raw._ts) < PROMO_MEMO_TTL_MS && raw.promo) {+ return raw.promo;+ }+ } catch { /* ignore */ }+ return null;+}++/**+ * Single source of truth: delegate to the CLI hooks statusline --json command.+ * Falls back to a minimal static object on failure so the statusline still renders.+ *+ * Fix for ruflo#2195: the previous local readers returned 0 for AgentDB patterns+ * (missed the .swarm/memory.db β AgentDB path), computed dddProgress wrong,+ * and only counted ADRs in v3/implementation/adrs/ (missed v3/docs/adr/).+ */+// Overlay the memoized promo onto any data object that's missing one. This is+// the safety net that keeps the funnel row rendered when an OLDER cached CLI+// version is picked up by npx β that older CLI succeeds but omits promo, so+// the JSON round-trips clean but without our row. We patch it back here.+function overlayMemoPromo(data) {+ if (data && !data.promo) {+ const memoPromo = readPromoMemo();+ if (memoPromo) data.promo = memoPromo;+ }+ return data;+}++function getStatuslineData() {+ const cache = readCache();+ // Both clocks must be satisfied to skip the CLI call entirely: the general+ // 60s TTL (#2337 β don't re-spawn the CLI on every rapid re-render) AND the+ // tighter promo-rotation clock (this fix β don't let a still-fresh 60s+ // cache silently freeze the promo/insight row across multiple 20s slots).+ if (cache.fresh && cache.promoFresh) {+ return applyLocalOverlays(overlayMemoPromo(cache.data));+ }++ // #2337: prefer an already-installed CLI bin via direct `node` invocation β+ // no npx, no registry round-trip, no @latest re-resolve per render. Try+ // every candidate that actually EXISTS (not just the first) before falling+ // back to `npx --prefer-offline @claude-flow/cli` (no @latest); an existing+ // but broken install (e.g. a stale marketplace checkout missing a bundled+ // workspace dep) must not block trying the next one.+ //+ // No `2>/dev/null` here (deliberately) β the execSync call below already+ // sets stdio: ['pipe','pipe','pipe'], which captures/discards stderr at the+ // Node level regardless of shell. The redirect was redundant on POSIX and+ // actively broke every candidate on Windows: cmd.exe (execSync's default+ // shell there) doesn't understand /dev/null, so the CLI delegation always+ // failed, silently degrading every render to buildLocalFallback() β 0%+ // intelligence and an empty promo row (the memo cache that keeps the row+ // populated across CLI hiccups is only ever written from a SUCCESSFUL+ // delegation, so it could never get seeded on Windows either).+ const cmds = resolveCliBinCandidates()+ .map((bin) => '"' + process.execPath + '" "' + bin + '" hooks statusline --json')+ .concat(['npx --prefer-offline @claude-flow/cli hooks statusline --json']);+ for (const cmd of cmds) {+ try {+ const raw = execSync(+ cmd,+ { encoding: 'utf-8', timeout: 8000, stdio: ['pipe', 'pipe', 'pipe'], cwd: CWD, windowsHide: true }+ ).trim();+ // The CLI may emit preamble lines before the JSON β find the first '{'.+ const jsonStart = raw.indexOf('{');+ if (jsonStart === -1) throw new Error('no JSON in CLI output');+ const data = JSON.parse(raw.slice(jsonStart));+ // Overlay every block the CLI JSON omits (adrs/agentdb/tests/hooks/integration)+ // with real local reads, so those segments reflect actual state instead of 0.+ applyLocalOverlays(data);+ overlayMemoPromo(data);+ writeCache(data);+ return data;+ } catch { /* this candidate unavailable, broken, or timed out β try the next */ }+ }++ // Stale-while-revalidate: if we have any cached data, keep serving it so the+ // funnel row doesn't flicker on CLI hiccups. Overlay fresh local reads for+ // the segments the CLI JSON doesn't populate; the promo row survives.+ if (cache.data) {+ applyLocalOverlays(cache.data);+ overlayMemoPromo(cache.data);+ return cache.data;+ }++ // Last resort: local probes + memo. Users still see the funnel row.+ return overlayMemoPromo(buildLocalFallback());+}++// Count ADRs from BOTH known directories (fix for ruflo#2195: old code missed+// v3/docs/adr/ which holds ADR-088..ADR-137, i.e. 41 of the 128 total ADRs).+function getLocalADRCount() {+ const adrDirs = [+ path.join(CWD, 'v3', 'implementation', 'adrs'),+ path.join(CWD, 'v3', 'docs', 'adr'),+ path.join(CWD, 'docs', 'adrs'),+ path.join(CWD, '.claude-flow', 'adrs'),+ ];+ let total = 0;+ for (const dir of adrDirs) {+ try {+ if (fs.existsSync(dir)) {+ const files = fs.readdirSync(dir).filter(function(f) {+ return f.endsWith('.md') && (f.startsWith('ADR-') || f.startsWith('adr-') || /^\d{4}-/.test(f));+ });+ total += files.length;+ }+ } catch { /* ignore */ }+ }+ return { count: total, implemented: total, compliance: 0 };+}++// βββ Local overlays for segments the CLI JSON omits ββββββββββββββ+// 'hooks statusline --json' only returns user/v3Progress/security/swarm/system.+// agentdb/tests/hooks/integration are never populated, so without these overlays+// they render as a permanent 0. Each reader is cheap and degrades to zeros.++// Real AgentDB stats from the local memory DB. Vectors live in .swarm/memory.db+// (sql.js + HNSW); ruvector.db is an opaque redb store counted only toward size.+// One read-only sqlite3 query (mode=ro never takes a write lock the daemon owns).+function getLocalAgentDB() {+ const result = { vectorCount: 0, dbSizeKB: 0, hasHnsw: false };+ try {+ let bytes = 0;+ for (const f of ['.swarm/memory.db', 'ruvector.db']) {+ try { bytes += fs.statSync(path.join(CWD, f)).size; } catch { /* missing */ }+ }+ result.dbSizeKB = Math.round(bytes / 1024);++ const memDb = path.join(CWD, '.swarm', 'memory.db');+ if (fs.existsSync(memDb)) {+ const Q = String.fromCharCode(34);+ // Two INDEPENDENT statements -- do NOT combine into one. Coupling the+ // vector count with the vector_indexes row count in a single statement+ // meant that on a DB missing the vector_indexes table (older/agentdb-+ // written DBs), the whole statement failed at PREPARE time (SQLite+ // compiles the full SQL before running), so the valid memory_entries+ // count was discarded too and the statusline showed Vectors 0 despite+ // thousands of real vectors. Split so a missing table can only zero the+ // HNSW flag, never the count. The init self-heal provisions the table so+ // the flag recovers on the next ruflo init / MCP start.+ const countSql = Q + 'SELECT COUNT(*) FROM memory_entries WHERE embedding IS NOT NULL;' + Q;+ const vc = safeExec("sqlite3 'file:" + memDb + "?mode=ro' " + countSql, 1500);+ if (vc) result.vectorCount = parseInt(vc, 10) || 0;+ // HNSW flag: separate statement. If vector_indexes is absent, sqlite3+ // exits non-zero and safeExec returns empty -- hasHnsw stays false (exact+ // original semantics: at least one index-config row present).+ const hnswSql = Q + 'SELECT COUNT(*) FROM vector_indexes;' + Q;+ const hn = safeExec("sqlite3 'file:" + memDb + "?mode=ro' " + hnswSql, 1500);+ if (hn) result.hasHnsw = (parseInt(hn, 10) || 0) > 0;+ }+ } catch { /* ignore */ }+ return result;+}++// Count test files via a bounded directory walk (no file reads).+function getLocalTests() {+ let testFiles = 0;+ function countTests(dir, depth) {+ if ((depth || 0) > 4) return;+ try {+ if (!fs.existsSync(dir)) return;+ for (const e of fs.readdirSync(dir, { withFileTypes: true })) {+ if (e.isDirectory() && !e.name.startsWith('.') && e.name !== 'node_modules') {+ countTests(path.join(dir, e.name), (depth || 0) + 1);+ } else if (e.isFile() && (e.name.includes('.test.') || e.name.includes('.spec.') || e.name.startsWith('test_') || e.name.startsWith('spec_'))) {+ testFiles++;+ }+ }+ } catch { /* ignore */ }+ }+ for (const d of ['tests', 'test', '__tests__', 'src', 'v3']) countTests(path.join(CWD, d));+ return { testFiles, testCases: testFiles * 4 };+}++// Count configured hooks from project .claude/settings.json. Claude Code hooks+// have no enabled/disabled flag, so every configured hook counts as enabled.+function getLocalHooks() {+ const result = { enabled: 0, total: 0 };+ try {+ const settings = readJSON(path.join(CWD, '.claude', 'settings.json'));+ const hooks = settings && settings.hooks;+ if (hooks && typeof hooks === 'object') {+ let n = 0;+ for (const ev of Object.keys(hooks)) {+ const groups = hooks[ev];+ if (Array.isArray(groups)) {+ for (const g of groups) {+ if (g && Array.isArray(g.hooks)) n += g.hooks.length;+ }+ }+ }+ result.total = n;+ result.enabled = n;+ }+ } catch { /* ignore */ }+ return result;+}++// Best-effort integration block: DB presence + locally-configured stdio MCP+// servers (project .mcp.json + global ~/.claude.json). Remote connectors are+// account-managed and not present in local config, so they are not counted.+function getLocalIntegration() {+ const integration = { mcpServers: { enabled: 0, total: 0 }, hasDatabase: false };+ try {+ for (const f of ['.swarm/memory.db', 'ruvector.db']) {+ if (fs.existsSync(path.join(CWD, f))) { integration.hasDatabase = true; break; }+ }+ const names = new Set();+ const projMcp = readJSON(path.join(CWD, '.mcp.json'));+ if (projMcp && projMcp.mcpServers) for (const k of Object.keys(projMcp.mcpServers)) names.add(k);+ const claudeJson = readJSON(path.join(os.homedir(), '.claude.json'));+ if (claudeJson) {+ if (claudeJson.mcpServers) for (const k of Object.keys(claudeJson.mcpServers)) names.add(k);+ const proj = claudeJson.projects && claudeJson.projects[CWD];+ if (proj && proj.mcpServers && !Array.isArray(proj.mcpServers)) {+ for (const k of Object.keys(proj.mcpServers)) names.add(k);+ }+ }+ integration.mcpServers.total = names.size;+ integration.mcpServers.enabled = names.size;+ } catch { /* ignore */ }+ return integration;+}++// βββ Security freshness overlay (ruvnet/ruflo#2776) ββββββββββββββ+// The shipped CLI producer (dist/src/funnel/local-signals.js getSecurityStatus)+// only ever emits PENDING / CLEAN / ISSUES β it captures `scannedAt` but never+// inspects it, so a year-old scan renders π‘ β forever and the renderer's+// STALE / IN_PROGRESS branches are unreachable. Worse, when CLI delegation+// fails, the stale-while-revalidate cache (readCache() below) keeps serving+// the pre-scan PENDING pill indefinitely, so a user who runs the advertised+// `ruflo security scan` sees no change β the pill freezes at "scan pending".+//+// This overlay recomputes the security block from disk on EVERY render (same+// pattern as adrs/agentdb/tests/hooks above), which:+// 1) Makes STALE reachable β when the newest scan is older than+// RUFLO_SCAN_STALE_HOURS (default 24h β matches the CVE feed refresh+// cadence), report STALE regardless of what the cached CLI JSON says.+// 2) Makes IN_PROGRESS reachable β when a `scan-in-progress` marker file+// exists and is younger than SECURITY_IN_PROGRESS_MAX_MIN (guards against+// a crashed scan leaving the marker behind).+// 3) Caps the "scan pending" display window β if PENDING has been shown for+// >RUFLO_SCAN_PENDING_CAP_MIN (default 30) without a completion write,+// switch to STALE and stop rendering the yellow indicator. The tracker+// lives in ~/.ruflo/statusline-scan-pending-since.json, keyed by CWD+// hash so multiple project checkouts don't collide.+// 4) Since this runs AFTER readCache() serves stale data, it bypasses the+// "pill freezes at PENDING" freeze in defect 2 β the overlay reads+// fresh disk state even when the CLI delegation is broken.+const SECURITY_STALE_HOURS = Math.max(1, parseInt(process.env.RUFLO_SCAN_STALE_HOURS || '24', 10) || 24);+const SECURITY_PENDING_CAP_MIN = Math.max(1, parseInt(process.env.RUFLO_SCAN_PENDING_CAP_MIN || '30', 10) || 30);+const SECURITY_IN_PROGRESS_MAX_MIN = 30; // marker older than this = crashed scan; treat as absent+const PENDING_TRACK_FILE = path.join(os.homedir(), '.ruflo', 'statusline-scan-pending-since.json');+const CWD_KEY = require('crypto').createHash('md5').update(CWD).digest('hex').slice(0, 12);++function readPendingSince() {+ try {+ if (!fs.existsSync(PENDING_TRACK_FILE)) return null;+ const raw = JSON.parse(fs.readFileSync(PENDING_TRACK_FILE, 'utf-8'));+ if (raw && typeof raw === 'object' && typeof raw[CWD_KEY] === 'number') return raw[CWD_KEY];+ } catch { /* ignore */ }+ return null;+}++function writePendingSince(ts) {+ try {+ let obj = {};+ if (fs.existsSync(PENDING_TRACK_FILE)) {+ try { obj = JSON.parse(fs.readFileSync(PENDING_TRACK_FILE, 'utf-8')) || {}; } catch { obj = {}; }+ }+ if (ts === null) { delete obj[CWD_KEY]; } else { obj[CWD_KEY] = ts; }+ fs.mkdirSync(path.dirname(PENDING_TRACK_FILE), { recursive: true, mode: 0o700 });+ fs.writeFileSync(PENDING_TRACK_FILE, JSON.stringify(obj), { encoding: 'utf-8', mode: 0o600 });+ } catch { /* ignore */ }+}++function getLocalSecurity(cliSecurity) {+ const base = (cliSecurity && typeof cliSecurity === 'object')+ ? Object.assign({}, cliSecurity)+ : { status: 'NONE', findings: 0, cvesFixed: 0, totalCves: 0 };+ base.findings = Math.max(0, base.findings || 0);++ const scanDir = path.join(CWD, '.claude', 'security-scans');++ // Detect a live in-progress marker (writer opts-in by writing this file).+ let inProgress = false;+ try {+ const marker = path.join(scanDir, 'scan-in-progress');+ if (fs.existsSync(marker)) {+ const ageMin = (Date.now() - fs.statSync(marker).mtimeMs) / 60000;+ if (ageMin < SECURITY_IN_PROGRESS_MAX_MIN) inProgress = true;+ }+ } catch { /* ignore */ }++ // Find newest scan-*.json by mtime and read its findings/timestamp.+ let newestPath = null;+ let newestMtime = 0;+ try {+ if (fs.existsSync(scanDir)) {+ for (const name of fs.readdirSync(scanDir)) {+ if (!name.startsWith('scan-') || !name.endsWith('.json')) continue;+ try {+ const st = fs.statSync(path.join(scanDir, name));+ if (st.mtimeMs > newestMtime) { newestMtime = st.mtimeMs; newestPath = path.join(scanDir, name); }+ } catch { /* ignore */ }+ }+ }+ } catch { /* ignore */ }++ if (newestPath) {+ // We have a scan on disk β the never-scanned pending tracker is no longer+ // relevant. Clear it so a re-created directory can start a fresh window.+ writePendingSince(null);++ let scannedAtMs = newestMtime;+ let findings = base.findings;+ try {+ const j = JSON.parse(fs.readFileSync(newestPath, 'utf-8'));+ // scannedAt (CLI producer's field name) OR timestamp (writer's field name).+ const isoStr = (j && (j.scannedAt || j.timestamp)) || null;+ if (isoStr) {+ const t = Date.parse(isoStr);+ if (!isNaN(t)) scannedAtMs = t;+ }+ // findings may be a number, an array, or nested in summary.total.+ if (j) {+ if (typeof j.findings === 'number') findings = j.findings;+ else if (Array.isArray(j.findings)) findings = j.findings.length;+ else if (j.summary && typeof j.summary.total === 'number') findings = j.summary.total;+ }+ } catch { /* ignore parse β fall back to mtime + cached findings */ }++ base.findings = Math.max(0, findings || 0);+ base.scannedAt = new Date(scannedAtMs).toISOString();++ const ageHours = (Date.now() - scannedAtMs) / 3600000;+ if (ageHours >= SECURITY_STALE_HOURS) {+ // Stale but findings still render red (a year-old ISSUES scan is still bad).+ base.status = 'STALE';+ } else if (inProgress) {+ base.status = 'IN_PROGRESS';+ } else if (base.findings > 0) {+ base.status = 'ISSUES';+ } else {+ base.status = 'CLEAN';+ }+ return base;+ }++ // No scan file. If a live marker exists, we're mid-scan.+ if (inProgress) {+ base.status = 'IN_PROGRESS';+ // Reset the pending tracker so, if the scan crashes mid-flight, the next+ // render starts a fresh N-minute pending window instead of an already-expired one.+ writePendingSince(null);+ return base;+ }++ // Truly never-scanned: track how long we've shown PENDING. After the cap,+ // escalate to STALE with the dim/gray glyph so the pill visibly stops+ // shouting for attention β the user has either ignored it for 30 min or+ // the scan is silently failing to write.+ let pendingSince = readPendingSince();+ if (pendingSince === null || typeof pendingSince !== 'number') {+ pendingSince = Date.now();+ writePendingSince(pendingSince);+ }+ const pendingAgeMin = (Date.now() - pendingSince) / 60000;+ base.status = (pendingAgeMin >= SECURITY_PENDING_CAP_MIN) ? 'STALE' : 'PENDING';+ return base;+}++// Overlay every locally-derived block onto the CLI data (mutates in place).+function applyLocalOverlays(data) {+ data.adrs = getLocalADRCount();+ data.agentdb = getLocalAgentDB();+ data.tests = getLocalTests();+ data.hooks = getLocalHooks();+ data.integration = getLocalIntegration();+ // Security overlay: recompute freshness from disk on every render so cached+ // CLI JSON can never freeze the pill at PENDING. See getLocalSecurity() above.+ data.security = getLocalSecurity(data.security);+ return data;+}++// Minimal local fallback when the CLI is not installed or times out.+// Returns a structure that matches the CLI JSON schema so the renderer works.+function buildLocalFallback() {+ const memMB = Math.floor(process.memoryUsage().heapUsed / 1024 / 1024);++ return applyLocalOverlays({+ user: { name: 'user', gitBranch: '', modelName: 'Claude Code' },+ v3Progress: { domainsCompleted: 0, totalDomains: 5, dddProgress: 0, patternsLearned: 0, sessionsCompleted: 0 },+ security: { status: 'NONE', findings: 0, cvesFixed: 0, totalCves: 0 },+ swarm: { activeAgents: 0, maxAgents: CONFIG.maxAgents, coordinationActive: false },+ system: { memoryMB: memMB, contextPct: 0, intelligencePct: 0, subAgents: 0 },+ lastUpdated: new Date().toISOString(),+ });+}++// ANSI colors+const c = {+ reset: '\x1b[0m',+ bold: '\x1b[1m',+ dim: '\x1b[2m',+ red: '\x1b[0;31m',+ green: '\x1b[0;32m',+ yellow: '\x1b[0;33m',+ blue: '\x1b[0;34m',+ purple: '\x1b[0;35m',+ cyan: '\x1b[0;36m',+ brightRed: '\x1b[1;31m',+ brightGreen: '\x1b[1;32m',+ brightYellow: '\x1b[1;33m',+ brightBlue: '\x1b[1;34m',+ brightPurple: '\x1b[1;35m',+ brightCyan: '\x1b[1;36m',+ brightWhite: '\x1b[1;37m',+};++// Safe execSync with strict timeout (returns empty string on failure)+function safeExec(cmd, timeoutMs) {+ try {+ return execSync(cmd, {+ encoding: 'utf-8',+ timeout: timeoutMs || 2000,+ stdio: ['pipe', 'pipe', 'pipe'],+ // Windows: without this, every execSync spawns cmd.exe /d /s /c which+ // flashes a visible console window every render (~1/min via the 60s+ // cache TTL). windowsHide runs the child in a hidden window instead.+ // No-op on POSIX. Fix for #2XXX (user report: "cmd prompt keeps opening").+ windowsHide: true,+ }).trim();+ } catch {+ return '';+ }+}++// Safe JSON file reader (returns null on failure)+function readJSON(filePath) {+ try {+ if (fs.existsSync(filePath)) {+ return JSON.parse(fs.readFileSync(filePath, 'utf-8'));+ }+ } catch { /* ignore */ }+ return null;+}++// βββ Git info (pure-Node / single exec β needed for branch display) ββββββββββ++function getGitInfo() {+ const result = {+ name: path.basename(CWD) || 'project', gitBranch: '', modified: 0, untracked: 0,+ staged: 0, ahead: 0, behind: 0,+ };++ const script = [+ 'git rev-parse --show-toplevel 2>/dev/null || pwd',+ 'echo "---SEP---"',+ 'git config user.name 2>/dev/null || echo user',+ 'echo "---SEP---"',+ 'git branch --show-current 2>/dev/null',+ 'echo "---SEP---"',+ 'git status --porcelain 2>/dev/null',+ 'echo "---SEP---"',+ 'git rev-list --left-right --count HEAD...@{upstream} 2>/dev/null || echo "0 0"',+ ].join('; ');++ const raw = safeExec("sh -c '" + script + "'", 3000);+ if (!raw) return result;++ const parts = raw.split('---SEP---').map(function(s) { return s.trim(); });+ if (parts.length >= 5) {+ const projectName = path.basename(parts[0] || CWD) || path.basename(CWD) || 'project';+ const authorName = parts[1] || 'user';+ result.name = CONFIG.identityMode === 'author' ? authorName : projectName;+ result.gitBranch = parts[2] || '';++ if (parts[3]) {+ for (const line of parts[3].split('\n')) {+ if (!line || line.length < 2) continue;+ const x = line[0], y = line[1];+ if (x === '?' && y === '?') { result.untracked++; continue; }+ if (x !== ' ' && x !== '?') result.staged++;+ if (y !== ' ' && y !== '?') result.modified++;+ }+ }++ const ab = (parts[4] || '0 0').split(/\s+/);+ result.ahead = parseInt(ab[0]) || 0;+ result.behind = parseInt(ab[1]) || 0;+ }++ return result;+}++// Detect model name from Claude config (pure file reads, no exec)+function getModelName() {+ try {+ const claudeConfig = readJSON(path.join(os.homedir(), '.claude.json'));+ if (claudeConfig && claudeConfig.projects) {+ for (const [projectPath, projectConfig] of Object.entries(claudeConfig.projects)) {+ if (CWD === projectPath || CWD.startsWith(projectPath + '/')) {+ const usage = projectConfig.lastModelUsage;+ if (usage) {+ const ids = Object.keys(usage);+ if (ids.length > 0) {+ let modelId = ids[ids.length - 1];+ let latest = 0;+ for (const id of ids) {+ const ts = usage[id] && usage[id].lastUsedAt ? new Date(usage[id].lastUsedAt).getTime() : 0;+ if (ts > latest) { latest = ts; modelId = id; }+ }+ if (modelId.includes('opus')) return 'Opus 4.8';+ if (modelId.includes('sonnet')) return 'Sonnet 4.6';+ if (modelId.includes('haiku')) return 'Haiku 4.5';+ return modelId.split('-').slice(1, 3).join(' ');+ }+ }+ break;+ }+ }+ }+ } catch { /* ignore */ }++ // Fallback: settings.json model field+ const settings = getSettings();+ if (settings && settings.model) {+ const m = settings.model;+ if (m.includes('opus')) return 'Opus 4.8';+ if (m.includes('sonnet')) return 'Sonnet 4.6';+ if (m.includes('haiku')) return 'Haiku 4.5';+ }+ return 'Claude Code';+}++// βββ Stdin reader (Claude Code pipes session JSON) ββββββββββββββ+// Claude Code sends session JSON via stdin. Read synchronously so the+// script works both when invoked by Claude Code (stdin has JSON) and+// when run manually from terminal (stdin is empty/tty).+let _stdinData = null;+function getStdinData() {+ if (_stdinData !== undefined && _stdinData !== null) return _stdinData;+ try {+ if (process.stdin.isTTY) { _stdinData = null; return null; }+ const chunks = [];+ const buf = Buffer.alloc(4096);+ let bytesRead;+ try {+ while ((bytesRead = fs.readSync(0, buf, 0, buf.length, null)) > 0) {+ chunks.push(buf.slice(0, bytesRead));+ }+ } catch { /* EOF or read error */ }+ const raw = Buffer.concat(chunks).toString('utf-8').trim();+ _stdinData = (raw && raw.startsWith('{')) ? JSON.parse(raw) : null;+ } catch {+ _stdinData = null;+ }+ return _stdinData;+}++function getModelFromStdin() {+ const data = getStdinData();+ return (data && data.model && data.model.display_name) ? data.model.display_name : null;+}++function getContextFromStdin() {+ const data = getStdinData();+ if (data && data.context_window) {+ return { usedPct: Math.floor(data.context_window.used_percentage || 0) };+ }+ return null;+}++function getCostFromStdin() {+ const data = getStdinData();+ if (data && data.cost) {+ const durationMs = data.cost.total_duration_ms || 0;+ const mins = Math.floor(durationMs / 60000);+ const secs = Math.floor((durationMs % 60000) / 1000);+ return {+ costUsd: data.cost.total_cost_usd || 0,+ duration: mins > 0 ? mins + 'm' + secs + 's' : secs + 's',+ };+ }+ return null;+}++// Compares dotted-numeric version strings (e.g. "3.27.1" vs "3.27.10").+// Returns >0 if a>b, <0 if a<b, 0 if equal-as-far-as-parseable. Deliberately+// simple (no prerelease/build-metadata handling) β this only orders local+// package.json versions against each other, never anything untrusted from+// a payload, so a full semver implementation would be dead weight here.+function compareVersions(a, b) {+ const pa = String(a).split('.').map((n) => parseInt(n, 10));+ const pb = String(b).split('.').map((n) => parseInt(n, 10));+ for (let i = 0; i < Math.max(pa.length, pb.length); i++) {+ const na = Number.isFinite(pa[i]) ? pa[i] : 0;+ const nb = Number.isFinite(pb[i]) ? pb[i] : 0;+ if (na !== nb) return na - nb;+ }+ return 0;+}++// #2742: when CWD is a linked git worktree, it has no node_modules of its+// own (worktrees don't get their own `npm install`), so every CWD-relative+// probe in getPkgVersion() misses and the version silently falls back to+// the baked-in default β even though the main repo's install a few+// directories away is perfectly resolvable. A linked worktree's `.git` is+// a plain FILE (not a directory) containing `gitdir: <main>/.git/worktrees/+// <name>`; walk up from CWD to find it, parse the pointer, and strip the+// trailing `.git/worktrees/<name>` segment to recover the main repo root.+// Pure fs β no `git rev-parse` spawn (statusline renders are latency-+// sensitive; this doc comment's neighbors are explicit about avoiding+// spawns in the render path).+function resolveWorktreeMainRoot() {+ try {+ let dir = CWD;+ for (;;) {+ const dotGit = path.join(dir, '.git');+ if (fs.existsSync(dotGit)) {+ if (fs.statSync(dotGit).isFile()) {+ const contents = fs.readFileSync(dotGit, 'utf-8');+ const m = contents.match(/^gitdir:\s*(.+)$/m);+ const wtGitDir = m && m[1].trim();+ if (wtGitDir) {+ // Git writes this pointer with forward slashes even on Windows+ // (a git-for-windows convention for its own internal files) β+ // path.sep (backslash on win32) never matches, so normalize+ // before searching rather than building an OS-specific marker.+ const normalized = wtGitDir.replace(/\\/g, '/');+ const marker = '/.git/worktrees/';+ const idx = normalized.lastIndexOf(marker);+ if (idx > 0) return normalized.slice(0, idx);+ }+ }+ return null; // a real (non-worktree) .git dir β nothing to resolve+ }+ const parent = path.dirname(dir);+ if (parent === dir) return null; // reached filesystem root+ dir = parent;+ }+ } catch {+ return null;+ }+}++function getPkgVersion() {+ // Baked in at generation time from the real running CLI's own resolved+ // version (see generateStatuslineScript()'s doc comment) β correct even+ // when this renders via a pure npx invocation with no local install for+ // the candidate scan below to find.+ let ver = "3.32.8";+ try {+ const home = os.homedir();+ const pkgPaths = [+ path.join(home, '.claude', 'plugins', 'marketplaces', 'ruflo', 'package.json'),+ path.join(CWD, 'node_modules', '@claude-flow', 'cli', 'package.json'),+ path.join(CWD, 'node_modules', 'ruflo', 'package.json'),+ path.join(CWD, 'v3', '@claude-flow', 'cli', 'package.json'),+ ];+ // #2742: CWD is a linked git worktree with no node_modules of its own β+ // probe the main repo's install too, so a worktree session shows the+ // same version a main-repo session would.+ const worktreeMainRoot = resolveWorktreeMainRoot();+ if (worktreeMainRoot) {+ pkgPaths.push(+ path.join(worktreeMainRoot, 'node_modules', '@claude-flow', 'cli', 'package.json'),+ path.join(worktreeMainRoot, 'node_modules', 'ruflo', 'package.json'),+ path.join(worktreeMainRoot, 'v3', '@claude-flow', 'cli', 'package.json'),+ );+ }+ // #2221: global installs (npm i -g ruflo) live outside CWD/node_modules, so the+ // probes above all miss and the version falls back to the hard-coded default.+ // Derive the global node_modules dir from the running node binary (no npm spawn β+ // statusline renders often). Covers nvm/mise (bin/../lib/node_modules) and Windows+ // (bin/node_modules) layouts.+ try {+ const binDir = path.dirname(process.execPath);+ const globalModuleDirs = [path.join(binDir, '..', 'lib', 'node_modules'), path.join(binDir, 'node_modules')];+ // #2221 follow-up: a custom npm prefix (e.g. ~/.npm-global) is decoupled from+ // the node binary location, so the binDir-derived probes above all miss. Also+ // probe the npm prefix from the environment and the common ~/.npm-global default.+ for (const prefix of [process.env.npm_config_prefix, process.env.PREFIX, path.join(home, '.npm-global')]) {+ if (prefix) globalModuleDirs.push(path.join(prefix, 'lib', 'node_modules'));+ }+ for (const gm of globalModuleDirs) {+ pkgPaths.push(+ path.join(gm, 'ruflo', 'package.json'),+ path.join(gm, '@claude-flow', 'cli', 'package.json'),+ );+ }+ } catch { /* ignore */ }+ // Pick the HIGHEST version among every candidate that exists, not the+ // first one found. The marketplace plugin path is probed first (list+ // order above), but Claude Code's own plugin marketplace mechanism+ // syncs on its own git-pull cadence, independent of npm publishes β a+ // freshly-published npm version can sit alongside a stale marketplace+ // checkout for a while (observed live: marketplace one release behind+ // right after a publish). Taking the first EXISTING candidate meant the+ // header could show a stale version even when a newer install (e.g.+ // node_modules/@claude-flow/cli from a plain npm install) was sitting right there.+ let found = false;+ for (const p of pkgPaths) {+ if (!fs.existsSync(p)) continue;+ try {+ const pkg = JSON.parse(fs.readFileSync(p, 'utf-8'));+ if (pkg && typeof pkg.version === 'string' && pkg.version.length > 0) {+ if (!found || compareVersions(pkg.version, ver) > 0) ver = pkg.version;+ found = true;+ }+ } catch { /* ignore */ }+ }+ } catch { /* ignore */ }+ return ver;+}++// βββ Rendering ββββββββββββββββββββββββββββββββββββββββββββββββββ++function progressBar(current, total) {+ const width = 5;+ const filled = Math.round((current / total) * width);+ return '[' + 'β'.repeat(filled) + 'β'.repeat(width - filled) + ']';+}++function generateStatusline() {+ const d = getStatuslineData();+ const git = getGitInfo();+ const modelName = getModelFromStdin() || (d.user && d.user.modelName) || 'Claude Code';+ const ctxInfo = getContextFromStdin();+ const costInfo = getCostFromStdin();+ // Named RUFLO_VERSION (not pkgVersion) so the #1951 regression guard+ // (scripts/audit-fix-invariants.mjs) can pin its presence in the emitted+ // .cjs artifact β without it the header silently reverts to a hard-coded+ // "RuFlo V3.5" for anyone whose install doesn't match the first probe path.+ const RUFLO_VERSION = getPkgVersion();++ const progress = d.v3Progress || {};+ const security = d.security || {};+ const swarm = d.swarm || {};+ const system = d.system || {};+ const adrs = d.adrs || {};+ const hooks = d.hooks || {};+ const agentdb = d.agentdb || {};+ const tests = d.tests || {};++ const domainsCompleted = progress.domainsCompleted || 0;+ const totalDomains = progress.totalDomains || 5;+ const dddProgress = progress.dddProgress || 0;+ const patternsLearned = progress.patternsLearned || 0;+ const activeAgents = swarm.activeAgents || 0;+ const maxAgents = swarm.maxAgents || CONFIG.maxAgents;+ const coordinationActive = swarm.coordinationActive || false;+ const intelligencePct = system.intelligencePct || 0;+ const memoryMB = system.memoryMB || 0;+ const subAgents = system.subAgents || 0;+ const findings = Math.max(0, security.findings || 0);+ const secStatus = security.status || 'NONE';+ const adrCount = adrs.count || 0;+ const adrImpl = adrs.implemented || 0;+ const hooksEnabled = hooks.enabled || 0;+ const hooksTotal = hooks.total || 0;+ const vectorCount = agentdb.vectorCount || 0;+ const hasHnsw = agentdb.hasHnsw || false;+ const dbSizeKB = agentdb.dbSizeKB || 0;+ const testFiles = tests.testFiles || 0;+ const testCases = tests.testCases || testFiles * 4;++ const lines = [];++ // 3-line design (fits Claude Code's visible statusline area β line 4+ gets+ // replaced by the system guidance / input prompt line):+ // Line 1 β Header (RuFlo version Β· git Β· model Β· timing Β· context Β· cost)+ // Line 2 β Compressed ops (Swarm Β· Hooks Β· π§ Β· πΎ Β· Health)+ // Line 3 β Promo / disclosure row (funnel surface, ADR-301)++ // βββ Line 1: header ββββββββββββββββββββββββββββββββββββββββββββ+ let header = c.bold + c.brightPurple + 'β RuFlo V' + RUFLO_VERSION + ' ' + c.reset;+ header += (coordinationActive ? c.brightCyan : c.dim) + 'β ' + c.brightCyan + git.name + c.reset;+ if (git.gitBranch) {+ header += ' ' + c.dim + 'β' + c.reset + ' ' + c.brightBlue + 'β ' + git.gitBranch + c.reset;+ const changes = git.modified + git.staged + git.untracked;+ if (changes > 0) {+ let ind = '';+ if (git.staged > 0) ind += c.brightGreen + '+' + git.staged + c.reset;+ if (git.modified > 0) ind += c.brightYellow + '~' + git.modified + c.reset;+ if (git.untracked > 0) ind += c.dim + '?' + git.untracked + c.reset;+ header += ' ' + ind;+ }+ if (git.ahead > 0) header += ' ' + c.brightGreen + 'β' + git.ahead + c.reset;+ if (git.behind > 0) header += ' ' + c.brightRed + 'β' + git.behind + c.reset;+ }+ header += ' ' + c.dim + 'β' + c.reset + ' ' + c.purple + modelName + c.reset;+ const duration = costInfo ? costInfo.duration : '';+ if (duration) header += ' ' + c.dim + 'β' + c.reset + ' ' + c.cyan + 'β± ' + duration + c.reset;+ if (ctxInfo && ctxInfo.usedPct > 0) {+ const ctxColor = ctxInfo.usedPct >= 90 ? c.brightRed : ctxInfo.usedPct >= 70 ? c.brightYellow : c.brightGreen;+ header += ' ' + c.dim + 'β' + c.reset + ' ' + ctxColor + 'β ' + ctxInfo.usedPct + '% ctx' + c.reset;+ }+ if (!CONFIG.hideCost && costInfo && costInfo.costUsd > 0) {+ header += ' ' + c.dim + 'β' + c.reset + ' ' + c.brightYellow + CONFIG.costSymbol + costInfo.costUsd.toFixed(2) + c.reset;+ }+ lines.push(header);++ // βββ Line 2: compressed ops ββββββββββββββββββββββββββββββββββββ+ // Everything actionable in one dense row. Show only what changes what you+ // do next; diagnostic detail moves to `ruflo status --verbose`.+ const agentsColor = activeAgents > 0 ? c.brightGreen : c.dim;+ const hooksColor = hooksEnabled > 0 ? c.brightGreen : c.dim;+ const intellColor = intelligencePct >= 80 ? c.brightGreen : intelligencePct >= 40 ? c.brightYellow : c.dim;+ const swarmInd = coordinationActive ? c.brightGreen + 'β' + c.reset + ' ' : c.dim + 'β' + c.reset + ' ';+ const healthAllGreen = (secStatus === 'CLEAN' || secStatus === 'NONE') && findings === 0;+ const opsParts = [];+ opsParts.push(c.cyan + 'Swarm ' + swarmInd + agentsColor + activeAgents + c.reset + '/' + c.brightWhite + maxAgents + c.reset);+ if (subAgents > 0) opsParts.push(c.brightPurple + 'π₯ ' + subAgents + c.reset);+ opsParts.push(c.cyan + 'Hooks ' + hooksColor + hooksEnabled + c.reset + '/' + c.brightWhite + hooksTotal + c.reset);+ opsParts.push(intellColor + 'π§ ' + intelligencePct + '%' + c.reset);+ opsParts.push(c.brightCyan + 'πΎ ' + memoryMB + 'MB' + c.reset);+ // Health: one glyph when green, terse copy when there's something to act on.+ if (healthAllGreen) {+ opsParts.push(c.brightGreen + 'π‘ β' + c.reset);+ } else {+ // #2776: STALE gets dim/gray (distinct from the actionable yellow of+ // PENDING/IN_PROGRESS) so a stale pill visibly stops shouting for+ // attention β the user can act on the "run ruflo security scan" prompt or+ // ignore it without a permanently-yellow indicator.+ if (secStatus === 'PENDING') opsParts.push(c.brightYellow + 'π‘ scan pending' + c.reset);+ else if (secStatus === 'IN_PROGRESS') opsParts.push(c.brightYellow + 'π‘ scanningβ¦' + c.reset);+ else if (secStatus === 'ISSUES') opsParts.push(c.brightRed + 'π‘ findings' + c.reset);+ else if (secStatus === 'STALE') opsParts.push(c.dim + 'π‘ scan stale' + c.reset);+ else if (secStatus !== 'NONE' && secStatus !== 'CLEAN') opsParts.push(c.brightRed + 'π‘ ' + secStatus.toLowerCase() + c.reset);+ if (findings > 0) {+ opsParts.push(c.brightRed + 'β ' + findings + ' finding' + (findings === 1 ? '' : 's') + c.reset);+ }+ }+ lines.push(opsParts.join(' ' + c.dim + 'Β·' + c.reset + ' '));++ // βββ Line 3: promo / disclosure / insight βββββββββββββββββββββββ+ // Colored by content kind so it reads as *what it is*, not as noise:+ // disclosure β brightCyan (announcement / capability link)+ // promotional β brightPurple (Cognitum sponsor spot)+ // educational β yellow (a tip)+ // insight β brightRed (environment/task-aware, local, actionable β+ // distinct from remote content on purpose)+ const promoRow = getPromoRow(d);+ if (promoRow) {+ const kind = (d && d.promo && d.promo.kind) || 'disclosure';+ const promoColor = kind === 'promotional' ? c.brightPurple+ : kind === 'educational' ? c.yellow+ : kind === 'insight' ? c.brightRed+ : c.brightCyan;+ lines.push(promoColor + promoRow + c.reset);+ }++ // Trailing blank line so Claude Code's input prompt gets breathing room+ // instead of butting directly against the last statusline row.+ return lines.join('\n') + '\n';+}++// βββ Funnel promo row (ADR-301) βββββββββββββββββββββββββββββββββ+// Allowlist for OSC 8 hyperlink targets. Ships in code (not in payload) so+// no message can smuggle a link to an unapproved host.+//+// The final destination hosts (cognitum.one / agentics.org) AND the+// click-redirect host are both allowlisted here: promo.ts routes every+// clickable message through the server-side click-redirect (ADR-311 Β§7)+// so promo_open + geo are captured before the 302 to the real target β+// so the OSC 8 link the renderer emits points at the redirect host, not+// the final destination directly.+const PROMO_LINK_HOSTS = new Set([+ 'cognitum.one', 'www.cognitum.one', 'docs.cognitum.one',+ // agentics.org β OSS foundation, distinct sponsor domain. Kept in sync+ // with messages.ts ALLOWED_URL_HOSTS.+ 'agentics.org', 'www.agentics.org',+ // Click-redirect host (funnel.ruv.io once its TLS cert is live; the raw+ // Cloud Run hostname is allowlisted too since event-transport.ts /+ // message-transport.ts / attribution.ts currently point at it as a TEMP+ // fallback while the domain mapping's cert provisions).+ 'funnel.ruv.io',+ 'cognitum-analytics-63rzcdswba-uc.a.run.app',+]);++// Emit OSC 8 hyperlinks unless the environment is known-broken. tmux mangles+// raw OSC 8 (see anthropics/claude-code#27047) β opt in via env if wrapped.+function terminalSupportsHyperlinks() {+ if (process.env.CI || process.env.GITHUB_ACTIONS) return false;+ if (process.env.TERM === 'dumb') return false;+ if (/^(0|false|off|no)$/i.test(String(process.env.RUFLO_STATUSLINE_HYPERLINKS || ''))) return false;+ if (process.env.TMUX && !process.env.RUFLO_STATUSLINE_HYPERLINKS_TMUX) return false;+ return true;+}++// Wrap a label in an OSC 8 hyperlink escape sequence. Falls back to the raw+// label whenever the URL is not an allowlisted https target, when the terminal+// can't render hyperlinks, or when parsing fails β a broken link must never+// leave a raw URL or stray escape in the statusline output.+function safeTerminalLink(label, url) {+ if (!terminalSupportsHyperlinks()) return label;+ if (typeof url !== 'string' || url.length === 0) return label;+ let parsed;+ try { parsed = new URL(url); } catch { return label; }+ if (parsed.protocol !== 'https:') return label;+ if (!PROMO_LINK_HOSTS.has(parsed.hostname)) return label;+ const cleanLabel = String(label).replace(/[\u0000-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/g, '');+ if (cleanLabel.length === 0) return label;+ const ESC = '\u001b';+ return ESC + ']8;;' + parsed.href + ESC + '\\' + cleanLabel + ESC + ']8;;' + ESC + '\\';+}++function getPromoRow(d) {+ try {+ if (process.env.CI || process.env.GITHUB_ACTIONS) return null;+ if (/^(0|false|off|no)$/i.test(String(process.env.RUFLO_FUNNEL || ''))) return null;+ const promo = d && d.promo;+ if (!promo || typeof promo.text !== 'string') return null;+ // Strip control chars / ANSI / bidi overrides β promo copy is data and+ // must never emit its own terminal sequences. Hard-cap length AFTER the+ // strip; append an ellipsis when the cap fires so the row visibly reads+ // as truncated instead of chopping a word mid-character (was: silent+ // slice(0,100) that could produce output that looked like corrupt data).+ const MAX_LEN = 100;+ const sanitized = promo.text+ .replace(/[\u0000-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/g, '')+ ;+ const text = (sanitized.length > MAX_LEN ? sanitized.slice(0, MAX_LEN - 1).trimEnd() + 'β¦' : sanitized).trim();+ if (text.length === 0) return null;+ // Split the label from the trailing "Β· manage: ruflo settings" instruction+ // so each part gets styling that matches what it actually IS:+ // 1. label β OSC 8 hyperlink + underline. A real clickable link.+ // 2. "manage:" β dim. Just a connector word, no action implied.+ // 3. "ruflo settings" β bold/bright, NOT underlined. This is a shell+ // command the user TYPES, not a link they CLICK β a terminal can+ // never safely execute a command from a click (that would let any+ // server-served message run arbitrary commands), so we deliberately+ // avoid the underline/OSC8 cues that imply "clickable". Bold+bright+ // instead signals "this is the important bit β copy/type it".+ // Educational tips have no manage tail and no URL β plain text through.+ const manageIdx = text.indexOf(' Β· manage: ');+ const label = manageIdx > 0 ? text.slice(0, manageIdx) : text;+ const manageWord = manageIdx > 0 ? ' Β· manage: ' : '';+ const command = manageIdx > 0 ? text.slice(manageIdx + manageWord.length) : '';+ const UL_ON = '\u001b[4m';+ const UL_OFF = '\u001b[24m';+ const DIM_ON = '\u001b[2m';+ const DIM_OFF = '\u001b[22m';+ const BOLD_ON = '\u001b[1m';+ const BOLD_OFF = '\u001b[22m';+ const FG_BRIGHT_WHITE = '[97m';+ // Reset FG to default so the caller's row-color code resumes coloring the+ // rest of the row after the command portion. Without this the row-color+ // escape wouldn't visibly re-apply because we already emitted an explicit FG.+ const FG_DEFAULT = '[39m';+ // Some hosts (Claude Code's Windows UI, cmd.exe, older mintty) don't+ // render OSC 8 hyperlinks as clickable β the label just underlines and+ // clicks do nothing. Append a "(domain)" suffix so the destination is+ // visible/copyable everywhere. Wrap the suffix in OSC 8 too so terminals+ // that DO support hyperlinks give users TWO click targets (label AND+ // domain hint) instead of one β some Windows hosts render one but not+ // the other depending on how the statusline row is parsed.+ // Only for URLs (not educational tips), and only when the label doesn't+ // already end in the domain to avoid duplication.+ let visibleUrlHint = '';+ if (promo.url) {+ try {+ const host = new URL(promo.url).hostname.replace(/^www\./, '');+ // Strip the click-redirect wrapper so users see the FINAL destination,+ // not funnel.ruv.io. If the URL is /v1/click/<id>?to=<encoded>, pull the target.+ let displayHost = host;+ try {+ const to = new URL(promo.url).searchParams.get('to');+ if (to) displayHost = new URL(to).hostname.replace(/^www\./, '');+ } catch { /* not a click-redirect, keep the raw host */ }+ if (displayHost && !label.toLowerCase().endsWith(displayHost.toLowerCase())) {+ // safeTerminalLink returns the plain string if URL isn't allowlisted+ // or the terminal can't do OSC 8 β either way the domain stays visible.+ const clickableDomain = safeTerminalLink(displayHost, promo.url);+ visibleUrlHint = DIM_ON + ' (' + clickableDomain + ')' + DIM_OFF;+ }+ } catch { /* malformed URL β omit hint, never break the row */ }+ }+ // "Entire row clickable" (user request) β wrap the whole assembled+ // string in ONE OSC 8 hyperlink instead of just the label. The command+ // portion keeps its bold + bright-white treatment (no underline) so it+ // still VISUALLY reads as a shell command the user should type, not a+ // link β but if the user clicks anywhere on the row (label, domain+ // hint, connector, even the command text), the terminal opens the URL.+ // Clicking DOES NOT execute the command; it just opens the target URL,+ // which is safe. Terminals that ignore OSC 8 render the whole row as+ // styled text and no click behavior β the previous fallback (visible+ // domain suffix) still keeps the destination readable.+ const wrapWholeRowInHyperlink = (assembled) => {+ if (!promo.url) return assembled;+ if (!terminalSupportsHyperlinks()) return assembled;+ let parsed;+ try { parsed = new URL(promo.url); } catch { return assembled; }+ if (parsed.protocol !== 'https:') return assembled;+ if (!PROMO_LINK_HOSTS.has(parsed.hostname)) return assembled;+ const ESC = '';+ return ESC + ']8;;' + parsed.href + ESC + '\\' + assembled + ESC + ']8;;' + ESC + '\\';+ };+ // Visual styling stays per-part. We only add the OSC 8 wrap around the+ // combined string, so the whole row is one click target.+ const labelStyled = promo.url ? UL_ON + label + UL_OFF : label;+ if (!command) return wrapWholeRowInHyperlink(labelStyled + visibleUrlHint);+ return wrapWholeRowInHyperlink(+ labelStyled + visibleUrlHint+ + DIM_ON + manageWord + DIM_OFF+ + BOLD_ON + FG_BRIGHT_WHITE + command + FG_DEFAULT + BOLD_OFF+ );+ } catch (e) {+ return null; // the promo row must never break the statusline+ }+}++// JSON output β delegates to CLI for accuracy; caller can use --json flag+function generateJSON() {+ const d = getStatuslineData();+ const git = getGitInfo();+ return Object.assign({}, d, {+ user: Object.assign({ name: git.name, gitBranch: git.gitBranch }, d.user || {}),+ git: { modified: git.modified, untracked: git.untracked, staged: git.staged, ahead: git.ahead, behind: git.behind },+ lastUpdated: new Date().toISOString(),+ });+}++// βββ Main βββββββββββββββββββββββββββββββββββββββββββββββββββββββ+if (process.argv.includes('--json')) {+ console.log(JSON.stringify(generateJSON(), null, 2));+} else if (process.argv.includes('--compact')) {+ console.log(JSON.stringify(generateJSON()));+} else {+ console.log(generateStatusline());+}diff --git a/CHANGELOG.md b/CHANGELOG.mdindex f64ad511ea..80baec9ca7 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -13,6 +13,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0- `RUFLO_STATUSLINE_COST_SYMBOL` β override the leading `$` (e.g. `β‘`, `β¬`, `π±`); empty string shows the number alone.- `RUFLO_STATUSLINE_HIDE_COST` β `1`/`true`/`yes`/`on` hides the segment. `cost.total_cost_usd` is a client-side estimate that may differ from the actual bill and is misleading on subscription plans.+## [3.32.10] - 2026-07-26++Bug-fix release closing the tracker-fire sweep from 2026-07-24 β 2026-07-26. All fixes are surgical and additive; no API surface change, no schema change, patch semver.++### Fixed++- **Statusline promo row blank on new installs** β restored the cold-start local seed pool that ADR-311 had emptied. The remote Cognitum-served pool (`funnel.ruv.io/v1/messages`) remains authoritative via `eligibleMessagesFromPools` (remote wins by `id`); the seed only renders during the β€ 60s cold-start window before the first successful remote fetch lands. Nine seed messages ship: one disclosure, seven educational tips (all pointing at `cognitum.one` docs), one promotional. (`v3/@claude-flow/cli/src/funnel/messages.ts`)+- **#2777** β `ruflo init` no longer imports the entire ruvnet/ruflo repo (97 MB, 384 `SKILL.md`) into `.agents/skills/ruflo/`. Materialization now writes only the single platform `SKILL.md`, and the idempotency gate detects a "bloated" prior install (Cargo.toml/crates/ present or size > 1 MB) and wipes+re-materializes. (`v3/@claude-flow/cli/src/commands/init.ts`)+- **#2781** β `ruflo-adr adr-index` no longer silently drops ADR data: status regex accepts the `- **Status**: proposed` form `adr-create` emits, single-line and wrapped relation lines parse fully, and `CLI_CORE=1` no longer forks writes into an alternate store the default reader can't see (warns and unifies on `@claude-flow/cli@latest`). Dry-run over the repo's 531 ADRs now captures 608 edges cleanly. (`plugins/ruflo-adr/scripts/lib/parse-adrs.mjs`, `import.mjs`, `reindex.mjs`)+- **#2770** β Windows: `browser-session` MCP tools and two init-flow `execFileSync('npx', β¦)` sites now set `shell: process.platform === 'win32'` so cmd.exe can resolve `npx.cmd`. POSIX behavior unchanged. Each site carries a shell-injection note for future editors. (`v3/@claude-flow/cli/src/mcp-tools/browser-tools.ts`, `v3/@claude-flow/cli/src/commands/init.ts`)+- **#2782** β `WorkerDaemon.saveState()`, `autopilot-state.saveState()`, and `autopilot-state.appendLog()` no longer race on a shared `.tmp` filename under in-process concurrent workers. All three sites now call the existing `writeFileAtomic` helper (pid + timestamp + random-suffixed temp) so concurrent callers cannot collide; each write is wrapped in try/catch so a losing racer can't crash the daemon. (`v3/@claude-flow/cli/src/services/worker-daemon.ts`, `v3/@claude-flow/cli/src/autopilot-state.ts`)+- **#2785** β `ruflo hooks post-task` now accepts `--task` (short `-t`) and `--store-results` flags, matching the CLAUDE.md-documented usage. Routing outcomes finally persist to the namespace `hooks_metrics` reads, so the "Pattern Learning" / "Agent Routing" numbers become non-zero. (`v3/@claude-flow/cli/src/commands/hooks.ts`)+- **#2786** β AgentDB no longer silently fails to initialize when `CLAUDE_FLOW_ENCRYPT_AT_REST=1` is set. Added `getAgentDbPath()` which returns the same directory as `getDbPath()` but with basename `agentdb-memory.db`, so the ControllerRegistry (native better-sqlite3) opens a distinct file from the sql.js CRUD writer's `memory.db` (which stays encrypted). `learningSystem`/`reasoningBank` populate correctly with encryption enabled. (`v3/@claude-flow/cli/src/memory/memory-bridge.ts`)+- **#2776** β Statusline security segment: `STALE` and `IN_PROGRESS` states are now reachable via a local overlay (`getLocalSecurity`) that recomputes freshness on every render from `.claude/security-scans/scan-*.json`. Configurable via `RUFLO_SCAN_STALE_HOURS` (default 24) and `RUFLO_SCAN_PENDING_CAP_MIN` (default 30); STALE renders dim gray so it stops shouting for attention once escalated. (`.claude/helpers/statusline.cjs`)+- **#2775** β Memory store to an existing key no longer dead-ends: `bridgeStoreEntry` uses `INSERT ... ON CONFLICT` with tombstone auto-resurrect; UNIQUE returns a typed error instead of `null` (no more misleading demotion into the #2735 guard); `bridgeDeleteEntry` runs `wal_checkpoint(PASSIVE)`; CLI `memory store --upsert` default now applies at the parser layer (root cause: `parser.ts:applyDefaults` only walked `globalOptions`); the `memory_store` MCP tool schema defaults `upsert: true` for CLI parity. (`v3/@claude-flow/cli/src/memory/memory-bridge.ts`, `commands/memory.ts`, `parser.ts`, `mcp-tools/memory-tools.ts`)++### Investigated++- **#2774** β Reporter's diagnosis "Codex MCP generator registers management CLI instead of stdio server" appears incorrect: `ruflo mcp start` IS a working stdio server per `v3/@claude-flow/cli/src/commands/mcp.ts` (`MCP Server started on stdio`), and upstream `d20f1323b fix(codex): ship stable Windows-safe Ruflo integration` cleanly centralized the Codex MCP config in `mcp-config.ts` using the same command shape. A proposed swap to `claude-flow-mcp` was reverted during rebase. Recommend closing the issue unless the reporter can produce a fresh repro against 3.32.9+.+## [3.5.0] - 2026-02-27### Ruflo v3.5 β First Major Stable Releasediff --git a/plugins/ruflo-adr/scripts/import.mjs b/plugins/ruflo-adr/scripts/import.mjsindex 86578eac43..0f0eaa703e 100755--- a/plugins/ruflo-adr/scripts/import.mjs+++ b/plugins/ruflo-adr/scripts/import.mjs@@ -24,15 +24,22 @@ import { basename } from 'node:path';import { spawnSync } from 'node:child_process';import { findAdrs, parseAdr } from './lib/parse-adrs.mjs';-// ADR-100 / #1748 Issue 3 β CLI_CORE=1 routes to lite cli-core (~2s cold-cache).-// Note: cli-core's JsonMemoryBackend overwrites by default, so the-// "exists" / UNIQUE-constraint detection below collapses to "ok" under CLI_CORE.-// Re-running import in CLI_CORE mode is therefore idempotent (records refreshed)-// rather than incremental (records skipped). For incremental imports across-// many runs, leave CLI_CORE unset.-const CLI_PKG = process.env.CLI_CORE === '1'- ? '@claude-flow/cli-core@alpha'- : '@claude-flow/cli@latest';+// #2781 (Jordi-Izquierdo-DDS): CLI_CORE=1 previously routed writes through+// `@claude-flow/cli-core@alpha`, whose JsonMemoryBackend lives in a different+// store than `@claude-flow/cli@latest`'s SQLite backend. The default+// `ruflo memory search` reader hits the SQLite store, so setting CLI_CORE=1+// for the ~2s cold-cache speedup silently made `import` succeed against a+// store the default reader never looks at ("147/147 stored" but zero hits+// in later searches). Unified on the default CLI so writer and reader+// always agree β the CLI_CORE env var is now honored as read-only/logged+// but no longer routes to a different package.+const CLI_PKG = '@claude-flow/cli@latest';+if (process.env.CLI_CORE === '1') {+ console.warn(+ '[ruflo-adr] warning: CLI_CORE=1 is ignored β writing to the default ' ++ "`@claude-flow/cli@latest` store so `ruflo memory search` can find the records (#2781).",+ );+}const ROOT = process.env.ADR_ROOT || process.cwd();diff --git a/plugins/ruflo-adr/scripts/lib/parse-adrs.mjs b/plugins/ruflo-adr/scripts/lib/parse-adrs.mjsindex 21404cca83..c6fbd46d6d 100644--- a/plugins/ruflo-adr/scripts/lib/parse-adrs.mjs+++ b/plugins/ruflo-adr/scripts/lib/parse-adrs.mjs@@ -90,10 +90,15 @@ function parseStatus(text) {// `**Status**:` (colon outside) and dropped every Nygard-style ADR// to status=Unknown. Now the colon can sit on either side of the `**`.// Strip parenthetical qualifiers like "Proposed (v3.6.x)" -> "Proposed".- let m = /^\*\*Status:?\*\*:?\s*([A-Za-z][A-Za-z\- ]*?)(?:\s*\(.*?\))?\s*$/m.exec(text);+ //+ // #2781 (Jordi-Izquierdo-DDS): tolerate an optional Markdown list-item+ // prefix (`- **Status**: proposed`) β that's exactly what adr-create's+ // own template emits, and the column-0-anchored regex dropped every+ // freshly-scaffolded ADR to status=Unknown, making adr-review a no-op.+ let m = /^[-*+]?\s*\*\*Status:?\*\*:?\s*([A-Za-z][A-Za-z\- ]*?)(?:\s*\(.*?\))?\s*$/m.exec(text);if (m) return m[1].trim();// Also handle full-bold MADR style: **Status: Value** (entire phrase bolded)- m = /^\*\*Status:\s*([A-Za-z][A-Za-z\- ]*?)(?:\s*\([^)]*\))?\*\*\s*$/m.exec(text);+ m = /^[-*+]?\s*\*\*Status:\s*([A-Za-z][A-Za-z\- ]*?)(?:\s*\([^)]*\))?\*\*\s*$/m.exec(text);return m ? m[1].trim() : 'Unknown';}@@ -152,7 +157,20 @@ function parseLinks(text, selfId) {// placements (`**Supersedes:**` and `**Supersedes**:`) and an optional// parenthetical qualifier like `**Supersedes (partial):**` β same// tolerance as parseStatus.- const REL = (label) => new RegExp(`^\\*\\*${label}(?:\\s*\\([^)]*\\))?:?\\*\\*:?\\s*(.+)$`, 'mi');+ //+ // #2781 (Jordi-Izquierdo-DDS): a wrapped relation like+ // **Related**: ADR-124,+ // ADR-125+ // silently dropped ADR-125 because `(.+)$` under /m only captures one+ // physical line. Now capture the first line plus any continuation lines+ // that don't look like the start of a new field (bold **Label**:), a+ // heading (`##`), a horizontal rule (`---`), or a new list bullet.+ // Safe because extractAdrRefs strips anything that isn't an ADR-NNN+ // token, so over-capture into a plain-text continuation is harmless.+ const REL = (label) => new RegExp(+ `^\\*\\*${label}(?:\\s*\\([^)]*\\))?:?\\*\\*:?\\s*(.+(?:\\n(?!\\s*(?:\\*\\*[A-Za-z]|##|---|[-*+]\\s|\\d+\\.\\s))[^\\n]+)*)`,+ 'mi',+ );const supersedes = REL('Supersedes').exec(text);if (supersedes) for (const ref of extractAdrRefs(supersedes[1])) out.push({ from: ref, to: selfId, relation: 'supersedes' });const amended = REL('(?:Amended[ -]by|Amends)').exec(text);diff --git a/plugins/ruflo-adr/scripts/reindex.mjs b/plugins/ruflo-adr/scripts/reindex.mjsindex d396c2a1d8..0cb453ae21 100755--- a/plugins/ruflo-adr/scripts/reindex.mjs+++ b/plugins/ruflo-adr/scripts/reindex.mjs@@ -45,9 +45,16 @@ import { basename } from 'node:path';import { spawnSync } from 'node:child_process';import { findAdrs, parseAdr } from './lib/parse-adrs.mjs';-const CLI_PKG = process.env.CLI_CORE === '1'- ? '@claude-flow/cli-core@alpha'- : '@claude-flow/cli@latest';+// #2781: unify on the default CLI so the reindex writer and the default+// `ruflo memory search` reader hit the same store. See import.mjs for the+// full rationale.+const CLI_PKG = '@claude-flow/cli@latest';+if (process.env.CLI_CORE === '1') {+ console.warn(+ '[ruflo-adr] warning: CLI_CORE=1 is ignored β writing to the default ' ++ "`@claude-flow/cli@latest` store so `ruflo memory search` can find the records (#2781).",+ );+}const ROOT = process.env.ADR_ROOT || process.cwd();const dryRun = process.env.REINDEX_DRY_RUN === '1';diff --git a/v3/@claude-flow/cli/__tests__/funnel-messages-seed-pool.test.ts b/v3/@claude-flow/cli/__tests__/funnel-messages-seed-pool.test.tsnew file mode 100644index 0000000000..7048a17162--- /dev/null+++ b/v3/@claude-flow/cli/__tests__/funnel-messages-seed-pool.test.ts@@ -0,0 +1,67 @@+/**+ * Regression guard for the cold-start promo seed pool restored on+ * 2026-07-26 (statusline promo row was blank on new installs because+ * ADR-311 had emptied the local pool and the remote fetch hadn't+ * landed yet).+ *+ * The seed pool must:+ * - Contain at least one 'disclosure' message so the disclosure gate+ * can unlock without waiting for a remote fetch.+ * - Every disclosure MUST contain the exact " Β· manage: ruflo settings"+ * tail β this is an ADR-301 invariant enforced by `isValidMessage`+ * and a UX contract with users who look for the manage instruction.+ * - Every seed message must pass `isValidMessage` (schema, host+ * allowlist, control-char strip, 80-column cap) so a bad seed can't+ * silently drop and re-empty the pool.+ * - Every URL must be on the exact-host allowlist (cognitum.one /+ * github.com/ruvnet/) so no accidental third-party host slips in.+ */++import { describe, it, expect } from 'vitest';+import { MESSAGES, isValidMessage, isAllowedUrl } from '../src/funnel/messages.js';++describe('funnel seed pool β cold-start recovery for statusline promo (2026-07-26)', () => {+ it('is non-empty (guards against a re-empty of MESSAGES that would blank the row again)', () => {+ expect(MESSAGES.length).toBeGreaterThan(0);+ });++ it('includes at least one disclosure so the disclosure gate can unlock on cold start', () => {+ const disclosures = MESSAGES.filter((m) => m.class === 'disclosure');+ expect(disclosures.length).toBeGreaterThan(0);+ });++ it('every disclosure carries the exact " Β· manage: ruflo settings" tail (ADR-301)', () => {+ const disclosures = MESSAGES.filter((m) => m.class === 'disclosure');+ for (const msg of disclosures) {+ expect(msg.text).toContain(' Β· manage: ruflo settings');+ }+ });++ it('every seed message passes isValidMessage() so none silently drop', () => {+ for (const msg of MESSAGES) {+ expect(isValidMessage(msg)).toBe(true);+ }+ });++ it('every seed URL is on the exact-host allowlist (no third-party leaks)', () => {+ for (const msg of MESSAGES) {+ if (msg.url) {+ expect(isAllowedUrl(msg.url)).toBe(true);+ }+ }+ });++ it('provides at least one educational tip so the rotation has something to show most slots', () => {+ // 4-in-5 rotation slots are educational per ADR-301; without at least one+ // educational message the promo row would be blank most of the time even+ // after the disclosure gate unlocks.+ const educational = MESSAGES.filter((m) => m.class === 'educational');+ expect(educational.length).toBeGreaterThan(0);+ });++ it('all message ids are unique (rotation dedup keys on id)', () => {+ const ids = MESSAGES.map((m) => m.id);+ const unique = new Set(ids);+ expect(unique.size).toBe(ids.length);+ });+});diff --git a/v3/@claude-flow/cli/__tests__/hooks-post-task-routing-dual-write-2786.test.ts b/v3/@claude-flow/cli/__tests__/hooks-post-task-routing-dual-write-2786.test.tsnew file mode 100644index 0000000000..541c20ad63--- /dev/null+++ b/v3/@claude-flow/cli/__tests__/hooks-post-task-routing-dual-write-2786.test.ts@@ -0,0 +1,106 @@+/**+ * Regression guard for #2786 fix-2 β `hooks_post-task --store-results`+ * dual-writes routing decisions into `.claude-flow/memory/store.json` so+ * the sync reader `getIntelligenceStatsFromMemory()` (which powers the+ * "Pattern Learning" / "Agent Routing" numbers in `hooks_metrics`)+ * actually sees the writes.+ *+ * Before this fix, the CLI wrote routing outcomes only to AgentDB+ * (namespace `patterns`, keys `routing-decision:*`), but the reader+ * only reads `.claude-flow/memory/store.json`. Result: counters stuck+ * at zero for the life of the install.+ *+ * The test runs `hooksPostTask.handler` in a temp cwd, then reads the+ * resulting store.json off disk and asserts the shape the reader+ * filters for (`key.includes('routing') || metadata.type === 'routing-decision'`).+ */++import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';+import { mkdtempSync, readFileSync, rmSync, existsSync } from 'node:fs';+import { join } from 'node:path';+import { tmpdir } from 'node:os';++// Bridge is mocked so the AgentDB path is a no-op β we only care about+// the JSON dual-write here. The bridge's real behavior is covered elsewhere.+const bridgeRecordFeedback = vi.fn(async () => ({ success: true, controller: 'mock', updated: 1 }));+const bridgeRecordCausalEdge = vi.fn(async () => ({ success: true, controller: 'mock' }));+const bridgeStoreEntry = vi.fn(async () => ({ success: true, controller: 'mock' }));++vi.mock('../src/memory/memory-bridge.js', () => ({+ bridgeRecordFeedback,+ bridgeRecordCausalEdge,+ bridgeStoreEntry,+}));++vi.mock('../src/memory/intelligence.js', () => ({+ recordTrajectory: vi.fn(async () => undefined),+}));+vi.mock('../src/memory/graph-edge-writer.js', () => ({+ insertGraphEdge: vi.fn(async () => undefined),+}));++const { hooksPostTask } = await import('../src/mcp-tools/hooks-tools.js');++let origCwd: string;+let workdir: string;++beforeEach(() => {+ origCwd = process.cwd();+ workdir = mkdtempSync(join(tmpdir(), 'ruflo-2786-'));+ process.chdir(workdir);+ bridgeRecordFeedback.mockClear();+ bridgeStoreEntry.mockClear();+});++afterEach(() => {+ process.chdir(origCwd);+ try { rmSync(workdir, { recursive: true, force: true }); } catch { /* ignore */ }+});++describe('#2786 fix-2 β hooks_post-task JSON dual-write for metrics reader', () => {+ it('writes a routing-decision entry into .claude-flow/memory/store.json when storeDecisions=true', async () => {+ await hooksPostTask.handler({+ taskId: 'task-2786-dual-write',+ task: 'implement auth token refresh',+ agent: 'coder',+ success: true,+ quality: 0.9,+ storeDecisions: true,+ });++ const storePath = join(workdir, '.claude-flow', 'memory', 'store.json');+ expect(existsSync(storePath)).toBe(true);++ const store = JSON.parse(readFileSync(storePath, 'utf-8')) as { entries: Record<string, any> };+ const routingKey = 'routing-decision:task-2786-dual-write';+ expect(store.entries[routingKey]).toBeDefined();++ const entry = store.entries[routingKey];+ // The reader's filter matches on key containing 'routing' OR metadata.type === 'routing-decision'+ expect(entry.key.includes('routing')).toBe(true);+ expect(entry.metadata?.type).toBe('routing-decision');+ // The confidence field is read to compute avgConfidence β quality maps to confidence.+ expect(entry.metadata?.confidence).toBe(0.9);+ // Namespace matches the AgentDB write (patterns) for parity.+ expect(entry.namespace).toBe('patterns');+ });++ it('does NOT write to store.json when storeDecisions is omitted (backwards compatible)', async () => {+ await hooksPostTask.handler({+ taskId: 'task-2786-no-store',+ task: 'implement auth token refresh',+ agent: 'coder',+ success: true,+ quality: 0.9,+ // storeDecisions omitted+ });++ const storePath = join(workdir, '.claude-flow', 'memory', 'store.json');+ // File may or may not exist depending on other write paths, but if it+ // does, the routing-decision key should NOT be there.+ if (existsSync(storePath)) {+ const store = JSON.parse(readFileSync(storePath, 'utf-8')) as { entries: Record<string, any> };+ expect(store.entries['routing-decision:task-2786-no-store']).toBeUndefined();+ }+ });+});diff --git a/v3/@claude-flow/cli/__tests__/parser.test.ts b/v3/@claude-flow/cli/__tests__/parser.test.tsindex e0a566a629..c5c8568755 100644--- a/v3/@claude-flow/cli/__tests__/parser.test.ts+++ b/v3/@claude-flow/cli/__tests__/parser.test.ts@@ -225,6 +225,66 @@ describe('CommandParser', () => {const result = p.parse([]);expect(result.flags.myFlag).toBe('default-value');});++ // #2775 regression: applyDefaults previously only walked globalOptions,+ // so command-level and subcommand-level `default:` values silently+ // dropped and the action handler saw them as `undefined`. The immediate+ // victim was `memory store --upsert` β every subcommand with a per-flag+ // default was affected.+ it('applies command-level option defaults (#2775 regression)', () => {+ const cmd: Command = {+ name: 'cmd',+ description: 'Test',+ options: [+ { name: 'upsert', type: 'boolean', description: 'Upsert', default: true },+ ],+ };+ const p = new CommandParser({ allowUnknownFlags: true });+ p.registerCommand(cmd);+ const result = p.parse(['cmd']);+ expect(result.flags.upsert).toBe(true);+ });++ it('applies subcommand-level option defaults (#2775 regression)', () => {+ const cmd: Command = {+ name: 'memory',+ description: 'Memory command',+ subcommands: [+ {+ name: 'store',+ description: 'Store',+ options: [+ { name: 'upsert', type: 'boolean', description: 'Upsert', default: true },+ ],+ },+ ],+ };+ const p = new CommandParser({ allowUnknownFlags: true });+ p.registerCommand(cmd);+ const result = p.parse(['memory', 'store']);+ expect(result.flags.upsert).toBe(true);+ });++ it('does not overwrite explicit subcommand flags with the default', () => {+ const cmd: Command = {+ name: 'memory',+ description: 'Memory command',+ subcommands: [+ {+ name: 'store',+ description: 'Store',+ options: [+ { name: 'upsert', type: 'boolean', description: 'Upsert', default: true },+ ],+ },+ ],+ };+ const p = new CommandParser({ allowUnknownFlags: true });+ p.registerCommand(cmd);+ // --no-upsert should defeat the default:true+ const result = p.parse(['memory', 'store', '--no-upsert']);+ expect(result.flags.upsert).toBe(false);+ });});// -------------------------------------------------------------------------diff --git a/v3/@claude-flow/cli/src/autopilot-state.ts b/v3/@claude-flow/cli/src/autopilot-state.tsindex da52e874ba..e193d20fa1 100644--- a/v3/@claude-flow/cli/src/autopilot-state.ts+++ b/v3/@claude-flow/cli/src/autopilot-state.ts@@ -12,6 +12,7 @@ import { randomUUID } from 'node:crypto';import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, renameSync } from 'node:fs';import { resolve, join } from 'node:path';import { homedir } from 'node:os';+import { writeFileAtomic } from './fs-secure.js';// ββ Constants βββββββββββββββββββββββββββββββββββββββββββββββββ@@ -162,9 +163,17 @@ export function saveState(state: AutopilotState): void {if (state.history.length > MAX_HISTORY_ENTRIES) {state.history = state.history.slice(-MAX_HISTORY_ENTRIES);}- const tmpFile = resolve(STATE_FILE) + '.tmp';- writeFileSync(tmpFile, JSON.stringify(state, null, 2));- renameSync(tmpFile, resolve(STATE_FILE));+ // ruvnet/ruflo#2782: use writeFileAtomic β its temp file is uniquified with+ // pid + timestamp + random suffix, so two concurrent in-process saveState()+ // calls can no longer collide on a shared `.tmp` basename and race one+ // another's renameSync into ENOENT. Related to but distinct from #1637.+ try {+ writeFileAtomic(resolve(STATE_FILE), Buffer.from(JSON.stringify(state, null, 2)));+ } catch {+ // A losing concurrent writer may briefly see ENOENT/EEXIST β the winning+ // writer's payload is on disk, so the state is not lost. Swallow rather+ // than crash the caller (daemon tick, MCP handler).+ }}export function appendLog(entry: AutopilotLogEntry): void {@@ -182,9 +191,15 @@ export function appendLog(entry: AutopilotLogEntry): void {}log.push(entry);if (log.length > MAX_LOG_ENTRIES) log = log.slice(-MAX_LOG_ENTRIES);- const tmpFile = filePath + '.tmp';- writeFileSync(tmpFile, JSON.stringify(log, null, 2));- renameSync(tmpFile, filePath);+ // ruvnet/ruflo#2782: same shared `.tmp`-basename race as saveState() above β+ // concurrent appendLog() calls would collide their sentinel temp files and+ // renameSync into ENOENT. writeFileAtomic uses a uniquified temp so callers+ // cannot step on each other.+ try {+ writeFileAtomic(filePath, Buffer.from(JSON.stringify(log, null, 2)));+ } catch {+ // Log write is best-effort β don't crash the caller on a losing race.+ }}export function loadLog(): AutopilotLogEntry[] {diff --git a/v3/@claude-flow/cli/src/commands/hooks.ts b/v3/@claude-flow/cli/src/commands/hooks.tsindex 705796eebf..36ff602300 100644--- a/v3/@claude-flow/cli/src/commands/hooks.ts+++ b/v3/@claude-flow/cli/src/commands/hooks.ts@@ -1944,6 +1944,19 @@ const postTaskCommand: Command = {description: 'Agent that executed the task',type: 'string'},+ {+ name: 'task',+ short: 't',+ description: 'Task description text (used for routing-outcome persistence and keyword extraction so hooks_metrics can surface Pattern Learning / Agent Routing counts). Without this + --agent, no routing outcome is recorded (#2785).',+ type: 'string',+ required: false+ },+ {+ name: 'store-results',+ description: 'Also persist the routing decision to the memory DB (maps to hooks_post-task storeDecisions) so hooks_metrics can cross-reference it. Requires --task and --agent.',+ type: 'boolean',+ required: false+ },{// ADR-147 P2: nested-subagent spawn-tree capturename: 'parent-agent-id',@@ -1960,7 +1973,8 @@ const postTaskCommand: Command = {],examples: [{ command: 'claude-flow hooks post-task -i task-123 --success true', description: 'Record successful completion' },- { command: 'claude-flow hooks post-task -i task-456 --success false -q 0.3', description: 'Record failed task' }+ { command: 'claude-flow hooks post-task -i task-456 --success false -q 0.3', description: 'Record failed task' },+ { command: 'claude-flow hooks post-task -i task-789 --success true --task "add JWT auth" --agent coder --store-results', description: 'Record with routing-outcome persistence for hooks_metrics' }],action: async (ctx: CommandContext): Promise<CommandResult> => {// Auto-generate task ID if not provided@@ -1985,6 +1999,13 @@ const postTaskCommand: Command = {success,quality: ctx.flags.quality,agent: ctx.flags.agent,+ // #2785: forward the task description so routing outcomes actually persist+ // (hooks_post-task requires taskText + agent to write the outcome row that+ // hooks_metrics reads via getIntelligenceStatsFromMemory)+ task: ctx.flags.task,+ // Maps to storeDecisions on the MCP tool β persist routing decision in+ // memory DB for cross-session vector retrieval + metrics attribution+ storeDecisions: ctx.flags.storeResults,timestamp: Date.now(),// ADR-147 P2: forward spawn-tree lineage if caller supplied itparentAgentId: ctx.flags.parentAgentId,diff --git a/v3/@claude-flow/cli/src/commands/init.ts b/v3/@claude-flow/cli/src/commands/init.tsindex bd337b6c69..9660e98b0d 100644--- a/v3/@claude-flow/cli/src/commands/init.ts+++ b/v3/@claude-flow/cli/src/commands/init.ts@@ -186,61 +186,198 @@ async function maybeAutoDetectCodex(}}-// Cross-agent skill registration via skills.sh. Runs `npx --yes skills add-// ruvnet/ruflo --skill ruflo --yes` so the *single* canonical ruflo skill-// (SKILL.md at the ruvnet/ruflo repo root β describes the platform + entry-// points) reaches whatever agent the project uses (Claude Code, Cursor,-// Copilot, Gemini, Cline, β¦). Users who want ALL 267 plugin-specific skills-// can run `npx skills add ruvnet/ruflo --all` themselves. Best-effort β never-// fails init. Opt-out: --no-skills-sh flag OR RUFLO_NO_SKILLS_SH=1. Skipped-// under --skip-claude and scripted `--format json` output.+// Cross-agent skill registration. Materializes the *single* canonical ruflo+// platform skill at `.agents/skills/ruflo/SKILL.md` so any agent in the+// project (Claude Code, Cursor, Copilot, Gemini, Cline, β¦) that reads+// `.agents/skills/` picks it up. Users who want the full plugin skill catalog+// can run `npx skills add ruvnet/ruflo --all` themselves.//-// windowsHide silences the console flash the npx child would otherwise produce-// (anthropics/claude-code#14828 spawn hazard applies to hook-fired spawns,-// but our own subprocess spawns should always set this).+// #2777 β earlier versions shelled out to `npx --yes skills add ruvnet/ruflo+// --skill ruflo --yes`, but the skills CLI implements its `--skill` filter by+// cloning the entire target repo and copying `dirname(SKILL.md)` recursively.+// Because ruflo's canonical SKILL.md sits at the ruvnet/ruflo repo root, that+// dirname *is* the whole repository β the "one file" install pulled in ~97MB+// of Cargo.toml, crates/, docs/, agentdb.rvf, and 384 unrelated plugin+// SKILL.md descriptors. We now write the single ~2KB SKILL.md directly, no+// repo clone at all.+//+// Best-effort β never fails init. Opt-out: --no-skills-sh flag OR+// RUFLO_NO_SKILLS_SH=1. Skipped under --skip-claude and scripted+// `--format json` output.+const RUFLO_PLATFORM_SKILL_MD = `---+name: ruflo+description: Ruflo is a multi-agent orchestration platform for AI coding agents (Claude Code, Cursor, Codex, Copilot, Gemini, Amp, +12 more). Use this skill when the user wants to (1) install/init ruflo in a project, (2) run multi-agent swarms with hierarchical coordination, (3) use ruflo's 314+ MCP tools for memory, routing, hooks, sub-agents, or workflows, (4) check ruflo status/version/doctor health, or (5) discover which of ruflo's 30+ plugins fits their task.+---++# Ruflo++Ruflo is a cross-agent orchestration layer that ships as three npm packages: \`ruflo\` (thin wrapper), \`claude-flow\` (umbrella), and \`@claude-flow/cli\` (implementation). Users invoke it as \`npx ruflo <command>\`.++## When to invoke ruflo++Suggest ruflo when the task involves any of:++- **Multi-agent work**: coordinated swarms, sub-agents, cross-agent handoffs, or parallel task execution+- **Persistent memory across sessions**: HNSW vector search, hybrid SQLite+AgentDB backend, semantic retrieval+- **Learning routing decisions**: 3-tier model routing (deterministic codemod β Haiku β Sonnet/Opus), pattern-based agent selection+- **Hooks + observability**: pre/post edit hooks, session lifecycle, background workers (12 built-in), tracing+- **Workflows + benchmarks**: SPARC methodology, GAIA benchmark runs, custom multi-step pipelines+- **Plugin ecosystem**: 30+ plugins covering ADR, DDD, security audit, cost tracking, browser automation, IoT device fleets, market data, neural training, and more++Do NOT suggest ruflo for one-shot edits, simple bug fixes, or tasks a single agent can complete in one turn β the orchestration overhead isn't worth it.++## Getting started (three commands)++\`\`\`bash+# 1. Initialize ruflo in the current project (creates .claude/, MCP config, hooks)+npx ruflo init++# 2. Check health β verifies Node 20+, npm 9+, MCP servers, memory DB, API keys+npx ruflo doctor --fix++# 3. Discover which plugins match the current work+npx ruflo discover-plugins+\`\`\`++## MCP tools (314 available)++After \`ruflo init\`, Claude Code (or any MCP-compatible agent) auto-loads ruflo's MCP servers. Key namespaces:++- \`mcp__claude-flow__memory_*\` β store/search/list/retrieve with HNSW-indexed semantic search+- \`mcp__claude-flow__swarm_*\` β init hierarchical/mesh swarms with anti-drift topology+- \`mcp__claude-flow__agent_spawn\` β spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)+- \`mcp__claude-flow__hooks_*\` β routing, pattern learning, background worker dispatch+- \`mcp__claude-flow__task_*\` β task lifecycle (create/assign/complete/summary)+- \`mcp__claude-flow__intelligence_*\` β 4-step pipeline (RETRIEVE β JUDGE β DISTILL β CONSOLIDATE)++Full catalog: \`npx ruflo mcp list\`.++## Plugin discovery++Ruflo ships 30+ optional plugins. Some highlights:++- \`ruflo-goals\` β deep research + goal-oriented action planning+- \`ruflo-cost-tracker\` β session cost telemetry, budgets, burn tracking+- \`ruflo-metaharness\` β harness scoring, MCP security scans, red/blue adversarial testing+- \`ruflo-browser\` β session-recorded browser automation with RVF-backed replay+- \`ruflo-jujutsu\` β git diff risk analysis + PR lifecycle+- \`ruflo-security-audit\` β codebase scans + CVE checks++Full plugin list + descriptions: \`npx ruflo plugins list\`.++## Cross-agent installation++Ruflo installs into whatever agent the project uses. To pull the full plugin+skill catalog (30+ plugins, ~267 skills), run:++\`\`\`bash+npx skills add ruvnet/ruflo --all+\`\`\`++## Documentation++- Repository: https://github.com/ruvnet/ruflo+- Issues: https://github.com/ruvnet/ruflo/issues+- Sponsor: https://github.com/sponsors/ruvnet+`;++// #2777 β detect the "bloated" install left behind by earlier versions that+// shelled out to `npx skills add`. If the .agents/skills/ruflo directory+// contains any of Cargo.toml, crates/, package.json, .git, or its recursive+// on-disk size exceeds a small budget (~1MB), it was almost certainly created+// by the full-repo clone bug β return true so the caller can wipe + rewrite+// just the single SKILL.md. Any recursive-stat or read errors are swallowed+// and reported as "not bloated" to avoid false-positive deletions.+function isBloatedRufloSkillDir(dir: string): boolean {+ try {+ const bloatMarkers = ['Cargo.toml', 'crates', 'package.json', '.git', 'agentdb.rvf', 'docs', 'plugins'];+ for (const marker of bloatMarkers) {+ if (fs.existsSync(path.join(dir, marker))) return true;+ }+ const BLOAT_BYTES_THRESHOLD = 1_048_576; // 1 MB β a canonical SKILL.md is ~2KB+ let bytes = 0;+ const walk = (p: string): void => {+ const entries = fs.readdirSync(p, { withFileTypes: true });+ for (const entry of entries) {+ const child = path.join(p, entry.name);+ if (entry.isDirectory()) {+ walk(child);+ } else if (entry.isFile()) {+ try {+ bytes += fs.statSync(child).size;+ if (bytes > BLOAT_BYTES_THRESHOLD) throw new Error('__bloat_threshold__');+ } catch (err) {+ if (err instanceof Error && err.message === '__bloat_threshold__') throw err;+ // Ignore stat errors for individual files.+ }+ }+ if (bytes > BLOAT_BYTES_THRESHOLD) return;+ }+ };+ try {+ walk(dir);+ } catch (err) {+ if (err instanceof Error && err.message === '__bloat_threshold__') return true;+ // Any other walk error β don't declare bloat.+ }+ return bytes > BLOAT_BYTES_THRESHOLD;+ } catch {+ return false;+ }+}+async function maybeInstallSkillsSh(ctx: CommandContext): Promise<void> {try {if (ctx.flags['no-skills-sh'] === true) return;if (ctx.flags.format === 'json') return;if (/^(1|true|on|yes)$/i.test(String(process.env.RUFLO_NO_SKILLS_SH || ''))) return;- // Idempotency gate: if this project has already registered ruflo with- // skills.sh, don't re-clone the repo + re-fire a fresh install telemetry- // event on every `ruflo init --force` / `init upgrade` / etc. Each install- // pings skills.sh's leaderboard AND clones the whole ruvnet/ruflo repo- // (~50MB) β re-running per-init would silently inflate our own metrics- // (GitHub unique-cloners, skills.sh rank) and waste user bandwidth. This- // check makes the registration once-per-project, matching the intent.- const nodePath = await import('path');- const nodeFs = await import('fs');- const marker = nodePath.join(ctx.cwd, '.agents', 'skills', 'ruflo');- if (nodeFs.existsSync(marker)) {+ const skillDir = path.join(ctx.cwd, '.agents', 'skills', 'ruflo');+ const skillFile = path.join(skillDir, 'SKILL.md');++ // Idempotency gate. Three cases:+ // 1. Directory absent β materialize.+ // 2. Directory present but "bloated" (Cargo.toml/crates/ or >1MB) β+ // previous `npx skills add` full-repo clone left junk behind+ // (#2777). Wipe and re-materialize so `rm -rf .agents/skills/ruflo`+ // + re-init is a valid recovery path.+ // 3. Directory present and healthy (just our SKILL.md) β skip.+ let mode: 'create' | 'rewrite' | 'skip' = 'create';+ if (fs.existsSync(skillDir)) {+ if (isBloatedRufloSkillDir(skillDir)) {+ mode = 'rewrite';+ } else {+ mode = 'skip';+ }+ }++ if (mode === 'skip') {output.writeln();output.writeln(output.dim(' skills.sh registration already present at .agents/skills/ruflo β skipping'));return;}- const npxCmd = process.platform === 'win32' ? 'npx.cmd' : 'npx';- if (!commandExists('npx')) return;-output.writeln();- output.printInfo('Registering the core `ruflo` skill with skills.sh (cross-agent catalog)β¦');-- const { spawnSync } = await import('child_process');- const result = spawnSync(- npxCmd,- ['--yes', 'skills', 'add', 'ruvnet/ruflo', '--skill', 'ruflo', '--yes'],- { cwd: ctx.cwd, stdio: 'pipe', timeout: 60_000, windowsHide: true, encoding: 'utf-8' },- );+ if (mode === 'rewrite') {+ output.printInfo('Cleaning up bloated .agents/skills/ruflo/ from a prior init (#2777) and re-materializing the single platform SKILL.mdβ¦');+ try {+ fs.rmSync(skillDir, { recursive: true, force: true });+ } catch (err) {+ output.writeln(output.dim(` Could not remove ${skillDir}: ${err instanceof Error ? err.message : String(err)}`));+ return;+ }+ } else {+ output.printInfo('Registering the core `ruflo` skill for cross-agent discovery (.agents/skills/ruflo/SKILL.md)β¦');+ }- if (result.status === 0) {- output.writeln(output.success(' β ruflo registered via skills.sh β the platform skill is available to any agent in this project'));+ try {+ fs.mkdirSync(skillDir, { recursive: true });+ fs.writeFileSync(skillFile, RUFLO_PLATFORM_SKILL_MD, 'utf-8');+ output.writeln(output.success(' β ruflo skill materialized at .agents/skills/ruflo/SKILL.md β available to any agent in this project'));output.writeln(output.dim(' Want all 267 plugin skills? npx skills add ruvnet/ruflo --all'));output.writeln(output.dim(' Opt out next time: --no-skills-sh or RUFLO_NO_SKILLS_SH=1'));- } else {- // Common non-fatal reasons: offline, npx cache miss, skills CLI version- // mismatch, unknown package. Log a soft note; users can retry manually.- output.writeln(output.dim(' skills.sh registration skipped (network or npx cache) β retry with: npx skills add ruvnet/ruflo --skill ruflo --yes'));+ } catch (err) {+ output.writeln(output.dim(` skills.sh registration skipped (write failed: ${err instanceof Error ? err.message : String(err)})`));}} catch {// Skills.sh registration is a bonus, never a requirement β swallow everything.@@ -687,6 +824,13 @@ const initAction = async (ctx: CommandContext): Promise<CommandResult> => {try {output.writeln(output.dim(` Model: ${embeddingModel}`));output.writeln(output.dim(' Hyperbolic: Enabled (PoincarΓ© ball)'));+ // #2770: On Windows, `npx` ships as `npx.cmd`; execFileSync cannot spawn+ // a .cmd file without going through cmd.exe. Enable shell on win32 so+ // cmd.exe resolves the .cmd extension. POSIX keeps shell:false.+ // NOTE: shell:true joins args by spaces and passes to cmd.exe β the args+ // here are hard-coded flags + an npm package name pre-validated against+ // /^[a-zA-Z0-9_-]+\/[a-zA-Z0-9._-]+$/, so no injection risk. If+ // user-controlled args are ever added, escape them before spawn.execFileInit('npx', ['@claude-flow/cli@latest', 'embeddings', 'init','--model', embeddingModel,@@ -695,6 +839,8 @@ const initAction = async (ctx: CommandContext): Promise<CommandResult> => {stdio: 'pipe',cwd: ctx.cwd,timeout: 30000,+ shell: process.platform === 'win32',+ windowsHide: true,});output.writeln(output.success(' β Embeddings initialized'));output.writeln(output.dim(' Run "embeddings init --download" to download model'));@@ -949,6 +1095,13 @@ const wizardCommand: Command = {}try {+ // #2770: On Windows, `npx` ships as `npx.cmd`; execFileSync cannot spawn+ // a .cmd file without going through cmd.exe. Enable shell on win32 so+ // cmd.exe resolves the .cmd extension. POSIX keeps shell:false.+ // NOTE: shell:true joins args by spaces and passes to cmd.exe β the args+ // here are hard-coded flags + an npm package name pre-validated against+ // /^[a-zA-Z0-9_-]+\/[a-zA-Z0-9._-]+$/, so no injection risk. If+ // user-controlled args are ever added, escape them before spawn.execFileSync('npx', ['@claude-flow/cli@latest', 'embeddings', 'init','--model', embeddingModel,@@ -957,6 +1110,8 @@ const wizardCommand: Command = {stdio: 'pipe',cwd: ctx.cwd,timeout: 30000,+ shell: process.platform === 'win32',+ windowsHide: true,});output.writeln(output.success(' β Embeddings configured'));embeddingsInitialized = true;diff --git a/v3/@claude-flow/cli/src/commands/memory.ts b/v3/@claude-flow/cli/src/commands/memory.tsindex bfe836669c..afcd7b26e1 100644--- a/v3/@claude-flow/cli/src/commands/memory.ts+++ b/v3/@claude-flow/cli/src/commands/memory.ts@@ -94,7 +94,18 @@ const storeCommand: Command = {const ttl = ctx.flags.ttl as number;const tags = ctx.flags.tags ? (ctx.flags.tags as string).split(',') : [];const asVector = ctx.flags.vector as boolean;- const upsert = ctx.flags.upsert as boolean;+ // #2775: the parser's `applyDefaults` only materializes global-option+ // defaults, not per-subcommand ones β so despite the `default: true`+ // above, `ctx.flags.upsert` arrives as `undefined` unless the user+ // passes `--upsert` explicitly. That is exactly the trap #2594 tried+ // to close: `store β delete β store` and even plain `store β store`+ // (against an active row) both fall through to the bridge's strict+ // insert, and before #2775's ON-CONFLICT-DO-UPDATE-WHERE-status-+ // 'deleted' fix, both dead-ended with the misleading #2735 guard.+ // Materialize the declared default locally so it takes effect+ // regardless of the parser gap: only an explicit `--no-upsert` (which+ // arrives as `false`) turns it off.+ const upsert = ctx.flags.upsert !== false;if (!key) {output.printError('Key is required. Use --key or -k');diff --git a/v3/@claude-flow/cli/src/funnel/disclosure.ts b/v3/@claude-flow/cli/src/funnel/disclosure.tsindex 7318ff4a2c..342fdde4f0 100644--- a/v3/@claude-flow/cli/src/funnel/disclosure.ts+++ b/v3/@claude-flow/cli/src/funnel/disclosure.ts@@ -23,6 +23,7 @@import type { DisclosureRecord, FunnelDisclosureState, FunnelMessage } from './types.js';import { readStateJson, writeStateJson } from './state.js';import { getRemoteMessages } from './message-transport.js';+import { MESSAGES, eligibleMessagesFromPools } from './messages.js';const DISCLOSURE_FILE = 'funnel-disclosure.json';@@ -35,9 +36,19 @@ export const DISCLOSURE_GRACE_MS = 24 * 60 * 60 * 1000; // 24h// session gets a different one than the previous one did.export const DISCLOSURE_ROTATION_SLOT_MS = 5 * 60 * 1000;-/** Remote-cached messages tagged class==='disclosure' β the only source. */+/**+ * Disclosure pool: remote-cached messages tagged class==='disclosure',+ * MERGED with the local seed pool by id (remote wins on collision).+ *+ * The remote pool is authoritative when populated. The local seed exists+ * so cold-start renders (before the first remote fetch lands) can still+ * unlock the disclosure gate β otherwise every new install sees a blank+ * promo row until the first fetch succeeds. Same merge semantics as+ * rotation.ts's `eligibleMessagesFromPools` (issue #2787 / 2026-07-26 sweep).+ */function getDisclosureMessagePool(): FunnelMessage[] {- return getRemoteMessages().filter((m) => m.class === 'disclosure');+ return eligibleMessagesFromPools(MESSAGES, getRemoteMessages())+ .filter((m) => m.class === 'disclosure');}/**diff --git a/v3/@claude-flow/cli/src/funnel/messages.ts b/v3/@claude-flow/cli/src/funnel/messages.tsindex fc9015382c..c956fa282f 100644--- a/v3/@claude-flow/cli/src/funnel/messages.ts+++ b/v3/@claude-flow/cli/src/funnel/messages.ts@@ -106,20 +106,92 @@ export function isValidMessage(msg: unknown, now: Date = new Date()): msg is Fun}/**- * Local promo/message content: INTENTIONALLY EMPTY (ADR-311 amendment).+ * Local promo/message content: cold-start seed (ADR-311 amendment+ * revisited, issue #2787).*- * All rotation content (educational tips, promotional messages, and the- * disclosure notice) is served exclusively from the remote message feed- * (GET /v1/messages -> message-transport.ts -> Firestore). Zero message- * text or URLs ship in the CLI package.+ * The remote pool is authoritative β `eligibleMessagesFromPools` in+ * `rotation.ts` merges by id with remote winning β but on new installs+ * the remote fetch races the very first render and the promo row shows+ * NOTHING until the pool has been fetched at least once. The disclosure+ * gate can't unlock either, so several 20-second slots go by blank.*- * Fail-closed by design: if the remote feed is unreachable (network down,- * cert issue, server outage) and no prior successful fetch has populated- * the local cache, the rotation has nothing to show and the promo row- * simply does not render that cycle. There is no local content to fall- * back to -- this is a deliberate choice, not an oversight.+ * The fix is a small local seed of educational tips, one bootstrap+ * disclosure, and a single sponsor promo, all validating cleanly through+ * `isValidMessage` and using only URLs on the exact-host allowlist. Each+ * carries a stable id so the remote pool can override or retire any of+ * them without a CLI release.*/-export const MESSAGES: FunnelMessage[] = [];+export const MESSAGES: FunnelMessage[] = [+ {+ schemaVersion: 1,+ id: 'local.disclosure.v1',+ class: 'disclosure',+ text: 'Ruflo shows occasional tips and sponsor notes here Β· manage: ruflo settings',+ },+ {+ schemaVersion: 1,+ id: 'local.edu.status-watch',+ class: 'educational',+ text: 'π ruflo status watch β real-time system + swarm health dashboard',+ url: 'https://cognitum.one/docs/statusline',+ },+ {+ schemaVersion: 1,+ id: 'local.edu.memory-search',+ class: 'educational',+ text: 'π§ ruflo memory search β semantic search over your project decisions',+ url: 'https://cognitum.one/docs/memory',+ },+ {+ schemaVersion: 1,+ id: 'local.edu.swarm-init',+ class: 'educational',+ text: 'π ruflo swarm init β hierarchical anti-drift multi-agent coordination',+ url: 'https://cognitum.one/docs/swarm',+ },+ {+ schemaVersion: 1,+ id: 'local.edu.security-scan',+ class: 'educational',+ text: 'π ruflo security scan --depth full β audits dependencies and config',+ url: 'https://cognitum.one/docs/security',+ },+ {+ schemaVersion: 1,+ id: 'local.edu.doctor',+ class: 'educational',+ text: 'π©Ί ruflo doctor --fix β diagnose and auto-repair install issues',+ url: 'https://cognitum.one/docs/doctor',+ },+ {+ schemaVersion: 1,+ id: 'local.edu.hooks-route',+ class: 'educational',+ text: 'πͺ ruflo hooks route β 3-tier model routing cuts token cost 30β75%',+ url: 'https://cognitum.one/docs/hooks',+ },+ {+ schemaVersion: 1,+ id: 'local.edu.adr-index',+ class: 'educational',+ text: 'π ruflo adr index β every architecture decision indexed and searchable',+ url: 'https://github.com/ruvnet/ruflo/tree/main/docs/adr',+ },+ {+ schemaVersion: 1,+ id: 'local.edu.agent-spawn',+ class: 'educational',+ text: 'β‘ ruflo agent spawn -t coder β background agents with anti-drift topology',+ url: 'https://cognitum.one/docs/agents',+ },+ {+ schemaVersion: 1,+ id: 'local.promo.cognitum',+ class: 'promotional',+ text: 'β¨ Cognitum β’ sponsored capacity for community jobs Β· manage: ruflo settings',+ url: 'https://cognitum.one',+ },+];/** Messages that survive every content boundary right now. */export function eligibleMessages(now: Date = new Date()): FunnelMessage[] {diff --git a/v3/@claude-flow/cli/src/mcp-tools/browser-tools.ts b/v3/@claude-flow/cli/src/mcp-tools/browser-tools.tsindex f5ba6da665..fe7b2ebd20 100644--- a/v3/@claude-flow/cli/src/mcp-tools/browser-tools.ts+++ b/v3/@claude-flow/cli/src/mcp-tools/browser-tools.ts@@ -37,9 +37,17 @@ export async function execBrowserCommand(args: string[], session = 'default'): Pconst err = error as NodeJS.ErrnoException;if (err.code === 'ENOENT') {try {+ // #2770: On Windows, `npx` ships as `npx.cmd`; execFileSync cannot spawn+ // a .cmd file without going through cmd.exe. Enable shell on win32 so+ // cmd.exe resolves the .cmd extension. POSIX keeps shell:false.+ // NOTE: shell:true joins args by spaces and passes to cmd.exe β the args+ // here are hard-coded flags + a package name, so no injection risk. If+ // user-controlled args are ever added, escape them before spawn.result = execFileSync('npx', ['--yes', 'agent-browser', ...fullArgs], {encoding: 'utf-8',timeout: 60000,+ shell: process.platform === 'win32',+ windowsHide: true,});} catch (npxError) {const npxErr = npxError as NodeJS.ErrnoException;diff --git a/v3/@claude-flow/cli/src/mcp-tools/hooks-tools.ts b/v3/@claude-flow/cli/src/mcp-tools/hooks-tools.tsindex 5ee1d49ca1..a79e70f8e8 100644--- a/v3/@claude-flow/cli/src/mcp-tools/hooks-tools.ts+++ b/v3/@claude-flow/cli/src/mcp-tools/hooks-tools.ts@@ -1497,6 +1497,26 @@ export const hooksPostTask: MCPTool = {});}} catch { /* non-critical */ }++ // #2786 fix-2 β also mirror into the JSON memory store so+ // `getIntelligenceStatsFromMemory()` (which reads .claude-flow/memory/store.json+ // synchronously) counts this routing decision in the hooks_metrics dashboard.+ // The AgentDB write above is authoritative for cross-session retrieval; this+ // is just the counter surface the sync reader depends on.+ try {+ const key = `routing-decision:${taskId}`;+ const store = loadMemoryStore();+ store.entries[key] = {+ key,+ value: JSON.stringify({ task: taskText, agent, success, quality, keywords: outcomeKeywords }),+ namespace: 'patterns',+ createdAt: new Date().toISOString(),+ metadata: { type: 'routing-decision', confidence: typeof quality === 'number' ? quality : undefined, agent, success },+ } as any;+ const memDir = resolve(MEMORY_DIR);+ if (!existsSync(memDir)) mkdirSync(memDir, { recursive: true });+ writeFileSync(getMemoryPath(), JSON.stringify(store, null, 2), 'utf-8');+ } catch { /* non-critical */ }}const duration = Date.now() - startTime;diff --git a/v3/@claude-flow/cli/src/mcp-tools/memory-tools.ts b/v3/@claude-flow/cli/src/mcp-tools/memory-tools.tsindex 2fe20f96d6..3caf15afda 100644--- a/v3/@claude-flow/cli/src/mcp-tools/memory-tools.ts+++ b/v3/@claude-flow/cli/src/mcp-tools/memory-tools.ts@@ -293,7 +293,7 @@ async function ensureInitialized(): Promise<void> {export const memoryTools: MCPTool[] = [{name: 'memory_store',- description: 'Persistent key-value store with vector embedding β survives across sessions and is searchable by meaning, not just by file path. Use when native Write is wrong because the data is not a file (e.g. a learned pattern, a decision, a budget config) AND you need to recall it later by semantic query, not by path. Defaults to namespace="default"; pass --upsert=true to update an existing key.',+ description: 'Persistent key-value store with vector embedding β survives across sessions and is searchable by meaning, not just by file path. Use when native Write is wrong because the data is not a file (e.g. a learned pattern, a decision, a budget config) AND you need to recall it later by semantic query, not by path. Defaults to namespace="default". Upsert semantics: writing an existing key updates it (matching the CLI `memory store` default); pass `upsert: false` to force strict-insert instead.',category: 'memory',inputSchema: {type: 'object',@@ -307,7 +307,7 @@ export const memoryTools: MCPTool[] = [description: 'Optional tags for filtering',},ttl: { type: 'number', description: 'Time-to-live in seconds (optional)' },- upsert: { type: 'boolean', description: 'If true, update existing key instead of failing (default: false)' },+ upsert: { type: 'boolean', description: 'Update existing key instead of failing (default: true, matching CLI `memory store`; set false for strict-insert). #2775 parity.' },},required: ['key', 'value'],},@@ -321,7 +321,8 @@ export const memoryTools: MCPTool[] = [const value = typeof rawValue === 'string' ? rawValue : (rawValue !== undefined ? JSON.stringify(rawValue) : '');const tags = (input.tags as string[]) || [];const ttl = input.ttl as number | undefined;- const upsert = (input.upsert as boolean) || false;+ // #2775 parity with CLI: default true; only explicit `upsert: false` opts out.+ const upsert = input.upsert !== false;if (!value) {return {diff --git a/v3/@claude-flow/cli/src/memory/memory-bridge.ts b/v3/@claude-flow/cli/src/memory/memory-bridge.tsindex d8495e9805..5b5fa21cd1 100644--- a/v3/@claude-flow/cli/src/memory/memory-bridge.ts+++ b/v3/@claude-flow/cli/src/memory/memory-bridge.ts@@ -27,29 +27,6 @@ let registryPromise: Promise<any> | null = null;let registryInstance: any = null;let bridgeAvailable: boolean | null = null;-// #2735 β the native-bridge -> sql.js whole-image fallback used to be-// completely silent: a registry init failure cached `bridgeAvailable =-// false` for the rest of the process, and a per-operation bridge exception-// swallowed itself with a bare `catch { return null; }` β in both cases the-// caller fell back to memory-initializer.ts's unsafe whole-image sql.js-// path with zero diagnostic trail. When that path corrupted a database, the-// demotion that caused it was structurally unknowable after the fact. Log-// once per distinct reason (not once per call β a hot per-op catch could-// otherwise spam stderr on every single memory operation) so the first-// occurrence is attributable. Stderr only β never stdout, which callers may-// be parsing as JSON.-const loggedDemotions = new Set<string>();-function logDemotionOnce(where: string, reason: string): void {- const dedupeKey = `${where}:${reason}`;- if (loggedDemotions.has(dedupeKey)) return;- loggedDemotions.add(dedupeKey);- try {- process.stderr.write(- `[memory-bridge] demoted to sql.js fallback in ${where}: ${reason}\n`,- );- } catch { /* stderr unavailable β nothing more we can do */ }-}-/*** Resolve database path with path traversal protection.* Only allows paths within or below the project's working directory,@@ -90,6 +67,27 @@ function getDbPath(customPath?: string): string {return resolved;}+/**+ * Resolve AgentDB's native better-sqlite3 database path (#2786).+ *+ * AgentDB is opened by ControllerRegistry via native better-sqlite3, which+ * requires a plaintext SQLite file. The sibling `memory.db` file written by+ * `memory-initializer.ts` (`writeFileRestricted(..., {encrypt: true})`) is+ * encrypted-at-rest when `CLAUDE_FLOW_ENCRYPT_AT_REST=1` β pointing native+ * better-sqlite3 at it fails with "file is not a database" and silently+ * disables `learningSystem`/`reasoningBank`.+ *+ * Give AgentDB a distinct filename in the same directory so both writers+ * coexist: sql.js keeps `memory.db` (possibly encrypted); AgentDB owns+ * `agentdb-memory.db`. Preserves the traversal protection in `getDbPath()`+ * because we derive from its already-validated return value.+ */+function getAgentDbPath(): string {+ const dbPath = getDbPath();+ if (dbPath === ':memory:') return ':memory:';+ return path.join(path.dirname(dbPath), 'agentdb-memory.db');+}+/*** Generate a secure random ID for memory entries.*/@@ -126,7 +124,8 @@ async function getRegistry(dbPath?: string): Promise<any | null> {try {await (registry as any).initialize({- dbPath: dbPath || getDbPath(),+ // #2786: use agentdb-memory.db (plaintext) so native better-sqlite3 doesn't hit the encrypted memory.db.+ dbPath: dbPath || getAgentDbPath(),embeddingModel: 'Xenova/all-MiniLM-L6-v2',dimension: 384,vectorBackend: 'auto',@@ -348,13 +347,9 @@ async function getRegistry(dbPath?: string): Promise<any | null> {registryInstance = registry;bridgeAvailable = true;return registry;- } catch (err) {+ } catch {bridgeAvailable = false;registryPromise = null;- logDemotionOnce(- 'getRegistry (process-wide, cached for the rest of this process)',- err instanceof Error ? err.message : String(err),- );return null;}})();@@ -743,7 +738,23 @@ export async function bridgeStoreEntry(options: {}}- // better-sqlite3 uses synchronous .run() with positional params+ // #2775: strict-insert path now auto-resurrects soft-deleted tombstones+ // via ON CONFLICT DO UPDATE ... WHERE status='deleted'. Rationale:+ // `bridgeDeleteEntry` performs a soft delete (status='deleted'), so the+ // `UNIQUE(namespace, key)` slot stays occupied β before this fix, a+ // natural `delete β store` sequence hit UNIQUE, the catch below returned+ // `null`, `storeEntry` fell back to the sql.js whole-image path, and the+ // #2735 -wal/-shm sidecar guard refused with a message about a "native+ // WAL connection" that had nothing to do with the actual failure.+ //+ // Semantics under the new strict-insert SQL:+ // β’ no existing row β INSERT succeeds, changes = 1+ // β’ existing row, status='deleted' β resurrected in-place, changes = 1+ // β’ existing row, status='active' β ON CONFLICT WHERE=false suppresses+ // the update, changes = 0 (checked+ // below β typed "already exists"+ // error, NEVER a null demotion).+ // Upsert path (INSERT OR REPLACE) is unchanged.const insertSql = options.upsert? `INSERT OR REPLACE INTO memory_entries (id, key, namespace, content, type,@@ -754,7 +765,20 @@ export async function bridgeStoreEntry(options: {id, key, namespace, content, type,embedding, embedding_dimensions, embedding_model,tags, metadata, created_at, updated_at, expires_at, status- ) VALUES (?, ?, ?, ?, 'semantic', ?, ?, ?, ?, ?, ?, ?, ?, 'active')`;+ ) VALUES (?, ?, ?, ?, 'semantic', ?, ?, ?, ?, ?, ?, ?, ?, 'active')+ ON CONFLICT(namespace, key) DO UPDATE SET+ id = excluded.id,+ content = excluded.content,+ embedding = excluded.embedding,+ embedding_dimensions = excluded.embedding_dimensions,+ embedding_model = excluded.embedding_model,+ tags = excluded.tags,+ metadata = excluded.metadata,+ created_at = excluded.created_at,+ updated_at = excluded.updated_at,+ expires_at = excluded.expires_at,+ status = 'active'+ WHERE memory_entries.status = 'deleted'`;// #1941: provision a `vector_indexes` row for this namespace before the// entry insert. AgentDB's HNSW/router keys lookups by namespace via this@@ -768,7 +792,7 @@ export async function bridgeStoreEntry(options: {} catch { /* vector_indexes may not exist on legacy DBs β fall through */ }const stmt = ctx.db.prepare(insertSql);- stmt.run(+ const runResult = stmt.run(id, key, namespace, value,embeddingJson, dimensions || null, model,tags.length > 0 ? JSON.stringify(tags) : null,@@ -777,6 +801,19 @@ export async function bridgeStoreEntry(options: {ttl ? now + (ttl * 1000) : null);+ // #2775: strict insert against an ACTIVE existing row β changes === 0+ // (the ON CONFLICT WHERE clause above suppressed the update). Surface+ // this as a typed data-level error rather than a bridge failure β+ // returning non-null so the caller does NOT demote to sql.js and does+ // NOT trip the #2735 whole-image guard with a misleading message.+ if (!options.upsert && (runResult?.changes ?? 0) === 0) {+ return {+ success: false,+ id,+ error: `key "${key}" already exists in namespace "${namespace}" β pass upsert=true (--upsert on the CLI) to update it`,+ };+ }+// #2558: keep `vector_indexes.total_vectors` accurate so status/tooling// stop reporting "HNSW index: 0 vectors" while embedded entries exist.try {@@ -823,7 +860,24 @@ export async function bridgeStoreEntry(options: {attested: true,};} catch (err) {- logDemotionOnce('bridgeStoreEntry', err instanceof Error ? err.message : String(err));+ // #2775: distinguish a data-level UNIQUE constraint violation (key+ // already exists β expected outcome of a strict insert) from a real+ // bridge failure (registry gone, DB locked, disk full, etc.). The+ // ON CONFLICT clause on the strict-insert SQL above should normally+ // convert UNIQUE hits into a `changes === 0` result, so reaching here+ // with a UNIQUE error means the schema pre-dates the (namespace, key)+ // unique index or the conflict target didn't match β treat it as a+ // clean "already exists" so the caller never demotes to sql.js and+ // never triggers the #2735 whole-image guard with a misleading+ // "active native WAL connection" error.+ const msg = err instanceof Error ? err.message : String(err);+ if (/UNIQUE constraint failed/i.test(msg)) {+ return {+ success: false,+ id: '',+ error: `key "${options.key}" already exists in namespace "${options.namespace ?? 'default'}" β pass upsert=true (--upsert on the CLI) to update it`,+ };+ }return null;}}@@ -1186,8 +1240,7 @@ export async function bridgeGetEntry(options: {await cacheSet(registry, cacheKey, entry);return { success: true, found: true, cacheHit: false, entry };- } catch (err) {- logDemotionOnce('bridgeGetEntry', err instanceof Error ? err.message : String(err));+ } catch {return null;}}@@ -1237,6 +1290,21 @@ export async function bridgeDeleteEntry(options: {return null;}+ // #2775: mirror the #2558 PASSIVE checkpoint after the delete. Without+ // this, the tombstone stays WAL-only until some unrelated store+ // eventually checkpoints β meaning WAL-blind readers (sql.js fallback,+ // statusline's read-only sqlite3 counter) keep serving the deleted row.+ // If the process exits before another checkpoint, on live multi-worktree+ // installations we've observed rows `active` in the main image but+ // `deleted` in the -wal, or rows existing only in an orphaned -wal+ // invisible to every image reader. PASSIVE flushes committed pages+ // without blocking writers. Best-effort, never fatal.+ try {+ if (typeof ctx.db.pragma === 'function') {+ ctx.db.pragma('wal_checkpoint(PASSIVE)');+ }+ } catch { /* non-WAL, busy, or unsupported β non-fatal */ }+// Phase 2: Invalidate cacheconst safeNs = String(namespace).replace(/:/g, '_');const safeKey = String(key).replace(/:/g, '_');@@ -1263,8 +1331,7 @@ export async function bridgeDeleteEntry(options: {remainingEntries: remaining,guarded: true,};- } catch (err) {- logDemotionOnce('bridgeDeleteEntry', err instanceof Error ? err.message : String(err));+ } catch {return null;}}@@ -1328,8 +1395,7 @@ export async function bridgePurgeNamespace(options: {remainingEntries: remaining,guarded: true,};- } catch (err) {- logDemotionOnce('bridgePurgeNamespace', err instanceof Error ? err.message : String(err));+ } catch {return null;}}diff --git a/v3/@claude-flow/cli/src/parser.ts b/v3/@claude-flow/cli/src/parser.tsindex c23b35dd8c..8648cb9cc1 100644--- a/v3/@claude-flow/cli/src/parser.ts+++ b/v3/@claude-flow/cli/src/parser.ts@@ -263,8 +263,12 @@ export class CommandParser {i++;}- // Apply defaults- this.applyDefaults(result.flags);+ // Apply defaults (globals + resolved command/subcommand β #2775 follow-up).+ // Previously only globals were walked, so any subcommand-declared+ // `default: true` silently dropped and reached the action handler as+ // `undefined`. That trapped `memory store --upsert` and every other+ // subcommand that leaned on a per-flag default.+ this.applyDefaults(result.flags, resolvedCmd, resolvedSub);return result;}@@ -511,16 +515,27 @@ export class CommandParser {return flags;}- private applyDefaults(flags: ParsedFlags): void {- // Apply global option defaults- for (const opt of this.globalOptions) {- const key = this.normalizeKey(opt.name);- if (flags[key] === undefined && opt.default !== undefined) {- flags[key] = opt.default as string | boolean | number | string[];+ private applyDefaults(flags: ParsedFlags, command?: Command, subcommand?: Command): void {+ // #2775: apply defaults from globals AND the resolved command/subcommand.+ // Subcommand > command > global (later writes lose to earlier β because+ // we only set when `undefined`, so the FIRST option definition that+ // supplies a default wins; walk narrow-to-broad so subcommand options+ // apply before broader ones do).+ const layers: CommandOption[][] = [];+ if (subcommand?.options) layers.push(subcommand.options);+ if (command?.options) layers.push(command.options);+ layers.push(this.globalOptions);++ for (const layer of layers) {+ for (const opt of layer) {+ const key = this.normalizeKey(opt.name);+ if (flags[key] === undefined && opt.default !== undefined) {+ flags[key] = opt.default as string | boolean | number | string[];+ }}}- // Apply custom defaults+ // Apply custom defaults (lowest precedence)if (this.options.defaults) {for (const [key, value] of Object.entries(this.options.defaults)) {const normalizedKey = this.normalizeKey(key);diff --git a/v3/@claude-flow/cli/src/services/worker-daemon.ts b/v3/@claude-flow/cli/src/services/worker-daemon.tsindex 390da4a418..8cf5725e74 100644--- a/v3/@claude-flow/cli/src/services/worker-daemon.ts+++ b/v3/@claude-flow/cli/src/services/worker-daemon.ts@@ -15,6 +15,7 @@ import { EventEmitter } from 'events';import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync, unlinkSync, renameSync } from 'fs';import { cpus } from 'os';import { join } from 'path';+import { writeFileAtomic } from '../fs-secure.js';import {HeadlessWorkerExecutor,HEADLESS_WORKER_TYPES,@@ -2027,9 +2028,11 @@ export class WorkerDaemon extends EventEmitter {};try {- const tmpFile = this.config.stateFile + '.tmp';- writeFileSync(tmpFile, JSON.stringify(state, null, 2));- renameSync(tmpFile, this.config.stateFile);+ // ruvnet/ruflo#2782: use writeFileAtomic β its temp file is uniquified with+ // pid + timestamp + random suffix, so two concurrent in-process saveState()+ // calls can no longer collide on a shared `.tmp` basename and race one+ // another's renameSync into ENOENT. Related to but distinct from #1637.+ writeFileAtomic(this.config.stateFile, Buffer.from(JSON.stringify(state, null, 2)));} catch (error) {this.log('error', `Failed to save state: ${error}`);}diff --git a/v3/@claude-flow/codex/src/generators/config-toml.ts b/v3/@claude-flow/codex/src/generators/config-toml.tsindex b7fc01d823..9e7bf5c0e9 100644--- a/v3/@claude-flow/codex/src/generators/config-toml.ts+++ b/v3/@claude-flow/codex/src/generators/config-toml.ts@@ -5,7 +5,6 @@*/import type { ConfigTomlOptions, McpServerConfig, SkillConfig, ConfigProfile } from '../types.js';-import { getRufloMcpServerConfig, renderMcpServerToml } from '../mcp-config.js';/*** Security configuration options@@ -71,7 +70,6 @@ export async function generateConfigToml(options: ExtendedConfigTomlOptions = {}security = {},performance = {},logging = {},- platform = process.platform,} = options;const lines: string[] = [];@@ -160,12 +158,18 @@ export async function generateConfigToml(options: ExtendedConfigTomlOptions = {}// Default claude-flow serverconst hasRuflo = mcpServers.some(s => s.name === 'ruflo' || s.name === 'claude-flow');if (!hasRuflo) {- lines.push(...renderMcpServerToml(getRufloMcpServerConfig(platform)));+ lines.push(...generateMcpServer({+ name: 'ruflo',+ command: 'npx',+ args: ['-y', '--package=@claude-flow/cli@latest', 'claude-flow-mcp'],+ enabled: true,+ toolTimeout: 120,+ }));lines.push('');}for (const server of mcpServers) {- lines.push(...renderMcpServerToml(server));+ lines.push(...generateMcpServer(server));lines.push('');}}@@ -448,6 +452,33 @@ function escapeTomlString(str: string): string {/*** Generate MCP server configuration lines*/+function generateMcpServer(server: McpServerConfig): string[] {+ const lines: string[] = [];+ lines.push(`[mcp_servers.${server.name}]`);+ lines.push(`command = "${server.command}"`);++ if (server.args && server.args.length > 0) {+ const argsStr = server.args.map(a => `"${a}"`).join(', ');+ lines.push(`args = [${argsStr}]`);+ }++ lines.push(`enabled = ${server.enabled ?? true}`);++ if (server.toolTimeout) {+ lines.push(`tool_timeout_sec = ${server.toolTimeout}`);+ }++ if (server.env && Object.keys(server.env).length > 0) {+ lines.push('');+ lines.push(`[mcp_servers.${server.name}.env]`);+ for (const [key, value] of Object.entries(server.env)) {+ lines.push(`${key} = "${value}"`);+ }+ }++ return lines;+}+/*** Generate skill configuration lines*/@@ -493,7 +524,6 @@ export async function generateMinimalConfigToml(options: ConfigTomlOptions = {})model = 'gpt-5.3-codex',approvalPolicy = 'on-request',sandboxMode = 'workspace-write',- platform = process.platform,} = options;return `# Claude Flow V3 - Minimal Codex Configuration@@ -502,14 +532,17 @@ model = "${model}"approval_policy = "${approvalPolicy}"sandbox_mode = "${sandboxMode}"-${renderMcpServerToml(getRufloMcpServerConfig(platform)).join('\n')}+[mcp_servers.ruflo]+command = "npx"+args = ["-y", "--package=@claude-flow/cli@latest", "claude-flow-mcp"]+enabled = true`;}/*** Generate CI/CD config.toml*/-export async function generateCIConfigToml(platform: NodeJS.Platform = process.platform): Promise<string> {+export async function generateCIConfigToml(): Promise<string> {return `# =============================================================================# Claude Flow V3 - CI/CD Pipeline Configuration# =============================================================================@@ -532,7 +565,11 @@ remote_compaction = falsechild_agents_md = truerequest_rule = false-${renderMcpServerToml(getRufloMcpServerConfig(platform, 300)).join('\n')}+[mcp_servers.ruflo]+command = "npx"+args = ["-y", "--package=@claude-flow/cli@latest", "claude-flow-mcp"]+enabled = true+tool_timeout_sec = 300[history]persistence = "none"@@ -574,7 +611,7 @@ train_on_edit = false/*** Generate enterprise config.toml with full governance*/-export async function generateEnterpriseConfigToml(platform: NodeJS.Platform = process.platform): Promise<string> {+export async function generateEnterpriseConfigToml(): Promise<string> {return `# =============================================================================# Claude Flow V3 - Enterprise Configuration# =============================================================================@@ -606,10 +643,14 @@ remote_compaction = true# MCP Servers# =============================================================================-${renderMcpServerToml({- ...getRufloMcpServerConfig(platform),- env: { CLAUDE_FLOW_LOG_LEVEL: 'info' },- }).join('\n')}+[mcp_servers.ruflo]+command = "npx"+args = ["-y", "--package=@claude-flow/cli@latest", "claude-flow-mcp"]+enabled = true+tool_timeout_sec = 120++[mcp_servers.ruflo.env]+CLAUDE_FLOW_LOG_LEVEL = "info"# =============================================================================# Profiles@@ -785,7 +826,7 @@ hipaa = false/*** Generate development config.toml with permissive settings*/-export async function generateDevConfigToml(platform: NodeJS.Platform = process.platform): Promise<string> {+export async function generateDevConfigToml(): Promise<string> {return `# =============================================================================# Claude Flow V3 - Development Configuration# =============================================================================@@ -807,7 +848,11 @@ shell_snapshot = truerequest_rule = falseremote_compaction = true-${renderMcpServerToml(getRufloMcpServerConfig(platform)).join('\n')}+[mcp_servers.ruflo]+command = "npx"+args = ["-y", "--package=@claude-flow/cli@latest", "claude-flow-mcp"]+enabled = true+tool_timeout_sec = 120[history]persistence = "save-all"@@ -862,7 +907,7 @@ enabled = true/*** Generate security-focused config.toml*/-export async function generateSecureConfigToml(platform: NodeJS.Platform = process.platform): Promise<string> {+export async function generateSecureConfigToml(): Promise<string> {return `# =============================================================================# Claude Flow V3 - Security-Focused Configuration# =============================================================================@@ -884,7 +929,11 @@ shell_snapshot = falserequest_rule = trueremote_compaction = false-${renderMcpServerToml(getRufloMcpServerConfig(platform, 60)).join('\n')}+[mcp_servers.ruflo]+command = "npx"+args = ["-y", "--package=@claude-flow/cli@latest", "claude-flow-mcp"]+enabled = true+tool_timeout_sec = 60[history]persistence = "save-all"diff --git a/v3/@claude-flow/codex/src/initializer.ts b/v3/@claude-flow/codex/src/initializer.tsindex 2024d0a0a8..da144b42eb 100644--- a/v3/@claude-flow/codex/src/initializer.ts+++ b/v3/@claude-flow/codex/src/initializer.ts@@ -5,9 +5,7 @@*/import fs from 'fs-extra';-import os from 'os';import path from 'path';-import { fileURLToPath } from 'url';import type {CodexInitOptions,CodexInitResult,@@ -18,20 +16,11 @@ import { generateAgentsMd } from './generators/agents-md.js';import { generateSkillMd, generateBuiltInSkill } from './generators/skill-md.js';import { generateConfigToml } from './generators/config-toml.js';import { DEFAULT_SKILLS_BY_TEMPLATE, AGENTS_OVERRIDE_TEMPLATE, GITIGNORE_ENTRIES, ALL_AVAILABLE_SKILLS } from './templates/index.js';-import {- getRufloMcpAddCommand,- getCodexCliInvocation,- getRufloMcpServerConfig,- hasExpectedRufloMcpTransport,- hasExpectedRufloMcpTimeout,- upsertMcpServerStartupTimeout,- type CodexMcpRegistration,-} from './mcp-config.js';/*** Bundled skills source directory (relative to package)*/-const MONOREPO_SKILLS_DIR = '../../../../.agents/skills';+const BUNDLED_SKILLS_DIR = '../../../../.agents/skills';/*** Main initializer for Codex projects@@ -54,14 +43,11 @@ export class CodexInitializer {this.force = options.force ?? false;this.dual = options.dual ?? false;- // Published packages carry their built-in skills beside dist/. The- // monorepo fallback keeps source checkouts compatible.- const moduleDir = path.dirname(fileURLToPath(import.meta.url));- const packagedSkillsPath = path.resolve(moduleDir, '..', '.agents', 'skills');- const monorepoSkillsPath = path.resolve(moduleDir, MONOREPO_SKILLS_DIR);- this.bundledSkillsPath = await fs.pathExists(packagedSkillsPath)- ? packagedSkillsPath- : monorepoSkillsPath;+ // Resolve bundled skills path (relative to this file's location)+ this.bundledSkillsPath = path.resolve(+ path.dirname(new URL(import.meta.url).pathname),+ BUNDLED_SKILLS_DIR+ );const filesCreated: string[] = [];const skillsGenerated: string[] = [];@@ -75,7 +61,13 @@ export class CodexInitializer {// Check if already initializedconst alreadyInitialized = await this.isAlreadyInitialized();if (alreadyInitialized && !this.force) {- warnings.push('Project already initialized - preserving existing project files and repairing Codex MCP registration');+ return {+ success: false,+ filesCreated,+ skillsGenerated,+ warnings: ['Project already initialized. Use --force to overwrite.'],+ errors: ['Project already initialized'],+ };}if (alreadyInitialized && this.force) {@@ -325,100 +317,85 @@ export class CodexInitializer {* Register claude-flow as MCP server with Codex*/private async registerMCPServer(): Promise<{ registered: boolean; warning?: string }> {- const manualCommand = getRufloMcpAddCommand(process.platform);try {- const { execFileSync } = await import('child_process');+ const { execSync } = await import('child_process');// Check if codex CLI is available- let codex: ReturnType<typeof getCodexCliInvocation>;try {- const output = process.platform === 'win32'- ? execFileSync('where.exe', ['codex'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] })- : execFileSync('which', ['codex'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] });- codex = getCodexCliInvocation(output, process.platform);+ execSync('which codex', { stdio: 'pipe' });} catch {return {registered: false,- warning: `Codex CLI not found. Run: ${manualCommand}`,+ warning: 'Codex CLI not found. Run: codex mcp add ruflo -- npx -y --package=@claude-flow/cli@latest claude-flow-mcp',};}- let existing: CodexMcpRegistration | undefined;+ // Check if already registered. Prefer the structured `--json` output+ // (each entry has a `name` field β confirmed current as of the 2026+ // `codex mcp` CLI) over a plain substring match against the human+ // -readable table, which false-positives on any server whose name or+ // command merely contains "ruflo" and breaks silently if the table+ // formatting changes.try {- const listJson = execFileSync(codex.command, [...codex.prefixArgs, 'mcp', 'list', '--json'], {- encoding: 'utf-8',- stdio: ['ignore', 'pipe', 'pipe'],- });+ const listJson = execSync('codex mcp list --json 2>&1', { encoding: 'utf-8' });const parsed = JSON.parse(listJson);+ // Confirmed shape (2026 `codex mcp` CLI) is a bare array; tolerate a+ // future `{ servers: [...] }` wrapper but otherwise treat an+ // unrecognized shape as "unknown" rather than silently concluding+ // not-registered β falls through to the safe text-based fallback.const servers = Array.isArray(parsed) ? parsed : Array.isArray(parsed?.servers) ? parsed.servers : null;if (!servers) throw new Error('unrecognized `codex mcp list --json` shape');- existing = servers.find((server: unknown): server is CodexMcpRegistration =>- Boolean(server && typeof server === 'object' && (server as CodexMcpRegistration).name === 'ruflo'));+ if (servers.some((s: unknown) => s && typeof s === 'object' && (s as { name?: unknown }).name === 'ruflo')) {+ return { registered: true }; // Already registered+ }} catch {- // Treat a plain-text match as stale because its transport cannot be validated.+ // --json unsupported (older codex CLI) or unparsable β fall back to+ // the plain-text listing so registration still no-ops idempotently.try {- const list = execFileSync(codex.command, [...codex.prefixArgs, 'mcp', 'list'], {- encoding: 'utf-8',- stdio: ['ignore', 'pipe', 'pipe'],- });+ const list = execSync('codex mcp list 2>&1', { encoding: 'utf-8' });if (list.includes('ruflo')) {- existing = { name: 'ruflo' };+ return { registered: true };}} catch {- // Ignore list errors and attempt registration below.+ // Ignore list errors β fall through to (re-)register below.}}- if (existing && hasExpectedRufloMcpTransport(existing, process.platform)) {- await this.ensureGlobalMcpStartupTimeout();- return {- registered: true,- ...(!hasExpectedRufloMcpTimeout(existing)- ? { warning: 'Updated Ruflo MCP startup timeout to 120 seconds' }- : {}),- };- }-+ // Register the MCP server.+ //+ // #2774: MUST target the dedicated stdio server binary+ // (`claude-flow-mcp`, exported by `@claude-flow/cli`) β NOT the+ // `ruflo mcp start` management CLI. The management CLI stays alive+ // but never answers `initialize` on stdio, so Codex silently sees+ // the server as configured but exposes zero Ruflo tools. The+ // dedicated binary streams JSON-RPC over stdio directly, with all+ // progress noise routed to stderr (also fixes the #2253 regression+ // where an embedder progress line leaks onto stdout before the+ // handshake).try {- if (existing) {- execFileSync(codex.command, [...codex.prefixArgs, 'mcp', 'remove', 'ruflo'], {- stdio: ['ignore', 'pipe', 'pipe'],+ execSync(+ 'codex mcp add ruflo -- npx -y --package=@claude-flow/cli@latest claude-flow-mcp',+ {+ stdio: 'pipe',timeout: 10000,- });- }-- const server = getRufloMcpServerConfig(process.platform);- execFileSync(codex.command, [...codex.prefixArgs, 'mcp', 'add', 'ruflo', '--', server.command, ...(server.args ?? [])], {- stdio: ['ignore', 'pipe', 'pipe'],- timeout: 10000,- });- await this.ensureGlobalMcpStartupTimeout();+ }+ );return { registered: true };} catch (err) {const errorMessage = err instanceof Error ? err.message : String(err);return {registered: false,- warning: `Failed to register MCP server: ${errorMessage}. Run manually: ${manualCommand}`,+ warning: `Failed to register MCP server: ${errorMessage}. Run manually: codex mcp add ruflo -- npx -y --package=@claude-flow/cli@latest claude-flow-mcp`,};}} catch {return {registered: false,- warning: `Could not register MCP server. Run manually: ${manualCommand}`,+ warning: 'Could not register MCP server. Run manually: codex mcp add ruflo -- npx -y --package=@claude-flow/cli@latest claude-flow-mcp',};}}- private async ensureGlobalMcpStartupTimeout(): Promise<void> {- const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');- const configPath = path.join(codexHome, 'config.toml');- const config = await fs.readFile(configPath, 'utf-8');- const updated = upsertMcpServerStartupTimeout(config);- if (updated !== config) {- await fs.writeFile(configPath, updated, 'utf-8');- }- }-/*** Generate AGENTS.md content*/@@ -670,8 +647,9 @@ ${this.skills.map(s => `- \`$${s}\` (Codex) / \`/${s}\` (Claude Code)`).join('\n## MCP Integration\`\`\`bash-# Start MCP server-npx ruflo mcp start+# Start Ruflo's MCP server over stdio (dedicated entry point β the+# management \`ruflo mcp start\` CLI does NOT answer JSON-RPC on stdio).+npx -y --package=@claude-flow/cli@latest claude-flow-mcp\`\`\`## Swarm Orchestrationdiff --git a/v3/@claude-flow/codex/src/migrations/index.ts b/v3/@claude-flow/codex/src/migrations/index.tsindex edeb853876..f782e537ea 100644--- a/v3/@claude-flow/codex/src/migrations/index.ts+++ b/v3/@claude-flow/codex/src/migrations/index.ts@@ -16,7 +16,6 @@ import type {ApprovalPolicy,SandboxMode,} from '../types.js';-import { getRufloMcpServerConfig, renderMcpServerToml } from '../mcp-config.js';/*** Parsed CLAUDE.md structure@@ -63,15 +62,6 @@ export interface CodeBlock {line: number;}-function isRufloMcpServer(name: string, args: string[] | undefined): boolean {- if (name === 'ruflo' || name === 'claude-flow' || name === 'claude_flow') {- return true;- }-- const commandLine = (args ?? []).join(' ');- return /(?:^|\s)(?:ruflo|claude-flow)(?:@[^\s]+)?\s+mcp\s+start(?:\s|$)/.test(commandLine);-}-/*** Parsed settings from CLAUDE.md content*/@@ -712,10 +702,7 @@ export function generateAgentsMdFromParsed(parsed: ParsedClaudeMd): string {/*** Convert settings.json to config.toml format*/-export function convertSettingsToToml(- settings: Record<string, unknown>,- platform: NodeJS.Platform = process.platform,-): string {+export function convertSettingsToToml(settings: Record<string, unknown>): string {const lines: string[] = [];lines.push('# Migrated from settings.json');lines.push('# Generated by @claude-flow/codex');@@ -765,35 +752,34 @@ export function convertSettingsToToml(lines.push('');// MCP servers- let hasRuflo = false;if (settings.mcpServers && typeof settings.mcpServers === 'object') {for (const [name, config] of Object.entries(settings.mcpServers as Record<string, unknown>)) {const mcpConfig = config as { command?: string; args?: string[]; env?: Record<string, string> };- if (isRufloMcpServer(name, mcpConfig.args)) {- if (!hasRuflo) {- lines.push(...renderMcpServerToml({- ...getRufloMcpServerConfig(platform),- ...(mcpConfig.env ? { env: mcpConfig.env } : {}),- }));- lines.push('');- hasRuflo = true;- }- continue;+ lines.push(`[mcp_servers.${name}]`);+ if (mcpConfig.command) {+ lines.push(`command = "${mcpConfig.command}"`);}+ if (mcpConfig.args && mcpConfig.args.length > 0) {+ const argsStr = mcpConfig.args.map((a) => `"${a}"`).join(', ');+ lines.push(`args = [${argsStr}]`);+ }+ lines.push('enabled = true');- lines.push(...renderMcpServerToml({- name,- command: mcpConfig.command || 'npx',- enabled: true,- ...(mcpConfig.args ? { args: mcpConfig.args } : {}),- ...(mcpConfig.env ? { env: mcpConfig.env } : {}),- }));+ if (mcpConfig.env && Object.keys(mcpConfig.env).length > 0) {+ lines.push('');+ lines.push(`[mcp_servers.${name}.env]`);+ for (const [key, value] of Object.entries(mcpConfig.env)) {+ lines.push(`${key} = "${value}"`);+ }+ }lines.push('');}- }-- if (!hasRuflo) {- lines.push(...renderMcpServerToml(getRufloMcpServerConfig(platform)));+ } else {+ // Add default claude-flow server+ lines.push('[mcp_servers.ruflo]');+ lines.push('command = "npx"');+ lines.push('args = ["-y", "--package=@claude-flow/cli@latest", "claude-flow-mcp"]');+ lines.push('enabled = true');lines.push('');}@@ -821,10 +807,7 @@ export function convertSettingsToToml(/*** Generate config.toml from parsed CLAUDE.md*/-export function generateConfigTomlFromParsed(- parsed: ParsedClaudeMd,- platform: NodeJS.Platform = process.platform,-): string {+export function generateConfigTomlFromParsed(parsed: ParsedClaudeMd): string {const lines: string[] = [];lines.push('# Migrated from CLAUDE.md');lines.push('# Generated by @claude-flow/codex');@@ -856,25 +839,23 @@ export function generateConfigTomlFromParsed(lines.push('');// MCP servers- let hasRuflo = false;- for (const server of parsed.mcpServers) {- if (isRufloMcpServer(server.name, server.args)) {- if (!hasRuflo) {- lines.push(...renderMcpServerToml(getRufloMcpServerConfig(platform)));- lines.push('');- hasRuflo = true;+ if (parsed.mcpServers.length > 0) {+ for (const server of parsed.mcpServers) {+ lines.push(`[mcp_servers.${server.name.replace(/-/g, '_')}]`);+ lines.push(`command = "${server.command}"`);+ if (server.args && server.args.length > 0) {+ const argsStr = server.args.map((a) => `"${a}"`).join(', ');+ lines.push(`args = [${argsStr}]`);}- } else {- lines.push(...renderMcpServerToml({- ...server,- name: server.name.replace(/-/g, '_'),- }));+ lines.push(`enabled = ${server.enabled ?? true}`);lines.push('');}- }-- if (!hasRuflo) {- lines.push(...renderMcpServerToml(getRufloMcpServerConfig(platform)));+ } else {+ // Default claude-flow server+ lines.push('[mcp_servers.ruflo]');+ lines.push('command = "npx"');+ lines.push('args = ["-y", "--package=@claude-flow/cli@latest", "claude-flow-mcp"]');+ lines.push('enabled = true');lines.push('');}diff --git a/v3/@claude-flow/codex/tests/generators.test.ts b/v3/@claude-flow/codex/tests/generators.test.tsindex 5adaef8cd4..da51ab6921 100644--- a/v3/@claude-flow/codex/tests/generators.test.ts+++ b/v3/@claude-flow/codex/tests/generators.test.ts@@ -650,7 +650,7 @@ describe('generateConfigToml', () => {expect(result).toContain('[mcp_servers.ruflo]');expect(result).toContain('command = "npx"');- expect(result).toContain('args = ["-y", "ruflo@latest", "mcp", "start"]');+ expect(result).toContain(`args = ["-y", "--package=@claude-flow/cli@latest", "claude-flow-mcp"]`);expect(result).toContain('enabled = true');});