ai-mind-map 1.1.0

package/dist/change-tracker/watcher.d.ts

@@ -0,0 +1,137 @@
+/**
+ * AI Mind Map — File System Watcher
+ *
+ * Real-time file system watcher using chokidar. Inspired by Cursor's Merkle
+ * tree approach and CocoIndex's incremental processing. Watches project
+ * directories for file changes (create, modify, delete, rename) and emits
+ * debounced change events for incremental re-indexing.
+ *
+ * Key design choices:
+ * - Uses Node's EventEmitter for a familiar pub-sub pattern.
+ * - Debounces bursts of file system events into batched change sets.
+ * - Respects .gitignore plus user-configured custom ignore patterns.
+ * - Tracks changed files since the last consumer "drain" so nothing is lost.
+ * - Supports start / stop / pause / resume lifecycle.
+ */
+import { EventEmitter } from 'node:events';
+import type { ChangeType, MindMapConfig } from '../types.js';
+/** A lightweight record of a single raw file-system event. */
+export interface WatcherEvent {
+    /** Absolute path of the affected file. */
+    filePath: string;
+    /** What happened. */
+    changeType: ChangeType;
+    /** Absolute path before rename (only for 'renamed' events). */
+    oldPath?: string;
+    /** Unix-epoch milliseconds when the event was recorded. */
+    timestamp: number;
+}
+/** Events emitted by {@link FileWatcher}. */
+export interface WatcherEvents {
+    /** Fired after the debounce window closes with ≥ 1 accumulated change. */
+    changes: (events: WatcherEvent[]) => void;
+    /** Fired when a file system error is encountered. */
+    error: (error: Error) => void;
+    /** Fired once the initial scan is complete and the watcher is ready. */
+    ready: () => void;
+}
+/** Internal state of the watcher lifecycle. */
+type WatcherState = 'idle' | 'running' | 'paused' | 'stopped';
+/**
+ * Production file-system watcher that batches raw events into debounced
+ * {@link WatcherEvent} arrays and re-emits them via EventEmitter.
+ *
+ * ```ts
+ * const watcher = new FileWatcher(config);
+ * watcher.on('changes', (events) => { … });
+ * await watcher.start();
+ * ```
+ */
+export declare class FileWatcher extends EventEmitter {
+    private readonly projectRoot;
+    private readonly debounceMs;
+    private readonly maxFileSize;
+    private readonly customIgnores;
+    /** Underlying chokidar instance. */
+    private chokidarWatcher;
+    /** Current lifecycle state. */
+    private state;
+    /** Buffer for events accumulated during the debounce window. */
+    private pendingEvents;
+    /** Changes accumulated since the last call to {@link drainChanges}. */
+    private undrainedChanges;
+    /** Handle for the debounce timer, if one is currently active. */
+    private debounceTimer;
+    /** Compiled ignore filter (gitignore + custom rules). */
+    private ignoreFilter;
+    constructor(config: Partial<MindMapConfig> & {
+        projectRoot: string;
+    });
+    /**
+     * Start watching the project directory.
+     *
+     * Resolves once the initial scan is complete and the watcher is "ready".
+     */
+    start(): Promise<void>;
+    /** Pause watching — events are silently discarded until {@link resume}. */
+    pause(): void;
+    /** Resume watching after a {@link pause}. */
+    resume(): void;
+    /**
+     * Stop watching entirely and release all resources.
+     *
+     * After calling `stop()` the instance cannot be restarted — create a new
+     * one instead.
+     */
+    stop(): Promise<void>;
+    /** Current lifecycle state of the watcher. */
+    getState(): WatcherState;
+    /**
+     * Return all change events accumulated since the last drain (or since
+     * start, whichever is more recent) and clear the buffer.
+     *
+     * This is the primary API for consumers that want to poll rather than
+     * subscribe via events.
+     */
+    drainChanges(): WatcherEvent[];
+    /**
+     * Peek at the undrained changes without clearing them.
+     */
+    peekChanges(): readonly WatcherEvent[];
+    /**
+     * Load `.gitignore` from the project root (if it exists) and merge it
+     * with user-configured custom ignore patterns.
+     */
+    private loadIgnoreRules;
+    /**
+     * Determine whether a given absolute path should be ignored.
+     */
+    private isIgnored;
+    /** Wire chokidar events to our internal handler. */
+    private attachListeners;
+    /**
+     * Handle a single raw chokidar event.
+     *
+     * Events are accumulated in {@link pendingEvents} (keyed by path so that
+     * rapid repeated changes to the same file collapse) and a debounce timer
+     * is (re)started.
+     */
+    private handleEvent;
+    /**
+     * Collapse two sequential change types into a single effective type.
+     *
+     * Returns `null` when the net effect is "nothing happened" (e.g. a file
+     * was created then immediately deleted within the debounce window).
+     */
+    private resolveChangeType;
+    /** Clear any outstanding debounce timer. */
+    private clearDebounce;
+    /** (Re)start the debounce timer. */
+    private restartDebounce;
+    /** Flush the pending-events buffer and emit a `changes` event. */
+    private flushPending;
+    /** Centralised error handler — emits 'error' but never throws. */
+    private handleError;
+}
+export {};
+//# sourceMappingURL=watcher.d.ts.map

package/dist/change-tracker/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/change-tracker/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI7D,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IAC1C,qDAAqD;IACrD,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B,wEAAwE;IACxE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,+CAA+C;AAC/C,KAAK,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAI9D;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IAEzC,oCAAoC;IACpC,OAAO,CAAC,eAAe,CAAkD;IAEzE,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAwB;IAErC,gEAAgE;IAChE,OAAO,CAAC,aAAa,CAAwC;IAE7D,uEAAuE;IACvE,OAAO,CAAC,gBAAgB,CAAsB;IAE9C,iEAAiE;IACjE,OAAO,CAAC,aAAa,CAA8C;IAEnE,yDAAyD;IACzD,OAAO,CAAC,YAAY,CAAY;gBAIpB,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAUpE;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC5B,2EAA2E;IAC3E,KAAK,IAAI,IAAI;IAMb,6CAA6C;IAC7C,MAAM,IAAI,IAAI;IAKd;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,8CAA8C;IAC9C,QAAQ,IAAI,YAAY;IAIxB;;;;;;OAMG;IACH,YAAY,IAAI,YAAY,EAAE;IAM9B;;OAEG;IACH,WAAW,IAAI,SAAS,YAAY,EAAE;IAMtC;;;OAGG;YACW,eAAe;IAqB7B;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB,oDAAoD;IACpD,OAAO,CAAC,eAAe;IAcvB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAwBnB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAsBzB,4CAA4C;IAC5C,OAAO,CAAC,aAAa;IAOrB,oCAAoC;IACpC,OAAO,CAAC,eAAe;IAOvB,kEAAkE;IAClE,OAAO,CAAC,YAAY;IAmBpB,kEAAkE;IAClE,OAAO,CAAC,WAAW;CAepB"}

package/dist/change-tracker/watcher.js

@@ -0,0 +1,300 @@
+/**
+ * AI Mind Map — File System Watcher
+ *
+ * Real-time file system watcher using chokidar. Inspired by Cursor's Merkle
+ * tree approach and CocoIndex's incremental processing. Watches project
+ * directories for file changes (create, modify, delete, rename) and emits
+ * debounced change events for incremental re-indexing.
+ *
+ * Key design choices:
+ * - Uses Node's EventEmitter for a familiar pub-sub pattern.
+ * - Debounces bursts of file system events into batched change sets.
+ * - Respects .gitignore plus user-configured custom ignore patterns.
+ * - Tracks changed files since the last consumer "drain" so nothing is lost.
+ * - Supports start / stop / pause / resume lifecycle.
+ */
+import { EventEmitter } from 'node:events';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import chokidar from 'chokidar';
+import ignore from 'ignore';
+// --------------------------------------------------------------- watcher --
+/**
+ * Production file-system watcher that batches raw events into debounced
+ * {@link WatcherEvent} arrays and re-emits them via EventEmitter.
+ *
+ * ```ts
+ * const watcher = new FileWatcher(config);
+ * watcher.on('changes', (events) => { … });
+ * await watcher.start();
+ * ```
+ */
+export class FileWatcher extends EventEmitter {
+    projectRoot;
+    debounceMs;
+    maxFileSize;
+    customIgnores;
+    /** Underlying chokidar instance. */
+    chokidarWatcher = null;
+    /** Current lifecycle state. */
+    state = 'idle';
+    /** Buffer for events accumulated during the debounce window. */
+    pendingEvents = new Map();
+    /** Changes accumulated since the last call to {@link drainChanges}. */
+    undrainedChanges = [];
+    /** Handle for the debounce timer, if one is currently active. */
+    debounceTimer = null;
+    /** Compiled ignore filter (gitignore + custom rules). */
+    ignoreFilter = ignore();
+    // ---------------------------------------------------------------- ctor --
+    constructor(config) {
+        super();
+        this.projectRoot = path.resolve(config.projectRoot);
+        this.debounceMs = config.watchDebounceMs ?? 500;
+        this.maxFileSize = config.maxFileSize ?? 512 * 1024;
+        this.customIgnores = config.ignore ?? [];
+    }
+    // ------------------------------------------------------ public methods --
+    /**
+     * Start watching the project directory.
+     *
+     * Resolves once the initial scan is complete and the watcher is "ready".
+     */
+    async start() {
+        if (this.state === 'running' || this.state === 'paused') {
+            return; // already watching
+        }
+        await this.loadIgnoreRules();
+        this.chokidarWatcher = chokidar.watch(this.projectRoot, {
+            ignored: (filePath) => this.isIgnored(filePath),
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 200,
+                pollInterval: 50,
+            },
+            // Avoid EMFILE on very large repos
+            usePolling: false,
+        });
+        this.attachListeners();
+        this.state = 'running';
+        // Wait for chokidar's 'ready' event before resolving.
+        return new Promise((resolve, reject) => {
+            this.chokidarWatcher.once('ready', () => {
+                this.emit('ready');
+                resolve();
+            });
+            this.chokidarWatcher.once('error', (err) => {
+                reject(err);
+            });
+        });
+    }
+    /** Pause watching — events are silently discarded until {@link resume}. */
+    pause() {
+        if (this.state !== 'running')
+            return;
+        this.state = 'paused';
+        this.clearDebounce();
+    }
+    /** Resume watching after a {@link pause}. */
+    resume() {
+        if (this.state !== 'paused')
+            return;
+        this.state = 'running';
+    }
+    /**
+     * Stop watching entirely and release all resources.
+     *
+     * After calling `stop()` the instance cannot be restarted — create a new
+     * one instead.
+     */
+    async stop() {
+        if (this.state === 'stopped')
+            return;
+        this.clearDebounce();
+        if (this.chokidarWatcher) {
+            await this.chokidarWatcher.close();
+            this.chokidarWatcher = null;
+        }
+        this.state = 'stopped';
+        this.pendingEvents.clear();
+        this.removeAllListeners();
+    }
+    /** Current lifecycle state of the watcher. */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Return all change events accumulated since the last drain (or since
+     * start, whichever is more recent) and clear the buffer.
+     *
+     * This is the primary API for consumers that want to poll rather than
+     * subscribe via events.
+     */
+    drainChanges() {
+        const changes = [...this.undrainedChanges];
+        this.undrainedChanges = [];
+        return changes;
+    }
+    /**
+     * Peek at the undrained changes without clearing them.
+     */
+    peekChanges() {
+        return this.undrainedChanges;
+    }
+    // -------------------------------------------------- ignore-rule loading --
+    /**
+     * Load `.gitignore` from the project root (if it exists) and merge it
+     * with user-configured custom ignore patterns.
+     */
+    async loadIgnoreRules() {
+        this.ignoreFilter = ignore();
+        // Always ignore .git directory itself
+        this.ignoreFilter.add('.git');
+        // Load .gitignore
+        const gitignorePath = path.join(this.projectRoot, '.gitignore');
+        try {
+            const content = await readFile(gitignorePath, 'utf-8');
+            this.ignoreFilter.add(content);
+        }
+        catch {
+            // No .gitignore — that's fine.
+        }
+        // Add custom ignore patterns from config
+        if (this.customIgnores.length > 0) {
+            this.ignoreFilter.add(this.customIgnores);
+        }
+    }
+    /**
+     * Determine whether a given absolute path should be ignored.
+     */
+    isIgnored(filePath) {
+        // Always allow the root itself through so chokidar can traverse it.
+        if (filePath === this.projectRoot)
+            return false;
+        const relative = path.relative(this.projectRoot, filePath);
+        // Paths outside project root — ignore.
+        if (!relative || relative.startsWith('..'))
+            return true;
+        // Normalise to forward-slash for `ignore` (it expects posix paths).
+        const posix = relative.split(path.sep).join('/');
+        try {
+            return this.ignoreFilter.ignores(posix);
+        }
+        catch {
+            return false;
+        }
+    }
+    // ------------------------------------------------------- event wiring --
+    /** Wire chokidar events to our internal handler. */
+    attachListeners() {
+        if (!this.chokidarWatcher)
+            return;
+        this.chokidarWatcher.on('add', (fp) => this.handleEvent(fp, 'created'));
+        this.chokidarWatcher.on('change', (fp) => this.handleEvent(fp, 'modified'));
+        this.chokidarWatcher.on('unlink', (fp) => this.handleEvent(fp, 'deleted'));
+        this.chokidarWatcher.on('error', (error) => {
+            this.handleError(error instanceof Error ? error : new Error(String(error)));
+        });
+    }
+    // -------------------------------------------------- event accumulation --
+    /**
+     * Handle a single raw chokidar event.
+     *
+     * Events are accumulated in {@link pendingEvents} (keyed by path so that
+     * rapid repeated changes to the same file collapse) and a debounce timer
+     * is (re)started.
+     */
+    handleEvent(filePath, changeType) {
+        if (this.state !== 'running')
+            return;
+        const absPath = path.resolve(filePath);
+        const existing = this.pendingEvents.get(absPath);
+        // Collapse logic — e.g. create → modify becomes create; create → delete
+        // cancels both; modify → delete becomes delete, etc.
+        const resolvedType = this.resolveChangeType(existing?.changeType, changeType);
+        if (resolvedType === null) {
+            // Changes cancel each other out (e.g. create + delete).
+            this.pendingEvents.delete(absPath);
+        }
+        else {
+            this.pendingEvents.set(absPath, {
+                filePath: absPath,
+                changeType: resolvedType,
+                timestamp: Date.now(),
+            });
+        }
+        this.restartDebounce();
+    }
+    /**
+     * Collapse two sequential change types into a single effective type.
+     *
+     * Returns `null` when the net effect is "nothing happened" (e.g. a file
+     * was created then immediately deleted within the debounce window).
+     */
+    resolveChangeType(prev, curr) {
+        if (prev === undefined)
+            return curr;
+        // created → deleted = net nothing
+        if (prev === 'created' && curr === 'deleted')
+            return null;
+        // created → modified = still "created"
+        if (prev === 'created' && curr === 'modified')
+            return 'created';
+        // modified → deleted = deleted
+        if (prev === 'modified' && curr === 'deleted')
+            return 'deleted';
+        // anything → modified after existing modify = still modified
+        if (prev === 'modified' && curr === 'modified')
+            return 'modified';
+        // deleted → created = modified (re-created file)
+        if (prev === 'deleted' && curr === 'created')
+            return 'modified';
+        return curr;
+    }
+    // ----------------------------------------------------------- debounce --
+    /** Clear any outstanding debounce timer. */
+    clearDebounce() {
+        if (this.debounceTimer !== null) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+    }
+    /** (Re)start the debounce timer. */
+    restartDebounce() {
+        this.clearDebounce();
+        this.debounceTimer = setTimeout(() => {
+            this.flushPending();
+        }, this.debounceMs);
+    }
+    /** Flush the pending-events buffer and emit a `changes` event. */
+    flushPending() {
+        if (this.pendingEvents.size === 0)
+            return;
+        const events = Array.from(this.pendingEvents.values());
+        this.pendingEvents.clear();
+        this.debounceTimer = null;
+        // Append to the undrained buffer so polling consumers can pick them up.
+        // Cap at 10,000 entries to prevent unbounded memory growth when idle.
+        this.undrainedChanges.push(...events);
+        if (this.undrainedChanges.length > 10_000) {
+            this.undrainedChanges = this.undrainedChanges.slice(-5_000);
+        }
+        this.emit('changes', events);
+    }
+    // -------------------------------------------------------- error handler --
+    /** Centralised error handler — emits 'error' but never throws. */
+    handleError(error) {
+        // Locked / inaccessible file warnings are common on Windows — demote
+        // them to non-fatal.
+        const isTransient = error.code === 'EPERM' ||
+            error.code === 'EBUSY' ||
+            error.code === 'EACCES';
+        if (isTransient) {
+            // Silently swallow transient FS errors; nothing actionable.
+            return;
+        }
+        this.emit('error', error);
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/change-tracker/watcher.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * AI Mind Map — CLI Interface
+ *
+ * Full command-line interface inspired by codebase-memory-mcp's CLI mode.
+ * Parses process.argv manually (no external CLI library). Each command
+ * initialises only the components it needs — no full MCP server boot for
+ * simple queries.
+ *
+ * Usage:
+ *   ai-mind-map <command> [options]
+ *
+ * @module cli
+ */
+/**
+ * Main CLI entry point. Parses arguments and dispatches to the
+ * appropriate command handler.
+ */
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AA49BH;;;GAGG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2FvE"}