@mcp-graph-workflow/mcp-graph 3.0.0

package/dist/api/routes/docs-cache.js

@@ -0,0 +1,79 @@
+import { Router } from "express";
+import { DocsCacheStore } from "../../core/docs/docs-cache-store.js";
+import { DocsSyncer } from "../../core/docs/docs-syncer.js";
+const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+const SEVEN_DAYS_MS = 7 * ONE_DAY_MS;
+function getFreshness(fetchedAt) {
+    const age = Date.now() - new Date(fetchedAt).getTime();
+    if (age < ONE_DAY_MS)
+        return "fresh";
+    if (age < SEVEN_DAYS_MS)
+        return "aging";
+    return "stale";
+}
+export function createDocsCacheRouter(store) {
+    const router = Router();
+    const cacheStore = new DocsCacheStore(store.getDb());
+    router.get("/", (req, res, next) => {
+        try {
+            const lib = req.query.lib;
+            if (lib) {
+                const results = cacheStore.searchDocs(lib);
+                res.json(results.map((d) => ({
+                    ...d,
+                    freshness: getFreshness(d.fetchedAt),
+                })));
+                return;
+            }
+            const docs = cacheStore.listCached();
+            res.json(docs.map((d) => ({
+                ...d,
+                freshness: getFreshness(d.fetchedAt),
+            })));
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get("/:libId", (req, res, next) => {
+        try {
+            const doc = cacheStore.getDoc(req.params.libId);
+            if (!doc) {
+                res.status(404).json({ error: `Doc not found: ${req.params.libId}` });
+                return;
+            }
+            res.json({ ...doc, freshness: getFreshness(doc.fetchedAt) });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.post("/sync", async (req, res, next) => {
+        try {
+            const { lib } = req.body;
+            if (!lib) {
+                res.status(400).json({ error: "Missing 'lib' in request body" });
+                return;
+            }
+            // Create a no-op fetcher that returns a placeholder — real Context7 integration
+            // requires MCP client connection which is not available in the REST API context.
+            // The sync endpoint stores the lib name for future MCP-based sync.
+            const placeholderFetcher = {
+                async resolveLibraryId(name) {
+                    return `context7:${name}`;
+                },
+                async queryDocs() {
+                    return `Documentation placeholder for ${lib}. Use Context7 MCP tools for full sync.`;
+                },
+            };
+            const syncer = new DocsSyncer(cacheStore, placeholderFetcher);
+            const doc = await syncer.syncLib(lib);
+            res.status(201).json({ ...doc, freshness: getFreshness(doc.fetchedAt) });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=docs-cache.js.map

package/dist/api/routes/docs-cache.js.map

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

package/dist/api/routes/edges.d.ts

@@ -0,0 +1,4 @@
+import { Router } from "express";
+import type { SqliteStore } from "../../core/store/sqlite-store.js";
+export declare function createEdgesRouter(store: SqliteStore): Router;
+//# sourceMappingURL=edges.d.ts.map

package/dist/api/routes/edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.d.ts","sourceRoot":"","sources":["../../../src/api/routes/edges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAUpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA4C5D"}

package/dist/api/routes/edges.js

@@ -0,0 +1,50 @@
+import { Router } from "express";
+import { z } from "zod/v4";
+import { GraphEdgeSchema } from "../../schemas/edge.schema.js";
+import { validateBody } from "../middleware/validate.js";
+import { generateId } from "../../core/utils/id.js";
+import { now } from "../../core/utils/time.js";
+const CreateEdgeBodySchema = GraphEdgeSchema.omit({ id: true, createdAt: true }).extend({
+    id: z.string().optional(),
+});
+export function createEdgesRouter(store) {
+    const router = Router();
+    router.get("/", (_req, res, next) => {
+        try {
+            res.json(store.getAllEdges());
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.post("/", validateBody(CreateEdgeBodySchema), (req, res, next) => {
+        try {
+            const edge = {
+                ...req.body,
+                id: req.body.id ?? generateId("edge"),
+                createdAt: now(),
+            };
+            store.insertEdge(edge);
+            res.status(201).json(edge);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.delete("/:id", (req, res, next) => {
+        try {
+            const id = req.params.id;
+            const deleted = store.deleteEdge(id);
+            if (!deleted) {
+                res.status(404).json({ error: `Edge not found: ${id}` });
+                return;
+            }
+            res.status(204).send();
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=edges.js.map

package/dist/api/routes/edges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edges.js","sourceRoot":"","sources":["../../../src/api/routes/edges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAsB,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAE/C,MAAM,oBAAoB,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACtF,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CACT,GAAG,EACH,YAAY,CAAC,oBAAoB,CAAC,EAClC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG;gBACX,GAAG,GAAG,CAAC,IAAI;gBACX,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC;gBACrC,SAAS,EAAE,GAAG,EAAE;aACjB,CAAC;YACF,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACvB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAY,CAAC;YACnC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,CAAC;gBACzD,OAAO;YACT,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/api/routes/events.d.ts

@@ -0,0 +1,4 @@
+import { Router } from "express";
+import type { GraphEventBus } from "../../core/events/event-bus.js";
+export declare function createEventsRouter(eventBus: GraphEventBus): Router;
+//# sourceMappingURL=events.d.ts.map

package/dist/api/routes/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/api/routes/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAIpE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAyClE"}

package/dist/api/routes/events.js

@@ -0,0 +1,37 @@
+import { Router } from "express";
+import { logger } from "../../core/utils/logger.js";
+export function createEventsRouter(eventBus) {
+    const router = Router();
+    /**
+     * GET /events
+     * Server-Sent Events stream for real-time graph updates.
+     */
+    router.get("/", (req, res) => {
+        logger.info("SSE client connected");
+        res.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            "Connection": "keep-alive",
+            "X-Accel-Buffering": "no",
+        });
+        // Send initial keepalive
+        res.write(": connected\n\n");
+        const handler = (event) => {
+            const data = JSON.stringify(event);
+            res.write(`event: ${event.type}\ndata: ${data}\n\n`);
+        };
+        eventBus.on("*", handler);
+        // Keepalive every 30s
+        const keepalive = setInterval(() => {
+            res.write(": keepalive\n\n");
+        }, 30_000);
+        // Cleanup on disconnect
+        req.on("close", () => {
+            logger.info("SSE client disconnected");
+            eventBus.off("*", handler);
+            clearInterval(keepalive);
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=events.js.map

package/dist/api/routes/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/api/routes/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,MAAM,UAAU,kBAAkB,CAAC,QAAuB;IACxD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAEpC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,YAAY,EAAE,YAAY;YAC1B,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CAAC;QAEH,yBAAyB;QACzB,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAE7B,MAAM,OAAO,GAAG,CAAC,KAAiB,EAAQ,EAAE;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnC,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,WAAW,IAAI,MAAM,CAAC,CAAC;QACvD,CAAC,CAAC;QAEF,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE1B,sBAAsB;QACtB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC/B,CAAC,EAAE,MAAM,CAAC,CAAC;QAEX,wBAAwB;QACxB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;YACvC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3B,aAAa,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/api/routes/gitnexus.d.ts

@@ -0,0 +1,12 @@
+/**
+ * GitNexus API bridge routes.
+ * Proxies requests to the local GitNexus instance.
+ * All data stays local — no external communication.
+ */
+import { Router } from "express";
+export interface GitNexusRouterOptions {
+    basePath: string;
+    gitnexusPort?: number;
+}
+export declare function createGitNexusRouter(options: GitNexusRouterOptions): Router;
+//# sourceMappingURL=gitnexus.d.ts.map

package/dist/api/routes/gitnexus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitnexus.d.ts","sourceRoot":"","sources":["../../../src/api/routes/gitnexus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAsBjC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA4BD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAuI3E"}

package/dist/api/routes/gitnexus.js

@@ -0,0 +1,162 @@
+/**
+ * GitNexus API bridge routes.
+ * Proxies requests to the local GitNexus instance.
+ * All data stays local — no external communication.
+ */
+import { Router } from "express";
+import { z } from "zod/v4";
+import { isGitNexusIndexed, isGitNexusRunning, getAnalyzePhase, ensureGitNexusAnalyzed, startGitNexusServe, } from "../../core/integrations/gitnexus-launcher.js";
+import { logger } from "../../core/utils/logger.js";
+import { buildContextQuery, buildImpactQuery, parseContextResponse, parseImpactResponse, } from "../../core/integrations/gitnexus-queries.js";
+const QueryBodySchema = z.object({ query: z.string().min(1) });
+const SymbolBodySchema = z.object({ symbol: z.string().min(1) });
+const DEFAULT_GITNEXUS_PORT = 3737;
+async function proxyToGitNexus(port, endpoint, body) {
+    try {
+        const res = await fetch(`http://localhost:${port}${endpoint}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        // Handle non-JSON responses (e.g. HTML 404 pages) gracefully
+        const contentType = res.headers.get("content-type") ?? "";
+        if (!contentType.includes("application/json")) {
+            return { ok: false, status: res.status, data: { error: `Non-JSON response from GitNexus (${res.status})` } };
+        }
+        const data = await res.json();
+        return { ok: res.ok, status: res.status, data };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, status: 502, data: { error: `GitNexus proxy error: ${message}` } };
+    }
+}
+export function createGitNexusRouter(options) {
+    const { basePath, gitnexusPort = DEFAULT_GITNEXUS_PORT } = options;
+    const router = Router();
+    // ── GET /status ───────────────────────────────
+    router.get("/status", async (_req, res, next) => {
+        try {
+            const indexed = isGitNexusIndexed(basePath);
+            const running = await isGitNexusRunning(gitnexusPort);
+            res.json({
+                indexed,
+                running,
+                port: gitnexusPort,
+                analyzePhase: getAnalyzePhase(),
+                ...(running ? { url: `http://localhost:${gitnexusPort}` } : {}),
+            });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    // ── POST /analyze ────────────────────────────────
+    router.post("/analyze", async (_req, res, next) => {
+        try {
+            const result = await ensureGitNexusAnalyzed(basePath);
+            res.json(result);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    // ── POST /serve ─────────────────────────────────
+    router.post("/serve", async (_req, res, next) => {
+        try {
+            const result = await startGitNexusServe(basePath, gitnexusPort);
+            res.json(result);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    // ── POST /query ───────────────────────────────
+    router.post("/query", async (req, res, next) => {
+        try {
+            const parsed = QueryBodySchema.safeParse(req.body);
+            if (!parsed.success) {
+                res.status(400).json({ error: "Missing required field: query" });
+                return;
+            }
+            const running = await isGitNexusRunning(gitnexusPort);
+            if (!running) {
+                res.status(503).json({ error: "GitNexus is not running. Start with: gitnexus serve" });
+                return;
+            }
+            const result = await proxyToGitNexus(gitnexusPort, "/api/query", { cypher: parsed.data.query });
+            res.status(result.status).json(result.data);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    // ── POST /context ─────────────────────────────
+    router.post("/context", async (req, res, next) => {
+        try {
+            const parsed = SymbolBodySchema.safeParse(req.body);
+            if (!parsed.success) {
+                res.status(400).json({ error: "Missing required field: symbol" });
+                return;
+            }
+            const running = await isGitNexusRunning(gitnexusPort);
+            if (!running) {
+                res.status(503).json({ error: "GitNexus is not running. Start with: gitnexus serve" });
+                return;
+            }
+            // Try direct proxy first, fallback to Cypher query
+            const result = await proxyToGitNexus(gitnexusPort, "/api/context", { symbol: parsed.data.symbol });
+            if (result.status === 404) {
+                logger.debug("GitNexus /api/context returned 404, falling back to Cypher query", { symbol: parsed.data.symbol });
+                const cypher = buildContextQuery(parsed.data.symbol);
+                const cypherResult = await proxyToGitNexus(gitnexusPort, "/api/query", { cypher });
+                if (!cypherResult.ok) {
+                    res.status(cypherResult.status).json(cypherResult.data);
+                    return;
+                }
+                const contextData = parseContextResponse(cypherResult.data);
+                res.json(contextData);
+                return;
+            }
+            res.status(result.status).json(result.data);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    // ── POST /impact ──────────────────────────────
+    router.post("/impact", async (req, res, next) => {
+        try {
+            const parsed = SymbolBodySchema.safeParse(req.body);
+            if (!parsed.success) {
+                res.status(400).json({ error: "Missing required field: symbol" });
+                return;
+            }
+            const running = await isGitNexusRunning(gitnexusPort);
+            if (!running) {
+                res.status(503).json({ error: "GitNexus is not running. Start with: gitnexus serve" });
+                return;
+            }
+            // Try direct proxy first, fallback to Cypher query
+            const result = await proxyToGitNexus(gitnexusPort, "/api/impact", { symbol: parsed.data.symbol });
+            if (result.status === 404) {
+                logger.debug("GitNexus /api/impact returned 404, falling back to Cypher query", { symbol: parsed.data.symbol });
+                const cypher = buildImpactQuery(parsed.data.symbol);
+                const cypherResult = await proxyToGitNexus(gitnexusPort, "/api/query", { cypher });
+                if (!cypherResult.ok) {
+                    res.status(cypherResult.status).json(cypherResult.data);
+                    return;
+                }
+                const impactData = parseImpactResponse(cypherResult.data, parsed.data.symbol);
+                res.json(impactData);
+                return;
+            }
+            res.status(result.status).json(result.data);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=gitnexus.js.map

package/dist/api/routes/gitnexus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitnexus.js","sourceRoot":"","sources":["../../../src/api/routes/gitnexus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,6CAA6C,CAAC;AAErD,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC/D,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEjE,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAOnC,KAAK,UAAU,eAAe,CAC5B,IAAY,EACZ,QAAgB,EAChB,IAAa;IAEb,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,GAAG,QAAQ,EAAE,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,6DAA6D;QAC7D,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,oCAAoC,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC/G,CAAC;QAED,MAAM,IAAI,GAAY,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACvC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,yBAAyB,OAAO,EAAE,EAAE,EAAE,CAAC;IACzF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,qBAAqB,EAAE,GAAG,OAAO,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,iDAAiD;IACjD,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAEtD,GAAG,CAAC,IAAI,CAAC;gBACP,OAAO;gBACP,OAAO;gBACP,IAAI,EAAE,YAAY;gBAClB,YAAY,EAAE,eAAe,EAAE;gBAC/B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,oBAAoB,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,oDAAoD;IACpD,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mDAAmD;IACnD,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;gBACjE,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC,CAAC;gBACvF,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAChG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC;gBAClE,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC,CAAC;gBACvF,OAAO;YACT,CAAC;YAED,mDAAmD;YACnD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACnG,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC1B,MAAM,CAAC,KAAK,CAAC,kEAAkE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjH,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrD,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnF,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;oBACrB,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;oBACxD,OAAO;gBACT,CAAC;gBACD,MAAM,WAAW,GAAG,oBAAoB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBAC5D,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC;gBAClE,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC,CAAC;gBACvF,OAAO;YACT,CAAC;YAED,mDAAmD;YACnD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAClG,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC1B,MAAM,CAAC,KAAK,CAAC,iEAAiE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAChH,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACpD,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnF,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;oBACrB,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;oBACxD,OAAO;gBACT,CAAC;gBACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9E,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/api/routes/graph.d.ts

@@ -0,0 +1,4 @@
+import { Router } from "express";
+import type { SqliteStore } from "../../core/store/sqlite-store.js";
+export declare function createGraphRouter(store: SqliteStore): Router;
+//# sourceMappingURL=graph.d.ts.map

package/dist/api/routes/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/api/routes/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAuC5D"}

package/dist/api/routes/graph.js

@@ -0,0 +1,39 @@
+import { Router } from "express";
+import { graphToMermaid } from "../../core/graph/mermaid-export.js";
+export function createGraphRouter(store) {
+    const router = Router();
+    router.get("/", (_req, res, next) => {
+        try {
+            const doc = store.toGraphDocument();
+            res.json(doc);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get("/mermaid", (req, res, next) => {
+        try {
+            const doc = store.toGraphDocument();
+            const format = req.query.format ?? "flowchart";
+            const direction = req.query.direction ?? "TD";
+            const filterStatus = req.query.status
+                ? req.query.status.split(",")
+                : undefined;
+            const filterType = req.query.type
+                ? req.query.type.split(",")
+                : undefined;
+            const mermaid = graphToMermaid(doc.nodes, doc.edges, {
+                format: format,
+                direction: direction,
+                filterStatus,
+                filterType,
+            });
+            res.type("text/plain").send(mermaid);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=graph.js.map

package/dist/api/routes/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/api/routes/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YAEpC,MAAM,MAAM,GAAI,GAAG,CAAC,KAAK,CAAC,MAAiB,IAAI,WAAW,CAAC;YAC3D,MAAM,SAAS,GAAI,GAAG,CAAC,KAAK,CAAC,SAAoB,IAAI,IAAI,CAAC;YAC1D,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM;gBACnC,CAAC,CAAE,GAAG,CAAC,KAAK,CAAC,MAAiB,CAAC,KAAK,CAAC,GAAG,CAAiB;gBACzD,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI;gBAC/B,CAAC,CAAE,GAAG,CAAC,KAAK,CAAC,IAAe,CAAC,KAAK,CAAC,GAAG,CAAe;gBACrD,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;gBACnD,MAAM,EAAE,MAAiC;gBACzC,SAAS,EAAE,SAAwB;gBACnC,YAAY;gBACZ,UAAU;aACX,CAAC,CAAC;YAEH,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/api/routes/import.d.ts

@@ -0,0 +1,4 @@
+import { Router } from "express";
+import type { SqliteStore } from "../../core/store/sqlite-store.js";
+export declare function createImportRouter(store: SqliteStore): Router;
+//# sourceMappingURL=import.d.ts.map

package/dist/api/routes/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../../src/api/routes/import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAQpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA0F7D"}

package/dist/api/routes/import.js

@@ -0,0 +1,92 @@
+import { Router } from "express";
+import multer from "multer";
+import { unlink } from "node:fs/promises";
+import { readFileContent, isSupportedFormat } from "../../core/parser/file-reader.js";
+import { extractEntities } from "../../core/parser/extract.js";
+import { convertToGraph } from "../../core/importer/prd-to-graph.js";
+import { logger } from "../../core/utils/logger.js";
+const upload = multer({ dest: "/tmp/mcp-graph-uploads/" });
+export function createImportRouter(store) {
+    const router = Router();
+    router.post("/", upload.single("file"), async (req, res, next) => {
+        const file = req.file;
+        if (!file) {
+            res.status(400).json({ error: "No file uploaded. Send a file with field name 'file'." });
+            return;
+        }
+        if (!isSupportedFormat(file.originalname)) {
+            await cleanupFile(file.path);
+            res.status(400).json({
+                error: `Unsupported file format. Supported: .md, .txt, .pdf, .html, .htm`,
+            });
+            return;
+        }
+        try {
+            // Ensure project is initialized
+            if (!store.getProject()) {
+                store.initProject();
+            }
+            const force = req.body?.force === "true" || req.body?.force === true;
+            const sourceFileName = file.originalname;
+            // Check for previous import
+            const alreadyImported = store.hasImport(sourceFileName);
+            if (alreadyImported && !force) {
+                await cleanupFile(file.path);
+                res.status(409).json({
+                    error: `File "${sourceFileName}" was already imported. Set force=true to re-import.`,
+                    sourceFile: sourceFileName,
+                });
+                return;
+            }
+            // Clear previous import if force
+            let cleared = null;
+            if (alreadyImported && force) {
+                cleared = store.clearImportedNodes(sourceFileName);
+            }
+            // Read file content
+            const { text } = await readFileContent(file.path, file.originalname);
+            // Extract entities
+            const extraction = extractEntities(text);
+            // Convert to graph
+            const { nodes, edges, stats } = convertToGraph(extraction, sourceFileName);
+            // Bulk insert
+            store.bulkInsert(nodes, edges);
+            // Record import + snapshot
+            store.recordImport(sourceFileName, stats.nodesCreated, stats.edgesCreated);
+            store.createSnapshot();
+            logger.info("Import via API complete", {
+                file: sourceFileName,
+                nodes: stats.nodesCreated,
+                edges: stats.edgesCreated,
+            });
+            res.status(201).json({
+                ok: true,
+                sourceFile: sourceFileName,
+                ...stats,
+                ...(cleared
+                    ? {
+                        reimported: true,
+                        previousNodesDeleted: cleared.nodesDeleted,
+                        previousEdgesDeleted: cleared.edgesDeleted,
+                    }
+                    : {}),
+            });
+        }
+        catch (err) {
+            next(err);
+        }
+        finally {
+            await cleanupFile(file.path);
+        }
+    });
+    return router;
+}
+async function cleanupFile(filePath) {
+    try {
+        await unlink(filePath);
+    }
+    catch {
+        // File may already be cleaned up
+    }
+}
+//# sourceMappingURL=import.js.map

package/dist/api/routes/import.js.map

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

package/dist/api/routes/insights.d.ts

@@ -0,0 +1,4 @@
+import { Router } from "express";
+import type { SqliteStore } from "../../core/store/sqlite-store.js";
+export declare function createInsightsRouter(store: SqliteStore, basePath: string): Router;
+//# sourceMappingURL=insights.d.ts.map

package/dist/api/routes/insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../src/api/routes/insights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAKpE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmCjF"}

package/dist/api/routes/insights.js

@@ -0,0 +1,40 @@
+import { Router } from "express";
+import { detectBottlenecks } from "../../core/insights/bottleneck-detector.js";
+import { scanSkills, recommendSkills } from "../../core/insights/skill-recommender.js";
+import { calculateMetrics } from "../../core/insights/metrics-calculator.js";
+export function createInsightsRouter(store, basePath) {
+    const router = Router();
+    router.get("/bottlenecks", (_req, res, next) => {
+        try {
+            const doc = store.toGraphDocument();
+            const report = detectBottlenecks(doc);
+            res.json(report);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get("/recommendations", async (_req, res, next) => {
+        try {
+            const doc = store.toGraphDocument();
+            const skills = await scanSkills(basePath);
+            const recommendations = recommendSkills(doc, skills);
+            res.json({ recommendations });
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    router.get("/metrics", (_req, res, next) => {
+        try {
+            const doc = store.toGraphDocument();
+            const metrics = calculateMetrics(doc);
+            res.json(metrics);
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=insights.js.map

package/dist/api/routes/insights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../../src/api/routes/insights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAE7E,MAAM,UAAU,oBAAoB,CAAC,KAAkB,EAAE,QAAgB;IACvE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,eAAe,GAAG,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACrD,GAAG,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/api/routes/integrations.d.ts

@@ -0,0 +1,4 @@
+import { Router } from "express";
+import type { SqliteStore } from "../../core/store/sqlite-store.js";
+export declare function createIntegrationsRouter(store: SqliteStore, basePath: string): Router;
+//# sourceMappingURL=integrations.d.ts.map

package/dist/api/routes/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../../src/api/routes/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAMpE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+ErF"}