@openspecui/server 1.1.0 → 1.2.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { serve } from "@hono/node-server";
-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 { CliExecutor, ConfigManager, OpenSpecAdapter, OpenSpecWatcher, OpsxKernel, PtyClientMessageSchema, ReactiveContext, getAllTools, getAvailableTools, getConfiguredTools, getDefaultCliCommandString, initWatcherPool, isWatcherPoolInitialized, sniffGlobalCli } from "@openspecui/core";
 import { fetchRequestHandler } from "@trpc/server/adapters/fetch";
 import { applyWSSHandler } from "@trpc/server/adapters/ws";
 import { Hono } from "hono";
@@ -12,9 +12,8 @@ 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 { dirname, join, resolve, sep } from "node:path";
 import { z } from "zod";
-import { parse } from "yaml";
 import { EventEmitter as EventEmitter$1 } from "node:events";
 import { NodeWorkerSearchProvider } from "@openspecui/search/node";
 
@@ -81,6 +80,8 @@ var PtySession = class extends EventEmitter {
 	command;
 	args;
 	platform;
+	closeTip;
+	closeCallbackUrl;
 	createdAt;
 	process;
 	titleInterval = null;
@@ -104,6 +105,8 @@ var PtySession = class extends EventEmitter {
 		this.command = resolvedCommand.command;
 		this.args = resolvedCommand.args;
 		this.platform = opts.platform;
+		this.closeTip = opts.closeTip;
+		this.closeCallbackUrl = opts.closeCallbackUrl;
 		this.maxBufferLines = opts.scrollback ?? DEFAULT_SCROLLBACK;
 		this.maxBufferBytes = opts.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;
 		this.process = pty.spawn(this.command, this.args, {
@@ -184,6 +187,8 @@ var PtySession = class extends EventEmitter {
 			platform: this.platform,
 			isExited: this.isExited,
 			exitCode: this.exitCode,
+			closeTip: this.closeTip,
+			closeCallbackUrl: this.closeCallbackUrl,
 			createdAt: this.createdAt
 		};
 	}
@@ -203,6 +208,8 @@ var PtyManager = class {
 			rows: opts.rows,
 			command: opts.command,
 			args: opts.args,
+			closeTip: opts.closeTip,
+			closeCallbackUrl: opts.closeCallbackUrl,
 			cwd: this.defaultCwd,
 			scrollback: opts.scrollback,
 			maxBufferBytes: opts.maxBufferBytes,
@@ -307,11 +314,14 @@ function createPtyWebSocketHandler(ptyManager) {
 			switch (msg.type) {
 				case "create":
 					try {
+						const createMessage = msg;
 						const session = ptyManager.create({
 							cols: msg.cols,
 							rows: msg.rows,
 							command: msg.command,
-							args: msg.args
+							args: msg.args,
+							closeTip: createMessage.closeTip,
+							closeCallbackUrl: createMessage.closeCallbackUrl
 						});
 						send({
 							type: "created",
@@ -367,7 +377,9 @@ function createPtyWebSocketHandler(ptyManager) {
 							args: s.args,
 							platform: s.platform,
 							isExited: s.isExited,
-							exitCode: s.exitCode
+							exitCode: s.exitCode,
+							closeTip: s.closeTip,
+							closeCallbackUrl: s.closeCallbackUrl
 						}))
 					});
 					break;
@@ -465,53 +477,6 @@ function createCliStreamObservable(startStream) {
 	});
 }
 
-//#endregion
-//#region src/opsx-schema.ts
-const SchemaYamlArtifactSchema = z.object({
-	id: z.string(),
-	generates: z.string(),
-	description: z.string().optional(),
-	template: z.string().optional(),
-	instruction: z.string().optional(),
-	requires: z.array(z.string()).optional()
-});
-const SchemaYamlSchema = z.object({
-	name: z.string(),
-	version: z.union([z.string(), z.number()]).optional(),
-	description: z.string().optional(),
-	artifacts: z.array(SchemaYamlArtifactSchema),
-	apply: z.object({
-		requires: z.array(z.string()).optional(),
-		tracks: z.string().optional(),
-		instruction: z.string().optional()
-	}).optional()
-});
-function parseSchemaYaml(content) {
-	const raw = parse(content);
-	const parsed = SchemaYamlSchema.safeParse(raw);
-	if (!parsed.success) throw new Error(`Invalid schema.yaml: ${parsed.error.message}`);
-	const { artifacts, apply, name, description, version } = parsed.data;
-	const detail = {
-		name,
-		description,
-		version,
-		artifacts: artifacts.map((artifact) => ({
-			id: artifact.id,
-			outputPath: artifact.generates,
-			description: artifact.description,
-			template: artifact.template,
-			instruction: artifact.instruction,
-			requires: artifact.requires ?? []
-		})),
-		applyRequires: apply?.requires ?? [],
-		applyTracks: apply?.tracks,
-		applyInstruction: apply?.instruction
-	};
-	const validated = SchemaDetailSchema.safeParse(detail);
-	if (!validated.success) throw new Error(`Invalid schema detail: ${validated.error.message}`);
-	return validated.data;
-}
-
 //#endregion
 //#region src/reactive-kv.ts
 /**
@@ -639,20 +604,6 @@ function requireChangeId(changeId) {
 function ensureEditableSource(source, label) {
 	if (source === "package") throw new Error(`${label} is read-only (package source)`);
 }
-function parseCliJson(raw, schema, label) {
-	const trimmed = raw.trim();
-	if (!trimmed) throw new Error(`${label} returned empty output`);
-	let parsed;
-	try {
-		parsed = JSON.parse(trimmed);
-	} catch (err) {
-		const message = err instanceof Error ? err.message : String(err);
-		throw new Error(`${label} returned invalid JSON: ${message}`);
-	}
-	const result = schema.safeParse(parsed);
-	if (!result.success) throw new Error(`${label} returned unexpected JSON: ${result.error.message}`);
-	return result.data;
-}
 function resolveEntryPath(root, entryPath) {
 	const normalizedRoot = resolve(root);
 	const resolvedPath = resolve(normalizedRoot, entryPath);
@@ -660,153 +611,62 @@ function resolveEntryPath(root, entryPath) {
 	if (resolvedPath !== normalizedRoot && !resolvedPath.startsWith(rootPrefix)) throw new Error("Invalid path: outside schema root");
 	return resolvedPath;
 }
-function toRelativePath(root, absolutePath) {
-	return relative(root, absolutePath).split(sep).join("/");
-}
-async function readEntriesUnderRoot(root) {
-	if (!(await reactiveStat(root))?.isDirectory) return [];
-	const collectEntries = async (dir) => {
-		const names = await reactiveReadDir(dir, { includeHidden: false });
-		const entries = [];
-		for (const name of names) {
-			const fullPath = join(dir, name);
-			const statInfo = await reactiveStat(fullPath);
-			if (!statInfo) continue;
-			const relativePath = toRelativePath(root, fullPath);
-			if (statInfo.isDirectory) {
-				entries.push({
-					path: relativePath,
-					type: "directory"
-				});
-				entries.push(...await collectEntries(fullPath));
-			} else {
-				const content = await reactiveReadFile(fullPath);
-				const size = content ? Buffer.byteLength(content, "utf-8") : void 0;
-				entries.push({
-					path: relativePath,
-					type: "file",
-					content: content ?? void 0,
-					size
-				});
-			}
-		}
-		return entries;
-	};
-	return collectEntries(root);
-}
-async function touchOpsxProjectDeps(projectDir) {
-	const openspecDir = join(projectDir, "openspec");
-	await reactiveReadFile(join(openspecDir, "config.yaml"));
-	const schemaRoot = join(openspecDir, "schemas");
-	const schemaDirs = await reactiveReadDir(schemaRoot, {
-		directoriesOnly: true,
-		includeHidden: true
-	});
-	await Promise.all(schemaDirs.map((name) => reactiveReadFile(join(schemaRoot, name, "schema.yaml"))));
-	await reactiveReadDir(join(openspecDir, "changes"), {
-		directoriesOnly: true,
-		includeHidden: true,
-		exclude: ["archive"]
-	});
-}
-async function touchOpsxChangeDeps(projectDir, changeId) {
-	const changeDir = join(projectDir, "openspec", "changes", changeId);
-	await reactiveReadDir(changeDir, { includeHidden: true });
-	await reactiveReadFile(join(changeDir, ".openspec.yaml"));
-}
-async function readGlobArtifactFiles(projectDir, changeId, outputPath) {
-	return (await readEntriesUnderRoot(join(projectDir, "openspec", "changes", changeId))).filter((entry) => entry.type === "file" && matchesGlob(entry.path, outputPath)).map((entry) => ({
-		path: entry.path,
-		type: "file",
-		content: entry.content ?? ""
-	}));
-}
 async function fetchOpsxStatus(ctx, input) {
 	const changeId = requireChangeId(input.change);
-	await touchOpsxProjectDeps(ctx.projectDir);
-	await touchOpsxChangeDeps(ctx.projectDir, changeId);
-	const args = [
-		"status",
-		"--json",
-		"--change",
-		changeId
-	];
-	if (input.schema) args.push("--schema", input.schema);
-	const result = await ctx.cliExecutor.execute(args);
-	if (!result.success) throw new Error(result.stderr || `openspec status failed (exit ${result.exitCode ?? "null"})`);
-	const status = parseCliJson(result.stdout, ChangeStatusSchema, "openspec status");
-	const changeRelDir = `openspec/changes/${changeId}`;
-	for (const artifact of status.artifacts) artifact.relativePath = `${changeRelDir}/${artifact.outputPath}`;
-	return status;
+	await ctx.kernel.waitForWarmup();
+	await ctx.kernel.ensureStatus(changeId, input.schema);
+	return ctx.kernel.getStatus(changeId, input.schema);
 }
 async function fetchOpsxStatusList(ctx) {
-	const changeIds = await reactiveReadDir(join(ctx.projectDir, "openspec", "changes"), {
-		directoriesOnly: true,
-		includeHidden: false,
-		exclude: ["archive"]
-	});
-	return await Promise.all(changeIds.map((changeId) => fetchOpsxStatus(ctx, { change: changeId })));
+	await ctx.kernel.waitForWarmup();
+	await ctx.kernel.ensureStatusList();
+	return ctx.kernel.getStatusList();
 }
 async function fetchOpsxInstructions(ctx, input) {
 	const changeId = requireChangeId(input.change);
-	await touchOpsxProjectDeps(ctx.projectDir);
-	await touchOpsxChangeDeps(ctx.projectDir, changeId);
-	const args = [
-		"instructions",
-		input.artifact,
-		"--json",
-		"--change",
-		changeId
-	];
-	if (input.schema) args.push("--schema", input.schema);
-	const result = await ctx.cliExecutor.execute(args);
-	if (!result.success) throw new Error(result.stderr || `openspec instructions failed (exit ${result.exitCode ?? "null"})`);
-	return parseCliJson(result.stdout, ArtifactInstructionsSchema, "openspec instructions");
+	await ctx.kernel.waitForWarmup();
+	await ctx.kernel.ensureInstructions(changeId, input.artifact, input.schema);
+	return ctx.kernel.getInstructions(changeId, input.artifact, input.schema);
 }
 async function fetchOpsxApplyInstructions(ctx, input) {
 	const changeId = requireChangeId(input.change);
-	await touchOpsxProjectDeps(ctx.projectDir);
-	await touchOpsxChangeDeps(ctx.projectDir, changeId);
-	const args = [
-		"instructions",
-		"apply",
-		"--json",
-		"--change",
-		changeId
-	];
-	if (input.schema) args.push("--schema", input.schema);
-	const result = await ctx.cliExecutor.execute(args);
-	if (!result.success) throw new Error(result.stderr || `openspec instructions apply failed (exit ${result.exitCode ?? "null"})`);
-	return parseCliJson(result.stdout, ApplyInstructionsSchema, "openspec instructions apply");
+	await ctx.kernel.waitForWarmup();
+	await ctx.kernel.ensureApplyInstructions(changeId, input.schema);
+	return ctx.kernel.getApplyInstructions(changeId, input.schema);
 }
-async function fetchOpsxSchemas(ctx) {
-	await touchOpsxProjectDeps(ctx.projectDir);
-	const result = await ctx.cliExecutor.schemas();
-	if (!result.success) throw new Error(result.stderr || `openspec schemas failed (exit ${result.exitCode ?? "null"})`);
-	return parseCliJson(result.stdout, z.array(SchemaInfoSchema), "openspec schemas");
+async function fetchOpsxConfigBundle(ctx) {
+	await ctx.kernel.ensureSchemas();
+	const schemas = ctx.kernel.getSchemas();
+	for (const schema of schemas) {
+		ctx.kernel.ensureSchemaDetail(schema.name).catch(() => {});
+		ctx.kernel.ensureSchemaResolution(schema.name).catch(() => {});
+	}
+	const schemaDetails = {};
+	const schemaResolutions = {};
+	for (const schema of schemas) {
+		schemaDetails[schema.name] = ctx.kernel.peekSchemaDetail(schema.name);
+		schemaResolutions[schema.name] = ctx.kernel.peekSchemaResolution(schema.name);
+	}
+	return {
+		schemas,
+		schemaDetails,
+		schemaResolutions
+	};
 }
 async function fetchOpsxSchemaResolution(ctx, name) {
-	await touchOpsxProjectDeps(ctx.projectDir);
-	const result = await ctx.cliExecutor.schemaWhich(name);
-	if (!result.success) throw new Error(result.stderr || `openspec schema which failed (exit ${result.exitCode ?? "null"})`);
-	return parseCliJson(result.stdout, SchemaResolutionSchema, "openspec schema which");
+	await ctx.kernel.waitForWarmup();
+	await ctx.kernel.ensureSchemaResolution(name);
+	return ctx.kernel.getSchemaResolution(name);
 }
 async function fetchOpsxTemplates(ctx, schema) {
-	await touchOpsxProjectDeps(ctx.projectDir);
-	const result = await ctx.cliExecutor.templates(schema);
-	if (!result.success) throw new Error(result.stderr || `openspec templates failed (exit ${result.exitCode ?? "null"})`);
-	return parseCliJson(result.stdout, TemplatesSchema, "openspec templates");
+	await ctx.kernel.waitForWarmup();
+	await ctx.kernel.ensureTemplates(schema);
+	return ctx.kernel.getTemplates(schema);
 }
 async function fetchOpsxTemplateContents(ctx, schema) {
-	const templates = await fetchOpsxTemplates(ctx, schema);
-	const entries = await Promise.all(Object.entries(templates).map(async ([artifactId, info]) => {
-		return [artifactId, {
-			content: await reactiveReadFile(info.path),
-			path: info.path,
-			source: info.source
-		}];
-	}));
-	return Object.fromEntries(entries);
+	await ctx.kernel.waitForWarmup();
+	await ctx.kernel.ensureTemplateContents(schema);
+	return ctx.kernel.getTemplateContents(schema);
 }
 /**
 * Spec router - spec CRUD operations
@@ -1196,11 +1056,11 @@ const opsxRouter = router({
 	})).subscription(({ ctx, input }) => {
 		return createReactiveSubscription(() => fetchOpsxApplyInstructions(ctx, input));
 	}),
-	schemas: publicProcedure.query(async ({ ctx }) => {
-		return fetchOpsxSchemas(ctx);
+	configBundle: publicProcedure.query(async ({ ctx }) => {
+		return fetchOpsxConfigBundle(ctx);
 	}),
-	subscribeSchemas: publicProcedure.subscription(({ ctx }) => {
-		return createReactiveSubscription(() => fetchOpsxSchemas(ctx));
+	subscribeConfigBundle: publicProcedure.subscription(({ ctx }) => {
+		return createReactiveSubscription(() => fetchOpsxConfigBundle(ctx));
 	}),
 	templates: publicProcedure.input(z.object({ schema: z.string().optional() }).optional()).query(async ({ ctx, input }) => {
 		return fetchOpsxTemplates(ctx, input?.schema);
@@ -1214,53 +1074,34 @@ const opsxRouter = router({
 	subscribeTemplateContents: publicProcedure.input(z.object({ schema: z.string().optional() }).optional()).subscription(({ ctx, input }) => {
 		return createReactiveSubscription(() => fetchOpsxTemplateContents(ctx, input?.schema));
 	}),
-	schemaResolution: publicProcedure.input(z.object({ name: z.string() })).query(async ({ ctx, input }) => {
-		return fetchOpsxSchemaResolution(ctx, input.name);
-	}),
-	subscribeSchemaResolution: publicProcedure.input(z.object({ name: z.string() })).subscription(({ ctx, input }) => {
-		return createReactiveSubscription(() => fetchOpsxSchemaResolution(ctx, input.name));
-	}),
-	schemaDetail: publicProcedure.input(z.object({ name: z.string() })).query(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
-		const schemaPath = join((await fetchOpsxSchemaResolution(ctx, input.name)).path, "schema.yaml");
-		const content = await reactiveReadFile(schemaPath);
-		if (!content) throw new Error(`schema.yaml not found at ${schemaPath}`);
-		return parseSchemaYaml(content);
-	}),
-	subscribeSchemaDetail: publicProcedure.input(z.object({ name: z.string() })).subscription(({ ctx, input }) => {
-		return createReactiveSubscription(async () => {
-			await touchOpsxProjectDeps(ctx.projectDir);
-			const schemaPath = join((await fetchOpsxSchemaResolution(ctx, input.name)).path, "schema.yaml");
-			const content = await reactiveReadFile(schemaPath);
-			if (!content) throw new Error(`schema.yaml not found at ${schemaPath}`);
-			return parseSchemaYaml(content);
-		});
-	}),
 	schemaFiles: publicProcedure.input(z.object({ name: z.string() })).query(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
-		return readEntriesUnderRoot((await fetchOpsxSchemaResolution(ctx, input.name)).path);
+		await ctx.kernel.waitForWarmup();
+		await ctx.kernel.ensureSchemaFiles(input.name);
+		return ctx.kernel.getSchemaFiles(input.name);
 	}),
 	subscribeSchemaFiles: publicProcedure.input(z.object({ name: z.string() })).subscription(({ ctx, input }) => {
 		return createReactiveSubscription(async () => {
-			await touchOpsxProjectDeps(ctx.projectDir);
-			return readEntriesUnderRoot((await fetchOpsxSchemaResolution(ctx, input.name)).path);
+			await ctx.kernel.waitForWarmup();
+			await ctx.kernel.ensureSchemaFiles(input.name);
+			return ctx.kernel.getSchemaFiles(input.name);
 		});
 	}),
 	schemaYaml: publicProcedure.input(z.object({ name: z.string() })).query(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
-		return reactiveReadFile(join((await fetchOpsxSchemaResolution(ctx, input.name)).path, "schema.yaml"));
+		await ctx.kernel.waitForWarmup();
+		await ctx.kernel.ensureSchemaYaml(input.name);
+		return ctx.kernel.getSchemaYaml(input.name);
 	}),
 	subscribeSchemaYaml: publicProcedure.input(z.object({ name: z.string() })).subscription(({ ctx, input }) => {
 		return createReactiveSubscription(async () => {
-			await touchOpsxProjectDeps(ctx.projectDir);
-			return reactiveReadFile(join((await fetchOpsxSchemaResolution(ctx, input.name)).path, "schema.yaml"));
+			await ctx.kernel.waitForWarmup();
+			await ctx.kernel.ensureSchemaYaml(input.name);
+			return ctx.kernel.getSchemaYaml(input.name);
 		});
 	}),
 	writeSchemaYaml: publicProcedure.input(z.object({
 		name: z.string(),
 		content: z.string()
 	})).mutation(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
 		const resolution = await fetchOpsxSchemaResolution(ctx, input.name);
 		ensureEditableSource(resolution.source, "schema.yaml");
 		const schemaPath = join(resolution.path, "schema.yaml");
@@ -1273,7 +1114,6 @@ const opsxRouter = router({
 		path: z.string(),
 		content: z.string()
 	})).mutation(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
 		const resolution = await fetchOpsxSchemaResolution(ctx, input.schema);
 		ensureEditableSource(resolution.source, "schema file");
 		if (!input.path.trim()) throw new Error("path is required");
@@ -1287,7 +1127,6 @@ const opsxRouter = router({
 		path: z.string(),
 		content: z.string().optional()
 	})).mutation(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
 		const resolution = await fetchOpsxSchemaResolution(ctx, input.schema);
 		ensureEditableSource(resolution.source, "schema file");
 		if (!input.path.trim()) throw new Error("path is required");
@@ -1300,7 +1139,6 @@ const opsxRouter = router({
 		schema: z.string(),
 		path: z.string()
 	})).mutation(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
 		const resolution = await fetchOpsxSchemaResolution(ctx, input.schema);
 		ensureEditableSource(resolution.source, "schema directory");
 		if (!input.path.trim()) throw new Error("path is required");
@@ -1311,7 +1149,6 @@ const opsxRouter = router({
 		schema: z.string(),
 		path: z.string()
 	})).mutation(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
 		const resolution = await fetchOpsxSchemaResolution(ctx, input.schema);
 		ensureEditableSource(resolution.source, "schema entry");
 		if (!input.path.trim()) throw new Error("path is required");
@@ -1327,26 +1164,18 @@ const opsxRouter = router({
 		schema: z.string(),
 		artifactId: z.string()
 	})).query(async ({ ctx, input }) => {
-		const info = (await fetchOpsxTemplates(ctx, input.schema))[input.artifactId];
+		const info = (await fetchOpsxTemplateContents(ctx, input.schema))[input.artifactId];
 		if (!info) throw new Error(`Template not found for ${input.schema}:${input.artifactId}`);
-		return {
-			content: await reactiveReadFile(info.path),
-			path: info.path,
-			source: info.source
-		};
+		return info;
 	}),
 	subscribeTemplateContent: publicProcedure.input(z.object({
 		schema: z.string(),
 		artifactId: z.string()
 	})).subscription(({ ctx, input }) => {
 		return createReactiveSubscription(async () => {
-			const info = (await fetchOpsxTemplates(ctx, input.schema))[input.artifactId];
+			const info = (await fetchOpsxTemplateContents(ctx, input.schema))[input.artifactId];
 			if (!info) throw new Error(`Template not found for ${input.schema}:${input.artifactId}`);
-			return {
-				content: await reactiveReadFile(info.path),
-				path: info.path,
-				source: info.source
-			};
+			return info;
 		});
 	}),
 	writeTemplateContent: publicProcedure.input(z.object({
@@ -1362,7 +1191,6 @@ const opsxRouter = router({
 		return { success: true };
 	}),
 	deleteSchema: publicProcedure.input(z.object({ name: z.string() })).mutation(async ({ ctx, input }) => {
-		await touchOpsxProjectDeps(ctx.projectDir);
 		const resolution = await fetchOpsxSchemaResolution(ctx, input.name);
 		ensureEditableSource(resolution.source, "schema");
 		await rm(resolution.path, {
@@ -1372,11 +1200,15 @@ const opsxRouter = router({
 		return { success: true };
 	}),
 	projectConfig: publicProcedure.query(async ({ ctx }) => {
-		return reactiveReadFile(join(ctx.projectDir, "openspec", "config.yaml"));
+		await ctx.kernel.waitForWarmup();
+		await ctx.kernel.ensureProjectConfig();
+		return ctx.kernel.getProjectConfig();
 	}),
 	subscribeProjectConfig: publicProcedure.subscription(({ ctx }) => {
 		return createReactiveSubscription(async () => {
-			return reactiveReadFile(join(ctx.projectDir, "openspec", "config.yaml"));
+			await ctx.kernel.waitForWarmup();
+			await ctx.kernel.ensureProjectConfig();
+			return ctx.kernel.getProjectConfig();
 		});
 	}),
 	writeProjectConfig: publicProcedure.input(z.object({ content: z.string() })).mutation(async ({ ctx, input }) => {
@@ -1386,55 +1218,63 @@ const opsxRouter = router({
 		return { success: true };
 	}),
 	listChanges: publicProcedure.query(async ({ ctx }) => {
-		return reactiveReadDir(join(ctx.projectDir, "openspec", "changes"), {
-			directoriesOnly: true,
-			exclude: ["archive"],
-			includeHidden: false
-		});
+		await ctx.kernel.waitForWarmup();
+		await ctx.kernel.ensureChangeIds();
+		return ctx.kernel.getChangeIds();
 	}),
 	subscribeChanges: publicProcedure.subscription(({ ctx }) => {
 		return createReactiveSubscription(async () => {
-			return reactiveReadDir(join(ctx.projectDir, "openspec", "changes"), {
-				directoriesOnly: true,
-				exclude: ["archive"],
-				includeHidden: false
-			});
+			await ctx.kernel.waitForWarmup();
+			await ctx.kernel.ensureChangeIds();
+			return ctx.kernel.getChangeIds();
 		});
 	}),
 	changeMetadata: publicProcedure.input(z.object({ changeId: z.string() })).query(async ({ ctx, input }) => {
-		return reactiveReadFile(join(ctx.projectDir, "openspec", "changes", input.changeId, ".openspec.yaml"));
+		await ctx.kernel.waitForWarmup();
+		await ctx.kernel.ensureChangeMetadata(input.changeId);
+		return ctx.kernel.getChangeMetadata(input.changeId);
 	}),
 	subscribeChangeMetadata: publicProcedure.input(z.object({ changeId: z.string() })).subscription(({ ctx, input }) => {
 		return createReactiveSubscription(async () => {
-			return reactiveReadFile(join(ctx.projectDir, "openspec", "changes", input.changeId, ".openspec.yaml"));
+			await ctx.kernel.waitForWarmup();
+			await ctx.kernel.ensureChangeMetadata(input.changeId);
+			return ctx.kernel.getChangeMetadata(input.changeId);
 		});
 	}),
 	readArtifactOutput: publicProcedure.input(z.object({
 		changeId: z.string(),
 		outputPath: z.string()
 	})).query(async ({ ctx, input }) => {
-		return reactiveReadFile(join(ctx.projectDir, "openspec", "changes", input.changeId, input.outputPath));
+		await ctx.kernel.waitForWarmup();
+		await ctx.kernel.ensureArtifactOutput(input.changeId, input.outputPath);
+		return ctx.kernel.getArtifactOutput(input.changeId, input.outputPath);
 	}),
 	subscribeArtifactOutput: publicProcedure.input(z.object({
 		changeId: z.string(),
 		outputPath: z.string()
 	})).subscription(({ ctx, input }) => {
 		return createReactiveSubscription(async () => {
-			return reactiveReadFile(join(ctx.projectDir, "openspec", "changes", input.changeId, input.outputPath));
+			await ctx.kernel.waitForWarmup();
+			await ctx.kernel.ensureArtifactOutput(input.changeId, input.outputPath);
+			return ctx.kernel.getArtifactOutput(input.changeId, input.outputPath);
 		});
 	}),
 	readGlobArtifactFiles: publicProcedure.input(z.object({
 		changeId: z.string(),
 		outputPath: z.string()
 	})).query(async ({ ctx, input }) => {
-		return readGlobArtifactFiles(ctx.projectDir, input.changeId, input.outputPath);
+		await ctx.kernel.waitForWarmup();
+		await ctx.kernel.ensureGlobArtifactFiles(input.changeId, input.outputPath);
+		return ctx.kernel.getGlobArtifactFiles(input.changeId, input.outputPath);
 	}),
 	subscribeGlobArtifactFiles: publicProcedure.input(z.object({
 		changeId: z.string(),
 		outputPath: z.string()
 	})).subscription(({ ctx, input }) => {
 		return createReactiveSubscription(async () => {
-			return readGlobArtifactFiles(ctx.projectDir, input.changeId, input.outputPath);
+			await ctx.kernel.waitForWarmup();
+			await ctx.kernel.ensureGlobArtifactFiles(input.changeId, input.outputPath);
+			return ctx.kernel.getGlobArtifactFiles(input.changeId, input.outputPath);
 		});
 	}),
 	writeArtifactOutput: publicProcedure.input(z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/server",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "dist/index.mjs",
   "exports": {
@@ -20,8 +20,8 @@
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
     "zod": "^3.24.1",
-    "@openspecui/search": "1.1.0",
-    "@openspecui/core": "1.1.0"
+    "@openspecui/core": "1.2.0",
+    "@openspecui/search": "1.1.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",