@jingyi0605/codingns 0.8.1 → 0.9.0

package/dist/server/modules/affairs-indexer/core/src/services/mcp/mcp-stdio-server.js

@@ -0,0 +1,264 @@
+import fs from "node:fs";
+import readline from "node:readline";
+import { CatalogRepository } from "../../repositories/catalog-repository.js";
+const MCP_PROTOCOL_VERSION = "2025-06-18";
+const MCP_SERVER_INFO = {
+    name: "doc-semantic-index",
+    title: "doc-semantic-index Node MCP",
+    version: "0.1.0",
+};
+function writeStdoutMessage(message) {
+    process.stdout.write(`${JSON.stringify(message)}\n`);
+}
+function makeTextToolResult(text, structuredContent) {
+    return {
+        content: [
+            {
+                type: "text",
+                text,
+            },
+        ],
+        ...(structuredContent ? { structuredContent } : {}),
+        isError: false,
+    };
+}
+function makeErrorToolResult(message, structuredContent) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: message,
+            },
+        ],
+        ...(structuredContent ? { structuredContent } : {}),
+        isError: true,
+    };
+}
+/**
+ * 最小 MCP stdio 服务。
+ * 当前阶段只实现 initialize / ping / tools/list / tools/call 四类最小读链能力。
+ */
+export class McpStdioServer {
+    config;
+    repository;
+    initialized = false;
+    constructor(config) {
+        this.config = config;
+        this.repository = new CatalogRepository(config.dbPath);
+    }
+    listTools() {
+        return [
+            {
+                name: "search_documents",
+                title: "搜索文档",
+                description: "按 query 在 SQLite 元数据中搜索文档，返回路径、标题、摘要与修改时间。",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: { type: "string", description: "搜索关键词" },
+                        limit: { type: "number", description: "返回结果数量，默认 10" },
+                    },
+                    required: ["query"],
+                },
+            },
+            {
+                name: "get_document_context",
+                title: "获取文档上下文",
+                description: "按 documentId 或 path 查询文档上下文。",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        documentId: { type: "string", description: "文档 ID" },
+                        path: { type: "string", description: "相对路径" },
+                    },
+                },
+            },
+            {
+                name: "browse_tags",
+                title: "浏览标签树",
+                description: "按 rootType 或 parentPath 浏览标签节点。",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        rootType: { type: "string", description: "根分类" },
+                        parentPath: { type: "string", description: "父标签路径" },
+                    },
+                },
+            },
+            {
+                name: "get_index_status",
+                title: "查看索引状态",
+                description: "读取当前索引目录、导出状态与基础存在性信息。",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+        ];
+    }
+    readIndexStatus() {
+        let exportStatus = null;
+        const statusPath = `${this.config.exportDir}/status.json`;
+        if (fs.existsSync(statusPath)) {
+            try {
+                exportStatus = JSON.parse(fs.readFileSync(statusPath, "utf-8"));
+            }
+            catch {
+                exportStatus = {
+                    parse_error: "status.json 解析失败",
+                };
+            }
+        }
+        return {
+            rootDir: this.config.rootDir,
+            indexDir: this.config.indexDir,
+            dbPath: this.config.dbPath,
+            exportDir: this.config.exportDir,
+            checks: {
+                rootDirExists: fs.existsSync(this.config.rootDir),
+                indexDirExists: fs.existsSync(this.config.indexDir),
+                dbExists: fs.existsSync(this.config.dbPath),
+                exportDirExists: fs.existsSync(this.config.exportDir),
+            },
+            exportStatus,
+        };
+    }
+    handleToolCall(name, args) {
+        if (name === "search_documents") {
+            const query = typeof args.query === "string" ? args.query : "";
+            const limit = typeof args.limit === "number" ? args.limit : 10;
+            if (!query.trim()) {
+                return makeErrorToolResult("search_documents 缺少 query。", { query, limit });
+            }
+            const result = this.repository.searchDocuments(query, limit);
+            return makeTextToolResult(`搜索完成，共 ${result.length} 条结果。`, { query, limit, results: result });
+        }
+        if (name === "get_document_context") {
+            const documentId = typeof args.documentId === "string" ? args.documentId : undefined;
+            const filePath = typeof args.path === "string" ? args.path : undefined;
+            if (!documentId && !filePath) {
+                return makeErrorToolResult("get_document_context 需要 documentId 或 path。");
+            }
+            const result = this.repository.getDocumentContext(documentId, filePath);
+            return makeTextToolResult(result ? "文档上下文查询完成。" : "未找到对应文档。", { result });
+        }
+        if (name === "browse_tags") {
+            const rootType = typeof args.rootType === "string" ? args.rootType : undefined;
+            const parentPath = typeof args.parentPath === "string" ? args.parentPath : undefined;
+            const result = this.repository.browseTags(rootType, parentPath);
+            return makeTextToolResult(`标签浏览完成，共 ${result.length} 个节点。`, { result });
+        }
+        if (name === "get_index_status") {
+            const result = this.readIndexStatus();
+            return makeTextToolResult("索引状态读取完成。", result);
+        }
+        throw this.makeJsonRpcError(-32601, `未知工具：${name}`);
+    }
+    makeJsonRpcError(code, message, id = null) {
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: {
+                code,
+                message,
+            },
+        };
+    }
+    handleRequest(message) {
+        if (message.jsonrpc !== "2.0") {
+            return this.makeJsonRpcError(-32600, "仅支持 JSON-RPC 2.0。", message.id ?? null);
+        }
+        if (!message.method) {
+            return this.makeJsonRpcError(-32600, "缺少 method。", message.id ?? null);
+        }
+        if (message.method === "notifications/initialized") {
+            this.initialized = true;
+            return null;
+        }
+        if (message.method.startsWith("notifications/")) {
+            return null;
+        }
+        if (message.method === "initialize") {
+            return {
+                jsonrpc: "2.0",
+                id: message.id ?? null,
+                result: {
+                    protocolVersion: MCP_PROTOCOL_VERSION,
+                    capabilities: {
+                        tools: {
+                            listChanged: false,
+                        },
+                    },
+                    serverInfo: MCP_SERVER_INFO,
+                    instructions: "当前提供最小只读 MCP 工具：search_documents、get_document_context、browse_tags、get_index_status。",
+                },
+            };
+        }
+        if (message.method === "ping") {
+            return {
+                jsonrpc: "2.0",
+                id: message.id ?? null,
+                result: {},
+            };
+        }
+        if (!this.initialized) {
+            return this.makeJsonRpcError(-32002, "服务器尚未完成 initialized。", message.id ?? null);
+        }
+        if (message.method === "tools/list") {
+            return {
+                jsonrpc: "2.0",
+                id: message.id ?? null,
+                result: {
+                    tools: this.listTools(),
+                },
+            };
+        }
+        if (message.method === "tools/call") {
+            const params = message.params ?? {};
+            const name = typeof params.name === "string" ? params.name : "";
+            const args = (params.arguments && typeof params.arguments === "object")
+                ? params.arguments
+                : {};
+            if (!name) {
+                return this.makeJsonRpcError(-32602, "tools/call 缺少 name。", message.id ?? null);
+            }
+            return {
+                jsonrpc: "2.0",
+                id: message.id ?? null,
+                result: this.handleToolCall(name, args),
+            };
+        }
+        return this.makeJsonRpcError(-32601, `不支持的方法：${message.method}`, message.id ?? null);
+    }
+    async run() {
+        const lineReader = readline.createInterface({
+            input: process.stdin,
+            crlfDelay: Infinity,
+        });
+        for await (const line of lineReader) {
+            const trimmed = line.trim();
+            if (!trimmed) {
+                continue;
+            }
+            let message;
+            try {
+                message = JSON.parse(trimmed);
+            }
+            catch {
+                writeStdoutMessage(this.makeJsonRpcError(-32700, "无效 JSON。"));
+                continue;
+            }
+            try {
+                const response = this.handleRequest(message);
+                if (response) {
+                    writeStdoutMessage(response);
+                }
+            }
+            catch (error) {
+                const messageText = error instanceof Error ? error.message : "未知内部错误";
+                writeStdoutMessage(this.makeJsonRpcError(-32603, messageText, message.id ?? null));
+            }
+        }
+    }
+}
+//# sourceMappingURL=mcp-stdio-server.js.map

package/dist/server/modules/affairs-indexer/core/src/services/mcp/mcp-stdio-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdio-server.js","sourceRoot":"","sources":["../../../../../../../../src/modules/affairs-indexer/core/src/services/mcp/mcp-stdio-server.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/affairs-indexer/core/src/services/search/offline-search-service.d.ts

@@ -0,0 +1,11 @@
+import { type RuntimeConfig } from "../../../../contracts/src/index.js";
+import type { SearchDocumentResult } from "../../repositories/catalog-repository.js";
+/**
+ * 离线搜索服务。
+ * 优先读取静态导出的 search bucket，找不到再由上层决定是否回退 SQLite。
+ */
+export declare class OfflineSearchService {
+    private readonly config;
+    constructor(config: RuntimeConfig);
+    search(query: string, limit?: number): SearchDocumentResult[];
+}

package/dist/server/modules/affairs-indexer/core/src/services/search/offline-search-service.js

@@ -0,0 +1,76 @@
+import fs from "node:fs";
+import path from "node:path";
+import { AppError, APP_ERROR_CODES } from "../../../../contracts/src/index.js";
+function normalizeText(value) {
+    return value.trim().toLowerCase();
+}
+function bucketName(term) {
+    const first = term[0] ?? "_";
+    if (/[a-z0-9]/.test(first)) {
+        return first;
+    }
+    return "han";
+}
+/**
+ * 离线搜索服务。
+ * 优先读取静态导出的 search bucket，找不到再由上层决定是否回退 SQLite。
+ */
+export class OfflineSearchService {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    search(query, limit = 20) {
+        const normalized = normalizeText(query);
+        if (!normalized) {
+            return [];
+        }
+        const manifestPath = path.join(this.config.exportDir, "search", "manifest.json");
+        if (!fs.existsSync(manifestPath)) {
+            return [];
+        }
+        const bucket = bucketName(normalized);
+        const bucketPath = path.join(this.config.exportDir, "search", `${bucket}.json`);
+        if (!fs.existsSync(bucketPath)) {
+            return [];
+        }
+        let payload;
+        try {
+            payload = JSON.parse(fs.readFileSync(bucketPath, "utf-8"));
+        }
+        catch (error) {
+            throw new AppError(`离线搜索 bucket 解析失败：${bucketPath}`, APP_ERROR_CODES.SEARCH_INDEX_INVALID, {
+                details: {
+                    bucketPath,
+                },
+                cause: error,
+            });
+        }
+        const matched = (payload.terms ?? []).find(item => item.term === normalized);
+        if (!matched) {
+            return [];
+        }
+        if ("document_ids" in matched) {
+            const documents = new Map(((payload.documents) ?? []).map(item => [item.document_id, item]));
+            return matched.document_ids
+                .slice(0, limit)
+                .map(documentId => documents.get(documentId))
+                .filter((item) => Boolean(item))
+                .map(item => ({
+                documentId: item.document_id,
+                path: item.path,
+                title: item.title,
+                summary: item.summary,
+                modifiedAt: item.mtime,
+            }));
+        }
+        return matched.postings.slice(0, limit).map(item => ({
+            documentId: item.document_id,
+            path: item.path,
+            title: item.title,
+            summary: item.summary,
+            modifiedAt: item.mtime,
+        }));
+    }
+}
+//# sourceMappingURL=offline-search-service.js.map

package/dist/server/modules/affairs-indexer/core/src/services/search/offline-search-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-search-service.js","sourceRoot":"","sources":["../../../../../../../../src/modules/affairs-indexer/core/src/services/search/offline-search-service.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/affairs-indexer/core/src/services/search/search-index-builder.d.ts

@@ -0,0 +1,26 @@
+import type { RuntimeConfig } from "../../../../contracts/src/index.js";
+import type { DirtyScope } from "../dirty/dirty-scope-resolver.js";
+export interface SearchIndexBuildOptions {
+    dirtyScope?: DirtyScope;
+    signal?: AbortSignal;
+    commandName?: string;
+    reason?: string;
+    targetPath?: string;
+}
+export interface SearchIndexBuildResult {
+    outputDir: string;
+    bucketCount: number;
+    manifestPath: string;
+    filesWritten: string[];
+    exportedAt: string;
+}
+/**
+ * 离线关键词倒排构建器。
+ * 改成两阶段流式：第一阶段按 bucket 写临时 NDJSON，第二阶段逐 bucket 汇总为静态 JSON，
+ * 避免把全部 documents / terms 一次性挂在内存里。
+ */
+export declare class SearchIndexBuilder {
+    private readonly config;
+    constructor(config: RuntimeConfig);
+    build(options?: SearchIndexBuildOptions): Promise<SearchIndexBuildResult>;
+}