forge-server 0.1.0

package/dist/server.js

@@ -0,0 +1,291 @@
+// server.ts — B19
+// MCP server setup: initialises all services and registers all tools.
+//
+// Startup sequence:
+//   1. Initialize SQLite (PipelineDB) — always succeeds; creates file if needed
+//   2. Attempt Qdrant connection with graceful degradation on failure
+//   3. Attempt FalkorDB connection with graceful degradation on failure
+//   4. Create ConfidenceManager for knowledge confidence tracking
+//   5. Create file content cache
+//   6. Create service instances (engine, registry, search, context, injector)
+//   7. Collect all tool handlers (pipeline, phase, context, registration,
+//      learning, ingestion, memory, graph, collaboration)
+//   8. Register all tools with the MCP server
+//   9. Start periodic confidence decay (every 24 hours)
+//
+// Lazy loading: embedding model is NOT loaded here. It is lazy-loaded in
+// embedder.ts on first use. This keeps server startup under 2 seconds.
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { PipelineDB } from './storage/sqlite.js';
+import { QdrantVectorStore } from './storage/qdrant-store.js';
+import { FalkorDBGraphStore } from './storage/falkordb-store.js';
+import { LRUFileContentCache } from './storage/file-cache.js';
+import { PipelineEngine } from './pipeline/engine.js';
+import { RepoRegistry } from './knowledge/registry.js';
+import { KnowledgeYamlStore } from './knowledge/store.js';
+import { KnowledgeHydrator } from './knowledge/hydrator.js';
+import { KnowledgeSearch } from './knowledge/search.js';
+import { CodebaseContext } from './context/codebase.js';
+import { MemoryBridge } from './context/memory.js';
+import { ContextInjector } from './context/injector.js';
+import { createPipelineTools } from './tools/pipeline-tools.js';
+import { createPhaseTools } from './tools/phase-tools.js';
+import { createContextTools } from './tools/context-tools.js';
+import { createRegistrationTools } from './tools/registration-tools.js';
+import { createLearningTools } from './tools/learning-tools.js';
+import { createIngestionTools } from './tools/ingestion-tools.js';
+import { createMemoryTools } from './tools/memory-tools.js';
+import { createGraphTools } from './tools/graph-tools.js';
+import { createCollaborationTools } from './tools/collaboration-tools.js';
+import { ConfidenceManager } from './learning/confidence.js';
+import { logger } from './util/logger.js';
+// ---------------------------------------------------------------------------
+// Default paths
+// ---------------------------------------------------------------------------
+const DEFAULT_DB_PATH = join(homedir(), '.forge', 'pipeline.db');
+const QDRANT_URL = process.env['QDRANT_URL'] ?? 'http://localhost:6333';
+const FALKORDB_HOST = process.env['FALKORDB_HOST'] ?? 'localhost';
+const FALKORDB_PORT = parseInt(process.env['FALKORDB_PORT'] ?? '6380', 10);
+// ---------------------------------------------------------------------------
+// Server info
+// ---------------------------------------------------------------------------
+const SERVER_NAME = 'dk-forge';
+const SERVER_VERSION = '0.1.0';
+// ---------------------------------------------------------------------------
+// createForgeServer
+// ---------------------------------------------------------------------------
+export async function createForgeServer() {
+    const startTime = Date.now();
+    logger.info(`${SERVER_NAME}: initializing`, { version: SERVER_VERSION });
+    // -------------------------------------------------------------------------
+    // 1. SQLite — always succeeds; creates ~/.forge/pipeline.db if needed
+    // -------------------------------------------------------------------------
+    const dbPath = process.env['FORGE_DB_PATH'] ?? DEFAULT_DB_PATH;
+    const db = new PipelineDB(dbPath);
+    db.initialize();
+    logger.info('server: SQLite initialized', { path: dbPath });
+    // -------------------------------------------------------------------------
+    // 2. Qdrant — graceful degradation if unavailable
+    // -------------------------------------------------------------------------
+    let vectorStore = null;
+    try {
+        const qdrant = new QdrantVectorStore(QDRANT_URL);
+        const qdrantHealthy = await qdrant.isHealthy();
+        if (qdrantHealthy) {
+            // Ensure collections exist (384-dim for all-MiniLM-L6-v2)
+            await qdrant.ensureCollections(384);
+            vectorStore = qdrant;
+            logger.info('server: Qdrant connected', { url: QDRANT_URL });
+        }
+        else {
+            logger.warn('server: Qdrant unavailable — knowledge search and codebase context will be degraded', {
+                url: QDRANT_URL,
+            });
+        }
+    }
+    catch (err) {
+        logger.warn('server: Qdrant connection failed — running without vector search', {
+            url: QDRANT_URL,
+            error: String(err),
+        });
+    }
+    // -------------------------------------------------------------------------
+    // 3. FalkorDB — graceful degradation if unavailable
+    // -------------------------------------------------------------------------
+    let graphStore = null;
+    try {
+        const falkor = new FalkorDBGraphStore(`redis://${FALKORDB_HOST}:${FALKORDB_PORT}`);
+        await falkor.connect();
+        const falkorHealthy = await falkor.isHealthy();
+        if (falkorHealthy) {
+            graphStore = falkor;
+            logger.info('server: FalkorDB connected', { host: FALKORDB_HOST, port: FALKORDB_PORT });
+        }
+        else {
+            logger.warn('server: FalkorDB unavailable — graph-boosted search disabled, using vector-only');
+            try {
+                await falkor.disconnect();
+            }
+            catch { }
+        }
+    }
+    catch (err) {
+        logger.warn('server: FalkorDB connection failed — running without graph store', {
+            error: String(err),
+        });
+    }
+    // -------------------------------------------------------------------------
+    // 4. Confidence manager — tracks knowledge item usage and decay
+    // -------------------------------------------------------------------------
+    const confidenceManager = new ConfidenceManager();
+    // -------------------------------------------------------------------------
+    // 5. File content cache
+    // -------------------------------------------------------------------------
+    const fileCache = new LRUFileContentCache({
+        maxSizeBytes: 128 * 1024 * 1024, // 128 MB
+        maxEntries: 2000,
+        ttlMs: 30 * 60 * 1000, // 30 minutes
+    });
+    // -------------------------------------------------------------------------
+    // 6. Service instances
+    // -------------------------------------------------------------------------
+    // Knowledge hydrator — wires YAML store + Qdrant
+    // The KnowledgeHydrator's yamlStore is overridden per-registration call inside RepoRegistry,
+    // so we pass a placeholder that uses ~/.forge as the base directory.
+    const knowledgeHydrator = vectorStore
+        ? new KnowledgeHydrator(new KnowledgeYamlStore(join(homedir(), '.forge')), vectorStore)
+        : undefined;
+    // Repo registry — passes the hydrator for knowledge sync on registration
+    const registry = new RepoRegistry(db, knowledgeHydrator);
+    // Pipeline engine
+    const engine = new PipelineEngine(db);
+    // Knowledge search — wraps Qdrant knowledge collection
+    const knowledgeSearch = vectorStore
+        ? new KnowledgeSearch(vectorStore)
+        : createDegradedKnowledgeSearch();
+    // Codebase context — wraps hybrid search
+    // Sharing resolver: looks up a repo's sharing mode from the registry so that
+    // cross-repo search results from private repos are filtered out.
+    const codebaseCtx = new CodebaseContext(graphStore, vectorStore, fileCache, (repoId) => registry.getRepo(repoId)?.sharing);
+    // Memory bridge — wraps Qdrant observations collection
+    const memoryBridge = new MemoryBridge(vectorStore);
+    // Context injector — orchestrates all context assembly
+    // Accepts confidenceManager + vectorStore to auto-boost knowledge confidence
+    // on consumption (Phase 2 swarm learning).
+    const contextInjector = new ContextInjector(knowledgeSearch, codebaseCtx, memoryBridge, db, confidenceManager, vectorStore);
+    // -------------------------------------------------------------------------
+    // 7. Collect all tool handlers
+    // -------------------------------------------------------------------------
+    // Existing tool factories — updated with new params for swarm learning
+    const pipelineTools = createPipelineTools(engine, registry);
+    const phaseTools = createPhaseTools(engine, contextInjector, vectorStore, graphStore);
+    const contextTools = createContextTools(knowledgeSearch, codebaseCtx, engine, memoryBridge, vectorStore, graphStore);
+    const registrationTools = createRegistrationTools(registry, {
+        vectorStore,
+        graphStore,
+        fileCache,
+    });
+    const learningTools = createLearningTools(knowledgeSearch, confidenceManager, vectorStore);
+    const ingestionTools = createIngestionTools(graphStore);
+    // New tool factories — swarm learning, graph analysis, collaboration
+    const memoryTools = createMemoryTools(memoryBridge, vectorStore, graphStore);
+    const graphTools = createGraphTools(graphStore);
+    const collaborationTools = createCollaborationTools(vectorStore, graphStore, db);
+    const allTools = {
+        ...pipelineTools,
+        ...phaseTools,
+        ...contextTools,
+        ...registrationTools,
+        ...learningTools,
+        ...ingestionTools,
+        ...memoryTools,
+        ...graphTools,
+        ...collaborationTools,
+    };
+    // -------------------------------------------------------------------------
+    // 8. Create and configure MCP server
+    // -------------------------------------------------------------------------
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    // Register each tool with the MCP server
+    for (const [name, tool] of Object.entries(allTools)) {
+        const { schema, description, handler } = tool;
+        server.tool(name, description, 
+        // MCP SDK accepts raw Zod shape objects (not the full z.object wrapper)
+        schema.shape, async (input) => {
+            try {
+                const result = await handler(input);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                const errorPayload = {
+                    error: 'TOOL_EXECUTION_ERROR',
+                    tool: name,
+                    message: String(err),
+                };
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(errorPayload, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        logger.debug(`server: registered tool: ${name}`);
+    }
+    const elapsed = Date.now() - startTime;
+    logger.info(`${SERVER_NAME}: ready`, {
+        toolCount: Object.keys(allTools).length,
+        qdrant: vectorStore !== null,
+        falkordb: graphStore !== null,
+        startupMs: elapsed,
+    });
+    // -------------------------------------------------------------------------
+    // 9. Periodic confidence decay — runs every 24 hours
+    // -------------------------------------------------------------------------
+    // Knowledge items that haven't been accessed recently see their confidence
+    // decrease over time. This prevents stale knowledge from dominating search
+    // results. The decay is best-effort and never blocks the server.
+    const DECAY_INTERVAL = 24 * 60 * 60 * 1000; // 24 hours
+    setInterval(() => {
+        if (vectorStore) {
+            confidenceManager.decayAll(vectorStore)
+                .catch(err => logger.warn('Periodic confidence decay failed', { error: String(err) }));
+        }
+    }, DECAY_INTERVAL);
+    // Expose close method for graceful shutdown
+    server._closeConnections = async () => {
+        db.close();
+        if (graphStore) {
+            try {
+                await graphStore.disconnect();
+            }
+            catch { }
+        }
+        logger.info('server: connections closed');
+    };
+    return server;
+}
+// ---------------------------------------------------------------------------
+// Degraded KnowledgeSearch stub — used when Qdrant is unavailable
+// ---------------------------------------------------------------------------
+function createDegradedKnowledgeSearch() {
+    // We need a QdrantVectorStore that always reports unhealthy.
+    // This causes KnowledgeSearch to return empty results gracefully.
+    const degradedStore = {
+        isHealthy: async () => false,
+        searchKnowledge: async () => [],
+        upsertKnowledge: async () => { },
+        deleteKnowledge: async () => { },
+        getKnowledgeCount: async () => 0,
+        searchCodeChunks: async () => [],
+        searchObservations: async () => [],
+        upsertCodeChunks: async () => { },
+        upsertObservation: async () => { },
+        deleteFileChunks: async () => { },
+        deleteRepoChunks: async () => { },
+        getCounts: async () => ({ codeChunks: 0, observations: 0 }),
+        getObservation: async () => null,
+        updateObservation: async () => { },
+        filterObservations: async () => [],
+        ensureCollections: async () => { },
+        connect: async () => { },
+        disconnect: async () => { },
+    };
+    return new KnowledgeSearch(degradedStore);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,sEAAsE;AACtE,EAAE;AACF,oBAAoB;AACpB,gFAAgF;AAChF,sEAAsE;AACtE,wEAAwE;AACxE,kEAAkE;AAClE,iCAAiC;AACjC,8EAA8E;AAC9E,0EAA0E;AAC1E,0DAA0D;AAC1D,8CAA8C;AAC9C,wDAAwD;AACxD,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACjE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,uBAAuB,CAAC;AACxE,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,WAAW,CAAC;AAClE,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAE3E,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,WAAW,GAAG,UAAU,CAAC;AAC/B,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,gBAAgB,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAEzE,4EAA4E;IAC5E,sEAAsE;IACtE,4EAA4E;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,eAAe,CAAC;IAC/D,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,EAAE,CAAC,UAAU,EAAE,CAAC;IAChB,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5D,4EAA4E;IAC5E,kDAAkD;IAClD,4EAA4E;IAC5E,IAAI,WAAW,GAA6B,IAAI,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAC/C,IAAI,aAAa,EAAE,CAAC;YAClB,0DAA0D;YAC1D,MAAM,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACpC,WAAW,GAAG,MAAM,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,qFAAqF,EAAE;gBACjG,GAAG,EAAE,UAAU;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,kEAAkE,EAAE;YAC9E,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;SACnB,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,oDAAoD;IACpD,4EAA4E;IAC5E,IAAI,UAAU,GAA8B,IAAI,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,kBAAkB,CACnC,WAAW,aAAa,IAAI,aAAa,EAAE,CAC5C,CAAC;QACF,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAC/C,IAAI,aAAa,EAAE,CAAC;YAClB,UAAU,GAAG,MAAM,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;YAC/F,IAAI,CAAC;gBAAC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,kEAAkE,EAAE;YAC9E,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;SACnB,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,gEAAgE;IAChE,4EAA4E;IAC5E,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAElD,4EAA4E;IAC5E,wBAAwB;IACxB,4EAA4E;IAC5E,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC;QACxC,YAAY,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,SAAS;QAC1C,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;KACrC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,uBAAuB;IACvB,4EAA4E;IAE5E,iDAAiD;IACjD,6FAA6F;IAC7F,qEAAqE;IACrE,MAAM,iBAAiB,GAAG,WAAW;QACnC,CAAC,CAAC,IAAI,iBAAiB,CACnB,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC,EACjD,WAAW,CACZ;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,yEAAyE;IACzE,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAEzD,kBAAkB;IAClB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;IAEtC,uDAAuD;IACvD,MAAM,eAAe,GAAG,WAAW;QACjC,CAAC,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC;QAClC,CAAC,CAAC,6BAA6B,EAAE,CAAC;IAEpC,yCAAyC;IACzC,6EAA6E;IAC7E,iEAAiE;IACjE,MAAM,WAAW,GAAG,IAAI,eAAe,CACrC,UAAU,EACV,WAAW,EACX,SAAS,EACT,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAC9C,CAAC;IAEF,uDAAuD;IACvD,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;IAEnD,uDAAuD;IACvD,6EAA6E;IAC7E,2CAA2C;IAC3C,MAAM,eAAe,GAAG,IAAI,eAAe,CACzC,eAAe,EACf,WAAW,EACX,YAAY,EACZ,EAAE,EACF,iBAAiB,EACjB,WAA4C,CAC7C,CAAC;IAEF,4EAA4E;IAC5E,+BAA+B;IAC/B,4EAA4E;IAE5E,uEAAuE;IACvE,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACtF,MAAM,YAAY,GAAG,kBAAkB,CACrC,eAAe,EAAE,WAAW,EAAE,MAAM,EACpC,YAAY,EAAE,WAAW,EAAE,UAAU,CACtC,CAAC;IACF,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,QAAQ,EAAE;QAC1D,WAAW;QACX,UAAU;QACV,SAAS;KACV,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,mBAAmB,CACvC,eAAe,EACf,iBAAiB,EACjB,WAAuC,CACxC,CAAC;IACF,MAAM,cAAc,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAExD,qEAAqE;IACrE,MAAM,WAAW,GAAG,iBAAiB,CAAC,YAAY,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,kBAAkB,GAAG,wBAAwB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAEjF,MAAM,QAAQ,GAAG;QACf,GAAG,aAAa;QAChB,GAAG,UAAU;QACb,GAAG,YAAY;QACf,GAAG,iBAAiB;QACpB,GAAG,aAAa;QAChB,GAAG,cAAc;QACjB,GAAG,WAAW;QACd,GAAG,UAAU;QACb,GAAG,kBAAkB;KACtB,CAAC;IAEF,4EAA4E;IAC5E,qCAAqC;IACrC,4EAA4E;IAC5E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,yCAAyC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAIxC,CAAC;QAEF,MAAM,CAAC,IAAI,CACT,IAAI,EACJ,WAAW;QACX,wEAAwE;QACvE,MAAwD,CAAC,KAAK,EAC/D,KAAK,EAAE,KAA8B,EAAE,EAAE;YACvC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;gBACpC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,YAAY,GAAG;oBACnB,KAAK,EAAE,sBAAsB;oBAC7B,IAAI,EAAE,IAAI;oBACV,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;iBACrB,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;yBAC5C;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,SAAS,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;QACvC,MAAM,EAAE,WAAW,KAAK,IAAI;QAC5B,QAAQ,EAAE,UAAU,KAAK,IAAI;QAC7B,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,4EAA4E;IAC5E,qDAAqD;IACrD,4EAA4E;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,iEAAiE;IACjE,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW;IACvD,WAAW,CAAC,GAAG,EAAE;QACf,IAAI,WAAW,EAAE,CAAC;YAChB,iBAAiB,CAAC,QAAQ,CAAC,WAAgC,CAAC;iBACzD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC,EAAE,cAAc,CAAC,CAAC;IAEnB,4CAA4C;IAC3C,MAAkE,CAAC,iBAAiB,GAAG,KAAK,IAAI,EAAE;QACjG,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBAAC,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACjD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAE9E,SAAS,6BAA6B;IACpC,6DAA6D;IAC7D,kEAAkE;IAClE,MAAM,aAAa,GAAG;QACpB,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;QAC5B,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAC/B,eAAe,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC/B,eAAe,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC/B,iBAAiB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAChC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAChC,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAClC,gBAAgB,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAChC,iBAAiB,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACjC,gBAAgB,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAChC,gBAAgB,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAChC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC3D,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;QAChC,iBAAiB,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACjC,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAClC,iBAAiB,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACjC,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACvB,UAAU,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACK,CAAC;IAElC,OAAO,IAAI,eAAe,CAAC,aAAa,CAAC,CAAC;AAC5C,CAAC"}

package/dist/storage/falkordb-store.d.ts

@@ -0,0 +1,73 @@
+/**
+ * FalkorDB implementation of GraphStore.
+ * FalkorDB speaks Redis protocol + GRAPH commands.
+ * Connects to localhost:6380 (remapped from container port 6379 per ADR-7).
+ *
+ * FalkorDB GRAPH.QUERY --compact response format:
+ * [
+ *   ["header", [...column_names]],
+ *   ["data", [[row], [row], ...]],
+ *   ["stats", ["Query internal execution time: X ms"]]
+ * ]
+ *
+ * Without --compact:
+ * [header_array, data_array, stats_array]
+ * where header_array = [column_names]
+ * and data_array = [[cell, cell, ...], ...]
+ */
+import type { GraphStore } from './interfaces.js';
+import type { GraphQueryResult } from '../util/types.js';
+export declare class FalkorDBGraphStore implements GraphStore {
+    private client;
+    private readonly url;
+    private readonly graphName;
+    private readonly queryTimeoutMs;
+    private connected;
+    private reconnectAttempts;
+    private readonly breaker;
+    constructor(url?: string, graphName?: string, queryTimeoutMs?: number);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isHealthy(): Promise<boolean>;
+    /**
+     * Execute a raw Cypher query and return typed results.
+     * Parses FalkorDB's non-compact response format.
+     */
+    query(cypher: string, params?: Record<string, unknown>): Promise<GraphQueryResult>;
+    upsertNode(label: string, matchProps: Record<string, unknown>, setProps: Record<string, unknown>): Promise<void>;
+    upsertEdge(fromLabel: string, fromProps: Record<string, unknown>, edgeType: string, edgeProps: Record<string, unknown>, toLabel: string, toProps: Record<string, unknown>): Promise<void>;
+    deleteFile(filePath: string, repoId: string): Promise<void>;
+    deleteRepo(repoId: string): Promise<void>;
+    getCounts(): Promise<{
+        totalNodes: number;
+        totalEdges: number;
+        byLabel: Record<string, number>;
+    }>;
+    ensureIndexes(): Promise<void>;
+    /**
+     * Execute a GRAPH.QUERY command with timeout, wrapped in the circuit breaker.
+     * Returns the raw FalkorDB response array.
+     */
+    private graphQuery;
+    /**
+     * Wrap a promise with a timeout that rejects after timeoutMs.
+     */
+    private withTimeout;
+    /**
+     * Parse FalkorDB GRAPH.QUERY response into GraphQueryResult.
+     * FalkorDB non-compact format: [header_row, data_rows, stats_row]
+     * header_row: ["column1", "column2", ...]
+     * data_rows: [[val1, val2, ...], [val1, val2, ...], ...]
+     */
+    private parseGraphQueryResult;
+    /**
+     * Extract a single scalar number from a GRAPH.QUERY count result.
+     * Response: [["cnt"], [[42]], [...stats]]
+     */
+    private extractScalarNumber;
+    private propsToMatch;
+    private propsToSet;
+    private valueToLiteral;
+    private escape;
+}
+//# sourceMappingURL=falkordb-store.d.ts.map

package/dist/storage/falkordb-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"falkordb-store.d.ts","sourceRoot":"","sources":["../../src/storage/falkordb-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQzD,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAGvC,GAAG,GAAE,MAAiC,EACtC,SAAS,GAAE,MAA0B,EACrC,cAAc,GAAE,MAAiC;IAY7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAenC;;;OAGG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUlF,UAAU,CACd,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAYV,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAoBV,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,SAAS,IAAI,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IA+BjG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BpC;;;OAGG;YACW,UAAU;IAcxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IA6C7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,MAAM;CAGf"}