oh-my-claude-sisyphus 3.5.8 → 3.6.0

package/dist/hooks/swarm/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Swarm Coordination Types
+ *
+ * Type definitions for the SQLite-based swarm coordination system.
+ * Swarm enables multiple agents to claim and work on tasks atomically
+ * with lease-based ownership and heartbeat monitoring.
+ */
+/**
+ * A task in the swarm task pool
+ */
+export interface SwarmTask {
+    /** Unique task identifier */
+    id: string;
+    /** Human-readable task description */
+    description: string;
+    /** Current task status */
+    status: 'pending' | 'claimed' | 'done' | 'failed';
+    /** Agent ID that claimed this task (null if unclaimed) */
+    claimedBy: string | null;
+    /** Unix timestamp when task was claimed (null if unclaimed) */
+    claimedAt: number | null;
+    /** Unix timestamp when task was completed (null if incomplete) */
+    completedAt: number | null;
+    /** Error message if task failed */
+    error?: string;
+    /** Result/output from completed task */
+    result?: string;
+}
+/**
+ * Overall swarm state
+ */
+export interface SwarmState {
+    /** Whether swarm is currently active */
+    active: boolean;
+    /** Unique session identifier */
+    sessionId: string;
+    /** Number of agents participating in the swarm */
+    agentCount: number;
+    /** All tasks in the swarm */
+    tasks: SwarmTask[];
+    /** Timestamp when swarm was started */
+    startedAt: number;
+    /** Timestamp when swarm completed (null if still running) */
+    completedAt: number | null;
+}
+/**
+ * Result of attempting to claim a task
+ */
+export interface ClaimResult {
+    /** Whether the claim was successful */
+    success: boolean;
+    /** ID of the claimed task (null if claim failed) */
+    taskId: string | null;
+    /** Task description (for convenience) */
+    description?: string;
+    /** Reason for failure if claim was unsuccessful */
+    reason?: string;
+}
+/**
+ * Configuration for swarm initialization
+ */
+export interface SwarmConfig {
+    /** Number of agents to spawn */
+    agentCount: number;
+    /** Task descriptions to add to the pool */
+    tasks: string[];
+    /** Agent type/model to use (default: executor) */
+    agentType?: string;
+    /** Lease timeout in milliseconds (default: 5 minutes) */
+    leaseTimeout?: number;
+    /** Heartbeat interval in milliseconds (default: 60 seconds) */
+    heartbeatInterval?: number;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * Agent heartbeat record
+ */
+export interface AgentHeartbeat {
+    /** Agent identifier */
+    agentId: string;
+    /** Unix timestamp of last heartbeat */
+    lastHeartbeat: number;
+    /** Task currently being worked on (null if idle) */
+    currentTaskId: string | null;
+}
+/**
+ * Swarm statistics
+ */
+export interface SwarmStats {
+    /** Total number of tasks */
+    totalTasks: number;
+    /** Number of pending tasks */
+    pendingTasks: number;
+    /** Number of claimed/in-progress tasks */
+    claimedTasks: number;
+    /** Number of completed tasks */
+    doneTasks: number;
+    /** Number of failed tasks */
+    failedTasks: number;
+    /** Number of active agents */
+    activeAgents: number;
+    /** Elapsed time in milliseconds */
+    elapsedTime: number;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_SWARM_CONFIG: Required<Omit<SwarmConfig, 'tasks' | 'cwd'>> & {
+    tasks: string[];
+};
+/**
+ * Database schema version for migrations
+ */
+export declare const DB_SCHEMA_VERSION = 1;
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/swarm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/swarm/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClD,0DAA0D;IAC1D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAMlG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC"}

package/dist/hooks/swarm/types.js

@@ -0,0 +1,22 @@
+/**
+ * Swarm Coordination Types
+ *
+ * Type definitions for the SQLite-based swarm coordination system.
+ * Swarm enables multiple agents to claim and work on tasks atomically
+ * with lease-based ownership and heartbeat monitoring.
+ */
+/**
+ * Default configuration values
+ */
+export const DEFAULT_SWARM_CONFIG = {
+    agentCount: 3,
+    tasks: [],
+    agentType: 'executor',
+    leaseTimeout: 5 * 60 * 1000, // 5 minutes
+    heartbeatInterval: 60 * 1000 // 60 seconds
+};
+/**
+ * Database schema version for migrations
+ */
+export const DB_SCHEMA_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/hooks/swarm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/swarm/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0GH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAuE;IACtG,UAAU,EAAE,CAAC;IACb,KAAK,EAAE,EAAE;IACT,SAAS,EAAE,UAAU;IACrB,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACzC,iBAAiB,EAAE,EAAE,GAAG,IAAI,CAAC,aAAa;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC"}

package/dist/hooks/ultrapilot/decomposer.d.ts

@@ -0,0 +1,141 @@
+/**
+ * AI-Powered Task Decomposition for Ultrapilot
+ *
+ * This module provides intelligent task decomposition using an Architect agent
+ * to analyze tasks and break them into parallel-safe subtasks with proper
+ * file ownership and dependency tracking.
+ */
+/**
+ * Agent type for task execution, determines model complexity
+ */
+export type AgentType = 'executor-low' | 'executor' | 'executor-high';
+/**
+ * Model tier for agent execution
+ */
+export type ModelTier = 'haiku' | 'sonnet' | 'opus';
+/**
+ * A decomposed subtask with file ownership and dependencies
+ */
+export interface DecomposedTask {
+    /** Unique identifier for this subtask */
+    id: string;
+    /** Clear description of what to implement */
+    description: string;
+    /** Files this task will touch (can include globs) */
+    files: string[];
+    /** Task IDs this subtask depends on (must complete first) */
+    blockedBy: string[];
+    /** Agent type based on task complexity */
+    agentType: AgentType;
+    /** Model tier for execution */
+    model: ModelTier;
+}
+/**
+ * Result of task decomposition
+ */
+export interface DecompositionResult {
+    /** Array of parallelizable subtasks */
+    subtasks: DecomposedTask[];
+    /** Files that need sequential handling (config, lock files) */
+    sharedFiles: string[];
+    /** Groups of task IDs that can run in parallel (dependency-ordered) */
+    parallelGroups: string[][];
+}
+/**
+ * Options for decomposition prompt generation
+ */
+export interface DecompositionOptions {
+    /** Maximum number of subtasks to generate */
+    maxSubtasks?: number;
+    /** Preferred model tier for workers */
+    preferredModel?: ModelTier;
+    /** Additional context about project structure */
+    projectContext?: string;
+}
+/**
+ * Default shared file patterns that should be handled by coordinator
+ */
+export declare const DEFAULT_SHARED_FILE_PATTERNS: string[];
+/**
+ * Generate a prompt for the Architect agent to decompose a task
+ *
+ * This prompt instructs the Architect to analyze the task and codebase context,
+ * then produce a structured JSON decomposition with file ownership and dependencies.
+ *
+ * @param task - The task description to decompose
+ * @param codebaseContext - Context about the codebase structure, files, and patterns
+ * @param options - Optional configuration for decomposition
+ * @returns Formatted prompt string for the Architect agent
+ *
+ * @example
+ * ```typescript
+ * const prompt = generateDecompositionPrompt(
+ *   "Build a full-stack todo app with React and Express",
+ *   "Project has src/client and src/server directories..."
+ * );
+ * // Use with Architect agent via Task tool
+ * ```
+ */
+export declare function generateDecompositionPrompt(task: string, codebaseContext: string, options?: DecompositionOptions): string;
+/**
+ * Parse the Architect's response into a structured DecompositionResult
+ *
+ * Handles various response formats including:
+ * - Raw JSON
+ * - JSON wrapped in markdown code fences
+ * - JSON with surrounding explanation text
+ *
+ * @param response - Raw response string from the Architect agent
+ * @returns Parsed and validated DecompositionResult
+ * @throws Error if response cannot be parsed or is invalid
+ *
+ * @example
+ * ```typescript
+ * const result = parseDecompositionResult(architectResponse);
+ * console.log(result.subtasks.length); // Number of parallel tasks
+ * console.log(result.parallelGroups); // Execution order
+ * ```
+ */
+export declare function parseDecompositionResult(response: string): DecompositionResult;
+/**
+ * Generate parallel groups from subtask dependencies
+ *
+ * Creates an ordered array of task ID groups where each group can run
+ * in parallel, and later groups depend on earlier ones completing.
+ *
+ * @param subtasks - Array of decomposed subtasks with blockedBy fields
+ * @returns Array of parallel groups (each group is array of task IDs)
+ */
+export declare function generateParallelGroups(subtasks: DecomposedTask[]): string[][];
+/**
+ * Validate that file ownership doesn't overlap between subtasks
+ *
+ * @param subtasks - Array of decomposed subtasks
+ * @returns Object with isValid flag and any conflicts found
+ */
+export declare function validateFileOwnership(subtasks: DecomposedTask[]): {
+    isValid: boolean;
+    conflicts: Array<{
+        file: string;
+        owners: string[];
+    }>;
+};
+/**
+ * Merge shared files from subtasks into the sharedFiles list
+ *
+ * Identifies files that match shared file patterns and removes them
+ * from subtask ownership, adding them to sharedFiles instead.
+ *
+ * @param result - DecompositionResult to process
+ * @param patterns - Array of glob patterns for shared files
+ * @returns Updated DecompositionResult with shared files extracted
+ */
+export declare function extractSharedFiles(result: DecompositionResult, patterns?: string[]): DecompositionResult;
+/**
+ * Convert DecompositionResult to simple string array for legacy compatibility
+ *
+ * @param result - Full decomposition result
+ * @returns Array of task description strings
+ */
+export declare function toSimpleSubtasks(result: DecompositionResult): string[];
+//# sourceMappingURL=decomposer.d.ts.map

package/dist/hooks/ultrapilot/decomposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer.d.ts","sourceRoot":"","sources":["../../../src/hooks/ultrapilot/decomposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,eAAe,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,+BAA+B;IAC/B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uEAAuE;IACvE,cAAc,EAAE,MAAM,EAAE,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,UA0BxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,oBAAyB,GACjC,MAAM,CA8GR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAmF9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,EAAE,CAmC7E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACtD,CAuBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,GAAE,MAAM,EAAiC,GAChD,mBAAmB,CAoCrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAEtE"}

package/dist/hooks/ultrapilot/decomposer.js

@@ -0,0 +1,377 @@
+/**
+ * AI-Powered Task Decomposition for Ultrapilot
+ *
+ * This module provides intelligent task decomposition using an Architect agent
+ * to analyze tasks and break them into parallel-safe subtasks with proper
+ * file ownership and dependency tracking.
+ */
+/**
+ * Default shared file patterns that should be handled by coordinator
+ */
+export const DEFAULT_SHARED_FILE_PATTERNS = [
+    'package.json',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+    'tsconfig.json',
+    'tsconfig.*.json',
+    'jest.config.js',
+    'jest.config.ts',
+    'vitest.config.ts',
+    '.eslintrc.*',
+    '.prettierrc.*',
+    '.gitignore',
+    'README.md',
+    'Makefile',
+    'go.mod',
+    'go.sum',
+    'Cargo.toml',
+    'Cargo.lock',
+    'pyproject.toml',
+    'requirements.txt',
+    'setup.py',
+    'Dockerfile',
+    'docker-compose.yml',
+    '.github/**',
+    '.gitlab-ci.yml'
+];
+/**
+ * Generate a prompt for the Architect agent to decompose a task
+ *
+ * This prompt instructs the Architect to analyze the task and codebase context,
+ * then produce a structured JSON decomposition with file ownership and dependencies.
+ *
+ * @param task - The task description to decompose
+ * @param codebaseContext - Context about the codebase structure, files, and patterns
+ * @param options - Optional configuration for decomposition
+ * @returns Formatted prompt string for the Architect agent
+ *
+ * @example
+ * ```typescript
+ * const prompt = generateDecompositionPrompt(
+ *   "Build a full-stack todo app with React and Express",
+ *   "Project has src/client and src/server directories..."
+ * );
+ * // Use with Architect agent via Task tool
+ * ```
+ */
+export function generateDecompositionPrompt(task, codebaseContext, options = {}) {
+    const { maxSubtasks = 5, preferredModel = 'sonnet', projectContext = '' } = options;
+    const additionalContext = projectContext ? `\nPROJECT NOTES:\n${projectContext}\n` : '';
+    return `Analyze this task and decompose it into parallel-safe subtasks for concurrent execution.
+
+TASK: ${task}
+
+CODEBASE CONTEXT:
+${codebaseContext}
+${additionalContext}
+OUTPUT REQUIREMENTS:
+Return a valid JSON object matching this exact schema:
+
+{
+  "subtasks": [
+    {
+      "id": "1",
+      "description": "Clear, actionable description of what to implement",
+      "files": ["src/path/to/file.ts", "src/path/to/other.ts"],
+      "blockedBy": [],
+      "agentType": "executor",
+      "model": "sonnet"
+    }
+  ],
+  "sharedFiles": ["package.json", "tsconfig.json"],
+  "parallelGroups": [["1", "2"], ["3"]]
+}
+
+DECOMPOSITION RULES:
+
+1. FILE OWNERSHIP:
+   - Each subtask should have exclusive ownership of its files
+   - NO file should appear in multiple subtasks' files arrays
+   - Use specific file paths, not directories (unless truly needed)
+   - Mark config/lock files as sharedFiles (handled by coordinator)
+
+2. DEPENDENCIES (blockedBy):
+   - Only add blockedBy if subtask TRULY requires another to complete first
+   - Prefer parallel execution - maximize independent subtasks
+   - Common dependencies: type definitions, shared utilities, API contracts
+
+3. PARALLEL GROUPS:
+   - Group subtasks that can run simultaneously
+   - First group has no dependencies
+   - Later groups depend on earlier ones completing
+   - Example: [["1", "2", "3"], ["4", "5"]] means 1,2,3 run first, then 4,5
+
+4. AGENT/MODEL SELECTION:
+   - executor-low/haiku: Simple changes, single file, straightforward logic
+   - executor/sonnet: Standard implementation, moderate complexity (DEFAULT)
+   - executor-high/opus: Complex refactoring, architectural changes, multi-file coordination
+
+5. SUBTASK GUIDELINES:
+   - Maximum ${maxSubtasks} subtasks
+   - Preferred model tier: ${preferredModel}
+   - Each subtask should be completable in 2-10 minutes
+   - Subtask description should be actionable and specific
+   - Include all files the subtask will CREATE or MODIFY
+
+6. SHARED FILES (coordinator handles):
+   - package.json, lock files
+   - tsconfig.json, config files
+   - Root README.md
+   - Docker/CI configuration
+   - Any file multiple subtasks would need to modify
+
+EXAMPLE OUTPUT:
+
+{
+  "subtasks": [
+    {
+      "id": "1",
+      "description": "Create Express API routes for todo CRUD operations",
+      "files": ["src/server/routes/todos.ts", "src/server/controllers/todoController.ts"],
+      "blockedBy": [],
+      "agentType": "executor",
+      "model": "sonnet"
+    },
+    {
+      "id": "2",
+      "description": "Create React components for todo list UI",
+      "files": ["src/client/components/TodoList.tsx", "src/client/components/TodoItem.tsx"],
+      "blockedBy": [],
+      "agentType": "executor",
+      "model": "sonnet"
+    },
+    {
+      "id": "3",
+      "description": "Create database schema and migrations for todos",
+      "files": ["src/db/migrations/001_create_todos.ts", "src/db/models/Todo.ts"],
+      "blockedBy": [],
+      "agentType": "executor-low",
+      "model": "haiku"
+    },
+    {
+      "id": "4",
+      "description": "Wire up API client in frontend to connect to backend",
+      "files": ["src/client/api/todoApi.ts", "src/client/hooks/useTodos.ts"],
+      "blockedBy": ["1", "2"],
+      "agentType": "executor",
+      "model": "sonnet"
+    }
+  ],
+  "sharedFiles": ["package.json", "tsconfig.json", "src/types/todo.ts"],
+  "parallelGroups": [["1", "2", "3"], ["4"]]
+}
+
+Return ONLY the JSON object, no markdown code fences or additional text.`;
+}
+/**
+ * Parse the Architect's response into a structured DecompositionResult
+ *
+ * Handles various response formats including:
+ * - Raw JSON
+ * - JSON wrapped in markdown code fences
+ * - JSON with surrounding explanation text
+ *
+ * @param response - Raw response string from the Architect agent
+ * @returns Parsed and validated DecompositionResult
+ * @throws Error if response cannot be parsed or is invalid
+ *
+ * @example
+ * ```typescript
+ * const result = parseDecompositionResult(architectResponse);
+ * console.log(result.subtasks.length); // Number of parallel tasks
+ * console.log(result.parallelGroups); // Execution order
+ * ```
+ */
+export function parseDecompositionResult(response) {
+    // Try to extract JSON from response (may be wrapped in markdown or have surrounding text)
+    let jsonStr;
+    // First, try to find JSON in markdown code fences
+    const fencedMatch = response.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (fencedMatch && fencedMatch[1]) {
+        jsonStr = fencedMatch[1].trim();
+    }
+    else {
+        // Try to find raw JSON object
+        const jsonMatch = response.match(/\{[\s\S]*\}/);
+        if (!jsonMatch) {
+            throw new Error('Could not parse decomposition result: no JSON object found in response');
+        }
+        jsonStr = jsonMatch[0];
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonStr);
+    }
+    catch (e) {
+        throw new Error(`Could not parse decomposition result: invalid JSON - ${e instanceof Error ? e.message : 'unknown error'}`);
+    }
+    // Validate structure
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error('Could not parse decomposition result: response is not an object');
+    }
+    const result = parsed;
+    // Validate required fields
+    if (!Array.isArray(result.subtasks)) {
+        throw new Error('Could not parse decomposition result: missing or invalid subtasks array');
+    }
+    // Validate each subtask
+    for (const subtask of result.subtasks) {
+        if (!subtask || typeof subtask !== 'object') {
+            throw new Error('Could not parse decomposition result: invalid subtask object');
+        }
+        const st = subtask;
+        if (typeof st.id !== 'string' || !st.id) {
+            throw new Error('Could not parse decomposition result: subtask missing id');
+        }
+        if (typeof st.description !== 'string' || !st.description) {
+            throw new Error('Could not parse decomposition result: subtask missing description');
+        }
+        if (!Array.isArray(st.files)) {
+            throw new Error(`Could not parse decomposition result: subtask ${st.id} missing files array`);
+        }
+        if (!Array.isArray(st.blockedBy)) {
+            // Default to empty array if not provided
+            st.blockedBy = [];
+        }
+        // Validate and default agentType
+        const validAgentTypes = ['executor-low', 'executor', 'executor-high'];
+        if (!st.agentType || !validAgentTypes.includes(st.agentType)) {
+            st.agentType = 'executor';
+        }
+        // Validate and default model
+        const validModels = ['haiku', 'sonnet', 'opus'];
+        if (!st.model || !validModels.includes(st.model)) {
+            st.model = 'sonnet';
+        }
+    }
+    // Validate/default sharedFiles
+    if (!Array.isArray(result.sharedFiles)) {
+        result.sharedFiles = [];
+    }
+    // Validate/default parallelGroups
+    if (!Array.isArray(result.parallelGroups)) {
+        // Generate default parallel groups based on blockedBy
+        result.parallelGroups = generateParallelGroups(result.subtasks);
+    }
+    return result;
+}
+/**
+ * Generate parallel groups from subtask dependencies
+ *
+ * Creates an ordered array of task ID groups where each group can run
+ * in parallel, and later groups depend on earlier ones completing.
+ *
+ * @param subtasks - Array of decomposed subtasks with blockedBy fields
+ * @returns Array of parallel groups (each group is array of task IDs)
+ */
+export function generateParallelGroups(subtasks) {
+    const groups = [];
+    const completed = new Set();
+    const remaining = new Set(subtasks.map((t) => t.id));
+    while (remaining.size > 0) {
+        const currentGroup = [];
+        for (const subtask of subtasks) {
+            if (!remaining.has(subtask.id))
+                continue;
+            // Check if all dependencies are completed
+            const depsCompleted = subtask.blockedBy.every((dep) => completed.has(dep));
+            if (depsCompleted) {
+                currentGroup.push(subtask.id);
+            }
+        }
+        if (currentGroup.length === 0) {
+            // Circular dependency detected - add remaining tasks to break cycle
+            const remainingIds = Array.from(remaining);
+            groups.push(remainingIds);
+            break;
+        }
+        // Mark current group as completed
+        for (const id of currentGroup) {
+            completed.add(id);
+            remaining.delete(id);
+        }
+        groups.push(currentGroup);
+    }
+    return groups;
+}
+/**
+ * Validate that file ownership doesn't overlap between subtasks
+ *
+ * @param subtasks - Array of decomposed subtasks
+ * @returns Object with isValid flag and any conflicts found
+ */
+export function validateFileOwnership(subtasks) {
+    const fileToOwners = new Map();
+    for (const subtask of subtasks) {
+        for (const file of subtask.files) {
+            if (!fileToOwners.has(file)) {
+                fileToOwners.set(file, []);
+            }
+            fileToOwners.get(file).push(subtask.id);
+        }
+    }
+    const conflicts = [];
+    for (const [file, owners] of fileToOwners.entries()) {
+        if (owners.length > 1) {
+            conflicts.push({ file, owners });
+        }
+    }
+    return {
+        isValid: conflicts.length === 0,
+        conflicts
+    };
+}
+/**
+ * Merge shared files from subtasks into the sharedFiles list
+ *
+ * Identifies files that match shared file patterns and removes them
+ * from subtask ownership, adding them to sharedFiles instead.
+ *
+ * @param result - DecompositionResult to process
+ * @param patterns - Array of glob patterns for shared files
+ * @returns Updated DecompositionResult with shared files extracted
+ */
+export function extractSharedFiles(result, patterns = DEFAULT_SHARED_FILE_PATTERNS) {
+    const sharedSet = new Set(result.sharedFiles);
+    // Simple pattern matching (exact match or basic glob)
+    const isSharedFile = (file) => {
+        const fileName = file.split('/').pop() || file;
+        return patterns.some((pattern) => {
+            if (pattern.includes('*')) {
+                // Basic glob: convert to regex
+                const regex = new RegExp('^' + pattern.replace(/\./g, '\\.').replace(/\*/g, '.*') + '$');
+                return regex.test(file) || regex.test(fileName);
+            }
+            return file === pattern || fileName === pattern;
+        });
+    };
+    // Process each subtask
+    const updatedSubtasks = result.subtasks.map((subtask) => {
+        const ownedFiles = [];
+        for (const file of subtask.files) {
+            if (isSharedFile(file)) {
+                sharedSet.add(file);
+            }
+            else {
+                ownedFiles.push(file);
+            }
+        }
+        return { ...subtask, files: ownedFiles };
+    });
+    return {
+        subtasks: updatedSubtasks,
+        sharedFiles: Array.from(sharedSet),
+        parallelGroups: result.parallelGroups
+    };
+}
+/**
+ * Convert DecompositionResult to simple string array for legacy compatibility
+ *
+ * @param result - Full decomposition result
+ * @returns Array of task description strings
+ */
+export function toSimpleSubtasks(result) {
+    return result.subtasks.map((t) => t.description);
+}
+//# sourceMappingURL=decomposer.js.map

package/dist/hooks/ultrapilot/decomposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer.js","sourceRoot":"","sources":["../../../src/hooks/ultrapilot/decomposer.ts"],"names":[],"mappings":"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"}