@folterung/project-memory 0.1.0

package/packages/server/dist/api/explain.d.ts

@@ -0,0 +1,6 @@
+import type { FastifyInstance } from "fastify";
+export declare function registerExplainRoutes(app: FastifyInstance, options: {
+    qdrantHost?: string;
+    qdrantPort?: number;
+    collection?: string;
+}): void;

package/packages/server/dist/api/explain.js

@@ -0,0 +1,16 @@
+import { createQdrantClient } from "../qdrant/client.js";
+import { embedText } from "../embedding/stub.js";
+import { searchPoints } from "../qdrant/client.js";
+export function registerExplainRoutes(app, options) {
+    const client = createQdrantClient(options.qdrantHost ?? "127.0.0.1", options.qdrantPort ?? 6333);
+    const collection = options.collection ?? "project_memory";
+    app.get("/explain/:symbol", async (request, reply) => {
+        const symbol = decodeURIComponent(request.params.symbol);
+        const vector = embedText(symbol);
+        const results = await searchPoints(client, collection, vector, 3);
+        const snippet = results[0]?.payload?.text ?? "";
+        const path = results[0]?.payload?.path;
+        await reply.send({ symbol, snippet, path, results: results.length });
+    });
+}
+//# sourceMappingURL=explain.js.map

package/packages/server/dist/api/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/api/explain.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,UAAU,qBAAqB,CACnC,GAAoB,EACpB,OAA0E;IAE1E,MAAM,MAAM,GAAG,kBAAkB,CAC/B,OAAO,CAAC,UAAU,IAAI,WAAW,EACjC,OAAO,CAAC,UAAU,IAAI,IAAI,CAC3B,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,CAAC;IAE1D,GAAG,CAAC,GAAG,CAAiC,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACnF,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC;QACvC,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/server/dist/api/health.d.ts

@@ -0,0 +1,7 @@
+import type { FastifyInstance } from "fastify";
+export declare function registerHealthRoutes(app: FastifyInstance, options: {
+    cwd: string;
+    qdrantHost?: string;
+    qdrantPort?: number;
+    collection?: string;
+}): void;

package/packages/server/dist/api/health.js

@@ -0,0 +1,43 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { createQdrantClient } from "../qdrant/client.js";
+const DEEP_INDEX_STATE_FILE = ".mem/state/deep-index.json";
+function getDeepIndexProgress(cwd) {
+    const path = join(cwd, DEEP_INDEX_STATE_FILE);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = readFileSync(path, "utf8");
+        const data = JSON.parse(raw);
+        const embedded = data.embedded ?? (Array.isArray(data.embeddedIds) ? data.embeddedIds.length : 0);
+        const total = data.total ?? 0;
+        const percent = total > 0 ? Math.round((embedded / total) * 100) : 0;
+        return { percent, embedded, total };
+    }
+    catch {
+        return null;
+    }
+}
+export function registerHealthRoutes(app, options) {
+    const client = createQdrantClient(options.qdrantHost ?? "127.0.0.1", options.qdrantPort ?? 6333);
+    const collection = options.collection ?? "project_memory";
+    app.get("/health", async (_request, reply) => {
+        let qdrant = false;
+        try {
+            await client.getCollection(collection);
+            qdrant = true;
+        }
+        catch {
+            // ignore
+        }
+        const deepIndexProgress = getDeepIndexProgress(options.cwd);
+        const indexVersion = deepIndexProgress ? `phase1+${deepIndexProgress.embedded}` : "phase1";
+        await reply.send({
+            status: qdrant ? "ok" : "degraded",
+            qdrant,
+            indexVersion,
+            deepIndexProgress: deepIndexProgress ?? undefined,
+        });
+    });
+}
+//# sourceMappingURL=health.js.map

package/packages/server/dist/api/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/api/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAE3D,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkE,CAAC;QAC9F,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,GAAoB,EACpB,OAAuF;IAEvF,MAAM,MAAM,GAAG,kBAAkB,CAC/B,OAAO,CAAC,UAAU,IAAI,WAAW,EACjC,OAAO,CAAC,UAAU,IAAI,IAAI,CAC3B,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,CAAC;IAE1D,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC3C,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACvC,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAG,iBAAiB,CAAC,CAAC,CAAC,UAAU,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3F,MAAM,KAAK,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU;YAClC,MAAM;YACN,YAAY;YACZ,iBAAiB,EAAE,iBAAiB,IAAI,SAAS;SAClD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/server/dist/api/refresh.d.ts

@@ -0,0 +1,2 @@
+import type { FastifyInstance } from "fastify";
+export declare function registerRefreshRoutes(app: FastifyInstance): void;

package/packages/server/dist/api/refresh.js

@@ -0,0 +1,8 @@
+export function registerRefreshRoutes(app) {
+    app.post("/refresh", async (_request, reply) => {
+        await reply.send({
+            message: "Refresh triggered. Run mem scaffold or mem update from CLI to re-index.",
+        });
+    });
+}
+//# sourceMappingURL=refresh.js.map

package/packages/server/dist/api/refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../src/api/refresh.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,GAAoB;IACxD,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,KAAK,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,yEAAyE;SACnF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/server/dist/api/search.d.ts

@@ -0,0 +1,28 @@
+import type { FastifyInstance } from "fastify";
+export interface SearchBody {
+    query: string;
+    limit?: number;
+}
+export interface SearchResponse {
+    systemMaps: Array<{
+        id: string;
+        text: string;
+        path?: string;
+    }>;
+    moduleSummaries: Array<{
+        id: string;
+        text: string;
+        path?: string;
+    }>;
+    chunks: Array<{
+        id: string;
+        text: string;
+        path?: string;
+        score?: number;
+    }>;
+}
+export declare function registerSearchRoutes(app: FastifyInstance, options: {
+    qdrantHost?: string;
+    qdrantPort?: number;
+    collection?: string;
+}): void;

package/packages/server/dist/api/search.js

@@ -0,0 +1,36 @@
+import { createQdrantClient } from "../qdrant/client.js";
+import { embedText } from "../embedding/stub.js";
+import { searchPoints, searchPointsKinds } from "../qdrant/client.js";
+export function registerSearchRoutes(app, options) {
+    const client = createQdrantClient(options.qdrantHost ?? "127.0.0.1", options.qdrantPort ?? 6333);
+    const collection = options.collection ?? "project_memory";
+    app.post("/search", async (request, reply) => {
+        const { query, limit = 20 } = request.body ?? {};
+        const vector = embedText(query ?? "");
+        const [systemMaps, moduleSummaries, chunks] = await Promise.all([
+            searchPoints(client, collection, vector, 5, "system_map"),
+            searchPoints(client, collection, vector, 10, "module_summary"),
+            searchPointsKinds(client, collection, vector, limit, ["chunk", "entrypoint"]),
+        ]);
+        const response = {
+            systemMaps: systemMaps.map((r) => ({
+                id: r.id,
+                text: r.payload.text ?? "",
+                path: r.payload.path,
+            })),
+            moduleSummaries: moduleSummaries.map((r) => ({
+                id: r.id,
+                text: r.payload.text ?? "",
+                path: r.payload.path,
+            })),
+            chunks: chunks.map((r) => ({
+                id: r.id,
+                text: r.payload.text ?? "",
+                path: r.payload.path,
+                score: r.score,
+            })),
+        };
+        await reply.send(response);
+    });
+}
+//# sourceMappingURL=search.js.map

package/packages/server/dist/api/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/api/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAatE,MAAM,UAAU,oBAAoB,CAClC,GAAoB,EACpB,OAA0E;IAE1E,MAAM,MAAM,GAAG,kBAAkB,CAC/B,OAAO,CAAC,UAAU,IAAI,WAAW,EACjC,OAAO,CAAC,UAAU,IAAI,IAAI,CAC3B,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,CAAC;IAE1D,GAAG,CAAC,IAAI,CAAuB,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACjE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAEtC,MAAM,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9D,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,CAAC;YACzD,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,gBAAgB,CAAC;YAC9D,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;SAC9E,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAmB;YAC/B,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE;gBAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,eAAe,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3C,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE;gBAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE;gBAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC;SACJ,CAAC;QACF,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/server/dist/api/system.d.ts

@@ -0,0 +1,6 @@
+import type { FastifyInstance } from "fastify";
+export declare function registerSystemRoutes(app: FastifyInstance, options: {
+    qdrantHost?: string;
+    qdrantPort?: number;
+    collection?: string;
+}): void;

package/packages/server/dist/api/system.js

@@ -0,0 +1,17 @@
+import { createQdrantClient } from "../qdrant/client.js";
+import { searchPoints } from "../qdrant/client.js";
+export function registerSystemRoutes(app, options) {
+    const client = createQdrantClient(options.qdrantHost ?? "127.0.0.1", options.qdrantPort ?? 6333);
+    const collection = options.collection ?? "project_memory";
+    app.get("/system/overview", async (_request, reply) => {
+        const vector = new Array(384).fill(0).map((_, i) => Math.sin(i * 0.1) * 0.5 + 0.5);
+        const results = await searchPoints(client, collection, vector, 10, "system_map");
+        const overview = results.map((r) => ({
+            id: r.id,
+            text: r.payload.text ?? "",
+            path: r.payload.path,
+        }));
+        await reply.send({ overview });
+    });
+}
+//# sourceMappingURL=system.js.map

package/packages/server/dist/api/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/api/system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAClC,GAAoB,EACpB,OAA0E;IAE1E,MAAM,MAAM,GAAG,kBAAkB,CAC/B,OAAO,CAAC,UAAU,IAAI,WAAW,EACjC,OAAO,CAAC,UAAU,IAAI,IAAI,CAC3B,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,CAAC;IAE1D,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;QACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE;YAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI;SACrB,CAAC,CAAC,CAAC;QACJ,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/server/dist/embedding/stub.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Stub embedder: deterministic pseudo-vector from text (same text -> same vector).
+ * V1 local default; replace with real model (e.g. transformers.js) later.
+ */
+export declare function embedText(text: string): number[];
+export declare function embedBatch(texts: string[]): number[][];
+export declare function getVectorSize(): number;

package/packages/server/dist/embedding/stub.js

@@ -0,0 +1,30 @@
+const VECTOR_SIZE = 384;
+function simpleHash(str) {
+    let h = 0;
+    for (let i = 0; i < str.length; i++) {
+        h = (h * 31 + str.charCodeAt(i)) >>> 0;
+    }
+    return h;
+}
+/**
+ * Stub embedder: deterministic pseudo-vector from text (same text -> same vector).
+ * V1 local default; replace with real model (e.g. transformers.js) later.
+ */
+export function embedText(text) {
+    const vec = [];
+    const words = text.split(/\s+/).filter(Boolean);
+    for (let i = 0; i < VECTOR_SIZE; i++) {
+        const seed = words[i % words.length]
+            ? simpleHash(words[i % words.length]) + i * 31
+            : i;
+        vec.push(Math.sin(seed) * 0.5 + 0.5);
+    }
+    return vec;
+}
+export function embedBatch(texts) {
+    return texts.map(embedText);
+}
+export function getVectorSize() {
+    return VECTOR_SIZE;
+}
+//# sourceMappingURL=stub.js.map

package/packages/server/dist/embedding/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../src/embedding/stub.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;YAClC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE;YAC9C,CAAC,CAAC,CAAC,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/packages/server/dist/embedding/stub.test.d.ts

@@ -0,0 +1 @@
+export {};

package/packages/server/dist/embedding/stub.test.js

@@ -0,0 +1,25 @@
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import { embedText, embedBatch, getVectorSize } from "./stub.js";
+describe("embedding stub (server)", () => {
+    it("getVectorSize returns 384", () => {
+        assert.strictEqual(getVectorSize(), 384);
+    });
+    it("embedText returns array of length 384", () => {
+        const vec = embedText("hello world");
+        assert.strictEqual(vec.length, 384);
+        assert.ok(vec.every((x) => typeof x === "number" && x >= 0 && x <= 1));
+    });
+    it("embedText is deterministic for same input", () => {
+        const a = embedText("same text");
+        const b = embedText("same text");
+        assert.deepStrictEqual(a, b);
+    });
+    it("embedBatch returns one vector per text", () => {
+        const batch = embedBatch(["a", "b"]);
+        assert.strictEqual(batch.length, 2);
+        assert.strictEqual(batch[0].length, 384);
+        assert.strictEqual(batch[1].length, 384);
+    });
+});
+//# sourceMappingURL=stub.test.js.map

package/packages/server/dist/embedding/stub.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.test.js","sourceRoot":"","sources":["../../src/embedding/stub.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEjE,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACzC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/packages/server/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/packages/server/dist/index.js

@@ -0,0 +1,26 @@
+import Fastify from "fastify";
+import { registerHealthRoutes } from "./api/health.js";
+import { registerSearchRoutes } from "./api/search.js";
+import { registerExplainRoutes } from "./api/explain.js";
+import { registerSystemRoutes } from "./api/system.js";
+import { registerRefreshRoutes } from "./api/refresh.js";
+const PORT = Number(process.env.MEM_SERVER_PORT) || 31415;
+const CWD = process.env.MEM_CWD || process.cwd();
+const QDRANT_HOST = process.env.MEM_QDRANT_HOST || "127.0.0.1";
+const QDRANT_PORT = Number(process.env.MEM_QDRANT_PORT) || 6333;
+const COLLECTION = process.env.MEM_COLLECTION || "project_memory";
+async function main() {
+    const app = Fastify({ logger: true });
+    registerHealthRoutes(app, { cwd: CWD, qdrantHost: QDRANT_HOST, qdrantPort: QDRANT_PORT, collection: COLLECTION });
+    registerSearchRoutes(app, { qdrantHost: QDRANT_HOST, qdrantPort: QDRANT_PORT, collection: COLLECTION });
+    registerExplainRoutes(app, { qdrantHost: QDRANT_HOST, qdrantPort: QDRANT_PORT, collection: COLLECTION });
+    registerSystemRoutes(app, { qdrantHost: QDRANT_HOST, qdrantPort: QDRANT_PORT, collection: COLLECTION });
+    registerRefreshRoutes(app);
+    await app.listen({ port: PORT, host: "127.0.0.1" });
+    console.log(`Memory server at http://127.0.0.1:${PORT}`);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/packages/server/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC;AAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AACjD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,WAAW,CAAC;AAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC;AAChE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,gBAAgB,CAAC;AAElE,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,oBAAoB,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAClH,oBAAoB,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IACxG,qBAAqB,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IACzG,oBAAoB,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IACxG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAE3B,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/packages/server/dist/qdrant/client.d.ts

@@ -0,0 +1,24 @@
+import { QdrantClient } from "@qdrant/js-client-rest";
+export declare function createQdrantClient(host?: string, port?: number): QdrantClient;
+export declare function ensureCollection(client: QdrantClient, collectionName?: string): Promise<void>;
+export interface PointPayload {
+    kind: string;
+    path?: string;
+    text: string;
+    [key: string]: unknown;
+}
+export declare function upsertPoints(client: QdrantClient, collectionName: string, points: {
+    id: string;
+    vector: number[];
+    payload: PointPayload;
+}[]): Promise<void>;
+export declare function searchPoints(client: QdrantClient, collectionName: string, vector: number[], limit?: number, filterKind?: string): Promise<{
+    id: string;
+    score: number;
+    payload: PointPayload;
+}[]>;
+export declare function searchPointsKinds(client: QdrantClient, collectionName: string, vector: number[], limit: number, kinds: string[]): Promise<{
+    id: string;
+    score: number;
+    payload: PointPayload;
+}[]>;

package/packages/server/dist/qdrant/client.js

@@ -0,0 +1,55 @@
+import { QdrantClient } from "@qdrant/js-client-rest";
+import { getVectorSize } from "../embedding/stub.js";
+const DEFAULT_COLLECTION = "project_memory";
+export function createQdrantClient(host = "127.0.0.1", port = 6333) {
+    return new QdrantClient({ url: `http://${host}:${port}` });
+}
+export async function ensureCollection(client, collectionName = DEFAULT_COLLECTION) {
+    const size = getVectorSize();
+    try {
+        await client.getCollection(collectionName);
+    }
+    catch {
+        await client.createCollection(collectionName, {
+            vectors: { size, distance: "Cosine" },
+        });
+    }
+}
+export async function upsertPoints(client, collectionName, points) {
+    if (points.length === 0)
+        return;
+    await client.upsert(collectionName, {
+        wait: true,
+        points: points.map((p) => ({
+            id: p.id,
+            vector: p.vector,
+            payload: p.payload,
+        })),
+    });
+}
+export async function searchPoints(client, collectionName, vector, limit = 10, filterKind) {
+    const filter = filterKind
+        ? { must: [{ key: "kind", match: { value: filterKind } }] }
+        : undefined;
+    return doSearch(client, collectionName, vector, limit, filter);
+}
+export async function searchPointsKinds(client, collectionName, vector, limit, kinds) {
+    const filter = kinds.length > 0
+        ? { should: kinds.map((k) => ({ key: "kind", match: { value: k } })) }
+        : undefined;
+    return doSearch(client, collectionName, vector, limit, filter);
+}
+async function doSearch(client, collectionName, vector, limit, filter) {
+    const result = await client.search(collectionName, {
+        vector,
+        limit,
+        with_payload: true,
+        filter,
+    });
+    return result.map((r) => ({
+        id: r.id ?? String(r.id),
+        score: r.score ?? 0,
+        payload: (r.payload ?? {}),
+    }));
+}
+//# sourceMappingURL=client.js.map

package/packages/server/dist/qdrant/client.js.map

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

package/packages/server/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@project-memory/server",
+  "version": "0.1.0",
+  "description": "Project Memory HTTP API — health, search, explain",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "node --watch dist/index.js",
+    "test": "npm run build && c8 node --test dist/",
+    "test:no-coverage": "npm run build && node --test dist/"
+  },
+  "c8": {
+    "exclude": ["**/*.test.js", "**/index.js"],
+    "include": ["dist/**/*.js"],
+    "check-coverage": true,
+    "lines": 85,
+    "functions": 85,
+    "branches": 85,
+    "statements": 85,
+    "reporter": ["text", "lcov"],
+    "reports-dir": "coverage"
+  },
+  "dependencies": {
+    "fastify": "^4.24.3",
+    "@qdrant/js-client-rest": "^1.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "c8": "^9.1.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/packages/server/src/api/explain.ts

@@ -0,0 +1,24 @@
+import type { FastifyInstance } from "fastify";
+import { createQdrantClient } from "../qdrant/client.js";
+import { embedText } from "../embedding/stub.js";
+import { searchPoints } from "../qdrant/client.js";
+
+export function registerExplainRoutes(
+  app: FastifyInstance,
+  options: { qdrantHost?: string; qdrantPort?: number; collection?: string }
+): void {
+  const client = createQdrantClient(
+    options.qdrantHost ?? "127.0.0.1",
+    options.qdrantPort ?? 6333
+  );
+  const collection = options.collection ?? "project_memory";
+
+  app.get<{ Params: { symbol: string } }>("/explain/:symbol", async (request, reply) => {
+    const symbol = decodeURIComponent(request.params.symbol);
+    const vector = embedText(symbol);
+    const results = await searchPoints(client, collection, vector, 3);
+    const snippet = results[0]?.payload?.text ?? "";
+    const path = results[0]?.payload?.path;
+    await reply.send({ symbol, snippet, path, results: results.length });
+  });
+}

package/packages/server/src/api/health.ts

@@ -0,0 +1,50 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import type { FastifyInstance } from "fastify";
+import { createQdrantClient } from "../qdrant/client.js";
+
+const DEEP_INDEX_STATE_FILE = ".mem/state/deep-index.json";
+
+function getDeepIndexProgress(cwd: string): { percent: number; embedded: number; total: number } | null {
+  const path = join(cwd, DEEP_INDEX_STATE_FILE);
+  if (!existsSync(path)) return null;
+  try {
+    const raw = readFileSync(path, "utf8");
+    const data = JSON.parse(raw) as { embedded?: number; total?: number; embeddedIds?: string[] };
+    const embedded = data.embedded ?? (Array.isArray(data.embeddedIds) ? data.embeddedIds.length : 0);
+    const total = data.total ?? 0;
+    const percent = total > 0 ? Math.round((embedded / total) * 100) : 0;
+    return { percent, embedded, total };
+  } catch {
+    return null;
+  }
+}
+
+export function registerHealthRoutes(
+  app: FastifyInstance,
+  options: { cwd: string; qdrantHost?: string; qdrantPort?: number; collection?: string }
+): void {
+  const client = createQdrantClient(
+    options.qdrantHost ?? "127.0.0.1",
+    options.qdrantPort ?? 6333
+  );
+  const collection = options.collection ?? "project_memory";
+
+  app.get("/health", async (_request, reply) => {
+    let qdrant = false;
+    try {
+      await client.getCollection(collection);
+      qdrant = true;
+    } catch {
+      // ignore
+    }
+    const deepIndexProgress = getDeepIndexProgress(options.cwd);
+    const indexVersion = deepIndexProgress ? `phase1+${deepIndexProgress.embedded}` : "phase1";
+    await reply.send({
+      status: qdrant ? "ok" : "degraded",
+      qdrant,
+      indexVersion,
+      deepIndexProgress: deepIndexProgress ?? undefined,
+    });
+  });
+}

package/packages/server/src/api/refresh.ts

@@ -0,0 +1,9 @@
+import type { FastifyInstance } from "fastify";
+
+export function registerRefreshRoutes(app: FastifyInstance): void {
+  app.post("/refresh", async (_request, reply) => {
+    await reply.send({
+      message: "Refresh triggered. Run mem scaffold or mem update from CLI to re-index.",
+    });
+  });
+}

package/packages/server/src/api/search.ts

@@ -0,0 +1,57 @@
+import type { FastifyInstance } from "fastify";
+import { createQdrantClient } from "../qdrant/client.js";
+import { embedText } from "../embedding/stub.js";
+import { searchPoints, searchPointsKinds } from "../qdrant/client.js";
+
+export interface SearchBody {
+  query: string;
+  limit?: number;
+}
+
+export interface SearchResponse {
+  systemMaps: Array<{ id: string; text: string; path?: string }>;
+  moduleSummaries: Array<{ id: string; text: string; path?: string }>;
+  chunks: Array<{ id: string; text: string; path?: string; score?: number }>;
+}
+
+export function registerSearchRoutes(
+  app: FastifyInstance,
+  options: { qdrantHost?: string; qdrantPort?: number; collection?: string }
+): void {
+  const client = createQdrantClient(
+    options.qdrantHost ?? "127.0.0.1",
+    options.qdrantPort ?? 6333
+  );
+  const collection = options.collection ?? "project_memory";
+
+  app.post<{ Body: SearchBody }>("/search", async (request, reply) => {
+    const { query, limit = 20 } = request.body ?? {};
+    const vector = embedText(query ?? "");
+
+    const [systemMaps, moduleSummaries, chunks] = await Promise.all([
+      searchPoints(client, collection, vector, 5, "system_map"),
+      searchPoints(client, collection, vector, 10, "module_summary"),
+      searchPointsKinds(client, collection, vector, limit, ["chunk", "entrypoint"]),
+    ]);
+
+    const response: SearchResponse = {
+      systemMaps: systemMaps.map((r) => ({
+        id: r.id,
+        text: r.payload.text ?? "",
+        path: r.payload.path,
+      })),
+      moduleSummaries: moduleSummaries.map((r) => ({
+        id: r.id,
+        text: r.payload.text ?? "",
+        path: r.payload.path,
+      })),
+      chunks: chunks.map((r) => ({
+        id: r.id,
+        text: r.payload.text ?? "",
+        path: r.payload.path,
+        score: r.score,
+      })),
+    };
+    await reply.send(response);
+  });
+}

package/packages/server/src/api/system.ts

@@ -0,0 +1,25 @@
+import type { FastifyInstance } from "fastify";
+import { createQdrantClient } from "../qdrant/client.js";
+import { searchPoints } from "../qdrant/client.js";
+
+export function registerSystemRoutes(
+  app: FastifyInstance,
+  options: { qdrantHost?: string; qdrantPort?: number; collection?: string }
+): void {
+  const client = createQdrantClient(
+    options.qdrantHost ?? "127.0.0.1",
+    options.qdrantPort ?? 6333
+  );
+  const collection = options.collection ?? "project_memory";
+
+  app.get("/system/overview", async (_request, reply) => {
+    const vector = new Array(384).fill(0).map((_, i) => Math.sin(i * 0.1) * 0.5 + 0.5);
+    const results = await searchPoints(client, collection, vector, 10, "system_map");
+    const overview = results.map((r) => ({
+      id: r.id,
+      text: r.payload.text ?? "",
+      path: r.payload.path,
+    }));
+    await reply.send({ overview });
+  });
+}