agent-orchestration 0.5.0 → 0.6.0

package/dist/tools/research.js

@@ -0,0 +1,182 @@
+/**
+ * Research workflow tools
+ *
+ * These tools implement the Research-First Workflow, ensuring agents
+ * properly understand context, requirements, and design before implementation.
+ */
+import { z } from 'zod';
+import { getDatabase } from '../database.js';
+import { TaskComplexity, RESEARCH_REQUIREMENTS } from '../models.js';
+export function registerResearchTools(server) {
+    // research_ready
+    server.tool('research_ready', 'Mark research as complete for a task. Validates that all required research items are documented based on task complexity. Call this before starting implementation.', {
+        task_id: z.string().describe('The task ID to mark as research-ready'),
+    }, async ({ task_id }) => {
+        const db = getDatabase();
+        const result = db.markResearchReady(task_id);
+        if (!result.success) {
+            return {
+                content: [{ type: 'text', text: `❌ ${result.message}` }],
+            };
+        }
+        const lines = [
+            '# ✅ Research Complete',
+            '',
+            `**Task**: ${result.task?.title}`,
+            `**Complexity**: ${result.task?.complexity}`,
+            '',
+            'You may now proceed with implementation.',
+            '',
+            'Next steps:',
+            '1. `task_claim` to start working',
+            '2. `lock_acquire` on files you\'ll edit',
+            '3. Implement the solution',
+            '4. `task_complete` when done',
+        ];
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+    // research_status
+    server.tool('research_status', 'Check research progress for a task. Shows what research is required, completed, and missing based on task complexity.', {
+        task_id: z.string().describe('The task ID to check research status for'),
+    }, async ({ task_id }) => {
+        const db = getDatabase();
+        const status = db.getResearchStatus(task_id);
+        if (!status.task) {
+            return {
+                content: [{ type: 'text', text: `Task ${task_id} not found.` }],
+            };
+        }
+        const task = status.task;
+        const lines = [
+            '# Research Status',
+            '',
+            `**Task**: ${task.title}`,
+            `**Complexity**: ${task.complexity}`,
+            `**Research Ready**: ${task.researchReady ? '✅ Yes' : '❌ No'}`,
+            '',
+        ];
+        if (status.required.length === 0) {
+            lines.push('_No research required for trivial tasks._');
+        }
+        else {
+            lines.push('## Checklist');
+            lines.push('');
+            for (const item of status.required) {
+                const done = status.completed.includes(item);
+                const emoji = done ? '✅' : '⬜';
+                const namespace = `research:${task_id}:${item}`;
+                lines.push(`${emoji} **${item}** - \`${namespace}\``);
+            }
+            if (status.missing.length > 0) {
+                lines.push('');
+                lines.push('## How to Complete');
+                lines.push('');
+                lines.push('Use `memory_set` to document each missing item:');
+                lines.push('');
+                lines.push('```');
+                lines.push('memory_set:');
+                lines.push(`  key: "<finding_name>"`);
+                lines.push(`  value: "<your findings>"`);
+                lines.push(`  namespace: "research:${task_id}:${status.missing[0]}"`);
+                lines.push('```');
+            }
+        }
+        // Show existing research
+        const research = db.getTaskResearch(task_id);
+        const categories = Object.keys(research);
+        if (categories.length > 0) {
+            lines.push('');
+            lines.push('## Documented Research');
+            for (const category of categories) {
+                lines.push('');
+                lines.push(`### ${category}`);
+                for (const entry of research[category]) {
+                    const valueStr = typeof entry.value === 'string'
+                        ? entry.value.slice(0, 100)
+                        : JSON.stringify(entry.value).slice(0, 100);
+                    lines.push(`- **${entry.key}**: ${valueStr}${valueStr.length >= 100 ? '...' : ''}`);
+                }
+            }
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+    // research_query
+    server.tool('research_query', 'Search past research findings across all tasks. Useful for finding relevant context from previous work.', {
+        query: z.string().describe('Search term to find in research findings'),
+        limit: z.number().optional().default(10).describe('Maximum results to return'),
+    }, async ({ query, limit }) => {
+        const db = getDatabase();
+        const results = db.searchResearch(query, limit);
+        if (results.length === 0) {
+            return {
+                content: [{ type: 'text', text: `No research findings match "${query}".` }],
+            };
+        }
+        const lines = [
+            `# Research Results for "${query}"`,
+            '',
+            `Found ${results.length} result(s):`,
+            '',
+        ];
+        for (const entry of results) {
+            // Parse namespace to get task ID and category
+            const parts = entry.namespace.split(':');
+            const taskId = parts[1] || 'unknown';
+            const category = parts[2] || 'unknown';
+            const valueStr = typeof entry.value === 'string'
+                ? entry.value.slice(0, 150)
+                : JSON.stringify(entry.value).slice(0, 150);
+            lines.push(`### ${entry.key}`);
+            lines.push(`- **Task**: \`${taskId.slice(0, 8)}...\``);
+            lines.push(`- **Category**: ${category}`);
+            lines.push(`- **Value**: ${valueStr}${valueStr.length >= 150 ? '...' : ''}`);
+            lines.push('');
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+    // research_checklist
+    server.tool('research_checklist', 'Get the research checklist for a specific complexity level. Shows what needs to be documented before implementation.', {
+        complexity: z
+            .enum(['trivial', 'simple', 'moderate', 'complex'])
+            .optional()
+            .describe('Complexity level. If omitted, shows all levels.'),
+    }, async ({ complexity }) => {
+        const lines = ['# Research Checklists', ''];
+        const levels = complexity
+            ? [complexity]
+            : [TaskComplexity.TRIVIAL, TaskComplexity.SIMPLE, TaskComplexity.MODERATE, TaskComplexity.COMPLEX];
+        for (const level of levels) {
+            const requirements = RESEARCH_REQUIREMENTS[level];
+            lines.push(`## ${level.charAt(0).toUpperCase() + level.slice(1)}`);
+            lines.push('');
+            if (requirements.length === 0) {
+                lines.push('_No research required - can proceed directly to implementation._');
+            }
+            else {
+                for (const req of requirements) {
+                    const descriptions = {
+                        context: 'Understand the current state, existing patterns, and project context',
+                        files: 'Identify all files that will be affected by this change',
+                        requirements: 'Document specs, acceptance criteria, and edge cases',
+                        design: 'Make architecture decisions and document component structure',
+                    };
+                    lines.push(`- **${req}**: ${descriptions[req] || req}`);
+                }
+            }
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push('');
+        lines.push('Use `memory_set` with namespace `research:<task_id>:<category>` to document each item.');
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+}
+//# sourceMappingURL=research.js.map

package/dist/tools/research.js.map

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

package/dist/tools/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmUzD"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsazD"}

package/dist/tools/task.js

@@ -3,11 +3,13 @@
  */
 import { z } from 'zod';
 import { getDatabase } from '../database.js';
-import { TaskStatus } from '../models.js';
+import { TaskStatus, RESEARCH_REQUIREMENTS } from '../models.js';
 import { getCurrentAgentId } from './agent.js';
+import { syncToActiveContext } from '../utils/contextSync.js';
+import { generateTaskDocumentation } from '../utils/autoDocumentation.js';
 export function registerTaskTools(server) {
     // task_create
-    server.tool('task_create', 'Create a new task in the task queue.', {
+    server.tool('task_create', 'Create a new task in the task queue. Complexity is auto-detected from title/description but can be overridden.', {
         title: z.string().describe('Short title for the task'),
         description: z.string().optional().default('').describe('Detailed description'),
         priority: z
@@ -15,38 +17,54 @@ export function registerTaskTools(server) {
             .optional()
             .default('normal')
             .describe('Priority level'),
+        complexity: z
+            .enum(['trivial', 'simple', 'moderate', 'complex'])
+            .optional()
+            .describe('Task complexity (auto-detected if not provided). Determines research requirements.'),
         assigned_to: z.string().optional().describe('Agent ID to assign to'),
         dependencies: z
             .array(z.string())
             .optional()
             .default([])
             .describe('List of task IDs that must complete first'),
-    }, async ({ title, description, priority, assigned_to, dependencies }) => {
+    }, async ({ title, description, priority, complexity, assigned_to, dependencies }) => {
         const agentId = getCurrentAgentId();
         const task = getDatabase().createTask({
             title,
             description,
             priority: priority,
+            complexity: complexity,
             createdBy: agentId,
             assignedTo: assigned_to ?? null,
             dependencies,
         });
+        // Keep activeContext.md up-to-date (if enabled)
+        syncToActiveContext();
+        const requirements = RESEARCH_REQUIREMENTS[task.complexity];
+        const researchInfo = requirements.length > 0
+            ? `\n\n**Research required** (${task.complexity}): ${requirements.join(', ')}\nUse \`research_status ${task.id}\` to see checklist.`
+            : '\n\n_No research required (trivial task)._';
         return {
             content: [
                 {
                     type: 'text',
-                    text: `Task created: '${task.title}' (\`${task.id}\`)`,
+                    text: `Task created: '${task.title}' (\`${task.id}\`)\n**Complexity**: ${task.complexity}${researchInfo}`,
                 },
             ],
         };
     });
     // task_claim
-    server.tool('task_claim', 'Claim a task to work on it. Sets status to in_progress.', {
+    server.tool('task_claim', 'Claim a task to work on it. Sets status to in_progress. Requires research to be complete for non-trivial tasks.', {
         task_id: z
             .string()
             .optional()
             .describe('Task ID to claim. If omitted, claims the next available task.'),
-    }, async ({ task_id }) => {
+        skip_research: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Force claim without research (not recommended). Use only for urgent fixes.'),
+    }, async ({ task_id, skip_research }) => {
         const agentId = getCurrentAgentId();
         if (!agentId) {
             return {
@@ -77,17 +95,61 @@ export function registerTaskTools(server) {
                 content: [{ type: 'text', text: `Cannot claim: dependencies not met.` }],
             };
         }
+        // Check research gate (unless skipped or trivial)
+        const requirements = RESEARCH_REQUIREMENTS[task.complexity];
+        if (!skip_research && requirements.length > 0 && !task.researchReady) {
+            const status = db.getResearchStatus(task.id);
+            const lines = [
+                '❌ **Cannot claim: Research not complete**',
+                '',
+                `**Task**: ${task.title}`,
+                `**Complexity**: ${task.complexity}`,
+                '',
+                '## Required Research',
+            ];
+            for (const req of requirements) {
+                const done = status.completed.includes(req);
+                lines.push(`${done ? '✅' : '⬜'} ${req}`);
+            }
+            if (status.missing.length > 0) {
+                lines.push('');
+                lines.push('## How to Complete');
+                lines.push('');
+                lines.push('1. Document each missing item with `memory_set`:');
+                lines.push('```');
+                lines.push(`memory_set key="<finding>" value="<details>" namespace="research:${task.id}:${status.missing[0]}"`);
+                lines.push('```');
+                lines.push('');
+                lines.push('2. Mark research complete:');
+                lines.push('```');
+                lines.push(`research_ready task_id="${task.id}"`);
+                lines.push('```');
+                lines.push('');
+                lines.push('3. Then claim the task again.');
+                lines.push('');
+                lines.push('_Use `skip_research: true` to bypass (not recommended)._');
+            }
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
         // Claim it
         const updated = db.updateTask(task.id, {
             status: TaskStatus.IN_PROGRESS,
             assignedTo: agentId,
         });
         if (updated) {
+            generateTaskDocumentation(db, updated.id);
+            // Keep activeContext.md up-to-date (if enabled)
+            syncToActiveContext();
+            const skippedWarning = skip_research && requirements.length > 0 && !task.researchReady
+                ? '\n\n⚠️ _Research was skipped. Consider documenting findings as you work._'
+                : '';
             return {
                 content: [
                     {
                         type: 'text',
-                        text: `Claimed task: '${updated.title}' (\`${updated.id}\`)`,
+                        text: `Claimed task: '${updated.title}' (\`${updated.id}\`)${skippedWarning}`,
                     },
                 ],
             };
@@ -120,6 +182,8 @@ export function registerTaskTools(server) {
             metadata,
         });
         if (updated) {
+            // Keep activeContext.md up-to-date (if enabled)
+            syncToActiveContext();
             const statusInfo = status ? ` → ${status}` : '';
             const progressInfo = progress !== undefined ? ` (${progress}%)` : '';
             return {
@@ -152,6 +216,8 @@ export function registerTaskTools(server) {
             output,
         });
         if (updated) {
+            // Keep activeContext.md up-to-date (if enabled)
+            syncToActiveContext();
             return {
                 content: [
                     {
@@ -199,8 +265,9 @@ export function registerTaskTools(server) {
                 failed: '❌',
                 cancelled: '🚫',
             }[task.status];
-            lines.push(`${emoji} **${task.title}** (\`${task.id.slice(0, 8)}...\`)`);
-            lines.push(`   Status: ${task.status} | Assigned: ${task.assignedTo || 'none'}`);
+            const researchIcon = task.researchReady ? '📚' : (RESEARCH_REQUIREMENTS[task.complexity].length > 0 ? '🔬' : '');
+            lines.push(`${emoji} **${task.title}** (\`${task.id.slice(0, 8)}...\`) ${researchIcon}`);
+            lines.push(`   Status: ${task.status} | Complexity: ${task.complexity} | Research: ${task.researchReady ? 'ready' : 'pending'}`);
         }
         return {
             content: [{ type: 'text', text: lines.join('\n') }],
@@ -247,6 +314,17 @@ export function registerTaskTools(server) {
                     content: [{ type: 'text', text: 'No - already completed.' }],
                 };
             }
+            const requirements = RESEARCH_REQUIREMENTS[task.complexity];
+            if (requirements.length > 0 && !task.researchReady) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Yes - task is assigned to you, but research is not complete. Use research_status task_id="${task.id}" then research_ready, then task_claim.`,
+                        },
+                    ],
+                };
+            }
             return {
                 content: [{ type: 'text', text: 'Yes - task is ready for you. Use task_claim to start.' }],
             };
@@ -254,6 +332,17 @@ export function registerTaskTools(server) {
         else {
             const available = db.getNextAvailableTask(agentId);
             if (available) {
+                const requirements = RESEARCH_REQUIREMENTS[available.complexity];
+                if (requirements.length > 0 && !available.researchReady) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Yes - '${available.title}' is available, but research is required before you can claim it. Use research_status task_id="${available.id}" then research_ready, then task_claim.`,
+                            },
+                        ],
+                    };
+                }
                 return {
                     content: [{ type: 'text', text: `Yes - '${available.title}' is available.` }],
                 };

package/dist/tools/task.js.map

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

package/dist/tools/utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../src/tools/utility.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2L5D"}
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../src/tools/utility.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmQ5D"}

package/dist/tools/utility.js

@@ -3,7 +3,7 @@
  */
 import { z } from 'zod';
 import { getDatabase } from '../database.js';
-import { AgentRole, AgentStatus, TaskStatus } from '../models.js';
+import { AgentRole, AgentStatus, TaskStatus, RESEARCH_REQUIREMENTS } from '../models.js';
 import { setCurrentAgent, } from './agent.js';
 import { syncToActiveContext } from '../utils/contextSync.js';
 export function registerUtilityTools(server) {
@@ -94,7 +94,7 @@ export function registerUtilityTools(server) {
         };
     });
     // claim_todo
-    server.tool('claim_todo', 'FOR SUB-AGENTS: Register yourself AND claim a specific task in one call. Use this when you were spawned to work on a specific todo. This creates the task if it doesn\'t exist, then claims it for you.', {
+    server.tool('claim_todo', 'FOR SUB-AGENTS: Register yourself AND claim a specific task in one call. Use this when you were spawned to work on a specific todo. This creates the task if it doesn\'t exist. Shows research checklist based on complexity.', {
         title: z.string().describe('The title of the todo/task you were spawned to work on'),
         description: z.string().optional().default('').describe('Additional details about the task'),
         priority: z
@@ -102,7 +102,11 @@ export function registerUtilityTools(server) {
             .optional()
             .default('normal')
             .describe('Priority level'),
-    }, async ({ title, description, priority }) => {
+        complexity: z
+            .enum(['trivial', 'simple', 'moderate', 'complex'])
+            .optional()
+            .describe('Task complexity (auto-detected if not provided). Determines research requirements.'),
+    }, async ({ title, description, priority, complexity }) => {
         const db = getDatabase();
         // Generate agent name
         const agentName = `sub-${Date.now()}`;
@@ -111,49 +115,114 @@ export function registerUtilityTools(server) {
             name: agentName,
             role: AgentRole.SUB,
             capabilities: ['code'],
-            status: AgentStatus.BUSY, // Already working
+            status: AgentStatus.ACTIVE, // Active, not busy yet (need to do research first)
         });
         setCurrentAgent(agent.id, agent.name);
         // Check if a task with this title already exists and is pending
         const allTasks = db.listTasks();
         let task = allTasks.find((t) => t.title.toLowerCase().trim() === title.toLowerCase().trim() &&
             ['pending', 'assigned'].includes(t.status));
+        let isNewTask = false;
         if (task) {
-            // Claim the existing task
+            // Assign the existing task to this agent (but don't start yet if research needed)
             task = db.updateTask(task.id, {
                 assignedTo: agent.id,
-                status: TaskStatus.IN_PROGRESS,
+                status: TaskStatus.ASSIGNED,
             });
         }
         else {
-            // Create a new task and claim it
+            // Create a new task (assigned, not in_progress)
+            isNewTask = true;
             task = db.createTask({
                 title,
                 description,
                 priority: priority,
-                status: TaskStatus.IN_PROGRESS,
+                complexity: complexity,
+                status: TaskStatus.ASSIGNED,
                 assignedTo: agent.id,
                 createdBy: agent.id,
-                startedAt: new Date(),
             });
         }
         // Sync context
         syncToActiveContext();
+        // Get research requirements
+        const requirements = RESEARCH_REQUIREMENTS[task.complexity];
+        const researchStatus = db.getResearchStatus(task.id);
         const lines = [
             '# Task Claimed',
             '',
             `**You are**: ${agent.name} (\`${agent.id}\`)`,
             `**Working on**: ${task.title}`,
             `**Task ID**: \`${task.id}\``,
+            `**Complexity**: ${task.complexity}`,
             '',
-            '---',
-            '',
-            'Now you can start working. Remember to:',
-            '1. `lock_acquire` on any files you edit',
-            '2. `task_update` to report progress',
-            '3. `task_complete` when done',
-            '4. `agent_unregister` when finished',
         ];
+        // Show research checklist based on complexity
+        if (requirements.length === 0) {
+            // Trivial task - no research needed
+            lines.push('## ✅ No Research Required');
+            lines.push('');
+            lines.push('This is a trivial task. You can start working immediately.');
+            lines.push('');
+            lines.push('**Next steps:**');
+            lines.push('1. `task_claim` to start working');
+            lines.push('2. `lock_acquire` on any files you edit');
+            lines.push('3. Implement the solution');
+            lines.push('4. `task_complete` when done');
+            lines.push('5. `agent_unregister` when finished');
+        }
+        else if (researchStatus.isReady) {
+            // Research already done
+            lines.push('## ✅ Research Complete');
+            lines.push('');
+            lines.push('Research has already been documented. You can start working.');
+            lines.push('');
+            lines.push('**Next steps:**');
+            lines.push('1. `task_claim` to start working');
+            lines.push('2. `lock_acquire` on any files you edit');
+            lines.push('3. Implement the solution');
+            lines.push('4. `task_complete` when done');
+        }
+        else {
+            // Research needed
+            lines.push('## 🔬 Research Required');
+            lines.push('');
+            lines.push('Before implementing, document your research:');
+            lines.push('');
+            const descriptions = {
+                context: 'Understand the current state, existing patterns, and project context',
+                files: 'Identify all files that will be affected by this change',
+                requirements: 'Document specs, acceptance criteria, and edge cases',
+                design: 'Make architecture decisions and document component structure',
+            };
+            for (const req of requirements) {
+                const done = researchStatus.completed.includes(req);
+                const emoji = done ? '✅' : '⬜';
+                lines.push(`${emoji} **${req}**: ${descriptions[req] || req}`);
+            }
+            lines.push('');
+            lines.push('### How to Document Research');
+            lines.push('');
+            lines.push('Use `memory_set` for each item:');
+            lines.push('```');
+            lines.push('memory_set:');
+            lines.push('  key: "<finding_name>"');
+            lines.push('  value: "<your findings>"');
+            lines.push(`  namespace: "research:${task.id}:<category>"`);
+            lines.push('```');
+            lines.push('');
+            lines.push('### When Done');
+            lines.push('');
+            lines.push('1. Mark research complete:');
+            lines.push('```');
+            lines.push(`research_ready task_id="${task.id}"`);
+            lines.push('```');
+            lines.push('');
+            lines.push('2. Then claim to start implementation:');
+            lines.push('```');
+            lines.push(`task_claim task_id="${task.id}"`);
+            lines.push('```');
+        }
         return {
             content: [{ type: 'text', text: lines.join('\n') }],
         };