@stackmemoryai/stackmemory 0.5.66 → 0.6.0

package/dist/src/integrations/linear/webhook-handler.js

@@ -7,6 +7,8 @@ import { LinearSyncEngine } from "./sync.js";
 import { LinearAuthManager } from "./auth.js";
 import { IntegrationError, ErrorCode } from "../../core/errors/index.js";
 import { logger } from "../../core/monitoring/logger.js";
+import { ClaudeCodeSubagentClient } from "../claude-code/subagent-client.js";
+const AUTOMATION_LABELS = ["automated", "claude-code", "stackmemory"];
 function getEnv(key, defaultValue) {
   const value = process.env[key];
   if (value === void 0) {
@@ -115,6 +117,86 @@ class LinearWebhookHandler {
     }
     await this.storeLinearMapping(taskId, issue.id, issue.identifier);
     logger.info(`Created task ${taskId} from Linear issue ${issue.identifier}`);
+    if (this.shouldSpawnSubagent(issue)) {
+      await this.spawnSubagentForIssue(issue);
+    }
+  }
+  /**
+   * Check if issue should trigger subagent spawn
+   */
+  shouldSpawnSubagent(issue) {
+    if (!issue.labels) return false;
+    const labelNames = issue.labels.map((l) => l.name.toLowerCase());
+    return AUTOMATION_LABELS.some((label) => labelNames.includes(label));
+  }
+  /**
+   * Spawn a Claude Code subagent for the issue
+   */
+  async spawnSubagentForIssue(issue) {
+    logger.info(`Spawning subagent for ${issue.identifier}`);
+    try {
+      const client = new ClaudeCodeSubagentClient();
+      const agentType = this.determineAgentType(issue.labels || []);
+      const task = this.buildTaskPrompt(issue);
+      const sourceUrl = this.extractSourceUrl(issue.description);
+      const result = await client.executeSubagent({
+        type: agentType,
+        task,
+        context: {
+          linearIssueId: issue.id,
+          linearIdentifier: issue.identifier,
+          linearUrl: issue.url,
+          sourceUrl: sourceUrl || issue.url
+        },
+        timeout: 5 * 60 * 1e3
+        // 5 min
+      });
+      logger.info(`Subagent completed for ${issue.identifier}`, {
+        sessionId: result.sessionId,
+        status: result.status
+      });
+    } catch (error) {
+      logger.error(`Failed to spawn subagent for ${issue.identifier}`, {
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+    }
+  }
+  /**
+   * Determine agent type from issue labels
+   */
+  determineAgentType(labels) {
+    const lowerLabels = labels.map((l) => l.name.toLowerCase());
+    if (lowerLabels.some((l) => l.includes("review") || l.includes("pr"))) {
+      return "review";
+    }
+    if (lowerLabels.some((l) => l.includes("explore") || l.includes("research"))) {
+      return "context";
+    }
+    return "code";
+  }
+  /**
+   * Build task prompt from Linear issue
+   */
+  buildTaskPrompt(issue) {
+    const parts = [`Linear Issue: ${issue.identifier} - ${issue.title}`];
+    if (issue.description) {
+      const quoteMatch = issue.description.match(/^>\s*(.+?)(?:\n\n|$)/s);
+      if (quoteMatch) {
+        parts.push("", "Context:", quoteMatch[1].replace(/^>\s*/gm, ""));
+      } else {
+        parts.push("", "Description:", issue.description);
+      }
+    }
+    parts.push("", `URL: ${issue.url}`);
+    return parts.join("\n");
+  }
+  /**
+   * Extract source URL from description
+   */
+  extractSourceUrl(description) {
+    if (!description) return void 0;
+    const urlMatch = description.match(/\*\*Source:\*\*\s*\[.+?\]\((.+?)\)/);
+    return urlMatch?.[1];
   }
   /**
    * Handle issue update

package/dist/src/integrations/linear/webhook-handler.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/integrations/linear/webhook-handler.ts"],
-  "sourcesContent": ["/**\n * Linear Webhook Handler\n * Processes incoming webhooks from Linear to update local task store\n */\n\nimport { createHmac } from 'crypto';\nimport { LinearTaskManager } from '../../features/tasks/linear-task-manager.js';\nimport { LinearSyncEngine } from './sync.js';\nimport { LinearAuthManager } from './auth.js';\nimport { LinearClient } from './client.js';\nimport { IntegrationError, ErrorCode } from '../../core/errors/index.js';\nimport { logger } from '../../core/monitoring/logger.js';\nimport type { Request, Response } from 'express';\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new IntegrationError(\n      `Environment variable ${key} is required`,\n      ErrorCode.LINEAR_WEBHOOK_FAILED\n    );\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\nexport interface LinearWebhookPayload {\n  action: 'create' | 'update' | 'remove';\n  createdAt: string;\n  data: {\n    id: string;\n    identifier: string;\n    title: string;\n    description?: string;\n    state: {\n      id: string;\n      name: string;\n      type: 'backlog' | 'unstarted' | 'started' | 'completed' | 'cancelled';\n    };\n    priority?: number;\n    estimate?: number;\n    assignee?: {\n      id: string;\n      name: string;\n      email: string;\n    };\n    labels?: Array<{ id: string; name: string }>;\n    updatedAt: string;\n    url: string;\n  };\n  type: 'Issue';\n  organizationId: string;\n  webhookId: string;\n}\n\nexport class LinearWebhookHandler {\n  private taskStore: LinearTaskManager;\n  private syncEngine: LinearSyncEngine | null = null;\n  private webhookSecret: string;\n\n  constructor(taskStore: LinearTaskManager, webhookSecret: string) {\n    this.taskStore = taskStore;\n    this.webhookSecret = webhookSecret;\n\n    // Initialize sync engine if API key is available\n    if (process.env['LINEAR_API_KEY']) {\n      const authManager = new LinearAuthManager();\n      this.syncEngine = new LinearSyncEngine(taskStore, authManager, {\n        enabled: true,\n        direction: 'from_linear',\n        autoSync: false,\n        conflictResolution: 'linear_wins',\n      });\n    }\n  }\n\n  /**\n   * Verify webhook signature\n   */\n  private verifySignature(payload: string, signature: string): boolean {\n    const hmac = createHmac('sha256', this.webhookSecret);\n    hmac.update(payload);\n    const expectedSignature = hmac.digest('hex');\n    return signature === expectedSignature;\n  }\n\n  /**\n   * Handle incoming webhook from Linear\n   */\n  async handleWebhook(req: Request, res: Response): Promise<void> {\n    try {\n      // Get raw body for signature verification\n      const rawBody = JSON.stringify(req.body);\n      const signature = req.headers['linear-signature'] as string;\n\n      // Verify signature\n      if (!this.verifySignature(rawBody, signature)) {\n        logger.error('Invalid webhook signature');\n        res.status(401).json({ error: 'Invalid signature' });\n        return;\n      }\n\n      const payload = req.body as LinearWebhookPayload;\n\n      // Only process Issue webhooks\n      if (payload.type !== 'Issue') {\n        res.status(200).json({ message: 'Ignored non-issue webhook' });\n        return;\n      }\n\n      // Process based on action\n      switch (payload.action) {\n        case 'create':\n          await this.handleIssueCreate(payload);\n          break;\n        case 'update':\n          await this.handleIssueUpdate(payload);\n          break;\n        case 'remove':\n          await this.handleIssueRemove(payload);\n          break;\n        default:\n          logger.warn(`Unknown webhook action: ${payload.action}`);\n      }\n\n      res.status(200).json({ message: 'Webhook processed successfully' });\n    } catch (error: unknown) {\n      logger.error('Failed to process webhook:', error as Error);\n      res.status(500).json({ error: 'Failed to process webhook' });\n    }\n  }\n\n  /**\n   * Handle issue creation\n   */\n  private async handleIssueCreate(\n    payload: LinearWebhookPayload\n  ): Promise<void> {\n    const issue = payload.data;\n\n    // Check if task already exists locally\n    const existingTasks = this.taskStore.getActiveTasks();\n    const exists = existingTasks.some(\n      (t) =>\n        t.title.includes(issue.identifier) ||\n        t.external_refs?.linear === issue.id\n    );\n\n    if (exists) {\n      logger.info(`Task ${issue.identifier} already exists locally`);\n      return;\n    }\n\n    // Create local task\n    const taskId = this.taskStore.createTask({\n      title: `[${issue.identifier}] ${issue.title}`,\n      description: issue.description || '',\n      priority: this.mapLinearPriorityToLocal(issue.priority),\n      frameId: 'linear-webhook',\n      tags: issue.labels?.map((l) => l.name) || ['linear'],\n      estimatedEffort: issue.estimate ? issue.estimate * 60 : undefined,\n      assignee: issue.assignee?.name,\n    });\n\n    // Update task status if not pending\n    const status = this.mapLinearStateToLocalStatus(issue.state.type);\n    if (status !== 'pending') {\n      this.taskStore.updateTaskStatus(\n        taskId,\n        status,\n        `Synced from Linear (${issue.state.name})`\n      );\n    }\n\n    // Store Linear mapping\n    await this.storeLinearMapping(taskId, issue.id, issue.identifier);\n\n    logger.info(`Created task ${taskId} from Linear issue ${issue.identifier}`);\n  }\n\n  /**\n   * Handle issue update\n   */\n  private async handleIssueUpdate(\n    payload: LinearWebhookPayload\n  ): Promise<void> {\n    const issue = payload.data;\n\n    // Find local task by Linear ID or identifier\n    const tasks = this.taskStore.getActiveTasks();\n    const localTask = tasks.find(\n      (t) =>\n        t.title.includes(issue.identifier) ||\n        t.external_refs?.linear === issue.id\n    );\n\n    if (!localTask) {\n      // Task doesn't exist locally, create it\n      await this.handleIssueCreate(payload);\n      return;\n    }\n\n    // Update task status\n    const newStatus = this.mapLinearStateToLocalStatus(issue.state.type);\n    if (newStatus !== localTask.status) {\n      this.taskStore.updateTaskStatus(\n        localTask.id,\n        newStatus,\n        `Updated from Linear (${issue.state.name})`\n      );\n    }\n\n    // Update priority if changed\n    const newPriority = this.mapLinearPriorityToLocal(issue.priority);\n    if (newPriority !== localTask.priority) {\n      // Note: Would need to add updateTaskPriority method to taskStore\n      logger.info(\n        `Priority changed for ${issue.identifier}: ${localTask.priority} -> ${newPriority}`\n      );\n    }\n\n    logger.info(\n      `Updated task ${localTask.id} from Linear issue ${issue.identifier}`\n    );\n  }\n\n  /**\n   * Handle issue removal\n   */\n  private async handleIssueRemove(\n    payload: LinearWebhookPayload\n  ): Promise<void> {\n    const issue = payload.data;\n\n    // Find and cancel local task\n    const tasks = this.taskStore.getActiveTasks();\n    const localTask = tasks.find(\n      (t) =>\n        t.title.includes(issue.identifier) ||\n        t.external_refs?.linear === issue.id\n    );\n\n    if (localTask) {\n      this.taskStore.updateTaskStatus(\n        localTask.id,\n        'cancelled',\n        `Removed in Linear`\n      );\n      logger.info(\n        `Cancelled task ${localTask.id} (Linear issue ${issue.identifier} was removed)`\n      );\n    }\n  }\n\n  /**\n   * Store Linear mapping for a task\n   */\n  private async storeLinearMapping(\n    taskId: string,\n    linearId: string,\n    linearIdentifier: string\n  ): Promise<void> {\n    // This would update the linear-mappings.json file\n    // For now, just log it\n    logger.info(\n      `Mapped task ${taskId} to Linear ${linearIdentifier} (${linearId})`\n    );\n  }\n\n  /**\n   * Map Linear priority to local priority\n   */\n  private mapLinearPriorityToLocal(\n    priority?: number\n  ): 'urgent' | 'high' | 'medium' | 'low' {\n    if (!priority) return 'medium';\n    switch (priority) {\n      case 0:\n        return 'urgent';\n      case 1:\n        return 'high';\n      case 2:\n        return 'medium';\n      case 3:\n      case 4:\n        return 'low';\n      default:\n        return 'medium';\n    }\n  }\n\n  /**\n   * Map Linear state to local status\n   */\n  private mapLinearStateToLocalStatus(\n    state: string\n  ): 'pending' | 'in_progress' | 'completed' | 'cancelled' | 'blocked' {\n    switch (state) {\n      case 'backlog':\n      case 'unstarted':\n        return 'pending';\n      case 'started':\n        return 'in_progress';\n      case 'completed':\n        return 'completed';\n      case 'cancelled':\n        return 'cancelled';\n      default:\n        return 'pending';\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Linear Webhook Handler\n * Processes incoming webhooks from Linear to update local task store\n */\n\nimport { createHmac } from 'crypto';\nimport { LinearTaskManager } from '../../features/tasks/linear-task-manager.js';\nimport { LinearSyncEngine } from './sync.js';\nimport { LinearAuthManager } from './auth.js';\nimport { LinearClient } from './client.js';\nimport { IntegrationError, ErrorCode } from '../../core/errors/index.js';\nimport { logger } from '../../core/monitoring/logger.js';\nimport { ClaudeCodeSubagentClient } from '../claude-code/subagent-client.js';\nimport type { Request, Response } from 'express';\n\n/** Labels that trigger automated Claude Code subagent */\nconst AUTOMATION_LABELS = ['automated', 'claude-code', 'stackmemory'];\n// Type-safe environment variable access\nfunction getEnv(key: string, defaultValue?: string): string {\n  const value = process.env[key];\n  if (value === undefined) {\n    if (defaultValue !== undefined) return defaultValue;\n    throw new IntegrationError(\n      `Environment variable ${key} is required`,\n      ErrorCode.LINEAR_WEBHOOK_FAILED\n    );\n  }\n  return value;\n}\n\nfunction getOptionalEnv(key: string): string | undefined {\n  return process.env[key];\n}\n\nexport interface LinearWebhookPayload {\n  action: 'create' | 'update' | 'remove';\n  createdAt: string;\n  data: {\n    id: string;\n    identifier: string;\n    title: string;\n    description?: string;\n    state: {\n      id: string;\n      name: string;\n      type: 'backlog' | 'unstarted' | 'started' | 'completed' | 'cancelled';\n    };\n    priority?: number;\n    estimate?: number;\n    assignee?: {\n      id: string;\n      name: string;\n      email: string;\n    };\n    labels?: Array<{ id: string; name: string }>;\n    updatedAt: string;\n    url: string;\n  };\n  type: 'Issue';\n  organizationId: string;\n  webhookId: string;\n}\n\nexport class LinearWebhookHandler {\n  private taskStore: LinearTaskManager;\n  private syncEngine: LinearSyncEngine | null = null;\n  private webhookSecret: string;\n\n  constructor(taskStore: LinearTaskManager, webhookSecret: string) {\n    this.taskStore = taskStore;\n    this.webhookSecret = webhookSecret;\n\n    // Initialize sync engine if API key is available\n    if (process.env['LINEAR_API_KEY']) {\n      const authManager = new LinearAuthManager();\n      this.syncEngine = new LinearSyncEngine(taskStore, authManager, {\n        enabled: true,\n        direction: 'from_linear',\n        autoSync: false,\n        conflictResolution: 'linear_wins',\n      });\n    }\n  }\n\n  /**\n   * Verify webhook signature\n   */\n  private verifySignature(payload: string, signature: string): boolean {\n    const hmac = createHmac('sha256', this.webhookSecret);\n    hmac.update(payload);\n    const expectedSignature = hmac.digest('hex');\n    return signature === expectedSignature;\n  }\n\n  /**\n   * Handle incoming webhook from Linear\n   */\n  async handleWebhook(req: Request, res: Response): Promise<void> {\n    try {\n      // Get raw body for signature verification\n      const rawBody = JSON.stringify(req.body);\n      const signature = req.headers['linear-signature'] as string;\n\n      // Verify signature\n      if (!this.verifySignature(rawBody, signature)) {\n        logger.error('Invalid webhook signature');\n        res.status(401).json({ error: 'Invalid signature' });\n        return;\n      }\n\n      const payload = req.body as LinearWebhookPayload;\n\n      // Only process Issue webhooks\n      if (payload.type !== 'Issue') {\n        res.status(200).json({ message: 'Ignored non-issue webhook' });\n        return;\n      }\n\n      // Process based on action\n      switch (payload.action) {\n        case 'create':\n          await this.handleIssueCreate(payload);\n          break;\n        case 'update':\n          await this.handleIssueUpdate(payload);\n          break;\n        case 'remove':\n          await this.handleIssueRemove(payload);\n          break;\n        default:\n          logger.warn(`Unknown webhook action: ${payload.action}`);\n      }\n\n      res.status(200).json({ message: 'Webhook processed successfully' });\n    } catch (error: unknown) {\n      logger.error('Failed to process webhook:', error as Error);\n      res.status(500).json({ error: 'Failed to process webhook' });\n    }\n  }\n\n  /**\n   * Handle issue creation\n   */\n  private async handleIssueCreate(\n    payload: LinearWebhookPayload\n  ): Promise<void> {\n    const issue = payload.data;\n\n    // Check if task already exists locally\n    const existingTasks = this.taskStore.getActiveTasks();\n    const exists = existingTasks.some(\n      (t) =>\n        t.title.includes(issue.identifier) ||\n        t.external_refs?.linear === issue.id\n    );\n\n    if (exists) {\n      logger.info(`Task ${issue.identifier} already exists locally`);\n      return;\n    }\n\n    // Create local task\n    const taskId = this.taskStore.createTask({\n      title: `[${issue.identifier}] ${issue.title}`,\n      description: issue.description || '',\n      priority: this.mapLinearPriorityToLocal(issue.priority),\n      frameId: 'linear-webhook',\n      tags: issue.labels?.map((l) => l.name) || ['linear'],\n      estimatedEffort: issue.estimate ? issue.estimate * 60 : undefined,\n      assignee: issue.assignee?.name,\n    });\n\n    // Update task status if not pending\n    const status = this.mapLinearStateToLocalStatus(issue.state.type);\n    if (status !== 'pending') {\n      this.taskStore.updateTaskStatus(\n        taskId,\n        status,\n        `Synced from Linear (${issue.state.name})`\n      );\n    }\n\n    // Store Linear mapping\n    await this.storeLinearMapping(taskId, issue.id, issue.identifier);\n\n    logger.info(`Created task ${taskId} from Linear issue ${issue.identifier}`);\n\n    // Check if we should spawn a Claude Code subagent\n    if (this.shouldSpawnSubagent(issue)) {\n      await this.spawnSubagentForIssue(issue);\n    }\n  }\n\n  /**\n   * Check if issue should trigger subagent spawn\n   */\n  private shouldSpawnSubagent(issue: LinearWebhookPayload['data']): boolean {\n    if (!issue.labels) return false;\n    const labelNames = issue.labels.map((l) => l.name.toLowerCase());\n    return AUTOMATION_LABELS.some((label) => labelNames.includes(label));\n  }\n\n  /**\n   * Spawn a Claude Code subagent for the issue\n   */\n  private async spawnSubagentForIssue(\n    issue: LinearWebhookPayload['data']\n  ): Promise<void> {\n    logger.info(`Spawning subagent for ${issue.identifier}`);\n\n    try {\n      const client = new ClaudeCodeSubagentClient();\n      const agentType = this.determineAgentType(issue.labels || []);\n      const task = this.buildTaskPrompt(issue);\n      const sourceUrl = this.extractSourceUrl(issue.description);\n\n      const result = await client.executeSubagent({\n        type: agentType,\n        task,\n        context: {\n          linearIssueId: issue.id,\n          linearIdentifier: issue.identifier,\n          linearUrl: issue.url,\n          sourceUrl: sourceUrl || issue.url,\n        },\n        timeout: 5 * 60 * 1000, // 5 min\n      });\n\n      logger.info(`Subagent completed for ${issue.identifier}`, {\n        sessionId: result.sessionId,\n        status: result.status,\n      });\n    } catch (error) {\n      logger.error(`Failed to spawn subagent for ${issue.identifier}`, {\n        error: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n\n  /**\n   * Determine agent type from issue labels\n   */\n  private determineAgentType(\n    labels: Array<{ name: string }>\n  ): 'code' | 'review' | 'context' {\n    const lowerLabels = labels.map((l) => l.name.toLowerCase());\n\n    if (lowerLabels.some((l) => l.includes('review') || l.includes('pr'))) {\n      return 'review';\n    }\n\n    if (\n      lowerLabels.some((l) => l.includes('explore') || l.includes('research'))\n    ) {\n      return 'context';\n    }\n\n    return 'code';\n  }\n\n  /**\n   * Build task prompt from Linear issue\n   */\n  private buildTaskPrompt(issue: LinearWebhookPayload['data']): string {\n    const parts = [`Linear Issue: ${issue.identifier} - ${issue.title}`];\n\n    if (issue.description) {\n      const quoteMatch = issue.description.match(/^>\\s*(.+?)(?:\\n\\n|$)/s);\n      if (quoteMatch) {\n        parts.push('', 'Context:', quoteMatch[1].replace(/^>\\s*/gm, ''));\n      } else {\n        parts.push('', 'Description:', issue.description);\n      }\n    }\n\n    parts.push('', `URL: ${issue.url}`);\n    return parts.join('\\n');\n  }\n\n  /**\n   * Extract source URL from description\n   */\n  private extractSourceUrl(description?: string): string | undefined {\n    if (!description) return undefined;\n    const urlMatch = description.match(/\\*\\*Source:\\*\\*\\s*\\[.+?\\]\\((.+?)\\)/);\n    return urlMatch?.[1];\n  }\n\n  /**\n   * Handle issue update\n   */\n  private async handleIssueUpdate(\n    payload: LinearWebhookPayload\n  ): Promise<void> {\n    const issue = payload.data;\n\n    // Find local task by Linear ID or identifier\n    const tasks = this.taskStore.getActiveTasks();\n    const localTask = tasks.find(\n      (t) =>\n        t.title.includes(issue.identifier) ||\n        t.external_refs?.linear === issue.id\n    );\n\n    if (!localTask) {\n      // Task doesn't exist locally, create it\n      await this.handleIssueCreate(payload);\n      return;\n    }\n\n    // Update task status\n    const newStatus = this.mapLinearStateToLocalStatus(issue.state.type);\n    if (newStatus !== localTask.status) {\n      this.taskStore.updateTaskStatus(\n        localTask.id,\n        newStatus,\n        `Updated from Linear (${issue.state.name})`\n      );\n    }\n\n    // Update priority if changed\n    const newPriority = this.mapLinearPriorityToLocal(issue.priority);\n    if (newPriority !== localTask.priority) {\n      // Note: Would need to add updateTaskPriority method to taskStore\n      logger.info(\n        `Priority changed for ${issue.identifier}: ${localTask.priority} -> ${newPriority}`\n      );\n    }\n\n    logger.info(\n      `Updated task ${localTask.id} from Linear issue ${issue.identifier}`\n    );\n  }\n\n  /**\n   * Handle issue removal\n   */\n  private async handleIssueRemove(\n    payload: LinearWebhookPayload\n  ): Promise<void> {\n    const issue = payload.data;\n\n    // Find and cancel local task\n    const tasks = this.taskStore.getActiveTasks();\n    const localTask = tasks.find(\n      (t) =>\n        t.title.includes(issue.identifier) ||\n        t.external_refs?.linear === issue.id\n    );\n\n    if (localTask) {\n      this.taskStore.updateTaskStatus(\n        localTask.id,\n        'cancelled',\n        `Removed in Linear`\n      );\n      logger.info(\n        `Cancelled task ${localTask.id} (Linear issue ${issue.identifier} was removed)`\n      );\n    }\n  }\n\n  /**\n   * Store Linear mapping for a task\n   */\n  private async storeLinearMapping(\n    taskId: string,\n    linearId: string,\n    linearIdentifier: string\n  ): Promise<void> {\n    // This would update the linear-mappings.json file\n    // For now, just log it\n    logger.info(\n      `Mapped task ${taskId} to Linear ${linearIdentifier} (${linearId})`\n    );\n  }\n\n  /**\n   * Map Linear priority to local priority\n   */\n  private mapLinearPriorityToLocal(\n    priority?: number\n  ): 'urgent' | 'high' | 'medium' | 'low' {\n    if (!priority) return 'medium';\n    switch (priority) {\n      case 0:\n        return 'urgent';\n      case 1:\n        return 'high';\n      case 2:\n        return 'medium';\n      case 3:\n      case 4:\n        return 'low';\n      default:\n        return 'medium';\n    }\n  }\n\n  /**\n   * Map Linear state to local status\n   */\n  private mapLinearStateToLocalStatus(\n    state: string\n  ): 'pending' | 'in_progress' | 'completed' | 'cancelled' | 'blocked' {\n    switch (state) {\n      case 'backlog':\n      case 'unstarted':\n        return 'pending';\n      case 'started':\n        return 'in_progress';\n      case 'completed':\n        return 'completed';\n      case 'cancelled':\n        return 'cancelled';\n      default:\n        return 'pending';\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/src/integrations/mcp/server.js

@@ -31,6 +31,11 @@ import { LLMContextRetrieval } from "../../core/retrieval/index.js";
 import { DiscoveryHandlers } from "./handlers/discovery-handlers.js";
 import { DiffMemHandlers } from "./handlers/diffmem-handlers.js";
 import { v4 as uuidv4 } from "uuid";
+import {
+  DEFAULT_PLANNER_MODEL,
+  DEFAULT_IMPLEMENTER,
+  DEFAULT_MAX_ITERS
+} from "../../orchestrators/multimodal/constants.js";
 function getEnv(key, defaultValue) {
   const value = process.env[key];
   if (value === void 0) {
@@ -1232,11 +1237,12 @@ ${summary}...`, 0.8);
   // Handle plan_and_code tool by invoking the mm harness
   async handlePlanAndCode(args) {
     const { runSpike } = await import("../../orchestrators/multimodal/harness.js");
-    const plannerModel = process.env["STACKMEMORY_MM_PLANNER_MODEL"] || "claude-3-5-sonnet-latest";
+    const envPlanner = process.env["STACKMEMORY_MM_PLANNER_MODEL"];
+    const plannerModel = envPlanner || DEFAULT_PLANNER_MODEL;
     const reviewerModel = process.env["STACKMEMORY_MM_REVIEWER_MODEL"] || plannerModel;
-    const implementer = args.implementer || process.env["STACKMEMORY_MM_IMPLEMENTER"] || "codex";
+    const implementer = args.implementer || process.env["STACKMEMORY_MM_IMPLEMENTER"] || DEFAULT_IMPLEMENTER;
     const maxIters = Number(
-      args.maxIters ?? process.env["STACKMEMORY_MM_MAX_ITERS"] ?? 2
+      args.maxIters ?? process.env["STACKMEMORY_MM_MAX_ITERS"] ?? DEFAULT_MAX_ITERS
     );
     const execute = Boolean(args.execute);
     const record = Boolean(args.record);
@@ -1281,7 +1287,7 @@ ${summary}...`, 0.8);
   async handlePlanOnly(args) {
     const { runPlanOnly } = await import("../../orchestrators/multimodal/harness.js");
     const task = String(args.task || "Plan change");
-    const plannerModel = args.plannerModel || process.env["STACKMEMORY_MM_PLANNER_MODEL"] || "claude-3-5-sonnet-latest";
+    const plannerModel = args.plannerModel || process.env["STACKMEMORY_MM_PLANNER_MODEL"] || DEFAULT_PLANNER_MODEL;
     const plan = await runPlanOnly(
       { task, repoPath: this.projectRoot },
       { plannerModel }
@@ -1319,7 +1325,7 @@ ${summary}...`, 0.8);
   async handleCallClaude(args) {
     const { callClaude } = await import("../../orchestrators/multimodal/providers.js");
     const prompt = String(args.prompt || "");
-    const model = args.model || process.env["STACKMEMORY_MM_PLANNER_MODEL"] || "claude-3-5-sonnet-latest";
+    const model = args.model || process.env["STACKMEMORY_MM_PLANNER_MODEL"] || DEFAULT_PLANNER_MODEL;
     const system = args.system || "You are a precise assistant. Return plain text unless asked for JSON.";
     const text = await callClaude(prompt, { model, system });
     return {
@@ -1374,7 +1380,7 @@ ${summary}...`, 0.8);
   async handlePlanGate(args) {
     const { runPlanOnly } = await import("../../orchestrators/multimodal/harness.js");
     const task = String(args.task || "Plan change");
-    const plannerModel = args.plannerModel || process.env["STACKMEMORY_MM_PLANNER_MODEL"] || "claude-3-5-sonnet-latest";
+    const plannerModel = args.plannerModel || process.env["STACKMEMORY_MM_PLANNER_MODEL"] || DEFAULT_PLANNER_MODEL;
     const plan = await runPlanOnly(
       { task, repoPath: this.projectRoot },
       { plannerModel }
@@ -1409,17 +1415,17 @@ ${summary}...`, 0.8);
         isError: false
       };
     }
-    const implementer = args.implementer || process.env["STACKMEMORY_MM_IMPLEMENTER"] || "codex";
+    const implementer = args.implementer || process.env["STACKMEMORY_MM_IMPLEMENTER"] || DEFAULT_IMPLEMENTER;
     const maxIters = Number(
-      args.maxIters ?? process.env["STACKMEMORY_MM_MAX_ITERS"] ?? 2
+      args.maxIters ?? process.env["STACKMEMORY_MM_MAX_ITERS"] ?? DEFAULT_MAX_ITERS
     );
     const recordFrame = args.recordFrame !== false;
     const execute = args.execute !== false;
     const result = await runSpike(
       { task: pending.task, repoPath: this.projectRoot },
       {
-        plannerModel: process.env["STACKMEMORY_MM_PLANNER_MODEL"] || "claude-3-5-sonnet-latest",
-        reviewerModel: process.env["STACKMEMORY_MM_REVIEWER_MODEL"] || process.env["STACKMEMORY_MM_PLANNER_MODEL"] || "claude-3-5-sonnet-latest",
+        plannerModel: process.env["STACKMEMORY_MM_PLANNER_MODEL"] || DEFAULT_PLANNER_MODEL,
+        reviewerModel: process.env["STACKMEMORY_MM_REVIEWER_MODEL"] || process.env["STACKMEMORY_MM_PLANNER_MODEL"] || DEFAULT_PLANNER_MODEL,
         implementer: implementer === "claude" ? "claude" : "codex",
         maxIters: isFinite(maxIters) ? Math.max(1, maxIters) : 2,
         dryRun: !execute,