helixmind 0.1.0

package/dist/spiral/engine.js

@@ -0,0 +1,271 @@
+import { Database } from '../storage/database.js';
+import { NodeStore } from '../storage/nodes.js';
+import { EdgeStore } from '../storage/edges.js';
+import { VectorStore } from '../storage/vectors.js';
+import { EmbeddingService } from './embeddings.js';
+import { InjectionEngine } from './injection.js';
+import { CompressionService } from './compression.js';
+import { logger } from '../utils/logger.js';
+import { statSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Core engine that orchestrates all spiral operations.
+ */
+export class SpiralEngine {
+    db;
+    nodes;
+    edges;
+    vectors;
+    embeddings;
+    injection;
+    compression;
+    config;
+    constructor(config) {
+        this.config = config;
+        // Initialize storage
+        this.db = new Database(config.dataDir);
+        this.nodes = new NodeStore(this.db);
+        this.edges = new EdgeStore(this.db);
+        this.vectors = new VectorStore(this.db, config.embeddingDimensions);
+        // Initialize spiral logic
+        this.embeddings = new EmbeddingService(config.model);
+        this.injection = new InjectionEngine(this.nodes, this.edges, this.vectors);
+        this.compression = new CompressionService(this.nodes, this.vectors, config.levelThresholds.l1Min, config.levelThresholds.l2Min, config.levelThresholds.l3Min, config.levelThresholds.l4Min);
+    }
+    /**
+     * Start the engine. Loads embedding model eagerly.
+     */
+    async initialize() {
+        await this.embeddings.initialize();
+        logger.info('SpiralEngine initialized');
+    }
+    /**
+     * Query context across spiral levels.
+     */
+    async query(queryText, maxTokens, levels) {
+        const budget = maxTokens ?? this.config.maxTokens;
+        const activeLevels = levels ?? [1, 2, 3, 4, 5];
+        // Generate embedding for query
+        const queryEmbedding = await this.embeddings.embed(queryText);
+        // Assemble context from all levels
+        return this.injection.assemble(queryEmbedding, queryText, budget, activeLevels);
+    }
+    /**
+     * Store new context in the spiral.
+     */
+    async store(content, type, metadata, relations) {
+        // Create the node
+        const node = this.nodes.create({
+            type,
+            content,
+            metadata: metadata ?? {},
+        });
+        // Generate and store embedding
+        const embedding = await this.embeddings.embed(content);
+        if (embedding) {
+            this.vectors.store(node.id, embedding);
+        }
+        // Create explicit relations
+        let connectionCount = 0;
+        if (relations) {
+            for (const targetId of relations) {
+                const target = this.nodes.getById(targetId);
+                if (target) {
+                    this.edges.create({
+                        source_id: node.id,
+                        target_id: targetId,
+                        relation_type: 'related_to',
+                    });
+                    connectionCount++;
+                }
+            }
+        }
+        // Auto-detect relations via similarity (if embeddings available)
+        if (embedding) {
+            const similar = this.vectors.search(embedding, 5);
+            for (const result of similar) {
+                if (result.node_id === node.id)
+                    continue;
+                if (result.distance < 0.3) { // Very similar
+                    try {
+                        this.edges.create({
+                            source_id: node.id,
+                            target_id: result.node_id,
+                            relation_type: 'related_to',
+                            weight: 1 - result.distance,
+                        });
+                        connectionCount++;
+                    }
+                    catch {
+                        // Duplicate edge, ignore
+                    }
+                }
+            }
+        }
+        logger.debug(`Stored node ${node.id} (type: ${type}, connections: ${connectionCount})`);
+        return {
+            node_id: node.id,
+            level: node.level,
+            connections: connectionCount,
+            token_count: node.token_count,
+        };
+    }
+    /**
+     * Get spiral status metrics.
+     */
+    status() {
+        const totalNodes = this.nodes.count();
+        const perLevel = this.nodes.countByLevel();
+        const totalEdges = this.edges.count();
+        const { oldest, newest } = this.nodes.getOldestAndNewest();
+        let storageSize = 0;
+        try {
+            const dbPath = join(this.config.dataDir, 'spiral.db');
+            storageSize = statSync(dbPath).size;
+        }
+        catch {
+            // File may not exist yet
+        }
+        return {
+            total_nodes: totalNodes,
+            per_level: perLevel,
+            total_edges: totalEdges,
+            storage_size_bytes: storageSize,
+            oldest_node: oldest ? new Date(oldest).toISOString() : null,
+            newest_node: newest ? new Date(newest).toISOString() : null,
+            embedding_status: this.embeddings.status,
+        };
+    }
+    /** Count web knowledge nodes (virtual L6) */
+    webKnowledgeCount() {
+        return this.nodes.countWebKnowledge();
+    }
+    /**
+     * Run compaction.
+     */
+    compact(aggressive) {
+        return this.compression.compact(aggressive);
+    }
+    /**
+     * Create a manual relation between two nodes.
+     */
+    relate(sourceId, targetId, type, weight) {
+        return this.edges.create({
+            source_id: sourceId,
+            target_id: targetId,
+            relation_type: type,
+            weight,
+        });
+    }
+    /**
+     * Export all data for visualization.
+     */
+    exportForVisualization() {
+        const allNodes = this.nodes.getAll();
+        const allEdges = [];
+        // Collect all edges
+        const seenEdgeIds = new Set();
+        for (const node of allNodes) {
+            const edges = this.edges.getConnected(node.id);
+            for (const edge of edges) {
+                if (!seenEdgeIds.has(edge.id)) {
+                    seenEdgeIds.add(edge.id);
+                    allEdges.push(edge);
+                }
+            }
+        }
+        return {
+            nodes: allNodes.map(n => ({
+                id: n.id,
+                label: buildNodeLabel(n),
+                content: (n.summary ?? n.content).slice(0, 200),
+                type: n.type,
+                level: n.level,
+                relevanceScore: n.relevance_score,
+                createdAt: new Date(n.created_at).toISOString(),
+                lastAccessed: new Date(n.accessed_at).toISOString(),
+            })),
+            edges: allEdges.map(e => ({
+                source: e.source_id,
+                target: e.target_id,
+                type: e.relation_type,
+                weight: e.weight,
+            })),
+        };
+    }
+    /**
+     * Run evolution: promote/demote nodes based on relevance scores.
+     * Preserves all nodes — nothing is deleted.
+     */
+    evolve() {
+        return this.compression.evolve();
+    }
+    /**
+     * Save state: persist conversation context and trigger evolution if needed.
+     * Called on graceful shutdown.
+     */
+    async saveState(conversationMessages) {
+        // Archive only NEW conversation messages as L1 nodes.
+        // Track the last saved index to avoid duplicates across sessions.
+        if (conversationMessages && conversationMessages.length > 0) {
+            // Only store the last few messages (avoid re-storing entire history)
+            const maxNewMessages = 10;
+            const startIdx = Math.max(0, conversationMessages.length - maxNewMessages);
+            const newMessages = conversationMessages.slice(startIdx);
+            for (const msg of newMessages) {
+                if (msg.role === 'user' || msg.role === 'assistant') {
+                    try {
+                        await this.store(msg.content, 'code', {
+                            tags: ['conversation', msg.role],
+                        });
+                    }
+                    catch {
+                        // Skip on error
+                    }
+                }
+            }
+        }
+        // Trigger evolution
+        this.compression.evolve();
+        logger.info('State saved and evolution triggered');
+    }
+    /**
+     * Import a node directly (for ZIP import). Returns store result.
+     */
+    importNode(input) {
+        const node = this.nodes.create({
+            type: input.type,
+            content: input.content,
+            metadata: input.metadata ?? {},
+            level: input.level,
+            relevance_score: input.relevanceScore,
+        });
+        return {
+            node_id: node.id,
+            level: node.level,
+            connections: 0,
+            token_count: node.token_count,
+        };
+    }
+    /**
+     * Clear all nodes and edges (for ZIP replace import).
+     */
+    clearAll() {
+        this.db.raw.exec('DELETE FROM edges');
+        this.db.raw.exec('DELETE FROM vec_nodes');
+        this.db.raw.exec('DELETE FROM nodes');
+    }
+    /**
+     * Shutdown: close database.
+     */
+    close() {
+        this.db.close();
+    }
+}
+function buildNodeLabel(node) {
+    if (node.metadata.file)
+        return node.metadata.file;
+    const firstLine = node.content.split('\n')[0];
+    return firstLine.length > 50 ? firstLine.slice(0, 47) + '...' : firstLine;
+}
+//# sourceMappingURL=engine.js.map

package/dist/spiral/engine.js.map

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

package/dist/spiral/injection.d.ts

@@ -0,0 +1,29 @@
+import type { SpiralResultNode } from '../types.js';
+import { NodeStore } from '../storage/nodes.js';
+import { EdgeStore } from '../storage/edges.js';
+import { VectorStore } from '../storage/vectors.js';
+interface InjectionResult {
+    level_1: SpiralResultNode[];
+    level_2: SpiralResultNode[];
+    level_3: SpiralResultNode[];
+    level_4: SpiralResultNode[];
+    level_5: SpiralResultNode[];
+    total_tokens: number;
+    node_count: number;
+}
+/**
+ * Proactive context injection engine.
+ * Assembles the most relevant context across all 5 spiral levels.
+ */
+export declare class InjectionEngine {
+    private nodes;
+    private edges;
+    private vectors;
+    constructor(nodes: NodeStore, edges: EdgeStore, vectors: VectorStore);
+    /**
+     * Build context for a query across all spiral levels.
+     */
+    assemble(queryEmbedding: Float32Array | null, query: string, maxTokens: number, levels: number[]): Promise<InjectionResult>;
+}
+export {};
+//# sourceMappingURL=injection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"injection.d.ts","sourceRoot":"","sources":["../../src/spiral/injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKpD,UAAU,eAAe;IACvB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAc;gBAEjB,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW;IAMpE;;OAEG;IACG,QAAQ,CACZ,cAAc,EAAE,YAAY,GAAG,IAAI,EACnC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,eAAe,CAAC;CAoK5B"}

package/dist/spiral/injection.js

@@ -0,0 +1,164 @@
+import { computeRelevance } from './relevance.js';
+import { allocateTokenBudget, estimateTokens } from '../utils/tokens.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Proactive context injection engine.
+ * Assembles the most relevant context across all 5 spiral levels.
+ */
+export class InjectionEngine {
+    nodes;
+    edges;
+    vectors;
+    constructor(nodes, edges, vectors) {
+        this.nodes = nodes;
+        this.edges = edges;
+        this.vectors = vectors;
+    }
+    /**
+     * Build context for a query across all spiral levels.
+     */
+    async assemble(queryEmbedding, query, maxTokens, levels) {
+        const budget = allocateTokenBudget(maxTokens);
+        // Step 1: Find direct matches via semantic search
+        let candidateIds = [];
+        if (queryEmbedding) {
+            const vecResults = this.vectors.search(queryEmbedding, 50);
+            candidateIds = vecResults.map(r => r.node_id);
+        }
+        // If no embedding results, fall back to loading recent nodes
+        if (candidateIds.length === 0) {
+            const allNodes = this.nodes.getAll();
+            candidateIds = allNodes.slice(0, 50).map(n => n.id);
+        }
+        // Step 2: Get full node data
+        const candidates = this.nodes.getByIds(candidateIds);
+        // Step 3: Score each candidate
+        // Build similarity lookup ONCE (not per-candidate)
+        const simMap = new Map();
+        if (queryEmbedding) {
+            const vecResults = this.vectors.search(queryEmbedding, 50);
+            for (const r of vecResults) {
+                simMap.set(r.node_id, 1 - r.distance);
+            }
+        }
+        const scored = candidates.map(node => {
+            const semanticSim = simMap.get(node.id) ?? (queryEmbedding ? 0 : 0.5);
+            const connectedIds = this.edges.getConnectedNodeIds(node.id);
+            const connectedInResult = connectedIds.filter(id => candidateIds.includes(id)).length;
+            const relevance = computeRelevance(semanticSim, node, connectedInResult, query);
+            return { node, relevance };
+        });
+        // Sort by relevance descending
+        scored.sort((a, b) => b.relevance - a.relevance);
+        // Step 4: Assemble levels with token budgets
+        const level1 = [];
+        const level2 = [];
+        const level3 = [];
+        const level4 = [];
+        const level5 = [];
+        let level1Tokens = 0;
+        let level2Tokens = 0;
+        let level3Tokens = 0;
+        let level4Tokens = 0;
+        let level5Tokens = 0;
+        // Step 5: Fill Level 1 Focus (direct matches, highest relevance)
+        for (const { node, relevance } of scored) {
+            if (!levels.includes(1))
+                break;
+            if (relevance < 0.5)
+                break;
+            const content = node.content;
+            const tokens = estimateTokens(content);
+            if (level1Tokens + tokens > budget.level1)
+                continue;
+            level1.push({ id: node.id, type: node.type, content, relevance });
+            level1Tokens += tokens;
+        }
+        const usedIds = new Set(level1.map(n => n.id));
+        // Step 6: Fill Level 2 Active (associated context, proactive injection)
+        if (levels.includes(2)) {
+            const neighborIds = new Set();
+            for (const l1Node of level1) {
+                const connected = this.edges.getConnectedNodeIds(l1Node.id);
+                for (const id of connected) {
+                    if (!usedIds.has(id))
+                        neighborIds.add(id);
+                }
+            }
+            const l2Candidates = scored
+                .filter(s => !usedIds.has(s.node.id))
+                .map(s => ({ ...s, isNeighbor: neighborIds.has(s.node.id) }));
+            l2Candidates.sort((a, b) => {
+                if (a.isNeighbor && !b.isNeighbor)
+                    return -1;
+                if (!a.isNeighbor && b.isNeighbor)
+                    return 1;
+                return b.relevance - a.relevance;
+            });
+            for (const { node, relevance } of l2Candidates) {
+                if (relevance < 0.2)
+                    break;
+                const content = node.summary ?? node.content;
+                const tokens = estimateTokens(content);
+                if (level2Tokens + tokens > budget.level2)
+                    continue;
+                level2.push({ id: node.id, type: node.type, content, relevance });
+                level2Tokens += tokens;
+                usedIds.add(node.id);
+            }
+        }
+        // Step 7: Fill Level 3 Reference (proactively injected context)
+        if (levels.includes(3)) {
+            const l3Candidates = scored.filter(s => !usedIds.has(s.node.id));
+            for (const { node, relevance } of l3Candidates) {
+                if (relevance < 0.1)
+                    break;
+                const content = node.summary ?? node.content.slice(0, 200);
+                const tokens = estimateTokens(content);
+                if (level3Tokens + tokens > budget.level3)
+                    continue;
+                level3.push({ id: node.id, type: node.type, content, relevance });
+                level3Tokens += tokens;
+                usedIds.add(node.id);
+            }
+        }
+        // Step 8: Fill Level 4 Archive (compressed background context)
+        if (levels.includes(4)) {
+            const l4Candidates = scored.filter(s => !usedIds.has(s.node.id));
+            for (const { node, relevance } of l4Candidates) {
+                const content = node.summary ?? node.content.slice(0, 100);
+                const tokens = estimateTokens(content);
+                if (level4Tokens + tokens > budget.level4)
+                    continue;
+                level4.push({ id: node.id, type: node.type, content, relevance });
+                level4Tokens += tokens;
+                usedIds.add(node.id);
+            }
+        }
+        // Step 9: Fill Level 5 Deep Archive (minimal references)
+        if (levels.includes(5)) {
+            const l5Candidates = scored.filter(s => !usedIds.has(s.node.id));
+            for (const { node, relevance } of l5Candidates) {
+                const content = node.summary ?? node.content.slice(0, 50);
+                const tokens = estimateTokens(content);
+                if (level5Tokens + tokens > budget.level5)
+                    continue;
+                level5.push({ id: node.id, type: node.type, content, relevance });
+                level5Tokens += tokens;
+            }
+        }
+        const totalTokens = level1Tokens + level2Tokens + level3Tokens + level4Tokens + level5Tokens;
+        const nodeCount = level1.length + level2.length + level3.length + level4.length + level5.length;
+        logger.debug(`Injection: L1=${level1.length} L2=${level2.length} L3=${level3.length} L4=${level4.length} L5=${level5.length} tokens=${totalTokens}`);
+        return {
+            level_1: level1,
+            level_2: level2,
+            level_3: level3,
+            level_4: level4,
+            level_5: level5,
+            total_tokens: totalTokens,
+            node_count: nodeCount,
+        };
+    }
+}
+//# sourceMappingURL=injection.js.map

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;AA2C3C,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;IAuB3B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,OAAO;IAoEf,KAAK,IAAI,IAAI;CAMd"}