deepseek-coordination 0.14.2 → 0.14.3

package/lib/index.mjs

@@ -1,5 +1,6 @@
 import { createRequire } from "node:module";
 import { appendFileSync, closeSync, existsSync, fstatSync, mkdirSync, openSync, readFileSync, readSync, realpathSync, renameSync, statSync, writeFileSync } from "node:fs";
+import { readdir } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
 import Schema$1 from "@deepseek-ai/schemastery";
 import { Service } from "@deepseek-ai/cordis";
@@ -15803,6 +15804,11 @@ const ZH = {
 		rebuildDone: "重建完成：{files} 个文件，{nodes} 个节点，用时 {ms} 毫秒",
 		rebuildPartial: "已重建（部分）",
 		actionFailed: "操作失败（{code}）",
+		indexWorkspace: "索引工作区",
+		indexHint: "工作区还没有索引。索引后可浏览文件、大纲与依赖关系。",
+		indexBusy: "正在索引工作区，请稍候",
+		indexDone: "索引完成：{indexed} 个文件，{nodes} 个节点，用时 {ms} 毫秒",
+		indexPartial: "已索引部分文件（达到上限）",
 		tabs: {
 			files: "文件",
 			outline: "大纲",
@@ -15899,6 +15905,7 @@ const ZH = {
 			fit: "适应画布",
 			resetLayout: "重置节点位置",
 			rebuilding: "正在重建…",
+			indexWorkspace: "扫描工作区文件并建立索引（只读）",
 			agentStatus: "代理状态",
 			tabAgents: "查看本会话代理",
 			agentExpand: "展开子代理",
@@ -16777,6 +16784,11 @@ const COPY_BY_LOCALE = {
 			rebuildDone: "Rebuilt {files} files and {nodes} nodes in {ms} ms",
 			rebuildPartial: "Rebuilt partially",
 			actionFailed: "Action failed ({code})",
+			indexWorkspace: "Index workspace",
+			indexHint: "This workspace has no index yet. Index it to browse files, outlines and dependencies.",
+			indexBusy: "Indexing the workspace; please wait.",
+			indexDone: "Indexed {indexed} files and {nodes} nodes in {ms} ms",
+			indexPartial: "Indexed partially (limit reached)",
 			tabs: {
 				files: "Files",
 				outline: "Outline",
@@ -16873,6 +16885,7 @@ const COPY_BY_LOCALE = {
 				fit: "Fit to canvas",
 				resetLayout: "Reset node positions",
 				rebuilding: "Rebuilding…",
+				indexWorkspace: "Scan workspace files and build the index (read-only)",
 				agentStatus: "Agent status",
 				tabAgents: "View this session’s agents",
 				agentExpand: "Expand sub-agents",
@@ -68563,6 +68576,18 @@ var require_underline = /* @__PURE__ */ __commonJSMin(((exports) => {
 * No Office byte is ever written to disk, no external process is started and
 * no converted body is stored or cached.
 *
+* # Bounded workspace indexing (`POST /graph/index`)
+*
+* A fresh profile has an empty graph: the file tools index only what they are
+* asked to parse. {@link indexWorkspaceFiles} is the scan half of the explicit
+* indexing entry point and is still pure orchestration — the host injects a
+* read-only {@link WorkspaceIndexIo} that binds it to `node:fs`, `ParseService`
+* and `GraphStore`/`ChainEngine`. The scan never descends into
+* `node_modules`/`.git`/`dist`/`.tmp`, never attempts a binary extension, is
+* capped at {@link MAX_INDEX_FILES} files / {@link INDEX_TIME_LIMIT_MS} ms and
+* reports `truncated` when a bound stopped it. {@link WorkspaceIndexGate}
+* serializes concurrent runs (the route answers 409 `BUSY`).
+*
 * # Two-level cache (dependencies / imports / intra)
 *
 * Per-file facts (`imports`, `exports`, `deps`) are resolved through:
@@ -71390,6 +71415,173 @@ const Color = {
 	Gray: 1,
 	Black: 2
 };
+/** Directories the scan never descends into (matched case-insensitively). */
+const INDEX_SKIP_DIRECTORIES = [
+	"node_modules",
+	".git",
+	"dist",
+	".tmp"
+];
+/**
+* Extensions the scan accepts, mirroring the registered text parsers.
+*
+* Deliberately an allowlist: shared `.json`/`.yaml`/`.xml` extensions have no
+* registered parser (the text layer refuses to guess), and binary documents
+* (`.docx`, `.pdf`, images, archives) stay out by construction.
+*/
+const INDEX_FILE_EXTENSIONS = [
+	".ts",
+	".tsx",
+	".mts",
+	".cts",
+	".js",
+	".jsx",
+	".mjs",
+	".cjs",
+	".java",
+	".py",
+	".pyi",
+	".pyw",
+	".rs",
+	".php",
+	".c",
+	".h",
+	".cc",
+	".cpp",
+	".hpp",
+	".cxx",
+	".hh",
+	".md",
+	".markdown",
+	".mdx",
+	".tex",
+	".ltx",
+	".latex",
+	".book",
+	".css",
+	".html",
+	".htm",
+	".csv",
+	".tsv"
+];
+/** True when a workspace-relative path has an extension the text layer parses. */
+function isIndexableWorkspaceFile(path) {
+	const extension = extensionOf(path);
+	return extension.length > 0 && INDEX_FILE_EXTENSIONS.includes(extension);
+}
+function isSkippedWorkspaceDirectory(name) {
+	return INDEX_SKIP_DIRECTORIES.includes(name.toLowerCase());
+}
+function joinWorkspacePath(directory, name) {
+	return directory.length === 0 ? name : `${directory}/${name}`;
+}
+/**
+* Scan the workspace and index every accepted text file.
+*
+* Breadth-first and deterministic: each directory's entries are sorted by
+* code-point name before they are visited, so a capped run always indexes the
+* same prefix of the workspace. `indexed` counts successful parses, `skipped`
+* counts files that were seen but not indexed (extension or parse failure);
+* directories are never counted. A directory that cannot be listed is skipped
+* without aborting the scan.
+*/
+async function indexWorkspaceFiles(io, options = {}) {
+	const maxFiles = Math.max(0, Math.floor(options.maxFiles ?? 200));
+	const timeLimitMs = Math.max(0, Math.floor(options.timeLimitMs ?? 1e4));
+	const maxDepth = Math.max(1, Math.floor(options.maxDepth ?? 8));
+	const now = options.now ?? Date.now;
+	const startedAt = now();
+	let indexed = 0;
+	let skipped = 0;
+	let nodes = 0;
+	let attempted = 0;
+	let truncated = false;
+	const pending = [{
+		path: "",
+		depth: 0
+	}];
+	scan: while (pending.length > 0) {
+		if (now() - startedAt >= timeLimitMs) {
+			truncated = true;
+			break;
+		}
+		const directory = pending.shift();
+		let entries;
+		try {
+			entries = await io.readDirectory(directory.path);
+		} catch {
+			continue;
+		}
+		const ordered = [...entries].sort((left, right) => compareText(left.name, right.name));
+		for (const entry of ordered) {
+			if (now() - startedAt >= timeLimitMs) {
+				truncated = true;
+				break scan;
+			}
+			if (entry.directory) {
+				if (directory.depth + 1 >= maxDepth) continue;
+				if (isSkippedWorkspaceDirectory(entry.name)) continue;
+				pending.push({
+					path: joinWorkspacePath(directory.path, entry.name),
+					depth: directory.depth + 1
+				});
+				continue;
+			}
+			const path = joinWorkspacePath(directory.path, entry.name);
+			if (!isIndexableWorkspaceFile(path)) {
+				skipped += 1;
+				continue;
+			}
+			if (attempted >= maxFiles) {
+				truncated = true;
+				break scan;
+			}
+			attempted += 1;
+			try {
+				const count = await io.indexFile(path);
+				indexed += 1;
+				nodes += Number.isFinite(count) && count > 0 ? Math.floor(count) : 0;
+			} catch {
+				skipped += 1;
+			}
+		}
+	}
+	return {
+		indexed,
+		skipped,
+		nodes,
+		durationMs: Math.max(0, now() - startedAt),
+		truncated
+	};
+}
+/**
+* Serialize workspace indexes in one host process.
+*
+* The flag flips synchronously before the task's first `await`, so a second
+* request in the same tick answers BUSY instead of queuing behind the scan.
+* The `finally` reset means a thrown task never leaves the gate stuck.
+*/
+var WorkspaceIndexGate = class {
+	active = false;
+	isBusy() {
+		return this.active;
+	}
+	async run(task) {
+		if (this.active) return {
+			ok: false,
+			busy: true
+		};
+		this.active = true;
+		try {
+			return {
+				ok: true,
+				value: await task()
+			};
+		} finally {
+			this.active = false;
+		}
+	}
+};
 //#endregion
 //#region src/index.ts
 const name = "deepseek-coordination";
@@ -71674,6 +71866,58 @@ async function rebuildGraph(service) {
 	};
 }
 /**
+* Serializes `POST /graph/index`: the flag flips before the first await, so a
+* concurrent request answers 409 `BUSY` instead of queuing behind the scan.
+*/
+const indexGate = new WorkspaceIndexGate();
+/**
+* Explicit indexing entry point for a profile whose graph is still empty.
+*
+* The file tools only index the paths they are asked to parse, so a fresh
+* workspace legitimately has no graph and the panels show their empty state.
+* This scan walks the workspace instead: the bounds (depth ≤ 8, accepted
+* extensions, skipped directories, 200 files / 10 s) live beside the pure
+* walker in `host/graph-view.ts`; this adapter only binds it to the same
+* services {@link rebuildGraph} uses.
+*
+* Read-only: directories are listed, accepted files are read through
+* `ParseService`'s budgeted read path, and only the coordination database's own
+* graph rows are rewritten. No build, command or execution runs, no workspace
+* file is written, and symlinks are not followed.
+*/
+async function indexWorkspace(service) {
+	const root = resolveToolWorkspaceRoot(service);
+	const parser = new ParseService({ workspaceRoot: root });
+	const store = new GraphStore(service.db, { workspaceRoot: root });
+	const registry = new NodeRegistry({ persist: { saveNode: (record) => store.saveNode(record) } });
+	const chain = new ChainEngine({ persist: {
+		saveNode: (node) => store.saveChainNode(node),
+		saveEdge: (edge) => store.saveEdge(edge),
+		deleteEdge: (edge) => store.deleteEdge(edge)
+	} });
+	const result = await indexWorkspaceFiles({
+		async readDirectory(path) {
+			const absolute = path.length === 0 ? root : join(root, path);
+			return (await readdir(absolute, { withFileTypes: true })).filter((entry) => !entry.isSymbolicLink() && (entry.isDirectory() || entry.isFile())).map((entry) => ({
+				name: entry.name,
+				directory: entry.isDirectory()
+			}));
+		},
+		async indexFile(path) {
+			const parsed = parser.parse({ path });
+			return store.transaction(() => {
+				store.beginParse(path);
+				const registered = registry.register(parsed);
+				chain.index(parsed);
+				store.saveSnapshot(parsed, { nodeCount: registered.length });
+				return registered.length;
+			});
+		}
+	});
+	resetGraphCache();
+	return result;
+}
+/**
 * Nest a flat dotted override map, then merge it over the deployment config.
 *
 * Stored overrides win over the profile patch: the operator changed those paths
@@ -72220,6 +72464,24 @@ function apply(context, configInput) {
 						}
 						return;
 					}
+					if (path === "/graph/index" && method === "POST") {
+						const outcome = await indexGate.run(() => indexWorkspace(service));
+						if (!outcome.ok) {
+							json(response, {
+								ok: false,
+								error: {
+									code: "BUSY",
+									message: "a workspace index is already running"
+								}
+							}, 409);
+							return;
+						}
+						json(response, {
+							ok: true,
+							value: outcome.value
+						});
+						return;
+					}
 					if (path === "/graph/rebuild" && method === "POST") {
 						if (rebuildInFlight) {
 							json(response, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepseek-coordination",
-  "version": "0.14.2",
+  "version": "0.14.3",
   "description": "A dual-face Cordis plugin for DeepSeek Harness: the host half owns a coordination SQLite database, seven model-facing tools and an HTTP surface; the web half mounts five composer dropdowns, a settings catalog and the service-level takeover dialog.",
   "keywords": [
     "deepseek-harness",