@sudosandwich/limps 0.2.0

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

@@ -0,0 +1,149 @@
+/**
+ * update_doc tool: Update existing documents with full replacement or patch operations.
+ */
+import { z } from 'zod';
+import type { ToolContext, ToolResult } from '../types.js';
+/**
+ * Patch operation schema.
+ */
+export declare const PatchSchema: z.ZodObject<{
+    search: z.ZodString;
+    replace: z.ZodString;
+    all: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    replace: string;
+    search: string;
+    all: boolean;
+}, {
+    replace: string;
+    search: string;
+    all?: boolean | undefined;
+}>;
+/**
+ * Base input schema for update_doc tool (for registration).
+ */
+export declare const UpdateDocInputBaseSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    patch: z.ZodOptional<z.ZodObject<{
+        search: z.ZodString;
+        replace: z.ZodString;
+        all: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        replace: string;
+        search: string;
+        all: boolean;
+    }, {
+        replace: string;
+        search: string;
+        all?: boolean | undefined;
+    }>>;
+    createBackup: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    force: boolean;
+    createBackup: boolean;
+    content?: string | undefined;
+    patch?: {
+        replace: string;
+        search: string;
+        all: boolean;
+    } | undefined;
+}, {
+    path: string;
+    content?: string | undefined;
+    force?: boolean | undefined;
+    patch?: {
+        replace: string;
+        search: string;
+        all?: boolean | undefined;
+    } | undefined;
+    createBackup?: boolean | undefined;
+}>;
+/**
+ * Input schema for update_doc tool (with validation).
+ */
+export declare const UpdateDocInputSchema: z.ZodEffects<z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    patch: z.ZodOptional<z.ZodObject<{
+        search: z.ZodString;
+        replace: z.ZodString;
+        all: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        replace: string;
+        search: string;
+        all: boolean;
+    }, {
+        replace: string;
+        search: string;
+        all?: boolean | undefined;
+    }>>;
+    createBackup: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    force: boolean;
+    createBackup: boolean;
+    content?: string | undefined;
+    patch?: {
+        replace: string;
+        search: string;
+        all: boolean;
+    } | undefined;
+}, {
+    path: string;
+    content?: string | undefined;
+    force?: boolean | undefined;
+    patch?: {
+        replace: string;
+        search: string;
+        all?: boolean | undefined;
+    } | undefined;
+    createBackup?: boolean | undefined;
+}>, {
+    path: string;
+    force: boolean;
+    createBackup: boolean;
+    content?: string | undefined;
+    patch?: {
+        replace: string;
+        search: string;
+        all: boolean;
+    } | undefined;
+}, {
+    path: string;
+    content?: string | undefined;
+    force?: boolean | undefined;
+    patch?: {
+        replace: string;
+        search: string;
+        all?: boolean | undefined;
+    } | undefined;
+    createBackup?: boolean | undefined;
+}>;
+export type UpdateDocInput = z.infer<typeof UpdateDocInputSchema>;
+/**
+ * Output interface for update_doc tool.
+ */
+export interface UpdateDocOutput {
+    path: string;
+    updated: true;
+    size: number;
+    backup?: string;
+    changes?: {
+        additions: number;
+        deletions: number;
+    };
+}
+/**
+ * Handle update_doc tool request.
+ * Updates an existing file with full replacement or patch operation.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export declare function handleUpdateDoc(input: UpdateDocInput, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=update-doc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-doc.d.ts","sourceRoot":"","sources":["../../src/tools/update-doc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;EAItB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGhC,CAAC;AAEF,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,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AA8CD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsJrB"}

package/dist/tools/update-doc.js

@@ -0,0 +1,195 @@
+/**
+ * update_doc tool: Update existing documents with full replacement or patch operations.
+ */
+import { z } from 'zod';
+import { existsSync, readFileSync, writeFileSync, statSync } from 'fs';
+import { dirname } from 'path';
+import { validatePath, isProtectedPlanFile } from '../utils/paths.js';
+import { notFound } from '../utils/errors.js';
+import { createBackup } from '../utils/backup.js';
+import { indexDocument } from '../indexer.js';
+/**
+ * Patch operation schema.
+ */
+export const PatchSchema = z.object({
+    search: z.string().min(1).describe('Text to find'),
+    replace: z.string().describe('Replacement text'),
+    all: z.boolean().default(false).describe('Replace all occurrences'),
+});
+/**
+ * Base input schema for update_doc tool (for registration).
+ */
+export const UpdateDocInputBaseSchema = z.object({
+    path: z.string().min(1).describe('Path to existing file'),
+    content: z.string().optional().describe('Full replacement content'),
+    patch: PatchSchema.optional().describe('Search/replace patch'),
+    createBackup: z.boolean().default(true).describe('Create backup before update'),
+    force: z.boolean().default(false).describe('Skip validation warnings'),
+});
+/**
+ * Input schema for update_doc tool (with validation).
+ */
+export const UpdateDocInputSchema = UpdateDocInputBaseSchema.refine((data) => data.content !== undefined || data.patch !== undefined, { message: 'Either content or patch must be provided' });
+/**
+ * Get repository root from config.
+ */
+function getRepoRoot(config) {
+    return dirname(config.plansPath);
+}
+/**
+ * Check if content has frontmatter (YAML or TOML).
+ */
+function hasFrontmatter(content) {
+    return /^---\s*\n/.test(content) || /^\+\+\+\s*\n/.test(content);
+}
+/**
+ * Calculate line count differences between old and new content.
+ */
+function calculateChanges(oldContent, newContent) {
+    const oldLines = oldContent.split('\n').length;
+    const newLines = newContent.split('\n').length;
+    const additions = Math.max(0, newLines - oldLines);
+    const deletions = Math.max(0, oldLines - newLines);
+    return { additions, deletions };
+}
+/**
+ * Apply patch operation to content.
+ */
+function applyPatch(content, patch) {
+    if (patch.all) {
+        return content.replaceAll(patch.search, patch.replace);
+    }
+    return content.replace(patch.search, patch.replace);
+}
+/**
+ * Handle update_doc tool request.
+ * Updates an existing file with full replacement or patch operation.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export async function handleUpdateDoc(input, context) {
+    const { path, content, patch, createBackup: shouldBackup, force } = input;
+    const repoRoot = getRepoRoot(context.config);
+    try {
+        // Validate path
+        const validated = validatePath(path, repoRoot);
+        // Check if file exists
+        if (!existsSync(validated.absolute)) {
+            throw notFound(path);
+        }
+        // Check if this is a protected plan file
+        if (isProtectedPlanFile(validated.relative) && !force) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            warning: 'Protected plan file - confirm with force: true',
+                            path: validated.relative,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Read existing content
+        const oldContent = readFileSync(validated.absolute, 'utf-8');
+        const hadFrontmatter = hasFrontmatter(oldContent);
+        // Determine new content
+        let newContent;
+        if (content !== undefined) {
+            // Full replacement
+            newContent = content;
+            // Warn if frontmatter was removed (unless force is true)
+            if (hadFrontmatter && !hasFrontmatter(newContent) && !force) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                warning: 'Frontmatter removed - confirm with force: true',
+                                path: validated.relative,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        else if (patch !== undefined) {
+            // Patch operation
+            newContent = applyPatch(oldContent, patch);
+            // Warn if patch had no matches
+            if (newContent === oldContent) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                warning: 'Patch had no matches - file unchanged',
+                                path: validated.relative,
+                                search: patch.search,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        else {
+            // This should never happen due to schema validation
+            throw new Error('Either content or patch must be provided');
+        }
+        // Create backup if requested
+        let backupPath;
+        if (shouldBackup) {
+            const backupResult = await createBackup(validated.absolute, repoRoot);
+            backupPath = backupResult.backupPath;
+        }
+        // Write new content
+        writeFileSync(validated.absolute, newContent, 'utf-8');
+        // Get file size
+        const stats = statSync(validated.absolute);
+        const size = stats.size;
+        // Calculate changes
+        const changes = calculateChanges(oldContent, newContent);
+        // Re-index the file
+        await indexDocument(context.db, validated.absolute);
+        const output = {
+            path: validated.relative,
+            updated: true,
+            size,
+            backup: backupPath,
+            changes,
+        };
+        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=update-doc.js.map

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

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

package/dist/tools/update-task-status.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import type { ToolContext, ToolResult } from '../types.js';
+/**
+ * Input schema for update_task_status tool.
+ */
+export declare const UpdateTaskStatusInputSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    status: z.ZodEnum<["GAP", "WIP", "PASS", "BLOCKED"]>;
+    agentId: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "GAP" | "WIP" | "PASS" | "BLOCKED";
+    taskId: string;
+    agentId?: string | undefined;
+    notes?: string | undefined;
+}, {
+    status: "GAP" | "WIP" | "PASS" | "BLOCKED";
+    taskId: string;
+    agentId?: string | undefined;
+    notes?: string | undefined;
+}>;
+/**
+ * Handle update_task_status tool request.
+ * Updates task status in planning documents (GAP → WIP → PASS/BLOCKED).
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export declare function handleUpdateTaskStatus(input: z.infer<typeof UpdateTaskStatusInputSchema>, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=update-task-status.d.ts.map

package/dist/tools/update-task-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-task-status.d.ts","sourceRoot":"","sources":["../../src/tools/update-task-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAKtC,CAAC;AAyLH;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,EAClD,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA0JrB"}

package/dist/tools/update-task-status.js

@@ -0,0 +1,303 @@
+import { z } from 'zod';
+import { readFileSync, writeFileSync } from 'fs';
+import { readCoordination, writeCoordination, } from '../coordination.js';
+import { indexDocument } from '../indexer.js';
+import { extractPlanId, parseTasksFromDocument, findTaskById } from '../task-parser.js';
+/**
+ * Input schema for update_task_status tool.
+ */
+export const UpdateTaskStatusInputSchema = z.object({
+    taskId: z.string(),
+    status: z.enum(['GAP', 'WIP', 'PASS', 'BLOCKED']),
+    agentId: z.string().optional(),
+    notes: z.string().optional(),
+});
+/**
+ * Valid status transitions.
+ */
+const VALID_TRANSITIONS = {
+    GAP: ['WIP'],
+    WIP: ['PASS', 'BLOCKED'],
+    PASS: [], // Terminal state
+    BLOCKED: ['GAP', 'WIP'], // Can be unblocked
+};
+/**
+ * Check if a status transition is valid.
+ */
+function isValidTransition(from, to) {
+    const allowed = VALID_TRANSITIONS[from] || [];
+    return allowed.includes(to);
+}
+/**
+ * Find task in document by feature number.
+ * Returns the content section for the task.
+ */
+function findTaskSection(content, featureNumber) {
+    const featureRegex = new RegExp(`^###\\s+#${featureNumber}:`, 'm');
+    const match = content.match(featureRegex);
+    if (!match || match.index === undefined) {
+        return null;
+    }
+    const start = match.index;
+    // Find next feature or end of document
+    const nextFeatureMatch = content.indexOf('### #', start + 1);
+    const end = nextFeatureMatch > 0 ? nextFeatureMatch : content.length;
+    const section = content.substring(start, end);
+    return { start, end, section };
+}
+/**
+ * Update status in task section.
+ * Preserves formatting and other content.
+ */
+function updateStatusInSection(section, newStatus) {
+    // Match status line: "Status: `GAP`" or "Status: `WIP`" etc.
+    const statusRegex = /Status:\s*`?(\w+)`?/i;
+    const match = section.match(statusRegex);
+    if (match) {
+        // Replace existing status
+        return section.replace(statusRegex, `Status: \`${newStatus}\``);
+    }
+    else {
+        // Add status line if not found (shouldn't happen, but handle gracefully)
+        // Insert after feature title
+        const titleMatch = section.match(/^###\s+#\d+:\s+(.+)$/m);
+        if (titleMatch) {
+            const titleEnd = section.indexOf('\n', titleMatch.index || 0);
+            return (section.substring(0, titleEnd + 1) +
+                `\nStatus: \`${newStatus}\`\n` +
+                section.substring(titleEnd + 1));
+        }
+        return section;
+    }
+}
+/**
+ * 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),
+    };
+}
+/**
+ * Find document path for a plan.
+ */
+async function findPlanDocument(db, plansPath, planId) {
+    // Query database for plan documents
+    // Match planId in path (could be "0001-plan-name" or just "0001")
+    const plans = db
+        .prepare(`
+    SELECT path
+    FROM documents
+    WHERE path LIKE ?
+    AND path LIKE '%/plan.md'
+  `)
+        .all(`${plansPath}%${planId}%`);
+    if (plans.length === 0) {
+        return null;
+    }
+    // Find exact match (plan directory should contain planId)
+    for (const plan of plans) {
+        if (plan.path.includes(planId)) {
+            return plan.path;
+        }
+    }
+    return plans[0]?.path || null;
+}
+/**
+ * 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;
+}
+/**
+ * Handle update_task_status tool request.
+ * Updates task status in planning documents (GAP → WIP → PASS/BLOCKED).
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export async function handleUpdateTaskStatus(input, context) {
+    const { taskId, status, agentId, notes } = input;
+    const { plansPath, coordinationPath } = context.config;
+    // Parse task ID
+    const parsed = parseTaskId(taskId);
+    if (!parsed) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Invalid task ID format: ${taskId}. Expected format: "<planId>#<featureNumber>"`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const { planId, featureNumber } = parsed;
+    // Find plan document
+    const documentPath = await findPlanDocument(context.db, plansPath, planId);
+    if (!documentPath) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Plan document not found for task ${taskId}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Read current coordination state
+    const coordination = await readCoordination(coordinationPath);
+    let task = coordination.tasks[taskId];
+    // Auto-create task entry if found in plan but not in coordination
+    if (!task) {
+        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;
+    }
+    // Validate status transition
+    if (!isValidTransition(task.status, status)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Invalid status transition from ${task.status} to ${status}. Valid transitions: ${VALID_TRANSITIONS[task.status]?.join(', ') || 'none'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Read document
+    const content = readFileSync(documentPath, 'utf-8');
+    // Find task section
+    const taskSection = findTaskSection(content, featureNumber);
+    if (!taskSection) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Feature #${featureNumber} not found in document`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Update status in section
+    const updatedSection = updateStatusInSection(taskSection.section, status);
+    // Replace section in document
+    const updatedContent = content.substring(0, taskSection.start) + updatedSection + content.substring(taskSection.end);
+    // Write updated document
+    writeFileSync(documentPath, updatedContent, 'utf-8');
+    // Update coordination state if agentId provided
+    if (agentId) {
+        const maxRetries = 5;
+        let retries = 0;
+        while (retries < maxRetries) {
+            try {
+                const currentCoordination = await readCoordination(coordinationPath);
+                const expectedVersion = currentCoordination.version;
+                // Update task status and claim
+                const updatedCoordination = {
+                    ...currentCoordination,
+                    version: currentCoordination.version + 1,
+                    tasks: {
+                        ...currentCoordination.tasks,
+                        [taskId]: {
+                            ...currentCoordination.tasks[taskId],
+                            status: status,
+                            claimedBy: status === 'WIP' ? agentId : undefined,
+                        },
+                    },
+                };
+                await writeCoordination(coordinationPath, updatedCoordination, expectedVersion);
+                break;
+            }
+            catch (error) {
+                retries++;
+                if (retries >= maxRetries) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Failed to update coordination state after ${maxRetries} retries: ${error instanceof Error ? error.message : String(error)}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Wait a bit before retry
+                await new Promise((resolve) => setTimeout(resolve, 10));
+            }
+        }
+    }
+    // Re-index document
+    await indexDocument(context.db, documentPath);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Task ${taskId} status updated to ${status}${agentId ? ` by agent ${agentId}` : ''}${notes ? `. Notes: ${notes}` : ''}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=update-task-status.js.map