Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

Checkpoint: File edits

rUv965afb4dcb01
diff --git a/.claude/helpers/learning-service.mjs b/.claude/helpers/learning-service.mjs
index df311ad82e..ec8511d03b 100755
--- a/.claude/helpers/learning-service.mjs
+++ b/.claude/helpers/learning-service.mjs
@@ -444,13 +444,14 @@ class HNSWIndex {
}
// =============================================================================
-// Embedding Service (ONNX via agentic-flow@alpha)
+// Embedding Service (ONNX via agentic-flow@alpha OptimizedEmbedder)
// =============================================================================
class EmbeddingService {
constructor(config) {
this.config = config;
this.initialized = false;
+ this.embedder = null;
this.embeddingCache = new Map();
this.cacheMaxSize = 1000;
}
@@ -459,20 +460,31 @@ class EmbeddingService {
if (this.initialized) return;
try {
- // Try to use agentic-flow@alpha embeddings
- const result = execSync(
- 'npx agentic-flow@alpha embeddings check 2>/dev/null || echo "fallback"',
- { encoding: 'utf-8', timeout: 5000 }
- ).trim();
+ // Dynamically import agentic-flow OptimizedEmbedder
+ const agenticFlowPath = join(PROJECT_ROOT, 'node_modules/agentic-flow/dist/embeddings/optimized-embedder.js');
+
+ if (existsSync(agenticFlowPath)) {
+ const { getOptimizedEmbedder } = await import(agenticFlowPath);
+ this.embedder = getOptimizedEmbedder({
+ modelId: 'all-MiniLM-L6-v2',
+ dimension: this.config.embedding.dimension,
+ cacheSize: 256,
+ autoDownload: false, // Model should already be downloaded
+ });
+
+ await this.embedder.init();
+ this.useAgenticFlow = true;
+ console.log('[Embedding] Initialized: agentic-flow OptimizedEmbedder (ONNX)');
+ } else {
+ this.useAgenticFlow = false;
+ console.log('[Embedding] agentic-flow not found, using fallback hash embeddings');
+ }
- this.useAgenticFlow = result !== 'fallback';
this.initialized = true;
-
- console.log(`[Embedding] Initialized: ${this.useAgenticFlow ? 'agentic-flow ONNX' : 'fallback hash'}`);
} catch (e) {
this.useAgenticFlow = false;
this.initialized = true;
- console.log('[Embedding] Using fallback hash-based embeddings');
+ console.log(`[Embedding] Using fallback hash-based embeddings: ${e.message}`);
}
}
@@ -487,16 +499,12 @@ class EmbeddingService {
let embedding;
- if (this.useAgenticFlow) {
+ if (this.useAgenticFlow && this.embedder) {
try {
- // Use agentic-flow@alpha ONNX embeddings
- const result = execSync(
- `npx agentic-flow@alpha embeddings generate "${text.replace(/"/g, '\\"').slice(0, 500)}" --format json 2>/dev/null`,
- { encoding: 'utf-8', timeout: 10000 }
- );
- const parsed = JSON.parse(result);
- embedding = new Float32Array(parsed.embedding || parsed);
+ // Use agentic-flow OptimizedEmbedder
+ embedding = await this.embedder.embed(text.slice(0, 500));
} catch (e) {
+ console.log(`[Embedding] ONNX failed, using fallback: ${e.message}`);
embedding = this._fallbackEmbed(text);
}
} else {
@@ -514,6 +522,14 @@ class EmbeddingService {
}
async embedBatch(texts) {
+ if (this.useAgenticFlow && this.embedder) {
+ try {
+ return await this.embedder.embedBatch(texts.map(t => t.slice(0, 500)));
+ } catch (e) {
+ // Fallback to sequential
+ return Promise.all(texts.map(t => this.embed(t)));
+ }
+ }
return Promise.all(texts.map(t => this.embed(t)));
}
diff --git a/agents/architect.yaml b/agents/architect.yaml
index f7901915a6..85dcae157a 100644
--- a/agents/architect.yaml
+++ b/agents/architect.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- context-caching
- memory-persistence
-createdAt: "2026-01-07T03:03:48.852Z"
+createdAt: "2026-01-07T03:47:06.427Z"
diff --git a/agents/coder.yaml b/agents/coder.yaml
index b96dcd40e9..c51013e250 100644
--- a/agents/coder.yaml
+++ b/agents/coder.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- flash-attention
- token-reduction
-createdAt: "2026-01-07T03:03:48.852Z"
+createdAt: "2026-01-07T03:47:06.426Z"
diff --git a/agents/reviewer.yaml b/agents/reviewer.yaml
index 4ac6ff00b9..e965b071b7 100644
--- a/agents/reviewer.yaml
+++ b/agents/reviewer.yaml
@@ -7,4 +7,4 @@ capabilities:
- best-practices
optimizations:
- incremental-analysis
-createdAt: "2026-01-07T03:03:48.852Z"
+createdAt: "2026-01-07T03:47:06.427Z"
diff --git a/agents/security-architect.yaml b/agents/security-architect.yaml
index cb157cbf01..a1a04837df 100644
--- a/agents/security-architect.yaml
+++ b/agents/security-architect.yaml
@@ -7,4 +7,4 @@ capabilities:
- security-review
optimizations:
- pattern-matching
-createdAt: "2026-01-07T03:03:48.852Z"
+createdAt: "2026-01-07T03:47:06.427Z"
diff --git a/agents/tester.yaml b/agents/tester.yaml
index 5a1f85afdd..79a2a2c7d8 100644
--- a/agents/tester.yaml
+++ b/agents/tester.yaml
@@ -7,4 +7,4 @@ capabilities:
- coverage
optimizations:
- parallel-execution
-createdAt: "2026-01-07T03:03:48.852Z"
+createdAt: "2026-01-07T03:47:06.427Z"
diff --git a/package.json b/package.json
index 2c71556c32..7c79039c23 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "claude-flow",
- "version": "3.0.0-alpha.7",
+ "version": "3.0.0-alpha.8",
"description": "Claude Flow V3 - Domain-Driven Design Architecture with 15-Agent Swarm Coordination",
"main": "dist/index.js",
"type": "module",
diff --git a/v3/@claude-flow/cli/agents/architect.yaml b/v3/@claude-flow/cli/agents/architect.yaml
index b8baa01dcc..f8b8049ddf 100644
--- a/v3/@claude-flow/cli/agents/architect.yaml
+++ b/v3/@claude-flow/cli/agents/architect.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- context-caching
- memory-persistence
-createdAt: "2026-01-07T03:15:23.193Z"
+createdAt: "2026-01-07T03:49:59.116Z"
diff --git a/v3/@claude-flow/cli/agents/coder.yaml b/v3/@claude-flow/cli/agents/coder.yaml
index 6337d810a8..f395aa29fc 100644
--- a/v3/@claude-flow/cli/agents/coder.yaml
+++ b/v3/@claude-flow/cli/agents/coder.yaml
@@ -8,4 +8,4 @@ capabilities:
optimizations:
- flash-attention
- token-reduction
-createdAt: "2026-01-07T03:15:23.193Z"
+createdAt: "2026-01-07T03:49:59.116Z"
diff --git a/v3/@claude-flow/cli/agents/reviewer.yaml b/v3/@claude-flow/cli/agents/reviewer.yaml
index d70cb3a6dd..3f238bd66f 100644
--- a/v3/@claude-flow/cli/agents/reviewer.yaml
+++ b/v3/@claude-flow/cli/agents/reviewer.yaml
@@ -7,4 +7,4 @@ capabilities:
- best-practices
optimizations:
- incremental-analysis
-createdAt: "2026-01-07T03:15:23.194Z"
+createdAt: "2026-01-07T03:49:59.116Z"
diff --git a/v3/@claude-flow/cli/agents/security-architect.yaml b/v3/@claude-flow/cli/agents/security-architect.yaml
index a4a3c75cae..774420637b 100644
--- a/v3/@claude-flow/cli/agents/security-architect.yaml
+++ b/v3/@claude-flow/cli/agents/security-architect.yaml
@@ -7,4 +7,4 @@ capabilities:
- security-review
optimizations:
- pattern-matching
-createdAt: "2026-01-07T03:15:23.193Z"
+createdAt: "2026-01-07T03:49:59.116Z"
diff --git a/v3/@claude-flow/cli/agents/tester.yaml b/v3/@claude-flow/cli/agents/tester.yaml
index 7c3ab728c8..c70acbc4b3 100644
--- a/v3/@claude-flow/cli/agents/tester.yaml
+++ b/v3/@claude-flow/cli/agents/tester.yaml
@@ -7,4 +7,4 @@ capabilities:
- coverage
optimizations:
- parallel-execution
-createdAt: "2026-01-07T03:15:23.193Z"
+createdAt: "2026-01-07T03:49:59.116Z"
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index 2de25e457e..d5170cece8 100644
--- a/v3/@claude-flow/cli/package.json
+++ b/v3/@claude-flow/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@claude-flow/cli",
- "version": "3.0.0-alpha.7",
+ "version": "3.0.0-alpha.8",
"type": "module",
"description": "CLI module - command parsing, prompts, output formatting",
"main": "dist/index.js",
diff --git a/v3/@claude-flow/cli/src/commands/daemon.ts b/v3/@claude-flow/cli/src/commands/daemon.ts
index eff0348d78..acbaefb5bc 100644
--- a/v3/@claude-flow/cli/src/commands/daemon.ts
+++ b/v3/@claude-flow/cli/src/commands/daemon.ts
@@ -6,6 +6,10 @@
import type { Command, CommandContext, CommandResult } from '../types.js';
import { output } from '../output.js';
import { WorkerDaemon, getDaemon, startDaemon, stopDaemon, type WorkerType } from '../services/worker-daemon.js';
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import * as fs from 'fs';
// Start daemon subcommand
const startCommand: Command = {
@@ -14,15 +18,34 @@ const startCommand: Command = {
options: [
{ name: 'workers', short: 'w', type: 'string', description: 'Comma-separated list of workers to enable (default: map,audit,optimize,consolidate,testgaps)' },
{ name: 'quiet', short: 'q', type: 'boolean', description: 'Suppress output' },
+ { name: 'background', short: 'b', type: 'boolean', description: 'Run daemon in background (detached process)', default: true },
+ { name: 'foreground', short: 'f', type: 'boolean', description: 'Run daemon in foreground (blocks terminal)' },
],
examples: [
- { command: 'claude-flow daemon start', description: 'Start daemon with default workers' },
+ { command: 'claude-flow daemon start', description: 'Start daemon in background (default)' },
+ { command: 'claude-flow daemon start --foreground', description: 'Start in foreground (blocks terminal)' },
{ command: 'claude-flow daemon start -w map,audit,optimize', description: 'Start with specific workers' },
],
action: async (ctx: CommandContext): Promise<CommandResult> => {
const quiet = ctx.flags.quiet as boolean;
+ const foreground = ctx.flags.foreground as boolean;
const projectRoot = process.cwd();
+ // Check if background daemon already running
+ const bgPid = getBackgroundDaemonPid(projectRoot);
+ if (bgPid && isProcessRunning(bgPid)) {
+ if (!quiet) {
+ output.printWarning(`Daemon already running in background (PID: ${bgPid})`);
+ }
+ return { success: true };
+ }
+
+ // Background mode (default): fork a detached process
+ if (!foreground) {
+ return startBackgroundDaemon(projectRoot, quiet);
+ }
+
+ // Foreground mode: run in current process (blocks terminal)
try {
if (!quiet) {
const spinner = output.createSpinner({ text: 'Starting worker daemon...', spinner: 'dots' });
@@ -31,7 +54,7 @@ const startCommand: Command = {
const daemon = await startDaemon(projectRoot);
const status = daemon.getStatus();
- spinner.succeed('Worker daemon started');
+ spinner.succeed('Worker daemon started (foreground mode)');
output.writeln();
output.printBox(
@@ -65,6 +88,9 @@ const startCommand: Command = {
})),
});
+ output.writeln();
+ output.writeln(output.dim('Press Ctrl+C to stop daemon'));
+
// Listen for worker events
daemon.on('worker:start', ({ type }: { type: string }) => {
output.writeln(output.dim(`[daemon] Worker starting: ${type}`));
@@ -77,8 +103,12 @@ const startCommand: Command = {
daemon.on('worker:error', ({ type, error }: { type: string; error: string }) => {
output.writeln(output.error(`[daemon] Worker failed: ${type} - ${error}`));
});
+
+ // Keep process alive
+ await new Promise(() => {}); // Never resolves - daemon runs until killed
} else {
await startDaemon(projectRoot);
+ await new Promise(() => {}); // Keep alive
}
return { success: true };
@@ -89,6 +119,65 @@ const startCommand: Command = {
},
};
+/**
+ * Start daemon as a detached background process
+ */
+async function startBackgroundDaemon(projectRoot: string, quiet: boolean): Promise<CommandResult> {
+ const stateDir = join(projectRoot, '.claude-flow');
+ const pidFile = join(stateDir, 'daemon.pid');
+ const logFile = join(stateDir, 'daemon.log');
+
+ // Ensure state directory exists
+ if (!fs.existsSync(stateDir)) {
+ fs.mkdirSync(stateDir, { recursive: true });
+ }
+
+ // Get path to CLI (from dist/src/commands/daemon.js -> bin/cli.js)
+ const __filename = fileURLToPath(import.meta.url);
+ const __dirname = dirname(__filename);
+ // dist/src/commands -> dist/src -> dist -> package root -> bin/cli.js
+ const cliPath = join(__dirname, '..', '..', '..', 'bin', 'cli.js');
+
+ // Open log file for daemon output
+ const logFd = fs.openSync(logFile, 'a');
+
+ // Verify CLI path exists
+ if (!fs.existsSync(cliPath)) {
+ fs.closeSync(logFd);
+ output.printError(`CLI not found at: ${cliPath}`);
+ return { success: false, exitCode: 1 };
+ }
+
+ // Spawn detached child process running daemon in foreground mode
+ const child = spawn(
+ process.execPath,
+ [cliPath, 'daemon', 'start', '--foreground', '--quiet'],
+ {
+ cwd: projectRoot,
+ detached: true,
+ stdio: ['ignore', logFd, logFd],
+ env: { ...process.env, CLAUDE_FLOW_DAEMON: '1' },
+ }
+ );
+
+ // Unref so parent can exit
+ child.unref();
+
+ // Save PID
+ fs.writeFileSync(pidFile, String(child.pid));
+
+ // Close log file descriptor in parent
+ fs.closeSync(logFd);
+
+ if (!quiet) {
+ output.printSuccess(`Daemon started in background (PID: ${child.pid})`);
+ output.printInfo(`Logs: ${logFile}`);
+ output.printInfo(`Stop with: claude-flow daemon stop`);
+ }
+
+ return { success: true };
+}
+
// Stop daemon subcommand
const stopCommand: Command = {
name: 'stop',
@@ -101,17 +190,23 @@ const stopCommand: Command = {
],
action: async (ctx: CommandContext): Promise<CommandResult> => {
const quiet = ctx.flags.quiet as boolean;
+ const projectRoot = process.cwd();
try {
if (!quiet) {
const spinner = output.createSpinner({ text: 'Stopping worker daemon...', spinner: 'dots' });
spinner.start();
+ // Try to stop in-process daemon first
await stopDaemon();
- spinner.succeed('Worker daemon stopped');
+ // Also kill any background daemon by PID
+ const killed = await killBackgroundDaemon(projectRoot);
+
+ spinner.succeed(killed ? 'Worker daemon stopped' : 'Worker daemon was not running');
} else {
await stopDaemon();
+ await killBackgroundDaemon(projectRoot);
}
return { success: true };
@@ -122,6 +217,92 @@ const stopCommand: Command = {
},
};
+/**
+ * Kill background daemon process using PID file
+ */
+async function killBackgroundDaemon(projectRoot: string): Promise<boolean> {
+ const pidFile = join(projectRoot, '.claude-flow', 'daemon.pid');
+
+ if (!fs.existsSync(pidFile)) {
+ return false;
+ }
+
+ try {
+ const pid = parseInt(fs.readFileSync(pidFile, 'utf-8').trim(), 10);
+
+ if (isNaN(pid)) {
+ fs.unlinkSync(pidFile);
+ return false;
+ }
+
+ // Check if process is running
+ try {
+ process.kill(pid, 0); // Signal 0 = check if alive
+ } catch {
+ // Process not running, clean up stale PID file
+ fs.unlinkSync(pidFile);
+ return false;
+ }
+
+ // Kill the process
+ process.kill(pid, 'SIGTERM');
+
+ // Wait a moment then force kill if needed
+ await new Promise(resolve => setTimeout(resolve, 1000));
+
+ try {
+ process.kill(pid, 0);
+ // Still alive, force kill
+ process.kill(pid, 'SIGKILL');
+ } catch {
+ // Process terminated
+ }
+
+ // Clean up PID file
+ if (fs.existsSync(pidFile)) {
+ fs.unlinkSync(pidFile);
+ }
+
+ return true;
+ } catch (error) {
+ // Clean up PID file on any error
+ if (fs.existsSync(pidFile)) {
+ fs.unlinkSync(pidFile);
+ }
+ return false;
+ }
+}
+
+/**
+ * Get PID of background daemon from PID file
+ */
+function getBackgroundDaemonPid(projectRoot: string): number | null {
+ const pidFile = join(projectRoot, '.claude-flow', 'daemon.pid');
+
+ if (!fs.existsSync(pidFile)) {
+ return null;
+ }
+
+ try {
+ const pid = parseInt(fs.readFileSync(pidFile, 'utf-8').trim(), 10);
+ return isNaN(pid) ? null : pid;
+ } catch {
+ return null;
+ }
+}
+
+/**
+ * Check if a process is running
+ */
+function isProcessRunning(pid: number): boolean {
+ try {
+ process.kill(pid, 0); // Signal 0 = check if alive
+ return true;
+ } catch {
+ return false;
+ }
+}
+
// Status subcommand
const statusCommand: Command = {
name: 'status',
@@ -135,21 +316,30 @@ const statusCommand: Command = {
],
action: async (ctx: CommandContext): Promise<CommandResult> => {
const verbose = ctx.flags.verbose as boolean;
+ const projectRoot = process.cwd();
try {
- const daemon = getDaemon(process.cwd());
+ const daemon = getDaemon(projectRoot);
const status = daemon.getStatus();
+ // Also check for background daemon
+ const bgPid = getBackgroundDaemonPid(projectRoot);
+ const bgRunning = bgPid ? isProcessRunning(bgPid) : false;
+
+ const isRunning = status.running || bgRunning;
+ const displayPid = bgPid || status.pid;
+
output.writeln();
// Daemon status box
- const statusIcon = status.running ? output.success('●') : output.error('○');
- const statusText = status.running ? output.success('RUNNING') : output.error('STOPPED');
+ const statusIcon = isRunning ? output.success('●') : output.error('○');
+ const statusText = isRunning ? output.success('RUNNING') : output.error('STOPPED');
+ const mode = bgRunning ? output.dim(' (background)') : status.running ? output.dim(' (foreground)') : '';
output.printBox(
[
- `Status: ${statusIcon} ${statusText}`,
- `PID: ${status.pid}`,
+ `Status: ${statusIcon} ${statusText}${mode}`,
+ `PID: ${displayPid}`,
status.startedAt ? `Started: ${status.startedAt.toISOString()}` : '',
`Workers Enabled: ${status.config.workers.filter(w => w.enabled).length}`,
`Max Concurrent: ${status.config.maxConcurrent}`,