@sudosandwich/limps 2.0.0 → 2.2.0

package/dist/tools/update-doc.js

@@ -5,8 +5,9 @@ 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 { notFound, permissionDenied, noSpaceError } from '../utils/errors.js';
 import { createBackup } from '../utils/backup.js';
+import { FrontmatterHandler } from '../utils/frontmatter.js';
 import { indexDocument } from '../indexer.js';
 /**
  * Patch operation schema.
@@ -21,15 +22,35 @@ export const PatchSchema = z.object({
  */
 export const UpdateDocInputBaseSchema = z.object({
     path: z.string().min(1).describe('Path to existing file'),
-    content: z.string().optional().describe('Full replacement content'),
+    content: z
+        .string()
+        .optional()
+        .describe('Content to write (required for overwrite/append/prepend modes)'),
     patch: PatchSchema.optional().describe('Search/replace patch'),
+    mode: z
+        .enum(['overwrite', 'append', 'prepend'])
+        .default('overwrite')
+        .describe('Write mode: overwrite (default), append, or prepend'),
     createBackup: z.boolean().default(true).describe('Create backup before update'),
     force: z.boolean().default(false).describe('Skip validation warnings'),
+    prettyPrint: z
+        .boolean()
+        .default(false)
+        .describe('Format JSON response with indentation (default: false)'),
 });
 /**
  * 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' });
+export const UpdateDocInputSchema = UpdateDocInputBaseSchema.refine((data) => {
+    // For append/prepend modes, content is required
+    if ((data.mode === 'append' || data.mode === 'prepend') && data.content === undefined) {
+        return false;
+    }
+    // For overwrite mode or patch, either content or patch must be provided
+    return data.content !== undefined || data.patch !== undefined;
+}, {
+    message: 'Content is required for append/prepend modes. For overwrite mode, either content or patch must be provided.',
+});
 /**
  * Get repository root from config.
  */
@@ -70,17 +91,22 @@ function applyPatch(content, patch) {
  * @returns Tool result
  */
 export async function handleUpdateDoc(input, context) {
-    const { path, content, patch, createBackup: shouldBackup, force } = input;
+    const { path, content, patch, mode = 'overwrite', createBackup: shouldBackup, force, prettyPrint, } = input;
     const repoRoot = getRepoRoot(context.config);
+    const frontmatterHandler = new FrontmatterHandler();
     try {
         // Validate path
         const validated = validatePath(path, repoRoot);
-        // Check if file exists
-        if (!existsSync(validated.absolute)) {
+        // Check if file exists (required for append/prepend modes)
+        const fileExists = existsSync(validated.absolute);
+        if (!fileExists && (mode === 'append' || mode === 'prepend')) {
+            throw notFound(path);
+        }
+        if (!fileExists && mode === 'overwrite' && patch === undefined) {
             throw notFound(path);
         }
         // Check if this is a protected plan file
-        if (isProtectedPlanFile(validated.relative) && !force) {
+        if (fileExists && isProtectedPlanFile(validated.relative) && !force) {
             return {
                 content: [
                     {
@@ -88,38 +114,102 @@ export async function handleUpdateDoc(input, context) {
                         text: JSON.stringify({
                             warning: 'Protected plan file - confirm with force: true',
                             path: validated.relative,
-                        }, null, 2),
+                        }, null, prettyPrint ? 2 : undefined),
                     },
                 ],
                 isError: true,
             };
         }
-        // Read existing content
-        const oldContent = readFileSync(validated.absolute, 'utf-8');
+        // Read existing content if file exists
+        const oldContent = fileExists ? 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) {
+            if (mode === 'overwrite') {
+                // 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, prettyPrint ? 2 : undefined),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+            else if (mode === 'append' || mode === 'prepend') {
+                // Append or prepend mode - merge frontmatter and content
+                if (!fileExists) {
+                    // File doesn't exist, treat as overwrite
+                    newContent = content;
+                }
+                else {
+                    // Parse existing note
+                    const existingNote = frontmatterHandler.parse(oldContent);
+                    const newNote = frontmatterHandler.parse(content);
+                    // Merge frontmatter
+                    const mergedFrontmatter = {
+                        ...existingNote.frontmatter,
+                        ...newNote.frontmatter,
+                    };
+                    // Combine content based on mode
+                    let combinedContent;
+                    if (mode === 'append') {
+                        combinedContent = existingNote.content + newNote.content;
+                    }
+                    else {
+                        // prepend
+                        combinedContent = newNote.content + existingNote.content;
+                    }
+                    // Validate merged frontmatter
+                    const validation = frontmatterHandler.validate(mergedFrontmatter);
+                    if (!validation.isValid) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({
+                                        error: `Invalid frontmatter after merge: ${validation.errors.join(', ')}`,
+                                        path: validated.relative,
+                                    }, null, prettyPrint ? 2 : undefined),
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    // Stringify with merged frontmatter and combined content
+                    newContent = frontmatterHandler.stringify(mergedFrontmatter, combinedContent);
+                }
+            }
+            else {
+                // This should never happen due to schema validation
+                throw new Error(`Invalid mode: ${mode}`);
+            }
+        }
+        else if (patch !== undefined) {
+            // Patch operation (only works with overwrite mode)
+            if (mode !== 'overwrite') {
                 return {
                     content: [
                         {
                             type: 'text',
                             text: JSON.stringify({
-                                warning: 'Frontmatter removed - confirm with force: true',
+                                error: 'Patch operations only work with overwrite mode',
                                 path: validated.relative,
-                            }, null, 2),
+                            }, null, prettyPrint ? 2 : undefined),
                         },
                     ],
                     isError: true,
                 };
             }
-        }
-        else if (patch !== undefined) {
-            // Patch operation
             newContent = applyPatch(oldContent, patch);
             // Warn if patch had no matches
             if (newContent === oldContent) {
@@ -131,7 +221,7 @@ export async function handleUpdateDoc(input, context) {
                                 warning: 'Patch had no matches - file unchanged',
                                 path: validated.relative,
                                 search: patch.search,
-                            }, null, 2),
+                            }, null, prettyPrint ? 2 : undefined),
                         },
                     ],
                     isError: true,
@@ -148,8 +238,21 @@ export async function handleUpdateDoc(input, context) {
             const backupResult = await createBackup(validated.absolute, repoRoot);
             backupPath = backupResult.backupPath;
         }
-        // Write new content
-        writeFileSync(validated.absolute, newContent, 'utf-8');
+        // Write new content with error handling
+        try {
+            writeFileSync(validated.absolute, newContent, 'utf-8');
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error) {
+                if (error.code === 'EACCES' || error.code === 'EPERM') {
+                    throw permissionDenied(validated.relative, undefined, 'write');
+                }
+                if (error.code === 'ENOSPC') {
+                    throw noSpaceError(validated.relative);
+                }
+            }
+            throw error;
+        }
         // Get file size
         const stats = statSync(validated.absolute);
         const size = stats.size;
@@ -168,7 +271,7 @@ export async function handleUpdateDoc(input, context) {
             content: [
                 {
                     type: 'text',
-                    text: JSON.stringify(output, null, 2),
+                    text: JSON.stringify(output, null, prettyPrint ? 2 : undefined),
                 },
             ],
         };
@@ -185,7 +288,7 @@ export async function handleUpdateDoc(input, context) {
                     type: 'text',
                     text: JSON.stringify({
                         error: error instanceof Error ? error.message : String(error),
-                    }, null, 2),
+                    }, null, prettyPrint ? 2 : undefined),
                 },
             ],
             isError: true,

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

@@ -1 +1 @@
-{"version":3,"file":"update-doc.js","sourceRoot":"","sources":["../../src/tools/update-doc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-doc.js","sourceRoot":"","sources":["../../src/tools/update-doc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;IAClD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAChD,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACpE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACzD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC9D,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;SACxC,OAAO,CAAC,WAAW,CAAC;SACpB,QAAQ,CAAC,qDAAqD,CAAC;IAClE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC/E,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACtE,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,wDAAwD,CAAC;CACtE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,MAAM,CACjE,CAAC,IAAI,EAAE,EAAE;IACP,gDAAgD;IAChD,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACtF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,wEAAwE;IACxE,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;AAChE,CAAC,EACD;IACE,OAAO,EACL,6GAA6G;CAChH,CACF,CAAC;AAkBF;;GAEG;AACH,SAAS,WAAW,CAAC,MAA6B;IAChD,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,UAAkB,EAClB,UAAkB;IAKlB,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACnD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CACjB,OAAe,EACf,KAAwD;IAExD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAqB,EACrB,OAAoB;IAEpB,MAAM,EACJ,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,GAAG,WAAW,EAClB,YAAY,EAAE,YAAY,EAC1B,KAAK,EACL,WAAW,GACZ,GAAG,KAAK,CAAC;IACV,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAEpD,IAAI,CAAC;QACH,gBAAgB;QAChB,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAE/C,2DAA2D;QAC3D,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;YAC7D,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,UAAU,IAAI,IAAI,KAAK,WAAW,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/D,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,yCAAyC;QACzC,IAAI,UAAU,IAAI,mBAAmB,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,OAAO,EAAE,gDAAgD;4BACzD,IAAI,EAAE,SAAS,CAAC,QAAQ;yBACzB,EACD,IAAI,EACJ,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAC5B;qBACF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,uCAAuC;QACvC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,cAAc,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAElD,wBAAwB;QACxB,IAAI,UAAkB,CAAC;QACvB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBACzB,mBAAmB;gBACnB,UAAU,GAAG,OAAO,CAAC;gBAErB,yDAAyD;gBACzD,IAAI,cAAc,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC5D,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oCACE,OAAO,EAAE,gDAAgD;oCACzD,IAAI,EAAE,SAAS,CAAC,QAAQ;iCACzB,EACD,IAAI,EACJ,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAC5B;6BACF;yBACF;wBACD,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACnD,yDAAyD;gBACzD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,yCAAyC;oBACzC,UAAU,GAAG,OAAO,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,sBAAsB;oBACtB,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC1D,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAElD,oBAAoB;oBACpB,MAAM,iBAAiB,GAAG;wBACxB,GAAG,YAAY,CAAC,WAAW;wBAC3B,GAAG,OAAO,CAAC,WAAW;qBACvB,CAAC;oBAEF,gCAAgC;oBAChC,IAAI,eAAuB,CAAC;oBAC5B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACtB,eAAe,GAAG,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;oBAC3D,CAAC;yBAAM,CAAC;wBACN,UAAU;wBACV,eAAe,GAAG,OAAO,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;oBAC3D,CAAC;oBAED,8BAA8B;oBAC9B,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;oBAClE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;wBACxB,OAAO;4BACL,OAAO,EAAE;gCACP;oCACE,IAAI,EAAE,MAAM;oCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wCACE,KAAK,EAAE,oCAAoC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wCACzE,IAAI,EAAE,SAAS,CAAC,QAAQ;qCACzB,EACD,IAAI,EACJ,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAC5B;iCACF;6BACF;4BACD,OAAO,EAAE,IAAI;yBACd,CAAC;oBACJ,CAAC;oBAED,yDAAyD;oBACzD,UAAU,GAAG,kBAAkB,CAAC,SAAS,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,oDAAoD;gBACpD,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,mDAAmD;YACnD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,KAAK,EAAE,gDAAgD;gCACvD,IAAI,EAAE,SAAS,CAAC,QAAQ;6BACzB,EACD,IAAI,EACJ,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAC5B;yBACF;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,UAAU,GAAG,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAE3C,+BAA+B;YAC/B,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;gCACE,OAAO,EAAE,uCAAuC;gCAChD,IAAI,EAAE,SAAS,CAAC,QAAQ;gCACxB,MAAM,EAAE,KAAK,CAAC,MAAM;6BACrB,EACD,IAAI,EACJ,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAC5B;yBACF;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oDAAoD;YACpD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,6BAA6B;QAC7B,IAAI,UAA8B,CAAC;QACnC,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACtE,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC;QACvC,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC;YACH,aAAa,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;gBAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACtD,MAAM,gBAAgB,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;gBACjE,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC5B,MAAM,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,gBAAgB;QAChB,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAExB,oBAAoB;QACpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAEzD,oBAAoB;QACpB,MAAM,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAoB;YAC9B,IAAI,EAAE,SAAS,CAAC,QAAQ;YACxB,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,MAAM,EAAE,UAAU;YAClB,OAAO;SACR,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;iBAChE;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+BAA+B;QAC/B,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YAC9C,MAAM,KAAK,CAAC;QACd,CAAC;QAED,oBAAoB;QACpB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,EACD,IAAI,EACJ,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAC5B;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -101,7 +101,7 @@ function findPlanDocument(db, plansPath, planId) {
     SELECT path
     FROM documents
     WHERE path LIKE ?
-    AND path LIKE '%/plan.md'
+    AND (path LIKE '%-plan.md' OR path LIKE '%/plan.md')
   `)
         .all(`${plansPath}%${planId}%`);
     if (plans.length === 0) {

package/dist/utils/errors.d.ts

@@ -5,8 +5,9 @@
 import type { JsonError } from '../cli/json-output.js';
 /**
  * Error codes for document operations.
+ * Includes filesystem error codes (ENOENT, EACCES, etc.) for better error handling.
  */
-export type ErrorCode = 'NOT_FOUND' | 'ALREADY_EXISTS' | 'PERMISSION_DENIED' | 'VALIDATION_ERROR' | 'RESTRICTED_PATH' | 'INTERNAL_ERROR';
+export type ErrorCode = 'NOT_FOUND' | 'ENOENT' | 'ALREADY_EXISTS' | 'EEXIST' | 'PERMISSION_DENIED' | 'EACCES' | 'VALIDATION_ERROR' | 'RESTRICTED_PATH' | 'INTERNAL_ERROR' | 'EISDIR' | 'ENOTDIR' | 'ENOSPC';
 /**
  * MCP-compatible error shape for JSON responses.
  */
@@ -34,12 +35,34 @@ export declare class DocumentError extends Error {
  * Factory: File not found error.
  *
  * @param path - Path to the file that was not found
+ * @param suggestion - Optional custom suggestion
  * @returns DocumentError with NOT_FOUND code
  * @example
  * throw notFound('research/missing.md');
  * // DocumentError: File not found: research/missing.md
  */
-export declare function notFound(path: string): DocumentError;
+export declare function notFound(path: string, suggestion?: string): DocumentError;
+/**
+ * Factory: Directory not found error.
+ *
+ * @param path - Path to the directory that was not found
+ * @returns DocumentError with ENOENT code
+ */
+export declare function directoryNotFound(path: string): DocumentError;
+/**
+ * Factory: Cannot read directory as file error.
+ *
+ * @param path - Path that is a directory, not a file
+ * @returns DocumentError with EISDIR code
+ */
+export declare function isDirectoryError(path: string): DocumentError;
+/**
+ * Factory: Not a directory error.
+ *
+ * @param path - Path that points to a file, not a directory
+ * @returns DocumentError with ENOTDIR code
+ */
+export declare function notDirectoryError(path: string): DocumentError;
 /**
  * Factory: File already exists error.
  *
@@ -55,12 +78,13 @@ export declare function alreadyExists(path: string): DocumentError;
  *
  * @param path - Path to the file
  * @param reason - Reason for the permission denial
- * @returns DocumentError with PERMISSION_DENIED code
+ * @param operation - Operation that was denied (read, write, delete, etc.)
+ * @returns DocumentError with EACCES code
  * @example
- * throw permissionDenied('config.json', 'File is read-only');
- * // DocumentError: Permission denied for config.json: File is read-only
+ * throw permissionDenied('config.json', 'File is read-only', 'write');
+ * // DocumentError: Permission denied: config.json. The file exists but cannot be written due to filesystem permissions.
  */
-export declare function permissionDenied(path: string, reason: string): DocumentError;
+export declare function permissionDenied(path: string, reason?: string, operation?: string): DocumentError;
 /**
  * Factory: Restricted path error.
  *
@@ -82,6 +106,13 @@ export declare function restrictedPath(path: string): DocumentError;
  * // DocumentError: Validation failed for 'path': must be relative to repo root
  */
 export declare function validationError(field: string, message: string): DocumentError;
+/**
+ * Factory: No space left on device error.
+ *
+ * @param path - Path where write failed
+ * @returns DocumentError with ENOSPC code
+ */
+export declare function noSpaceError(path: string): DocumentError;
 /**
  * Error thrown when recursion depth limit is exceeded.
  * Used by RLM sub-call processing.

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAgBhF;;OAEG;IACH,MAAM,IAAI,QAAQ;CAgBnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAOpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAOzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAO5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAO1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAE7E;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAcnD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAexD;;OAEG;IACH,MAAM,IAAI,SAAS;CAgBpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,UAAU,CAoBvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,UAAU,CAoBtF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}

package/dist/utils/errors.js

@@ -45,13 +45,41 @@ export class DocumentError extends Error {
  * Factory: File not found error.
  *
  * @param path - Path to the file that was not found
+ * @param suggestion - Optional custom suggestion
  * @returns DocumentError with NOT_FOUND code
  * @example
  * throw notFound('research/missing.md');
  * // DocumentError: File not found: research/missing.md
  */
-export function notFound(path) {
-    return new DocumentError('NOT_FOUND', `File not found: ${path}`, path, 'Use create_doc to create a new file, or check that the path is correct.');
+export function notFound(path, suggestion) {
+    return new DocumentError('NOT_FOUND', `File not found: ${path}. Use list_directory to see available files, or check the path spelling.`, path, suggestion || 'Use create_doc to create a new file, or check that the path is correct.');
+}
+/**
+ * Factory: Directory not found error.
+ *
+ * @param path - Path to the directory that was not found
+ * @returns DocumentError with ENOENT code
+ */
+export function directoryNotFound(path) {
+    return new DocumentError('ENOENT', `Directory not found: ${path}. Use list_directory with no path or '/' to see root folders.`, path, 'Check that the directory path is correct and exists.');
+}
+/**
+ * Factory: Cannot read directory as file error.
+ *
+ * @param path - Path that is a directory, not a file
+ * @returns DocumentError with EISDIR code
+ */
+export function isDirectoryError(path) {
+    return new DocumentError('EISDIR', `Cannot read directory as file: ${path}. Use list_directory tool instead.`, path, 'Use list_directory to list files in a directory, or read_note to read a file.');
+}
+/**
+ * Factory: Not a directory error.
+ *
+ * @param path - Path that points to a file, not a directory
+ * @returns DocumentError with ENOTDIR code
+ */
+export function notDirectoryError(path) {
+    return new DocumentError('ENOTDIR', `Not a directory: ${path}. This path points to a file, not a folder. Use read_note to read files.`, path, 'Use read_note to read files, or list_directory to list directory contents.');
 }
 /**
  * Factory: File already exists error.
@@ -70,13 +98,17 @@ export function alreadyExists(path) {
  *
  * @param path - Path to the file
  * @param reason - Reason for the permission denial
- * @returns DocumentError with PERMISSION_DENIED code
+ * @param operation - Operation that was denied (read, write, delete, etc.)
+ * @returns DocumentError with EACCES code
  * @example
- * throw permissionDenied('config.json', 'File is read-only');
- * // DocumentError: Permission denied for config.json: File is read-only
+ * throw permissionDenied('config.json', 'File is read-only', 'write');
+ * // DocumentError: Permission denied: config.json. The file exists but cannot be written due to filesystem permissions.
  */
-export function permissionDenied(path, reason) {
-    return new DocumentError('PERMISSION_DENIED', `Permission denied for ${path}: ${reason}`, path, 'Check file permissions or ensure the file is not locked.');
+export function permissionDenied(path, reason, operation) {
+    const operationText = operation ? ` (${operation})` : '';
+    const reasonText = reason ? `: ${reason}` : '';
+    const message = `Permission denied${operationText}: ${path}${reasonText}. The file exists but cannot be ${operation || 'accessed'} due to filesystem permissions.`;
+    return new DocumentError('EACCES', message, path, 'Check file permissions or ensure the file is not locked.');
 }
 /**
  * Factory: Restricted path error.
@@ -101,7 +133,16 @@ export function restrictedPath(path) {
  * // DocumentError: Validation failed for 'path': must be relative to repo root
  */
 export function validationError(field, message) {
-    return new DocumentError('VALIDATION_ERROR', `Validation failed for '${field}': ${message}`);
+    return new DocumentError('VALIDATION_ERROR', `Validation failed for '${field}': ${message}`, undefined, 'Check the input format and try again.');
+}
+/**
+ * Factory: No space left on device error.
+ *
+ * @param path - Path where write failed
+ * @returns DocumentError with ENOSPC code
+ */
+export function noSpaceError(path) {
+    return new DocumentError('ENOSPC', `No space left on device: ${path}`, path, 'Free up disk space and try again.');
 }
 /**
  * Error thrown when recursion depth limit is exceeded.

package/dist/utils/errors.js.map

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

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Frontmatter handling utilities with validation.
+ * Based on patterns from mcp-obsidian for safe YAML frontmatter parsing.
+ */
+/**
+ * Parsed note with frontmatter and content separated.
+ */
+export interface ParsedNote {
+    frontmatter: Record<string, unknown>;
+    content: string;
+    originalContent: string;
+}
+/**
+ * Result of frontmatter validation.
+ */
+export interface FrontmatterValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Frontmatter handler with validation and safe parsing.
+ * Prevents functions, symbols, and other dangerous objects in frontmatter.
+ */
+export declare class FrontmatterHandler {
+    /**
+     * Parse frontmatter from content.
+     * Returns parsed frontmatter and content separated.
+     *
+     * @param content - Content with optional YAML frontmatter
+     * @returns Parsed note with frontmatter and content
+     */
+    parse(content: string): ParsedNote;
+    /**
+     * Stringify frontmatter and content back to markdown.
+     *
+     * @param frontmatterData - Frontmatter object
+     * @param content - Content body
+     * @returns Complete markdown with frontmatter
+     */
+    stringify(frontmatterData: Record<string, unknown>, content: string): string;
+    /**
+     * Validate frontmatter for security and correctness.
+     * Prevents functions, symbols, and other dangerous objects.
+     *
+     * @param frontmatterData - Frontmatter object to validate
+     * @returns Validation result with errors and warnings
+     */
+    validate(frontmatterData: Record<string, unknown>): FrontmatterValidationResult;
+    /**
+     * Recursively check for problematic values in frontmatter.
+     *
+     * @param obj - Object to check
+     * @param result - Validation result to update
+     * @param path - Current path in the object (for error messages)
+     */
+    private checkForProblematicValues;
+    /**
+     * Extract only frontmatter from content without parsing body.
+     *
+     * @param content - Content with optional YAML frontmatter
+     * @returns Frontmatter object
+     */
+    extractFrontmatter(content: string): Record<string, unknown>;
+    /**
+     * Update frontmatter in content, preserving body.
+     *
+     * @param content - Original content
+     * @param updates - Frontmatter updates to merge
+     * @returns Updated content with new frontmatter
+     */
+    updateFrontmatter(content: string, updates: Record<string, unknown>): string;
+}
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAkBlC;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAe5E;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,2BAA2B;IAuB/E;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IAmDjC;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK5D;;;;;;OAMG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAW7E"}