@sudosandwich/limps 0.2.0

package/dist/tools/claim-task.js

@@ -0,0 +1,288 @@
+import { z } from 'zod';
+import { readCoordination, writeCoordination, } from '../coordination.js';
+import { extractPlanId, parseTasksFromDocument, findTaskById } from '../task-parser.js';
+/**
+ * Input schema for claim_task tool.
+ */
+export const ClaimTaskInputSchema = z.object({
+    taskId: z.string(),
+    agentId: z.string(),
+    persona: z.enum(['coder', 'reviewer', 'pm', 'customer']).optional(),
+});
+/**
+ * Extract files from task metadata.
+ * For now, returns empty array. In future, this could query the database
+ * to get files associated with the task from planning documents.
+ *
+ * @param _taskId - Task identifier
+ * @param _context - Tool context
+ * @returns Array of file paths
+ */
+async function extractTaskFiles(_taskId, _context) {
+    // TODO: Extract files from task metadata in database
+    // For now, return empty array - files will be determined by task implementation
+    return [];
+}
+/**
+ * Parse task ID to extract plan ID and feature number.
+ * Format: "<planId>#<featureNumber>"
+ */
+function parseTaskId(taskId) {
+    const match = taskId.match(/^(.+)#(\d+)$/);
+    if (!match) {
+        return null;
+    }
+    return {
+        planId: match[1],
+        featureNumber: parseInt(match[2], 10),
+    };
+}
+/**
+ * Try to auto-create a task entry from the plan document.
+ * Returns the task state if found in the plan, null otherwise.
+ *
+ * @param taskId - Task identifier
+ * @param context - Tool context
+ * @returns Task state or null if not found
+ */
+async function tryAutoCreateTaskFromPlan(taskId, context) {
+    const parsed = parseTaskId(taskId);
+    if (!parsed) {
+        return null;
+    }
+    const { planId } = parsed;
+    const { plansPath } = context.config;
+    // Query database for plan documents matching this plan ID
+    const plans = context.db
+        .prepare(`
+    SELECT path, content
+    FROM documents
+    WHERE path LIKE ?
+    AND path LIKE '%/plan.md'
+  `)
+        .all(`${plansPath}%${planId}%`);
+    if (plans.length === 0) {
+        return null;
+    }
+    // Find the plan document and parse tasks
+    for (const plan of plans) {
+        const extractedPlanId = extractPlanId(plan.path);
+        if (!extractedPlanId || !extractedPlanId.includes(planId)) {
+            continue;
+        }
+        const tasks = parseTasksFromDocument(plan.path, plan.content, extractedPlanId);
+        const task = findTaskById(tasks, taskId);
+        if (task) {
+            // Create TaskState from parsed task
+            return {
+                status: task.status,
+                claimedBy: undefined,
+                dependencies: task.dependencies,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Check if any files are already locked by other agents.
+ *
+ * @param files - Files to check
+ * @param coordination - Coordination state
+ * @param agentId - Current agent ID
+ * @returns Error message if conflict found, null otherwise
+ */
+function checkFileLockConflicts(files, coordination, agentId) {
+    for (const file of files) {
+        const lockedBy = coordination.fileLocks[file];
+        if (lockedBy && lockedBy !== agentId) {
+            return `File ${file} is already locked by agent ${lockedBy}`;
+        }
+    }
+    return null;
+}
+/**
+ * Handle claim_task tool request.
+ * Marks a task as in-progress by a specific agent with file locks.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export async function handleClaimTask(input, context) {
+    const { taskId, agentId, persona } = input;
+    const coordinationPath = context.config.coordinationPath;
+    // Retry loop for optimistic concurrency
+    const maxRetries = 5;
+    let retries = 0;
+    while (retries < maxRetries) {
+        try {
+            // Read current coordination state
+            const coordination = await readCoordination(coordinationPath);
+            const expectedVersion = coordination.version;
+            // Check if task exists, auto-create if found in plan but not in coordination
+            let task = coordination.tasks[taskId];
+            if (!task) {
+                // Try to auto-create from plan document
+                const autoCreatedTask = await tryAutoCreateTaskFromPlan(taskId, context);
+                if (!autoCreatedTask) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Task ${taskId} not found in coordination state or plan documents`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Add the auto-created task to coordination state
+                coordination.tasks[taskId] = autoCreatedTask;
+                task = autoCreatedTask;
+            }
+            // Check if task is already claimed by a different agent
+            if (task.status === 'WIP' && task.claimedBy && task.claimedBy !== agentId) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Task ${taskId} is already claimed by agent ${task.claimedBy}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // If already claimed by same agent, just update heartbeat
+            if (task.status === 'WIP' && task.claimedBy === agentId) {
+                const agent = coordination.agents[agentId];
+                if (agent) {
+                    // Update heartbeat
+                    const updatedCoordination = {
+                        ...coordination,
+                        version: coordination.version + 1,
+                        agents: {
+                            ...coordination.agents,
+                            [agentId]: {
+                                ...agent,
+                                heartbeat: new Date().toISOString(),
+                            },
+                        },
+                    };
+                    await writeCoordination(coordinationPath, updatedCoordination, expectedVersion);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Heartbeat updated for task ${taskId}`,
+                            },
+                        ],
+                    };
+                }
+            }
+            // Check if task status allows claiming (must be 'GAP')
+            if (task.status !== 'GAP') {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Task ${taskId} cannot be claimed. Current status: ${task.status}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Extract files for this task
+            const files = await extractTaskFiles(taskId, context);
+            // Check for file lock conflicts
+            const conflict = checkFileLockConflicts(files, coordination, agentId);
+            if (conflict) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: conflict,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Create file locks
+            const fileLocks = { ...coordination.fileLocks };
+            for (const file of files) {
+                fileLocks[file] = agentId;
+            }
+            // Update coordination state
+            const updatedCoordination = {
+                ...coordination,
+                version: coordination.version + 1,
+                tasks: {
+                    ...coordination.tasks,
+                    [taskId]: {
+                        ...task,
+                        status: 'WIP',
+                        claimedBy: agentId,
+                    },
+                },
+                agents: {
+                    ...coordination.agents,
+                    [agentId]: {
+                        status: 'WIP',
+                        persona: persona || 'coder',
+                        taskId,
+                        filesLocked: files,
+                        heartbeat: new Date().toISOString(),
+                    },
+                },
+                fileLocks,
+            };
+            // Write with optimistic concurrency control
+            await writeCoordination(coordinationPath, updatedCoordination, expectedVersion);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Task ${taskId} claimed successfully by agent ${agentId}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // Handle version mismatch (optimistic concurrency conflict)
+            if (error instanceof Error && error.message.includes('Version mismatch')) {
+                retries++;
+                if (retries >= maxRetries) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Failed to claim task after ${maxRetries} retries due to concurrent modifications`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Retry with fresh state
+                continue;
+            }
+            // Other errors
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error claiming task: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Failed to claim task after ${maxRetries} retries`,
+            },
+        ],
+        isError: true,
+    };
+}
+//# sourceMappingURL=claim-task.js.map

package/dist/tools/claim-task.js.map

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

package/dist/tools/create-doc.d.ts

@@ -0,0 +1,47 @@
+/**
+ * create_doc tool: Create new documents with optional template frontmatter.
+ */
+import { z } from 'zod';
+import { type DocType } from '../utils/paths.js';
+import type { ToolContext, ToolResult } from '../types.js';
+/**
+ * Input schema for create_doc tool.
+ */
+export declare const CreateDocInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+    template: z.ZodDefault<z.ZodEnum<["addendum", "research", "example", "none"]>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    content: string;
+    template: "none" | "research" | "addendum" | "example";
+}, {
+    path: string;
+    content: string;
+    template?: "none" | "research" | "addendum" | "example" | undefined;
+}>;
+export type CreateDocInput = z.infer<typeof CreateDocInputSchema>;
+/**
+ * Output interface for create_doc tool.
+ */
+export interface CreateDocOutput {
+    path: string;
+    created: true;
+    size: number;
+    type: DocType;
+}
+/**
+ * Template definitions with frontmatter.
+ * {{DATE}} placeholder is replaced with current date in YYYY-MM-DD format.
+ */
+export declare const TEMPLATES: Record<string, string>;
+/**
+ * Handle create_doc tool request.
+ * Creates a new file with optional template frontmatter.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export declare function handleCreateDoc(input: CreateDocInput, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=create-doc.d.ts.map

package/dist/tools/create-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-doc.d.ts","sourceRoot":"","sources":["../../src/tools/create-doc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG/E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAO/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqB5C,CAAC;AAmBF;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAgFrB"}

package/dist/tools/create-doc.js

@@ -0,0 +1,137 @@
+/**
+ * create_doc tool: Create new documents with optional template frontmatter.
+ */
+import { z } from 'zod';
+import { existsSync, writeFileSync, mkdirSync, statSync } from 'fs';
+import { dirname } from 'path';
+import { validatePath, isWritablePath } from '../utils/paths.js';
+import { alreadyExists, restrictedPath } from '../utils/errors.js';
+import { indexDocument } from '../indexer.js';
+/**
+ * Input schema for create_doc tool.
+ */
+export const CreateDocInputSchema = z.object({
+    path: z.string().min(1).describe('Path for new file relative to repo root'),
+    content: z.string().describe('File content'),
+    template: z
+        .enum(['addendum', 'research', 'example', 'none'])
+        .default('none')
+        .describe('Template to apply (adds frontmatter)'),
+});
+/**
+ * Template definitions with frontmatter.
+ * {{DATE}} placeholder is replaced with current date in YYYY-MM-DD format.
+ */
+export const TEMPLATES = {
+    addendum: `---
+version: "1.0"
+date: "{{DATE}}"
+status: "Draft"
+type: "addendum"
+extends: ""
+author: ""
+---
+
+`,
+    research: `---
+version: "1.0"
+date: "{{DATE}}"
+status: "Draft"
+type: "research"
+---
+
+`,
+    example: '',
+    none: '',
+};
+/**
+ * Get repository root from config.
+ * Assumes plansPath is ../plans relative to .mcp, so dirname gives repo root.
+ */
+function getRepoRoot(config) {
+    return dirname(config.plansPath);
+}
+/**
+ * Apply template to content, replacing {{DATE}} with current date.
+ */
+function applyTemplate(template, content) {
+    const date = new Date().toISOString().split('T')[0];
+    const templateContent = template.replace(/\{\{DATE\}\}/g, date);
+    return templateContent + content;
+}
+/**
+ * Handle create_doc tool request.
+ * Creates a new file with optional template frontmatter.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export async function handleCreateDoc(input, context) {
+    const { path, content, template } = input;
+    const repoRoot = getRepoRoot(context.config);
+    try {
+        // Validate path (must not exist, must be writable)
+        const validated = validatePath(path, repoRoot, {
+            requireWritable: true,
+        });
+        // Check if file already exists
+        if (existsSync(validated.absolute)) {
+            throw alreadyExists(path);
+        }
+        // Check if path is writable (additional check beyond requireWritable)
+        if (!isWritablePath(validated.relative)) {
+            throw restrictedPath(path);
+        }
+        // Apply template if specified
+        let finalContent = content;
+        if (template !== 'none' && TEMPLATES[template]) {
+            finalContent = applyTemplate(TEMPLATES[template], content);
+        }
+        // Create parent directories if needed
+        const parentDir = dirname(validated.absolute);
+        if (!existsSync(parentDir)) {
+            mkdirSync(parentDir, { recursive: true });
+        }
+        // Write file
+        writeFileSync(validated.absolute, finalContent, 'utf-8');
+        // Get file size
+        const stats = statSync(validated.absolute);
+        const size = stats.size;
+        // Index the new file
+        await indexDocument(context.db, validated.absolute);
+        const output = {
+            path: validated.relative,
+            created: true,
+            size,
+            type: validated.type,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        // Re-throw DocumentError as-is
+        if (error instanceof Error && 'code' in error) {
+            throw error;
+        }
+        // Wrap other errors
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : String(error),
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=create-doc.js.map

package/dist/tools/create-doc.js.map

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

package/dist/tools/create-plan.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import type { ToolContext, ToolResult } from '../types.js';
+/**
+ * Input schema for create_plan tool.
+ */
+export declare const CreatePlanInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description?: string | undefined;
+}, {
+    name: string;
+    description?: string | undefined;
+}>;
+/**
+ * Handle create_plan tool request.
+ * Creates a new planning document from template with zero-padded ordering.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export declare function handleCreatePlan(input: z.infer<typeof CreatePlanInputSchema>, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=create-plan.d.ts.map

package/dist/tools/create-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-plan.d.ts","sourceRoot":"","sources":["../../src/tools/create-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM3D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAiHH;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,EAC5C,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAgErB"}