@stackmemoryai/stackmemory 0.5.64 → 0.5.67

package/dist/src/skills/linear-task-runner.js

@@ -0,0 +1,262 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { logger } from "../core/monitoring/logger.js";
+import * as fs from "fs";
+import * as path from "path";
+const PROMPT_PLAN_PATH = "docs/specs/PROMPT_PLAN.md";
+class LinearTaskRunner {
+  constructor(taskManager, rlmOrchestrator, context, specSkill) {
+    this.taskManager = taskManager;
+    this.rlmOrchestrator = rlmOrchestrator;
+    this.context = context;
+    this.specSkill = specSkill;
+  }
+  /** Pull next task from Linear, execute via RLM, update status */
+  async runNext(opts) {
+    const tasks = this.getFilteredTasks(opts);
+    if (tasks.length === 0) {
+      return {
+        success: true,
+        message: "No pending tasks found",
+        data: { tasksAvailable: 0 }
+      };
+    }
+    const task = tasks[0];
+    return this.runTask(task.id, opts);
+  }
+  /** Run all active tasks iteratively */
+  async runAll(opts) {
+    const startTime = Date.now();
+    const tasks = this.getFilteredTasks(opts);
+    if (tasks.length === 0) {
+      return {
+        success: true,
+        message: "No pending tasks to execute",
+        data: { tasksAvailable: 0 }
+      };
+    }
+    if (opts?.dryRun) {
+      return this.preview();
+    }
+    const summary = {
+      completed: [],
+      failed: [],
+      skipped: [],
+      totalTokens: 0,
+      totalCost: 0,
+      duration: 0
+    };
+    for (const task of tasks) {
+      try {
+        const result = await this.executeTask(task);
+        if (result.success) {
+          summary.completed.push(task.id);
+          const data = result.data;
+          summary.totalTokens += data?.totalTokens || 0;
+          summary.totalCost += data?.totalCost || 0;
+          await this.autoUpdatePromptPlan(task);
+        } else {
+          summary.failed.push({
+            taskId: task.id,
+            error: result.message
+          });
+        }
+        await this.syncSafe();
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        summary.failed.push({ taskId: task.id, error: msg });
+        logger.error("Task execution failed", { taskId: task.id, error: msg });
+      }
+    }
+    summary.duration = Date.now() - startTime;
+    return {
+      success: summary.failed.length === 0,
+      message: `Completed ${summary.completed.length}/${tasks.length} tasks`,
+      data: summary,
+      action: `Executed ${summary.completed.length} tasks, ${summary.failed.length} failures`
+    };
+  }
+  /** Execute a specific Linear task by ID */
+  async runTask(taskId, opts) {
+    const task = this.taskManager.getTask(taskId);
+    if (!task) {
+      return { success: false, message: `Task not found: ${taskId}` };
+    }
+    if (opts?.dryRun) {
+      return this.previewTask(task);
+    }
+    const result = await this.executeTask(task);
+    if (result.success) {
+      await this.autoUpdatePromptPlan(task);
+      await this.syncSafe();
+    }
+    return result;
+  }
+  /** Show execution plan without running */
+  async preview(taskId) {
+    if (taskId) {
+      const task = this.taskManager.getTask(taskId);
+      if (!task) {
+        return { success: false, message: `Task not found: ${taskId}` };
+      }
+      return this.previewTask(task);
+    }
+    const tasks = this.getFilteredTasks();
+    const plan = tasks.map((t, i) => ({
+      order: i + 1,
+      id: t.id,
+      identifier: t.externalIdentifier || t.id,
+      title: t.title,
+      priority: t.priority || "medium",
+      status: t.status,
+      tags: t.tags
+    }));
+    return {
+      success: true,
+      message: `${plan.length} tasks in execution queue`,
+      data: { plan, totalTasks: plan.length }
+    };
+  }
+  // --- Private helpers ---
+  async executeTask(task) {
+    const taskLabel = task.externalIdentifier || task.id;
+    logger.info("Starting task execution", {
+      taskId: task.id,
+      title: task.title
+    });
+    try {
+      this.taskManager.updateTaskStatus(
+        task.id,
+        "in_progress",
+        "LinearTaskRunner: starting execution"
+      );
+    } catch {
+    }
+    try {
+      const result = await this.rlmOrchestrator.execute(
+        task.description || task.title,
+        {
+          linearTaskId: task.id,
+          linearIdentifier: task.externalIdentifier,
+          title: task.title,
+          tags: task.tags
+        }
+      );
+      if (result.success) {
+        this.taskManager.updateTaskStatus(
+          task.id,
+          "done",
+          `Completed via RLM: ${result.improvements.length} improvements, ${result.testsGenerated} tests`
+        );
+        return {
+          success: true,
+          message: `${taskLabel}: completed`,
+          data: {
+            taskId: task.id,
+            duration: result.duration,
+            totalTokens: result.totalTokens,
+            totalCost: result.totalCost,
+            testsGenerated: result.testsGenerated,
+            improvements: result.improvements.length,
+            issuesFound: result.issuesFound,
+            issuesFixed: result.issuesFixed
+          },
+          action: `Executed ${taskLabel} via RLM`
+        };
+      } else {
+        logger.warn("Task execution failed", {
+          taskId: task.id,
+          rootNode: result.rootNode
+        });
+        return {
+          success: false,
+          message: `${taskLabel}: execution failed`,
+          data: {
+            taskId: task.id,
+            duration: result.duration,
+            totalTokens: result.totalTokens
+          }
+        };
+      }
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error("Task execution threw", { taskId: task.id, error: msg });
+      return {
+        success: false,
+        message: `${taskLabel}: ${msg}`,
+        data: { taskId: task.id }
+      };
+    }
+  }
+  getFilteredTasks(opts) {
+    const tasks = this.taskManager.getTasksByStatus("todo");
+    let filtered = tasks;
+    if (opts?.priority) {
+      filtered = filtered.filter((t) => t.priority === opts.priority);
+    }
+    if (opts?.tag) {
+      const tag = opts.tag;
+      filtered = filtered.filter((t) => t.tags.includes(tag));
+    }
+    const priorityOrder = {
+      urgent: 0,
+      high: 1,
+      medium: 2,
+      low: 3
+    };
+    return filtered.sort(
+      (a, b) => (priorityOrder[a.priority || "medium"] || 2) - (priorityOrder[b.priority || "medium"] || 2)
+    );
+  }
+  previewTask(task) {
+    return {
+      success: true,
+      message: `Preview: ${task.externalIdentifier || task.id}`,
+      data: {
+        id: task.id,
+        identifier: task.externalIdentifier,
+        title: task.title,
+        description: task.description?.slice(0, 200),
+        priority: task.priority,
+        status: task.status,
+        tags: task.tags,
+        willExecuteVia: "RLM Orchestrator",
+        estimatedSteps: [
+          "Planning agent decomposes task",
+          "Code/Test/Review subagents execute",
+          "Multi-stage review",
+          "Update Linear status to done"
+        ]
+      }
+    };
+  }
+  /** Auto-update PROMPT_PLAN checkboxes when a task completes */
+  async autoUpdatePromptPlan(task) {
+    if (!this.specSkill) return;
+    const promptPlanPath = path.join(process.cwd(), PROMPT_PLAN_PATH);
+    if (!fs.existsSync(promptPlanPath)) return;
+    try {
+      await this.specSkill.update(PROMPT_PLAN_PATH, task.title);
+      logger.info("Auto-updated PROMPT_PLAN checkbox", {
+        taskId: task.id,
+        title: task.title
+      });
+    } catch {
+    }
+  }
+  /** Safe Linear sync — log errors but don't throw */
+  async syncSafe() {
+    try {
+      await this.taskManager.syncWithLinear();
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.warn("Linear sync failed (non-fatal)", { error: msg });
+    }
+  }
+}
+export {
+  LinearTaskRunner
+};
+//# sourceMappingURL=linear-task-runner.js.map

package/dist/src/skills/linear-task-runner.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/skills/linear-task-runner.ts"],
+  "sourcesContent": ["/**\n * Linear Task Runner\n * Bridges LinearTaskManager \u2192 RLM Orchestrator \u2192 Linear status updates.\n * Stateless: pull \u2192 execute \u2192 update. Ralph loop handles retries/learning.\n */\n\nimport type { SkillContext, SkillResult } from './claude-skills.js';\nimport type { RecursiveAgentOrchestrator } from './recursive-agent-orchestrator.js';\nimport type { SpecGeneratorSkill } from './spec-generator-skill.js';\nimport type { Task } from '../types/task.js';\nimport { logger } from '../core/monitoring/logger.js';\nimport * as fs from 'fs';\nimport * as path from 'path';\n\n// Dynamic import type for LinearTaskManager (loaded lazily)\ntype LinearTaskManagerType = {\n  getActiveTasks(): Task[];\n  getTask(id: string): Task | undefined;\n  updateTaskStatus(id: string, status: string, reason?: string): void;\n  syncWithLinear(): Promise<{ synced: number; errors: string[] }>;\n  getTasksByStatus(status: string): Task[];\n};\n\ninterface RunOptions {\n  priority?: string;\n  tag?: string;\n  dryRun?: boolean;\n  maxConcurrent?: number;\n}\n\ninterface RunSummary {\n  completed: string[];\n  failed: Array<{ taskId: string; error: string }>;\n  skipped: string[];\n  totalTokens: number;\n  totalCost: number;\n  duration: number;\n}\n\nconst PROMPT_PLAN_PATH = 'docs/specs/PROMPT_PLAN.md';\n\nexport class LinearTaskRunner {\n  constructor(\n    private taskManager: LinearTaskManagerType,\n    private rlmOrchestrator: RecursiveAgentOrchestrator,\n    private context: SkillContext,\n    private specSkill?: SpecGeneratorSkill\n  ) {}\n\n  /** Pull next task from Linear, execute via RLM, update status */\n  async runNext(opts?: RunOptions): Promise<SkillResult> {\n    const tasks = this.getFilteredTasks(opts);\n\n    if (tasks.length === 0) {\n      return {\n        success: true,\n        message: 'No pending tasks found',\n        data: { tasksAvailable: 0 },\n      };\n    }\n\n    const task = tasks[0];\n    return this.runTask(task.id, opts);\n  }\n\n  /** Run all active tasks iteratively */\n  async runAll(opts?: RunOptions): Promise<SkillResult> {\n    const startTime = Date.now();\n    const tasks = this.getFilteredTasks(opts);\n\n    if (tasks.length === 0) {\n      return {\n        success: true,\n        message: 'No pending tasks to execute',\n        data: { tasksAvailable: 0 },\n      };\n    }\n\n    if (opts?.dryRun) {\n      return this.preview();\n    }\n\n    const summary: RunSummary = {\n      completed: [],\n      failed: [],\n      skipped: [],\n      totalTokens: 0,\n      totalCost: 0,\n      duration: 0,\n    };\n\n    // Sequential by default\n    for (const task of tasks) {\n      try {\n        const result = await this.executeTask(task);\n\n        if (result.success) {\n          summary.completed.push(task.id);\n          const data = result.data as Record<string, unknown> | undefined;\n          summary.totalTokens += (data?.totalTokens as number) || 0;\n          summary.totalCost += (data?.totalCost as number) || 0;\n\n          // Auto-update PROMPT_PLAN checkboxes if spec skill available\n          await this.autoUpdatePromptPlan(task);\n        } else {\n          summary.failed.push({\n            taskId: task.id,\n            error: result.message,\n          });\n        }\n\n        // Sync to Linear after each task\n        await this.syncSafe();\n      } catch (error: unknown) {\n        const msg = error instanceof Error ? error.message : String(error);\n        summary.failed.push({ taskId: task.id, error: msg });\n        logger.error('Task execution failed', { taskId: task.id, error: msg });\n      }\n    }\n\n    summary.duration = Date.now() - startTime;\n\n    return {\n      success: summary.failed.length === 0,\n      message: `Completed ${summary.completed.length}/${tasks.length} tasks`,\n      data: summary,\n      action: `Executed ${summary.completed.length} tasks, ${summary.failed.length} failures`,\n    };\n  }\n\n  /** Execute a specific Linear task by ID */\n  async runTask(taskId: string, opts?: RunOptions): Promise<SkillResult> {\n    const task = this.taskManager.getTask(taskId);\n\n    if (!task) {\n      return { success: false, message: `Task not found: ${taskId}` };\n    }\n\n    if (opts?.dryRun) {\n      return this.previewTask(task);\n    }\n\n    const result = await this.executeTask(task);\n\n    // Auto-update PROMPT_PLAN if successful\n    if (result.success) {\n      await this.autoUpdatePromptPlan(task);\n      await this.syncSafe();\n    }\n\n    return result;\n  }\n\n  /** Show execution plan without running */\n  async preview(taskId?: string): Promise<SkillResult> {\n    if (taskId) {\n      const task = this.taskManager.getTask(taskId);\n      if (!task) {\n        return { success: false, message: `Task not found: ${taskId}` };\n      }\n      return this.previewTask(task);\n    }\n\n    const tasks = this.getFilteredTasks();\n    const plan = tasks.map((t, i) => ({\n      order: i + 1,\n      id: t.id,\n      identifier: t.externalIdentifier || t.id,\n      title: t.title,\n      priority: t.priority || 'medium',\n      status: t.status,\n      tags: t.tags,\n    }));\n\n    return {\n      success: true,\n      message: `${plan.length} tasks in execution queue`,\n      data: { plan, totalTasks: plan.length },\n    };\n  }\n\n  // --- Private helpers ---\n\n  private async executeTask(task: Task): Promise<SkillResult> {\n    const taskLabel = task.externalIdentifier || task.id;\n\n    logger.info('Starting task execution', {\n      taskId: task.id,\n      title: task.title,\n    });\n\n    // 1. Mark as in_progress\n    try {\n      this.taskManager.updateTaskStatus(\n        task.id,\n        'in_progress',\n        'LinearTaskRunner: starting execution'\n      );\n    } catch {\n      // Non-fatal \u2014 task may already be in_progress\n    }\n\n    // 2. Execute via RLM orchestrator\n    try {\n      const result = await this.rlmOrchestrator.execute(\n        task.description || task.title,\n        {\n          linearTaskId: task.id,\n          linearIdentifier: task.externalIdentifier,\n          title: task.title,\n          tags: task.tags,\n        }\n      );\n\n      if (result.success) {\n        // 3. Mark as done\n        this.taskManager.updateTaskStatus(\n          task.id,\n          'done',\n          `Completed via RLM: ${result.improvements.length} improvements, ${result.testsGenerated} tests`\n        );\n\n        return {\n          success: true,\n          message: `${taskLabel}: completed`,\n          data: {\n            taskId: task.id,\n            duration: result.duration,\n            totalTokens: result.totalTokens,\n            totalCost: result.totalCost,\n            testsGenerated: result.testsGenerated,\n            improvements: result.improvements.length,\n            issuesFound: result.issuesFound,\n            issuesFixed: result.issuesFixed,\n          },\n          action: `Executed ${taskLabel} via RLM`,\n        };\n      } else {\n        // Leave as in_progress on failure \u2014 don't regress to todo\n        logger.warn('Task execution failed', {\n          taskId: task.id,\n          rootNode: result.rootNode,\n        });\n\n        return {\n          success: false,\n          message: `${taskLabel}: execution failed`,\n          data: {\n            taskId: task.id,\n            duration: result.duration,\n            totalTokens: result.totalTokens,\n          },\n        };\n      }\n    } catch (error: unknown) {\n      const msg = error instanceof Error ? error.message : String(error);\n      logger.error('Task execution threw', { taskId: task.id, error: msg });\n\n      return {\n        success: false,\n        message: `${taskLabel}: ${msg}`,\n        data: { taskId: task.id },\n      };\n    }\n  }\n\n  private getFilteredTasks(opts?: RunOptions): Task[] {\n    const tasks = this.taskManager.getTasksByStatus('todo');\n\n    let filtered = tasks;\n\n    // Filter by priority\n    if (opts?.priority) {\n      filtered = filtered.filter((t) => t.priority === opts.priority);\n    }\n\n    // Filter by tag\n    if (opts?.tag) {\n      const tag = opts.tag;\n      filtered = filtered.filter((t) => t.tags.includes(tag));\n    }\n\n    // Sort: urgent > high > medium > low\n    const priorityOrder: Record<string, number> = {\n      urgent: 0,\n      high: 1,\n      medium: 2,\n      low: 3,\n    };\n\n    return filtered.sort(\n      (a, b) =>\n        (priorityOrder[a.priority || 'medium'] || 2) -\n        (priorityOrder[b.priority || 'medium'] || 2)\n    );\n  }\n\n  private previewTask(task: Task): SkillResult {\n    return {\n      success: true,\n      message: `Preview: ${task.externalIdentifier || task.id}`,\n      data: {\n        id: task.id,\n        identifier: task.externalIdentifier,\n        title: task.title,\n        description: task.description?.slice(0, 200),\n        priority: task.priority,\n        status: task.status,\n        tags: task.tags,\n        willExecuteVia: 'RLM Orchestrator',\n        estimatedSteps: [\n          'Planning agent decomposes task',\n          'Code/Test/Review subagents execute',\n          'Multi-stage review',\n          'Update Linear status to done',\n        ],\n      },\n    };\n  }\n\n  /** Auto-update PROMPT_PLAN checkboxes when a task completes */\n  private async autoUpdatePromptPlan(task: Task): Promise<void> {\n    if (!this.specSkill) return;\n\n    const promptPlanPath = path.join(process.cwd(), PROMPT_PLAN_PATH);\n    if (!fs.existsSync(promptPlanPath)) return;\n\n    try {\n      // Try to match task title to a checkbox in PROMPT_PLAN\n      await this.specSkill.update(PROMPT_PLAN_PATH, task.title);\n      logger.info('Auto-updated PROMPT_PLAN checkbox', {\n        taskId: task.id,\n        title: task.title,\n      });\n    } catch {\n      // Non-fatal \u2014 task title may not match any checkbox\n    }\n  }\n\n  /** Safe Linear sync \u2014 log errors but don't throw */\n  private async syncSafe(): Promise<void> {\n    try {\n      await this.taskManager.syncWithLinear();\n    } catch (error: unknown) {\n      const msg = error instanceof Error ? error.message : String(error);\n      logger.warn('Linear sync failed (non-fatal)', { error: msg });\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/skills/recursive-agent-orchestrator.js

@@ -2,6 +2,8 @@ import { fileURLToPath as __fileURLToPath } from 'url';
 import { dirname as __pathDirname } from 'path';
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __pathDirname(__filename);
+import * as fs from "fs";
+import * as path from "path";
 import { logger } from "../core/monitoring/logger.js";
 import { ParallelExecutor } from "../core/execution/parallel-executor.js";
 import { RecursiveContextManager } from "../core/context/recursive-context-manager.js";
@@ -61,42 +63,46 @@ class RecursiveAgentOrchestrator {
     const configs = /* @__PURE__ */ new Map();
     configs.set("planning", {
       type: "planning",
-      model: "claude-3-5-sonnet-latest",
+      model: "claude-sonnet-4-5-20250929",
       maxTokens: 2e4,
       temperature: 0.3,
-      systemPrompt: `You are a Planning Agent specializing in task decomposition.
-        Analyze complex tasks and break them into parallel and sequential subtasks.
-        Create detailed execution plans with clear dependencies.
-        Consider edge cases and potential failures.
-        Output structured task trees with agent assignments.`,
+      systemPrompt: `You decompose tasks into parallel/sequential subtask trees.
+Output JSON: { subtasks: [{ id, description, agent, dependencies[], parallel: bool }] }
+Rules:
+- Maximize parallelism \u2014 independent tasks run concurrently
+- Each subtask names its agent type: planning, code, testing, linting, review, improve, context, publish
+- Include failure modes and rollback steps for risky operations
+- Keep subtask descriptions actionable (verb + object + constraint)`,
       capabilities: ["decompose", "analyze", "strategize", "prioritize"]
     });
     configs.set("code", {
       type: "code",
-      model: "claude-3-5-sonnet-latest",
+      model: "claude-sonnet-4-5-20250929",
       maxTokens: 3e4,
       temperature: 0.2,
-      systemPrompt: `You are a Code Agent specializing in implementation.
-        Write clean, maintainable, production-ready code.
-        Follow project conventions and best practices.
-        Include comprehensive error handling.
-        Document complex logic with clear comments.`,
+      systemPrompt: `You implement code changes. Read existing code before modifying.
+Output JSON: { success: bool, filesChanged: string[], changes: string[], notes: string[] }
+Rules:
+- Follow existing project conventions (naming, imports, patterns)
+- Add .js extensions to relative TypeScript imports (ESM)
+- Return undefined over throwing; log+continue over crash
+- No emojis, no unnecessary comments, functions under 20 lines
+- Validate inputs at system boundaries only`,
       capabilities: ["implement", "refactor", "optimize", "document"]
     });
     configs.set("testing", {
       type: "testing",
-      model: "claude-3-5-sonnet-latest",
-      // High quality for test generation
+      model: "claude-sonnet-4-5-20250929",
       maxTokens: 25e3,
       temperature: 0.1,
-      systemPrompt: `You are a Testing Agent specializing in test generation and validation.
-        Generate comprehensive test suites including:
-        - Unit tests for all functions/methods
-        - Integration tests for API endpoints
-        - E2E tests for critical user flows
-        - Edge cases and error scenarios
-        Ensure 100% code coverage where possible.
-        Validate that all tests pass and are meaningful.`,
+      systemPrompt: `You generate and run tests using the project's test framework.
+Output JSON: { success: bool, tests: [{ name, type, file }], coverage: string, notes: string[] }
+Rules:
+- Use vitest (describe/it/expect) \u2014 check existing tests for patterns
+- Prioritize: critical paths > edge cases > happy paths
+- Each test should assert meaningful behavior, not implementation details
+- Use parameterized tests (it.each) to consolidate similar cases
+- Run tests after writing: npm run test:run`,
       capabilities: [
         "generate-tests",
         "validate",
@@ -106,33 +112,31 @@ class RecursiveAgentOrchestrator {
     });
     configs.set("linting", {
       type: "linting",
-      model: "claude-3-5-haiku-latest",
+      model: "claude-haiku-4-5-20251001",
       maxTokens: 15e3,
       temperature: 0,
-      systemPrompt: `You are a Linting Agent specializing in code quality.
-        Check for:
-        - Syntax errors and type issues
-        - Code formatting and style violations
-        - Security vulnerabilities
-        - Performance anti-patterns
-        - Unused imports and dead code
-        Provide actionable fixes for all issues found.`,
+      systemPrompt: `You run lint checks and fix issues.
+Output JSON: { success: bool, issuesFound: number, issuesFixed: number, remaining: string[] }
+Rules:
+- Run: npm run lint (ESLint + Prettier)
+- Auto-fix: npm run lint:fix
+- ESM imports require .js extension on relative paths
+- Report unfixable issues with file:line format`,
       capabilities: ["lint", "format", "type-check", "security-scan"]
     });
     configs.set("review", {
       type: "review",
-      model: "claude-3-5-sonnet-latest",
+      model: "claude-sonnet-4-5-20250929",
       maxTokens: 25e3,
       temperature: 0.2,
-      systemPrompt: `You are a Review Agent specializing in multi-stage code review.
-        Perform thorough reviews focusing on:
-        - Architecture and design patterns
-        - Code quality and maintainability
-        - Performance implications
-        - Security considerations
-        - Test coverage adequacy
-        Suggest specific improvements with examples.
-        Rate quality on a 0-1 scale.`,
+      systemPrompt: `You review code changes for quality, security, and correctness.
+Output JSON: { qualityScore: 0-1, issues: [{ severity, file, line, description, suggestion }], approved: bool }
+Rules:
+- Score 0.85+ = approved, below = needs improvement
+- Flag: SQL injection, XSS, secret exposure, command injection
+- Flag: functions > 20 lines, cyclomatic complexity > 5
+- Flag: missing error handling at system boundaries
+- Suggest specific fixes, not vague improvements`,
       capabilities: [
         "review",
         "critique",
@@ -142,46 +146,44 @@ class RecursiveAgentOrchestrator {
     });
     configs.set("improve", {
       type: "improve",
-      model: "claude-3-5-sonnet-latest",
+      model: "claude-sonnet-4-5-20250929",
       maxTokens: 3e4,
       temperature: 0.3,
-      systemPrompt: `You are an Improvement Agent specializing in code enhancement.
-        Take reviewed code and implement suggested improvements:
-        - Refactor for better architecture
-        - Optimize performance bottlenecks
-        - Enhance error handling
-        - Improve code clarity and documentation
-        - Add missing test cases
-        Ensure all improvements maintain backward compatibility.`,
+      systemPrompt: `You implement review feedback and improve code quality.
+Output JSON: { success: bool, improvements: string[], filesChanged: string[] }
+Rules:
+- Apply only the specific improvements requested \u2014 no scope creep
+- Maintain backward compatibility unless explicitly breaking
+- Run lint + tests after changes to verify nothing regressed
+- Keep changes minimal and focused`,
       capabilities: ["enhance", "refactor", "optimize", "polish"]
     });
     configs.set("context", {
       type: "context",
-      model: "claude-3-5-haiku-latest",
+      model: "claude-haiku-4-5-20251001",
       maxTokens: 1e4,
       temperature: 0,
-      systemPrompt: `You are a Context Agent specializing in information retrieval.
-        Search and retrieve relevant context from:
-        - Project codebase and documentation
-        - Previous frame history
-        - Similar implementations
-        - Best practices and patterns
-        Provide concise, relevant context for other agents.`,
+      systemPrompt: `You retrieve relevant context from the codebase and specs.
+Output JSON: { context: string, sources: string[], relevanceScore: 0-1 }
+Rules:
+- Check docs/specs/ for ONE_PAGER.md, DEV_SPEC.md, PROMPT_PLAN.md
+- Check CLAUDE.md and AGENTS.md for project conventions
+- Search src/ for relevant implementations
+- Return concise summaries, not full file contents`,
       capabilities: ["search", "retrieve", "summarize", "contextualize"]
     });
     configs.set("publish", {
       type: "publish",
-      model: "claude-3-5-haiku-latest",
+      model: "claude-haiku-4-5-20251001",
       maxTokens: 15e3,
       temperature: 0,
-      systemPrompt: `You are a Publish Agent specializing in release management.
-        Handle:
-        - NPM package publishing
-        - GitHub releases and tagging
-        - Documentation updates
-        - Changelog generation
-        - Deployment automation
-        Ensure all release steps are properly sequenced.`,
+      systemPrompt: `You handle releases and publishing.
+Output JSON: { success: bool, version: string, actions: string[] }
+Rules:
+- Verify lint + tests + build pass before any publish
+- Follow semver: breaking=major, feature=minor, fix=patch
+- Generate changelog from git log since last tag
+- Never force-push or skip pre-publish hooks`,
       capabilities: ["publish-npm", "github-release", "deploy", "document"]
     });
     return configs;
@@ -479,23 +481,50 @@ class RecursiveAgentOrchestrator {
     node.children.push(testNode);
   }
   injectReviewStages(_node, _stages) {
+  }
+  loadSpecContext() {
+    const specDir = path.join(process.cwd(), "docs", "specs");
+    if (!fs.existsSync(specDir)) return "";
+    const specFiles = ["ONE_PAGER.md", "DEV_SPEC.md", "PROMPT_PLAN.md"];
+    const sections = [];
+    for (const file of specFiles) {
+      const filePath = path.join(specDir, file);
+      if (fs.existsSync(filePath)) {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const truncated = content.length > 2e3 ? content.slice(0, 2e3) + "\n...[truncated]" : content;
+        sections.push(`### ${file}
+${truncated}`);
+      }
+    }
+    return sections.length > 0 ? `
+## Project Specs
+${sections.join("\n\n")}` : "";
   }
   buildAgentPrompt(node, context) {
-    return `
-      Task: ${node.description}
-      
-      Context:
-      ${JSON.stringify(context, null, 2)}
-      
-      Previous Results:
-      ${JSON.stringify(
-      node.dependencies.map((id) => this.activeExecutions.get(id)?.result),
-      null,
-      2
-    )}
-      
-      Please complete this task following your specialized role.
-    `;
+    const depResults = node.dependencies.map((id) => {
+      const dep = this.activeExecutions.get(id);
+      if (!dep?.result) return null;
+      return { id, agent: dep.agent, result: dep.result };
+    }).filter(Boolean);
+    const specContext = node.agent === "planning" || node.agent === "code" ? this.loadSpecContext() : "";
+    return [
+      `## Task`,
+      node.description,
+      "",
+      `## Agent Role: ${node.agent}`,
+      `Config: ${JSON.stringify(this.subagentConfigs.get(node.agent)?.capabilities || [])}`,
+      "",
+      `## Context`,
+      JSON.stringify(context, null, 2),
+      "",
+      ...depResults.length > 0 ? [`## Dependency Results`, JSON.stringify(depResults, null, 2), ""] : [],
+      ...specContext ? [specContext, ""] : [],
+      `## Constraints`,
+      `- ESM imports: use .js extensions on relative imports`,
+      `- Testing: vitest (not jest)`,
+      `- Lint: npm run lint (eslint + prettier)`,
+      `- Output structured JSON when possible`
+    ].join("\n");
   }
   estimateTokens(text) {
     return Math.ceil(text.length / 4);
@@ -526,9 +555,9 @@ class RecursiveAgentOrchestrator {
   }
   calculateNodeCost(tokens, model) {
     const pricing = {
-      "claude-3-5-sonnet-latest": 15,
-      "claude-3-5-haiku-latest": 1,
-      "claude-3-opus-latest": 75
+      "claude-sonnet-4-5-20250929": 15,
+      "claude-haiku-4-5-20251001": 1,
+      "claude-opus-4-6": 75
     };
     return tokens / 1e6 * (pricing[model] || 10);
   }