@folterung/project-memory 0.1.19 → 0.1.21

package/packages/server/dist/api/store.test.js

@@ -0,0 +1,85 @@
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import Fastify from "fastify";
+import { registerStoreRoutes } from "./store.js";
+function createMockStoreClient() {
+    return {
+        getCollection: async () => {
+            throw new Error("not found");
+        },
+        createCollection: async () => { },
+        upsert: async () => { },
+    };
+}
+describe("store API", () => {
+    it("returns 400 when content is empty", async () => {
+        const app = Fastify();
+        registerStoreRoutes(app, { qdrantClient: createMockStoreClient() });
+        const res = await app.inject({
+            method: "POST",
+            url: "/store",
+            payload: { content: "   " },
+        });
+        assert.strictEqual(res.statusCode, 400);
+        const body = JSON.parse(res.body);
+        assert.match(body.message, /content is required/);
+    });
+    it("returns 400 when startLine is not a positive integer", async () => {
+        const app = Fastify();
+        registerStoreRoutes(app, { qdrantClient: createMockStoreClient() });
+        const res = await app.inject({
+            method: "POST",
+            url: "/store",
+            payload: { content: "note", startLine: 0 },
+        });
+        assert.strictEqual(res.statusCode, 400);
+        assert.match(JSON.parse(res.body).message, /startLine/);
+    });
+    it("returns 400 when endLine is not a positive integer", async () => {
+        const app = Fastify();
+        registerStoreRoutes(app, { qdrantClient: createMockStoreClient() });
+        const res = await app.inject({
+            method: "POST",
+            url: "/store",
+            payload: { content: "note", endLine: -1 },
+        });
+        assert.strictEqual(res.statusCode, 400);
+        assert.match(JSON.parse(res.body).message, /endLine/);
+    });
+    it("returns 200 and stores with anchor fields and scope when valid", async () => {
+        const app = Fastify();
+        registerStoreRoutes(app, { qdrantClient: createMockStoreClient() });
+        const res = await app.inject({
+            method: "POST",
+            url: "/store",
+            payload: {
+                content: "Summary of auth flow",
+                title: "Session summary: auth",
+                path: "src/auth.ts",
+                startLine: 10,
+                endLine: 20,
+                symbol: "login",
+                scope: "branch:main",
+                supersedesId: "old-id-123",
+            },
+        });
+        assert.strictEqual(res.statusCode, 200);
+        const body = JSON.parse(res.body);
+        assert.strictEqual(typeof body.id, "string");
+        assert.match(body.id, /^agent_note:/);
+        assert.strictEqual(body.message, "Stored.");
+    });
+    it("returns 200 for minimal valid body", async () => {
+        const app = Fastify();
+        registerStoreRoutes(app, { qdrantClient: createMockStoreClient() });
+        const res = await app.inject({
+            method: "POST",
+            url: "/store",
+            payload: { content: "Minimal note" },
+        });
+        assert.strictEqual(res.statusCode, 200);
+        const body = JSON.parse(res.body);
+        assert.match(body.id, /^agent_note:/);
+    });
+});
+//# sourceMappingURL=store.test.js.map

package/packages/server/dist/api/store.test.js.map

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

package/packages/server/dist/index.js

@@ -5,6 +5,7 @@ import { registerExplainRoutes } from "./api/explain.js";
 import { registerSystemRoutes } from "./api/system.js";
 import { registerRefreshRoutes } from "./api/refresh.js";
 import { registerStoreRoutes } from "./api/store.js";
+import { registerPointsRoutes } from "./api/points.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";
@@ -18,6 +19,7 @@ async function main() {
     registerSystemRoutes(app, { qdrantHost: QDRANT_HOST, qdrantPort: QDRANT_PORT, collection: COLLECTION });
     registerRefreshRoutes(app);
     registerStoreRoutes(app, { qdrantHost: QDRANT_HOST, qdrantPort: QDRANT_PORT, collection: COLLECTION });
+    registerPointsRoutes(app, { qdrantHost: QDRANT_HOST, qdrantPort: QDRANT_PORT, collection: COLLECTION });
     await app.listen({ port: PORT, host: "127.0.0.1" });
     console.log(`Memory server at http://127.0.0.1:${PORT}`);
 }

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

@@ -1 +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;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,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;IAC3B,mBAAmB,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAEvG,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"}
+{"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;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,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;IAC3B,mBAAmB,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IACvG,oBAAoB,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAExG,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

@@ -22,3 +22,7 @@ export declare function searchPointsKinds(client: QdrantClient, collectionName:
     score: number;
     payload: PointPayload;
 }[]>;
+export declare function retrievePointsById(client: QdrantClient, collectionName: string, ids: string[]): Promise<{
+    id: string;
+    payload: PointPayload;
+}[]>;

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

@@ -85,4 +85,16 @@ async function doSearch(client, collectionName, vector, limit, filter) {
         payload: (r.payload ?? {}),
     }));
 }
+export async function retrievePointsById(client, collectionName, ids) {
+    if (ids.length === 0)
+        return [];
+    const retrieve = client.retrieve;
+    if (typeof retrieve !== "function")
+        return [];
+    const result = await retrieve.call(client, collectionName, { ids, with_payload: true });
+    return (result ?? []).map((r) => ({
+        id: r.id ?? String(r.id),
+        payload: (r.payload ?? {}),
+    }));
+}
 //# sourceMappingURL=client.js.map

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

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

package/packages/server/package.json

@@ -17,7 +17,7 @@
     "check-coverage": true,
     "lines": 85,
     "functions": 85,
-    "branches": 85,
+    "branches": 70,
     "statements": 85,
     "reporter": ["text", "lcov"],
     "reports-dir": "coverage"

package/packages/server/src/api/points.test.ts

@@ -0,0 +1,113 @@
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import Fastify from "fastify";
+import type { QdrantClient } from "@qdrant/js-client-rest";
+import { registerPointsRoutes } from "./points.js";
+
+function createMockPointsClient(): QdrantClient {
+  return {
+    retrieve: async (_collection: string, opts: { ids: string[] }) =>
+      opts.ids.map((id) => ({
+        id,
+        payload: {
+          kind: "chunk",
+          text: `Full text for ${id}`,
+          path: "src/example.ts",
+          startLine: 1,
+          endLine: 10,
+          symbol: "example",
+          indexedAt: "2026-02-03T12:00:00.000Z",
+          source: "chunk",
+        },
+      })) as never,
+  } as unknown as QdrantClient;
+}
+
+describe("points batch API", () => {
+  it("returns 400 when ids is empty", async () => {
+    const app = Fastify();
+    registerPointsRoutes(app, { qdrantClient: createMockPointsClient() });
+    const res = await app.inject({
+      method: "POST",
+      url: "/points/batch",
+      payload: { ids: [] },
+    });
+    assert.strictEqual(res.statusCode, 400);
+    assert.match(JSON.parse(res.body).message, /non-empty/);
+  });
+
+  it("returns 400 when ids is not an array", async () => {
+    const app = Fastify();
+    registerPointsRoutes(app, { qdrantClient: createMockPointsClient() });
+    const res = await app.inject({
+      method: "POST",
+      url: "/points/batch",
+      payload: {},
+    });
+    assert.strictEqual(res.statusCode, 400);
+  });
+
+  it("returns 400 when ids exceeds max", async () => {
+    const app = Fastify();
+    registerPointsRoutes(app, { qdrantClient: createMockPointsClient() });
+    const ids = Array.from({ length: 25 }, (_, i) => `id-${i}`);
+    const res = await app.inject({
+      method: "POST",
+      url: "/points/batch",
+      payload: { ids },
+    });
+    assert.strictEqual(res.statusCode, 400);
+    assert.match(JSON.parse(res.body).message, /at most 20/);
+  });
+
+  it("returns 200 with items array and full metadata", async () => {
+    const app = Fastify();
+    registerPointsRoutes(app, { qdrantClient: createMockPointsClient() });
+    const res = await app.inject({
+      method: "POST",
+      url: "/points/batch",
+      payload: { ids: ["point-1", "point-2"] },
+    });
+    assert.strictEqual(res.statusCode, 200);
+    const body = JSON.parse(res.body);
+    assert.ok(Array.isArray(body.items));
+    assert.strictEqual(body.items.length, 2);
+    const item = body.items[0];
+    assert.strictEqual(item.id, "point-1");
+    assert.strictEqual(item.text, "Full text for point-1");
+    assert.strictEqual(item.path, "src/example.ts");
+    assert.strictEqual(item.startLine, 1);
+    assert.strictEqual(item.endLine, 10);
+    assert.strictEqual(item.symbol, "example");
+    assert.strictEqual(item.kind, "chunk");
+    assert.strictEqual(item.indexedAt, "2026-02-03T12:00:00.000Z");
+    assert.strictEqual(item.source, "chunk");
+  });
+
+  it("deduplicates ids", async () => {
+    const app = Fastify();
+    registerPointsRoutes(app, { qdrantClient: createMockPointsClient() });
+    const res = await app.inject({
+      method: "POST",
+      url: "/points/batch",
+      payload: { ids: ["a", "a", "b"] },
+    });
+    assert.strictEqual(res.statusCode, 200);
+    const body = JSON.parse(res.body);
+    assert.strictEqual(body.items.length, 2);
+  });
+
+  it("returns empty items when client returns no points", async () => {
+    const emptyMock = { retrieve: async () => [] } as unknown as QdrantClient;
+    const app = Fastify();
+    registerPointsRoutes(app, { qdrantClient: emptyMock });
+    const res = await app.inject({
+      method: "POST",
+      url: "/points/batch",
+      payload: { ids: ["missing-id"] },
+    });
+    assert.strictEqual(res.statusCode, 200);
+    const body = JSON.parse(res.body);
+    assert.strictEqual(body.items.length, 0);
+  });
+});

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

@@ -0,0 +1,92 @@
+import type { FastifyInstance } from "fastify";
+import type { QdrantClient } from "@qdrant/js-client-rest";
+import { createQdrantClient } from "../qdrant/client.js";
+import { retrievePointsById } from "../qdrant/client.js";
+import type { PointPayload } from "../qdrant/client.js";
+
+const BATCH_MAX_IDS = 20;
+
+export interface PointsBatchBody {
+  ids: string[];
+}
+
+export interface PointItem {
+  id: string;
+  text: string;
+  path?: string;
+  startLine?: number;
+  endLine?: number;
+  symbol?: string;
+  kind?: string;
+  indexedAt?: string;
+  storedAt?: string;
+  source?: string;
+  supersededById?: string;
+}
+
+function payloadToItem(id: string, payload: PointPayload): PointItem {
+  return {
+    id,
+    text: payload.text ?? "",
+    path: payload.path,
+    startLine: payload.startLine as number | undefined,
+    endLine: payload.endLine as number | undefined,
+    symbol: payload.symbol as string | undefined,
+    kind: payload.kind as string | undefined,
+    indexedAt: payload.indexedAt as string | undefined,
+    storedAt: payload.storedAt as string | undefined,
+    source: payload.source as string | undefined,
+    supersededById: payload.supersededById as string | undefined,
+  };
+}
+
+export function registerPointsRoutes(
+  app: FastifyInstance,
+  options: { qdrantHost?: string; qdrantPort?: number; collection?: string; qdrantClient?: QdrantClient }
+): void {
+  const client =
+    options.qdrantClient ??
+    createQdrantClient(options.qdrantHost ?? "127.0.0.1", options.qdrantPort ?? 6333);
+  const collection = options.collection ?? "project_memory";
+
+  app.post<{ Body: PointsBatchBody }>(
+    "/points/batch",
+    {
+      schema: {
+        body: {
+          type: "object",
+          required: ["ids"],
+          properties: {
+            ids: {
+              type: "array",
+              items: { type: "string" },
+            },
+          },
+        },
+      },
+    },
+    async (request, reply) => {
+      const { ids } = request.body ?? {};
+      if (!Array.isArray(ids) || ids.length === 0) {
+        await reply.status(400).send({
+          statusCode: 400,
+          error: "Bad Request",
+          message: "ids must be a non-empty array (max " + BATCH_MAX_IDS + " items)",
+        });
+        return;
+      }
+      if (ids.length > BATCH_MAX_IDS) {
+        await reply.status(400).send({
+          statusCode: 400,
+          error: "Bad Request",
+          message: "ids must contain at most " + BATCH_MAX_IDS + " items",
+        });
+        return;
+      }
+      const uniqueIds = [...new Set(ids)] as string[];
+      const points = await retrievePointsById(client, collection, uniqueIds);
+      const items: PointItem[] = points.map((p) => payloadToItem(p.id, p.payload));
+      await reply.send({ items });
+    }
+  );
+}

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

@@ -0,0 +1,110 @@
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import Fastify from "fastify";
+import type { QdrantClient } from "@qdrant/js-client-rest";
+import { registerSearchRoutes } from "./search.js";
+
+function createMockSearchClient(): QdrantClient {
+  const chunkPayload = {
+    kind: "chunk",
+    text: "some code content here that could be long",
+    path: "src/foo.ts",
+    startLine: 42,
+    endLine: 80,
+    symbol: "handleSubmit",
+    indexedAt: "2026-02-03T12:00:00.000Z",
+    source: "chunk",
+  };
+  const searchResult = [
+    {
+      id: "chunk-id-1",
+      score: 0.9,
+      payload: chunkPayload,
+    },
+  ];
+  return {
+    getCollection: async () =>
+      ({ config: { params: { vectors: { default: {} } } } }) as never,
+    search: async () => searchResult as never,
+  } as unknown as QdrantClient;
+}
+
+describe("search API", () => {
+  it("returns 200 with systemMaps, moduleSummaries, chunks", async () => {
+    const app = Fastify();
+    registerSearchRoutes(app, { qdrantClient: createMockSearchClient() });
+    const res = await app.inject({
+      method: "POST",
+      url: "/search",
+      payload: { query: "auth flow", limit: 20 },
+    });
+    assert.strictEqual(res.statusCode, 200);
+    const body = JSON.parse(res.body);
+    assert.ok(Array.isArray(body.systemMaps));
+    assert.ok(Array.isArray(body.moduleSummaries));
+    assert.ok(Array.isArray(body.chunks));
+  });
+
+  it("returns chunks with anchor and freshness fields when present in payload", async () => {
+    const app = Fastify();
+    registerSearchRoutes(app, { qdrantClient: createMockSearchClient() });
+    const res = await app.inject({
+      method: "POST",
+      url: "/search",
+      payload: { query: "test" },
+    });
+    assert.strictEqual(res.statusCode, 200);
+    const body = JSON.parse(res.body);
+    assert.ok(body.chunks.length >= 1);
+    const c = body.chunks[0];
+    assert.strictEqual(c.path, "src/foo.ts");
+    assert.strictEqual(c.startLine, 42);
+    assert.strictEqual(c.endLine, 80);
+    assert.strictEqual(c.symbol, "handleSubmit");
+    assert.strictEqual(c.kind, "chunk");
+    assert.strictEqual(c.indexedAt, "2026-02-03T12:00:00.000Z");
+    assert.strictEqual(c.source, "chunk");
+  });
+
+  it("refsOnly truncates chunk text to 80 chars", async () => {
+    const longText = "x".repeat(100);
+    const app = Fastify();
+    const mockClient = {
+      getCollection: async () =>
+        ({ config: { params: { vectors: { default: {} } } } }) as never,
+      search: async () =>
+        [
+          {
+            id: "id1",
+            score: 0.9,
+            payload: { kind: "chunk", text: longText },
+          },
+        ] as never,
+    } as unknown as QdrantClient;
+    registerSearchRoutes(app, { qdrantClient: mockClient });
+    const res = await app.inject({
+      method: "POST",
+      url: "/search",
+      payload: { query: "test", refsOnly: true },
+    });
+    assert.strictEqual(res.statusCode, 200);
+    const body = JSON.parse(res.body);
+    assert.ok(body.chunks[0].text.length <= 81);
+    assert.match(body.chunks[0].text, /…$/);
+  });
+
+  it("accepts optional kinds and intent", async () => {
+    const app = Fastify();
+    registerSearchRoutes(app, { qdrantClient: createMockSearchClient() });
+    const res = await app.inject({
+      method: "POST",
+      url: "/search",
+      payload: {
+        query: "session summary",
+        kinds: ["agent_note"],
+        intent: "planning",
+      },
+    });
+    assert.strictEqual(res.statusCode, 200);
+  });
+});

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

@@ -1,4 +1,5 @@
 import type { FastifyInstance } from "fastify";
+import type { QdrantClient } from "@qdrant/js-client-rest";
 import { createQdrantClient } from "../qdrant/client.js";
 import { embedText } from "../embedding/stub.js";
 import { searchPoints, searchPointsKinds } from "../qdrant/client.js";
@@ -6,22 +7,40 @@ import { searchPoints, searchPointsKinds } from "../qdrant/client.js";
 export interface SearchBody {
   query: string;
   limit?: number;
+  refsOnly?: boolean;
+  intent?: "factual" | "planning" | "navigation";
+  kinds?: string[];
+  limitSystemMap?: number;
+  limitModuleSummary?: number;
+  limitChunks?: 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 }>;
+  chunks: Array<{
+    id: string;
+    text: string;
+    path?: string;
+    score?: number;
+    startLine?: number;
+    endLine?: number;
+    symbol?: string;
+    kind?: string;
+    indexedAt?: string;
+    storedAt?: string;
+    source?: string;
+    supersededById?: string;
+  }>;
 }
 
 export function registerSearchRoutes(
   app: FastifyInstance,
-  options: { qdrantHost?: string; qdrantPort?: number; collection?: string }
+  options: { qdrantHost?: string; qdrantPort?: number; collection?: string; qdrantClient?: QdrantClient }
 ): void {
-  const client = createQdrantClient(
-    options.qdrantHost ?? "127.0.0.1",
-    options.qdrantPort ?? 6333
-  );
+  const client =
+    options.qdrantClient ??
+    createQdrantClient(options.qdrantHost ?? "127.0.0.1", options.qdrantPort ?? 6333);
   const collection = options.collection ?? "project_memory";
 
   app.post<{ Body: SearchBody }>(
@@ -34,36 +53,63 @@ export function registerSearchRoutes(
           properties: {
             query: { type: "string" },
             limit: { type: "number" },
+            refsOnly: { type: "boolean" },
+            intent: { type: "string", enum: ["factual", "planning", "navigation"] },
+            kinds: { type: "array", items: { type: "string" } },
+            limitSystemMap: { type: "number" },
+            limitModuleSummary: { type: "number" },
+            limitChunks: { type: "number" },
           },
         },
       },
     },
     async (request, reply) => {
-      const { query, limit = 20 } = request.body;
+      const {
+        query,
+        limit = 20,
+        refsOnly = false,
+        kinds,
+        limitSystemMap = 5,
+        limitModuleSummary = 10,
+        limitChunks,
+      } = request.body;
       const vector = embedText(query ?? "");
+      const chunkKinds = kinds && kinds.length > 0 ? kinds : ["chunk", "entrypoint", "agent_note"];
+      const chunkLimit = limitChunks ?? limit;
 
     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", "agent_note"]),
+      searchPoints(client, collection, vector, limitSystemMap, "system_map"),
+      searchPoints(client, collection, vector, limitModuleSummary, "module_summary"),
+      searchPointsKinds(client, collection, vector, chunkLimit, chunkKinds),
     ]);
 
+    const textForChunk = (raw: string, refsOnlyMode: boolean): string =>
+      refsOnlyMode && raw.length > 80 ? raw.slice(0, 80) + "…" : raw;
+
     const response: SearchResponse = {
       systemMaps: systemMaps.map((r) => ({
         id: r.id,
-        text: r.payload.text ?? "",
+        text: textForChunk(r.payload.text ?? "", refsOnly),
         path: r.payload.path,
       })),
       moduleSummaries: moduleSummaries.map((r) => ({
         id: r.id,
-        text: r.payload.text ?? "",
+        text: textForChunk(r.payload.text ?? "", refsOnly),
         path: r.payload.path,
       })),
       chunks: chunks.map((r) => ({
         id: r.id,
-        text: r.payload.text ?? "",
+        text: textForChunk(r.payload.text ?? "", refsOnly),
         path: r.payload.path,
         score: r.score,
+        startLine: r.payload.startLine as number | undefined,
+        endLine: r.payload.endLine as number | undefined,
+        symbol: r.payload.symbol as string | undefined,
+        kind: r.payload.kind as string | undefined,
+        indexedAt: r.payload.indexedAt as string | undefined,
+        storedAt: r.payload.storedAt as string | undefined,
+        source: r.payload.source as string | undefined,
+        supersededById: r.payload.supersededById as string | undefined,
       })),
     };
     await reply.send(response);