@stackmemoryai/stackmemory 0.3.16 → 0.3.18

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

@@ -1,7 +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} 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/frame-manager.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: ExecutionNode,\n    agentType: SubagentType\n  ): ExecutionNode | 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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",
+  "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/frame-manager.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "Lossless memory runtime for AI coding tools - organizes context as a call stack instead of linear chat logs, with team collaboration and infinite retention",
   "engines": {
     "node": ">=20.0.0",
@@ -15,6 +15,7 @@
   "types": "dist/src/index.d.ts",
   "files": [
     "dist",
+    "scripts",
     "templates",
     "README.md",
     "LICENSE"
@@ -68,26 +69,17 @@
     "railway:setup": "./scripts/setup-railway-deployment.sh",
     "railway:deploy": "railway up --detach",
     "railway:logs": "railway logs",
-    "tui": "npm run build && node dist/features/tui/index.js",
-    "tui:dev": "./scripts/dev-tui.sh",
-    "tui:watch": "npm run build && nodemon --watch src/features/tui --watch src/cli --watch src/skills -e ts --exec 'npm run build && node dist/features/tui/index.js'",
     "claude:setup": "node scripts/setup-claude-integration.js",
     "daemons:start": "node scripts/claude-sm-autostart.js",
     "daemons:status": "node scripts/claude-sm-autostart.js status",
     "daemons:stop": "node scripts/claude-sm-autostart.js stop",
     "sync:start": "node scripts/background-sync-manager.js",
     "sync:setup": "./scripts/setup-background-sync.sh",
-    "context:load": "node scripts/chromadb-context-loader.js load",
-    "context:search": "node scripts/chromadb-context-loader.js search",
-    "context:changes": "node scripts/chromadb-context-loader.js changes",
-    "context:sync": "node scripts/chromadb-context-loader.js sync",
-    "context:auto": "node scripts/chromadb-context-loader.js auto",
-    "prepare": "husky"
+    "prepare": "echo 'Prepare step completed'"
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.958.0",
     "@browsermcp/mcp": "^0.1.3",
-    "@chroma-core/default-embed": "^0.1.9",
     "@google-cloud/storage": "^7.18.0",
     "@linear/sdk": "^68.1.0",
     "@modelcontextprotocol/sdk": "^0.5.0",
@@ -97,13 +89,12 @@
     "bcryptjs": "^3.0.3",
     "better-sqlite3": "^9.2.2",
     "chalk": "^5.3.0",
-    "chromadb": "^3.2.0",
-    "chromadb-default-embed": "^2.14.0",
     "cli-table3": "^0.6.5",
     "commander": "^11.1.0",
     "compression": "^1.8.1",
     "cors": "^2.8.5",
     "dotenv": "^17.2.3",
+    "esbuild": "^0.27.2",
     "express": "^4.22.1",
     "glob": "^13.0.0",
     "helmet": "^8.1.0",
@@ -116,15 +107,15 @@
     "ngrok": "^5.0.0-beta.2",
     "open": "^11.0.0",
     "ora": "^9.0.0",
-    "pg": "^8.16.3",
+    "pg": "^8.17.1",
     "puppeteer": "^24.34.0",
     "rate-limiter-flexible": "^9.0.1",
     "redis": "^5.10.0",
     "shell-escape": "^0.2.0",
-    "simple-peer": "^9.11.1",
     "socket.io": "^4.6.0",
     "socket.io-client": "^4.6.0",
     "tweetnacl": "^1.0.3",
+    "typescript": "^5.3.3",
     "uuid": "^9.0.1",
     "ws": "^8.16.0",
     "zod": "^3.22.4"
@@ -134,14 +125,12 @@
     "@types/express": "^4.17.25",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.6",
-    "@types/simple-peer": "^9.11.8",
     "@types/uuid": "^10.0.0",
     "@types/ws": "^8.5.10",
     "@typescript-eslint/eslint-plugin": "^8.50.1",
     "@typescript-eslint/parser": "^8.50.1",
     "@vitest/coverage-v8": "^4.0.16",
     "@vitest/ui": "^4.0.16",
-    "esbuild": "^0.27.2",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
@@ -150,7 +139,6 @@
     "oxlint": "^1.36.0",
     "prettier": "^3.7.4",
     "tsx": "^4.7.0",
-    "typescript": "^5.3.3",
     "vitest": "^4.0.16"
   },
   "lint-staged": {

package/scripts/README-TESTING.md

@@ -0,0 +1,186 @@
+# StackMemory Pre-Publish Test Suite
+
+This directory contains comprehensive tests for validating StackMemory installation and functionality before publishing to npm.
+
+## Test Scripts
+
+### 1. `test-installation.sh`
+**Main pre-publish validation suite**
+- Tests CLI build and compilation
+- Validates package.json structure
+- Checks shell integration setup
+- Validates binary functionality
+- Tests fresh installation simulation
+- Runs security audits
+
+**Usage:**
+```bash
+npm run test:install
+# or
+./scripts/test-installation.sh
+```
+
+### 2. `test-shell-integration.sh`
+**Shell integration specific tests**
+- Validates all binaries exist and are executable
+- Tests individual binary functionality
+- Checks shell integration file syntax
+- Validates PATH configuration
+- Tests for startup errors
+
+**Usage:**
+```bash
+npm run test:shell
+# or
+./scripts/test-shell-integration.sh
+```
+
+### 3. `test-installation-scenarios.sh`
+**Real-world installation scenario tests**
+- Tests global installation
+- Tests local project installation
+- Tests permission scenarios
+- Tests Node.js version compatibility
+- Tests package integrity
+- Tests upgrade scenarios
+
+**Usage:**
+```bash
+npm run test:scenarios
+# or
+./scripts/test-installation-scenarios.sh
+```
+
+## Complete Pre-Publish Test Suite
+
+Run all tests before publishing:
+
+```bash
+npm run test:pre-publish
+```
+
+This runs all three test suites in sequence and must pass before `npm publish` can succeed.
+
+## Test Components Validated
+
+### CLI Functionality
+- ✅ Build completes without errors
+- ✅ CLI executable works (`stackmemory --version`, `stackmemory --help`)
+- ✅ Core commands load without module resolution errors
+- ✅ TypeScript compilation succeeds
+- ✅ Linting passes
+
+### Shell Integration
+- ✅ `~/.stackmemory/bin/` directory and binaries exist
+- ✅ `stackmemory-daemon` functionality (start, stop, status)
+- ✅ `stackmemory-monitor` configuration management
+- ✅ `sm-review` context review functionality  
+- ✅ `stackmemory` wrapper delegates properly
+- ✅ Shell integration files can be sourced without errors
+- ✅ PATH configuration includes StackMemory binaries
+
+### Package & Installation
+- ✅ package.json structure is valid
+- ✅ npm pack succeeds
+- ✅ Fresh installation simulation works
+- ✅ Global and local installation scenarios
+- ✅ Permission handling
+- ✅ Node.js compatibility (18, 20, 21, 22)
+- ✅ Package integrity validation
+- ✅ Postinstall setup execution
+- ✅ Upgrade scenarios
+
+### Security
+- ✅ Dependencies security audit passes
+- ✅ No high-severity vulnerabilities
+- ✅ Git working directory is clean
+
+## Integration with npm
+
+The test suite is integrated with npm lifecycle hooks:
+
+```json
+{
+  "scripts": {
+    "prepublishOnly": "npm run build && npm run test:pre-publish"
+  }
+}
+```
+
+This ensures that:
+1. All tests must pass before any `npm publish` command succeeds
+2. The package is built fresh before testing
+3. Installation scenarios are validated in clean environments
+
+## Test Output
+
+Each test script provides colored output:
+- 🔵 **INFO**: Test execution information
+- 🟢 **PASS**: Test passed successfully
+- 🔴 **FAIL**: Test failed with error details
+- 🟡 **WARN**: Warning or non-critical issue
+
+Example output:
+```
+============================================
+  StackMemory Pre-Publish Test Suite
+============================================
+
+🔨 Build & Compilation Tests
+[PASS] Build succeeds without errors
+[PASS] TypeScript compilation check
+[PASS] Lint check passes
+
+⚡ CLI Functionality Tests
+[PASS] CLI is executable
+[PASS] CLI help displays correctly
+[PASS] CLI commands load without errors
+
+📦 Package Validation Tests
+[PASS] package.json structure valid
+[PASS] npm pack succeeds
+[PASS] Git status is clean
+
+✅ All tests passed! Ready for npm publish.
+```
+
+## Troubleshooting Failed Tests
+
+### Build Failures
+- Check TypeScript errors: `npm run build`
+- Fix linting issues: `npm run lint:fix`
+- Ensure all dependencies are installed: `npm install`
+
+### CLI Failures
+- Verify dist/cli/index.js exists and is executable
+- Check for missing ES module import extensions (.js)
+- Ensure all imported modules exist in the build
+
+### Shell Integration Failures  
+- Verify `~/.stackmemory/bin/` directory exists
+- Check binary file permissions: `ls -la ~/.stackmemory/bin/`
+- Test individual binaries manually
+- Check shell integration syntax: `bash -n ~/.stackmemory/shell-integration-consolidated.sh`
+
+### Installation Scenario Failures
+- Check npm pack output for missing files
+- Verify package.json bin configuration
+- Test in clean environment manually
+- Check Node.js version compatibility
+
+## Continuous Integration
+
+For CI/CD pipelines, run the full test suite:
+
+```bash
+# In CI environment
+npm ci
+npm run test:pre-publish
+npm publish
+```
+
+The tests are designed to work in various environments:
+- Local development machines
+- CI/CD systems (GitHub Actions, etc.)
+- Docker containers
+- Different operating systems (macOS, Linux)