@sudosandwich/limps 0.2.0

package/dist/utils/os-paths.js

@@ -0,0 +1,81 @@
+/**
+ * OS-specific path resolution utilities for global npm installation.
+ * Provides default configuration and data paths based on the operating system.
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+const DEFAULT_APP_NAME = 'mcp-planning-server';
+/**
+ * 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 function getOSBasePath(appName = DEFAULT_APP_NAME) {
+    const home = homedir();
+    switch (process.platform) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', appName);
+        case 'win32':
+            return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), appName);
+        default:
+            return join(process.env.XDG_CONFIG_HOME || join(home, '.config'), appName);
+    }
+}
+/**
+ * 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 function getOSConfigPath(appName = DEFAULT_APP_NAME) {
+    return join(getOSBasePath(appName), 'config.json');
+}
+/**
+ * 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 function getOSDataPath(appName = DEFAULT_APP_NAME) {
+    const home = homedir();
+    switch (process.platform) {
+        case 'darwin':
+            return join(getOSBasePath(appName), 'data');
+        case 'win32':
+            return join(getOSBasePath(appName), 'data');
+        default:
+            // Linux: data goes to XDG_DATA_HOME, not XDG_CONFIG_HOME
+            return join(process.env.XDG_DATA_HOME || join(home, '.local', 'share'), appName, 'data');
+    }
+}
+/**
+ * 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 function getOSCoordinationPath(appName = DEFAULT_APP_NAME) {
+    const home = homedir();
+    switch (process.platform) {
+        case 'darwin':
+            return join(getOSBasePath(appName), 'coordination.json');
+        case 'win32':
+            return join(getOSBasePath(appName), 'coordination.json');
+        default:
+            return join(process.env.XDG_DATA_HOME || join(home, '.local', 'share'), appName, 'coordination.json');
+    }
+}
+//# sourceMappingURL=os-paths.js.map

package/dist/utils/os-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-paths.js","sourceRoot":"","sources":["../../src/utils/os-paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,gBAAgB;IAC9D,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IAEvB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC/D,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAChF;YACE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,gBAAgB;IAChE,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,gBAAgB;IAC9D,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IAEvB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C;YACE,yDAAyD;YACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB,gBAAgB;IACtE,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IAEvB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC;QAC3D,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC;QAC3D;YACE,OAAO,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAC1D,OAAO,EACP,mBAAmB,CACpB,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Path validation utilities for MCP document CRUD operations.
+ * Validates paths, prevents directory traversal, and enforces access restrictions.
+ */
+/**
+ * Document type based on file extension.
+ */
+export type DocType = 'md' | 'jsx' | 'tsx' | 'ts' | 'json' | 'yaml' | 'other';
+/**
+ * Result of path validation.
+ */
+export interface ValidatedPath {
+    /** Path relative to repo root */
+    relative: string;
+    /** Absolute path */
+    absolute: string;
+    /** Document type based on extension */
+    type: DocType;
+    /** Directory portion (empty string for root) */
+    directory: string;
+    /** Filename with extension */
+    filename: string;
+    /** File extension including dot (e.g., '.md') */
+    extension: string;
+}
+/**
+ * Options for path validation.
+ */
+export interface PathValidationOptions {
+    /** Whether to check if path is in a writable directory (default: false) */
+    requireWritable?: boolean;
+}
+/**
+ * Paths that are restricted and cannot be accessed.
+ */
+export declare const RESTRICTED_PATHS: readonly string[];
+/**
+ * Directories that allow write operations.
+ */
+export declare const WRITABLE_DIRS: readonly string[];
+/**
+ * Plan files that require confirmation before overwrite (protected, not blocked).
+ * These files can be written, but require explicit confirmation (force: true).
+ */
+export declare const PROTECTED_PLAN_FILES: readonly RegExp[];
+/**
+ * Check if a path is a protected plan file that requires confirmation.
+ *
+ * @param relativePath - Path relative to repo root
+ * @returns True if the path matches a protected plan file pattern
+ */
+export declare function isProtectedPlanFile(relativePath: string): boolean;
+/**
+ * Get document type from file path based on extension.
+ */
+export declare function getDocType(filePath: string): DocType;
+/**
+ * Check if a path is writable (in allowed directories or root .md file).
+ */
+export declare function isWritablePath(relativePath: string): boolean;
+/**
+ * Validate a path relative to the repository root.
+ *
+ * @param path - Path to validate (relative to repo root)
+ * @param repoRoot - Absolute path to repository root
+ * @param options - Validation options
+ * @returns Validated path information
+ * @throws DocumentError if validation fails
+ */
+export declare function validatePath(path: string, repoRoot: string, options?: PathValidationOptions): ValidatedPath;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAQ7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAmD,CAAC;AAE/F;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAEjD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoBpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAuB5D;AAoCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,aAAa,CAgDf"}

package/dist/utils/paths.js

@@ -0,0 +1,165 @@
+/**
+ * Path validation utilities for MCP document CRUD operations.
+ * Validates paths, prevents directory traversal, and enforces access restrictions.
+ */
+import { resolve, dirname, basename, extname, isAbsolute, relative } from 'path';
+import { restrictedPath, validationError } from './errors.js';
+/**
+ * Paths that are restricted and cannot be accessed.
+ */
+export const RESTRICTED_PATHS = [
+    '.git',
+    'node_modules',
+    '.env',
+    '.env.local',
+    '.env.development',
+    '.env.production',
+    '.env.test',
+];
+/**
+ * Directories that allow write operations.
+ */
+export const WRITABLE_DIRS = ['addendums', 'examples', 'research', 'plans'];
+/**
+ * Plan files that require confirmation before overwrite (protected, not blocked).
+ * These files can be written, but require explicit confirmation (force: true).
+ */
+export const PROTECTED_PLAN_FILES = [
+    /^plans\/\d{4}-[^/]+\/plan\.md$/, // Existing plan.md files
+];
+/**
+ * Check if a path is a protected plan file that requires confirmation.
+ *
+ * @param relativePath - Path relative to repo root
+ * @returns True if the path matches a protected plan file pattern
+ */
+export function isProtectedPlanFile(relativePath) {
+    const normalized = normalizePath(relativePath);
+    return PROTECTED_PLAN_FILES.some((pattern) => pattern.test(normalized));
+}
+/**
+ * Get document type from file path based on extension.
+ */
+export function getDocType(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    switch (ext) {
+        case '.md':
+            return 'md';
+        case '.jsx':
+            return 'jsx';
+        case '.tsx':
+            return 'tsx';
+        case '.ts':
+            return 'ts';
+        case '.json':
+            return 'json';
+        case '.yaml':
+        case '.yml':
+            return 'yaml';
+        default:
+            return 'other';
+    }
+}
+/**
+ * Check if a path is writable (in allowed directories or root .md file).
+ */
+export function isWritablePath(relativePath) {
+    const normalized = normalizePath(relativePath);
+    // Empty path (root) is not writable
+    if (!normalized) {
+        return false;
+    }
+    // Get the top-level directory
+    const parts = normalized.split('/');
+    const topDir = parts[0];
+    // Check if in writable directories
+    if (WRITABLE_DIRS.includes(topDir)) {
+        return true;
+    }
+    // Root-level markdown files are writable
+    if (parts.length === 1 && extname(normalized).toLowerCase() === '.md') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Normalize a path: remove trailing slashes, collapse double slashes.
+ */
+function normalizePath(path) {
+    // Remove trailing slashes
+    let normalized = path.replace(/\/+$/, '');
+    // Collapse double slashes
+    normalized = normalized.replace(/\/+/g, '/');
+    // Remove leading ./
+    normalized = normalized.replace(/^\.\//, '');
+    return normalized;
+}
+/**
+ * Check if path matches any restricted patterns.
+ */
+function isRestrictedPath(relativePath) {
+    const normalized = normalizePath(relativePath);
+    const parts = normalized.split('/');
+    for (const part of parts) {
+        // Check exact matches
+        if (RESTRICTED_PATHS.includes(part)) {
+            return true;
+        }
+        // Check .env* patterns
+        if (part.startsWith('.env')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Validate a path relative to the repository root.
+ *
+ * @param path - Path to validate (relative to repo root)
+ * @param repoRoot - Absolute path to repository root
+ * @param options - Validation options
+ * @returns Validated path information
+ * @throws DocumentError if validation fails
+ */
+export function validatePath(path, repoRoot, options = {}) {
+    // Reject absolute paths
+    if (isAbsolute(path)) {
+        throw validationError('path', 'Path must be relative to repo root');
+    }
+    // Check for path traversal attempts before resolving
+    if (path.includes('..')) {
+        throw validationError('path', 'Path traversal not allowed');
+    }
+    // Normalize the path
+    const normalized = normalizePath(path);
+    // Resolve to absolute path
+    const absolutePath = resolve(repoRoot, normalized);
+    // Double-check the resolved path is within repo root
+    // This catches edge cases the simple .. check might miss
+    const resolvedRelative = relative(repoRoot, absolutePath);
+    if (resolvedRelative.startsWith('..') || isAbsolute(resolvedRelative)) {
+        throw validationError('path', 'Path traversal not allowed');
+    }
+    // Check for restricted paths
+    if (isRestrictedPath(normalized)) {
+        throw restrictedPath(path);
+    }
+    // Check writable requirement
+    if (options.requireWritable && !isWritablePath(normalized)) {
+        throw restrictedPath(path);
+    }
+    // Extract path components
+    const dir = dirname(normalized);
+    const filename = basename(normalized);
+    const extension = extname(normalized);
+    const type = getDocType(normalized);
+    return {
+        relative: normalized,
+        absolute: absolutePath,
+        type,
+        directory: dir === '.' ? '' : dir,
+        filename: filename || normalized, // Handle directory-only paths
+        extension,
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

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

package/dist/watcher.d.ts

@@ -0,0 +1,19 @@
+import { type FSWatcher } from 'chokidar';
+/**
+ * Start a file watcher for specified file types.
+ *
+ * @param watchPaths - Path(s) to watch (file or directory, single or array)
+ * @param onChange - Callback when file changes (path, event)
+ * @param fileExtensions - File extensions to watch (e.g., ['.md', '.jsx', '.tsx'])
+ * @param ignorePatterns - Patterns to ignore (e.g., ['.git', 'node_modules'])
+ * @param debounceDelay - Debounce delay in milliseconds (default: 200ms)
+ * @returns Chokidar watcher instance
+ */
+export declare function startWatcher(watchPaths: string | string[], onChange: (path: string, event: 'add' | 'change' | 'unlink') => Promise<void>, fileExtensions?: string[], ignorePatterns?: string[], debounceDelay?: number): FSWatcher;
+/**
+ * Stop a file watcher.
+ *
+ * @param watcher - Chokidar watcher instance
+ */
+export declare function stopWatcher(watcher: FSWatcher): Promise<void>;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA,OAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAcpD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,EAC7E,cAAc,GAAE,MAAM,EAA4B,EAClD,cAAc,GAAE,MAAM,EAAqC,EAC3D,aAAa,SAAM,GAClB,SAAS,CAwFX;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE"}

package/dist/watcher.js

@@ -0,0 +1,109 @@
+import chokidar from 'chokidar';
+/**
+ * Default file extensions to watch.
+ */
+const DEFAULT_FILE_EXTENSIONS = ['.md'];
+/**
+ * Check if a file path matches any of the given extensions.
+ */
+function matchesExtension(filePath, extensions) {
+    return extensions.some((ext) => filePath.endsWith(ext));
+}
+/**
+ * Start a file watcher for specified file types.
+ *
+ * @param watchPaths - Path(s) to watch (file or directory, single or array)
+ * @param onChange - Callback when file changes (path, event)
+ * @param fileExtensions - File extensions to watch (e.g., ['.md', '.jsx', '.tsx'])
+ * @param ignorePatterns - Patterns to ignore (e.g., ['.git', 'node_modules'])
+ * @param debounceDelay - Debounce delay in milliseconds (default: 200ms)
+ * @returns Chokidar watcher instance
+ */
+export function startWatcher(watchPaths, onChange, fileExtensions = DEFAULT_FILE_EXTENSIONS, ignorePatterns = ['.git', 'node_modules', '.tmp'], debounceDelay = 200) {
+    // Build ignore patterns for Chokidar
+    const ignored = ignorePatterns.map((pattern) => {
+        // Convert simple patterns to glob patterns
+        if (pattern.includes('*')) {
+            return pattern;
+        }
+        // Match directories and files with this name
+        return `**/${pattern}/**`;
+    });
+    // Build complete ignore patterns
+    const allIgnored = [
+        ...ignored,
+        /(^|[/\\])\../, // Ignore dotfiles
+    ];
+    // Watch the directory (or file if it's a single file)
+    const watcher = chokidar.watch(watchPaths, {
+        ignored: allIgnored,
+        persistent: true,
+        ignoreInitial: false,
+        awaitWriteFinish: {
+            stabilityThreshold: 100,
+            pollInterval: 100,
+        },
+    });
+    // Debounce map to track pending callbacks
+    const debounceMap = new Map();
+    const debouncedOnChange = (path, event) => {
+        // Clear existing timeout for this path
+        const existing = debounceMap.get(path);
+        if (existing) {
+            clearTimeout(existing);
+        }
+        // Set new timeout
+        const timeout = setTimeout(async () => {
+            debounceMap.delete(path);
+            try {
+                await onChange(path, event);
+            }
+            catch (error) {
+                // Log error but don't throw (watcher should continue)
+                console.error(`Error in onChange callback for ${path}:`, error);
+            }
+        }, debounceDelay);
+        debounceMap.set(path, timeout);
+    };
+    // Watch for file additions (only files with matching extensions)
+    watcher.on('add', (path) => {
+        if (matchesExtension(path, fileExtensions)) {
+            debouncedOnChange(path, 'add');
+        }
+    });
+    // Watch for file changes (only files with matching extensions)
+    watcher.on('change', (path) => {
+        if (matchesExtension(path, fileExtensions)) {
+            debouncedOnChange(path, 'change');
+        }
+    });
+    // Watch for file deletions (only files with matching extensions)
+    watcher.on('unlink', (path) => {
+        if (matchesExtension(path, fileExtensions)) {
+            // Clear any pending debounce for this path
+            const existing = debounceMap.get(path);
+            if (existing) {
+                clearTimeout(existing);
+                debounceMap.delete(path);
+            }
+            // Handle deletion immediately (no debounce needed)
+            onChange(path, 'unlink').catch((error) => {
+                console.error(`Error handling file deletion for ${path}:`, error);
+            });
+        }
+    });
+    // Handle errors
+    watcher.on('error', (error) => {
+        console.error('Watcher error:', error);
+    });
+    return watcher;
+}
+/**
+ * Stop a file watcher.
+ *
+ * @param watcher - Chokidar watcher instance
+ */
+export async function stopWatcher(watcher) {
+    await watcher.close();
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

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

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@sudosandwich/limps",
+  "version": "0.2.0",
+  "description": "Local Intelligent MCP Planning Server - AI agent plan management and coordination",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "limps": "dist/index.js"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "planning",
+    "document-management",
+    "ai",
+    "cursor",
+    "claude",
+    "anthropic",
+    "ai-agent",
+    "local-first",
+    "llm",
+    "mcp-server",
+    "rlm",
+    "recursive-language-model"
+  ],
+  "author": "Paul Breuler",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/paulbreuler/mcp-planning-server.git"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "better-sqlite3": "^11.7.0",
+    "chokidar": "^4.0.3",
+    "micromatch": "^4.0.8",
+    "open": "^10.2.0",
+    "quickjs-emscripten": "^0.31.0",
+    "which": "^4.0.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.23.8"
+  },
+  "lint-staged": {
+    "src/**/*.ts": [
+      "prettier --write",
+      "eslint --fix"
+    ],
+    "tests/**/*.ts": [
+      "prettier --write",
+      "eslint --fix"
+    ]
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/micromatch": "^4.0.10",
+    "@types/node": "^25.0.9",
+    "@types/which": "^3.0.4",
+    "@vitest/coverage-v8": "^4.0.17",
+    "eslint": "^9.39.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.53.1",
+    "vitest": "^4.0.17"
+  }
+}