@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/src/skills/unified-rlm-orchestrator.js

@@ -0,0 +1,404 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import {
+  RecursiveAgentOrchestrator
+} from "./recursive-agent-orchestrator.js";
+import {
+  ClaudeSkillsManager
+} from "./claude-skills.js";
+import { logger } from "../core/monitoring/logger.js";
+class UnifiedRLMOrchestrator {
+  rlmOrchestrator;
+  skillsManager;
+  skillMappings;
+  constructor(frameManager, dualStackManager, contextRetriever, taskStore, skillContext) {
+    this.rlmOrchestrator = new RecursiveAgentOrchestrator(
+      frameManager,
+      dualStackManager,
+      contextRetriever,
+      taskStore
+    );
+    this.skillsManager = new ClaudeSkillsManager(skillContext);
+    this.skillMappings = this.initializeSkillMappings();
+    logger.info("Unified RLM Orchestrator initialized with RLM-first routing");
+  }
+  /**
+   * Initialize skill to RLM agent mappings
+   */
+  initializeSkillMappings() {
+    const mappings = /* @__PURE__ */ new Map();
+    mappings.set("handoff", {
+      skillName: "handoff",
+      primaryAgent: "context",
+      secondaryAgents: ["planning"],
+      taskTemplate: "Prepare comprehensive handoff to {targetUser}: {message}. Extract relevant context, identify dependencies, and create actionable items.",
+      defaultOptions: {
+        maxParallel: 3,
+        reviewStages: 1,
+        shareContextRealtime: true
+      },
+      preprocessor: (args, options) => ({
+        task: `Handoff to ${args[0]}: ${args[1]}`,
+        context: {
+          targetUser: args[0],
+          message: args[1],
+          priority: options.priority || "medium",
+          frames: options.frames || []
+        }
+      }),
+      postprocessor: (result) => ({
+        success: result.success,
+        message: `Handoff ${result.success ? "completed" : "failed"}`,
+        data: result.rootNode.result
+      })
+    });
+    mappings.set("checkpoint", {
+      skillName: "checkpoint",
+      primaryAgent: "context",
+      secondaryAgents: ["code"],
+      taskTemplate: "Create recovery checkpoint: {description}. Capture current state, identify risky operations, and backup critical files.",
+      defaultOptions: {
+        maxParallel: 2,
+        reviewStages: 0,
+        verboseLogging: false
+      },
+      preprocessor: (args, options) => ({
+        task: `${args[0]} checkpoint: ${args[1]}`,
+        context: {
+          operation: args[0],
+          description: args[1],
+          ...options
+        }
+      })
+    });
+    mappings.set("dig", {
+      skillName: "dig",
+      primaryAgent: "context",
+      taskTemplate: "Deep archaeological search: {query}. Analyze patterns, extract decisions, and build timeline.",
+      defaultOptions: {
+        maxParallel: 1,
+        maxTokensPerAgent: 5e4,
+        reviewStages: 0
+      },
+      preprocessor: (args, options) => ({
+        task: `Archaeological dig: ${args[0]}`,
+        context: {
+          query: args[0],
+          depth: options.depth || "30days",
+          patterns: options.patterns,
+          decisions: options.decisions,
+          timeline: options.timeline
+        }
+      })
+    });
+    mappings.set("lint", {
+      skillName: "lint",
+      primaryAgent: "linting",
+      secondaryAgents: ["improve"],
+      taskTemplate: "Comprehensive linting of {path}: Check syntax, types, formatting, security, performance, and dead code. Provide fixes.",
+      defaultOptions: {
+        maxParallel: 1,
+        reviewStages: 0,
+        verboseLogging: true
+      },
+      preprocessor: (args, options) => ({
+        task: `Lint ${args[0] || "current directory"}`,
+        context: {
+          path: args[0] || process.cwd(),
+          fix: options.fix,
+          focus: options.security ? "security" : options.performance ? "performance" : "all"
+        }
+      }),
+      postprocessor: (result) => {
+        const lintingNode = this.findNodeByAgent(result.rootNode, "linting");
+        return {
+          success: result.success,
+          message: `Found ${result.issuesFound} issues, fixed ${result.issuesFixed}`,
+          data: {
+            issues: lintingNode?.result?.issues || [],
+            fixes: lintingNode?.result?.fixes || [],
+            stats: {
+              found: result.issuesFound,
+              fixed: result.issuesFixed,
+              duration: result.duration
+            }
+          }
+        };
+      }
+    });
+    mappings.set("test", {
+      skillName: "test",
+      primaryAgent: "testing",
+      secondaryAgents: ["code", "review"],
+      taskTemplate: "Generate comprehensive {testMode} tests for {target}. Ensure high coverage and meaningful assertions.",
+      defaultOptions: {
+        maxParallel: 3,
+        testGenerationMode: "all",
+        reviewStages: 2,
+        qualityThreshold: 0.9
+      },
+      preprocessor: (args, options) => ({
+        task: `Generate tests for ${args[0] || "project"}`,
+        context: {
+          target: args[0] || process.cwd(),
+          testMode: options.mode || "all",
+          coverage: options.coverage || "high"
+        }
+      })
+    });
+    mappings.set("review", {
+      skillName: "review",
+      primaryAgent: "review",
+      secondaryAgents: ["improve", "testing"],
+      taskTemplate: "Multi-stage code review of {target}. Analyze architecture, quality, performance, security. Suggest improvements.",
+      defaultOptions: {
+        maxParallel: 2,
+        reviewStages: 3,
+        qualityThreshold: 0.85,
+        verboseLogging: true
+      },
+      preprocessor: (args, options) => ({
+        task: `Review code in ${args[0] || "project"}`,
+        context: {
+          target: args[0] || process.cwd(),
+          focus: options.focus || "all",
+          autofix: options.fix || false
+        }
+      })
+    });
+    mappings.set("refactor", {
+      skillName: "refactor",
+      primaryAgent: "code",
+      secondaryAgents: ["review", "improve", "testing"],
+      taskTemplate: "Refactor {target}: Improve architecture, reduce complexity, enhance maintainability. Preserve functionality.",
+      defaultOptions: {
+        maxParallel: 4,
+        reviewStages: 2,
+        qualityThreshold: 0.9,
+        testGenerationMode: "unit"
+      },
+      preprocessor: (args, options) => ({
+        task: `Refactor ${args[0] || "codebase"}`,
+        context: {
+          target: args[0] || process.cwd(),
+          scope: options.scope || "moderate",
+          preserveApi: options.preserveApi !== false
+        }
+      })
+    });
+    mappings.set("publish", {
+      skillName: "publish",
+      primaryAgent: "publish",
+      secondaryAgents: ["testing", "linting"],
+      taskTemplate: "Prepare and execute {publishType} release. Run tests, update versions, generate changelog, publish.",
+      defaultOptions: {
+        maxParallel: 1,
+        reviewStages: 1,
+        testGenerationMode: "all"
+      },
+      preprocessor: (args, options) => ({
+        task: `Publish ${options.type || "npm"} release`,
+        context: {
+          version: args[0],
+          publishType: options.type || "npm",
+          prerelease: options.prerelease || false,
+          skipTests: options.skipTests || false
+        }
+      })
+    });
+    return mappings;
+  }
+  /**
+   * Execute any skill through RLM orchestration first
+   */
+  async executeSkill(skillName, args, options) {
+    logger.info(`Executing skill through RLM: ${skillName}`, { args, options });
+    const mapping = this.skillMappings.get(skillName);
+    if (mapping) {
+      return this.executeViaRLM(mapping, args, options || {});
+    }
+    if (skillName === "rlm") {
+      const task = args.join(" ") || "Analyze and optimize current code";
+      const result = await this.rlmOrchestrator.execute(
+        task,
+        options || {},
+        options
+      );
+      return {
+        success: result.success,
+        message: `RLM execution ${result.success ? "completed" : "failed"}`,
+        data: result
+      };
+    }
+    logger.warn(`Skill ${skillName} not mapped to RLM, using legacy execution`);
+    return this.skillsManager.executeSkill(skillName, args, options);
+  }
+  /**
+   * Execute skill via RLM orchestration
+   */
+  async executeViaRLM(mapping, args, options) {
+    try {
+      const { task, context } = mapping.preprocessor ? mapping.preprocessor(args, options) : {
+        task: mapping.taskTemplate.replace("{args}", args.join(" ")),
+        context: { args, ...options }
+      };
+      const rlmOptions = {
+        ...mapping.defaultOptions,
+        ...options,
+        // Force specific agents if specified
+        agents: [mapping.primaryAgent, ...mapping.secondaryAgents || []]
+      };
+      const result = await this.rlmOrchestrator.execute(
+        task,
+        context,
+        rlmOptions
+      );
+      if (mapping.postprocessor) {
+        return mapping.postprocessor(result);
+      }
+      return {
+        success: result.success,
+        message: `${mapping.skillName} ${result.success ? "completed" : "failed"}`,
+        data: {
+          duration: result.duration,
+          tokens: result.totalTokens,
+          cost: result.totalCost,
+          improvements: result.improvements,
+          testsGenerated: result.testsGenerated,
+          issuesFound: result.issuesFound,
+          issuesFixed: result.issuesFixed,
+          details: result.rootNode
+        }
+      };
+    } catch (error) {
+      logger.error(`RLM execution failed for ${mapping.skillName}:`, error);
+      return {
+        success: false,
+        message: `Failed to execute ${mapping.skillName}: ${error.message}`
+      };
+    }
+  }
+  /**
+   * Helper: Find node by agent type in task tree
+   */
+  findNodeByAgent(node, agentType) {
+    if (node.agent === agentType) {
+      return node;
+    }
+    if (node.children) {
+      for (const child of node.children) {
+        const found = this.findNodeByAgent(child, agentType);
+        if (found) return found;
+      }
+    }
+    return null;
+  }
+  /**
+   * Get available skills (all RLM-mapped + legacy)
+   */
+  getAvailableSkills() {
+    const rlmSkills = Array.from(this.skillMappings.keys());
+    const legacySkills = this.skillsManager.getAvailableSkills();
+    const allSkills = /* @__PURE__ */ new Set([...rlmSkills, ...legacySkills, "rlm"]);
+    return Array.from(allSkills);
+  }
+  /**
+   * Get skill help
+   */
+  getSkillHelp(skillName) {
+    const mapping = this.skillMappings.get(skillName);
+    if (mapping) {
+      return `
+${skillName} (RLM-Orchestrated)
+Primary Agent: ${mapping.primaryAgent}
+Secondary Agents: ${mapping.secondaryAgents?.join(", ") || "none"}
+
+${mapping.taskTemplate}
+
+This skill is executed through RLM orchestration for:
+- Automatic task decomposition
+- Parallel agent execution
+- Multi-stage quality review
+- Comprehensive result aggregation
+`;
+    }
+    return this.skillsManager.getSkillHelp(skillName);
+  }
+  /**
+   * Execute task with intelligent routing
+   */
+  async executeTask(task, context) {
+    const taskAnalysis = this.analyzeTask(task);
+    if (taskAnalysis.suggestedSkill) {
+      return this.executeSkill(
+        taskAnalysis.suggestedSkill,
+        taskAnalysis.args,
+        taskAnalysis.options
+      );
+    }
+    const result = await this.rlmOrchestrator.execute(task, context || {}, {
+      maxParallel: 5,
+      reviewStages: 2,
+      qualityThreshold: 0.85,
+      verboseLogging: true
+    });
+    return {
+      success: result.success,
+      message: `Task ${result.success ? "completed" : "failed"}`,
+      data: result
+    };
+  }
+  /**
+   * Analyze task to determine best routing
+   */
+  analyzeTask(task) {
+    const taskLower = task.toLowerCase();
+    const patterns = [
+      { pattern: /lint|format|style|quality/i, skill: "lint" },
+      { pattern: /test|coverage|unit|integration/i, skill: "test" },
+      { pattern: /review|analyze|improve/i, skill: "review" },
+      { pattern: /refactor|restructure|clean/i, skill: "refactor" },
+      { pattern: /handoff|transfer|pass/i, skill: "handoff" },
+      { pattern: /checkpoint|backup|save/i, skill: "checkpoint" },
+      { pattern: /search|find|dig|history/i, skill: "dig" },
+      { pattern: /publish|release|deploy/i, skill: "publish" }
+    ];
+    for (const { pattern, skill } of patterns) {
+      if (pattern.test(taskLower)) {
+        return {
+          suggestedSkill: skill,
+          args: [task],
+          options: {}
+        };
+      }
+    }
+    return {
+      args: [task],
+      options: {}
+    };
+  }
+}
+let unifiedOrchestrator = null;
+function initializeUnifiedOrchestrator(frameManager, dualStackManager, contextRetriever, taskStore, skillContext) {
+  if (!unifiedOrchestrator) {
+    unifiedOrchestrator = new UnifiedRLMOrchestrator(
+      frameManager,
+      dualStackManager,
+      contextRetriever,
+      taskStore,
+      skillContext
+    );
+  }
+  return unifiedOrchestrator;
+}
+function getUnifiedOrchestrator() {
+  return unifiedOrchestrator;
+}
+export {
+  UnifiedRLMOrchestrator,
+  getUnifiedOrchestrator,
+  initializeUnifiedOrchestrator
+};
+//# sourceMappingURL=unified-rlm-orchestrator.js.map

package/dist/src/skills/unified-rlm-orchestrator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/skills/unified-rlm-orchestrator.ts"],
+  "sourcesContent": ["/**\n * Unified RLM-First Orchestrator for StackMemory\n *\n * All skills and tasks flow through RLM orchestration first,\n * ensuring consistent decomposition, parallel execution, and quality control.\n */\n\nimport {\n  RecursiveAgentOrchestrator,\n  type RLMOptions,\n  type SubagentType,\n  type ExecutionResult,\n  type TaskNode,\n} from './recursive-agent-orchestrator.js';\nimport {\n  ClaudeSkillsManager,\n  type SkillContext,\n  type SkillResult,\n} from './claude-skills.js';\nimport { logger } from '../core/monitoring/logger.js';\nimport type { DualStackManager } from '../core/context/dual-stack-manager.js';\nimport type { ContextRetriever } from '../core/retrieval/context-retriever.js';\nimport type { FrameManager } from '../core/context/index.js';\nimport type { LinearTaskManager } from '../features/tasks/linear-task-manager.js';\n\n// Skill to RLM mapping configuration\ninterface SkillToRLMConfig {\n  skillName: string;\n  primaryAgent: SubagentType;\n  secondaryAgents?: SubagentType[];\n  taskTemplate: string;\n  defaultOptions?: Partial<RLMOptions>;\n  preprocessor?: (\n    args: string[],\n    options: Record<string, unknown>\n  ) => { task: string; context: Record<string, unknown> };\n  postprocessor?: (result: ExecutionResult) => SkillResult;\n}\n\n/**\n * UnifiedRLMOrchestrator - Routes all skills through RLM first\n */\nexport class UnifiedRLMOrchestrator {\n  private rlmOrchestrator: RecursiveAgentOrchestrator;\n  private skillsManager: ClaudeSkillsManager;\n  private skillMappings: Map<string, SkillToRLMConfig>;\n\n  constructor(\n    frameManager: FrameManager,\n    dualStackManager: DualStackManager,\n    contextRetriever: ContextRetriever,\n    taskStore: LinearTaskManager,\n    skillContext: SkillContext\n  ) {\n    // Initialize RLM orchestrator\n    this.rlmOrchestrator = new RecursiveAgentOrchestrator(\n      frameManager,\n      dualStackManager,\n      contextRetriever,\n      taskStore\n    );\n\n    // Initialize skills manager (for legacy compatibility)\n    this.skillsManager = new ClaudeSkillsManager(skillContext);\n\n    // Initialize skill mappings\n    this.skillMappings = this.initializeSkillMappings();\n\n    logger.info('Unified RLM Orchestrator initialized with RLM-first routing');\n  }\n\n  /**\n   * Initialize skill to RLM agent mappings\n   */\n  private initializeSkillMappings(): Map<string, SkillToRLMConfig> {\n    const mappings = new Map<string, SkillToRLMConfig>();\n\n    // Handoff skill -> Context + Planning agents\n    mappings.set('handoff', {\n      skillName: 'handoff',\n      primaryAgent: 'context',\n      secondaryAgents: ['planning'],\n      taskTemplate:\n        'Prepare comprehensive handoff to {targetUser}: {message}. Extract relevant context, identify dependencies, and create actionable items.',\n      defaultOptions: {\n        maxParallel: 3,\n        reviewStages: 1,\n        shareContextRealtime: true,\n      },\n      preprocessor: (args, options) => ({\n        task: `Handoff to ${args[0]}: ${args[1]}`,\n        context: {\n          targetUser: args[0],\n          message: args[1],\n          priority: options.priority || 'medium',\n          frames: options.frames || [],\n        },\n      }),\n      postprocessor: (result) => ({\n        success: result.success,\n        message: `Handoff ${result.success ? 'completed' : 'failed'}`,\n        data: result.rootNode.result,\n      }),\n    });\n\n    // Checkpoint skill -> Context + Code agents\n    mappings.set('checkpoint', {\n      skillName: 'checkpoint',\n      primaryAgent: 'context',\n      secondaryAgents: ['code'],\n      taskTemplate:\n        'Create recovery checkpoint: {description}. Capture current state, identify risky operations, and backup critical files.',\n      defaultOptions: {\n        maxParallel: 2,\n        reviewStages: 0,\n        verboseLogging: false,\n      },\n      preprocessor: (args, options) => ({\n        task: `${args[0]} checkpoint: ${args[1]}`,\n        context: {\n          operation: args[0],\n          description: args[1],\n          ...options,\n        },\n      }),\n    });\n\n    // Dig skill -> Context agent (deep search)\n    mappings.set('dig', {\n      skillName: 'dig',\n      primaryAgent: 'context',\n      taskTemplate:\n        'Deep archaeological search: {query}. Analyze patterns, extract decisions, and build timeline.',\n      defaultOptions: {\n        maxParallel: 1,\n        maxTokensPerAgent: 50000,\n        reviewStages: 0,\n      },\n      preprocessor: (args, options) => ({\n        task: `Archaeological dig: ${args[0]}`,\n        context: {\n          query: args[0],\n          depth: options.depth || '30days',\n          patterns: options.patterns,\n          decisions: options.decisions,\n          timeline: options.timeline,\n        },\n      }),\n    });\n\n    // Lint skill -> Linting agent primarily\n    mappings.set('lint', {\n      skillName: 'lint',\n      primaryAgent: 'linting',\n      secondaryAgents: ['improve'],\n      taskTemplate:\n        'Comprehensive linting of {path}: Check syntax, types, formatting, security, performance, and dead code. Provide fixes.',\n      defaultOptions: {\n        maxParallel: 1,\n        reviewStages: 0,\n        verboseLogging: true,\n      },\n      preprocessor: (args, options) => ({\n        task: `Lint ${args[0] || 'current directory'}`,\n        context: {\n          path: args[0] || process.cwd(),\n          fix: options.fix,\n          focus: options.security\n            ? 'security'\n            : options.performance\n              ? 'performance'\n              : 'all',\n        },\n      }),\n      postprocessor: (result) => {\n        const lintingNode = this.findNodeByAgent(result.rootNode, 'linting');\n        return {\n          success: result.success,\n          message: `Found ${result.issuesFound} issues, fixed ${result.issuesFixed}`,\n          data: {\n            issues: lintingNode?.result?.issues || [],\n            fixes: lintingNode?.result?.fixes || [],\n            stats: {\n              found: result.issuesFound,\n              fixed: result.issuesFixed,\n              duration: result.duration,\n            },\n          },\n        };\n      },\n    });\n\n    // Test generation -> Testing agent\n    mappings.set('test', {\n      skillName: 'test',\n      primaryAgent: 'testing',\n      secondaryAgents: ['code', 'review'],\n      taskTemplate:\n        'Generate comprehensive {testMode} tests for {target}. Ensure high coverage and meaningful assertions.',\n      defaultOptions: {\n        maxParallel: 3,\n        testGenerationMode: 'all',\n        reviewStages: 2,\n        qualityThreshold: 0.9,\n      },\n      preprocessor: (args, options) => ({\n        task: `Generate tests for ${args[0] || 'project'}`,\n        context: {\n          target: args[0] || process.cwd(),\n          testMode: options.mode || 'all',\n          coverage: options.coverage || 'high',\n        },\n      }),\n    });\n\n    // Code review -> Review + Improve agents\n    mappings.set('review', {\n      skillName: 'review',\n      primaryAgent: 'review',\n      secondaryAgents: ['improve', 'testing'],\n      taskTemplate:\n        'Multi-stage code review of {target}. Analyze architecture, quality, performance, security. Suggest improvements.',\n      defaultOptions: {\n        maxParallel: 2,\n        reviewStages: 3,\n        qualityThreshold: 0.85,\n        verboseLogging: true,\n      },\n      preprocessor: (args, options) => ({\n        task: `Review code in ${args[0] || 'project'}`,\n        context: {\n          target: args[0] || process.cwd(),\n          focus: options.focus || 'all',\n          autofix: options.fix || false,\n        },\n      }),\n    });\n\n    // Refactor -> Code + Review + Improve agents\n    mappings.set('refactor', {\n      skillName: 'refactor',\n      primaryAgent: 'code',\n      secondaryAgents: ['review', 'improve', 'testing'],\n      taskTemplate:\n        'Refactor {target}: Improve architecture, reduce complexity, enhance maintainability. Preserve functionality.',\n      defaultOptions: {\n        maxParallel: 4,\n        reviewStages: 2,\n        qualityThreshold: 0.9,\n        testGenerationMode: 'unit',\n      },\n      preprocessor: (args, options) => ({\n        task: `Refactor ${args[0] || 'codebase'}`,\n        context: {\n          target: args[0] || process.cwd(),\n          scope: options.scope || 'moderate',\n          preserveApi: options.preserveApi !== false,\n        },\n      }),\n    });\n\n    // Deploy/Publish -> Publish agent\n    mappings.set('publish', {\n      skillName: 'publish',\n      primaryAgent: 'publish',\n      secondaryAgents: ['testing', 'linting'],\n      taskTemplate:\n        'Prepare and execute {publishType} release. Run tests, update versions, generate changelog, publish.',\n      defaultOptions: {\n        maxParallel: 1,\n        reviewStages: 1,\n        testGenerationMode: 'all',\n      },\n      preprocessor: (args, options) => ({\n        task: `Publish ${options.type || 'npm'} release`,\n        context: {\n          version: args[0],\n          publishType: options.type || 'npm',\n          prerelease: options.prerelease || false,\n          skipTests: options.skipTests || false,\n        },\n      }),\n    });\n\n    return mappings;\n  }\n\n  /**\n   * Execute any skill through RLM orchestration first\n   */\n  async executeSkill(\n    skillName: string,\n    args: string[],\n    options?: Record<string, unknown>\n  ): Promise<SkillResult> {\n    logger.info(`Executing skill through RLM: ${skillName}`, { args, options });\n\n    // Check if skill has RLM mapping\n    const mapping = this.skillMappings.get(skillName);\n\n    if (mapping) {\n      // Route through RLM orchestrator\n      return this.executeViaRLM(mapping, args, options || {});\n    }\n\n    // Special case: Direct RLM execution\n    if (skillName === 'rlm') {\n      const task = args.join(' ') || 'Analyze and optimize current code';\n      const result = await this.rlmOrchestrator.execute(\n        task,\n        options || {},\n        options as RLMOptions\n      );\n      return {\n        success: result.success,\n        message: `RLM execution ${result.success ? 'completed' : 'failed'}`,\n        data: result,\n      };\n    }\n\n    // Fallback to legacy skill manager for unmapped skills\n    logger.warn(`Skill ${skillName} not mapped to RLM, using legacy execution`);\n    return this.skillsManager.executeSkill(skillName, args, options);\n  }\n\n  /**\n   * Execute skill via RLM orchestration\n   */\n  private async executeViaRLM(\n    mapping: SkillToRLMConfig,\n    args: string[],\n    options: Record<string, unknown>\n  ): Promise<SkillResult> {\n    try {\n      // Preprocess arguments\n      const { task, context } = mapping.preprocessor\n        ? mapping.preprocessor(args, options)\n        : {\n            task: mapping.taskTemplate.replace('{args}', args.join(' ')),\n            context: { args, ...options },\n          };\n\n      // Merge options\n      const rlmOptions: RLMOptions = {\n        ...mapping.defaultOptions,\n        ...options,\n        // Force specific agents if specified\n        agents: [mapping.primaryAgent, ...(mapping.secondaryAgents || [])],\n      };\n\n      // Execute through RLM\n      const result = await this.rlmOrchestrator.execute(\n        task,\n        context,\n        rlmOptions\n      );\n\n      // Postprocess result\n      if (mapping.postprocessor) {\n        return mapping.postprocessor(result);\n      }\n\n      // Default postprocessing\n      return {\n        success: result.success,\n        message: `${mapping.skillName} ${result.success ? 'completed' : 'failed'}`,\n        data: {\n          duration: result.duration,\n          tokens: result.totalTokens,\n          cost: result.totalCost,\n          improvements: result.improvements,\n          testsGenerated: result.testsGenerated,\n          issuesFound: result.issuesFound,\n          issuesFixed: result.issuesFixed,\n          details: result.rootNode,\n        },\n      };\n    } catch (error) {\n      logger.error(`RLM execution failed for ${mapping.skillName}:`, error);\n      return {\n        success: false,\n        message: `Failed to execute ${mapping.skillName}: ${error.message}`,\n      };\n    }\n  }\n\n  /**\n   * Helper: Find node by agent type in task tree\n   */\n  private findNodeByAgent(\n    node: TaskNode,\n    agentType: SubagentType\n  ): TaskNode | null {\n    if (node.agent === agentType) {\n      return node;\n    }\n    if (node.children) {\n      for (const child of node.children) {\n        const found = this.findNodeByAgent(child, agentType);\n        if (found) return found;\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Get available skills (all RLM-mapped + legacy)\n   */\n  getAvailableSkills(): string[] {\n    const rlmSkills = Array.from(this.skillMappings.keys());\n    const legacySkills = this.skillsManager.getAvailableSkills();\n    const allSkills = new Set([...rlmSkills, ...legacySkills, 'rlm']);\n    return Array.from(allSkills);\n  }\n\n  /**\n   * Get skill help\n   */\n  getSkillHelp(skillName: string): string {\n    const mapping = this.skillMappings.get(skillName);\n    if (mapping) {\n      return `\n${skillName} (RLM-Orchestrated)\nPrimary Agent: ${mapping.primaryAgent}\nSecondary Agents: ${mapping.secondaryAgents?.join(', ') || 'none'}\n\n${mapping.taskTemplate}\n\nThis skill is executed through RLM orchestration for:\n- Automatic task decomposition\n- Parallel agent execution\n- Multi-stage quality review\n- Comprehensive result aggregation\n`;\n    }\n\n    // Fallback to legacy help\n    return this.skillsManager.getSkillHelp(skillName);\n  }\n\n  /**\n   * Execute task with intelligent routing\n   */\n  async executeTask(\n    task: string,\n    context?: Record<string, unknown>\n  ): Promise<SkillResult> {\n    // Analyze task to determine best skill/agent combination\n    const taskAnalysis = this.analyzeTask(task);\n\n    if (taskAnalysis.suggestedSkill) {\n      // Route to specific skill\n      return this.executeSkill(\n        taskAnalysis.suggestedSkill,\n        taskAnalysis.args,\n        taskAnalysis.options\n      );\n    }\n\n    // Direct RLM execution for complex/ambiguous tasks\n    const result = await this.rlmOrchestrator.execute(task, context || {}, {\n      maxParallel: 5,\n      reviewStages: 2,\n      qualityThreshold: 0.85,\n      verboseLogging: true,\n    });\n\n    return {\n      success: result.success,\n      message: `Task ${result.success ? 'completed' : 'failed'}`,\n      data: result,\n    };\n  }\n\n  /**\n   * Analyze task to determine best routing\n   */\n  private analyzeTask(task: string): {\n    suggestedSkill?: string;\n    args: string[];\n    options: Record<string, unknown>;\n  } {\n    const taskLower = task.toLowerCase();\n\n    // Pattern matching for skill detection\n    const patterns = [\n      { pattern: /lint|format|style|quality/i, skill: 'lint' },\n      { pattern: /test|coverage|unit|integration/i, skill: 'test' },\n      { pattern: /review|analyze|improve/i, skill: 'review' },\n      { pattern: /refactor|restructure|clean/i, skill: 'refactor' },\n      { pattern: /handoff|transfer|pass/i, skill: 'handoff' },\n      { pattern: /checkpoint|backup|save/i, skill: 'checkpoint' },\n      { pattern: /search|find|dig|history/i, skill: 'dig' },\n      { pattern: /publish|release|deploy/i, skill: 'publish' },\n    ];\n\n    for (const { pattern, skill } of patterns) {\n      if (pattern.test(taskLower)) {\n        return {\n          suggestedSkill: skill,\n          args: [task],\n          options: {},\n        };\n      }\n    }\n\n    // No specific skill detected\n    return {\n      args: [task],\n      options: {},\n    };\n  }\n}\n\n/**\n * Singleton instance for global access\n */\nlet unifiedOrchestrator: UnifiedRLMOrchestrator | null = null;\n\nexport function initializeUnifiedOrchestrator(\n  frameManager: FrameManager,\n  dualStackManager: DualStackManager,\n  contextRetriever: ContextRetriever,\n  taskStore: LinearTaskManager,\n  skillContext: SkillContext\n): UnifiedRLMOrchestrator {\n  if (!unifiedOrchestrator) {\n    unifiedOrchestrator = new UnifiedRLMOrchestrator(\n      frameManager,\n      dualStackManager,\n      contextRetriever,\n      taskStore,\n      skillContext\n    );\n  }\n  return unifiedOrchestrator;\n}\n\nexport function getUnifiedOrchestrator(): UnifiedRLMOrchestrator | null {\n  return unifiedOrchestrator;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/types/task.js

@@ -0,0 +1,5 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+//# sourceMappingURL=task.js.map

package/dist/src/types/task.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/src/utils/env.js

@@ -0,0 +1,50 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+function getEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (!value && !defaultValue) {
+    throw new Error(`Environment variable ${key} is required but not set`);
+  }
+  return value || defaultValue || "";
+}
+function getOptionalEnv(key, defaultValue) {
+  return process.env[key] || defaultValue;
+}
+function getRequiredEnv(key) {
+  const value = process.env[key];
+  if (!value) {
+    throw new Error(`Environment variable ${key} is required but not set`);
+  }
+  return value;
+}
+function getBooleanEnv(key, defaultValue = false) {
+  const value = process.env[key];
+  if (!value) return defaultValue;
+  return value.toLowerCase() === "true" || value === "1";
+}
+function getNumberEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (!value) {
+    if (defaultValue === void 0) {
+      throw new Error(`Environment variable ${key} is required but not set`);
+    }
+    return defaultValue;
+  }
+  const num = parseInt(value, 10);
+  if (isNaN(num)) {
+    throw new Error(
+      `Environment variable ${key} must be a number, got: ${value}`
+    );
+  }
+  return num;
+}
+export {
+  getBooleanEnv,
+  getEnv,
+  getNumberEnv,
+  getOptionalEnv,
+  getRequiredEnv
+};
+//# sourceMappingURL=env.js.map

package/dist/src/utils/env.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/env.ts"],
+  "sourcesContent": ["/**\n * Shared environment variable utilities\n */\n\nexport function getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (!value && !defaultValue) {\n    throw new Error(`Environment variable ${key} is required but not set`);\n  }\n  return value || defaultValue || '';\n}\n\nexport function getOptionalEnv(\n  key: string,\n  defaultValue?: string\n): string | undefined {\n  return process.env[key] || defaultValue;\n}\n\nexport function getRequiredEnv(key: string): string {\n  const value = process.env[key];\n  if (!value) {\n    throw new Error(`Environment variable ${key} is required but not set`);\n  }\n  return value;\n}\n\nexport function getBooleanEnv(\n  key: string,\n  defaultValue: boolean = false\n): boolean {\n  const value = process.env[key];\n  if (!value) return defaultValue;\n  return value.toLowerCase() === 'true' || value === '1';\n}\n\nexport function getNumberEnv(key: string, defaultValue?: number): number {\n  const value = process.env[key];\n  if (!value) {\n    if (defaultValue === undefined) {\n      throw new Error(`Environment variable ${key} is required but not set`);\n    }\n    return defaultValue;\n  }\n  const num = parseInt(value, 10);\n  if (isNaN(num)) {\n    throw new Error(\n      `Environment variable ${key} must be a number, got: ${value}`\n    );\n  }\n  return num;\n}\n"],
+  "mappings": ";;;;AAIO,SAAS,OAAO,KAAa,cAA+B;AACjE,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,CAAC,SAAS,CAAC,cAAc;AAC3B,UAAM,IAAI,MAAM,wBAAwB,GAAG,0BAA0B;AAAA,EACvE;AACA,SAAO,SAAS,gBAAgB;AAClC;AAEO,SAAS,eACd,KACA,cACoB;AACpB,SAAO,QAAQ,IAAI,GAAG,KAAK;AAC7B;AAEO,SAAS,eAAe,KAAqB;AAClD,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,wBAAwB,GAAG,0BAA0B;AAAA,EACvE;AACA,SAAO;AACT;AAEO,SAAS,cACd,KACA,eAAwB,OACf;AACT,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,MAAM,YAAY,MAAM,UAAU,UAAU;AACrD;AAEO,SAAS,aAAa,KAAa,cAA+B;AACvE,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,CAAC,OAAO;AACV,QAAI,iBAAiB,QAAW;AAC9B,YAAM,IAAI,MAAM,wBAAwB,GAAG,0BAA0B;AAAA,IACvE;AACA,WAAO;AAAA,EACT;AACA,QAAM,MAAM,SAAS,OAAO,EAAE;AAC9B,MAAI,MAAM,GAAG,GAAG;AACd,UAAM,IAAI;AAAA,MACR,wBAAwB,GAAG,2BAA2B,KAAK;AAAA,IAC7D;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/src/utils/formatting.js

@@ -0,0 +1,62 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+function formatBytes(bytes) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB", "TB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+}
+function formatDuration(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  const seconds = Math.floor(ms / 1e3);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  if (days > 0) {
+    return `${days}d ${hours % 24}h`;
+  }
+  if (hours > 0) {
+    return `${hours}h ${minutes % 60}m`;
+  }
+  if (minutes > 0) {
+    return `${minutes}m ${seconds % 60}s`;
+  }
+  return `${seconds}s`;
+}
+function formatRelativeTime(timestamp) {
+  const now = Date.now();
+  const diff = now - timestamp;
+  const minutes = Math.floor(diff / 6e4);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  if (days > 0) return `${days} day${days > 1 ? "s" : ""} ago`;
+  if (hours > 0) return `${hours} hour${hours > 1 ? "s" : ""} ago`;
+  if (minutes > 0) return `${minutes} minute${minutes > 1 ? "s" : ""} ago`;
+  return "just now";
+}
+function truncate(str, maxLength) {
+  if (str.length <= maxLength) return str;
+  return str.substring(0, maxLength - 3) + "...";
+}
+function formatPercent(value, total) {
+  if (total === 0) return "0%";
+  return `${(value / total * 100).toFixed(1)}%`;
+}
+function createProgressBar(value, max, width = 20) {
+  const percent = Math.min(value / max, 1);
+  const filled = Math.floor(percent * width);
+  const empty = width - filled;
+  return "\u2588".repeat(filled) + "\u2591".repeat(empty);
+}
+export {
+  createProgressBar,
+  formatBytes,
+  formatDuration,
+  formatPercent,
+  formatRelativeTime,
+  truncate
+};
+//# sourceMappingURL=formatting.js.map

package/dist/src/utils/formatting.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/formatting.ts"],
+  "sourcesContent": ["/**\n * Formatting utilities for CLI output\n */\n\n/**\n * Format bytes to human-readable string\n */\nexport function formatBytes(bytes: number): string {\n  if (bytes === 0) return '0 B';\n\n  const k = 1024;\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n  return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;\n}\n\n/**\n * Format duration in milliseconds to human-readable string\n */\nexport function formatDuration(ms: number): string {\n  if (ms < 1000) return `${ms}ms`;\n\n  const seconds = Math.floor(ms / 1000);\n  const minutes = Math.floor(seconds / 60);\n  const hours = Math.floor(minutes / 60);\n  const days = Math.floor(hours / 24);\n\n  if (days > 0) {\n    return `${days}d ${hours % 24}h`;\n  }\n  if (hours > 0) {\n    return `${hours}h ${minutes % 60}m`;\n  }\n  if (minutes > 0) {\n    return `${minutes}m ${seconds % 60}s`;\n  }\n\n  return `${seconds}s`;\n}\n\n/**\n * Format relative time\n */\nexport function formatRelativeTime(timestamp: number): string {\n  const now = Date.now();\n  const diff = now - timestamp;\n\n  const minutes = Math.floor(diff / 60000);\n  const hours = Math.floor(minutes / 60);\n  const days = Math.floor(hours / 24);\n\n  if (days > 0) return `${days} day${days > 1 ? 's' : ''} ago`;\n  if (hours > 0) return `${hours} hour${hours > 1 ? 's' : ''} ago`;\n  if (minutes > 0) return `${minutes} minute${minutes > 1 ? 's' : ''} ago`;\n\n  return 'just now';\n}\n\n/**\n * Truncate string with ellipsis\n */\nexport function truncate(str: string, maxLength: number): string {\n  if (str.length <= maxLength) return str;\n  return str.substring(0, maxLength - 3) + '...';\n}\n\n/**\n * Format percentage\n */\nexport function formatPercent(value: number, total: number): string {\n  if (total === 0) return '0%';\n  return `${((value / total) * 100).toFixed(1)}%`;\n}\n\n/**\n * Create a simple text progress bar\n */\nexport function createProgressBar(\n  value: number,\n  max: number,\n  width: number = 20\n): string {\n  const percent = Math.min(value / max, 1);\n  const filled = Math.floor(percent * width);\n  const empty = width - filled;\n\n  return '\u2588'.repeat(filled) + '\u2591'.repeat(empty);\n}\n"],
+  "mappings": ";;;;AAOO,SAAS,YAAY,OAAuB;AACjD,MAAI,UAAU,EAAG,QAAO;AAExB,QAAM,IAAI;AACV,QAAM,QAAQ,CAAC,KAAK,MAAM,MAAM,MAAM,IAAI;AAC1C,QAAM,IAAI,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,CAAC,CAAC;AAElD,SAAO,IAAI,QAAQ,KAAK,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AAC3D;AAKO,SAAS,eAAe,IAAoB;AACjD,MAAI,KAAK,IAAM,QAAO,GAAG,EAAE;AAE3B,QAAM,UAAU,KAAK,MAAM,KAAK,GAAI;AACpC,QAAM,UAAU,KAAK,MAAM,UAAU,EAAE;AACvC,QAAM,QAAQ,KAAK,MAAM,UAAU,EAAE;AACrC,QAAM,OAAO,KAAK,MAAM,QAAQ,EAAE;AAElC,MAAI,OAAO,GAAG;AACZ,WAAO,GAAG,IAAI,KAAK,QAAQ,EAAE;AAAA,EAC/B;AACA,MAAI,QAAQ,GAAG;AACb,WAAO,GAAG,KAAK,KAAK,UAAU,EAAE;AAAA,EAClC;AACA,MAAI,UAAU,GAAG;AACf,WAAO,GAAG,OAAO,KAAK,UAAU,EAAE;AAAA,EACpC;AAEA,SAAO,GAAG,OAAO;AACnB;AAKO,SAAS,mBAAmB,WAA2B;AAC5D,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,OAAO,MAAM;AAEnB,QAAM,UAAU,KAAK,MAAM,OAAO,GAAK;AACvC,QAAM,QAAQ,KAAK,MAAM,UAAU,EAAE;AACrC,QAAM,OAAO,KAAK,MAAM,QAAQ,EAAE;AAElC,MAAI,OAAO,EAAG,QAAO,GAAG,IAAI,OAAO,OAAO,IAAI,MAAM,EAAE;AACtD,MAAI,QAAQ,EAAG,QAAO,GAAG,KAAK,QAAQ,QAAQ,IAAI,MAAM,EAAE;AAC1D,MAAI,UAAU,EAAG,QAAO,GAAG,OAAO,UAAU,UAAU,IAAI,MAAM,EAAE;AAElE,SAAO;AACT;AAKO,SAAS,SAAS,KAAa,WAA2B;AAC/D,MAAI,IAAI,UAAU,UAAW,QAAO;AACpC,SAAO,IAAI,UAAU,GAAG,YAAY,CAAC,IAAI;AAC3C;AAKO,SAAS,cAAc,OAAe,OAAuB;AAClE,MAAI,UAAU,EAAG,QAAO;AACxB,SAAO,IAAK,QAAQ,QAAS,KAAK,QAAQ,CAAC,CAAC;AAC9C;AAKO,SAAS,kBACd,OACA,KACA,QAAgB,IACR;AACR,QAAM,UAAU,KAAK,IAAI,QAAQ,KAAK,CAAC;AACvC,QAAM,SAAS,KAAK,MAAM,UAAU,KAAK;AACzC,QAAM,QAAQ,QAAQ;AAEtB,SAAO,SAAI,OAAO,MAAM,IAAI,SAAI,OAAO,KAAK;AAC9C;",
+  "names": []
+}