@sudosandwich/limps 0.2.0

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

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

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+import type { Database as DatabaseType } from 'better-sqlite3';
+import type { CoordinationState } from './coordination.js';
+import type { ServerConfig } from './config.js';
+/**
+ * Context passed to tool handlers.
+ */
+export interface ToolContext {
+    db: DatabaseType;
+    coordination: CoordinationState;
+    config: ServerConfig;
+}
+/**
+ * Context passed to resource handlers.
+ */
+export interface ResourceContext {
+    db: DatabaseType;
+    coordination: CoordinationState;
+    config: ServerConfig;
+}
+/**
+ * Result returned by tool handlers.
+ * Matches MCP SDK tool result format.
+ * Index signature required for MCP SDK compatibility.
+ */
+export interface ToolResult {
+    [key: string]: unknown;
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+}
+/**
+ * Result returned by resource handlers.
+ * Matches MCP SDK resource result format.
+ */
+export interface ResourceResult {
+    contents: ({
+        uri: string;
+        mimeType?: string;
+        text: string;
+        blob?: never;
+    } | {
+        uri: string;
+        mimeType?: string;
+        blob: string;
+        text?: never;
+    })[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,YAAY,CAAC;IACjB,YAAY,EAAE,iBAAiB,CAAC;IAChC,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,YAAY,CAAC;IACjB,YAAY,EAAE,iBAAiB,CAAC;IAChC,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,CACN;QACE,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,KAAK,CAAC;KACd,GACD;QACE,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,KAAK,CAAC;KACd,CACJ,EAAE,CAAC;CACL"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/backup.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Backup utilities for MCP document CRUD operations.
+ * Creates timestamped backups before destructive operations and handles pruning.
+ */
+/**
+ * Backup directory name (relative to repo root).
+ */
+export declare const BACKUP_DIR = ".backups";
+/**
+ * Result of a backup operation.
+ */
+export interface BackupResult {
+    /** Original file path */
+    path: string;
+    /** Path to the backup file */
+    backupPath: string;
+    /** ISO timestamp of the backup */
+    timestamp: string;
+}
+/**
+ * Options for backup operations.
+ */
+export interface BackupOptions {
+    /** Number of days to retain backups (default: 7) */
+    retentionDays?: number;
+    /** Minimum backups to keep regardless of age (default: 3) */
+    minBackups?: number;
+}
+/**
+ * Format a date for use in backup/trash filenames.
+ * Uses ISO format with colons replaced by dashes for Windows compatibility.
+ *
+ * @param date - Date to format
+ * @returns Formatted timestamp string (e.g., "2026-01-20T12-30-45")
+ * @example
+ * formatTimestamp(new Date('2026-01-20T12:30:45Z'));
+ * // Returns: "2026-01-20T12-30-45"
+ */
+export declare function formatTimestamp(date: Date): string;
+/**
+ * Get the backup path for a file.
+ *
+ * @param filePath - Absolute path to the original file
+ * @param repoRoot - Absolute path to repository root
+ * @param timestamp - Optional timestamp (defaults to now)
+ * @returns Absolute path for the backup file
+ */
+export declare function getBackupPath(filePath: string, repoRoot: string, timestamp?: Date): string;
+/**
+ * Create a backup of a file.
+ *
+ * @param filePath - Absolute path to the file to backup
+ * @param repoRoot - Absolute path to repository root
+ * @returns Backup result with paths and timestamp
+ * @throws DocumentError if file doesn't exist
+ */
+export declare function createBackup(filePath: string, repoRoot: string): Promise<BackupResult>;
+/**
+ * List all backups for a file, sorted by timestamp (newest first).
+ *
+ * @param filePath - Absolute path to the original file
+ * @param repoRoot - Absolute path to repository root
+ * @returns Array of backup results
+ */
+export declare function listBackups(filePath: string, repoRoot: string): Promise<BackupResult[]>;
+/**
+ * Prune old backups for a file.
+ * Keeps backups newer than retention period OR minimum count, whichever keeps more.
+ *
+ * @param filePath - Absolute path to the original file
+ * @param repoRoot - Absolute path to repository root
+ * @param options - Pruning options
+ * @returns Number of backups pruned
+ */
+export declare function pruneBackups(filePath: string, repoRoot: string, options?: BackupOptions): Promise<number>;
+//# sourceMappingURL=backup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/utils/backup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,eAAO,MAAM,UAAU,aAAa,CAAC;AAYrC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMlD;AAoBD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,IAAiB,GAC3B,MAAM,CASR;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqB5F;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAkC7F;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsCjB"}

package/dist/utils/backup.js

@@ -0,0 +1,172 @@
+/**
+ * Backup utilities for MCP document CRUD operations.
+ * Creates timestamped backups before destructive operations and handles pruning.
+ */
+import { copyFile, mkdir, readdir, unlink } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join, dirname, basename, relative } from 'path';
+import { notFound } from './errors.js';
+/**
+ * Backup directory name (relative to repo root).
+ */
+export const BACKUP_DIR = '.backups';
+/**
+ * Default backup retention: 7 days.
+ */
+const DEFAULT_RETENTION_DAYS = 7;
+/**
+ * Minimum backups to keep regardless of age.
+ */
+const DEFAULT_MIN_BACKUPS = 3;
+/**
+ * Format a date for use in backup/trash filenames.
+ * Uses ISO format with colons replaced by dashes for Windows compatibility.
+ *
+ * @param date - Date to format
+ * @returns Formatted timestamp string (e.g., "2026-01-20T12-30-45")
+ * @example
+ * formatTimestamp(new Date('2026-01-20T12:30:45Z'));
+ * // Returns: "2026-01-20T12-30-45"
+ */
+export function formatTimestamp(date) {
+    // Format: 2026-01-20T12-30-45
+    return date
+        .toISOString()
+        .replace(/:/g, '-')
+        .replace(/\.\d{3}Z$/, '');
+}
+/**
+ * Parse a timestamp from a backup filename.
+ */
+function parseTimestamp(filename) {
+    // Match: filename.YYYY-MM-DDTHH-MM-SS.bak
+    const match = filename.match(/\.(\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2})\.bak$/);
+    if (!match)
+        return null;
+    // Convert back to ISO format
+    const isoString = match[1].replace(/-/g, (char, index) => {
+        // Keep dashes for date part (indices 4, 7), replace with colons for time (indices 13, 16)
+        return index > 9 ? ':' : char;
+    }) + 'Z';
+    return new Date(isoString);
+}
+/**
+ * Get the backup path for a file.
+ *
+ * @param filePath - Absolute path to the original file
+ * @param repoRoot - Absolute path to repository root
+ * @param timestamp - Optional timestamp (defaults to now)
+ * @returns Absolute path for the backup file
+ */
+export function getBackupPath(filePath, repoRoot, timestamp = new Date()) {
+    // Get relative path from repo root
+    const relativePath = relative(repoRoot, filePath);
+    // Build backup path: .backups/{relative-path}.{timestamp}.bak
+    const backupFilename = `${basename(relativePath)}.${formatTimestamp(timestamp)}.bak`;
+    const backupDir = join(repoRoot, BACKUP_DIR, dirname(relativePath));
+    return join(backupDir, backupFilename);
+}
+/**
+ * Create a backup of a file.
+ *
+ * @param filePath - Absolute path to the file to backup
+ * @param repoRoot - Absolute path to repository root
+ * @returns Backup result with paths and timestamp
+ * @throws DocumentError if file doesn't exist
+ */
+export async function createBackup(filePath, repoRoot) {
+    // Verify file exists
+    if (!existsSync(filePath)) {
+        throw notFound(relative(repoRoot, filePath));
+    }
+    const timestamp = new Date();
+    const backupPath = getBackupPath(filePath, repoRoot, timestamp);
+    // Ensure backup directory exists
+    const backupDir = dirname(backupPath);
+    await mkdir(backupDir, { recursive: true });
+    // Copy file to backup location
+    await copyFile(filePath, backupPath);
+    return {
+        path: filePath,
+        backupPath,
+        timestamp: formatTimestamp(timestamp),
+    };
+}
+/**
+ * List all backups for a file, sorted by timestamp (newest first).
+ *
+ * @param filePath - Absolute path to the original file
+ * @param repoRoot - Absolute path to repository root
+ * @returns Array of backup results
+ */
+export async function listBackups(filePath, repoRoot) {
+    const relativePath = relative(repoRoot, filePath);
+    const backupDir = join(repoRoot, BACKUP_DIR, dirname(relativePath));
+    // If backup directory doesn't exist, no backups
+    if (!existsSync(backupDir)) {
+        return [];
+    }
+    const filename = basename(relativePath);
+    const backupPrefix = `${filename}.`;
+    const backupSuffix = '.bak';
+    // Find all backups for this file
+    const entries = await readdir(backupDir);
+    const backups = [];
+    for (const entry of entries) {
+        if (entry.startsWith(backupPrefix) && entry.endsWith(backupSuffix)) {
+            const timestamp = parseTimestamp(entry);
+            if (timestamp) {
+                backups.push({
+                    path: filePath,
+                    backupPath: join(backupDir, entry),
+                    timestamp: formatTimestamp(timestamp),
+                });
+            }
+        }
+    }
+    // Sort by timestamp, newest first
+    backups.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    return backups;
+}
+/**
+ * Prune old backups for a file.
+ * Keeps backups newer than retention period OR minimum count, whichever keeps more.
+ *
+ * @param filePath - Absolute path to the original file
+ * @param repoRoot - Absolute path to repository root
+ * @param options - Pruning options
+ * @returns Number of backups pruned
+ */
+export async function pruneBackups(filePath, repoRoot, options = {}) {
+    const retentionDays = options.retentionDays ?? DEFAULT_RETENTION_DAYS;
+    const minBackups = options.minBackups ?? DEFAULT_MIN_BACKUPS;
+    const backups = await listBackups(filePath, repoRoot);
+    if (backups.length <= minBackups) {
+        return 0;
+    }
+    const cutoffDate = new Date();
+    cutoffDate.setDate(cutoffDate.getDate() - retentionDays);
+    const cutoffTimestamp = formatTimestamp(cutoffDate);
+    let prunedCount = 0;
+    // Process backups from oldest to newest (reverse of the sorted list)
+    // But keep at least minBackups
+    for (let i = backups.length - 1; i >= 0; i--) {
+        // Always keep minimum backups
+        if (backups.length - prunedCount <= minBackups) {
+            break;
+        }
+        const backup = backups[i];
+        // Only prune if older than retention period
+        if (backup.timestamp < cutoffTimestamp) {
+            try {
+                await unlink(backup.backupPath);
+                prunedCount++;
+            }
+            catch {
+                // Ignore errors (file may already be deleted)
+            }
+        }
+    }
+    return prunedCount;
+}
+//# sourceMappingURL=backup.js.map

package/dist/utils/backup.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Error handling utilities for MCP document CRUD operations.
+ * Provides consistent error types with codes, suggestions, and JSON serialization.
+ */
+/**
+ * Error codes for document operations.
+ */
+export type ErrorCode = 'NOT_FOUND' | 'ALREADY_EXISTS' | 'PERMISSION_DENIED' | 'VALIDATION_ERROR' | 'RESTRICTED_PATH' | 'INTERNAL_ERROR';
+/**
+ * MCP-compatible error shape for JSON responses.
+ */
+export interface MCPError {
+    code: ErrorCode;
+    message: string;
+    path?: string;
+    suggestion?: string;
+}
+/**
+ * Custom error class for document operations.
+ * Extends Error with code, path, suggestion, and JSON serialization.
+ */
+export declare class DocumentError extends Error {
+    readonly code: ErrorCode;
+    readonly path?: string;
+    readonly suggestion?: string;
+    constructor(code: ErrorCode, message: string, path?: string, suggestion?: string);
+    /**
+     * Convert to MCP-compatible JSON shape.
+     */
+    toJSON(): MCPError;
+}
+/**
+ * Factory: File not found error.
+ *
+ * @param path - Path to the file that was not found
+ * @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;
+/**
+ * Factory: File already exists error.
+ *
+ * @param path - Path to the file that already exists
+ * @returns DocumentError with ALREADY_EXISTS code
+ * @example
+ * throw alreadyExists('addendums/001-existing.md');
+ * // DocumentError: File already exists: addendums/001-existing.md
+ */
+export declare function alreadyExists(path: string): DocumentError;
+/**
+ * Factory: Permission denied error.
+ *
+ * @param path - Path to the file
+ * @param reason - Reason for the permission denial
+ * @returns DocumentError with PERMISSION_DENIED code
+ * @example
+ * throw permissionDenied('config.json', 'File is read-only');
+ * // DocumentError: Permission denied for config.json: File is read-only
+ */
+export declare function permissionDenied(path: string, reason: string): DocumentError;
+/**
+ * Factory: Restricted path error.
+ *
+ * @param path - Path that is restricted
+ * @returns DocumentError with RESTRICTED_PATH code
+ * @example
+ * throw restrictedPath('.git/config');
+ * // DocumentError: Cannot access restricted path: .git/config
+ */
+export declare function restrictedPath(path: string): DocumentError;
+/**
+ * Factory: Validation error.
+ *
+ * @param field - Name of the field that failed validation
+ * @param message - Description of the validation failure
+ * @returns DocumentError with VALIDATION_ERROR code
+ * @example
+ * throw validationError('path', 'must be relative to repo root');
+ * // DocumentError: Validation failed for 'path': must be relative to repo root
+ */
+export declare function validationError(field: string, message: string): DocumentError;
+/**
+ * Error thrown when recursion depth limit is exceeded.
+ * Used by RLM sub-call processing.
+ */
+export declare class DepthLimitError extends Error {
+    readonly maxDepth: number;
+    readonly currentDepth: number;
+    constructor(maxDepth: number, currentDepth: number);
+}
+//# sourceMappingURL=errors.d.ts.map

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

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

package/dist/utils/errors.js

@@ -0,0 +1,125 @@
+/**
+ * Error handling utilities for MCP document CRUD operations.
+ * Provides consistent error types with codes, suggestions, and JSON serialization.
+ */
+/**
+ * Custom error class for document operations.
+ * Extends Error with code, path, suggestion, and JSON serialization.
+ */
+export class DocumentError extends Error {
+    code;
+    path;
+    suggestion;
+    constructor(code, message, path, suggestion) {
+        super(message);
+        this.name = 'DocumentError';
+        this.code = code;
+        this.path = path;
+        this.suggestion = suggestion;
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, DocumentError.prototype);
+        // Capture stack trace (V8 engines)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DocumentError);
+        }
+    }
+    /**
+     * Convert to MCP-compatible JSON shape.
+     */
+    toJSON() {
+        const result = {
+            code: this.code,
+            message: this.message,
+        };
+        if (this.path !== undefined) {
+            result.path = this.path;
+        }
+        if (this.suggestion !== undefined) {
+            result.suggestion = this.suggestion;
+        }
+        return result;
+    }
+}
+/**
+ * Factory: File not found error.
+ *
+ * @param path - Path to the file that was not found
+ * @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.');
+}
+/**
+ * Factory: File already exists error.
+ *
+ * @param path - Path to the file that already exists
+ * @returns DocumentError with ALREADY_EXISTS code
+ * @example
+ * throw alreadyExists('addendums/001-existing.md');
+ * // DocumentError: File already exists: addendums/001-existing.md
+ */
+export function alreadyExists(path) {
+    return new DocumentError('ALREADY_EXISTS', `File already exists: ${path}`, path, 'Use update_doc to modify existing files.');
+}
+/**
+ * Factory: Permission denied error.
+ *
+ * @param path - Path to the file
+ * @param reason - Reason for the permission denial
+ * @returns DocumentError with PERMISSION_DENIED code
+ * @example
+ * throw permissionDenied('config.json', 'File is read-only');
+ * // DocumentError: Permission denied for config.json: File is read-only
+ */
+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.');
+}
+/**
+ * Factory: Restricted path error.
+ *
+ * @param path - Path that is restricted
+ * @returns DocumentError with RESTRICTED_PATH code
+ * @example
+ * throw restrictedPath('.git/config');
+ * // DocumentError: Cannot access restricted path: .git/config
+ */
+export function restrictedPath(path) {
+    return new DocumentError('RESTRICTED_PATH', `Cannot access restricted path: ${path}`, path, 'Writable directories: addendums/, examples/, research/, and root *.md files.');
+}
+/**
+ * Factory: Validation error.
+ *
+ * @param field - Name of the field that failed validation
+ * @param message - Description of the validation failure
+ * @returns DocumentError with VALIDATION_ERROR code
+ * @example
+ * throw validationError('path', 'must be relative to repo root');
+ * // 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}`);
+}
+/**
+ * Error thrown when recursion depth limit is exceeded.
+ * Used by RLM sub-call processing.
+ */
+export class DepthLimitError extends Error {
+    maxDepth;
+    currentDepth;
+    constructor(maxDepth, currentDepth) {
+        super(`Max recursion depth exceeded: ${currentDepth} > ${maxDepth}`);
+        this.name = 'DepthLimitError';
+        this.maxDepth = maxDepth;
+        this.currentDepth = currentDepth;
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, DepthLimitError.prototype);
+        // Capture stack trace (V8 engines)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DepthLimitError);
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility modules for MCP document CRUD operations.
+ */
+export * from './errors.js';
+export * from './paths.js';
+export * from './backup.js';
+export * from './os-paths.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+/**
+ * Utility modules for MCP document CRUD operations.
+ */
+// Re-export all utilities
+export * from './errors.js';
+export * from './paths.js';
+export * from './backup.js';
+export * from './os-paths.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0BAA0B;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/utils/os-paths.d.ts

@@ -0,0 +1,45 @@
+/**
+ * OS-specific path resolution utilities for global npm installation.
+ * Provides default configuration and data paths based on the operating system.
+ */
+/**
+ * Get the OS-specific base directory for application data.
+ *
+ * @param appName - Application/project name (defaults to mcp-planning-server)
+ * @returns Absolute path to the base directory
+ */
+export declare function getOSBasePath(appName?: string): string;
+/**
+ * Get the OS-specific default configuration file path.
+ *
+ * - macOS: ~/Library/Application Support/{appName}/config.json
+ * - Windows: %APPDATA%\{appName}\config.json
+ * - Linux/others: ~/.config/{appName}/config.json (XDG_CONFIG_HOME)
+ *
+ * @param appName - Application/project name (defaults to mcp-planning-server)
+ * @returns Absolute path to the default config file location
+ */
+export declare function getOSConfigPath(appName?: string): string;
+/**
+ * Get the OS-specific default data directory path.
+ *
+ * - macOS: ~/Library/Application Support/{appName}/data
+ * - Windows: %APPDATA%\{appName}\data
+ * - Linux/others: ~/.local/share/{appName}/data (XDG_DATA_HOME)
+ *
+ * @param appName - Application/project name (defaults to mcp-planning-server)
+ * @returns Absolute path to the default data directory
+ */
+export declare function getOSDataPath(appName?: string): string;
+/**
+ * Get the OS-specific default coordination file path.
+ *
+ * - macOS: ~/Library/Application Support/{appName}/coordination.json
+ * - Windows: %APPDATA%\{appName}\coordination.json
+ * - Linux/others: ~/.local/share/{appName}/coordination.json (XDG_DATA_HOME)
+ *
+ * @param appName - Application/project name (defaults to mcp-planning-server)
+ * @returns Absolute path to the default coordination file
+ */
+export declare function getOSCoordinationPath(appName?: string): string;
+//# sourceMappingURL=os-paths.d.ts.map

package/dist/utils/os-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-paths.d.ts","sourceRoot":"","sources":["../../src/utils/os-paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAWxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAE1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAYxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAehF"}