@sudosandwich/limps 0.2.0

package/dist/tools/open-document-in-cursor.d.ts

@@ -0,0 +1,62 @@
+/**
+ * open_document_in_cursor tool: Open files in Cursor editor using URI protocol with CLI fallback.
+ */
+import { z } from 'zod';
+import type { ToolContext, ToolResult } from '../types.js';
+/**
+ * Input schema for open_document_in_cursor tool.
+ */
+export declare const OpenDocumentInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    line: z.ZodOptional<z.ZodNumber>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    line?: number | undefined;
+    column?: number | undefined;
+}, {
+    path: string;
+    line?: number | undefined;
+    column?: number | undefined;
+}>;
+export type OpenDocumentInput = z.infer<typeof OpenDocumentInputSchema>;
+/**
+ * Output interface for open_document_in_cursor tool.
+ */
+export interface OpenDocumentOutput {
+    success: boolean;
+    method?: 'uri' | 'cli';
+    message?: string;
+    error?: string;
+}
+/**
+ * Check if cursor CLI is available on the system.
+ *
+ * @returns true if cursor command is available, false otherwise
+ */
+export declare function isCursorCliAvailable(): boolean;
+/**
+ * Open a file in Cursor using URI protocol with CLI fallback.
+ *
+ * @param filePath - Absolute path to the file
+ * @param options - Optional line and column numbers
+ * @returns Result indicating success and method used
+ */
+export declare function openInCursor(filePath: string, options?: {
+    line?: number;
+    column?: number;
+}): Promise<{
+    success: boolean;
+    method: 'uri' | 'cli' | 'failed';
+    error?: string;
+}>;
+/**
+ * Handle open_document_in_cursor tool request.
+ * Opens a file in Cursor editor at an optional line/column position.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export declare function handleOpenDocumentInCursor(input: OpenDocumentInput, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=open-document-in-cursor.d.ts.map

package/dist/tools/open-document-in-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-document-in-cursor.d.ts","sourceRoot":"","sources":["../../src/tools/open-document-in-cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI3D;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuBD;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwDjF;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAuHrB"}

package/dist/tools/open-document-in-cursor.js

@@ -0,0 +1,211 @@
+/**
+ * open_document_in_cursor tool: Open files in Cursor editor using URI protocol with CLI fallback.
+ */
+import { z } from 'zod';
+import { existsSync } from 'fs';
+import { dirname } from 'path';
+import { spawn } from 'child_process';
+import open from 'open';
+import which from 'which';
+import { validatePath } from '../utils/paths.js';
+import { notFound } from '../utils/errors.js';
+/**
+ * Input schema for open_document_in_cursor tool.
+ */
+export const OpenDocumentInputSchema = z.object({
+    path: z.string().min(1).describe('Path relative to repo root'),
+    line: z.number().int().positive().optional().describe('Optional line number to jump to'),
+    column: z.number().int().positive().optional().describe('Optional column number'),
+});
+/**
+ * Get repository root from config.
+ * Uses the first docsPath entry as the repo root, or derives from plansPath.
+ */
+function getRepoRoot(config) {
+    // Prefer docsPaths[0] if it exists (it's the repo root)
+    if (config.docsPaths && config.docsPaths.length > 0) {
+        return config.docsPaths[0];
+    }
+    // Fallback: use plansPath parent directory
+    return dirname(config.plansPath);
+}
+/**
+ * URL encode special characters in path for URI protocol.
+ * Encodes: # → %23, ? → %3F, spaces → %20
+ */
+function encodePathForUri(path) {
+    return path.replace(/#/g, '%23').replace(/\?/g, '%3F').replace(/ /g, '%20');
+}
+/**
+ * Check if cursor CLI is available on the system.
+ *
+ * @returns true if cursor command is available, false otherwise
+ */
+export function isCursorCliAvailable() {
+    try {
+        which.sync('cursor');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Open a file in Cursor using URI protocol with CLI fallback.
+ *
+ * @param filePath - Absolute path to the file
+ * @param options - Optional line and column numbers
+ * @returns Result indicating success and method used
+ */
+export async function openInCursor(filePath, options) {
+    // Try URI protocol first
+    try {
+        // URL encode the path portion only
+        const encodedPath = encodePathForUri(filePath);
+        let uri = `cursor://file${encodedPath}`;
+        if (options?.line !== undefined) {
+            uri += `:${options.line}`;
+            if (options.column !== undefined) {
+                uri += `:${options.column}`;
+            }
+        }
+        await open(uri, { wait: false });
+        return { success: true, method: 'uri' };
+    }
+    catch (uriError) {
+        // URI failed, try CLI fallback
+        if (isCursorCliAvailable()) {
+            try {
+                const args = [];
+                if (options?.line !== undefined) {
+                    const location = `${filePath}:${options.line}${options.column !== undefined ? `:${options.column}` : ''}`;
+                    args.push('-g', location);
+                }
+                else {
+                    args.push(filePath);
+                }
+                const child = spawn('cursor', args, {
+                    detached: true,
+                    stdio: 'ignore',
+                    shell: process.platform === 'win32',
+                });
+                child.unref();
+                return { success: true, method: 'cli' };
+            }
+            catch (cliError) {
+                return {
+                    success: false,
+                    method: 'failed',
+                    error: `CLI fallback failed: ${cliError instanceof Error ? cliError.message : String(cliError)}`,
+                };
+            }
+        }
+        return {
+            success: false,
+            method: 'failed',
+            error: `URI protocol failed and cursor CLI is not available: ${uriError instanceof Error ? uriError.message : String(uriError)}`,
+        };
+    }
+}
+/**
+ * Handle open_document_in_cursor tool request.
+ * Opens a file in Cursor editor at an optional line/column position.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export async function handleOpenDocumentInCursor(input, context) {
+    const { path, line, column } = input;
+    const { config } = context;
+    try {
+        // Get repo root
+        const repoRoot = getRepoRoot(config);
+        // Validate path first
+        const validated = validatePath(path, repoRoot);
+        // Check if file exists
+        if (!existsSync(validated.absolute)) {
+            throw notFound(path);
+        }
+        // Open file in Cursor
+        const result = await openInCursor(validated.absolute, { line, column });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: result.error || 'Failed to open file in Cursor',
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Format success output (result.method is 'uri' | 'cli' at this point since success is true)
+        const output = {
+            success: true,
+            method: result.method,
+            message: `Opened ${validated.relative}${line ? ` at line ${line}` : ''}${column ? `, column ${column}` : ''} using ${result.method} method`,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        // Handle DocumentError
+        if (error instanceof Error && 'code' in error) {
+            const docError = error;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: docError.message,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Handle file system errors
+        if (error instanceof Error) {
+            // Check for ENOENT (file not found)
+            if ('code' in error && error.code === 'ENOENT') {
+                throw notFound(path);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: `Error opening file: ${error.message}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: false,
+                        error: `Unknown error: ${String(error)}`,
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=open-document-in-cursor.js.map

package/dist/tools/open-document-in-cursor.js.map

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

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

@@ -0,0 +1,44 @@
+/**
+ * read_doc tool: Read full content of any document in the repository.
+ */
+import { z } from 'zod';
+import type { ToolContext, ToolResult } from '../types.js';
+/**
+ * Input schema for read_doc tool.
+ */
+export declare const ReadDocInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    lines: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    lines?: [number, number] | undefined;
+}, {
+    path: string;
+    lines?: [number, number] | undefined;
+}>;
+export type ReadDocInput = z.infer<typeof ReadDocInputSchema>;
+/**
+ * Output interface for read_doc tool.
+ */
+export interface ReadDocOutput {
+    path: string;
+    content: string;
+    metadata: {
+        size: number;
+        lines: number;
+        modified: string;
+        type: 'md' | 'jsx' | 'tsx' | 'ts' | 'json' | 'yaml' | 'other';
+        partial?: boolean;
+        range?: [number, number];
+    };
+}
+/**
+ * Handle read_doc tool request.
+ * Reads full file content with optional line range.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export declare function handleReadDoc(input: ReadDocInput, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=read-doc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-doc.d.ts","sourceRoot":"","sources":["../../src/tools/read-doc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI3D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAM7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1B,CAAC;CACH;AAeD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAuJrB"}

package/dist/tools/read-doc.js

@@ -0,0 +1,174 @@
+/**
+ * read_doc tool: Read full content of any document in the repository.
+ */
+import { z } from 'zod';
+import { readFile, stat } from 'fs/promises';
+import { existsSync } from 'fs';
+import { dirname } from 'path';
+import { validatePath } from '../utils/paths.js';
+import { notFound } from '../utils/errors.js';
+/**
+ * Input schema for read_doc tool.
+ */
+export const ReadDocInputSchema = z.object({
+    path: z.string().min(1).describe('Path relative to repo root'),
+    lines: z
+        .tuple([z.number().int().positive(), z.number().int().positive()])
+        .optional()
+        .describe('Optional line range [start, end], 1-indexed'),
+});
+/**
+ * Get repository root from config.
+ * Uses the first docsPath entry as the repo root, or derives from plansPath.
+ */
+function getRepoRoot(config) {
+    // Prefer docsPaths[0] if it exists (it's the repo root)
+    if (config.docsPaths && config.docsPaths.length > 0) {
+        return config.docsPaths[0];
+    }
+    // Fallback: use plansPath parent directory
+    return dirname(config.plansPath);
+}
+/**
+ * Handle read_doc tool request.
+ * Reads full file content with optional line range.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export async function handleReadDoc(input, context) {
+    const { path, lines } = input;
+    const { config } = context;
+    try {
+        // Get repo root
+        const repoRoot = getRepoRoot(config);
+        // Validate path first
+        const validated = validatePath(path, repoRoot);
+        // Check if file exists
+        if (!existsSync(validated.absolute)) {
+            throw notFound(path);
+        }
+        // Read file stats
+        const stats = await stat(validated.absolute);
+        // Read file content
+        const content = await readFile(validated.absolute, 'utf-8');
+        // Count lines (empty file has 0 lines, not 1)
+        const lineCount = content === '' ? 0 : content.split('\n').length;
+        // Handle line range if specified
+        let finalContent = content;
+        let partial = false;
+        let range;
+        if (lines) {
+            const [start, end] = lines;
+            // Validate range
+            if (start > end) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Invalid line range: start (${start}) must be <= end (${end})`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (start < 1 || end < 1) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Invalid line range: line numbers must be >= 1`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Convert 1-indexed to 0-indexed
+            const startIdx = start - 1;
+            const endIdx = end; // end is inclusive, so we use it directly for slice
+            // Split into lines
+            const contentLines = content.split('\n');
+            // Validate range against file
+            if (startIdx > contentLines.length) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Line range [${start}, ${end}] exceeds file length (${lineCount} lines)`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Extract range (endIdx is exclusive in slice, so we add 1)
+            const endSlice = Math.min(endIdx, contentLines.length);
+            const selectedLines = contentLines.slice(startIdx, endSlice);
+            // Rejoin lines
+            finalContent = selectedLines.join('\n');
+            partial = true;
+            range = [start, Math.min(end, lineCount)];
+        }
+        // Format output
+        const output = {
+            path: validated.relative,
+            content: finalContent,
+            metadata: {
+                size: stats.size,
+                lines: lineCount,
+                modified: stats.mtime.toISOString(),
+                type: validated.type,
+                ...(partial && { partial: true, range }),
+            },
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        // Handle DocumentError
+        if (error instanceof Error && 'code' in error) {
+            const docError = error;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${docError.message}${docError.path ? ` (path: ${docError.path})` : ''}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Handle file system errors
+        if (error instanceof Error) {
+            // Check for ENOENT (file not found)
+            if ('code' in error && error.code === 'ENOENT') {
+                throw notFound(path);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error reading file: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Unknown error: ${String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=read-doc.js.map

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

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

package/dist/tools/release-task.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { ToolContext, ToolResult } from '../types.js';
+/**
+ * Input schema for release_task tool.
+ */
+export declare const ReleaseTaskInputSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    agentId: z.ZodString;
+    finalStatus: z.ZodOptional<z.ZodEnum<["PASS", "BLOCKED"]>>;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    agentId: string;
+    finalStatus?: "PASS" | "BLOCKED" | undefined;
+}, {
+    taskId: string;
+    agentId: string;
+    finalStatus?: "PASS" | "BLOCKED" | undefined;
+}>;
+/**
+ * Handle release_task tool request.
+ * Frees a task and associated file locks when agent completes or abandons work.
+ *
+ * @param input - Tool input
+ * @param context - Tool context
+ * @returns Tool result
+ */
+export declare function handleReleaseTask(input: z.infer<typeof ReleaseTaskInputSchema>, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=release-task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"release-task.d.ts","sourceRoot":"","sources":["../../src/tools/release-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAC7C,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAqJrB"}