@sirius-mcp/mcp 1.4.0

package/dist/app/reindex.d.ts

@@ -0,0 +1,27 @@
+import { type McpError } from "../errors.js";
+import { type IndexedDocument } from "../domain/index.js";
+import { type IndexWriterPort } from "../domain/index-writer.js";
+import { type LicensePort } from "../domain/license.js";
+export interface ReindexWarning {
+    path: string;
+    reason: string;
+}
+export interface ReindexResult {
+    indexed: number;
+    skipped: number;
+    warnings: ReindexWarning[];
+}
+export interface StoreCollection {
+    docs: IndexedDocument[];
+    warnings: ReindexWarning[];
+    skipped: number;
+}
+export declare function reindexContextStore(root: string, writer: IndexWriterPort, licensePort?: LicensePort, hardGate?: boolean): Promise<{
+    success: true;
+    data: ReindexResult;
+} | {
+    success: false;
+    error: McpError;
+}>;
+export declare function collectStoreDocuments(root: string): Promise<StoreCollection>;
+//# sourceMappingURL=reindex.d.ts.map

package/dist/app/reindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.d.ts","sourceRoot":"","sources":["../../src/app/reindex.ts"],"names":[],"mappings":"AAOA,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,WAAW,GAAE,WAA4B,EACzC,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CA8CvF;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBlF"}

package/dist/app/reindex.js

@@ -0,0 +1,97 @@
+import { loadProjectConfig, configLoadError } from "./loadProjectConfig.js";
+import { listDocumentFiles, readDocumentByPath, } from "../adapters/fs/structure.js";
+import { parseDocumentMarkdown } from "../schemas/document.js";
+import { mcpError, toMcpError } from "../errors.js";
+import {} from "../domain/index.js";
+import {} from "../domain/index-writer.js";
+import { devLicensePort } from "../domain/license.js";
+import { licenseGate } from "./license-gate.js";
+import { resolve } from "node:path";
+export async function reindexContextStore(root, writer, licensePort = devLicensePort, hardGate = false) {
+    const gate = await licenseGate({
+        tool: "reindex",
+        licensePort,
+        hardGate,
+        mode: "write",
+    });
+    if (gate) {
+        return { success: false, error: gate };
+    }
+    const config = await loadProjectConfig(root);
+    if (config.kind !== "ok") {
+        return { success: false, error: configLoadError(config) };
+    }
+    if (!writer.isOpen()) {
+        return {
+            success: false,
+            error: mcpError("INDEX_NOT_OPEN", "Search index is not open."),
+        };
+    }
+    try {
+        const collected = await collectStoreDocuments(root);
+        const outcome = await writer.rebuild(collected.docs);
+        if (!outcome.ok) {
+            return {
+                success: false,
+                error: mcpError("REINDEX_FAILED", `Index rebuild failed: ${outcome.reason ?? "unknown error"}`),
+            };
+        }
+        return {
+            success: true,
+            data: {
+                indexed: collected.docs.length,
+                skipped: collected.skipped,
+                warnings: [...collected.warnings, ...writer.takeWarnings()],
+            },
+        };
+    }
+    catch (err) {
+        return { success: false, error: toMcpError(err, "REINDEX_FAILED") };
+    }
+}
+export async function collectStoreDocuments(root) {
+    const docs = [];
+    const warnings = [];
+    let skipped = 0;
+    const files = await listDocumentFiles(root);
+    for (const file of files) {
+        const collected = await collectIndexedDocument(root, file);
+        if (collected === null) {
+            skipped++;
+            continue;
+        }
+        if ("doc" in collected) {
+            docs.push(collected.doc);
+        }
+        else {
+            skipped++;
+            warnings.push({ path: collected.path, reason: collected.reason });
+        }
+    }
+    return { docs, warnings, skipped };
+}
+async function collectIndexedDocument(root, file) {
+    if (file.warning) {
+        return { path: file.path, reason: file.warning };
+    }
+    const absolutePath = resolve(root, file.path);
+    const content = await readDocumentByPath(absolutePath);
+    if (content === null) {
+        return null;
+    }
+    const parsed = parseDocumentMarkdown(content);
+    if (!parsed.success) {
+        return { path: file.path, reason: parsed.error.message };
+    }
+    return {
+        doc: {
+            id: parsed.data.frontmatter.id,
+            type: parsed.data.frontmatter.type,
+            status: parsed.data.frontmatter.status,
+            title: parsed.data.frontmatter.title,
+            body: parsed.data.body,
+            path: file.path,
+        },
+    };
+}
+//# sourceMappingURL=reindex.js.map

package/dist/app/reindex.js.map

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

package/dist/app/search-orchestrator.d.ts

@@ -0,0 +1,13 @@
+import { type IndexPort } from "../domain/index.js";
+import { type HybridSearchEngine, type HybridSearchHit } from "../domain/hybrid-search.js";
+import { type SqliteVecAdapter } from "../adapters/db/sqlite-vec-adapter.js";
+import { type EmbeddingPort } from "../domain/embedding-port.js";
+export declare class SearchOrchestrator {
+    private readonly ftsIndex;
+    private readonly sqliteVecAdapter?;
+    private readonly embeddingPort?;
+    private readonly hybridEngine;
+    constructor(ftsIndex: IndexPort, sqliteVecAdapter?: SqliteVecAdapter | undefined, embeddingPort?: EmbeddingPort | undefined, hybridEngine?: HybridSearchEngine);
+    search(query: string, limit?: number): Promise<HybridSearchHit[]>;
+}
+//# sourceMappingURL=search-orchestrator.d.ts.map

package/dist/app/search-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-orchestrator.d.ts","sourceRoot":"","sources":["../../src/app/search-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAIrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IALjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;gBAG/B,QAAQ,EAAE,SAAS,EACnB,gBAAgB,CAAC,EAAE,gBAAgB,YAAA,EACnC,aAAa,CAAC,EAAE,aAAa,YAAA,EAC9C,YAAY,CAAC,EAAE,kBAAkB;IAK7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAoDnE"}

package/dist/app/search-orchestrator.js

@@ -0,0 +1,63 @@
+import {} from "../domain/index.js";
+import { DefaultHybridSearchEngine, } from "../domain/hybrid-search.js";
+import {} from "../adapters/db/sqlite-vec-adapter.js";
+import {} from "../domain/embedding-port.js";
+export class SearchOrchestrator {
+    ftsIndex;
+    sqliteVecAdapter;
+    embeddingPort;
+    hybridEngine;
+    constructor(ftsIndex, sqliteVecAdapter, embeddingPort, hybridEngine) {
+        this.ftsIndex = ftsIndex;
+        this.sqliteVecAdapter = sqliteVecAdapter;
+        this.embeddingPort = embeddingPort;
+        this.hybridEngine = hybridEngine ?? new DefaultHybridSearchEngine();
+    }
+    async search(query, limit = 5) {
+        const trimmed = query.trim();
+        if (!trimmed) {
+            return [];
+        }
+        // 1. Lexical search via FTS5
+        let lexicalHits = [];
+        if (this.ftsIndex.isOpen()) {
+            const rawHits = this.ftsIndex.search(trimmed, limit * 2);
+            lexicalHits = rawHits.map((h, idx) => ({
+                id: h.id,
+                type: h.type,
+                status: h.status,
+                title: h.title,
+                path: h.path,
+                snippet: h.snippet,
+                rank: idx + 1,
+            }));
+        }
+        // 2. Vector search via sqlite-vec + embedding
+        const vectorHits = [];
+        if (this.sqliteVecAdapter && this.embeddingPort) {
+            try {
+                const queryEmbedding = await this.embeddingPort.embed(trimmed);
+                const knnResults = this.sqliteVecAdapter.searchKNN(queryEmbedding, limit * 2);
+                for (let i = 0; i < knnResults.length; i++) {
+                    const res = knnResults[i];
+                    const doc = this.sqliteVecAdapter.getDocByIdentity(res.doc_rowid);
+                    if (doc) {
+                        vectorHits.push({
+                            id: doc.id,
+                            type: doc.type,
+                            distance: res.distance,
+                            rank: i + 1,
+                            path: doc.path,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Fall back gracefully to lexical only (AD-F2-18)
+            }
+        }
+        // 3. Reciprocal Rank Fusion
+        return this.hybridEngine.fuse(trimmed, lexicalHits, vectorHits, { limit });
+    }
+}
+//# sourceMappingURL=search-orchestrator.js.map

package/dist/app/search-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-orchestrator.js","sourceRoot":"","sources":["../../src/app/search-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAKL,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAyB,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAsB,MAAM,6BAA6B,CAAC;AAEjE,MAAM,OAAO,kBAAkB;IAIV;IACA;IACA;IALF,YAAY,CAAqB;IAElD,YACmB,QAAmB,EACnB,gBAAmC,EACnC,aAA6B,EAC9C,YAAiC;QAHhB,aAAQ,GAAR,QAAQ,CAAW;QACnB,qBAAgB,GAAhB,gBAAgB,CAAmB;QACnC,kBAAa,GAAb,aAAa,CAAgB;QAG9C,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,yBAAyB,EAAE,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,6BAA6B;QAC7B,IAAI,WAAW,GAAiB,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACzD,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;gBACrC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,IAAI,EAAE,GAAG,GAAG,CAAC;aACd,CAAC,CAAC,CAAC;QACN,CAAC;QAED,8CAA8C;QAC9C,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAChD,IAAI,CAAC;gBACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAChD,cAAc,EACd,KAAK,GAAG,CAAC,CACV,CAAC;gBAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC3C,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;oBAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAClE,IAAI,GAAG,EAAE,CAAC;wBACR,UAAU,CAAC,IAAI,CAAC;4BACd,EAAE,EAAE,GAAG,CAAC,EAAE;4BACV,IAAI,EAAE,GAAG,CAAC,IAAI;4BACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;4BACtB,IAAI,EAAE,CAAC,GAAG,CAAC;4BACX,IAAI,EAAE,GAAG,CAAC,IAAI;yBACf,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kDAAkD;YACpD,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/dist/app/search.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { type McpError } from "../errors.js";
+import { type IndexPort, type SearchHit } from "../domain/index.js";
+import { type LicensePort } from "../domain/license.js";
+import { type SearchOrchestrator } from "./search-orchestrator.js";
+import { type HybridSearchHit } from "../domain/hybrid-search.js";
+export declare const SearchInput: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit?: number | undefined;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;
+export type SearchInput = z.infer<typeof SearchInput>;
+export interface SearchResult {
+    hits: (SearchHit | HybridSearchHit)[];
+}
+export declare function searchContextStore(root: string, input: SearchInput, indexPort: IndexPort, licensePort?: LicensePort, hardGate?: boolean, orchestrator?: SearchOrchestrator): Promise<{
+    success: true;
+    data: SearchResult;
+} | {
+    success: false;
+    error: McpError;
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/app/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/app/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,eAAO,MAAM,WAAW;;;;;;;;;EAGtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,CAAC,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC;CACvC;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,SAAS,EACpB,WAAW,GAAE,WAA4B,EACzC,QAAQ,GAAE,OAAe,EACzB,YAAY,CAAC,EAAE,kBAAkB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CAoCtF"}

package/dist/app/search.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { loadProjectConfig, configLoadError } from "./loadProjectConfig.js";
+import { mcpError, toMcpError } from "../errors.js";
+import {} from "../domain/index.js";
+import { devLicensePort } from "../domain/license.js";
+import { licenseGate } from "./license-gate.js";
+import {} from "./search-orchestrator.js";
+import {} from "../domain/hybrid-search.js";
+export const SearchInput = z.object({
+    query: z.string().min(1, "query is required"),
+    limit: z.number().int().min(1).max(5, "limit must be between 1 and 5").optional(),
+});
+export async function searchContextStore(root, input, indexPort, licensePort = devLicensePort, hardGate = false, orchestrator) {
+    const gate = await licenseGate({
+        tool: "context_search",
+        licensePort,
+        hardGate,
+        mode: "read",
+    });
+    if (gate) {
+        return { success: false, error: gate };
+    }
+    const config = await loadProjectConfig(root);
+    if (config.kind !== "ok") {
+        return { success: false, error: configLoadError(config) };
+    }
+    if (!indexPort.isOpen()) {
+        return {
+            success: false,
+            error: mcpError("INDEX_NOT_OPEN", "Search index is not open."),
+        };
+    }
+    try {
+        const validated = SearchInput.parse(input);
+        const limit = validated.limit ?? 5;
+        const hits = orchestrator
+            ? await orchestrator.search(validated.query, limit)
+            : indexPort.search(validated.query, limit);
+        return { success: true, data: { hits } };
+    }
+    catch (err) {
+        return { success: false, error: toMcpError(err, "SEARCH_FAILED") };
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/app/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/app/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAiB,MAAM,cAAc,CAAC;AACnE,OAAO,EAAkC,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAoB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAA2B,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAwB,MAAM,4BAA4B,CAAC;AAElE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC,CAAC,QAAQ,EAAE;CAClF,CAAC,CAAC;AAQH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,KAAkB,EAClB,SAAoB,EACpB,cAA2B,cAAc,EACzC,WAAoB,KAAK,EACzB,YAAiC;IAEjC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC;QAC7B,IAAI,EAAE,gBAAgB;QACtB,WAAW;QACX,QAAQ;QACR,IAAI,EAAE,MAAM;KACb,CAAC,CAAC;IACH,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,QAAQ,CACb,gBAAgB,EAChB,2BAA2B,CAC5B;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,YAAY;YACvB,CAAC,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;YACnD,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/app/upsert.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { type DocumentType } from "../adapters/fs/structure.js";
+import { type McpError } from "../errors.js";
+import { type IndexWriterPort } from "../domain/index-writer.js";
+import { type LicensePort } from "../domain/license.js";
+export declare const UpsertDocumentInput: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["feature", "business-rule", "decision", "component", "architecture"]>;
+    status: z.ZodEnum<["draft", "active", "deprecated", "superseded"]>;
+    title: z.ZodString;
+    updated: z.ZodString;
+    related: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodOptional<z.ZodEnum<["feature", "business-rule", "decision", "component", "architecture"]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+    }, {
+        id: string;
+        type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+    }>, "many">>>, {
+        id: string;
+        type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+    }[] | undefined, {
+        id: string;
+        type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+    }[] | null | undefined>;
+    code_refs: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>, string[] | undefined, string[] | null | undefined>;
+    tags: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>, string[] | undefined, string[] | null | undefined>;
+    summary: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | undefined, string | null | undefined>;
+} & {
+    body: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: "feature" | "business-rule" | "decision" | "component" | "architecture";
+    status: "draft" | "active" | "deprecated" | "superseded";
+    title: string;
+    updated: string;
+    body: string;
+    related?: {
+        id: string;
+        type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+    }[] | undefined;
+    code_refs?: string[] | undefined;
+    tags?: string[] | undefined;
+    summary?: string | undefined;
+}, {
+    id: string;
+    type: "feature" | "business-rule" | "decision" | "component" | "architecture";
+    status: "draft" | "active" | "deprecated" | "superseded";
+    title: string;
+    updated: string;
+    body: string;
+    related?: {
+        id: string;
+        type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+    }[] | null | undefined;
+    code_refs?: string[] | null | undefined;
+    tags?: string[] | null | undefined;
+    summary?: string | null | undefined;
+}>;
+export type UpsertDocumentInput = z.infer<typeof UpsertDocumentInput>;
+export interface UpsertDocumentArgs extends UpsertDocumentInput {
+    root: string;
+}
+export type UpsertDocumentResult = {
+    success: true;
+    indexUpdate: "ok" | "failed";
+} | {
+    success: false;
+    error: McpError;
+};
+export declare function upsertDocument(args: UpsertDocumentArgs, writer?: IndexWriterPort, licensePort?: LicensePort, hardGate?: boolean): Promise<UpsertDocumentResult>;
+export declare function validateDocumentPath(root: string, type: DocumentType, id: string): McpError | null;
+//# sourceMappingURL=upsert.d.ts.map

package/dist/app/upsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../src/app/upsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,IAAI,GAAG,QAAQ,CAAA;CAAE,GAC/C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAExC,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,EACxB,MAAM,CAAC,EAAE,eAAe,EACxB,WAAW,GAAE,WAA4B,EACzC,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAoD/B;AAoBD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,MAAM,GACT,QAAQ,GAAG,IAAI,CAkBjB"}

package/dist/app/upsert.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { loadProjectConfig, configLoadError } from "./loadProjectConfig.js";
+import { DocumentFrontmatter, buildDocumentMarkdown, } from "../schemas/document.js";
+import { writeDocument, documentPath } from "../adapters/fs/structure.js";
+import { mcpError, toMcpError } from "../errors.js";
+import { resolve, relative } from "node:path";
+import {} from "../domain/index-writer.js";
+import { devLicensePort } from "../domain/license.js";
+import { licenseGate } from "./license-gate.js";
+export const UpsertDocumentInput = DocumentFrontmatter.extend({
+    body: z.string(),
+});
+export async function upsertDocument(args, writer, licensePort = devLicensePort, hardGate = false) {
+    try {
+        const gate = await licenseGate({
+            tool: "context_upsert",
+            licensePort,
+            hardGate,
+            mode: "write",
+        });
+        if (gate) {
+            return { success: false, error: gate };
+        }
+        const config = await loadProjectConfig(args.root);
+        if (config.kind !== "ok") {
+            return { success: false, error: configLoadError(config) };
+        }
+        const validated = UpsertDocumentInput.parse(args);
+        const pathError = validateDocumentPath(args.root, validated.type, validated.id);
+        if (pathError) {
+            return { success: false, error: pathError };
+        }
+        const frontmatter = {
+            id: validated.id,
+            type: validated.type,
+            status: validated.status,
+            title: validated.title,
+            updated: validated.updated,
+            related: validated.related,
+            code_refs: validated.code_refs,
+            tags: validated.tags,
+            summary: validated.summary,
+        };
+        const markdown = buildDocumentMarkdown(frontmatter, validated.body);
+        await writeDocument(args.root, validated.type, validated.id, markdown);
+        const indexUpdate = await updateIndex(writer, {
+            id: validated.id,
+            type: validated.type,
+            status: validated.status,
+            title: validated.title,
+            body: validated.body,
+            path: `.context/${validated.type}/${validated.id}.md`,
+        });
+        return { success: true, indexUpdate };
+    }
+    catch (err) {
+        return { success: false, error: toMcpError(err, "UPSERT_FAILED") };
+    }
+}
+async function updateIndex(writer, doc) {
+    if (!writer || !writer.isOpen()) {
+        return "failed";
+    }
+    const outcome = await writer.upsert(doc);
+    return outcome.ok ? "ok" : "failed";
+}
+export function validateDocumentPath(root, type, id) {
+    if (!id || id.length === 0) {
+        return mcpError("VALIDATION_ERROR", "id is required", { field: "id" });
+    }
+    const target = documentPath(root, type, id);
+    const contextRoot = resolve(root, ".context");
+    const rel = relative(contextRoot, target);
+    if (rel.startsWith("..") || rel.includes("..")) {
+        return mcpError("INVALID_PATH", `Document path escapes the context store: ${type}/${id}`, { field: "id", path: rel });
+    }
+    return null;
+}
+//# sourceMappingURL=upsert.js.map

package/dist/app/upsert.js.map

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

package/dist/app/vector-backfill.d.ts

@@ -0,0 +1,27 @@
+import { type SqliteVecAdapter } from "../adapters/db/sqlite-vec-adapter.js";
+import { type EmbeddingPort } from "../domain/embedding-port.js";
+export interface VectorBackfillTask {
+    type: string;
+    id: string;
+    title: string;
+    body: string;
+    path: string;
+    tags?: string[];
+}
+export declare class VectorBackfillQueue {
+    private readonly vecAdapter;
+    private readonly embeddingPort;
+    private readonly batchSize;
+    private queue;
+    private inFlightCount;
+    private running;
+    private idleResolvers;
+    constructor(vecAdapter: SqliteVecAdapter, embeddingPort: EmbeddingPort, batchSize?: number);
+    enqueue(task: VectorBackfillTask): void;
+    enqueueBatch(tasks: VectorBackfillTask[]): void;
+    pendingCount(): number;
+    idle(): Promise<void>;
+    private scheduleProcess;
+    private process;
+}
+//# sourceMappingURL=vector-backfill.d.ts.map

package/dist/app/vector-backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-backfill.d.ts","sourceRoot":"","sources":["../../src/app/vector-backfill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qBAAa,mBAAmB;IAO5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAsB;gBAGxB,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,EAC5B,SAAS,SAAK;IAGjC,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAKvC,YAAY,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAK/C,YAAY,IAAI,MAAM;IAIhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,OAAO,CAAC,eAAe;YAQT,OAAO;CA4CtB"}

package/dist/app/vector-backfill.js

@@ -0,0 +1,78 @@
+import {} from "../adapters/db/sqlite-vec-adapter.js";
+import {} from "../domain/embedding-port.js";
+export class VectorBackfillQueue {
+    vecAdapter;
+    embeddingPort;
+    batchSize;
+    queue = [];
+    inFlightCount = 0;
+    running = false;
+    idleResolvers = [];
+    constructor(vecAdapter, embeddingPort, batchSize = 16) {
+        this.vecAdapter = vecAdapter;
+        this.embeddingPort = embeddingPort;
+        this.batchSize = batchSize;
+    }
+    enqueue(task) {
+        this.queue.push(task);
+        this.scheduleProcess();
+    }
+    enqueueBatch(tasks) {
+        this.queue.push(...tasks);
+        this.scheduleProcess();
+    }
+    pendingCount() {
+        return this.queue.length + this.inFlightCount;
+    }
+    async idle() {
+        if (this.pendingCount() === 0 && !this.running) {
+            return;
+        }
+        return new Promise((resolve) => {
+            this.idleResolvers.push(resolve);
+        });
+    }
+    scheduleProcess() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        void this.process();
+    }
+    async process() {
+        while (this.queue.length > 0) {
+            const chunk = this.queue.splice(0, this.batchSize);
+            this.inFlightCount = chunk.length;
+            const texts = chunk.map((task) => {
+                const tagStr = (task.tags ?? []).join(" ");
+                return `${task.title}\n\n${tagStr}\n\n${task.body}`;
+            });
+            try {
+                const embeddings = await this.embeddingPort.embedBatch(texts);
+                for (let i = 0; i < chunk.length; i++) {
+                    const task = chunk[i];
+                    const embedding = embeddings[i];
+                    if (embedding) {
+                        const hash = `${task.title}:${task.body.length}:${Date.now()}`;
+                        const rowid = this.vecAdapter.upsertDocRow(task.type, task.id, task.path, hash);
+                        this.vecAdapter.upsertVector(rowid, embedding);
+                    }
+                }
+            }
+            catch {
+                // Continue processing remaining tasks without throwing
+            }
+            this.inFlightCount = 0;
+            if (this.queue.length > 0) {
+                await new Promise((resolve) => setImmediate(resolve));
+            }
+        }
+        this.running = false;
+        const resolvers = [...this.idleResolvers];
+        this.idleResolvers = [];
+        for (const resolve of resolvers) {
+            resolve();
+        }
+    }
+}
+//# sourceMappingURL=vector-backfill.js.map

package/dist/app/vector-backfill.js.map

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