@sudosandwich/limps 0.2.0

package/dist/coordination.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Task handoff contract for sequential review workflows.
+ */
+export interface TaskHandoff {
+    fromAgent: string;
+    toPersona: 'reviewer' | 'pm' | 'customer';
+    task: {
+        id: string;
+        filesModified: string[];
+        summary: string;
+        testsAdded: number;
+    };
+    reviewCriteria: {
+        type: 'code_quality' | 'security' | 'ux' | 'requirements';
+        required: boolean;
+    }[];
+    iterationCount: number;
+    maxIterations: number;
+}
+/**
+ * Coordination state for multi-agent orchestration.
+ */
+export interface CoordinationState {
+    version: number;
+    agents: Record<string, AgentState>;
+    tasks: Record<string, TaskState>;
+    fileLocks: Record<string, string>;
+    handoffs?: Record<string, TaskHandoff>;
+}
+/**
+ * Agent state tracking.
+ */
+export interface AgentState {
+    status: 'idle' | 'WIP';
+    persona: 'coder' | 'reviewer' | 'pm' | 'customer';
+    taskId?: string;
+    filesLocked: string[];
+    heartbeat: string;
+}
+/**
+ * Task state tracking.
+ */
+export interface TaskState {
+    status: 'GAP' | 'WIP' | 'PASS' | 'BLOCKED';
+    claimedBy?: string;
+    dependencies: string[];
+}
+/**
+ * Read coordination state from file.
+ * Creates default state if file doesn't exist.
+ *
+ * @param path - Path to coordination.json file
+ * @returns Coordination state
+ */
+export declare function readCoordination(path: string): Promise<CoordinationState>;
+/**
+ * Write coordination state to file with optimistic concurrency control.
+ * Uses atomic write (temp file + rename) to prevent corruption.
+ *
+ * @param path - Path to coordination.json file
+ * @param state - Coordination state to write
+ * @param expectedVersion - Expected version number (for optimistic concurrency)
+ * @throws Error if expectedVersion doesn't match current version
+ */
+export declare function writeCoordination(path: string, state: CoordinationState, expectedVersion: number): Promise<void>;
+/**
+ * Create a task handoff contract.
+ *
+ * @param fromAgent - Agent ID creating the handoff
+ * @param toPersona - Target persona type
+ * @param task - Task information
+ * @param criteria - Review criteria
+ * @param maxIterations - Maximum iterations before escalation (typically from config.maxHandoffIterations)
+ * @returns Task handoff contract
+ */
+export declare function createHandoff(fromAgent: string, toPersona: string, task: TaskHandoff['task'], criteria: TaskHandoff['reviewCriteria'], maxIterations?: number): TaskHandoff;
+/**
+ * Accept a handoff and store it in coordination state.
+ * Updates coordination state to link handoff to task.
+ * Note: Interface shows void return, but implementation returns updated state
+ * for functional/immutable pattern. Caller should write coordination state.
+ *
+ * @param coordination - Coordination state to update
+ * @param handoff - Handoff to accept
+ * @param _agentId - Agent ID accepting the handoff
+ * @returns Updated coordination state (caller should write to file)
+ */
+export declare function acceptHandoff(coordination: CoordinationState, handoff: TaskHandoff, _agentId: string): CoordinationState;
+/**
+ * Reject a handoff with feedback and determine escalation.
+ * Increments iteration count and checks if escalation is needed.
+ *
+ * @param handoff - Handoff to reject
+ * @param _feedback - Rejection feedback (for future use - could be stored in handoff or separate store)
+ * @returns Escalation decision and new status (includes updatedHandoff for convenience)
+ */
+export declare function rejectHandoff(handoff: TaskHandoff, _feedback: string): {
+    shouldEscalate: boolean;
+    newStatus: 'WIP' | 'BLOCKED';
+    updatedHandoff: TaskHandoff;
+};
+//# sourceMappingURL=coordination.d.ts.map

package/dist/coordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.d.ts","sourceRoot":"","sources":["../src/coordination.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,cAAc,EAAE;QACd,IAAI,EAAE,cAAc,GAAG,UAAU,GAAG,IAAI,GAAG,cAAc,CAAC;QAC1D,QAAQ,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiD/E;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,iBAAiB,EACxB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,WAAW,CAAC,gBAAgB,CAAC,EACvC,aAAa,SAAI,GAChB,WAAW,CAcb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,iBAAiB,EAC/B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAUnB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAChB;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,SAAS,CAAC;IAAC,cAAc,EAAE,WAAW,CAAA;CAAE,CAiBxF"}

package/dist/coordination.js

@@ -0,0 +1,157 @@
+import { readFileSync, writeFileSync, existsSync, renameSync, mkdirSync, unlinkSync } from 'fs';
+import { dirname } from 'path';
+/**
+ * Read coordination state from file.
+ * Creates default state if file doesn't exist.
+ *
+ * @param path - Path to coordination.json file
+ * @returns Coordination state
+ */
+export async function readCoordination(path) {
+    if (!existsSync(path)) {
+        const defaultState = {
+            version: 1,
+            agents: {},
+            tasks: {},
+            fileLocks: {},
+            handoffs: {},
+        };
+        // Ensure directory exists
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(defaultState, null, 2), 'utf-8');
+        return defaultState;
+    }
+    try {
+        const content = readFileSync(path, 'utf-8');
+        const state = JSON.parse(content);
+        // Validate structure
+        if (typeof state.version !== 'number' || !state.agents || !state.tasks || !state.fileLocks) {
+            // Return default state if structure is invalid
+            const defaultState = {
+                version: 1,
+                agents: {},
+                tasks: {},
+                fileLocks: {},
+                handoffs: {},
+            };
+            return defaultState;
+        }
+        // Ensure handoffs exists (for backward compatibility)
+        if (!state.handoffs) {
+            state.handoffs = {};
+        }
+        return state;
+    }
+    catch (_error) {
+        // Handle malformed JSON gracefully
+        const defaultState = {
+            version: 1,
+            agents: {},
+            tasks: {},
+            fileLocks: {},
+            handoffs: {},
+        };
+        return defaultState;
+    }
+}
+/**
+ * Write coordination state to file with optimistic concurrency control.
+ * Uses atomic write (temp file + rename) to prevent corruption.
+ *
+ * @param path - Path to coordination.json file
+ * @param state - Coordination state to write
+ * @param expectedVersion - Expected version number (for optimistic concurrency)
+ * @throws Error if expectedVersion doesn't match current version
+ */
+export async function writeCoordination(path, state, expectedVersion) {
+    // Ensure directory exists
+    mkdirSync(dirname(path), { recursive: true });
+    // Read current state to check version
+    const currentState = await readCoordination(path);
+    if (currentState.version !== expectedVersion) {
+        throw new Error(`Version mismatch: expected ${expectedVersion}, got ${currentState.version}`);
+    }
+    // Atomic write: write to temp file, then rename
+    const tempPath = `${path}.tmp`;
+    try {
+        writeFileSync(tempPath, JSON.stringify(state, null, 2), 'utf-8');
+        // Rename is atomic on most filesystems
+        renameSync(tempPath, path);
+    }
+    catch (error) {
+        // Clean up temp file on error
+        if (existsSync(tempPath)) {
+            unlinkSync(tempPath);
+        }
+        throw error;
+    }
+}
+/**
+ * Create a task handoff contract.
+ *
+ * @param fromAgent - Agent ID creating the handoff
+ * @param toPersona - Target persona type
+ * @param task - Task information
+ * @param criteria - Review criteria
+ * @param maxIterations - Maximum iterations before escalation (typically from config.maxHandoffIterations)
+ * @returns Task handoff contract
+ */
+export function createHandoff(fromAgent, toPersona, task, criteria, maxIterations = 3) {
+    // Validate toPersona matches expected type
+    if (!['reviewer', 'pm', 'customer'].includes(toPersona)) {
+        throw new Error(`Invalid toPersona: ${toPersona}. Must be 'reviewer', 'pm', or 'customer'`);
+    }
+    return {
+        fromAgent,
+        toPersona: toPersona,
+        task,
+        reviewCriteria: criteria,
+        iterationCount: 0,
+        maxIterations,
+    };
+}
+/**
+ * Accept a handoff and store it in coordination state.
+ * Updates coordination state to link handoff to task.
+ * Note: Interface shows void return, but implementation returns updated state
+ * for functional/immutable pattern. Caller should write coordination state.
+ *
+ * @param coordination - Coordination state to update
+ * @param handoff - Handoff to accept
+ * @param _agentId - Agent ID accepting the handoff
+ * @returns Updated coordination state (caller should write to file)
+ */
+export function acceptHandoff(coordination, handoff, _agentId) {
+    const handoffs = coordination.handoffs || {};
+    return {
+        ...coordination,
+        handoffs: {
+            ...handoffs,
+            [handoff.task.id]: handoff,
+        },
+    };
+}
+/**
+ * Reject a handoff with feedback and determine escalation.
+ * Increments iteration count and checks if escalation is needed.
+ *
+ * @param handoff - Handoff to reject
+ * @param _feedback - Rejection feedback (for future use - could be stored in handoff or separate store)
+ * @returns Escalation decision and new status (includes updatedHandoff for convenience)
+ */
+export function rejectHandoff(handoff, _feedback) {
+    const newIterationCount = handoff.iterationCount + 1;
+    const shouldEscalate = newIterationCount >= handoff.maxIterations;
+    const updatedHandoff = {
+        ...handoff,
+        iterationCount: newIterationCount,
+    };
+    // Store feedback in handoff (extend interface if needed, or use a separate feedback store)
+    // For now, we'll return the decision and let the caller handle feedback storage
+    return {
+        shouldEscalate,
+        newStatus: shouldEscalate ? 'BLOCKED' : 'WIP',
+        updatedHandoff,
+    };
+}
+//# sourceMappingURL=coordination.js.map

package/dist/coordination.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+import { loadConfig, getAllDocsPaths, getFileExtensions } from './config.js';
+import { createServer, startServer } from './server.js';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { mkdirSync, existsSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import which from 'which';
+/**
+ * Expand tilde in path to full home directory path.
+ */
+function expandTilde(path) {
+    if (path.startsWith('~/')) {
+        return resolve(homedir(), path.slice(2));
+    }
+    return resolve(path);
+}
+import { initializeDatabase, createSchema, indexAllPaths, indexDocument, removeDocument, } from './indexer.js';
+import { startWatcher, stopWatcher } from './watcher.js';
+import { readCoordination } from './coordination.js';
+import { getOSConfigPath, getOSBasePath, getOSDataPath, getOSCoordinationPath, } from './utils/os-paths.js';
+// Global references for graceful shutdown
+let watcher = null;
+let db = null;
+/**
+ * Parse command line arguments.
+ *
+ * Supports:
+ * - limps (start server with default config)
+ * - limps --config <path> (start server with custom config)
+ * - limps init <project-name> [--docs-path <path>] (initialize new project)
+ *
+ * @returns Parsed arguments
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    // Check for init command
+    if (args[0] === 'init') {
+        const projectName = args[1];
+        const docsPathIndex = args.indexOf('--docs-path');
+        const docsPath = docsPathIndex !== -1 ? args[docsPathIndex + 1] : undefined;
+        return { command: 'init', projectName, docsPath };
+    }
+    // Check for --config flag
+    const configIndex = args.indexOf('--config');
+    if (configIndex !== -1 && args[configIndex + 1]) {
+        return { configPath: args[configIndex + 1] };
+    }
+    return {};
+}
+/**
+ * Get the full path to the limps executable.
+ * Falls back to 'limps' if not found in PATH.
+ */
+function getLocalPlannerPath() {
+    try {
+        return which.sync('limps');
+    }
+    catch {
+        // Fallback to command name if not in PATH
+        return 'limps';
+    }
+}
+/**
+ * Initialize a new project configuration.
+ *
+ * @param projectName - Name of the project (e.g., "runi-planning")
+ * @param docsPath - Optional path to documentation directory
+ */
+function initProject(projectName, docsPath) {
+    const basePath = getOSBasePath(projectName);
+    const configPath = getOSConfigPath(projectName);
+    const dataPath = getOSDataPath(projectName);
+    const coordinationPath = getOSCoordinationPath(projectName);
+    // Expand tilde in docsPath if provided
+    const resolvedDocsPath = docsPath ? expandTilde(docsPath) : null;
+    const defaultDocsPath = resolve(homedir(), 'Documents', projectName);
+    // Create directory
+    mkdirSync(basePath, { recursive: true });
+    // Check if config already exists
+    if (existsSync(configPath)) {
+        console.log(`Config already exists at: ${configPath}`);
+        console.log('To reconfigure, delete the existing config file first.');
+        process.exit(1);
+    }
+    // Create default config with absolute paths
+    const config = {
+        plansPath: resolvedDocsPath ? resolve(resolvedDocsPath, 'plans') : resolve(defaultDocsPath, 'plans'),
+        docsPaths: [resolvedDocsPath || defaultDocsPath],
+        fileExtensions: ['.md'],
+        dataPath: dataPath,
+        coordinationPath: coordinationPath,
+        heartbeatTimeout: 300000,
+        debounceDelay: 200,
+        maxHandoffIterations: 3,
+    };
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
+    // Get the full path to limps executable
+    const localPlannerPath = getLocalPlannerPath();
+    console.log(`\n✓ Created ${projectName} configuration\n`);
+    console.log(`Config: ${configPath}`);
+    console.log(`Data:   ${dataPath}`);
+    console.log('');
+    // Output Cursor settings snippet
+    console.log('Add this to your Cursor settings (Cmd+Shift+P → "Preferences: Open User Settings (JSON)"):\n');
+    console.log(JSON.stringify({
+        'mcp.servers': {
+            [projectName]: {
+                command: localPlannerPath,
+                args: ['--config', configPath],
+            },
+        },
+    }, null, 2));
+    console.log('');
+    // Output Claude Desktop config snippet
+    console.log('For Claude Desktop, add this to ~/Library/Application Support/Claude/claude_desktop_config.json:\n');
+    console.log(JSON.stringify({
+        mcpServers: {
+            [projectName]: {
+                command: localPlannerPath,
+                args: ['--config', configPath],
+            },
+        },
+    }, null, 2));
+    console.log('');
+    // Test command
+    console.log('To test the server:');
+    console.log(`  ${localPlannerPath} --config "${configPath}"`);
+}
+/**
+ * Resolve configuration file path with priority:
+ * 1. CLI argument --config
+ * 2. Environment variable MCP_PLANNING_CONFIG
+ * 3. OS-specific default path
+ *
+ * Falls back to repo-local config.json if no config exists at determined path.
+ *
+ * @param cliConfigPath - Config path from CLI argument (if provided)
+ * @returns Resolved absolute path to config file
+ */
+function resolveConfigPath(cliConfigPath) {
+    // Priority 1: CLI argument
+    if (cliConfigPath) {
+        return resolve(cliConfigPath);
+    }
+    // Priority 2: Environment variable
+    const envConfigPath = process.env.MCP_PLANNING_CONFIG;
+    if (envConfigPath) {
+        return resolve(envConfigPath);
+    }
+    // Priority 3: OS-specific default
+    const osConfigPath = getOSConfigPath();
+    if (existsSync(osConfigPath)) {
+        return osConfigPath;
+    }
+    // Fallback: repo-local config.json (for development/backwards compatibility)
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = dirname(currentFile);
+    const srcDir = dirname(currentDir);
+    const repoRoot = dirname(srcDir);
+    const repoConfigPath = resolve(repoRoot, 'config.json');
+    // If neither OS config nor repo config exists, use OS path (will be created)
+    if (existsSync(repoConfigPath)) {
+        return repoConfigPath;
+    }
+    return osConfigPath;
+}
+/**
+ * Entry point for the MCP Planning Server.
+ * Loads configuration and starts the server.
+ */
+async function main() {
+    try {
+        // Parse CLI arguments
+        const args = parseArgs();
+        // Handle init command
+        if (args.command === 'init') {
+            if (!args.projectName) {
+                console.error('Usage: limps init <project-name> [--docs-path <path>]');
+                console.error('');
+                console.error('Example:');
+                console.error('  limps init my-project --docs-path ~/Documents/my-project');
+                process.exit(1);
+            }
+            initProject(args.projectName, args.docsPath);
+            return;
+        }
+        // Resolve config path for server mode
+        const configPath = resolveConfigPath(args.configPath);
+        // Load configuration
+        const config = loadConfig(configPath);
+        // Ensure data directory exists
+        mkdirSync(config.dataPath, { recursive: true });
+        // Initialize database
+        const dbPath = resolve(config.dataPath, 'documents.sqlite');
+        db = initializeDatabase(dbPath);
+        createSchema(db);
+        console.error(`Database initialized at ${dbPath}`);
+        // Load coordination state
+        const coordination = await readCoordination(config.coordinationPath);
+        console.error(`Coordination state loaded from ${config.coordinationPath}`);
+        // Get all paths and extensions to index
+        const docsPaths = getAllDocsPaths(config);
+        const fileExtensions = getFileExtensions(config);
+        const ignorePatterns = ['.git', 'node_modules', '.tmp'];
+        // Initial indexing (#19)
+        const result = await indexAllPaths(db, docsPaths, fileExtensions, ignorePatterns);
+        console.error(`Indexed ${result.indexed} documents (${result.updated} updated, ${result.skipped} skipped)`);
+        console.error(`Paths: ${docsPaths.join(', ')}`);
+        console.error(`Extensions: ${fileExtensions.join(', ')}`);
+        if (result.errors.length > 0) {
+            console.error(`Indexing errors: ${result.errors.length}`);
+            for (const err of result.errors) {
+                console.error(`  - ${err.path}: ${err.error}`);
+            }
+        }
+        // Capture db reference for watcher callback
+        const dbRef = db;
+        // Start file watcher (#4)
+        watcher = startWatcher(docsPaths, async (path, event) => {
+            if (event === 'unlink') {
+                await removeDocument(dbRef, path);
+                console.error(`Removed document: ${path}`);
+            }
+            else {
+                await indexDocument(dbRef, path);
+                console.error(`Indexed document: ${path} (${event})`);
+            }
+        }, fileExtensions, ignorePatterns, config.debounceDelay);
+        console.error(`File watcher started for ${docsPaths.length} path(s)`);
+        // Create and start server (pass db and coordination for tools)
+        const server = createServer(config, db, coordination);
+        await startServer(server, async () => {
+            // Graceful shutdown callback
+            if (watcher) {
+                await stopWatcher(watcher);
+                console.error('File watcher stopped');
+                watcher = null;
+            }
+            if (db) {
+                db.close();
+                console.error('Database connection closed');
+                db = null;
+            }
+        });
+    }
+    catch (error) {
+        console.error('Fatal error in main():', error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('Unhandled error in main():', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/indexer.d.ts

@@ -0,0 +1,83 @@
+import { type Database as DatabaseType } from 'better-sqlite3';
+/**
+ * Document metadata interface.
+ */
+export interface DocumentMetadata {
+    path: string;
+    title: string;
+    content: string;
+    summary?: string;
+    status?: 'GAP' | 'WIP' | 'PASS' | 'BLOCKED' | 'MISSING';
+    dependencies?: string[];
+    modifiedAt: number;
+    hash: string;
+}
+/**
+ * Indexing result interface for batch operations.
+ */
+export interface IndexingResult {
+    indexed: number;
+    updated: number;
+    skipped: number;
+    errors: {
+        path: string;
+        error: string;
+    }[];
+}
+/**
+ * Initialize a SQLite database at the given path.
+ * Creates the database file if it doesn't exist.
+ *
+ * @param dbPath - Path to the SQLite database file
+ * @returns Database instance
+ */
+export declare function initializeDatabase(dbPath: string): DatabaseType;
+/**
+ * Create the database schema including documents table and FTS5 virtual table.
+ * Must be called after initializeDatabase.
+ *
+ * @param db - Database instance
+ */
+export declare function createSchema(db: DatabaseType): void;
+/**
+ * Index a single document into the database.
+ *
+ * @param db - Database instance
+ * @param filePath - Path to the markdown file
+ * @returns Document metadata
+ */
+export declare function indexDocument(db: DatabaseType, filePath: string): Promise<DocumentMetadata>;
+/**
+ * Update document index in database and FTS5.
+ *
+ * @param db - Database instance
+ * @param metadata - Document metadata
+ */
+export declare function updateDocumentIndex(db: DatabaseType, metadata: DocumentMetadata): Promise<void>;
+/**
+ * Remove document from database and FTS5 index.
+ *
+ * @param db - Database instance
+ * @param filePath - Path to the document
+ */
+export declare function removeDocument(db: DatabaseType, filePath: string): Promise<void>;
+/**
+ * Index all documents in a directory.
+ *
+ * @param db - Database instance
+ * @param plansPath - Path to the plans directory
+ * @param ignorePatterns - Patterns to ignore (e.g., ['node_modules', '.git'])
+ * @returns Indexing result
+ */
+export declare function indexAllDocuments(db: DatabaseType, plansPath: string, ignorePatterns?: string[]): Promise<IndexingResult>;
+/**
+ * Index all documents from multiple paths with configurable file extensions.
+ *
+ * @param db - Database instance
+ * @param paths - Array of paths to index
+ * @param extensions - File extensions to index (e.g., ['.md', '.jsx', '.tsx'])
+ * @param ignorePatterns - Patterns to ignore (e.g., ['node_modules', '.git'])
+ * @returns Combined indexing result
+ */
+export declare function indexAllPaths(db: DatabaseType, paths: string[], extensions?: string[], ignorePatterns?: string[]): Promise<IndexingResult>;
+//# sourceMappingURL=indexer.d.ts.map

package/dist/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"AAAA,OAAiB,EAAE,KAAK,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKzE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAqBnD;AA8LD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyDjG;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtF;AAwDD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,MAAM,EAAqC,GAC1D,OAAO,CAAC,cAAc,CAAC,CAiEzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,GAAE,MAAM,EAAY,EAC9B,cAAc,GAAE,MAAM,EAAqC,GAC1D,OAAO,CAAC,cAAc,CAAC,CAyEzB"}