claude-flow 3.32.33 → 3.32.35

package/v3/@claude-flow/cli/dist/src/services/pheromone-adaptive.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ADR-330 — Adaptive Pheromone Swarm Consensus.
+ *
+ * This is a scheduling eligibility layer, not an agent terminator. It learns a
+ * bounded EMA signal per agent, compares agents against role-local baselines,
+ * and may suspend them from future dispatch. Coordinators and other protected
+ * roles remain eligible, quorum is never crossed, pruning per round is capped,
+ * and exploration periodically reactivates a suspended agent.
+ */
+export declare const APSC_SCHEMA = "ruflo.apsc-state/v1";
+export interface ApscConfig {
+    alpha: number;
+    beta: number;
+    gamma: number;
+    emaDecay: number;
+    pruningFactor: number;
+    reactivationThreshold: number;
+    minActiveAgents: number;
+    minSamples: number;
+    maxSuspendFraction: number;
+    explorationRate: number;
+    dryRun: boolean;
+    protectedRoles: string[];
+}
+export interface ApscAgentState {
+    agentId: string;
+    role: string;
+    status: 'active' | 'suspended';
+    samples: number;
+    rawScore: number;
+    normalizedScore: number;
+    emaScore: number;
+    lastUpdatedAt: string;
+    lastDecision?: 'keep' | 'would-suspend' | 'suspend' | 'reactivate' | 'explore';
+}
+export interface ApscState {
+    schemaVersion: typeof APSC_SCHEMA;
+    config: ApscConfig;
+    round: number;
+    threshold: number;
+    roleBaselines: Record<string, number>;
+    agents: Record<string, ApscAgentState>;
+}
+export interface ApscSignal {
+    agentId: string;
+    role: string;
+    taskSuccess: number;
+    normalizedLatency: number;
+    consensusAlignment: number;
+}
+export interface ApscDecision {
+    agentId: string;
+    score: number;
+    normalizedScore: number;
+    emaScore: number;
+    threshold: number;
+    action: 'keep' | 'would-suspend' | 'suspend' | 'reactivate' | 'explore';
+    applied: boolean;
+    reason: string;
+    activeAgents: number;
+    suspendedAgents: number;
+}
+export declare const DEFAULT_APSC_CONFIG: ApscConfig;
+export declare function normalizeApscConfig(input?: Partial<ApscConfig>): ApscConfig;
+export declare function createApscState(config?: Partial<ApscConfig>): ApscState;
+export declare function recordApscSignal(current: ApscState, signal: ApscSignal, now?: number): {
+    state: ApscState;
+    decision: ApscDecision;
+};
+export declare function isApscAgentEligible(state: ApscState | undefined, agentId: string): boolean;
+//# sourceMappingURL=pheromone-adaptive.d.ts.map

package/v3/@claude-flow/cli/dist/src/services/pheromone-adaptive.js

@@ -0,0 +1,214 @@
+/**
+ * ADR-330 — Adaptive Pheromone Swarm Consensus.
+ *
+ * This is a scheduling eligibility layer, not an agent terminator. It learns a
+ * bounded EMA signal per agent, compares agents against role-local baselines,
+ * and may suspend them from future dispatch. Coordinators and other protected
+ * roles remain eligible, quorum is never crossed, pruning per round is capped,
+ * and exploration periodically reactivates a suspended agent.
+ */
+export const APSC_SCHEMA = 'ruflo.apsc-state/v1';
+export const DEFAULT_APSC_CONFIG = {
+    alpha: 0.5,
+    beta: 0.2,
+    gamma: 0.3,
+    emaDecay: 0.85,
+    pruningFactor: 0.6,
+    reactivationThreshold: 0.75,
+    minActiveAgents: 3,
+    minSamples: 3,
+    maxSuspendFraction: 0.25,
+    explorationRate: 0.1,
+    dryRun: true,
+    protectedRoles: ['coordinator', 'queen', 'security-architect', 'security-auditor'],
+};
+const unit = (value, field) => {
+    if (!Number.isFinite(value) || value < 0 || value > 1) {
+        throw new Error(`${field} must be a finite number in [0,1]`);
+    }
+    return value;
+};
+export function normalizeApscConfig(input = {}) {
+    const alpha = unit(input.alpha ?? DEFAULT_APSC_CONFIG.alpha, 'alpha');
+    const beta = unit(input.beta ?? DEFAULT_APSC_CONFIG.beta, 'beta');
+    const gamma = unit(input.gamma ?? DEFAULT_APSC_CONFIG.gamma, 'gamma');
+    const weight = alpha + beta + gamma;
+    if (weight <= 0)
+        throw new Error('at least one APSC score weight must be positive');
+    const minActiveAgents = input.minActiveAgents ?? DEFAULT_APSC_CONFIG.minActiveAgents;
+    const minSamples = input.minSamples ?? DEFAULT_APSC_CONFIG.minSamples;
+    if (!Number.isInteger(minActiveAgents) || minActiveAgents < 1 || minActiveAgents > 50) {
+        throw new Error('minActiveAgents must be an integer in [1,50]');
+    }
+    if (!Number.isInteger(minSamples) || minSamples < 1 || minSamples > 1000) {
+        throw new Error('minSamples must be an integer in [1,1000]');
+    }
+    const protectedRoles = [...new Set((input.protectedRoles ?? DEFAULT_APSC_CONFIG.protectedRoles)
+            .map((role) => role.trim().toLowerCase())
+            .filter(Boolean))].sort();
+    return {
+        alpha: alpha / weight,
+        beta: beta / weight,
+        gamma: gamma / weight,
+        emaDecay: unit(input.emaDecay ?? DEFAULT_APSC_CONFIG.emaDecay, 'emaDecay'),
+        pruningFactor: unit(input.pruningFactor ?? DEFAULT_APSC_CONFIG.pruningFactor, 'pruningFactor'),
+        reactivationThreshold: unit(input.reactivationThreshold ?? DEFAULT_APSC_CONFIG.reactivationThreshold, 'reactivationThreshold'),
+        minActiveAgents,
+        minSamples,
+        maxSuspendFraction: unit(input.maxSuspendFraction ?? DEFAULT_APSC_CONFIG.maxSuspendFraction, 'maxSuspendFraction'),
+        explorationRate: unit(input.explorationRate ?? DEFAULT_APSC_CONFIG.explorationRate, 'explorationRate'),
+        dryRun: input.dryRun ?? DEFAULT_APSC_CONFIG.dryRun,
+        protectedRoles,
+    };
+}
+export function createApscState(config = {}) {
+    return {
+        schemaVersion: APSC_SCHEMA,
+        config: normalizeApscConfig(config),
+        round: 0,
+        threshold: 0.5,
+        roleBaselines: {},
+        agents: {},
+    };
+}
+function counts(state) {
+    const values = Object.values(state.agents);
+    return {
+        activeAgents: values.filter((agent) => agent.status === 'active').length,
+        suspendedAgents: values.filter((agent) => agent.status === 'suspended').length,
+    };
+}
+function protectedRole(state, role) {
+    return state.config.protectedRoles.includes(role.toLowerCase());
+}
+export function recordApscSignal(current, signal, now = Date.now()) {
+    if (!/^[A-Za-z0-9._:-]{1,160}$/.test(signal.agentId))
+        throw new Error('invalid APSC agentId');
+    if (!/^[A-Za-z0-9._:-]{1,100}$/.test(signal.role))
+        throw new Error('invalid APSC role');
+    const config = normalizeApscConfig(current.config);
+    const state = {
+        ...current,
+        config,
+        round: current.round + 1,
+        roleBaselines: { ...current.roleBaselines },
+        agents: Object.fromEntries(Object.entries(current.agents).map(([id, agent]) => [id, { ...agent }])),
+    };
+    const success = unit(signal.taskSuccess, 'taskSuccess');
+    const latency = unit(signal.normalizedLatency, 'normalizedLatency');
+    const alignment = unit(signal.consensusAlignment, 'consensusAlignment');
+    const rawScore = config.alpha * success + config.beta * (1 - latency) + config.gamma * alignment;
+    const role = signal.role.toLowerCase();
+    // Compare against peers in the same role, excluding the current agent.
+    // Letting an agent update its own baseline before normalization caused a
+    // persistently weak agent to redefine "normal" downward and reactivate
+    // without any recovery.
+    const rolePeers = Object.values(state.agents)
+        .filter((item) => item.agentId !== signal.agentId && item.role === role && item.samples > 0);
+    const peerMean = rolePeers.length
+        ? rolePeers.reduce((sum, item) => sum + item.rawScore, 0) / rolePeers.length
+        : undefined;
+    const priorRoleBaseline = peerMean ?? state.roleBaselines[role] ?? rawScore;
+    // A common absolute scale unfairly prunes coordinators/specialists whose
+    // observable task signal differs by role. Center each score on its role EMA.
+    const normalizedScore = Math.max(0, Math.min(1, 0.5 + rawScore - priorRoleBaseline));
+    const previous = state.agents[signal.agentId];
+    const agent = {
+        agentId: signal.agentId,
+        role,
+        status: previous?.status ?? 'active',
+        samples: (previous?.samples ?? 0) + 1,
+        rawScore,
+        normalizedScore,
+        emaScore: previous
+            ? config.emaDecay * previous.emaScore + (1 - config.emaDecay) * normalizedScore
+            : normalizedScore,
+        lastUpdatedAt: new Date(now).toISOString(),
+        lastDecision: 'keep',
+    };
+    state.agents[signal.agentId] = agent;
+    const allRoleAgents = Object.values(state.agents).filter((item) => item.role === role);
+    const observedRoleMean = allRoleAgents.reduce((sum, item) => sum + item.rawScore, 0) / allRoleAgents.length;
+    state.roleBaselines[role] = config.emaDecay * priorRoleBaseline + (1 - config.emaDecay) * observedRoleMean;
+    const mature = Object.values(state.agents).filter((item) => item.samples >= config.minSamples);
+    const observedMean = mature.length
+        ? mature.reduce((sum, item) => sum + item.emaScore, 0) / mature.length
+        : state.threshold;
+    state.threshold = config.emaDecay * state.threshold + (1 - config.emaDecay) * observedMean;
+    let action = 'keep';
+    let applied = false;
+    let reason = agent.samples < config.minSamples
+        ? `warm-up ${agent.samples}/${config.minSamples}`
+        : 'within adaptive envelope';
+    if (agent.status === 'suspended' && agent.emaScore >= state.threshold * config.reactivationThreshold) {
+        action = 'reactivate';
+        reason = 'score recovered above reactivation threshold';
+        if (!config.dryRun) {
+            agent.status = 'active';
+            applied = true;
+        }
+    }
+    else if (agent.status === 'active'
+        && agent.samples >= config.minSamples
+        && !protectedRole(state, agent.role)
+        && agent.emaScore < state.threshold * config.pruningFactor) {
+        const before = counts(state);
+        const maxThisRound = Math.floor(before.activeAgents * config.maxSuspendFraction);
+        const quorumCapacity = Math.max(0, before.activeAgents - config.minActiveAgents);
+        if (maxThisRound < 1 || quorumCapacity < 1) {
+            reason = 'safety floor prevents suspension';
+        }
+        else {
+            action = config.dryRun ? 'would-suspend' : 'suspend';
+            reason = 'score below adaptive pruning threshold';
+            if (!config.dryRun) {
+                agent.status = 'suspended';
+                applied = true;
+            }
+        }
+    }
+    else if (protectedRole(state, agent.role)) {
+        reason = 'protected role remains eligible';
+    }
+    // Deterministic exploration: at a bounded cadence, reactivate the stalest
+    // suspended agent so a transient failure cannot permanently exclude it.
+    if (!config.dryRun && config.explorationRate > 0) {
+        const cadence = Math.max(1, Math.round(1 / config.explorationRate));
+        if (state.round % cadence === 0) {
+            const explorer = Object.values(state.agents)
+                .filter((item) => item.status === 'suspended')
+                .sort((a, b) => a.lastUpdatedAt.localeCompare(b.lastUpdatedAt) || a.agentId.localeCompare(b.agentId))[0];
+            if (explorer) {
+                explorer.status = 'active';
+                explorer.lastDecision = 'explore';
+                if (explorer.agentId === agent.agentId) {
+                    action = 'explore';
+                    applied = true;
+                    reason = 'bounded exploration reactivation';
+                }
+            }
+        }
+    }
+    agent.lastDecision = action;
+    const after = counts(state);
+    return {
+        state,
+        decision: {
+            agentId: agent.agentId,
+            score: rawScore,
+            normalizedScore,
+            emaScore: agent.emaScore,
+            threshold: state.threshold,
+            action,
+            applied,
+            reason,
+            ...after,
+        },
+    };
+}
+export function isApscAgentEligible(state, agentId) {
+    if (!state || state.config.dryRun)
+        return true;
+    return state.agents[agentId]?.status !== 'suspended';
+}
+//# sourceMappingURL=pheromone-adaptive.js.map

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

@@ -70,7 +70,10 @@ const NO_DISTILL_ENV = 'RUFLO_DAEMON_NO_DISTILL';
 // half a day; set RUFLO_DAEMON_TTL_SECS=0 (or `--ttl 0`) to opt out. Idle
 // shutdown is opt-in (0 = disabled) since a legitimately quiet daemon is not a leak.
 const DEFAULT_DAEMON_TTL_MS = 12 * 60 * 60 * 1000;
-const DEFAULT_DAEMON_IDLE_SHUTDOWN_MS = 0;
+// #2834 — an auto-started daemon must not remain alive for the full 12h TTL
+// after its workspace goes idle. Explicit 0 via config/env still disables the
+// idle cap for operators who intentionally want a resident daemon.
+const DEFAULT_DAEMON_IDLE_SHUTDOWN_MS = 30 * 60 * 1000;
 /**
  * Read a non-negative seconds value from an env var and return it as ms.
  * Unlike the `parseInt(x) || default` idiom used elsewhere, an explicit `0`

package/v3/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.32.33",
+  "version": "3.32.35",
   "type": "module",
   "description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",

package/v3/@claude-flow/shared/dist/core/config/loader.js

@@ -100,7 +100,7 @@ function loadEnvConfig() {
     const defaultSwarm = defaultSystemConfig.swarm ?? { topology: 'hierarchical-mesh', maxAgents: 20 };
     if (process.env.CLAUDE_FLOW_SWARM_TOPOLOGY) {
         const topology = process.env.CLAUDE_FLOW_SWARM_TOPOLOGY;
-        if (['hierarchical', 'mesh', 'ring', 'star', 'adaptive', 'hierarchical-mesh'].includes(topology)) {
+        if (['hierarchical', 'mesh', 'ring', 'star', 'adaptive', 'pheromone-adaptive', 'hierarchical-mesh'].includes(topology)) {
             config.swarm = {
                 ...defaultSwarm,
                 topology,

package/v3/@claude-flow/shared/dist/core/config/schema.d.ts

@@ -147,7 +147,7 @@ export declare const TaskConfigSchema: z.ZodObject<{
  * Swarm configuration schema
  */
 export declare const SwarmConfigSchema: z.ZodObject<{
-    topology: z.ZodEnum<["hierarchical", "mesh", "ring", "star", "adaptive", "hierarchical-mesh"]>;
+    topology: z.ZodEnum<["hierarchical", "mesh", "ring", "star", "adaptive", "pheromone-adaptive", "hierarchical-mesh"]>;
     maxAgents: z.ZodDefault<z.ZodNumber>;
     autoScale: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
@@ -211,7 +211,7 @@ export declare const SwarmConfigSchema: z.ZodObject<{
     }>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive";
+    topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive" | "pheromone-adaptive";
     maxAgents: number;
     metadata?: Record<string, unknown> | undefined;
     autoScale?: {
@@ -235,7 +235,7 @@ export declare const SwarmConfigSchema: z.ZodObject<{
         flushIntervalMs: number;
     } | undefined;
 }, {
-    topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive";
+    topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive" | "pheromone-adaptive";
     maxAgents?: number | undefined;
     metadata?: Record<string, unknown> | undefined;
     autoScale?: {
@@ -819,7 +819,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
         version?: string | undefined;
     }>>;
     swarm: z.ZodOptional<z.ZodObject<{
-        topology: z.ZodEnum<["hierarchical", "mesh", "ring", "star", "adaptive", "hierarchical-mesh"]>;
+        topology: z.ZodEnum<["hierarchical", "mesh", "ring", "star", "adaptive", "pheromone-adaptive", "hierarchical-mesh"]>;
         maxAgents: z.ZodDefault<z.ZodNumber>;
         autoScale: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -883,7 +883,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
         }>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive";
+        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive" | "pheromone-adaptive";
         maxAgents: number;
         metadata?: Record<string, unknown> | undefined;
         autoScale?: {
@@ -907,7 +907,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
             flushIntervalMs: number;
         } | undefined;
     }, {
-        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive";
+        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive" | "pheromone-adaptive";
         maxAgents?: number | undefined;
         metadata?: Record<string, unknown> | undefined;
         autoScale?: {
@@ -1205,7 +1205,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
         version?: string | undefined;
     }>>;
     swarm: z.ZodOptional<z.ZodObject<{
-        topology: z.ZodEnum<["hierarchical", "mesh", "ring", "star", "adaptive", "hierarchical-mesh"]>;
+        topology: z.ZodEnum<["hierarchical", "mesh", "ring", "star", "adaptive", "pheromone-adaptive", "hierarchical-mesh"]>;
         maxAgents: z.ZodDefault<z.ZodNumber>;
         autoScale: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1269,7 +1269,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
         }>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive";
+        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive" | "pheromone-adaptive";
         maxAgents: number;
         metadata?: Record<string, unknown> | undefined;
         autoScale?: {
@@ -1293,7 +1293,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
             flushIntervalMs: number;
         } | undefined;
     }, {
-        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive";
+        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive" | "pheromone-adaptive";
         maxAgents?: number | undefined;
         metadata?: Record<string, unknown> | undefined;
         autoScale?: {
@@ -1591,7 +1591,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
         version?: string | undefined;
     }>>;
     swarm: z.ZodOptional<z.ZodObject<{
-        topology: z.ZodEnum<["hierarchical", "mesh", "ring", "star", "adaptive", "hierarchical-mesh"]>;
+        topology: z.ZodEnum<["hierarchical", "mesh", "ring", "star", "adaptive", "pheromone-adaptive", "hierarchical-mesh"]>;
         maxAgents: z.ZodDefault<z.ZodNumber>;
         autoScale: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1655,7 +1655,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
         }>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive";
+        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive" | "pheromone-adaptive";
         maxAgents: number;
         metadata?: Record<string, unknown> | undefined;
         autoScale?: {
@@ -1679,7 +1679,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
             flushIntervalMs: number;
         } | undefined;
     }, {
-        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive";
+        topology: "hierarchical-mesh" | "mesh" | "hierarchical" | "ring" | "star" | "adaptive" | "pheromone-adaptive";
         maxAgents?: number | undefined;
         metadata?: Record<string, unknown> | undefined;
         autoScale?: {

package/v3/@claude-flow/shared/dist/core/config/schema.js

@@ -49,7 +49,7 @@ export const TaskConfigSchema = z.object({
  * Swarm configuration schema
  */
 export const SwarmConfigSchema = z.object({
-    topology: z.enum(['hierarchical', 'mesh', 'ring', 'star', 'adaptive', 'hierarchical-mesh']),
+    topology: z.enum(['hierarchical', 'mesh', 'ring', 'star', 'adaptive', 'pheromone-adaptive', 'hierarchical-mesh']),
     maxAgents: z.number().int().positive().default(20),
     autoScale: z.object({
         enabled: z.boolean().default(false),

package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts

@@ -8,7 +8,7 @@ import type { IAgent, IAgentConfig } from './agent.interface.js';
 /**
  * Swarm topology types
  */
-export type SwarmTopology = 'hierarchical' | 'mesh' | 'ring' | 'star' | 'adaptive' | 'hierarchical-mesh';
+export type SwarmTopology = 'hierarchical' | 'mesh' | 'ring' | 'star' | 'adaptive' | 'pheromone-adaptive' | 'hierarchical-mesh';
 /**
  * Coordination status
  */

package/v3/@claude-flow/shared/dist/types/swarm.types.js

@@ -53,6 +53,24 @@ export const TopologyPresets = {
             retryPolicy: { maxRetries: 5, backoffMs: 500 }
         }
     },
+    'pheromone-adaptive': {
+        topology: 'pheromone-adaptive',
+        autoScale: {
+            enabled: true,
+            minAgents: 3,
+            maxAgents: 20,
+            scaleUpThreshold: 0.8,
+            scaleDownThreshold: 0.3
+        },
+        coordination: {
+            consensusRequired: true,
+            timeoutMs: 10000,
+            retryPolicy: { maxRetries: 5, backoffMs: 500 }
+        },
+        metadata: {
+            apsc: { dryRun: true, minActiveAgents: 3, minSamples: 3 }
+        }
+    },
     'hierarchical-mesh': {
         topology: 'hierarchical-mesh',
         coordination: {