claude-flow 3.28.0 → 3.29.0

package/v3/@claude-flow/cli/dist/src/services/event-stream.js

@@ -0,0 +1,27 @@
+/**
+ * NDJSON Event Stream for CLI --stream mode
+ *
+ * Emits newline-delimited JSON events to stdout for consumption
+ * by Claude Code's Monitor tool. Each event includes schema versioning.
+ *
+ * @see ADR-091: NDJSON event streaming infrastructure
+ */
+import { randomBytes } from 'crypto';
+/** Generate a short unique run ID (e.g. run_m1abc_3f2a1b) */
+export function createRunId() {
+    return `run_${Date.now().toString(36)}_${randomBytes(3).toString('hex')}`;
+}
+/** Write one NDJSON line to stdout with schema and timestamp auto-populated */
+export function emitEvent(event) {
+    const full = Object.assign({ schema: 'ruflo.event.v1', ts: new Date().toISOString() }, event);
+    process.stdout.write(JSON.stringify(full) + '\n');
+}
+/** Convenience wrapper that binds a runId to an emitter */
+export function createEventEmitter(runId) {
+    return {
+        emit(event, data) {
+            emitEvent({ runId, event, ...data });
+        },
+    };
+}
+//# sourceMappingURL=event-stream.js.map

package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js

@@ -78,18 +78,18 @@ export const HEADLESS_WORKER_CONFIGS = {
         description: 'AI-powered security analysis',
         enabled: true,
         headless: {
-            promptTemplate: `Analyze this codebase for security vulnerabilities:
-- Check for hardcoded secrets (API keys, passwords)
-- Identify SQL injection risks
-- Find XSS vulnerabilities
-- Check for insecure dependencies
-- Identify authentication/authorization issues
-
-Provide a JSON report with:
-{
-  "vulnerabilities": [{ "severity": "high|medium|low", "file": "...", "line": N, "description": "..." }],
-  "riskScore": 0-100,
-  "recommendations": ["..."]
+            promptTemplate: `Analyze this codebase for security vulnerabilities:
+- Check for hardcoded secrets (API keys, passwords)
+- Identify SQL injection risks
+- Find XSS vulnerabilities
+- Check for insecure dependencies
+- Identify authentication/authorization issues
+
+Provide a JSON report with:
+{
+  "vulnerabilities": [{ "severity": "high|medium|low", "file": "...", "line": N, "description": "..." }],
+  "riskScore": 0-100,
+  "recommendations": ["..."]
 }`,
             sandbox: 'strict',
             model: 'haiku',
@@ -106,13 +106,13 @@ Provide a JSON report with:
         description: 'AI optimization suggestions',
         enabled: true,
         headless: {
-            promptTemplate: `Analyze this codebase for performance optimizations:
-- Identify N+1 query patterns
-- Find unnecessary re-renders in React
-- Suggest caching opportunities
-- Identify memory leaks
-- Find redundant computations
-
+            promptTemplate: `Analyze this codebase for performance optimizations:
+- Identify N+1 query patterns
+- Find unnecessary re-renders in React
+- Suggest caching opportunities
+- Identify memory leaks
+- Find redundant computations
+
 Provide actionable suggestions with code examples.`,
             sandbox: 'permissive',
             model: 'sonnet',
@@ -129,13 +129,13 @@ Provide actionable suggestions with code examples.`,
         description: 'AI test gap analysis',
         enabled: true,
         headless: {
-            promptTemplate: `Analyze test coverage and identify gaps:
-- Find untested functions and classes
-- Identify edge cases not covered
-- Suggest new test scenarios
-- Check for missing error handling tests
-- Identify integration test gaps
-
+            promptTemplate: `Analyze test coverage and identify gaps:
+- Find untested functions and classes
+- Identify edge cases not covered
+- Suggest new test scenarios
+- Check for missing error handling tests
+- Identify integration test gaps
+
 For each gap, provide a test skeleton.`,
             sandbox: 'permissive',
             model: 'sonnet',
@@ -152,13 +152,13 @@ For each gap, provide a test skeleton.`,
         description: 'AI documentation generation',
         enabled: false,
         headless: {
-            promptTemplate: `Generate documentation for undocumented code:
-- Add JSDoc comments to functions
-- Create README sections for modules
-- Document API endpoints
-- Add inline comments for complex logic
-- Generate usage examples
-
+            promptTemplate: `Generate documentation for undocumented code:
+- Add JSDoc comments to functions
+- Create README sections for modules
+- Document API endpoints
+- Add inline comments for complex logic
+- Generate usage examples
+
 Focus on public APIs and exported functions.`,
             sandbox: 'permissive',
             model: 'haiku',
@@ -175,19 +175,19 @@ Focus on public APIs and exported functions.`,
         description: 'Deep knowledge acquisition',
         enabled: false,
         headless: {
-            promptTemplate: `Deeply analyze this codebase to learn:
-- Architectural patterns used
-- Coding conventions
-- Domain-specific terminology
-- Common patterns and idioms
-- Team preferences
-
-Provide insights as JSON:
-{
-  "architecture": { "patterns": [...], "style": "..." },
-  "conventions": { "naming": "...", "formatting": "..." },
-  "domains": ["..."],
-  "insights": ["..."]
+            promptTemplate: `Deeply analyze this codebase to learn:
+- Architectural patterns used
+- Coding conventions
+- Domain-specific terminology
+- Common patterns and idioms
+- Team preferences
+
+Provide insights as JSON:
+{
+  "architecture": { "patterns": [...], "style": "..." },
+  "conventions": { "naming": "...", "formatting": "..." },
+  "domains": ["..."],
+  "insights": ["..."]
 }`,
             sandbox: 'strict',
             model: 'opus',
@@ -204,13 +204,13 @@ Provide insights as JSON:
         description: 'AI refactoring suggestions',
         enabled: false,
         headless: {
-            promptTemplate: `Suggest refactoring opportunities:
-- Identify code duplication
-- Suggest better abstractions
-- Find opportunities for design patterns
-- Identify overly complex functions
-- Suggest module reorganization
-
+            promptTemplate: `Suggest refactoring opportunities:
+- Identify code duplication
+- Suggest better abstractions
+- Find opportunities for design patterns
+- Identify overly complex functions
+- Suggest module reorganization
+
 Provide before/after code examples.`,
             sandbox: 'permissive',
             model: 'sonnet',
@@ -227,13 +227,13 @@ Provide before/after code examples.`,
         description: 'Deep code analysis',
         enabled: false,
         headless: {
-            promptTemplate: `Perform deep analysis of this codebase:
-- Understand data flow
-- Map dependencies
-- Identify architectural issues
-- Find potential bugs
-- Analyze error handling
-
+            promptTemplate: `Perform deep analysis of this codebase:
+- Understand data flow
+- Map dependencies
+- Identify architectural issues
+- Find potential bugs
+- Analyze error handling
+
 Provide comprehensive report.`,
             sandbox: 'strict',
             model: 'opus',
@@ -250,18 +250,18 @@ Provide comprehensive report.`,
         description: 'Predictive preloading',
         enabled: false,
         headless: {
-            promptTemplate: `Based on recent activity, predict what the developer needs:
-- Files likely to be edited next
-- Tests that should be run
-- Documentation to reference
-- Dependencies to check
-
-Provide preload suggestions as JSON:
-{
-  "filesToPreload": ["..."],
-  "testsToRun": ["..."],
-  "docsToReference": ["..."],
-  "confidence": 0.0-1.0
+            promptTemplate: `Based on recent activity, predict what the developer needs:
+- Files likely to be edited next
+- Tests that should be run
+- Documentation to reference
+- Dependencies to check
+
+Provide preload suggestions as JSON:
+{
+  "filesToPreload": ["..."],
+  "testsToRun": ["..."],
+  "docsToReference": ["..."],
+  "confidence": 0.0-1.0
 }`,
             sandbox: 'strict',
             model: 'haiku',
@@ -980,20 +980,20 @@ export class HeadlessWorkerExecutor extends EventEmitter {
      */
     buildPrompt(template, context) {
         if (!context) {
-            return `${template}
-
-## Instructions
-
+            return `${template}
+
+## Instructions
+
 Analyze the codebase and provide your response following the format specified in the task.`;
         }
-        return `${template}
-
-## Codebase Context
-
-${context}
-
-## Instructions
-
+        return `${template}
+
+## Codebase Context
+
+${context}
+
+## Instructions
+
 Analyze the above codebase context and provide your response following the format specified in the task.`;
     }
     /**

package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ADR-091 Phase 2 -- Stateless Loop Worker Runner
+ *
+ * Designed for /loop execution: runs a single worker iteration and returns
+ * metadata that the caller can use with ScheduleWakeup.
+ */
+export interface LoopWorkerResult {
+    workerType: string;
+    success: boolean;
+    suggestedDelay: number;
+    reason: string;
+    loopPrompt: string;
+    metrics?: Record<string, unknown>;
+}
+export declare function runLoopWorker(workerType: string): Promise<LoopWorkerResult>;
+//# sourceMappingURL=loop-worker-runner.d.ts.map

package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.js

@@ -0,0 +1,34 @@
+/**
+ * ADR-091 Phase 2 -- Stateless Loop Worker Runner
+ *
+ * Designed for /loop execution: runs a single worker iteration and returns
+ * metadata that the caller can use with ScheduleWakeup.
+ */
+import { execSync } from 'child_process';
+import { getCacheWarmDelay } from './runtime-capabilities.js';
+export async function runLoopWorker(workerType) {
+    const startMs = Date.now();
+    let success = false;
+    let reason = '';
+    try {
+        const safeWorkerType = workerType.replace(/[^a-zA-Z0-9_-]/g, '');
+        const stdout = execSync(`npx @claude-flow/cli hooks worker dispatch --trigger ${safeWorkerType}`, { encoding: 'utf-8', timeout: 120_000, stdio: ['ignore', 'pipe', 'pipe'] });
+        success = true;
+        reason = stdout.trim().slice(0, 200) || `${workerType} completed`;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        reason = `${workerType} failed: ${msg.slice(0, 200)}`;
+    }
+    const durationMs = Date.now() - startMs;
+    const suggestedDelay = getCacheWarmDelay();
+    return {
+        workerType,
+        success,
+        suggestedDelay,
+        reason,
+        loopPrompt: `Run ${workerType} worker and report results`,
+        metrics: { durationMs, timestamp: new Date().toISOString() },
+    };
+}
+//# sourceMappingURL=loop-worker-runner.js.map

package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js

@@ -116,10 +116,10 @@ export async function runDistillation(options) {
             return { ...report, corrupt: true, skipped: 'memory DB reports corruption — run recoverMemoryDatabase first' };
         }
         // M0: incremental cursor table (per namespace, by monotonic rowid).
-        db.exec(`CREATE TABLE IF NOT EXISTS distill_state (
-      namespace TEXT PRIMARY KEY,
-      last_rowid INTEGER NOT NULL DEFAULT 0,
-      last_run_at INTEGER
+        db.exec(`CREATE TABLE IF NOT EXISTS distill_state (
+      namespace TEXT PRIMARY KEY,
+      last_rowid INTEGER NOT NULL DEFAULT 0,
+      last_run_at INTEGER
     )`);
         // Which namespaces to process.
         const nsAll = db.prepare("SELECT DISTINCT COALESCE(namespace,'default') AS ns FROM memory_entries WHERE embedding IS NOT NULL").all().map(r => r.ns);

package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ADR-091 Phase 1 -- Runtime Capabilities Detection
+ *
+ * Detects the host environment and exposes which execution primitives are
+ * available so that higher-level services can choose the right path:
+ *   1. claude-code-native  -- full Claude Code tooling (loop, monitor, cron, teams)
+ *   2. mcp-fallback        -- MCP transport active but native tools missing
+ *   3. ci-daemon           -- headless / CI, use detached daemon
+ */
+export interface RuntimeCapabilities {
+    loop: boolean;
+    monitor: boolean;
+    cron: boolean;
+    teams: boolean;
+    worktreeIsolation: boolean;
+    pushNotification: boolean;
+}
+export type RuntimeTier = 'claude-code-native' | 'mcp-fallback' | 'ci-daemon';
+export declare function detectCapabilities(): RuntimeCapabilities;
+export declare function getRuntimeTier(): RuntimeTier;
+export declare function getCacheWarmDelay(providerCacheTtlSeconds?: number): number;
+//# sourceMappingURL=runtime-capabilities.d.ts.map

package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.js

@@ -0,0 +1,45 @@
+/**
+ * ADR-091 Phase 1 -- Runtime Capabilities Detection
+ *
+ * Detects the host environment and exposes which execution primitives are
+ * available so that higher-level services can choose the right path:
+ *   1. claude-code-native  -- full Claude Code tooling (loop, monitor, cron, teams)
+ *   2. mcp-fallback        -- MCP transport active but native tools missing
+ *   3. ci-daemon           -- headless / CI, use detached daemon
+ */
+function isClaudeCodeNative() {
+    return !!(process.env.CLAUDE_CODE ||
+        process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS);
+}
+function isMcpTransportActive() {
+    return (!process.stdin.isTTY &&
+        process.env.CLAUDE_FLOW_MCP_TRANSPORT === 'stdio');
+}
+function isCiOrHeadless() {
+    return !!(process.env.CI || process.env.CLAUDE_FLOW_HEADLESS);
+}
+export function detectCapabilities() {
+    const native = isClaudeCodeNative();
+    const teamsEnabled = !!process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
+    return {
+        loop: native,
+        monitor: native,
+        cron: native,
+        teams: native && teamsEnabled,
+        worktreeIsolation: native,
+        pushNotification: native,
+    };
+}
+export function getRuntimeTier() {
+    if (isClaudeCodeNative())
+        return 'claude-code-native';
+    if (isMcpTransportActive())
+        return 'mcp-fallback';
+    if (isCiOrHeadless())
+        return 'ci-daemon';
+    return 'mcp-fallback';
+}
+export function getCacheWarmDelay(providerCacheTtlSeconds) {
+    return Math.min(270, (providerCacheTtlSeconds ?? 300) * 0.9);
+}
+//# sourceMappingURL=runtime-capabilities.js.map

package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js

@@ -71,29 +71,29 @@ function parseArgs() {
  * Print help message
  */
 function printHelp() {
-    console.log(`
-Seraphine Genesis Deployer
-==========================
-
-Deploy the foundational Claude Flow pattern model.
-
-Usage:
-  npx ts-node deploy-seraphine.ts [options]
-
-Options:
-  --output, -o <path>     Output file path
-  --to-ipfs, --ipfs       Upload to IPFS
-  --anonymize, -a <level> Anonymization level (minimal|standard|strict|paranoid)
-  --gateway, -g <url>     IPFS gateway URL
-  --no-pin                Don't pin to pinning service
-  --no-validate           Skip validation
-  --verbose, -v           Verbose output
-  --help, -h              Show this help
-
-Examples:
-  npx ts-node deploy-seraphine.ts --output ./seraphine-genesis.cfp.json
-  npx ts-node deploy-seraphine.ts --to-ipfs --anonymize strict
-  npx ts-node deploy-seraphine.ts --to-ipfs --gateway https://dweb.link
+    console.log(`
+Seraphine Genesis Deployer
+==========================
+
+Deploy the foundational Claude Flow pattern model.
+
+Usage:
+  npx ts-node deploy-seraphine.ts [options]
+
+Options:
+  --output, -o <path>     Output file path
+  --to-ipfs, --ipfs       Upload to IPFS
+  --anonymize, -a <level> Anonymization level (minimal|standard|strict|paranoid)
+  --gateway, -g <url>     IPFS gateway URL
+  --no-pin                Don't pin to pinning service
+  --no-validate           Skip validation
+  --verbose, -v           Verbose output
+  --help, -h              Show this help
+
+Examples:
+  npx ts-node deploy-seraphine.ts --output ./seraphine-genesis.cfp.json
+  npx ts-node deploy-seraphine.ts --to-ipfs --anonymize strict
+  npx ts-node deploy-seraphine.ts --to-ipfs --gateway https://dweb.link
 `);
 }
 /**