claude-flow-novice 1.6.4 → 1.6.5

package/.claude-flow-novice/dist/src/coordination/coordination-toggle.js

@@ -1,12 +1,11 @@
 /**
  * CoordinationToggle - Version-aware coordinator factory
  *
- * Provides unified factory interface for V1/V2 coordination systems.
- * Auto-detects version from environment and instantiates appropriate coordinator.
+ * Provides factory interface for V1 coordination system.
+ * V2 SDK coordination has been archived - use V1 or CLI bash coordination instead.
  *
  * @module coordination/coordination-toggle
- */ import { CoordinatorFactory } from './v2/coordinator-factory.js';
-import { createTopologyCoordinator } from './index.js';
+ */ import { createTopologyCoordinator } from './index.js';
 import { Logger } from '../core/logger.js';
 import { V1CoordinatorAdapter } from './adapters/v1-coordinator-adapter.js';
 import { ConfigTranslator } from './config-translator.js';
@@ -14,22 +13,21 @@ import { TelemetrySystem } from '../observability/telemetry.js';
 // Re-export ConfigTranslator for test compatibility
 export { ConfigTranslator } from './config-translator.js';
 /**
- * CoordinationToggle - Factory selector for V1/V2 coordinators
+ * CoordinationToggle - Factory for V1 coordinator
  *
  * Features:
- * - Auto-detects coordination version from COORDINATION_VERSION env var
- * - Translates unified config to version-specific formats
- * - Returns ICoordinator interface regardless of version
- * - Enables gradual V2 migration without breaking V1 usage
+ * - Creates V1 coordination system instances
+ * - Returns ICoordinator interface for compatibility
+ * - V2 SDK coordination has been archived
  *
- * Version Selection Priority:
- * 1. Explicit config.version ('v1' | 'v2')
- * 2. COORDINATION_VERSION environment variable
- * 3. Default: 'v2' (current recommended version)
+ * Version Selection:
+ * - Only 'v1' is supported
+ * - V2 requests will throw error with migration guidance
+ * - Default: 'v1' (only available version)
  *
  * @example
  * ```typescript
- * // Auto-detect version (uses COORDINATION_VERSION env var or defaults to v2)
+ * // Create V1 coordinator (default)
  * const coordinator = await CoordinationToggle.create({
  *   topology: 'mesh',
  *   maxAgents: 5
@@ -42,13 +40,8 @@ export { ConfigTranslator } from './config-translator.js';
  *   maxAgents: 12
  * });
  *
- * // Explicit V2 coordinator
- * const v2Coordinator = await CoordinationToggle.create({
- *   version: 'v2',
- *   topology: 'mesh',
- *   maxAgents: 5,
- *   tokenBudget: 20000
- * });
+ * // V2 is archived - use CLI bash coordination instead
+ * // See: tests/cli-coordination/ for bash-based multi-agent coordination
  * ```
  */ export class CoordinationToggle {
     static logger = new Logger({
@@ -61,32 +54,30 @@ export { ConfigTranslator } from './config-translator.js';
         enablePersistence: true
     });
     /**
-   * Create coordinator instance based on version
+   * Create coordinator instance (V1 only)
    *
-   * Auto-detects coordination version and instantiates appropriate coordinator:
-   * - V1: Legacy coordination system (QueenAgent/MeshCoordinator)
-   * - V2: Modern coordination system (SDK/CLI/Hybrid modes)
+   * Creates V1 coordination system instance.
+   * V2 SDK coordination has been archived.
    *
    * @param config - Unified coordinator configuration
    * @returns Promise resolving to ICoordinator instance
-   * @throws Error if version not supported or dependencies missing
+   * @throws Error if v2 requested or dependencies missing
    */ static async create(config = {}) {
         const startTime = Date.now();
         // Determine effective version
         const version = this.detectVersion(config);
+        // V2 is archived - throw error with migration guidance
+        if (version === 'v2') {
+            throw new Error('V2 SDK coordination has been archived. Use v1 coordination or CLI bash coordination (tests/cli-coordination/).');
+        }
         this.logger.info('CoordinationToggle: Creating coordinator', {
             requestedVersion: config.version ?? 'auto',
             detectedVersion: version,
             topology: config.topology ?? 'mesh',
             maxAgents: config.maxAgents ?? 10
         });
-        // Create version-specific coordinator
-        let coordinator;
-        if (version === 'v1') {
-            coordinator = await this.createV1Coordinator(config);
-        } else {
-            coordinator = await this.createV2Coordinator(config);
-        }
+        // Create V1 coordinator
+        const coordinator = await this.createV1Coordinator(config);
         const initTime = Date.now() - startTime;
         this.logger.info('CoordinationToggle: Coordinator created', {
             version,
@@ -106,11 +97,11 @@ export { ConfigTranslator } from './config-translator.js';
    * Priority:
    * 1. Explicit config.version
    * 2. COORDINATION_VERSION environment variable
-   * 3. Default: 'v2'
+   * 3. Default: 'v1' (only supported version)
    *
    * @private
    * @param config - Unified configuration
-   * @returns Detected version ('v1' | 'v2')
+   * @returns Detected version ('v1' or 'v2' for error handling)
    */ static detectVersion(config) {
         // Priority 1: Explicit version in config
         if (config.version) {
@@ -126,8 +117,8 @@ export { ConfigTranslator } from './config-translator.js';
             }
             return normalized;
         }
-        // Priority 3: Default to v2
-        return 'v2';
+        // Priority 3: Default to v1 (v2 is archived)
+        return 'v1';
     }
     /**
    * Create V1 coordinator (legacy system)
@@ -171,39 +162,6 @@ export { ConfigTranslator } from './config-translator.js';
         return new V1CoordinatorAdapter(v1Coordinator);
     }
     /**
-   * Create V2 coordinator (modern system)
-   *
-   * Translates unified config to V2 FactoryOptions format
-   * and uses CoordinatorFactory for instantiation.
-   *
-   * @private
-   * @param config - Unified configuration
-   * @returns Promise resolving to V2 coordinator
-   */ static async createV2Coordinator(config) {
-        this.logger.debug('Creating V2 coordinator', {
-            topology: config.topology,
-            maxAgents: config.maxAgents,
-            tokenBudget: config.tokenBudget
-        });
-        // Translate unified config to V2 format
-        const v2Config = ConfigTranslator.toV2Config(config);
-        // VUL-5 FIX: Log selected version for transparency
-        this.logger.info('V2 coordinator selected', {
-            version: 'v2',
-            topology: config.topology,
-            source: config.version ? 'explicit' : 'environment/default'
-        });
-        // Track V2 coordinator usage metrics
-        this.telemetry.recordCounter('coordination.version.selected', 1, {
-            version: 'v2',
-            topology: config.topology || 'mesh',
-            source: config.version ? 'explicit' : 'environment',
-            mode: v2Config.mode || 'sdk'
-        });
-        // Use CoordinatorFactory to create V2 coordinator
-        return await CoordinatorFactory.create(v2Config);
-    }
-    /**
    * Get default V1 dependencies for standalone usage
    *
    * Creates minimal dependency set when not provided in config.
@@ -265,20 +223,20 @@ export { ConfigTranslator } from './config-translator.js';
    * console.log(CoordinationToggle.getVersionSummary());
    * // Output:
    * // Coordination Version Detection:
-   * // - COORDINATION_VERSION: v2
-   * // - Default Version: v2
+   * // - COORDINATION_VERSION: v1
+   * // - Default Version: v1
    * // - V1 Available: true
-   * // - V2 Available: true
+   * // - V2 Available: false (archived)
    * ```
    */ static getVersionSummary() {
         const envVersion = process.env.COORDINATION_VERSION?.toLowerCase();
-        const defaultVersion = 'v2';
+        const defaultVersion = 'v1';
         const lines = [
             'Coordination Version Detection:',
             `- COORDINATION_VERSION: ${envVersion ?? 'not set'}`,
             `- Default Version: ${defaultVersion}`,
-            '- V1 Available: true (legacy)',
-            '- V2 Available: true (recommended)'
+            '- V1 Available: true (active)',
+            '- V2 Available: false (archived - use CLI bash coordination)'
         ];
         return lines.join('\n');
     }

package/.claude-flow-novice/dist/src/coordination/coordination-toggle.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/coordination/coordination-toggle.ts"],"names":["CoordinatorFactory","createTopologyCoordinator","Logger","V1CoordinatorAdapter","ConfigTranslator","TelemetrySystem","CoordinationToggle","logger","level","format","destination","telemetry","enableMetrics","enablePersistence","create","config","startTime","Date","now","version","detectVersion","info","requestedVersion","detectedVersion","topology","maxAgents","coordinator","createV1Coordinator","createV2Coordinator","initTime","initTimeMs","recordTimer","String","envVersion","process","env","COORDINATION_VERSION","normalized","toLowerCase","test","Error","debug","v1Config","toV1Config","dependencies","getDefaultV1Dependencies","validateV1Dependencies","source","recordCounter","v1Coordinator","tokenBudget","v2Config","toV2Config","mode","dangerousKeys","key","requiredKeys","join","getVersionSummary","defaultVersion","lines"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/coordination/coordination-toggle.ts"],"names":["createTopologyCoordinator","Logger","V1CoordinatorAdapter","ConfigTranslator","TelemetrySystem","CoordinationToggle","logger","level","format","destination","telemetry","enableMetrics","enablePersistence","create","config","startTime","Date","now","version","detectVersion","Error","info","requestedVersion","detectedVersion","topology","maxAgents","coordinator","createV1Coordinator","initTime","initTimeMs","recordTimer","String","envVersion","process","env","COORDINATION_VERSION","normalized","toLowerCase","test","debug","v1Config","toV1Config","dependencies","getDefaultV1Dependencies","validateV1Dependencies","source","recordCounter","v1Coordinator","dangerousKeys","key","requiredKeys","join","getVersionSummary","defaultVersion","lines"],"mappings":"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"}

package/.claude-flow-novice/dist/src/coordination/shared/core/agent-state.js

@@ -0,0 +1,172 @@
+/**
+ * Agent Coordination - Core State Definitions (Shared)
+ *
+ * Foundational state definitions for the Agent Coordination state machine.
+ * Provides type-safe state enumeration and metadata for agent lifecycle management.
+ *
+ * @module coordination/shared/core/agent-state
+ */ /**
+ * Agent execution states in the coordination lifecycle.
+ *
+ * State transitions are controlled by the state machine and validated
+ * against the transition matrix defined in state-machine-config.ts
+ */ export var AgentState = /*#__PURE__*/ function(AgentState) {
+    /** Agent available for work assignment */ AgentState["IDLE"] = "idle";
+    /** Actively executing assigned task */ AgentState["WORKING"] = "working";
+    /** Blocked on dependency or waiting for external input */ AgentState["WAITING"] = "waiting";
+    /** Assisting another agent with collaborative task */ AgentState["HELPING"] = "helping";
+    /** Deadlocked or in error state requiring intervention */ AgentState["BLOCKED"] = "blocked";
+    /** Agent paused by query controller */ AgentState["PAUSED"] = "paused";
+    /** Task finished successfully */ AgentState["COMPLETED"] = "completed";
+    /** Agent terminated gracefully */ AgentState["TERMINATED"] = "terminated";
+    /** Execution failed with recoverable or fatal error */ AgentState["ERROR"] = "error";
+    return AgentState;
+}({});
+/**
+ * Complete metadata map for all agent states.
+ * Provides comprehensive state information for monitoring and debugging.
+ */ export const AGENT_STATE_METADATA = {
+    ["idle"]: {
+        label: 'Idle',
+        description: 'Agent available for work assignment',
+        isActive: false,
+        isTerminal: false,
+        isError: false
+    },
+    ["working"]: {
+        label: 'Working',
+        description: 'Actively executing assigned task',
+        isActive: true,
+        isTerminal: false,
+        isError: false
+    },
+    ["waiting"]: {
+        label: 'Waiting',
+        description: 'Blocked on dependency or waiting for external input',
+        isActive: false,
+        isTerminal: false,
+        isError: false
+    },
+    ["helping"]: {
+        label: 'Helping',
+        description: 'Assisting another agent with collaborative task',
+        isActive: true,
+        isTerminal: false,
+        isError: false
+    },
+    ["blocked"]: {
+        label: 'Blocked',
+        description: 'Deadlocked or in error state requiring intervention',
+        isActive: false,
+        isTerminal: false,
+        isError: true
+    },
+    ["paused"]: {
+        label: 'Paused',
+        description: 'Agent paused by query controller',
+        isActive: false,
+        isTerminal: false,
+        isError: false
+    },
+    ["completed"]: {
+        label: 'Completed',
+        description: 'Task finished successfully',
+        isActive: false,
+        isTerminal: true,
+        isError: false
+    },
+    ["terminated"]: {
+        label: 'Terminated',
+        description: 'Agent terminated gracefully',
+        isActive: false,
+        isTerminal: true,
+        isError: false
+    },
+    ["error"]: {
+        label: 'Error',
+        description: 'Execution failed with recoverable or fatal error',
+        isActive: false,
+        isTerminal: true,
+        isError: true
+    }
+};
+/**
+ * Type guard to check if a string is a valid AgentState.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid AgentState
+ *
+ * @example
+ * ```typescript
+ * if (isAgentState('working')) {
+ *   // TypeScript now knows this is AgentState.WORKING
+ * }
+ * ```
+ */ export function isAgentState(value) {
+    return typeof value === 'string' && Object.values(AgentState).includes(value);
+}
+/**
+ * Get metadata for a specific agent state.
+ *
+ * @param state - Agent state to query
+ * @returns State metadata
+ * @throws Error if state is invalid
+ *
+ * @example
+ * ```typescript
+ * const metadata = getStateMetadata(AgentState.WORKING);
+ * console.log(metadata.label); // "Working"
+ * console.log(metadata.isActive); // true
+ * ```
+ */ export function getStateMetadata(state) {
+    const metadata = AGENT_STATE_METADATA[state];
+    if (!metadata) {
+        throw new Error(`Invalid agent state: ${state}`);
+    }
+    return metadata;
+}
+/**
+ * Check if an agent state indicates active work.
+ *
+ * @param state - Agent state to check
+ * @returns True if state indicates active work
+ *
+ * @example
+ * ```typescript
+ * isActiveState(AgentState.WORKING); // true
+ * isActiveState(AgentState.IDLE); // false
+ * ```
+ */ export function isActiveState(state) {
+    return getStateMetadata(state).isActive;
+}
+/**
+ * Check if an agent state is terminal (no further transitions possible).
+ *
+ * @param state - Agent state to check
+ * @returns True if state is terminal
+ *
+ * @example
+ * ```typescript
+ * isTerminalState(AgentState.COMPLETED); // true
+ * isTerminalState(AgentState.WORKING); // false
+ * ```
+ */ export function isTerminalState(state) {
+    return getStateMetadata(state).isTerminal;
+}
+/**
+ * Check if an agent state indicates error condition.
+ *
+ * @param state - Agent state to check
+ * @returns True if state indicates error
+ *
+ * @example
+ * ```typescript
+ * isErrorState(AgentState.ERROR); // true
+ * isErrorState(AgentState.BLOCKED); // true
+ * isErrorState(AgentState.WORKING); // false
+ * ```
+ */ export function isErrorState(state) {
+    return getStateMetadata(state).isError;
+}
+
+//# sourceMappingURL=agent-state.js.map

package/.claude-flow-novice/dist/src/coordination/shared/core/agent-state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/coordination/shared/core/agent-state.ts"],"names":["AgentState","AGENT_STATE_METADATA","label","description","isActive","isTerminal","isError","isAgentState","value","Object","values","includes","getStateMetadata","state","metadata","Error","isActiveState","isTerminalState","isErrorState"],"mappings":"AAAA;;;;;;;CAOC,GAED;;;;;CAKC,GACD,OAAO,IAAA,AAAKA,oCAAAA;IACV,wCAAwC;IAGxC,qCAAqC;IAGrC,wDAAwD;IAGxD,oDAAoD;IAGpD,wDAAwD;IAGxD,qCAAqC;IAGrC,+BAA+B;IAG/B,gCAAgC;IAGhC,qDAAqD;WAzB3CA;MA2BX;AAuBD;;;CAGC,GACD,OAAO,MAAMC,uBAA+D;IAC1E,QAAiB,EAAE;QACjBC,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;IACA,WAAoB,EAAE;QACpBJ,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;IACA,WAAoB,EAAE;QACpBJ,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;IACA,WAAoB,EAAE;QACpBJ,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;IACA,WAAoB,EAAE;QACpBJ,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;IACA,UAAmB,EAAE;QACnBJ,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;IACA,aAAsB,EAAE;QACtBJ,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;IACA,cAAuB,EAAE;QACvBJ,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;IACA,SAAkB,EAAE;QAClBJ,OAAO;QACPC,aAAa;QACbC,UAAU;QACVC,YAAY;QACZC,SAAS;IACX;AACF,EAAE;AAEF;;;;;;;;;;;;CAYC,GACD,OAAO,SAASC,aAAaC,KAAc;IACzC,OAAO,OAAOA,UAAU,YAAYC,OAAOC,MAAM,CAACV,YAAYW,QAAQ,CAACH;AACzE;AAEA;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASI,iBAAiBC,KAAiB;IAChD,MAAMC,WAAWb,oBAAoB,CAACY,MAAM;IAC5C,IAAI,CAACC,UAAU;QACb,MAAM,IAAIC,MAAM,CAAC,qBAAqB,EAAEF,OAAO;IACjD;IACA,OAAOC;AACT;AAEA;;;;;;;;;;;CAWC,GACD,OAAO,SAASE,cAAcH,KAAiB;IAC7C,OAAOD,iBAAiBC,OAAOT,QAAQ;AACzC;AAEA;;;;;;;;;;;CAWC,GACD,OAAO,SAASa,gBAAgBJ,KAAiB;IAC/C,OAAOD,iBAAiBC,OAAOR,UAAU;AAC3C;AAEA;;;;;;;;;;;;CAYC,GACD,OAAO,SAASa,aAAaL,KAAiB;IAC5C,OAAOD,iBAAiBC,OAAOP,OAAO;AACxC"}

package/.claude-flow-novice/dist/src/coordination/shared/core/index.js

@@ -0,0 +1,7 @@
+/**
+ * Shared Core - Central Export
+ *
+ * @module coordination/shared/core
+ */ export * from './agent-state.js';
+
+//# sourceMappingURL=index.js.map

package/.claude-flow-novice/dist/src/coordination/shared/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/coordination/shared/core/index.ts"],"names":[],"mappings":"AAAA;;;;CAIC,GAED,cAAc,mBAAmB"}

package/.claude-flow-novice/dist/src/coordination/shared/index.js

@@ -0,0 +1,19 @@
+/**
+ * Agent Coordination - Shared Types and Interfaces
+ *
+ * Central export point for shared coordination types, interfaces, and utilities
+ * used across v1, v2, and future coordination system versions.
+ *
+ * @module coordination/shared
+ */ // Core state definitions
+export * from './core/agent-state.js';
+// SDK types
+export * from './types/sdk.js';
+// Coordinator interfaces
+export * from './interfaces/ICoordinator.js';
+// Message types and utilities
+export { Message, MessageConfig, MessageHandler, MessageFilter, MessagePriority, MessageStats, MessageUtils, MessageValidationError, Reply, RequestOptions, Subscription, SubscriptionConfig, DeliverySemantics } from './message.js';
+// Message broker
+export { MessageBroker, MessageBrokerError, MessageBrokerConfig, IAuthorizationProvider, RateLimitConfig } from './message-broker.js';
+
+//# sourceMappingURL=index.js.map

package/.claude-flow-novice/dist/src/coordination/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/coordination/shared/index.ts"],"names":["Message","MessageConfig","MessageHandler","MessageFilter","MessagePriority","MessageStats","MessageUtils","MessageValidationError","Reply","RequestOptions","Subscription","SubscriptionConfig","DeliverySemantics","MessageBroker","MessageBrokerError","MessageBrokerConfig","IAuthorizationProvider","RateLimitConfig"],"mappings":"AAAA;;;;;;;CAOC,GAED,yBAAyB;AACzB,cAAc,wBAAwB;AAEtC,YAAY;AACZ,cAAc,iBAAiB;AAE/B,yBAAyB;AACzB,cAAc,+BAA+B;AAE7C,8BAA8B;AAC9B,SACEA,OAAO,EACPC,aAAa,EACbC,cAAc,EACdC,aAAa,EACbC,eAAe,EACfC,YAAY,EACZC,YAAY,EACZC,sBAAsB,EACtBC,KAAK,EACLC,cAAc,EACdC,YAAY,EACZC,kBAAkB,EAClBC,iBAAiB,QACZ,eAAe;AAEtB,iBAAiB;AACjB,SACEC,aAAa,EACbC,kBAAkB,EAClBC,mBAAmB,EACnBC,sBAAsB,EACtBC,eAAe,QACV,sBAAsB"}

package/.claude-flow-novice/dist/src/coordination/shared/interfaces/ICoordinator.js

@@ -0,0 +1,24 @@
+/**
+ * Agent Coordination - ICoordinator Interface (Shared)
+ *
+ * Unified coordinator interface enabling CLI/SDK/Hybrid mode switching.
+ * Provides abstraction layer for agent lifecycle, state management, and metrics.
+ *
+ * @module coordination/shared/interfaces/ICoordinator
+ */ /**
+ * ICoordinator - Unified coordinator interface for agent lifecycle management
+ *
+ * Implementations:
+ * - CLICoordinator: Direct CLI mode execution
+ * - SDKCoordinator: Programmatic SDK usage
+ * - HybridCoordinator: Mixed CLI/SDK mode with seamless transitions
+ *
+ * Features:
+ * - Zero-cost agent pausing (idle agents consume 0 tokens)
+ * - Resume from exact message UUID checkpoint
+ * - <500ms checkpoint recovery (p99)
+ * - Dynamic resource allocation
+ * - State persistence across coordinator restarts
+ */ export { };
+
+//# sourceMappingURL=ICoordinator.js.map

package/.claude-flow-novice/dist/src/coordination/shared/interfaces/ICoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/coordination/shared/interfaces/ICoordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;CAOC,GA4ID;;;;;;;;;;;;;;CAcC,GACD,WAqOC"}

package/.claude-flow-novice/dist/src/coordination/shared/interfaces/index.js

@@ -0,0 +1,7 @@
+/**
+ * Shared Interfaces - Central Export
+ *
+ * @module coordination/shared/interfaces
+ */ export * from './ICoordinator.js';
+
+//# sourceMappingURL=index.js.map

package/.claude-flow-novice/dist/src/coordination/shared/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/coordination/shared/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;CAIC,GAED,cAAc,oBAAoB"}