memgrid 0.5.0

package/dist/store/file-store.d.ts

@@ -0,0 +1,62 @@
+import type { MemoryUnit, MemoryGrid, MemoryUnitType } from '../shared/types.js';
+export interface ListFilter {
+    type?: MemoryUnitType;
+    includeArchived?: boolean;
+}
+/**
+ * File-based store with in-memory index cache.
+ *
+ * Units stored as JSON (not YAML) for maximum read/write performance.
+ * First init/load: all JSON files read → JSON.parse → cached in Map.
+ * After that: listUnits()/getUnit() are O(1) memory lookups.
+ * saveUnit() writes to disk + updates cache instantly.
+ */
+export declare class FileStore {
+    private projectRoot;
+    private cache;
+    private archiveCache;
+    private gridCache;
+    private loaded;
+    private dirtyUsage;
+    constructor(projectRoot: string);
+    get gridDir(): string;
+    get unitsDir(): string;
+    get archiveDir(): string;
+    get meshPath(): string;
+    unitPath(id: string): string;
+    archivePath(id: string): string;
+    ensureDirs(): void;
+    /**
+     * Load all JSON unit files into memory cache.
+     * Supports both .json (new) and .yaml (legacy) for migration.
+     */
+    load(): {
+        total: number;
+        loadedMs: number;
+    };
+    reload(): void;
+    listUnits(filter?: ListFilter): Promise<MemoryUnit[]>;
+    getUnit(id: string): MemoryUnit | null;
+    saveUnit(unit: MemoryUnit): void;
+    deleteUnit(id: string): void;
+    archiveUnit(id: string): void;
+    touch(id: string): void;
+    flushUsage(): {
+        synced: number;
+    };
+    saveUnits(units: MemoryUnit[]): {
+        written: number;
+        skipped: number;
+    };
+    getGrid(): MemoryGrid | null;
+    saveGrid(grid: MemoryGrid): void;
+    getStats(): {
+        totalUnits: number;
+        activeUnits: number;
+        archivedUnits: number;
+        typeDistribution: Record<string, number>;
+    };
+    private ensureLoaded;
+    private unitsEqual;
+}
+//# sourceMappingURL=file-store.d.ts.map

package/dist/store/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/store/file-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOjF,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAA0B;gBAEhC,WAAW,EAAE,MAAM;IAM/B,IAAI,OAAO,IAAI,MAAM,CAAkD;IACvE,IAAI,QAAQ,IAAI,MAAM,CAA+C;IACrE,IAAI,UAAU,IAAI,MAAM,CAAiD;IACzE,IAAI,QAAQ,IAAI,MAAM,CAA+C;IAErE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI5B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAS/B,UAAU,IAAI,IAAI;IAKlB;;;OAGG;IACH,IAAI,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAkD3C,MAAM,IAAI,IAAI;IAIR,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAiB3D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAOtC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAehC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ5B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAmB7B,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASvB,UAAU,IAAI;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IAkBhC,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAmBpE,OAAO,IAAI,UAAU,GAAG,IAAI;IAO5B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAOhC,QAAQ;;;;;;IAkBR,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,UAAU;CASnB"}

package/dist/store/file-store.js

@@ -0,0 +1,241 @@
+import * as fs from 'fs';
+import * as path from 'path';
+const GRID_DIR = '.claude/memory-grid';
+const UNITS_DIR = 'units';
+const ARCHIVE_DIR = 'archive';
+const MESH_FILE = 'mesh.json';
+/**
+ * File-based store with in-memory index cache.
+ *
+ * Units stored as JSON (not YAML) for maximum read/write performance.
+ * First init/load: all JSON files read → JSON.parse → cached in Map.
+ * After that: listUnits()/getUnit() are O(1) memory lookups.
+ * saveUnit() writes to disk + updates cache instantly.
+ */
+export class FileStore {
+    projectRoot;
+    // In-memory cache
+    cache = new Map();
+    archiveCache = new Map();
+    gridCache = null;
+    loaded = false;
+    dirtyUsage = new Set();
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    // ===== Path helpers =====
+    get gridDir() { return path.join(this.projectRoot, GRID_DIR); }
+    get unitsDir() { return path.join(this.gridDir, UNITS_DIR); }
+    get archiveDir() { return path.join(this.gridDir, ARCHIVE_DIR); }
+    get meshPath() { return path.join(this.gridDir, MESH_FILE); }
+    unitPath(id) {
+        return path.join(this.unitsDir, `${id}.json`);
+    }
+    archivePath(id) {
+        const year = new Date().getFullYear();
+        const dir = path.join(this.archiveDir, String(year));
+        fs.mkdirSync(dir, { recursive: true });
+        return path.join(dir, `${id}.json`);
+    }
+    // ===== Initialization =====
+    ensureDirs() {
+        fs.mkdirSync(this.unitsDir, { recursive: true });
+        fs.mkdirSync(this.archiveDir, { recursive: true });
+    }
+    /**
+     * Load all JSON unit files into memory cache.
+     * Supports both .json (new) and .yaml (legacy) for migration.
+     */
+    load() {
+        const start = Date.now();
+        this.ensureDirs();
+        const parseUnit = (filePath) => {
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                return JSON.parse(content);
+            }
+            catch {
+                return null;
+            }
+        };
+        // Load active units
+        this.cache.clear();
+        if (fs.existsSync(this.unitsDir)) {
+            for (const file of fs.readdirSync(this.unitsDir)) {
+                if (!file.endsWith('.json') && !file.endsWith('.yaml'))
+                    continue;
+                const unit = parseUnit(path.join(this.unitsDir, file));
+                if (unit)
+                    this.cache.set(unit.id, unit);
+            }
+        }
+        // Load archived units
+        this.archiveCache.clear();
+        if (fs.existsSync(this.archiveDir)) {
+            const walkArchive = (dir) => {
+                if (!fs.existsSync(dir))
+                    return;
+                for (const entry of fs.readdirSync(dir)) {
+                    const full = path.join(dir, entry);
+                    if (fs.statSync(full).isDirectory()) {
+                        walkArchive(full);
+                    }
+                    else if (entry.endsWith('.json') || entry.endsWith('.yaml')) {
+                        const unit = parseUnit(full);
+                        if (unit)
+                            this.archiveCache.set(unit.id, unit);
+                    }
+                }
+            };
+            walkArchive(this.archiveDir);
+        }
+        this.loaded = true;
+        this.dirtyUsage.clear();
+        return {
+            total: this.cache.size + this.archiveCache.size,
+            loadedMs: Date.now() - start,
+        };
+    }
+    reload() { this.load(); }
+    // ===== Unit read (from cache) =====
+    async listUnits(filter) {
+        this.ensureLoaded();
+        const results = [];
+        for (const unit of this.cache.values()) {
+            if (!filter?.type || unit.type === filter.type)
+                results.push(unit);
+        }
+        if (filter?.includeArchived) {
+            for (const unit of this.archiveCache.values()) {
+                if (!filter?.type || unit.type === filter.type)
+                    results.push(unit);
+            }
+        }
+        return results;
+    }
+    getUnit(id) {
+        this.ensureLoaded();
+        return this.cache.get(id) || this.archiveCache.get(id) || null;
+    }
+    // ===== Unit write (JSON → disk + cache) =====
+    saveUnit(unit) {
+        this.ensureLoaded();
+        const filePath = this.unitPath(unit.id);
+        const jsonStr = JSON.stringify(unit, null, 2);
+        fs.writeFileSync(filePath, jsonStr, 'utf-8');
+        // Update cache
+        if (unit.meta.status === 'archived') {
+            this.cache.delete(unit.id);
+            this.archiveCache.set(unit.id, unit);
+        }
+        else {
+            this.cache.set(unit.id, unit);
+        }
+    }
+    deleteUnit(id) {
+        this.ensureLoaded();
+        const filePath = this.unitPath(id);
+        if (fs.existsSync(filePath))
+            fs.unlinkSync(filePath);
+        this.cache.delete(id);
+        this.archiveCache.delete(id);
+    }
+    archiveUnit(id) {
+        this.ensureLoaded();
+        const unit = this.cache.get(id);
+        if (!unit)
+            return;
+        const fromPath = this.unitPath(id);
+        const toPath = this.archivePath(id);
+        unit.meta.status = 'archived';
+        unit.meta.updated = new Date().toISOString();
+        const jsonStr = JSON.stringify(unit, null, 2);
+        fs.writeFileSync(toPath, jsonStr, 'utf-8');
+        if (fs.existsSync(fromPath))
+            fs.unlinkSync(fromPath);
+        this.cache.delete(id);
+        this.archiveCache.set(id, unit);
+    }
+    touch(id) {
+        this.ensureLoaded();
+        const unit = this.cache.get(id) || this.archiveCache.get(id);
+        if (unit) {
+            unit.meta.usage_count++;
+            this.dirtyUsage.add(id);
+        }
+    }
+    flushUsage() {
+        let synced = 0;
+        for (const id of this.dirtyUsage) {
+            const unit = this.cache.get(id) || this.archiveCache.get(id);
+            if (unit) {
+                const filePath = unit.meta.status === 'archived'
+                    ? this.archivePath(id)
+                    : this.unitPath(id);
+                if (fs.existsSync(filePath)) {
+                    fs.writeFileSync(filePath, JSON.stringify(unit, null, 2), 'utf-8');
+                    synced++;
+                }
+            }
+        }
+        this.dirtyUsage.clear();
+        return { synced };
+    }
+    saveUnits(units) {
+        this.ensureLoaded();
+        let written = 0, skipped = 0;
+        for (const unit of units) {
+            const existing = this.cache.get(unit.id);
+            if (existing && this.unitsEqual(existing, unit)) {
+                skipped++;
+            }
+            else {
+                this.saveUnit(unit);
+                written++;
+            }
+        }
+        return { written, skipped };
+    }
+    // ===== Grid =====
+    getGrid() {
+        if (this.gridCache)
+            return this.gridCache;
+        if (!fs.existsSync(this.meshPath))
+            return null;
+        this.gridCache = JSON.parse(fs.readFileSync(this.meshPath, 'utf-8'));
+        return this.gridCache;
+    }
+    saveGrid(grid) {
+        this.gridCache = grid;
+        fs.writeFileSync(this.meshPath, JSON.stringify(grid, null, 2), 'utf-8');
+    }
+    // ===== Stats =====
+    getStats() {
+        this.ensureLoaded();
+        const typeDistribution = {};
+        let active = 0;
+        for (const unit of this.cache.values()) {
+            typeDistribution[unit.type] = (typeDistribution[unit.type] || 0) + 1;
+            if (unit.meta.status === 'active')
+                active++;
+        }
+        return {
+            totalUnits: this.cache.size,
+            activeUnits: active,
+            archivedUnits: this.archiveCache.size,
+            typeDistribution,
+        };
+    }
+    ensureLoaded() {
+        if (!this.loaded)
+            this.load();
+    }
+    unitsEqual(a, b) {
+        return (a.summary === b.summary &&
+            a.meta.status === b.meta.status &&
+            a.meta.updated === b.meta.updated &&
+            a.associations.length === b.associations.length &&
+            a.content.description === b.content.description);
+    }
+}
+//# sourceMappingURL=file-store.js.map

package/dist/store/file-store.js.map

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

package/dist/store/index.d.ts

@@ -0,0 +1,3 @@
+export { FileStore } from './file-store.js';
+export type { ListFilter } from './file-store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/store/index.js

@@ -0,0 +1,2 @@
+export { FileStore } from './file-store.js';
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/sync/index.d.ts

@@ -0,0 +1,56 @@
+import type { SyncResult, SyncOptions } from '../shared/types.js';
+import type { FileStore } from '../store/file-store.js';
+import type { Scanner } from '../scanner/scanner.js';
+export declare class SyncEngine {
+    private store;
+    private scanner;
+    private projectRoot;
+    constructor(store: FileStore, scanner: Scanner, projectRoot: string);
+    /**
+     * Incremental sync: detect changed files → re-scan only those → repair associations.
+     *
+     * Phases:
+     * 1. Hash compare — compute current hashes vs fileSnapshot
+     * 2. Re-scan changed files → add/update units
+     * 3. Remove units from deleted files → mark stale
+     * 4. Repair broken associations via fuzzy match
+     * 5. Write updated mesh.json and fileSnapshot
+     */
+    sync(options: SyncOptions): Promise<SyncResult>;
+    /**
+     * Partial scan — only re-scan changed TypeScript/markdown files.
+     * Uses ts-morph for .ts files, inline parsing for .md / config.
+     */
+    private scanChangedFiles;
+    /**
+     * Fuzzy-match a newly scanned unit against an existing stale unit.
+     * Returns the matching stale unit or null.
+     *
+     * Matching signals:
+     * 1. Same source file + high signature overlap (jaccard ≥ threshold)
+     * 2. Same source file + high summary similarity (dice ≥ threshold)
+     * 3. Same unit id (method was renamed but we kept same id pattern)
+     */
+    private fuzzyMatchUnit;
+    /**
+     * Repair broken associations across all units.
+     *
+     * For each association whose target unit is stale/archived/missing:
+     * 1. Try fuzzy match against active units by signature
+     * 2. If match found → repair the link
+     * 3. If no match → reduce weight, mark for eventual removal
+     */
+    private repairAssociations;
+    /**
+     * Find a replacement unit for a broken association.
+     * Strategy:
+     * 1. Search signature index for the original unit's summary keywords
+     * 2. Fuzzy match summaries against active units
+     * 3. Return best match above threshold
+     */
+    private findReplacementAssociation;
+    private updateGrid;
+    private sanitizeId;
+    private extractJsDoc;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAwC,UAAU,EAAE,WAAW,EAAe,MAAM,oBAAoB,CAAC;AACrH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAgErD,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM;IAMnE;;;;;;;;;OASG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAiLrD;;;OAGG;YACW,gBAAgB;IAwL9B;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAsDtB;;;;;;;OAOG;YACW,kBAAkB;IAwDhC;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IA+BlC,OAAO,CAAC,UAAU;IA+BlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;CAOrB"}