@stackmemoryai/stackmemory 0.5.31 → 0.5.34

package/dist/agents/core/agent-task-manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/agents/core/agent-task-manager.ts"],
-  "sourcesContent": ["/**\n * Agent Task Manager - Spotify-inspired task handling for StackMemory\n *\n * Integrates Spotify's background coding agent strategies:\n * - 10-turn session limits with automatic task breakdown\n * - Strong verification loops with incremental feedback\n * - Context-aware task prioritization\n * - LLM judge for semantic validation\n */\n\nimport {\n  LinearTaskManager,\n  PebblesTask,\n  TaskStatus,\n  TaskPriority,\n} from '../../features/tasks/linear-task-manager.js';\nimport { logger } from '../../core/monitoring/logger.js';\nimport { FrameManager } from '../../core/context/frame-manager.js';\nimport { TaskError, ErrorCode } from '../../core/errors/index.js';\n\nexport interface AgentTaskSession {\n  id: string;\n  frameId: string;\n  taskId: string;\n  turnCount: number;\n  maxTurns: number;\n  status: 'active' | 'completed' | 'failed' | 'timeout';\n  startedAt: Date;\n  completedAt?: Date;\n  verificationResults: VerificationResult[];\n  contextWindow: string[];\n  feedbackLoop: FeedbackEntry[];\n}\n\nexport interface VerificationResult {\n  verifierId: string;\n  passed: boolean;\n  message: string;\n  severity: 'error' | 'warning' | 'info';\n  timestamp: Date;\n  autoFix?: string;\n}\n\nexport interface FeedbackEntry {\n  turn: number;\n  action: string;\n  result: string;\n  verificationPassed: boolean;\n  contextAdjustment?: string;\n}\n\nexport interface TaskBreakdown {\n  parentTaskId: string;\n  subtasks: SubtaskDefinition[];\n  dependencies: Map<string, string[]>;\n  estimatedTurns: number;\n}\n\nexport interface SubtaskDefinition {\n  title: string;\n  description: string;\n  acceptanceCriteria: string[];\n  estimatedTurns: number;\n  verifiers: string[];\n}\n\n/**\n * Supported agent types\n */\nexport enum AgentType {\n  FORMATTER = 'formatter',\n  SECURITY = 'security',\n  TESTING = 'testing',\n  PERFORMANCE = 'performance',\n  DOCUMENTATION = 'documentation',\n  REFACTORING = 'refactoring'\n}\n\n/**\n * Spotify-inspired Agent Task Manager\n */\nexport class AgentTaskManager {\n  private taskStore: LinearTaskManager;\n  private frameManager: FrameManager;\n  private activeSessions: Map<string, AgentTaskSession> = new Map();\n  private sessionTimeouts: Map<string, NodeJS.Timeout> = new Map();\n  private agentRegistry: Map<AgentType, any> = new Map();\n\n  // Spotify strategy constants\n  private readonly MAX_TURNS_PER_SESSION = 10;\n  private readonly MAX_SESSION_RETRIES = 3;\n  private readonly SESSION_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes\n  private readonly CONTEXT_WINDOW_SIZE = 5; // Last 5 significant events\n\n  constructor(taskStore: LinearTaskManager, frameManager: FrameManager) {\n    this.taskStore = taskStore;\n    this.frameManager = frameManager;\n  }\n\n  /**\n   * Start a new agent task session with Spotify's 10-turn limit\n   */\n  async startTaskSession(\n    taskId: string,\n    frameId: string\n  ): Promise<AgentTaskSession> {\n    const task = this.taskStore.getTask(taskId);\n    if (!task) {\n      throw new TaskError(\n        `Task ${taskId} not found`,\n        ErrorCode.TASK_NOT_FOUND,\n        { taskId }\n      );\n    }\n\n    // Check if task needs breakdown (Spotify strategy)\n    if (this.needsBreakdown(task)) {\n      const breakdown = await this.breakdownTask(task);\n      return this.startMultiTaskSession(breakdown, frameId);\n    }\n\n    const sessionId = this.generateSessionId(taskId);\n    const session: AgentTaskSession = {\n      id: sessionId,\n      frameId,\n      taskId,\n      turnCount: 0,\n      maxTurns: this.MAX_TURNS_PER_SESSION,\n      status: 'active',\n      startedAt: new Date(),\n      verificationResults: [],\n      contextWindow: [],\n      feedbackLoop: [],\n    };\n\n    this.activeSessions.set(sessionId, session);\n    this.startSessionTimeout(sessionId);\n\n    // Update task status\n    this.taskStore.updateTaskStatus(\n      taskId,\n      'in_progress',\n      'Agent session started'\n    );\n\n    logger.info('Started agent task session', {\n      sessionId,\n      taskId,\n      taskTitle: task.title,\n      maxTurns: this.MAX_TURNS_PER_SESSION,\n    });\n\n    return session;\n  }\n\n  /**\n   * Execute a turn in the session with verification\n   */\n  async executeTurn(\n    sessionId: string,\n    action: string,\n    context: Record<string, any>\n  ): Promise<{\n    success: boolean;\n    feedback: string;\n    shouldContinue: boolean;\n    verificationResults: VerificationResult[];\n  }> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session || session.status !== 'active') {\n      throw new TaskError(\n        'Invalid or inactive session',\n        ErrorCode.TASK_INVALID_STATE,\n        { sessionId }\n      );\n    }\n\n    session.turnCount++;\n\n    // Check turn limit (Spotify strategy)\n    if (session.turnCount >= session.maxTurns) {\n      return this.handleTurnLimitReached(session);\n    }\n\n    // Execute action with verification loop\n    const verificationResults = await this.runVerificationLoop(\n      action,\n      context,\n      session\n    );\n\n    // Update context window (keep last N significant events)\n    this.updateContextWindow(session, action, verificationResults);\n\n    // Generate feedback based on verification\n    const feedback = this.generateFeedback(verificationResults);\n    const success = verificationResults.every(\n      (r) => r.passed || r.severity !== 'error'\n    );\n\n    // Record in feedback loop\n    session.feedbackLoop.push({\n      turn: session.turnCount,\n      action,\n      result: feedback,\n      verificationPassed: success,\n      contextAdjustment:\n        this.suggestContextAdjustment(verificationResults) || undefined,\n    });\n\n    // Determine if should continue\n    const shouldContinue = success && session.turnCount < session.maxTurns;\n\n    if (!shouldContinue && success) {\n      await this.completeSession(session);\n    }\n\n    return {\n      success,\n      feedback,\n      shouldContinue,\n      verificationResults,\n    };\n  }\n\n  /**\n   * Run Spotify-style verification loop\n   */\n  private async runVerificationLoop(\n    action: string,\n    context: Record<string, any>,\n    session: AgentTaskSession\n  ): Promise<VerificationResult[]> {\n    const results: VerificationResult[] = [];\n\n    // Get applicable verifiers based on context\n    const verifiers = this.getApplicableVerifiers(context);\n\n    for (const verifier of verifiers) {\n      const result = await this.runVerifier(verifier, action, context);\n      results.push(result);\n      session.verificationResults.push(result);\n\n      // Stop on critical errors (Spotify strategy)\n      if (!result.passed && result.severity === 'error') {\n        logger.warn('Verification failed, stopping execution', {\n          verifier: result.verifierId,\n          message: result.message,\n        });\n        break;\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Get verifiers applicable to current context\n   */\n  private getApplicableVerifiers(context: Record<string, any>): string[] {\n    const verifiers: string[] = [];\n\n    // Add verifiers based on context (Spotify's context-aware approach)\n    if (context['codeChange']) {\n      verifiers.push('formatter', 'linter', 'type-checker');\n    }\n    if (context['testsPresent']) {\n      verifiers.push('test-runner');\n    }\n    if (context['hasDocumentation']) {\n      verifiers.push('doc-validator');\n    }\n    if (context['performanceCritical']) {\n      verifiers.push('performance-analyzer');\n    }\n\n    // Always include semantic validator (LLM judge from Spotify)\n    verifiers.push('semantic-validator');\n\n    return verifiers;\n  }\n\n  /**\n   * Run a single verifier\n   */\n  private async runVerifier(\n    verifierId: string,\n    action: string,\n    context: Record<string, any>\n  ): Promise<VerificationResult> {\n    // This would integrate with actual verifiers\n    // For now, return mock result\n    const mockResults: Record<string, () => VerificationResult> = {\n      formatter: () => ({\n        verifierId: 'formatter',\n        passed: Math.random() > 0.1,\n        message: 'Code formatting check',\n        severity: 'warning',\n        timestamp: new Date(),\n        autoFix: 'prettier --write',\n      }),\n      linter: () => ({\n        verifierId: 'linter',\n        passed: Math.random() > 0.2,\n        message: 'Linting check',\n        severity: 'error',\n        timestamp: new Date(),\n      }),\n      'test-runner': () => ({\n        verifierId: 'test-runner',\n        passed: Math.random() > 0.3,\n        message: 'Test execution',\n        severity: 'error',\n        timestamp: new Date(),\n      }),\n      'semantic-validator': () => ({\n        verifierId: 'semantic-validator',\n        passed: Math.random() > 0.25, // ~75% pass rate like Spotify\n        message: 'Semantic validation against original requirements',\n        severity: 'error',\n        timestamp: new Date(),\n      }),\n    };\n\n    const verifierFn =\n      mockResults[verifierId] ||\n      (() => ({\n        verifierId,\n        passed: true,\n        message: 'Unknown verifier',\n        severity: 'info' as const,\n        timestamp: new Date(),\n      }));\n\n    return verifierFn();\n  }\n\n  /**\n   * Check if task needs breakdown (Spotify strategy for complex tasks)\n   */\n  private needsBreakdown(task: PebblesTask): boolean {\n    // Heuristics for determining if task is too complex\n    const indicators = {\n      hasMultipleComponents:\n        (task.description?.match(/\\band\\b/gi)?.length || 0) > 2,\n      longDescription: (task.description?.length || 0) > 500,\n      highComplexityTags: task.tags.some((tag) =>\n        ['refactor', 'migration', 'architecture', 'redesign'].includes(\n          tag.toLowerCase()\n        )\n      ),\n      hasManydependencies: task.depends_on.length > 3,\n    };\n\n    const complexityScore = Object.values(indicators).filter(Boolean).length;\n    return complexityScore >= 2;\n  }\n\n  /**\n   * Break down complex task into subtasks\n   */\n  private async breakdownTask(task: PebblesTask): Promise<TaskBreakdown> {\n    // This would use LLM to intelligently break down the task\n    // For now, return a simple breakdown\n    const subtasks: SubtaskDefinition[] = [\n      {\n        title: `Analyze requirements for ${task.title}`,\n        description: 'Understand and document requirements',\n        acceptanceCriteria: [\n          'Requirements documented',\n          'Constraints identified',\n        ],\n        estimatedTurns: 2,\n        verifiers: ['semantic-validator'],\n      },\n      {\n        title: `Implement core functionality for ${task.title}`,\n        description: 'Build the main implementation',\n        acceptanceCriteria: ['Core logic implemented', 'Tests passing'],\n        estimatedTurns: 5,\n        verifiers: ['linter', 'test-runner'],\n      },\n      {\n        title: `Verify and refine ${task.title}`,\n        description: 'Final verification and improvements',\n        acceptanceCriteria: ['All tests passing', 'Documentation complete'],\n        estimatedTurns: 3,\n        verifiers: ['formatter', 'linter', 'test-runner', 'semantic-validator'],\n      },\n    ];\n\n    return {\n      parentTaskId: task.id,\n      subtasks,\n      dependencies: new Map([\n        [subtasks[1]!.title, [subtasks[0]!.title]],\n        [subtasks[2]!.title, [subtasks[1]!.title]],\n      ]),\n      estimatedTurns: subtasks.reduce((sum, st) => sum + st.estimatedTurns, 0),\n    };\n  }\n\n  /**\n   * Start multi-task session for complex tasks\n   */\n  private async startMultiTaskSession(\n    breakdown: TaskBreakdown,\n    frameId: string\n  ): Promise<AgentTaskSession> {\n    // Create subtasks in task store\n    const subtaskIds: string[] = [];\n\n    for (const subtask of breakdown.subtasks) {\n      const subtaskId = this.taskStore.createTask({\n        title: subtask.title,\n        description: subtask.description,\n        frameId,\n        parentId: breakdown.parentTaskId,\n        tags: ['agent-subtask', ...subtask.verifiers],\n        estimatedEffort: subtask.estimatedTurns * 5, // Rough conversion to minutes\n      });\n      subtaskIds.push(subtaskId);\n    }\n\n    // Add dependencies\n    const titleToId = new Map(\n      breakdown.subtasks.map((st, i) => [st.title, subtaskIds[i]])\n    );\n\n    for (const [title, deps] of breakdown.dependencies) {\n      const taskId = titleToId.get(title);\n      if (taskId) {\n        for (const dep of deps) {\n          const depId = titleToId.get(dep);\n          if (depId) {\n            this.taskStore.addDependency(taskId, depId);\n          }\n        }\n      }\n    }\n\n    // Start session for first subtask\n    return this.startTaskSession(subtaskIds[0]!, frameId);\n  }\n\n  /**\n   * Update context window with significant events\n   */\n  private updateContextWindow(\n    session: AgentTaskSession,\n    action: string,\n    verificationResults: VerificationResult[]\n  ): void {\n    const significantEvent = {\n      turn: session.turnCount,\n      action: action.substring(0, 100),\n      verificationSummary: verificationResults.map((r) => ({\n        verifier: r.verifierId,\n        passed: r.passed,\n      })),\n      timestamp: new Date().toISOString(),\n    };\n\n    session.contextWindow.push(JSON.stringify(significantEvent));\n\n    // Keep only last N events (Spotify's context window optimization)\n    if (session.contextWindow.length > this.CONTEXT_WINDOW_SIZE) {\n      session.contextWindow = session.contextWindow.slice(\n        -this.CONTEXT_WINDOW_SIZE\n      );\n    }\n  }\n\n  /**\n   * Generate feedback from verification results\n   */\n  private generateFeedback(results: VerificationResult[]): string {\n    const failed = results.filter((r) => !r.passed);\n    const warnings = results.filter(\n      (r) => !r.passed && r.severity === 'warning'\n    );\n    const errors = results.filter((r) => !r.passed && r.severity === 'error');\n\n    if (errors.length > 0) {\n      const errorMessages = errors.map((e) => `- ${e.message}`).join('\\n');\n      return `Verification failed with ${errors.length} error(s):\\n${errorMessages}`;\n    }\n\n    if (warnings.length > 0) {\n      const warningMessages = warnings.map((w) => `- ${w.message}`).join('\\n');\n      return `Verification passed with ${warnings.length} warning(s):\\n${warningMessages}`;\n    }\n\n    return 'All verifications passed successfully';\n  }\n\n  /**\n   * Suggest context adjustment based on verification results\n   */\n  private suggestContextAdjustment(\n    results: VerificationResult[]\n  ): string | undefined {\n    const failed = results.filter((r) => !r.passed && r.severity === 'error');\n\n    if (failed.length === 0) {\n      return undefined;\n    }\n\n    // Generate suggestions based on failure patterns\n    const suggestions: string[] = [];\n\n    if (failed.some((r) => r.verifierId === 'test-runner')) {\n      suggestions.push('Focus on fixing failing tests');\n    }\n    if (failed.some((r) => r.verifierId === 'linter')) {\n      suggestions.push('Address linting errors before proceeding');\n    }\n    if (failed.some((r) => r.verifierId === 'semantic-validator')) {\n      suggestions.push('Review original requirements and adjust approach');\n    }\n\n    return suggestions.length > 0 ? suggestions.join('; ') : undefined;\n  }\n\n  /**\n   * Handle turn limit reached\n   */\n  private async handleTurnLimitReached(session: AgentTaskSession): Promise<{\n    success: boolean;\n    feedback: string;\n    shouldContinue: boolean;\n    verificationResults: VerificationResult[];\n  }> {\n    logger.warn('Session reached turn limit', {\n      sessionId: session.id,\n      taskId: session.taskId,\n      turnCount: session.turnCount,\n    });\n\n    // Check if task can be considered complete\n    const task = this.taskStore.getTask(session.taskId);\n    const isComplete = this.assessTaskCompletion(session);\n\n    if (isComplete) {\n      await this.completeSession(session);\n      return {\n        success: true,\n        feedback: 'Task completed successfully within turn limit',\n        shouldContinue: false,\n        verificationResults: [],\n      };\n    }\n\n    // Mark session as timeout\n    session.status = 'timeout';\n    this.taskStore.updateTaskStatus(\n      session.taskId,\n      'blocked',\n      'Session timeout - manual review needed'\n    );\n\n    return {\n      success: false,\n      feedback: `Session reached ${this.MAX_TURNS_PER_SESSION} turn limit. Task requires manual review or retry.`,\n      shouldContinue: false,\n      verificationResults: [],\n    };\n  }\n\n  /**\n   * Assess if task is complete enough\n   */\n  private assessTaskCompletion(session: AgentTaskSession): boolean {\n    // Check if recent verifications are passing\n    const recentResults = session.verificationResults.slice(-5);\n    const recentPassRate =\n      recentResults.filter((r) => r.passed).length / recentResults.length;\n\n    // Check if semantic validator passed recently (Spotify's LLM judge)\n    const semanticPassed = recentResults.some(\n      (r) => r.verifierId === 'semantic-validator' && r.passed\n    );\n\n    return recentPassRate >= 0.8 && semanticPassed;\n  }\n\n  /**\n   * Complete a session\n   */\n  private async completeSession(session: AgentTaskSession): Promise<void> {\n    session.status = 'completed';\n    session.completedAt = new Date();\n\n    // Update task status\n    this.taskStore.updateTaskStatus(\n      session.taskId,\n      'completed',\n      'Agent session completed'\n    );\n\n    // Clear timeout\n    const timeout = this.sessionTimeouts.get(session.id);\n    if (timeout) {\n      clearTimeout(timeout);\n      this.sessionTimeouts.delete(session.id);\n    }\n\n    // Generate and save session summary to frame\n    const summary = this.generateSessionSummary(session);\n    this.frameManager.addEvent('observation', {\n      type: 'session_summary',\n      frameId: session.frameId,\n      summary,\n    });\n\n    logger.info('Session completed', {\n      sessionId: session.id,\n      taskId: session.taskId,\n      turnCount: session.turnCount,\n      duration: session.completedAt.getTime() - session.startedAt.getTime(),\n    });\n  }\n\n  /**\n   * Generate session summary for frame digest\n   */\n  private generateSessionSummary(\n    session: AgentTaskSession\n  ): Record<string, any> {\n    const verificationStats = {\n      total: session.verificationResults.length,\n      passed: session.verificationResults.filter((r) => r.passed).length,\n      failed: session.verificationResults.filter((r) => !r.passed).length,\n    };\n\n    return {\n      sessionId: session.id,\n      taskId: session.taskId,\n      status: session.status,\n      turnCount: session.turnCount,\n      duration: session.completedAt\n        ? session.completedAt.getTime() - session.startedAt.getTime()\n        : 0,\n      verificationStats,\n      feedbackLoop: session.feedbackLoop.slice(-3), // Last 3 feedback entries\n      contextWindow: session.contextWindow.slice(-2), // Last 2 context entries\n    };\n  }\n\n  /**\n   * Start timeout for session\n   */\n  private startSessionTimeout(sessionId: string): void {\n    const timeout = setTimeout(() => {\n      const session = this.activeSessions.get(sessionId);\n      if (session && session.status === 'active') {\n        session.status = 'timeout';\n        this.taskStore.updateTaskStatus(\n          session.taskId,\n          'blocked',\n          'Session timeout - no activity'\n        );\n        logger.warn('Session timed out due to inactivity', { sessionId });\n      }\n    }, this.SESSION_TIMEOUT_MS);\n\n    this.sessionTimeouts.set(sessionId, timeout);\n  }\n\n  /**\n   * Generate unique session ID\n   */\n  private generateSessionId(taskId: string): string {\n    return `session-${taskId}-${Date.now()}`;\n  }\n\n  /**\n   * Get active sessions summary\n   */\n  getActiveSessions(): Array<{\n    sessionId: string;\n    taskId: string;\n    turnCount: number;\n    status: string;\n    startedAt: Date;\n  }> {\n    return Array.from(this.activeSessions.values()).map((session) => ({\n      sessionId: session.id,\n      taskId: session.taskId,\n      turnCount: session.turnCount,\n      status: session.status,\n      startedAt: session.startedAt,\n    }));\n  }\n\n  /**\n   * Retry a failed session (Spotify's 3-retry strategy)\n   */\n  async retrySession(sessionId: string): Promise<AgentTaskSession | null> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session || session.status === 'active') {\n      return null;\n    }\n\n    // Count previous retries\n    const retryCount = Array.from(this.activeSessions.values()).filter(\n      (s) => s.taskId === session.taskId && s.status === 'failed'\n    ).length;\n\n    if (retryCount >= this.MAX_SESSION_RETRIES) {\n      logger.warn('Max retries reached for task', {\n        taskId: session.taskId,\n        retries: retryCount,\n      });\n      return null;\n    }\n\n    // Start new session with learned context\n    const newSession = await this.startTaskSession(\n      session.taskId,\n      session.frameId\n    );\n\n    // Transfer learned context from previous session\n    newSession.contextWindow = session.contextWindow.slice(-3);\n    newSession.feedbackLoop = [\n      {\n        turn: 0,\n        action: 'Session retry with learned context',\n        result: `Retrying after ${retryCount} previous attempts`,\n        verificationPassed: true,\n        contextAdjustment: session.feedbackLoop\n          .filter((f) => f.contextAdjustment)\n          .map((f) => f.contextAdjustment)\n          .join('; '),\n      },\n    ];\n\n    return newSession;\n  }\n}\n"],
+  "sourcesContent": ["/**\n * Agent Task Manager - Spotify-inspired task handling for StackMemory\n *\n * Integrates Spotify's background coding agent strategies:\n * - 10-turn session limits with automatic task breakdown\n * - Strong verification loops with incremental feedback\n * - Context-aware task prioritization\n * - LLM judge for semantic validation\n */\n\nimport {\n  LinearTaskManager,\n  PebblesTask,\n  TaskStatus,\n  TaskPriority,\n} from '../../features/tasks/linear-task-manager.js';\nimport { logger } from '../../core/monitoring/logger.js';\nimport { FrameManager } from '../../core/context/index.js';\nimport { TaskError, ErrorCode } from '../../core/errors/index.js';\n\nexport interface AgentTaskSession {\n  id: string;\n  frameId: string;\n  taskId: string;\n  turnCount: number;\n  maxTurns: number;\n  status: 'active' | 'completed' | 'failed' | 'timeout';\n  startedAt: Date;\n  completedAt?: Date;\n  verificationResults: VerificationResult[];\n  contextWindow: string[];\n  feedbackLoop: FeedbackEntry[];\n}\n\nexport interface VerificationResult {\n  verifierId: string;\n  passed: boolean;\n  message: string;\n  severity: 'error' | 'warning' | 'info';\n  timestamp: Date;\n  autoFix?: string;\n}\n\nexport interface FeedbackEntry {\n  turn: number;\n  action: string;\n  result: string;\n  verificationPassed: boolean;\n  contextAdjustment?: string;\n}\n\nexport interface TaskBreakdown {\n  parentTaskId: string;\n  subtasks: SubtaskDefinition[];\n  dependencies: Map<string, string[]>;\n  estimatedTurns: number;\n}\n\nexport interface SubtaskDefinition {\n  title: string;\n  description: string;\n  acceptanceCriteria: string[];\n  estimatedTurns: number;\n  verifiers: string[];\n}\n\n/**\n * Supported agent types\n */\nexport enum AgentType {\n  FORMATTER = 'formatter',\n  SECURITY = 'security',\n  TESTING = 'testing',\n  PERFORMANCE = 'performance',\n  DOCUMENTATION = 'documentation',\n  REFACTORING = 'refactoring'\n}\n\n/**\n * Spotify-inspired Agent Task Manager\n */\nexport class AgentTaskManager {\n  private taskStore: LinearTaskManager;\n  private frameManager: FrameManager;\n  private activeSessions: Map<string, AgentTaskSession> = new Map();\n  private sessionTimeouts: Map<string, NodeJS.Timeout> = new Map();\n  private agentRegistry: Map<AgentType, any> = new Map();\n\n  // Spotify strategy constants\n  private readonly MAX_TURNS_PER_SESSION = 10;\n  private readonly MAX_SESSION_RETRIES = 3;\n  private readonly SESSION_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes\n  private readonly CONTEXT_WINDOW_SIZE = 5; // Last 5 significant events\n\n  constructor(taskStore: LinearTaskManager, frameManager: FrameManager) {\n    this.taskStore = taskStore;\n    this.frameManager = frameManager;\n  }\n\n  /**\n   * Start a new agent task session with Spotify's 10-turn limit\n   */\n  async startTaskSession(\n    taskId: string,\n    frameId: string\n  ): Promise<AgentTaskSession> {\n    const task = this.taskStore.getTask(taskId);\n    if (!task) {\n      throw new TaskError(\n        `Task ${taskId} not found`,\n        ErrorCode.TASK_NOT_FOUND,\n        { taskId }\n      );\n    }\n\n    // Check if task needs breakdown (Spotify strategy)\n    if (this.needsBreakdown(task)) {\n      const breakdown = await this.breakdownTask(task);\n      return this.startMultiTaskSession(breakdown, frameId);\n    }\n\n    const sessionId = this.generateSessionId(taskId);\n    const session: AgentTaskSession = {\n      id: sessionId,\n      frameId,\n      taskId,\n      turnCount: 0,\n      maxTurns: this.MAX_TURNS_PER_SESSION,\n      status: 'active',\n      startedAt: new Date(),\n      verificationResults: [],\n      contextWindow: [],\n      feedbackLoop: [],\n    };\n\n    this.activeSessions.set(sessionId, session);\n    this.startSessionTimeout(sessionId);\n\n    // Update task status\n    this.taskStore.updateTaskStatus(\n      taskId,\n      'in_progress',\n      'Agent session started'\n    );\n\n    logger.info('Started agent task session', {\n      sessionId,\n      taskId,\n      taskTitle: task.title,\n      maxTurns: this.MAX_TURNS_PER_SESSION,\n    });\n\n    return session;\n  }\n\n  /**\n   * Execute a turn in the session with verification\n   */\n  async executeTurn(\n    sessionId: string,\n    action: string,\n    context: Record<string, any>\n  ): Promise<{\n    success: boolean;\n    feedback: string;\n    shouldContinue: boolean;\n    verificationResults: VerificationResult[];\n  }> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session || session.status !== 'active') {\n      throw new TaskError(\n        'Invalid or inactive session',\n        ErrorCode.TASK_INVALID_STATE,\n        { sessionId }\n      );\n    }\n\n    session.turnCount++;\n\n    // Check turn limit (Spotify strategy)\n    if (session.turnCount >= session.maxTurns) {\n      return this.handleTurnLimitReached(session);\n    }\n\n    // Execute action with verification loop\n    const verificationResults = await this.runVerificationLoop(\n      action,\n      context,\n      session\n    );\n\n    // Update context window (keep last N significant events)\n    this.updateContextWindow(session, action, verificationResults);\n\n    // Generate feedback based on verification\n    const feedback = this.generateFeedback(verificationResults);\n    const success = verificationResults.every(\n      (r) => r.passed || r.severity !== 'error'\n    );\n\n    // Record in feedback loop\n    session.feedbackLoop.push({\n      turn: session.turnCount,\n      action,\n      result: feedback,\n      verificationPassed: success,\n      contextAdjustment:\n        this.suggestContextAdjustment(verificationResults) || undefined,\n    });\n\n    // Determine if should continue\n    const shouldContinue = success && session.turnCount < session.maxTurns;\n\n    if (!shouldContinue && success) {\n      await this.completeSession(session);\n    }\n\n    return {\n      success,\n      feedback,\n      shouldContinue,\n      verificationResults,\n    };\n  }\n\n  /**\n   * Run Spotify-style verification loop\n   */\n  private async runVerificationLoop(\n    action: string,\n    context: Record<string, any>,\n    session: AgentTaskSession\n  ): Promise<VerificationResult[]> {\n    const results: VerificationResult[] = [];\n\n    // Get applicable verifiers based on context\n    const verifiers = this.getApplicableVerifiers(context);\n\n    for (const verifier of verifiers) {\n      const result = await this.runVerifier(verifier, action, context);\n      results.push(result);\n      session.verificationResults.push(result);\n\n      // Stop on critical errors (Spotify strategy)\n      if (!result.passed && result.severity === 'error') {\n        logger.warn('Verification failed, stopping execution', {\n          verifier: result.verifierId,\n          message: result.message,\n        });\n        break;\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Get verifiers applicable to current context\n   */\n  private getApplicableVerifiers(context: Record<string, any>): string[] {\n    const verifiers: string[] = [];\n\n    // Add verifiers based on context (Spotify's context-aware approach)\n    if (context['codeChange']) {\n      verifiers.push('formatter', 'linter', 'type-checker');\n    }\n    if (context['testsPresent']) {\n      verifiers.push('test-runner');\n    }\n    if (context['hasDocumentation']) {\n      verifiers.push('doc-validator');\n    }\n    if (context['performanceCritical']) {\n      verifiers.push('performance-analyzer');\n    }\n\n    // Always include semantic validator (LLM judge from Spotify)\n    verifiers.push('semantic-validator');\n\n    return verifiers;\n  }\n\n  /**\n   * Run a single verifier\n   */\n  private async runVerifier(\n    verifierId: string,\n    action: string,\n    context: Record<string, any>\n  ): Promise<VerificationResult> {\n    // This would integrate with actual verifiers\n    // For now, return mock result\n    const mockResults: Record<string, () => VerificationResult> = {\n      formatter: () => ({\n        verifierId: 'formatter',\n        passed: Math.random() > 0.1,\n        message: 'Code formatting check',\n        severity: 'warning',\n        timestamp: new Date(),\n        autoFix: 'prettier --write',\n      }),\n      linter: () => ({\n        verifierId: 'linter',\n        passed: Math.random() > 0.2,\n        message: 'Linting check',\n        severity: 'error',\n        timestamp: new Date(),\n      }),\n      'test-runner': () => ({\n        verifierId: 'test-runner',\n        passed: Math.random() > 0.3,\n        message: 'Test execution',\n        severity: 'error',\n        timestamp: new Date(),\n      }),\n      'semantic-validator': () => ({\n        verifierId: 'semantic-validator',\n        passed: Math.random() > 0.25, // ~75% pass rate like Spotify\n        message: 'Semantic validation against original requirements',\n        severity: 'error',\n        timestamp: new Date(),\n      }),\n    };\n\n    const verifierFn =\n      mockResults[verifierId] ||\n      (() => ({\n        verifierId,\n        passed: true,\n        message: 'Unknown verifier',\n        severity: 'info' as const,\n        timestamp: new Date(),\n      }));\n\n    return verifierFn();\n  }\n\n  /**\n   * Check if task needs breakdown (Spotify strategy for complex tasks)\n   */\n  private needsBreakdown(task: PebblesTask): boolean {\n    // Heuristics for determining if task is too complex\n    const indicators = {\n      hasMultipleComponents:\n        (task.description?.match(/\\band\\b/gi)?.length || 0) > 2,\n      longDescription: (task.description?.length || 0) > 500,\n      highComplexityTags: task.tags.some((tag) =>\n        ['refactor', 'migration', 'architecture', 'redesign'].includes(\n          tag.toLowerCase()\n        )\n      ),\n      hasManydependencies: task.depends_on.length > 3,\n    };\n\n    const complexityScore = Object.values(indicators).filter(Boolean).length;\n    return complexityScore >= 2;\n  }\n\n  /**\n   * Break down complex task into subtasks\n   */\n  private async breakdownTask(task: PebblesTask): Promise<TaskBreakdown> {\n    // This would use LLM to intelligently break down the task\n    // For now, return a simple breakdown\n    const subtasks: SubtaskDefinition[] = [\n      {\n        title: `Analyze requirements for ${task.title}`,\n        description: 'Understand and document requirements',\n        acceptanceCriteria: [\n          'Requirements documented',\n          'Constraints identified',\n        ],\n        estimatedTurns: 2,\n        verifiers: ['semantic-validator'],\n      },\n      {\n        title: `Implement core functionality for ${task.title}`,\n        description: 'Build the main implementation',\n        acceptanceCriteria: ['Core logic implemented', 'Tests passing'],\n        estimatedTurns: 5,\n        verifiers: ['linter', 'test-runner'],\n      },\n      {\n        title: `Verify and refine ${task.title}`,\n        description: 'Final verification and improvements',\n        acceptanceCriteria: ['All tests passing', 'Documentation complete'],\n        estimatedTurns: 3,\n        verifiers: ['formatter', 'linter', 'test-runner', 'semantic-validator'],\n      },\n    ];\n\n    return {\n      parentTaskId: task.id,\n      subtasks,\n      dependencies: new Map([\n        [subtasks[1]!.title, [subtasks[0]!.title]],\n        [subtasks[2]!.title, [subtasks[1]!.title]],\n      ]),\n      estimatedTurns: subtasks.reduce((sum, st) => sum + st.estimatedTurns, 0),\n    };\n  }\n\n  /**\n   * Start multi-task session for complex tasks\n   */\n  private async startMultiTaskSession(\n    breakdown: TaskBreakdown,\n    frameId: string\n  ): Promise<AgentTaskSession> {\n    // Create subtasks in task store\n    const subtaskIds: string[] = [];\n\n    for (const subtask of breakdown.subtasks) {\n      const subtaskId = this.taskStore.createTask({\n        title: subtask.title,\n        description: subtask.description,\n        frameId,\n        parentId: breakdown.parentTaskId,\n        tags: ['agent-subtask', ...subtask.verifiers],\n        estimatedEffort: subtask.estimatedTurns * 5, // Rough conversion to minutes\n      });\n      subtaskIds.push(subtaskId);\n    }\n\n    // Add dependencies\n    const titleToId = new Map(\n      breakdown.subtasks.map((st, i) => [st.title, subtaskIds[i]])\n    );\n\n    for (const [title, deps] of breakdown.dependencies) {\n      const taskId = titleToId.get(title);\n      if (taskId) {\n        for (const dep of deps) {\n          const depId = titleToId.get(dep);\n          if (depId) {\n            this.taskStore.addDependency(taskId, depId);\n          }\n        }\n      }\n    }\n\n    // Start session for first subtask\n    return this.startTaskSession(subtaskIds[0]!, frameId);\n  }\n\n  /**\n   * Update context window with significant events\n   */\n  private updateContextWindow(\n    session: AgentTaskSession,\n    action: string,\n    verificationResults: VerificationResult[]\n  ): void {\n    const significantEvent = {\n      turn: session.turnCount,\n      action: action.substring(0, 100),\n      verificationSummary: verificationResults.map((r) => ({\n        verifier: r.verifierId,\n        passed: r.passed,\n      })),\n      timestamp: new Date().toISOString(),\n    };\n\n    session.contextWindow.push(JSON.stringify(significantEvent));\n\n    // Keep only last N events (Spotify's context window optimization)\n    if (session.contextWindow.length > this.CONTEXT_WINDOW_SIZE) {\n      session.contextWindow = session.contextWindow.slice(\n        -this.CONTEXT_WINDOW_SIZE\n      );\n    }\n  }\n\n  /**\n   * Generate feedback from verification results\n   */\n  private generateFeedback(results: VerificationResult[]): string {\n    const failed = results.filter((r) => !r.passed);\n    const warnings = results.filter(\n      (r) => !r.passed && r.severity === 'warning'\n    );\n    const errors = results.filter((r) => !r.passed && r.severity === 'error');\n\n    if (errors.length > 0) {\n      const errorMessages = errors.map((e) => `- ${e.message}`).join('\\n');\n      return `Verification failed with ${errors.length} error(s):\\n${errorMessages}`;\n    }\n\n    if (warnings.length > 0) {\n      const warningMessages = warnings.map((w) => `- ${w.message}`).join('\\n');\n      return `Verification passed with ${warnings.length} warning(s):\\n${warningMessages}`;\n    }\n\n    return 'All verifications passed successfully';\n  }\n\n  /**\n   * Suggest context adjustment based on verification results\n   */\n  private suggestContextAdjustment(\n    results: VerificationResult[]\n  ): string | undefined {\n    const failed = results.filter((r) => !r.passed && r.severity === 'error');\n\n    if (failed.length === 0) {\n      return undefined;\n    }\n\n    // Generate suggestions based on failure patterns\n    const suggestions: string[] = [];\n\n    if (failed.some((r) => r.verifierId === 'test-runner')) {\n      suggestions.push('Focus on fixing failing tests');\n    }\n    if (failed.some((r) => r.verifierId === 'linter')) {\n      suggestions.push('Address linting errors before proceeding');\n    }\n    if (failed.some((r) => r.verifierId === 'semantic-validator')) {\n      suggestions.push('Review original requirements and adjust approach');\n    }\n\n    return suggestions.length > 0 ? suggestions.join('; ') : undefined;\n  }\n\n  /**\n   * Handle turn limit reached\n   */\n  private async handleTurnLimitReached(session: AgentTaskSession): Promise<{\n    success: boolean;\n    feedback: string;\n    shouldContinue: boolean;\n    verificationResults: VerificationResult[];\n  }> {\n    logger.warn('Session reached turn limit', {\n      sessionId: session.id,\n      taskId: session.taskId,\n      turnCount: session.turnCount,\n    });\n\n    // Check if task can be considered complete\n    const task = this.taskStore.getTask(session.taskId);\n    const isComplete = this.assessTaskCompletion(session);\n\n    if (isComplete) {\n      await this.completeSession(session);\n      return {\n        success: true,\n        feedback: 'Task completed successfully within turn limit',\n        shouldContinue: false,\n        verificationResults: [],\n      };\n    }\n\n    // Mark session as timeout\n    session.status = 'timeout';\n    this.taskStore.updateTaskStatus(\n      session.taskId,\n      'blocked',\n      'Session timeout - manual review needed'\n    );\n\n    return {\n      success: false,\n      feedback: `Session reached ${this.MAX_TURNS_PER_SESSION} turn limit. Task requires manual review or retry.`,\n      shouldContinue: false,\n      verificationResults: [],\n    };\n  }\n\n  /**\n   * Assess if task is complete enough\n   */\n  private assessTaskCompletion(session: AgentTaskSession): boolean {\n    // Check if recent verifications are passing\n    const recentResults = session.verificationResults.slice(-5);\n    const recentPassRate =\n      recentResults.filter((r) => r.passed).length / recentResults.length;\n\n    // Check if semantic validator passed recently (Spotify's LLM judge)\n    const semanticPassed = recentResults.some(\n      (r) => r.verifierId === 'semantic-validator' && r.passed\n    );\n\n    return recentPassRate >= 0.8 && semanticPassed;\n  }\n\n  /**\n   * Complete a session\n   */\n  private async completeSession(session: AgentTaskSession): Promise<void> {\n    session.status = 'completed';\n    session.completedAt = new Date();\n\n    // Update task status\n    this.taskStore.updateTaskStatus(\n      session.taskId,\n      'completed',\n      'Agent session completed'\n    );\n\n    // Clear timeout\n    const timeout = this.sessionTimeouts.get(session.id);\n    if (timeout) {\n      clearTimeout(timeout);\n      this.sessionTimeouts.delete(session.id);\n    }\n\n    // Generate and save session summary to frame\n    const summary = this.generateSessionSummary(session);\n    this.frameManager.addEvent('observation', {\n      type: 'session_summary',\n      frameId: session.frameId,\n      summary,\n    });\n\n    logger.info('Session completed', {\n      sessionId: session.id,\n      taskId: session.taskId,\n      turnCount: session.turnCount,\n      duration: session.completedAt.getTime() - session.startedAt.getTime(),\n    });\n  }\n\n  /**\n   * Generate session summary for frame digest\n   */\n  private generateSessionSummary(\n    session: AgentTaskSession\n  ): Record<string, any> {\n    const verificationStats = {\n      total: session.verificationResults.length,\n      passed: session.verificationResults.filter((r) => r.passed).length,\n      failed: session.verificationResults.filter((r) => !r.passed).length,\n    };\n\n    return {\n      sessionId: session.id,\n      taskId: session.taskId,\n      status: session.status,\n      turnCount: session.turnCount,\n      duration: session.completedAt\n        ? session.completedAt.getTime() - session.startedAt.getTime()\n        : 0,\n      verificationStats,\n      feedbackLoop: session.feedbackLoop.slice(-3), // Last 3 feedback entries\n      contextWindow: session.contextWindow.slice(-2), // Last 2 context entries\n    };\n  }\n\n  /**\n   * Start timeout for session\n   */\n  private startSessionTimeout(sessionId: string): void {\n    const timeout = setTimeout(() => {\n      const session = this.activeSessions.get(sessionId);\n      if (session && session.status === 'active') {\n        session.status = 'timeout';\n        this.taskStore.updateTaskStatus(\n          session.taskId,\n          'blocked',\n          'Session timeout - no activity'\n        );\n        logger.warn('Session timed out due to inactivity', { sessionId });\n      }\n    }, this.SESSION_TIMEOUT_MS);\n\n    this.sessionTimeouts.set(sessionId, timeout);\n  }\n\n  /**\n   * Generate unique session ID\n   */\n  private generateSessionId(taskId: string): string {\n    return `session-${taskId}-${Date.now()}`;\n  }\n\n  /**\n   * Get active sessions summary\n   */\n  getActiveSessions(): Array<{\n    sessionId: string;\n    taskId: string;\n    turnCount: number;\n    status: string;\n    startedAt: Date;\n  }> {\n    return Array.from(this.activeSessions.values()).map((session) => ({\n      sessionId: session.id,\n      taskId: session.taskId,\n      turnCount: session.turnCount,\n      status: session.status,\n      startedAt: session.startedAt,\n    }));\n  }\n\n  /**\n   * Retry a failed session (Spotify's 3-retry strategy)\n   */\n  async retrySession(sessionId: string): Promise<AgentTaskSession | null> {\n    const session = this.activeSessions.get(sessionId);\n    if (!session || session.status === 'active') {\n      return null;\n    }\n\n    // Count previous retries\n    const retryCount = Array.from(this.activeSessions.values()).filter(\n      (s) => s.taskId === session.taskId && s.status === 'failed'\n    ).length;\n\n    if (retryCount >= this.MAX_SESSION_RETRIES) {\n      logger.warn('Max retries reached for task', {\n        taskId: session.taskId,\n        retries: retryCount,\n      });\n      return null;\n    }\n\n    // Start new session with learned context\n    const newSession = await this.startTaskSession(\n      session.taskId,\n      session.frameId\n    );\n\n    // Transfer learned context from previous session\n    newSession.contextWindow = session.contextWindow.slice(-3);\n    newSession.feedbackLoop = [\n      {\n        turn: 0,\n        action: 'Session retry with learned context',\n        result: `Retrying after ${retryCount} previous attempts`,\n        verificationPassed: true,\n        contextAdjustment: session.feedbackLoop\n          .filter((f) => f.contextAdjustment)\n          .map((f) => f.contextAdjustment)\n          .join('; '),\n      },\n    ];\n\n    return newSession;\n  }\n}\n"],
   "mappings": "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",
   "names": ["AgentType"]
 }

package/dist/cli/claude-sm.js

@@ -17,7 +17,15 @@ import {
   generateSessionSummary,
   formatSummaryMessage
 } from "../hooks/session-summary.js";
-import { sendNotification } from "../hooks/sms-notify.js";
+import { sendNotification, loadSMSConfig } from "../hooks/sms-notify.js";
+import { enableAutoSync } from "../hooks/whatsapp-sync.js";
+import { enableCommands } from "../hooks/whatsapp-commands.js";
+import { startScheduler, listSchedules } from "../hooks/whatsapp-scheduler.js";
+import {
+  getModelRouter,
+  loadModelRouterConfig
+} from "../core/models/model-router.js";
+import { FallbackMonitor } from "../core/models/fallback-monitor.js";
 const DEFAULT_SM_CONFIG = {
   defaultWorktree: false,
   defaultSandbox: false,
@@ -25,7 +33,8 @@ const DEFAULT_SM_CONFIG = {
   defaultTracing: true,
   defaultRemote: false,
   defaultNotifyOnDone: true,
-  defaultWhatsApp: false
+  defaultWhatsApp: false,
+  defaultModelRouting: false
 };
 function getConfigPath() {
   return path.join(os.homedir(), ".stackmemory", "claude-sm.json");
@@ -68,7 +77,9 @@ class ClaudeSM {
       contextEnabled: true,
       tracingEnabled: this.smConfig.defaultTracing,
       verboseTracing: false,
-      sessionStartTime: Date.now()
+      sessionStartTime: Date.now(),
+      useModelRouting: this.smConfig.defaultModelRouting,
+      useThinkingMode: false
     };
     this.stackmemoryPath = this.findStackMemory();
     this.worktreeScriptPath = path.join(
@@ -249,7 +260,41 @@ class ClaudeSM {
   }
   async startWhatsAppServices() {
     const WEBHOOK_PORT = 3456;
-    console.log(chalk.cyan("Starting WhatsApp services..."));
+    console.log(chalk.cyan("\n\u{1F4F1} WhatsApp Mode - Full Integration"));
+    console.log(chalk.gray("\u2500".repeat(42)));
+    const smsConfig = loadSMSConfig();
+    if (!smsConfig.enabled) {
+      console.log(
+        chalk.yellow("  Notifications disabled. Run: stackmemory notify enable")
+      );
+    }
+    try {
+      enableAutoSync();
+      console.log(
+        chalk.green("  \u2713 Auto-sync enabled (digests on frame close)")
+      );
+    } catch {
+      console.log(chalk.gray("  Auto-sync: skipped"));
+    }
+    try {
+      enableCommands();
+      console.log(chalk.green("  \u2713 Command processing enabled"));
+      console.log(
+        chalk.gray("    Reply: status, tasks, context, help, build, test, lint")
+      );
+    } catch {
+      console.log(chalk.gray("  Command processing: skipped"));
+    }
+    try {
+      const schedules = listSchedules();
+      if (schedules.length > 0) {
+        startScheduler();
+        console.log(
+          chalk.green(`  \u2713 Scheduler started (${schedules.length} schedules)`)
+        );
+      }
+    } catch {
+    }
     const webhookRunning = await fetch(
       `http://localhost:${WEBHOOK_PORT}/health`
     ).then((r) => r.ok).catch(() => false);
@@ -262,11 +307,11 @@ class ClaudeSM {
       });
       webhookProcess.unref();
       console.log(
-        chalk.gray(`  Webhook server starting on port ${WEBHOOK_PORT}`)
+        chalk.green(`  \u2713 Webhook server started (port ${WEBHOOK_PORT})`)
       );
     } else {
       console.log(
-        chalk.gray(`  Webhook already running on port ${WEBHOOK_PORT}`)
+        chalk.green(`  \u2713 Webhook already running (port ${WEBHOOK_PORT})`)
       );
     }
     const ngrokRunning = await fetch("http://localhost:4040/api/tunnels").then((r) => r.ok).catch(() => false);
@@ -276,7 +321,7 @@ class ClaudeSM {
         stdio: "ignore"
       });
       ngrokProcess.unref();
-      console.log(chalk.gray("  ngrok tunnel starting..."));
+      console.log(chalk.gray("  Starting ngrok tunnel..."));
       await new Promise((resolve) => setTimeout(resolve, 3e3));
     }
     try {
@@ -291,15 +336,34 @@ class ClaudeSM {
           fs.mkdirSync(configDir, { recursive: true });
         }
         fs.writeFileSync(configPath, publicUrl);
-        console.log(
-          chalk.green(`  WhatsApp webhook: ${publicUrl}/sms/incoming`)
-        );
+        console.log(chalk.green(`  \u2713 ngrok tunnel: ${publicUrl}/sms/incoming`));
       }
     } catch {
+      console.log(chalk.yellow("  ngrok: waiting for tunnel..."));
+    }
+    if (smsConfig.pendingPrompts.length > 0) {
+      console.log();
       console.log(
-        chalk.yellow("  Waiting for ngrok... URL will be available shortly")
+        chalk.yellow(
+          `  \u23F3 ${smsConfig.pendingPrompts.length} pending prompt(s) awaiting response:`
+        )
       );
+      smsConfig.pendingPrompts.slice(0, 3).forEach((p, i) => {
+        const msg = p.message.length > 40 ? p.message.slice(0, 40) + "..." : p.message;
+        console.log(chalk.gray(`     ${i + 1}. [${p.id}] ${msg}`));
+      });
+      if (smsConfig.pendingPrompts.length > 3) {
+        console.log(
+          chalk.gray(`     ... and ${smsConfig.pendingPrompts.length - 3} more`)
+        );
+      }
     }
+    console.log();
+    console.log(chalk.gray("  Quick actions from WhatsApp:"));
+    console.log(chalk.gray('    "status"  - session status'));
+    console.log(chalk.gray('    "context" - current frame digest'));
+    console.log(chalk.gray('    "1", "2"  - respond to prompts'));
+    console.log(chalk.gray("\u2500".repeat(42)));
   }
   async sendDoneNotification(exitCode) {
     try {
@@ -430,6 +494,31 @@ class ClaudeSM {
             this.config.useWorktree = this.hasUncommittedChanges() || this.detectMultipleInstances();
           }
           break;
+        case "--think":
+        case "--think-hard":
+        case "--ultrathink":
+          this.config.useThinkingMode = true;
+          this.config.useModelRouting = true;
+          this.config.forceProvider = "qwen";
+          break;
+        case "--qwen":
+          this.config.useModelRouting = true;
+          this.config.forceProvider = "qwen";
+          break;
+        case "--openai":
+          this.config.useModelRouting = true;
+          this.config.forceProvider = "openai";
+          break;
+        case "--ollama":
+          this.config.useModelRouting = true;
+          this.config.forceProvider = "ollama";
+          break;
+        case "--model-routing":
+          this.config.useModelRouting = true;
+          break;
+        case "--no-model-routing":
+          this.config.useModelRouting = false;
+          break;
         default:
           claudeArgs.push(arg);
       }
@@ -517,6 +606,45 @@ class ClaudeSM {
         );
       }
     }
+    if (this.config.useModelRouting) {
+      const routerConfig = loadModelRouterConfig();
+      if (routerConfig.enabled || this.config.forceProvider) {
+        const router = getModelRouter();
+        let routeResult;
+        if (this.config.forceProvider) {
+          const env = router.switchTo(this.config.forceProvider);
+          Object.assign(process.env, env);
+          console.log(
+            chalk.magenta(`\u{1F500} Model: ${this.config.forceProvider} (forced)`)
+          );
+          if (this.config.forceProvider === "qwen" && this.config.useThinkingMode) {
+            const qwenConfig = routerConfig.providers.qwen;
+            if (qwenConfig?.params?.enable_thinking) {
+              console.log(
+                chalk.gray(
+                  `   Thinking mode: budget ${qwenConfig.params.thinking_budget || 1e4} tokens`
+                )
+              );
+            }
+          }
+        } else {
+          const taskType = this.config.useThinkingMode ? "think" : "default";
+          routeResult = router.route(taskType, this.config.task);
+          Object.assign(process.env, routeResult.env);
+          if (routeResult.switched) {
+            console.log(
+              chalk.magenta(`\u{1F500} Model routed to: ${routeResult.provider}`)
+            );
+          }
+        }
+      } else {
+        console.log(
+          chalk.gray(
+            "   Model routing: disabled (run: stackmemory model enable)"
+          )
+        );
+      }
+    }
     if (this.config.useWhatsApp) {
       console.log(
         chalk.cyan("\u{1F4F1} WhatsApp mode: notifications + webhook enabled")
@@ -537,10 +665,36 @@ class ClaudeSM {
       process.exit(1);
       return;
     }
-    const claude = spawn(claudeBin, claudeArgs, {
-      stdio: "inherit",
-      env: process.env
+    const fallbackMonitor = new FallbackMonitor({
+      enabled: true,
+      maxRestarts: 2,
+      restartDelayMs: 1500,
+      onFallback: (provider, reason) => {
+        console.log(chalk.yellow(`
+[auto-fallback] Switching to ${provider}`));
+        console.log(chalk.gray(`   Reason: ${reason}`));
+        console.log(chalk.gray(`   Session will continue on ${provider}...`));
+        if (this.config.notifyOnDone || this.config.useWhatsApp) {
+          sendNotification({
+            type: "custom",
+            title: "Model Fallback",
+            message: `Claude unavailable (${reason}). Switched to ${provider}.`
+          }).catch(() => {
+          });
+        }
+      }
     });
+    const fallbackAvailable = fallbackMonitor.isFallbackAvailable();
+    if (fallbackAvailable) {
+      console.log(
+        chalk.gray(`   Auto-fallback: Qwen ready (on rate limit/error)`)
+      );
+    }
+    const wrapper = fallbackMonitor.wrapProcess(claudeBin, claudeArgs, {
+      env: process.env,
+      cwd: process.cwd()
+    });
+    const claude = wrapper.start();
     claude.on("error", (err) => {
       console.error(chalk.red("\u274C Failed to launch Claude CLI."));
       if (err.code === "ENOENT") {
@@ -559,6 +713,15 @@ class ClaudeSM {
       process.exit(1);
     });
     claude.on("exit", async (code) => {
+      const status = fallbackMonitor.getStatus();
+      if (status.inFallback) {
+        console.log(
+          chalk.yellow(
+            `
+Session completed on fallback provider: ${status.currentProvider}`
+          )
+        );
+      }
       this.saveContext("Claude session ended", {
         action: "session_end",
         exitCode: code
@@ -624,6 +787,9 @@ configCmd.command("show").description("Show current default settings").action(()
   console.log(
     `  defaultWhatsApp: ${config.defaultWhatsApp ? chalk.green("true") : chalk.gray("false")}`
   );
+  console.log(
+    `  defaultModelRouting: ${config.defaultModelRouting ? chalk.green("true") : chalk.gray("false")}`
+  );
   console.log(chalk.gray(`
 Config: ${getConfigPath()}`));
 });
@@ -638,7 +804,9 @@ configCmd.command("set <key> <value>").description("Set a default (e.g., set wor
     remote: "defaultRemote",
     "notify-done": "defaultNotifyOnDone",
     notifyondone: "defaultNotifyOnDone",
-    whatsapp: "defaultWhatsApp"
+    whatsapp: "defaultWhatsApp",
+    "model-routing": "defaultModelRouting",
+    modelrouting: "defaultModelRouting"
   };
   const configKey = keyMap[key];
   if (!configKey) {
@@ -704,10 +872,25 @@ configCmd.command("whatsapp-off").description("Disable WhatsApp mode by default"
   saveSMConfig(config);
   console.log(chalk.green("WhatsApp mode disabled by default"));
 });
+configCmd.command("model-routing-on").description(
+  "Enable model routing by default (route tasks to Qwen/other models)"
+).action(() => {
+  const config = loadSMConfig();
+  config.defaultModelRouting = true;
+  saveSMConfig(config);
+  console.log(chalk.green("Model routing enabled by default"));
+  console.log(chalk.gray("Configure with: stackmemory model setup-qwen"));
+});
+configCmd.command("model-routing-off").description("Disable model routing by default (use Claude only)").action(() => {
+  const config = loadSMConfig();
+  config.defaultModelRouting = false;
+  saveSMConfig(config);
+  console.log(chalk.green("Model routing disabled by default"));
+});
 program.option("-w, --worktree", "Create isolated worktree for this instance").option("-W, --no-worktree", "Disable worktree (override default)").option("-r, --remote", "Enable remote mode (WhatsApp for all questions)").option("--no-remote", "Disable remote mode (override default)").option("-n, --notify-done", "Send WhatsApp notification when session ends").option("--no-notify-done", "Disable notification when session ends").option(
   "--whatsapp",
   "Enable WhatsApp mode (auto-start webhook + ngrok + notifications)"
-).option("--no-whatsapp", "Disable WhatsApp mode (override default)").option("-s, --sandbox", "Enable sandbox mode (file/network restrictions)").option("-c, --chrome", "Enable Chrome automation").option("-a, --auto", "Automatically detect and apply best settings").option("-b, --branch <name>", "Specify branch name for worktree").option("-t, --task <desc>", "Task description for context").option("--claude-bin <path>", "Path to claude CLI (or use CLAUDE_BIN)").option("--no-context", "Disable StackMemory context integration").option("--no-trace", "Disable debug tracing (enabled by default)").option("--verbose-trace", "Enable verbose debug tracing with full details").helpOption("-h, --help", "Display help").allowUnknownOption(true).action(async (_options) => {
+).option("--no-whatsapp", "Disable WhatsApp mode (override default)").option("-s, --sandbox", "Enable sandbox mode (file/network restrictions)").option("-c, --chrome", "Enable Chrome automation").option("-a, --auto", "Automatically detect and apply best settings").option("-b, --branch <name>", "Specify branch name for worktree").option("-t, --task <desc>", "Task description for context").option("--claude-bin <path>", "Path to claude CLI (or use CLAUDE_BIN)").option("--no-context", "Disable StackMemory context integration").option("--no-trace", "Disable debug tracing (enabled by default)").option("--verbose-trace", "Enable verbose debug tracing with full details").option("--think", "Enable thinking mode with Qwen (deep reasoning)").option("--think-hard", "Alias for --think").option("--ultrathink", "Alias for --think").option("--qwen", "Force Qwen provider for this session").option("--openai", "Force OpenAI provider for this session").option("--ollama", "Force Ollama provider for this session").option("--model-routing", "Enable model routing").option("--no-model-routing", "Disable model routing").helpOption("-h, --help", "Display help").allowUnknownOption(true).action(async (_options) => {
   const claudeSM = new ClaudeSM();
   const args = process.argv.slice(2);
   await claudeSM.run(args);