@folterung/project-memory 0.1.19 → 0.1.21

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

@@ -0,0 +1,24 @@
+import type { FastifyInstance } from "fastify";
+import type { QdrantClient } from "@qdrant/js-client-rest";
+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;
+}
+export declare function registerPointsRoutes(app: FastifyInstance, options: {
+    qdrantHost?: string;
+    qdrantPort?: number;
+    collection?: string;
+    qdrantClient?: QdrantClient;
+}): void;

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

@@ -0,0 +1,60 @@
+import { createQdrantClient } from "../qdrant/client.js";
+import { retrievePointsById } from "../qdrant/client.js";
+const BATCH_MAX_IDS = 20;
+function payloadToItem(id, payload) {
+    return {
+        id,
+        text: payload.text ?? "",
+        path: payload.path,
+        startLine: payload.startLine,
+        endLine: payload.endLine,
+        symbol: payload.symbol,
+        kind: payload.kind,
+        indexedAt: payload.indexedAt,
+        storedAt: payload.storedAt,
+        source: payload.source,
+        supersededById: payload.supersededById,
+    };
+}
+export function registerPointsRoutes(app, options) {
+    const client = options.qdrantClient ??
+        createQdrantClient(options.qdrantHost ?? "127.0.0.1", options.qdrantPort ?? 6333);
+    const collection = options.collection ?? "project_memory";
+    app.post("/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)];
+        const points = await retrievePointsById(client, collection, uniqueIds);
+        const items = points.map((p) => payloadToItem(p.id, p.payload));
+        await reply.send({ items });
+    });
+}
+//# sourceMappingURL=points.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"points.js","sourceRoot":"","sources":["../../src/api/points.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,aAAa,GAAG,EAAE,CAAC;AAoBzB,SAAS,aAAa,CAAC,EAAU,EAAE,OAAqB;IACtD,OAAO;QACL,EAAE;QACF,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAA+B;QAClD,OAAO,EAAE,OAAO,CAAC,OAA6B;QAC9C,MAAM,EAAE,OAAO,CAAC,MAA4B;QAC5C,IAAI,EAAE,OAAO,CAAC,IAA0B;QACxC,SAAS,EAAE,OAAO,CAAC,SAA+B;QAClD,QAAQ,EAAE,OAAO,CAAC,QAA8B;QAChD,MAAM,EAAE,OAAO,CAAC,MAA4B;QAC5C,cAAc,EAAE,OAAO,CAAC,cAAoC;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,GAAoB,EACpB,OAAuG;IAEvG,MAAM,MAAM,GACV,OAAO,CAAC,YAAY;QACpB,kBAAkB,CAAC,OAAO,CAAC,UAAU,IAAI,WAAW,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,CAAC;IAE1D,GAAG,CAAC,IAAI,CACN,eAAe,EACf;QACE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,KAAK,CAAC;gBACjB,UAAU,EAAE;oBACV,GAAG,EAAE;wBACH,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;qBAC1B;iBACF;aACF;SACF;KACF,EACD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC3B,UAAU,EAAE,GAAG;gBACf,KAAK,EAAE,aAAa;gBACpB,OAAO,EAAE,qCAAqC,GAAG,aAAa,GAAG,SAAS;aAC3E,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YAC/B,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC3B,UAAU,EAAE,GAAG;gBACf,KAAK,EAAE,aAAa;gBACpB,OAAO,EAAE,2BAA2B,GAAG,aAAa,GAAG,QAAQ;aAChE,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAa,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACvE,MAAM,KAAK,GAAgB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7E,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9B,CAAC,CACF,CAAC;AACJ,CAAC"}

package/packages/server/dist/api/points.test.d.ts

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

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

@@ -0,0 +1,105 @@
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import Fastify from "fastify";
+import { registerPointsRoutes } from "./points.js";
+function createMockPointsClient() {
+    return {
+        retrieve: async (_collection, opts) => 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",
+            },
+        })),
+    };
+}
+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 () => [] };
+        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);
+    });
+});
+//# sourceMappingURL=points.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"points.test.js","sourceRoot":"","sources":["../../src/api/points.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,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,SAAS,sBAAsB;IAC7B,OAAO;QACL,QAAQ,EAAE,KAAK,EAAE,WAAmB,EAAE,IAAuB,EAAE,EAAE,CAC/D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACpB,EAAE;YACF,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,iBAAiB,EAAE,EAAE;gBAC3B,IAAI,EAAE,gBAAgB;gBACtB,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,EAAE;gBACX,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,0BAA0B;gBACrC,MAAM,EAAE,OAAO;aAChB;SACF,CAAC,CAAU;KACY,CAAC;AAC/B,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,oBAAoB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,eAAe;YACpB,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,oBAAoB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,eAAe;YACpB,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,oBAAoB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,eAAe;YACpB,OAAO,EAAE,EAAE,GAAG,EAAE;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,oBAAoB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,eAAe;YACpB,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE;SACzC,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;QACvD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QAChD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;QAC/D,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAChC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,oBAAoB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,eAAe;YACpB,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,SAAS,GAAG,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,EAA6B,CAAC;QAC1E,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,oBAAoB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,eAAe;YACpB,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE;SACjC,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -1,7 +1,14 @@
 import type { FastifyInstance } from "fastify";
+import type { QdrantClient } from "@qdrant/js-client-rest";
 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<{
@@ -19,10 +26,19 @@ export interface SearchResponse {
         text: string;
         path?: string;
         score?: number;
+        startLine?: number;
+        endLine?: number;
+        symbol?: string;
+        kind?: string;
+        indexedAt?: string;
+        storedAt?: string;
+        source?: string;
+        supersededById?: string;
     }>;
 }
 export declare function registerSearchRoutes(app: FastifyInstance, options: {
     qdrantHost?: string;
     qdrantPort?: number;
     collection?: string;
+    qdrantClient?: QdrantClient;
 }): void;

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

@@ -2,7 +2,8 @@ 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 client = options.qdrantClient ??
+        createQdrantClient(options.qdrantHost ?? "127.0.0.1", options.qdrantPort ?? 6333);
     const collection = options.collection ?? "project_memory";
     app.post("/search", {
         schema: {
@@ -12,33 +13,50 @@ export function registerSearchRoutes(app, options) {
                 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, refsOnlyMode) => refsOnlyMode && raw.length > 80 ? raw.slice(0, 80) + "…" : raw;
         const response = {
             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,
+                endLine: r.payload.endLine,
+                symbol: r.payload.symbol,
+                kind: r.payload.kind,
+                indexedAt: r.payload.indexedAt,
+                storedAt: r.payload.storedAt,
+                source: r.payload.source,
+                supersededById: r.payload.supersededById,
             })),
         };
         await reply.send(response);

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

@@ -1 +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,CACN,SAAS,EACT;QACE,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,OAAO,CAAC;gBACnB,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;aACF;SACF;KACF,EACD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAExC,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,EAAE,YAAY,CAAC,CAAC;SAC5F,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"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/api/search.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1,102 @@
+import { strict as assert } from "node:assert";
+import { describe, it } from "node:test";
+import Fastify from "fastify";
+import { registerSearchRoutes } from "./search.js";
+function createMockSearchClient() {
+    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: {} } } } }),
+        search: async () => searchResult,
+    };
+}
+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: {} } } } }),
+            search: async () => [
+                {
+                    id: "id1",
+                    score: 0.9,
+                    payload: { kind: "chunk", text: longText },
+                },
+            ],
+        };
+        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);
+    });
+});
+//# sourceMappingURL=search.test.js.map

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

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

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

@@ -1,11 +1,18 @@
 import type { FastifyInstance } from "fastify";
+import type { QdrantClient } from "@qdrant/js-client-rest";
 export interface StoreBody {
     content: string;
     title?: string;
     path?: string;
+    startLine?: number;
+    endLine?: number;
+    symbol?: string;
+    scope?: string;
+    supersedesId?: string;
 }
 export declare function registerStoreRoutes(app: FastifyInstance, options: {
     qdrantHost?: string;
     qdrantPort?: number;
     collection?: string;
+    qdrantClient?: QdrantClient;
 }): void;

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

@@ -9,11 +9,14 @@ function buildTextToEmbed(body) {
         parts.push(`File: ${body.path}`);
     if (body.title)
         parts.push(`Title: ${body.title}`);
+    if (body.symbol)
+        parts.push(`Symbol: ${body.symbol}`);
     parts.push(body.content);
     return parts.join("\n\n");
 }
 export function registerStoreRoutes(app, options) {
-    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("/store", {
         schema: {
@@ -24,15 +27,43 @@ export function registerStoreRoutes(app, options) {
                     content: { type: "string" },
                     title: { type: ["string", "null"] },
                     path: { type: ["string", "null"] },
+                    startLine: { type: ["number", "null"] },
+                    endLine: { type: ["number", "null"] },
+                    symbol: { type: ["string", "null"] },
+                    scope: { type: ["string", "null"] },
+                    supersedesId: { type: ["string", "null"] },
                 },
             },
         },
     }, async (request, reply) => {
         const raw = request.body;
+        const startLine = raw.startLine != null ? Number(raw.startLine) : undefined;
+        const endLine = raw.endLine != null ? Number(raw.endLine) : undefined;
+        if (startLine != null && (!Number.isInteger(startLine) || startLine < 1)) {
+            await reply.status(400).send({
+                statusCode: 400,
+                error: "Bad Request",
+                message: "startLine must be a positive integer when provided",
+            });
+            return;
+        }
+        if (endLine != null && (!Number.isInteger(endLine) || endLine < 1)) {
+            await reply.status(400).send({
+                statusCode: 400,
+                error: "Bad Request",
+                message: "endLine must be a positive integer when provided",
+            });
+            return;
+        }
         const body = {
             content: raw.content ?? "",
             title: raw.title ?? undefined,
             path: raw.path ?? undefined,
+            startLine,
+            endLine,
+            symbol: raw.symbol ?? undefined,
+            scope: raw.scope ?? undefined,
+            supersedesId: raw.supersedesId ?? undefined,
         };
         const content = body.content.trim();
         if (!content) {
@@ -46,17 +77,29 @@ export function registerStoreRoutes(app, options) {
         const textToEmbed = buildTextToEmbed({ ...body, content });
         const vector = embedText(textToEmbed);
         const id = randomUUID();
+        const storedAt = new Date().toISOString();
+        const source = body.title?.trim().toLowerCase().startsWith("session summary")
+            ? "session-summary"
+            : "store";
+        const payload = {
+            kind: KIND_AGENT_NOTE,
+            path: body.path,
+            title: body.title,
+            text: content,
+            storedAt,
+            source,
+            ...(body.startLine != null && { startLine: body.startLine }),
+            ...(body.endLine != null && { endLine: body.endLine }),
+            ...(body.symbol != null && { symbol: body.symbol }),
+            ...(body.scope != null && { scope: body.scope }),
+            ...(body.supersedesId != null && { supersedesId: body.supersedesId }),
+        };
         await ensureCollection(client, collection);
         await upsertPoints(client, collection, [
             {
                 id,
                 vector,
-                payload: {
-                    kind: KIND_AGENT_NOTE,
-                    path: body.path,
-                    title: body.title,
-                    text: content,
-                },
+                payload,
             },
         ]);
         await reply.send({ id: `${KIND_AGENT_NOTE}:${id}`, message: "Stored." });

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

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

package/packages/server/dist/api/store.test.d.ts

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