@openspecui/server 1.0.3 → 1.1.0

package/dist/index.mjs

@@ -1,21 +1,414 @@
 import { serve } from "@hono/node-server";
-import { Hono } from "hono";
-import { cors } from "hono/cors";
+import { ApplyInstructionsSchema, ArtifactInstructionsSchema, ChangeStatusSchema, CliExecutor, ConfigManager, OpenSpecAdapter, OpenSpecWatcher, OpsxKernel, PtyClientMessageSchema, ReactiveContext, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, TemplatesSchema, getAllTools, getAvailableTools, getConfiguredTools, getDefaultCliCommandString, initWatcherPool, isWatcherPoolInitialized, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli } from "@openspecui/core";
 import { fetchRequestHandler } from "@trpc/server/adapters/fetch";
 import { applyWSSHandler } from "@trpc/server/adapters/ws";
+import { Hono } from "hono";
+import { cors } from "hono/cors";
 import { WebSocketServer } from "ws";
-import { ApplyInstructionsSchema, ArtifactInstructionsSchema, ChangeStatusSchema, CliExecutor, ConfigManager, OpenSpecAdapter, OpenSpecWatcher, OpsxKernel, PtyClientMessageSchema, ReactiveContext, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, TemplatesSchema, getAllTools, getAvailableTools, getConfiguredTools, getDefaultCliCommandString, initWatcherPool, isWatcherPoolInitialized, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli } from "@openspecui/core";
+import { createServer as createServer$1 } from "node:net";
+import * as pty from "@lydell/node-pty";
+import { EventEmitter } from "events";
+import { SearchQuerySchema } from "@openspecui/search";
 import { initTRPC } from "@trpc/server";
 import { observable } from "@trpc/server/observable";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import { dirname, join, matchesGlob, relative, resolve, sep } from "node:path";
 import { z } from "zod";
 import { parse } from "yaml";
-import { EventEmitter } from "node:events";
-import { createServer as createServer$1 } from "node:net";
-import * as pty from "@lydell/node-pty";
-import { EventEmitter as EventEmitter$1 } from "events";
+import { EventEmitter as EventEmitter$1 } from "node:events";
+import { NodeWorkerSearchProvider } from "@openspecui/search/node";
 
+//#region src/port-utils.ts
+/**
+* Check if a port is available by trying to listen on it.
+* Uses default binding (both IPv4 and IPv6) to detect conflicts.
+*/
+function isPortAvailable(port) {
+	return new Promise((resolve$1) => {
+		const server = createServer$1();
+		server.once("error", () => {
+			resolve$1(false);
+		});
+		server.once("listening", () => {
+			server.close(() => resolve$1(true));
+		});
+		server.listen(port);
+	});
+}
+/**
+* Find an available port starting from the given port.
+* Will try up to maxAttempts ports sequentially.
+*
+* @param startPort - The preferred port to start checking from
+* @param maxAttempts - Maximum number of ports to try (default: 10)
+* @returns The first available port found
+* @throws Error if no available port is found in the range
+*/
+async function findAvailablePort(startPort, maxAttempts = 10) {
+	for (let i = 0; i < maxAttempts; i++) {
+		const port = startPort + i;
+		if (await isPortAvailable(port)) return port;
+	}
+	throw new Error(`No available port found in range ${startPort}-${startPort + maxAttempts - 1}`);
+}
+
+//#endregion
+//#region src/pty-manager.ts
+const DEFAULT_SCROLLBACK = 1e3;
+const DEFAULT_MAX_BUFFER_BYTES = 2 * 1024 * 1024;
+function detectPtyPlatform() {
+	if (process.platform === "win32") return "windows";
+	if (process.platform === "darwin") return "macos";
+	return "common";
+}
+function resolveDefaultShell(platform, env) {
+	if (platform === "windows") return env.ComSpec?.trim() || "cmd.exe";
+	return env.SHELL?.trim() || "/bin/sh";
+}
+function resolvePtyCommand(opts) {
+	const command = opts.command?.trim();
+	if (command) return {
+		command,
+		args: opts.args ?? []
+	};
+	return {
+		command: resolveDefaultShell(opts.platform, opts.env),
+		args: []
+	};
+}
+var PtySession = class extends EventEmitter {
+	id;
+	command;
+	args;
+	platform;
+	createdAt;
+	process;
+	titleInterval = null;
+	lastTitle = "";
+	buffer = [];
+	bufferByteLength = 0;
+	maxBufferLines;
+	maxBufferBytes;
+	isExited = false;
+	exitCode = null;
+	constructor(id, opts) {
+		super();
+		this.id = id;
+		this.createdAt = Date.now();
+		const resolvedCommand = resolvePtyCommand({
+			platform: opts.platform,
+			command: opts.command,
+			args: opts.args,
+			env: process.env
+		});
+		this.command = resolvedCommand.command;
+		this.args = resolvedCommand.args;
+		this.platform = opts.platform;
+		this.maxBufferLines = opts.scrollback ?? DEFAULT_SCROLLBACK;
+		this.maxBufferBytes = opts.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;
+		this.process = pty.spawn(this.command, this.args, {
+			name: "xterm-256color",
+			cols: opts.cols ?? 80,
+			rows: opts.rows ?? 24,
+			cwd: opts.cwd,
+			env: {
+				...process.env,
+				TERM: "xterm-256color"
+			}
+		});
+		this.process.onData((data) => {
+			this.appendBuffer(data);
+			this.emit("data", data);
+		});
+		this.process.onExit(({ exitCode }) => {
+			if (this.titleInterval) {
+				clearInterval(this.titleInterval);
+				this.titleInterval = null;
+			}
+			this.isExited = true;
+			this.exitCode = exitCode;
+			this.emit("exit", exitCode);
+		});
+		this.titleInterval = setInterval(() => {
+			try {
+				const title = this.process.process;
+				if (title && title !== this.lastTitle) {
+					this.lastTitle = title;
+					this.emit("title", title);
+				}
+			} catch {}
+		}, 1e3);
+	}
+	get title() {
+		return this.lastTitle;
+	}
+	appendBuffer(data) {
+		let chunk = data;
+		if (chunk.length > this.maxBufferBytes) chunk = chunk.slice(-this.maxBufferBytes);
+		this.buffer.push(chunk);
+		this.bufferByteLength += chunk.length;
+		while (this.bufferByteLength > this.maxBufferBytes && this.buffer.length > 0) {
+			const removed = this.buffer.shift();
+			this.bufferByteLength -= removed.length;
+		}
+		while (this.buffer.length > this.maxBufferLines) {
+			const removed = this.buffer.shift();
+			this.bufferByteLength -= removed.length;
+		}
+	}
+	getBuffer() {
+		return this.buffer.join("");
+	}
+	write(data) {
+		if (!this.isExited) this.process.write(data);
+	}
+	resize(cols, rows) {
+		if (!this.isExited) this.process.resize(cols, rows);
+	}
+	close() {
+		if (this.titleInterval) {
+			clearInterval(this.titleInterval);
+			this.titleInterval = null;
+		}
+		try {
+			this.process.kill();
+		} catch {}
+		this.removeAllListeners();
+	}
+	toInfo() {
+		return {
+			id: this.id,
+			title: this.lastTitle,
+			command: this.command,
+			args: this.args,
+			platform: this.platform,
+			isExited: this.isExited,
+			exitCode: this.exitCode,
+			createdAt: this.createdAt
+		};
+	}
+};
+var PtyManager = class {
+	sessions = /* @__PURE__ */ new Map();
+	idCounter = 0;
+	platform;
+	constructor(defaultCwd) {
+		this.defaultCwd = defaultCwd;
+		this.platform = detectPtyPlatform();
+	}
+	create(opts) {
+		const id = `pty-${++this.idCounter}`;
+		const session = new PtySession(id, {
+			cols: opts.cols,
+			rows: opts.rows,
+			command: opts.command,
+			args: opts.args,
+			cwd: this.defaultCwd,
+			scrollback: opts.scrollback,
+			maxBufferBytes: opts.maxBufferBytes,
+			platform: this.platform
+		});
+		this.sessions.set(id, session);
+		return session;
+	}
+	get(id) {
+		return this.sessions.get(id);
+	}
+	list() {
+		const result = [];
+		for (const session of this.sessions.values()) result.push(session.toInfo());
+		return result;
+	}
+	write(id, data) {
+		this.sessions.get(id)?.write(data);
+	}
+	resize(id, cols, rows) {
+		this.sessions.get(id)?.resize(cols, rows);
+	}
+	close(id) {
+		const session = this.sessions.get(id);
+		if (session) {
+			session.close();
+			this.sessions.delete(id);
+		}
+	}
+	closeAll() {
+		for (const session of this.sessions.values()) session.close();
+		this.sessions.clear();
+	}
+};
+
+//#endregion
+//#region src/pty-websocket.ts
+function createPtyWebSocketHandler(ptyManager) {
+	return (ws) => {
+		const cleanups = /* @__PURE__ */ new Map();
+		const send = (msg) => {
+			if (ws.readyState === ws.OPEN) ws.send(JSON.stringify(msg));
+		};
+		const sendError = (code, message, opts) => {
+			send({
+				type: "error",
+				code,
+				message,
+				sessionId: opts?.sessionId
+			});
+		};
+		const attachToSession = (session, opts) => {
+			const sessionId = session.id;
+			cleanups.get(sessionId)?.();
+			if (opts?.cols && opts?.rows && !session.isExited) session.resize(opts.cols, opts.rows);
+			const onData = (data) => {
+				send({
+					type: "output",
+					sessionId,
+					data
+				});
+			};
+			const onExit = (exitCode) => {
+				send({
+					type: "exit",
+					sessionId,
+					exitCode
+				});
+			};
+			const onTitle = (title) => {
+				send({
+					type: "title",
+					sessionId,
+					title
+				});
+			};
+			session.on("data", onData);
+			session.on("exit", onExit);
+			session.on("title", onTitle);
+			cleanups.set(sessionId, () => {
+				session.removeListener("data", onData);
+				session.removeListener("exit", onExit);
+				session.removeListener("title", onTitle);
+				cleanups.delete(sessionId);
+			});
+		};
+		ws.on("message", (raw) => {
+			let parsed;
+			try {
+				parsed = JSON.parse(String(raw));
+			} catch {
+				sendError("INVALID_JSON", "Invalid JSON payload");
+				return;
+			}
+			const parsedMessage = PtyClientMessageSchema.safeParse(parsed);
+			if (!parsedMessage.success) {
+				const firstIssue = parsedMessage.error.issues[0]?.message;
+				sendError("INVALID_MESSAGE", firstIssue ?? "Invalid PTY message");
+				return;
+			}
+			const msg = parsedMessage.data;
+			switch (msg.type) {
+				case "create":
+					try {
+						const session = ptyManager.create({
+							cols: msg.cols,
+							rows: msg.rows,
+							command: msg.command,
+							args: msg.args
+						});
+						send({
+							type: "created",
+							requestId: msg.requestId,
+							sessionId: session.id,
+							platform: session.platform
+						});
+						attachToSession(session);
+					} catch (err) {
+						sendError("PTY_CREATE_FAILED", err instanceof Error ? err.message : String(err), { sessionId: msg.requestId });
+					}
+					break;
+				case "attach": {
+					const session = ptyManager.get(msg.sessionId);
+					if (!session) {
+						sendError("SESSION_NOT_FOUND", `Session not found: ${msg.sessionId}`, { sessionId: msg.sessionId });
+						send({
+							type: "exit",
+							sessionId: msg.sessionId,
+							exitCode: -1
+						});
+						break;
+					}
+					attachToSession(session, {
+						cols: msg.cols,
+						rows: msg.rows
+					});
+					const buffer = session.getBuffer();
+					if (buffer) send({
+						type: "buffer",
+						sessionId: session.id,
+						data: buffer
+					});
+					if (session.title) send({
+						type: "title",
+						sessionId: session.id,
+						title: session.title
+					});
+					if (session.isExited) send({
+						type: "exit",
+						sessionId: session.id,
+						exitCode: session.exitCode ?? -1
+					});
+					break;
+				}
+				case "list":
+					send({
+						type: "list",
+						sessions: ptyManager.list().map((s) => ({
+							id: s.id,
+							title: s.title,
+							command: s.command,
+							args: s.args,
+							platform: s.platform,
+							isExited: s.isExited,
+							exitCode: s.exitCode
+						}))
+					});
+					break;
+				case "input": {
+					const session = ptyManager.get(msg.sessionId);
+					if (!session) {
+						sendError("SESSION_NOT_FOUND", `Session not found: ${msg.sessionId}`, { sessionId: msg.sessionId });
+						break;
+					}
+					session.write(msg.data);
+					break;
+				}
+				case "resize": {
+					const session = ptyManager.get(msg.sessionId);
+					if (!session) {
+						sendError("SESSION_NOT_FOUND", `Session not found: ${msg.sessionId}`, { sessionId: msg.sessionId });
+						break;
+					}
+					session.resize(msg.cols, msg.rows);
+					break;
+				}
+				case "close": {
+					const session = ptyManager.get(msg.sessionId);
+					if (!session) {
+						sendError("SESSION_NOT_FOUND", `Session not found: ${msg.sessionId}`, { sessionId: msg.sessionId });
+						break;
+					}
+					cleanups.get(msg.sessionId)?.();
+					ptyManager.close(session.id);
+					break;
+				}
+			}
+		});
+		ws.on("close", () => {
+			for (const cleanup of cleanups.values()) cleanup();
+			cleanups.clear();
+		});
+	};
+}
+
+//#endregion
 //#region src/cli-stream-observable.ts
 /**
 * 创建安全的 CLI 流式 observable
@@ -131,7 +524,7 @@ function parseSchemaYaml(content) {
 */
 var ReactiveKV = class {
 	store = /* @__PURE__ */ new Map();
-	emitter = new EventEmitter();
+	emitter = new EventEmitter$1();
 	constructor() {
 		this.emitter.setMaxListeners(200);
 	}
@@ -1086,389 +1479,165 @@ const kvRouter = router({
 	})
 });
 /**
-* Main app router
-*/
-const appRouter = router({
-	spec: specRouter,
-	change: changeRouter,
-	archive: archiveRouter,
-	init: initRouter,
-	realtime: realtimeRouter,
-	config: configRouter,
-	cli: cliRouter,
-	opsx: opsxRouter,
-	kv: kvRouter
-});
-
-//#endregion
-//#region src/port-utils.ts
-/**
-* Check if a port is available by trying to listen on it.
-* Uses default binding (both IPv4 and IPv6) to detect conflicts.
-*/
-function isPortAvailable(port) {
-	return new Promise((resolve$1) => {
-		const server = createServer$1();
-		server.once("error", () => {
-			resolve$1(false);
-		});
-		server.once("listening", () => {
-			server.close(() => resolve$1(true));
-		});
-		server.listen(port);
-	});
-}
-/**
-* Find an available port starting from the given port.
-* Will try up to maxAttempts ports sequentially.
-*
-* @param startPort - The preferred port to start checking from
-* @param maxAttempts - Maximum number of ports to try (default: 10)
-* @returns The first available port found
-* @throws Error if no available port is found in the range
+* Search router - unified fulltext search over specs/changes/archives
 */
-async function findAvailablePort(startPort, maxAttempts = 10) {
-	for (let i = 0; i < maxAttempts; i++) {
-		const port = startPort + i;
-		if (await isPortAvailable(port)) return port;
-	}
-	throw new Error(`No available port found in range ${startPort}-${startPort + maxAttempts - 1}`);
-}
-
-//#endregion
-//#region src/pty-manager.ts
-const DEFAULT_SCROLLBACK = 1e3;
-const DEFAULT_MAX_BUFFER_BYTES = 2 * 1024 * 1024;
-function detectPtyPlatform() {
-	if (process.platform === "win32") return "windows";
-	if (process.platform === "darwin") return "macos";
-	return "common";
-}
-var PtySession = class extends EventEmitter$1 {
-	id;
-	command;
-	args;
-	platform;
-	createdAt;
-	process;
-	titleInterval = null;
-	lastTitle = "";
-	buffer = [];
-	bufferByteLength = 0;
-	maxBufferLines;
-	maxBufferBytes;
-	isExited = false;
-	exitCode = null;
-	constructor(id, opts) {
-		super();
-		this.id = id;
-		this.createdAt = Date.now();
-		const shell = opts.command ?? process.env.SHELL ?? "/bin/sh";
-		const args = opts.command ? opts.args ?? [] : [];
-		this.command = shell;
-		this.args = args;
-		this.platform = opts.platform;
-		this.maxBufferLines = opts.scrollback ?? DEFAULT_SCROLLBACK;
-		this.maxBufferBytes = opts.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;
-		this.process = pty.spawn(shell, args, {
-			name: "xterm-256color",
-			cols: opts.cols ?? 80,
-			rows: opts.rows ?? 24,
-			cwd: opts.cwd,
-			env: {
-				...process.env,
-				TERM: "xterm-256color"
-			}
-		});
-		this.process.onData((data) => {
-			this.appendBuffer(data);
-			this.emit("data", data);
-		});
-		this.process.onExit(({ exitCode }) => {
-			if (this.titleInterval) {
-				clearInterval(this.titleInterval);
-				this.titleInterval = null;
-			}
-			this.isExited = true;
-			this.exitCode = exitCode;
-			this.emit("exit", exitCode);
-		});
-		this.titleInterval = setInterval(() => {
-			try {
-				const title = this.process.process;
-				if (title && title !== this.lastTitle) {
-					this.lastTitle = title;
-					this.emit("title", title);
-				}
-			} catch {}
-		}, 1e3);
-	}
-	get title() {
-		return this.lastTitle;
-	}
-	appendBuffer(data) {
-		let chunk = data;
-		if (chunk.length > this.maxBufferBytes) chunk = chunk.slice(-this.maxBufferBytes);
-		this.buffer.push(chunk);
-		this.bufferByteLength += chunk.length;
-		while (this.bufferByteLength > this.maxBufferBytes && this.buffer.length > 0) {
-			const removed = this.buffer.shift();
-			this.bufferByteLength -= removed.length;
-		}
-		while (this.buffer.length > this.maxBufferLines) {
-			const removed = this.buffer.shift();
-			this.bufferByteLength -= removed.length;
-		}
+const searchRouter = router({
+	query: publicProcedure.input(SearchQuerySchema).query(async ({ ctx, input }) => {
+		return ctx.searchService.query(input);
+	}),
+	subscribe: publicProcedure.input(SearchQuerySchema).subscription(({ ctx, input }) => {
+		return createReactiveSubscriptionWithInput((queryInput) => ctx.searchService.queryReactive(queryInput))(input);
+	})
+});
+/**
+* Main app router
+*/
+const appRouter = router({
+	spec: specRouter,
+	change: changeRouter,
+	archive: archiveRouter,
+	init: initRouter,
+	realtime: realtimeRouter,
+	config: configRouter,
+	cli: cliRouter,
+	opsx: opsxRouter,
+	kv: kvRouter,
+	search: searchRouter
+});
+
+//#endregion
+//#region src/search-documents.ts
+function joinParts(parts) {
+	return parts.map((part) => part?.trim() ?? "").filter((part) => part.length > 0).join("\n\n");
+}
+async function collectSearchDocuments(adapter) {
+	const docs = [];
+	const specs = await adapter.listSpecsWithMeta();
+	for (const spec of specs) {
+		const raw = await adapter.readSpecRaw(spec.id);
+		if (!raw) continue;
+		docs.push({
+			id: `spec:${spec.id}`,
+			kind: "spec",
+			title: spec.name,
+			href: `/specs/${encodeURIComponent(spec.id)}`,
+			path: `openspec/specs/${spec.id}/spec.md`,
+			content: raw,
+			updatedAt: spec.updatedAt
+		});
 	}
-	getBuffer() {
-		return this.buffer.join("");
+	const changes = await adapter.listChangesWithMeta();
+	for (const change of changes) {
+		const raw = await adapter.readChangeRaw(change.id);
+		if (!raw) continue;
+		docs.push({
+			id: `change:${change.id}`,
+			kind: "change",
+			title: change.name,
+			href: `/changes/${encodeURIComponent(change.id)}`,
+			path: `openspec/changes/${change.id}`,
+			content: joinParts([
+				raw.proposal,
+				raw.tasks,
+				raw.design,
+				...raw.deltaSpecs.map((deltaSpec) => deltaSpec.content)
+			]),
+			updatedAt: change.updatedAt
+		});
 	}
-	write(data) {
-		if (!this.isExited) this.process.write(data);
+	const archives = await adapter.listArchivedChangesWithMeta();
+	for (const archive of archives) {
+		const raw = await adapter.readArchivedChangeRaw(archive.id);
+		if (!raw) continue;
+		docs.push({
+			id: `archive:${archive.id}`,
+			kind: "archive",
+			title: archive.name,
+			href: `/archive/${encodeURIComponent(archive.id)}`,
+			path: `openspec/changes/archive/${archive.id}`,
+			content: joinParts([
+				raw.proposal,
+				raw.tasks,
+				raw.design,
+				...raw.deltaSpecs.map((deltaSpec) => deltaSpec.content)
+			]),
+			updatedAt: archive.updatedAt
+		});
 	}
-	resize(cols, rows) {
-		if (!this.isExited) this.process.resize(cols, rows);
+	return docs;
+}
+
+//#endregion
+//#region src/search-service.ts
+const REBUILD_DEBOUNCE_MS = 250;
+var SearchService = class {
+	provider;
+	initialized = false;
+	initPromise = null;
+	rebuildPromise = null;
+	rebuildTimer = null;
+	constructor(adapter, watcher, provider = new NodeWorkerSearchProvider()) {
+		this.adapter = adapter;
+		this.provider = provider;
+		watcher?.on("change", () => {
+			this.scheduleRebuild();
+		});
 	}
-	close() {
-		if (this.titleInterval) {
-			clearInterval(this.titleInterval);
-			this.titleInterval = null;
-		}
+	async init() {
+		if (this.initialized) return;
+		if (this.initPromise) return this.initPromise;
+		this.initPromise = this.rebuildIndex(true);
 		try {
-			this.process.kill();
-		} catch {}
-		this.removeAllListeners();
-	}
-	toInfo() {
-		return {
-			id: this.id,
-			title: this.lastTitle,
-			command: this.command,
-			args: this.args,
-			platform: this.platform,
-			isExited: this.isExited,
-			exitCode: this.exitCode,
-			createdAt: this.createdAt
-		};
-	}
-};
-var PtyManager = class {
-	sessions = /* @__PURE__ */ new Map();
-	idCounter = 0;
-	platform;
-	constructor(defaultCwd) {
-		this.defaultCwd = defaultCwd;
-		this.platform = detectPtyPlatform();
+			await this.initPromise;
+		} finally {
+			this.initPromise = null;
+		}
 	}
-	create(opts) {
-		const id = `pty-${++this.idCounter}`;
-		const session = new PtySession(id, {
-			cols: opts.cols,
-			rows: opts.rows,
-			command: opts.command,
-			args: opts.args,
-			cwd: this.defaultCwd,
-			scrollback: opts.scrollback,
-			maxBufferBytes: opts.maxBufferBytes,
-			platform: this.platform
-		});
-		this.sessions.set(id, session);
-		return session;
+	async query(input) {
+		const parsed = SearchQuerySchema.parse(input);
+		await this.init();
+		return this.provider.search(parsed);
 	}
-	get(id) {
-		return this.sessions.get(id);
+	async queryReactive(input) {
+		const parsed = SearchQuerySchema.parse(input);
+		await this.rebuildIndex();
+		return this.provider.search(parsed);
 	}
-	list() {
-		const result = [];
-		for (const session of this.sessions.values()) result.push(session.toInfo());
-		return result;
+	async dispose() {
+		this.cancelRebuild();
+		await this.provider.dispose();
 	}
-	write(id, data) {
-		this.sessions.get(id)?.write(data);
+	scheduleRebuild() {
+		this.cancelRebuild();
+		this.rebuildTimer = setTimeout(() => {
+			this.rebuildTimer = null;
+			this.rebuildIndex().catch(() => {});
+		}, REBUILD_DEBOUNCE_MS);
 	}
-	resize(id, cols, rows) {
-		this.sessions.get(id)?.resize(cols, rows);
+	cancelRebuild() {
+		if (!this.rebuildTimer) return;
+		clearTimeout(this.rebuildTimer);
+		this.rebuildTimer = null;
 	}
-	close(id) {
-		const session = this.sessions.get(id);
-		if (session) {
-			session.close();
-			this.sessions.delete(id);
+	async rebuildIndex(forceInit = false) {
+		if (!forceInit && !this.initialized) return;
+		if (this.rebuildPromise) return this.rebuildPromise;
+		this.rebuildPromise = (async () => {
+			const docs = await collectSearchDocuments(this.adapter);
+			if (this.initialized) await this.provider.replaceAll(docs);
+			else {
+				await this.provider.init(docs);
+				this.initialized = true;
+			}
+		})();
+		try {
+			await this.rebuildPromise;
+		} finally {
+			this.rebuildPromise = null;
 		}
 	}
-	closeAll() {
-		for (const session of this.sessions.values()) session.close();
-		this.sessions.clear();
-	}
 };
 
-//#endregion
-//#region src/pty-websocket.ts
-function createPtyWebSocketHandler(ptyManager) {
-	return (ws) => {
-		const cleanups = /* @__PURE__ */ new Map();
-		const send = (msg) => {
-			if (ws.readyState === ws.OPEN) ws.send(JSON.stringify(msg));
-		};
-		const sendError = (code, message, opts) => {
-			send({
-				type: "error",
-				code,
-				message,
-				sessionId: opts?.sessionId
-			});
-		};
-		const attachToSession = (session, opts) => {
-			const sessionId = session.id;
-			cleanups.get(sessionId)?.();
-			if (opts?.cols && opts?.rows && !session.isExited) session.resize(opts.cols, opts.rows);
-			const onData = (data) => {
-				send({
-					type: "output",
-					sessionId,
-					data
-				});
-			};
-			const onExit = (exitCode) => {
-				send({
-					type: "exit",
-					sessionId,
-					exitCode
-				});
-			};
-			const onTitle = (title) => {
-				send({
-					type: "title",
-					sessionId,
-					title
-				});
-			};
-			session.on("data", onData);
-			session.on("exit", onExit);
-			session.on("title", onTitle);
-			cleanups.set(sessionId, () => {
-				session.removeListener("data", onData);
-				session.removeListener("exit", onExit);
-				session.removeListener("title", onTitle);
-				cleanups.delete(sessionId);
-			});
-		};
-		ws.on("message", (raw) => {
-			let parsed;
-			try {
-				parsed = JSON.parse(String(raw));
-			} catch {
-				sendError("INVALID_JSON", "Invalid JSON payload");
-				return;
-			}
-			const parsedMessage = PtyClientMessageSchema.safeParse(parsed);
-			if (!parsedMessage.success) {
-				const firstIssue = parsedMessage.error.issues[0]?.message;
-				sendError("INVALID_MESSAGE", firstIssue ?? "Invalid PTY message");
-				return;
-			}
-			const msg = parsedMessage.data;
-			switch (msg.type) {
-				case "create": {
-					const session = ptyManager.create({
-						cols: msg.cols,
-						rows: msg.rows,
-						command: msg.command,
-						args: msg.args
-					});
-					send({
-						type: "created",
-						requestId: msg.requestId,
-						sessionId: session.id,
-						platform: session.platform
-					});
-					attachToSession(session);
-					break;
-				}
-				case "attach": {
-					const session = ptyManager.get(msg.sessionId);
-					if (!session) {
-						sendError("SESSION_NOT_FOUND", `Session not found: ${msg.sessionId}`, { sessionId: msg.sessionId });
-						send({
-							type: "exit",
-							sessionId: msg.sessionId,
-							exitCode: -1
-						});
-						break;
-					}
-					attachToSession(session, {
-						cols: msg.cols,
-						rows: msg.rows
-					});
-					const buffer = session.getBuffer();
-					if (buffer) send({
-						type: "buffer",
-						sessionId: session.id,
-						data: buffer
-					});
-					if (session.title) send({
-						type: "title",
-						sessionId: session.id,
-						title: session.title
-					});
-					if (session.isExited) send({
-						type: "exit",
-						sessionId: session.id,
-						exitCode: session.exitCode ?? -1
-					});
-					break;
-				}
-				case "list":
-					send({
-						type: "list",
-						sessions: ptyManager.list().map((s) => ({
-							id: s.id,
-							title: s.title,
-							command: s.command,
-							args: s.args,
-							platform: s.platform,
-							isExited: s.isExited,
-							exitCode: s.exitCode
-						}))
-					});
-					break;
-				case "input": {
-					const session = ptyManager.get(msg.sessionId);
-					if (!session) {
-						sendError("SESSION_NOT_FOUND", `Session not found: ${msg.sessionId}`, { sessionId: msg.sessionId });
-						break;
-					}
-					session.write(msg.data);
-					break;
-				}
-				case "resize": {
-					const session = ptyManager.get(msg.sessionId);
-					if (!session) {
-						sendError("SESSION_NOT_FOUND", `Session not found: ${msg.sessionId}`, { sessionId: msg.sessionId });
-						break;
-					}
-					session.resize(msg.cols, msg.rows);
-					break;
-				}
-				case "close": {
-					const session = ptyManager.get(msg.sessionId);
-					if (!session) {
-						sendError("SESSION_NOT_FOUND", `Session not found: ${msg.sessionId}`, { sessionId: msg.sessionId });
-						break;
-					}
-					cleanups.get(msg.sessionId)?.();
-					ptyManager.close(session.id);
-					break;
-				}
-			}
-		});
-		ws.on("close", () => {
-			for (const cleanup of cleanups.values()) cleanup();
-			cleanups.clear();
-		});
-	};
-}
-
 //#endregion
 //#region src/server.ts
 /**
@@ -1492,6 +1661,7 @@ function createServer(config) {
 	const cliExecutor = new CliExecutor(configManager, config.projectDir);
 	const kernel = config.kernel;
 	const watcher = config.enableWatcher !== false ? new OpenSpecWatcher(config.projectDir) : void 0;
+	const searchService = new SearchService(adapter, watcher);
 	const app = new Hono();
 	const corsOrigins = config.corsOrigins ?? ["http://localhost:5173", "http://localhost:3000"];
 	app.use("*", cors({
@@ -1515,6 +1685,7 @@ function createServer(config) {
 				configManager,
 				cliExecutor,
 				kernel,
+				searchService,
 				watcher,
 				projectDir: config.projectDir
 			})
@@ -1525,6 +1696,7 @@ function createServer(config) {
 		configManager,
 		cliExecutor,
 		kernel,
+		searchService,
 		watcher,
 		projectDir: config.projectDir
 	});
@@ -1534,6 +1706,7 @@ function createServer(config) {
 		configManager,
 		cliExecutor,
 		kernel,
+		searchService,
 		watcher,
 		createContext,
 		port: config.port ?? 3100
@@ -1575,6 +1748,7 @@ async function createWebSocketServer(server, httpServer, config) {
 			ptyWss.close();
 			wss.close();
 			server.watcher?.stop();
+			server.searchService.dispose().catch(() => {});
 		}
 	};
 }
@@ -1607,6 +1781,9 @@ async function startServer(config, setupApp) {
 	kernel.warmup().catch((err) => {
 		console.error("Kernel warmup failed:", err);
 	});
+	server.searchService.init().catch((err) => {
+		console.error("Search service warmup failed:", err);
+	});
 	return {
 		url,
 		port,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/server",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "type": "module",
   "main": "dist/index.mjs",
   "exports": {
@@ -20,7 +20,8 @@
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
     "zod": "^3.24.1",
-    "@openspecui/core": "1.0.3"
+    "@openspecui/search": "1.1.0",
+    "@openspecui/core": "1.1.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
@@ -34,7 +35,7 @@
   "scripts": {
     "build": "tsdown src/index.ts --format esm --no-dts",
     "typecheck": "tsc --noEmit",
-    "dev": "tsx watch --include '../core/dist/**' src/standalone.ts",
+    "dev": "tsx watch --include '../core/dist/**' --include '../search/dist/**' src/standalone.ts",
     "test": "vitest run",
     "test:watch": "vitest"
   }