helixmind 0.5.4

package/dist/spiral/injection.js.map

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

package/dist/spiral/relevance.d.ts

@@ -0,0 +1,37 @@
+import type { ContextNode, ContextType, SpiralLevel } from '../types.js';
+/**
+ * Per-level weights for relevance scoring.
+ * Higher levels (Focus) weight semantic similarity more,
+ * Lower levels (Archive) weight recency less.
+ */
+export declare const LEVEL_WEIGHTS: Record<SpiralLevel, {
+    semantic: number;
+    recency: number;
+    connection: number;
+    typeBoost: number;
+}>;
+/**
+ * Computes relevance score for a node given a query context.
+ * Uses per-level weights for differentiated scoring.
+ */
+export declare function computeRelevance(semanticSimilarity: number, node: ContextNode, connectedInResult: number, query: string): number;
+/**
+ * Recency score using exponential decay.
+ * Half-life ~14 hours (λ = 0.05).
+ */
+export declare function computeRecency(accessedAt: number, now?: number): number;
+/**
+ * Connection score: nodes connected to other relevant nodes get boosted.
+ * Normalized to [0, 1] with saturation at 5 connections.
+ */
+export declare function computeConnectionScore(connectedNodesInResult: number): number;
+/**
+ * Type boost: certain node types get boosted based on query keywords.
+ */
+export declare function computeTypeBoost(nodeType: ContextType, query: string): number;
+/**
+ * Determines which spiral level a node should be on based on its relevance score.
+ * L1 Focus >= l1Min, L2 Active >= l2Min, L3 Reference >= l3Min, L4 Archive >= l4Min, L5 Deep Archive < l4Min
+ */
+export declare function determineLevel(relevanceScore: number, l1Min?: number, l2Min?: number, l3Min?: number, l4Min?: number): SpiralLevel;
+//# sourceMappingURL=relevance.d.ts.map

package/dist/spiral/relevance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relevance.d.ts","sourceRoot":"","sources":["../../src/spiral/relevance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAMzE;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAM3H,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,kBAAkB,EAAE,MAAM,EAC1B,IAAI,EAAE,WAAW,EACjB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,sBAAsB,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAa7E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,KAAK,SAAM,EACX,KAAK,SAAM,EACX,KAAK,SAAM,EACX,KAAK,SAAM,GACV,WAAW,CAMb"}

package/dist/spiral/relevance.js

@@ -0,0 +1,75 @@
+const ERROR_KEYWORDS = ['error', 'exception', 'bug', 'fail', 'crash', 'TypeError', 'ReferenceError', 'SyntaxError'];
+const ARCH_KEYWORDS = ['architecture', 'design', 'decision', 'pattern', 'structure', 'refactor'];
+const CODE_KEYWORDS = ['function', 'class', 'module', 'import', 'implement', 'code', 'method'];
+/**
+ * Per-level weights for relevance scoring.
+ * Higher levels (Focus) weight semantic similarity more,
+ * Lower levels (Archive) weight recency less.
+ */
+export const LEVEL_WEIGHTS = {
+    1: { semantic: 0.45, recency: 0.30, connection: 0.15, typeBoost: 0.10 },
+    2: { semantic: 0.40, recency: 0.25, connection: 0.20, typeBoost: 0.15 },
+    3: { semantic: 0.35, recency: 0.20, connection: 0.25, typeBoost: 0.20 },
+    4: { semantic: 0.30, recency: 0.15, connection: 0.30, typeBoost: 0.25 },
+    5: { semantic: 0.25, recency: 0.10, connection: 0.35, typeBoost: 0.30 },
+};
+/**
+ * Computes relevance score for a node given a query context.
+ * Uses per-level weights for differentiated scoring.
+ */
+export function computeRelevance(semanticSimilarity, node, connectedInResult, query) {
+    const semantic = Math.max(0, Math.min(1, semanticSimilarity));
+    const recency = computeRecency(node.accessed_at);
+    const connection = computeConnectionScore(connectedInResult);
+    const typeBoost = computeTypeBoost(node.type, query);
+    const w = LEVEL_WEIGHTS[node.level] ?? LEVEL_WEIGHTS[1];
+    return semantic * w.semantic + recency * w.recency + connection * w.connection + typeBoost * w.typeBoost;
+}
+/**
+ * Recency score using exponential decay.
+ * Half-life ~14 hours (λ = 0.05).
+ */
+export function computeRecency(accessedAt, now) {
+    const currentTime = now ?? Date.now();
+    const hoursSinceAccess = (currentTime - accessedAt) / (1000 * 60 * 60);
+    return Math.exp(-0.05 * Math.max(0, hoursSinceAccess));
+}
+/**
+ * Connection score: nodes connected to other relevant nodes get boosted.
+ * Normalized to [0, 1] with saturation at 5 connections.
+ */
+export function computeConnectionScore(connectedNodesInResult) {
+    return Math.min(1.0, connectedNodesInResult / 5);
+}
+/**
+ * Type boost: certain node types get boosted based on query keywords.
+ */
+export function computeTypeBoost(nodeType, query) {
+    const lowerQuery = query.toLowerCase();
+    if (nodeType === 'error' && ERROR_KEYWORDS.some(kw => lowerQuery.includes(kw.toLowerCase()))) {
+        return 1.0;
+    }
+    if ((nodeType === 'architecture' || nodeType === 'decision') && ARCH_KEYWORDS.some(kw => lowerQuery.includes(kw))) {
+        return 1.0;
+    }
+    if ((nodeType === 'code' || nodeType === 'pattern') && CODE_KEYWORDS.some(kw => lowerQuery.includes(kw))) {
+        return 1.0;
+    }
+    return 0.0;
+}
+/**
+ * Determines which spiral level a node should be on based on its relevance score.
+ * L1 Focus >= l1Min, L2 Active >= l2Min, L3 Reference >= l3Min, L4 Archive >= l4Min, L5 Deep Archive < l4Min
+ */
+export function determineLevel(relevanceScore, l1Min = 0.7, l2Min = 0.5, l3Min = 0.3, l4Min = 0.1) {
+    if (relevanceScore >= l1Min)
+        return 1;
+    if (relevanceScore >= l2Min)
+        return 2;
+    if (relevanceScore >= l3Min)
+        return 3;
+    if (relevanceScore >= l4Min)
+        return 4;
+    return 5;
+}
+//# sourceMappingURL=relevance.js.map

package/dist/spiral/relevance.js.map

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

package/dist/storage/database.d.ts

@@ -0,0 +1,11 @@
+import BetterSqlite3 from 'better-sqlite3';
+export declare class Database {
+    readonly raw: BetterSqlite3.Database;
+    readonly hasVecExtension: boolean;
+    private closed;
+    constructor(dataDir: string);
+    private tryLoadVecExtension;
+    private migrate;
+    close(): void;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/storage/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/storage/database.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAgD3C,qBAAa,QAAQ;IACnB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,QAAQ,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM;IA0B3B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,OAAO;IAmFf,KAAK,IAAI,IAAI;CAYd"}

package/dist/storage/database.js

@@ -0,0 +1,169 @@
+import BetterSqlite3 from 'better-sqlite3';
+import { join } from 'node:path';
+import { mkdirSync } from 'node:fs';
+import { logger } from '../utils/logger.js';
+// Tables first — indexes created AFTER migration (content_hash may not exist yet)
+const SCHEMA_TABLES = `
+CREATE TABLE IF NOT EXISTS nodes (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  content TEXT NOT NULL,
+  content_hash TEXT,
+  summary TEXT,
+  level INTEGER NOT NULL DEFAULT 1 CHECK(level IN (1, 2, 3, 4, 5)),
+  relevance_score REAL NOT NULL DEFAULT 1.0,
+  token_count INTEGER NOT NULL DEFAULT 0,
+  metadata TEXT NOT NULL DEFAULT '{}',
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  accessed_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS edges (
+  id TEXT PRIMARY KEY,
+  source_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+  target_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+  relation_type TEXT NOT NULL,
+  weight REAL NOT NULL DEFAULT 1.0,
+  metadata TEXT NOT NULL DEFAULT '{}',
+  created_at INTEGER NOT NULL,
+  UNIQUE(source_id, target_id, relation_type)
+);
+
+CREATE TABLE IF NOT EXISTS schema_version (version INTEGER NOT NULL);
+`;
+const SCHEMA_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_nodes_type ON nodes(type);
+CREATE INDEX IF NOT EXISTS idx_nodes_level ON nodes(level);
+CREATE INDEX IF NOT EXISTS idx_nodes_relevance ON nodes(relevance_score);
+CREATE INDEX IF NOT EXISTS idx_nodes_updated ON nodes(updated_at);
+CREATE INDEX IF NOT EXISTS idx_nodes_accessed ON nodes(accessed_at);
+CREATE INDEX IF NOT EXISTS idx_nodes_content_hash ON nodes(content_hash);
+CREATE INDEX IF NOT EXISTS idx_edges_source ON edges(source_id);
+CREATE INDEX IF NOT EXISTS idx_edges_target ON edges(target_id);
+CREATE INDEX IF NOT EXISTS idx_edges_type ON edges(relation_type);
+`;
+export class Database {
+    raw;
+    hasVecExtension;
+    closed = false;
+    constructor(dataDir) {
+        mkdirSync(dataDir, { recursive: true });
+        const dbPath = join(dataDir, 'spiral.db');
+        this.raw = new BetterSqlite3(dbPath);
+        // Performance pragmas
+        this.raw.pragma('journal_mode = WAL');
+        this.raw.pragma('foreign_keys = ON');
+        this.raw.pragma('synchronous = NORMAL');
+        // Try to load sqlite-vec extension
+        this.hasVecExtension = this.tryLoadVecExtension();
+        // Create tables (without indexes — old DBs may lack content_hash column)
+        this.raw.exec(SCHEMA_TABLES);
+        // Run migrations for existing databases (adds content_hash etc.)
+        this.migrate();
+        // Create indexes AFTER migration (content_hash column now exists)
+        this.raw.exec(SCHEMA_INDEXES);
+        logger.debug(`Database opened at ${dbPath} (vec: ${this.hasVecExtension})`);
+    }
+    tryLoadVecExtension() {
+        try {
+            // Dynamic import to avoid crash if sqlite-vec is not installed
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const sqliteVec = require('sqlite-vec');
+            sqliteVec.load(this.raw);
+            logger.info('sqlite-vec extension loaded');
+            return true;
+        }
+        catch {
+            logger.info('sqlite-vec not available, using JS fallback for vector search');
+            return false;
+        }
+    }
+    migrate() {
+        const versionRow = this.raw.prepare("SELECT version FROM schema_version LIMIT 1").get();
+        const currentVersion = versionRow?.version ?? 0;
+        if (currentVersion < 3) {
+            const nodesSql = this.raw.prepare("SELECT sql FROM sqlite_master WHERE type='table' AND name='nodes'").get()?.sql ?? '';
+            // Needs migration if: has old type CHECK, or has 3-level CHECK constraint
+            const needsMigration = nodesSql.includes("CHECK(type IN") ||
+                (nodesSql.includes("CHECK(level IN") && !nodesSql.includes('4, 5'));
+            if (needsMigration) {
+                this.raw.exec('PRAGMA foreign_keys = OFF');
+                this.raw.exec('BEGIN TRANSACTION');
+                try {
+                    this.raw.exec(`
+            ALTER TABLE nodes RENAME TO nodes_old;
+            CREATE TABLE nodes (
+              id TEXT PRIMARY KEY, type TEXT NOT NULL, content TEXT NOT NULL,
+              content_hash TEXT,
+              summary TEXT, level INTEGER NOT NULL DEFAULT 1 CHECK(level IN (1, 2, 3, 4, 5)),
+              relevance_score REAL NOT NULL DEFAULT 1.0,
+              token_count INTEGER NOT NULL DEFAULT 0, metadata TEXT NOT NULL DEFAULT '{}',
+              created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL, accessed_at INTEGER NOT NULL
+            );
+            INSERT INTO nodes (id, type, content, summary, level, relevance_score, token_count, metadata, created_at, updated_at, accessed_at)
+              SELECT id, type, content, summary, level, relevance_score, token_count, metadata, created_at, updated_at, accessed_at FROM nodes_old;
+            DROP TABLE nodes_old;
+
+            ALTER TABLE edges RENAME TO edges_old;
+            CREATE TABLE edges (
+              id TEXT PRIMARY KEY,
+              source_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+              target_id TEXT NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+              relation_type TEXT NOT NULL, weight REAL NOT NULL DEFAULT 1.0,
+              metadata TEXT NOT NULL DEFAULT '{}', created_at INTEGER NOT NULL,
+              UNIQUE(source_id, target_id, relation_type)
+            );
+            INSERT INTO edges SELECT * FROM edges_old;
+            DROP TABLE edges_old;
+
+            CREATE INDEX IF NOT EXISTS idx_nodes_type ON nodes(type);
+            CREATE INDEX IF NOT EXISTS idx_nodes_level ON nodes(level);
+            CREATE INDEX IF NOT EXISTS idx_nodes_relevance ON nodes(relevance_score);
+            CREATE INDEX IF NOT EXISTS idx_nodes_updated ON nodes(updated_at);
+            CREATE INDEX IF NOT EXISTS idx_nodes_accessed ON nodes(accessed_at);
+            CREATE INDEX IF NOT EXISTS idx_nodes_content_hash ON nodes(content_hash);
+            CREATE INDEX IF NOT EXISTS idx_edges_source ON edges(source_id);
+            CREATE INDEX IF NOT EXISTS idx_edges_target ON edges(target_id);
+            CREATE INDEX IF NOT EXISTS idx_edges_type ON edges(relation_type);
+          `);
+                    this.raw.exec('COMMIT');
+                }
+                catch (err) {
+                    this.raw.exec('ROLLBACK');
+                    logger.warn(`Migration failed: ${err}`);
+                }
+                this.raw.exec('PRAGMA foreign_keys = ON');
+            }
+            // Set version to 4 (includes content_hash)
+            this.raw.exec('DELETE FROM schema_version');
+            this.raw.prepare('INSERT INTO schema_version (version) VALUES (?)').run(4);
+        }
+        // Migration v3 → v4: add content_hash column for deduplication
+        if (currentVersion === 3) {
+            try {
+                this.raw.exec('ALTER TABLE nodes ADD COLUMN content_hash TEXT');
+                this.raw.exec('CREATE INDEX IF NOT EXISTS idx_nodes_content_hash ON nodes(content_hash)');
+            }
+            catch {
+                // Column may already exist
+            }
+            this.raw.exec('DELETE FROM schema_version');
+            this.raw.prepare('INSERT INTO schema_version (version) VALUES (?)').run(4);
+        }
+    }
+    close() {
+        if (!this.closed) {
+            // Checkpoint WAL before closing to ensure data durability and clean state for backups/exports
+            try {
+                this.raw.pragma('wal_checkpoint(TRUNCATE)');
+            }
+            catch {
+                // Checkpoint may fail if DB is already locked — not fatal
+            }
+            this.raw.close();
+            this.closed = true;
+        }
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/storage/database.js.map

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

package/dist/storage/edges.d.ts

@@ -0,0 +1,30 @@
+import type { Database } from './database.js';
+import type { Edge, RelationType } from '../types.js';
+interface CreateEdgeInput {
+    source_id: string;
+    target_id: string;
+    relation_type: RelationType;
+    weight?: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class EdgeStore {
+    private db;
+    constructor(db: Database);
+    create(input: CreateEdgeInput): Edge;
+    getBySource(sourceId: string): Edge[];
+    getByTarget(targetId: string): Edge[];
+    getConnected(nodeId: string): Edge[];
+    /**
+     * Get all node IDs connected to a given node (1-hop neighbors).
+     */
+    getConnectedNodeIds(nodeId: string): string[];
+    /**
+     * Batch-fetch connected node IDs for multiple nodes in a single SQL query.
+     * Eliminates N+1 query pattern in the injection engine.
+     */
+    getConnectedNodeIdsForMany(nodeIds: string[]): Map<string, string[]>;
+    count(): number;
+    delete(id: string): void;
+}
+export {};
+//# sourceMappingURL=edges.d.ts.map

package/dist/storage/edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.d.ts","sourceRoot":"","sources":["../../src/storage/edges.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtD,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAgCD,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAW;gBAET,EAAE,EAAE,QAAQ;IAIxB,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IA4BpC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IAKrC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IAKrC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE;IAKpC;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAU7C;;;OAGG;IACH,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAiBpE,KAAK,IAAI,MAAM;IAKf,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGzB"}

package/dist/storage/edges.js

@@ -0,0 +1,98 @@
+import { randomUUID } from 'node:crypto';
+function safeParseJson(raw, fallback = {}) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+function rowToEdge(row) {
+    return {
+        id: row.id,
+        source_id: row.source_id,
+        target_id: row.target_id,
+        relation_type: row.relation_type,
+        weight: row.weight,
+        metadata: safeParseJson(row.metadata),
+        created_at: row.created_at,
+    };
+}
+export class EdgeStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(input) {
+        const id = randomUUID();
+        const now = Date.now();
+        this.db.raw.prepare(`
+      INSERT INTO edges (id, source_id, target_id, relation_type, weight, metadata, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(id, input.source_id, input.target_id, input.relation_type, input.weight ?? 1.0, JSON.stringify(input.metadata ?? {}), now);
+        return {
+            id,
+            source_id: input.source_id,
+            target_id: input.target_id,
+            relation_type: input.relation_type,
+            weight: input.weight ?? 1.0,
+            metadata: input.metadata ?? {},
+            created_at: now,
+        };
+    }
+    getBySource(sourceId) {
+        const rows = this.db.raw.prepare('SELECT * FROM edges WHERE source_id = ?').all(sourceId);
+        return rows.map(rowToEdge);
+    }
+    getByTarget(targetId) {
+        const rows = this.db.raw.prepare('SELECT * FROM edges WHERE target_id = ?').all(targetId);
+        return rows.map(rowToEdge);
+    }
+    getConnected(nodeId) {
+        const rows = this.db.raw.prepare('SELECT * FROM edges WHERE source_id = ? OR target_id = ?').all(nodeId, nodeId);
+        return rows.map(rowToEdge);
+    }
+    /**
+     * Get all node IDs connected to a given node (1-hop neighbors).
+     */
+    getConnectedNodeIds(nodeId) {
+        const edges = this.getConnected(nodeId);
+        const ids = new Set();
+        for (const edge of edges) {
+            if (edge.source_id !== nodeId)
+                ids.add(edge.source_id);
+            if (edge.target_id !== nodeId)
+                ids.add(edge.target_id);
+        }
+        return Array.from(ids);
+    }
+    /**
+     * Batch-fetch connected node IDs for multiple nodes in a single SQL query.
+     * Eliminates N+1 query pattern in the injection engine.
+     */
+    getConnectedNodeIdsForMany(nodeIds) {
+        if (nodeIds.length === 0)
+            return new Map();
+        const placeholders = nodeIds.map(() => '?').join(',');
+        const rows = this.db.raw.prepare(`SELECT source_id, target_id FROM edges
+       WHERE source_id IN (${placeholders}) OR target_id IN (${placeholders})`).all(...nodeIds, ...nodeIds);
+        const map = new Map();
+        for (const id of nodeIds)
+            map.set(id, []);
+        for (const row of rows) {
+            if (map.has(row.source_id))
+                map.get(row.source_id).push(row.target_id);
+            if (map.has(row.target_id))
+                map.get(row.target_id).push(row.source_id);
+        }
+        return map;
+    }
+    count() {
+        const row = this.db.raw.prepare('SELECT COUNT(*) as cnt FROM edges').get();
+        return row.cnt;
+    }
+    delete(id) {
+        this.db.raw.prepare('DELETE FROM edges WHERE id = ?').run(id);
+    }
+}
+//# sourceMappingURL=edges.js.map

package/dist/storage/edges.js.map

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

package/dist/storage/nodes.d.ts

@@ -0,0 +1,60 @@
+import type { Database } from './database.js';
+import type { ContextNode, ContextType, SpiralLevel, NodeMetadata } from '../types.js';
+interface CreateNodeInput {
+    type: ContextType;
+    content: string;
+    metadata: NodeMetadata;
+    summary?: string;
+    level?: SpiralLevel;
+    relevance_score?: number;
+}
+export declare class NodeStore {
+    private db;
+    constructor(db: Database);
+    create(input: CreateNodeInput & {
+        content_hash?: string;
+    }): ContextNode;
+    /**
+     * Find a node by its content hash (for deduplication).
+     * Returns null if no matching node exists.
+     */
+    findByContentHash(hash: string): ContextNode | null;
+    /**
+     * Update an existing node's content, metadata, and access time (for dedup refresh).
+     */
+    refreshNode(id: string, content: string, metadata: NodeMetadata, contentHash: string): void;
+    /** Check if a node exists without updating accessed_at (for internal lookups) */
+    exists(id: string): boolean;
+    getById(id: string): ContextNode | null;
+    getByLevel(level: SpiralLevel): ContextNode[];
+    getAll(): ContextNode[];
+    /** Return IDs of the most recently accessed nodes (bounded). */
+    getRecentIds(limit: number): string[];
+    getByIds(ids: string[]): ContextNode[];
+    updateLevel(id: string, level: SpiralLevel): void;
+    updateRelevance(id: string, score: number): void;
+    updateSummary(id: string, summary: string): void;
+    count(): number;
+    countByLevel(): Record<SpiralLevel, number>;
+    /** Count web knowledge nodes (L2 nodes with [Web Knowledge: prefix) */
+    countWebKnowledge(): number;
+    getOldestAndNewest(): {
+        oldest: number | null;
+        newest: number | null;
+    };
+    delete(id: string): void;
+    /**
+     * Get nodes that need decay (accessed more than `hours` ago).
+     */
+    getStaleNodes(hoursThreshold: number): ContextNode[];
+    /**
+     * Bulk update relevance scores. Used by decay function.
+     */
+    bulkUpdateRelevance(updates: Array<{
+        id: string;
+        score: number;
+        level: SpiralLevel;
+    }>): void;
+}
+export {};
+//# sourceMappingURL=nodes.d.ts.map

package/dist/storage/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/storage/nodes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGvF,UAAU,eAAe;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAyCD,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAW;gBAET,EAAE,EAAE,QAAQ;IAIxB,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAsCvE;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAOnD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAS3F,iFAAiF;IACjF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK3B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAWvC,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE;IAK7C,MAAM,IAAI,WAAW,EAAE;IAKvB,gEAAgE;IAChE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAOrC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE;IAOtC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAIjD,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD,KAAK,IAAI,MAAM;IAKf,YAAY,IAAI,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC;IAS3C,uEAAuE;IACvE,iBAAiB,IAAI,MAAM;IAK3B,kBAAkB,IAAI;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAKtE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW,EAAE;IAMpD;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC,GAAG,IAAI;CAU7F"}