@openspecui/core 7.0.1 → 7.0.2

package/dist/index.mjs

@@ -13,8 +13,8 @@ import { $ as shouldShowTranslationEngineInstallGate, A as TranslationEngineIdSc
 import { a as ActiveRootOfficialConfigSchema, c as MAX_ACTIVE_ROOT_CONTEXT_BYTES, i as ActiveRootMutationSchema, n as patchActiveRootOfficialFields, o as ActiveRootRevisionSchema, r as validateActiveRootRawYaml, s as ActiveRootStructuredUpdateSchema, t as inspectActiveRootOfficialConfig } from "./active-root-config-L5QaMb3A.mjs";
 import { a as DocumentTranslationDisplayModeSchema, c as TRANSLATION_CACHE_POLICY_VERSION, d as TranslationCacheSettingsSchema, f as TranslationCacheSettingsUpdateSchema, g as TranslationEngineProjectSettingsUpdateSchema, h as TranslationEngineProjectSettingsSchema, i as DocumentTranslationConfigUpdateSchema, l as TranslationCacheEntrySchema, m as TranslationCacheWriteInputSchema, n as DOCUMENT_TRANSLATION_DISPLAY_MODES, o as MAX_TRANSLATION_CACHE_ENTRY_LIMIT, p as TranslationCacheStatsSchema, r as DocumentTranslationConfigSchema, s as MIN_TRANSLATION_CACHE_ENTRY_LIMIT, t as DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT, u as TranslationCacheReadInputSchema } from "./document-translation-B3xaP0dJ.mjs";
 import { _ as customHashFromSoundId, a as CustomSoundHashSchema, b as soundIdFromCustomHash, c as CustomSoundMetadataSchema, f as LEGACY_SOUND_ID_MAP, g as SoundVolumeSchema, h as SoundIdSchema, i as CUSTOM_SOUND_ADD_VALUE, l as DEFAULT_BELL_SOUND_ID, m as SoundConfigIdSchema, n as BUILTIN_SOUND_OPTIONS, o as CustomSoundIdSchema, p as SILENT_SOUND_ID, r as BuiltinSoundIdSchema, s as CustomSoundMetadataFileSchema, t as BUILTIN_SOUND_IDS, u as DEFAULT_NOTIFICATION_SOUND_ID, v as getBuiltinSoundUrl, y as normalizeLegacySoundId } from "./sounds-6prQvKXl.mjs";
-import { n as terminalNotificationEventToPublishInput, t as TerminalControlParser } from "./terminal-control-c6oS-lFb.mjs";
-import { a as NotificationPublishInputSchema, c as NotificationSoundSchema, h as groupNotifications, i as NotificationGroupKeySchema, l as NotificationSourceSchema, m as getNotificationGroupLabel, n as NOTIFICATION_SOUND_VALUES, o as NotificationRecordSchema, p as getNotificationGroupKey, r as NotificationActionSchema, s as NotificationSettingsSchema, t as NOTIFICATION_SOUND_OPTIONS, u as TerminalNotificationParser } from "./notifications-Cy74GVN7.mjs";
+import { n as terminalNotificationEventToPublishInput, t as TerminalControlParser } from "./terminal-control-CdPuYwwU.mjs";
+import { a as NotificationPublishInputSchema, c as NotificationSoundSchema, h as groupNotifications, i as NotificationGroupKeySchema, l as NotificationSourceSchema, m as getNotificationGroupLabel, n as NOTIFICATION_SOUND_VALUES, o as NotificationRecordSchema, p as getNotificationGroupKey, r as NotificationActionSchema, s as NotificationSettingsSchema, t as NOTIFICATION_SOUND_OPTIONS, u as TerminalNotificationParser } from "./notifications-VHUMI-qG.mjs";
 import { n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSoundSchema, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-DeubAfFC.mjs";
 import { a as TERMINAL_THEME_VALUES, i as TERMINAL_THEME_MODE_VALUES, n as DEFAULT_TERMINAL_LIGHT_THEME, r as DEFAULT_TERMINAL_THEME_MODE, t as DEFAULT_TERMINAL_DARK_THEME } from "./terminal-theme-Byzxmnjm.mjs";
 import { i as selectLocalDownloadGroup, n as buildLocalDownloadPlanFromRepositoryFiles, r as buildLocalDownloadPlanFromRuntimeProfileFiles, t as LOCAL_MODEL_PROFILE_DEFINITIONS } from "./local-download-profiles-h9lUTXr-.mjs";
@@ -34,7 +34,8 @@ import { dirname, join } from "path";
 import { isMap, parseDocument } from "yaml";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import { access, lstat, mkdir as mkdir$1, open, readFile, readdir, realpath, rename, rm, stat, writeFile as writeFile$1 } from "node:fs/promises";
-import { basename, dirname as dirname$1, isAbsolute, join as join$1, matchesGlob, posix, relative, resolve, sep, win32 } from "node:path";
+import { basename, dirname as dirname$1, extname, isAbsolute, join as join$1, matchesGlob, posix, relative, resolve, sep, win32 } from "node:path";
+import { setTimeout as setTimeout$1 } from "node:timers/promises";
 import { existsSync, lstatSync, readFileSync, realpathSync } from "node:fs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { z } from "zod";
@@ -42,12 +43,14 @@ import { EventEmitter } from "events";
 import { watch } from "fs";
 import { exec, execFile } from "child_process";
 import { promisify } from "util";
-import crossSpawn from "cross-spawn";
+import { pathToFileURL } from "node:url";
+import { execFile as execFile$1, spawn, spawnSync } from "node:child_process";
+import process$1 from "node:process";
+import { promisify as promisify$1 } from "node:util";
 import { homedir, loadavg, platform } from "node:os";
 import { context, trace } from "@opentelemetry/api";
 import { performance as performance$1 } from "node:perf_hooks";
 import { Worker } from "node:worker_threads";
-import { pathToFileURL } from "node:url";
 
 //#region src/parser.ts
 const SCENARIO_STEP_PATTERN = new RegExp(`^\\s*[-*+]\\s+(?:\\*\\*)?(${[
@@ -540,7 +543,7 @@ var ProjectWatcher = class {
 	matchPath(event, sub) {
 		const eventPath = event.path;
 		if (sub.watchAncestorsWhileMissing && sub.awaitingPathCreation && isStrictAncestorPath(eventPath, sub.path)) return true;
-		if (sub.watchChildren) return eventPath.startsWith(sub.path + "/") || eventPath === sub.path;
+		if (sub.watchChildren) return eventPath === sub.path || isStrictAncestorPath(sub.path, eventPath);
 		else {
 			const eventDir = dirname$1(eventPath);
 			return eventPath === sub.path || eventDir === sub.path;
@@ -756,13 +759,14 @@ async function closeAllProjectWatchers() {
 //#endregion
 //#region src/reactive-fs/watcher-pool.ts
 /**
-* Orthogonal intents (updated 2026-07-28 Asia/Shanghai):
+* Orthogonal intents (updated 2026-08-07 Asia/Shanghai):
 * 1. Own a reference-counted dynamic set of physical watcher roots, including missing logical roots
 *    through their nearest existing ancestor.
 * 2. Bind shared path subscriptions to the deepest active containing root.
 * 3. Rebind pending subscriptions when roots appear, disappear, or recover.
 * 4. Expose aggregate and per-root runtime status for server diagnostics.
-* 5. Keep missing-path ancestor settlement explicit in subscription identity and release all leases deterministically.
+* 5. Keep missing-path ancestor settlement explicit in subscription identity and retire every
+*    physical subscription plus cached ProjectWatcher during full teardown.
 *
 * Original request (2026-07-15): "响应式内核要观察 data home、Store roots 和 connected project roots。"
 * Remote CI fixed point (2026-07-28): data-home Schema creation may arrive as an ancestor event on Linux.
@@ -989,6 +993,7 @@ async function closeAllWatchers() {
 	]);
 	closingWatcherRoots.clear();
 	closingPhysicalWatchers.clear();
+	await closeAllProjectWatchers();
 	emitWatcherRuntimeStatus();
 }
 function isWatcherPoolInitialized() {
@@ -1617,19 +1622,37 @@ function getCacheSize() {
 //#endregion
 //#region src/physical-reactive-file-writer.ts
 /**
-* Orthogonal intents (updated 2026-08-02 Asia/Shanghai):
+* Orthogonal intents (updated 2026-08-05 Asia/Shanghai):
 * 1. Own lexical and existing-ancestor physical confinement for root-scoped mutations.
-* 2. Execute direct or atomic UTF-8 write, directory-create, remove, and guarded external mutations.
+* 2. Execute direct or atomic UTF-8 write, including bounded Windows replacement retries.
 * 3. Settle overlapping reactive projections before returning any terminal outcome.
 * 4. Keep TOCTOU and hard-link alias limitations explicit at the mutation seam.
 *
 * Original request (2026-07-16): "建立唯一的 physical/reactive entity-write owner。"
 * Original request (2026-07-16): "Schema/Template mutations must reject symlink escape and settle reactive projections before success."
 * Derived requirement (2026-08-02): "Raw Active Root YAML uses same-directory atomic replacement before reactive settlement."
+* Original request (2026-08-05): Continue the Windows adaptation and fix equivalent failures together.
 */
+const WINDOWS_FILE_REPLACEMENT_RETRY_LIMIT = 80;
+const WINDOWS_FILE_REPLACEMENT_RETRY_DELAY_MS = 25;
 function isMissingPath(error) {
 	return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
 }
+function isRetryableWindowsFileReplacementError(error) {
+	if (typeof error !== "object" || error === null || !("code" in error)) return false;
+	const code = error.code;
+	return code === "EACCES" || code === "EBUSY" || code === "EPERM";
+}
+/** Commit one prepared replacement through rename, retrying transient Windows file locks. */
+async function replaceFileAtomically(temporaryPath, targetPath) {
+	for (let attempt = 0;; attempt += 1) try {
+		await rename(temporaryPath, targetPath);
+		return;
+	} catch (error) {
+		if (process.platform !== "win32" || !isRetryableWindowsFileReplacementError(error) || attempt >= WINDOWS_FILE_REPLACEMENT_RETRY_LIMIT) throw error;
+		await setTimeout$1(WINDOWS_FILE_REPLACEMENT_RETRY_DELAY_MS);
+	}
+}
 function ensureContained(rootPath, candidatePath, boundary) {
 	const childPath = relative(rootPath, candidatePath);
 	if (childPath === ".." || childPath.startsWith(`..${sep}`) || isAbsolute(childPath)) throw new Error(`Mutation target escaped the ${boundary} root.`);
@@ -1734,7 +1757,7 @@ async function writeAtomicPhysicalReactiveFile(input) {
 			await temporaryFile.close();
 			temporaryFile = null;
 			await assertMutationTarget(target);
-			await rename(temporaryPath, target.targetPath);
+			await replaceFileAtomically(temporaryPath, target.targetPath);
 		} finally {
 			await temporaryFile?.close().catch(() => void 0);
 			await rm(temporaryPath, { force: true }).catch(() => void 0);
@@ -1777,7 +1800,7 @@ async function compareAndWriteAtomicPhysicalReactiveFile(input) {
 				state: "conflict",
 				content: currentContent
 			};
-			await rename(temporaryPath, target.targetPath);
+			await replaceFileAtomically(temporaryPath, target.targetPath);
 			committed = true;
 			return { state: "written" };
 		} finally {
@@ -1894,9 +1917,9 @@ var Validator = class {
 //#endregion
 //#region src/adapter.ts
 /**
-* Orthogonal intents (updated 2026-08-02 Asia/Shanghai):
+* Orthogonal intents (updated 2026-08-04 Asia/Shanghai):
 * 1. Read and mutate one CLI-selected planning root through reactive filesystem APIs.
-* 2. Project recursive Specs, Changes, Archives, and schema-neutral entity files.
+* 2. Project recursive Specs, Changes, Archives, and schema-neutral entity files with canonical protocol paths.
 * 3. Keep tracked workflow tasks distinct from document checklist analytics.
 * 4. Preserve filesystem provenance and mutation boundaries for server consumers.
 * 5. Expose Launch Project local-initialization evidence independently from Planning-root readiness.
@@ -1904,6 +1927,7 @@ var Validator = class {
 * Original request (2026-07-15): "Split formal tracked progress, document checklist statistics, and Apply instruction progress into non-interchangeable facts."
 * Original request (2026-08-01): adapt OpenSpec 1.7 nested Spec ids such as `platform/auth`.
 * Review correction (2026-08-02): a same-named ordinary file is not initialized project structure.
+* Original request (2026-08-04): "Make pnpm openspecui start and equivalent package scripts work on Windows."
 */
 /**
 * OpenSpec filesystem adapter
@@ -2117,7 +2141,7 @@ var OpenSpecAdapter = class {
 			const fullPath = join(dir, name);
 			const statInfo = await reactiveStat(fullPath);
 			if (!statInfo) continue;
-			const relativePath = fullPath.slice(root.length + 1);
+			const relativePath = normalizeOpsxEntityPath(fullPath.slice(root.length + 1));
 			if (statInfo.isDirectory) {
 				files.push({
 					path: relativePath,
@@ -2503,6 +2527,17 @@ function updateProjectBindingContent(content, update) {
 //#endregion
 //#region src/watcher.ts
 /**
+* Orthogonal intents (updated 2026-08-09 Asia/Shanghai):
+* 1. Project legacy OpenSpec directory changes for compatibility consumers.
+* 2. Settle every native watcher handle before runtime teardown completes.
+* 3. Interpret native recursive-watch paths without assuming one directory separator.
+*
+* Original request (2026-08-04): "Make pnpm openspecui start and equivalent package scripts work on Windows."
+*/
+function watchedPathSegments(filename) {
+	return filename.split(/[\\/]+/).filter(Boolean);
+}
+/**
 * OpenSpec file watcher
 * Watches the openspec/ directory for changes and emits events
 */
@@ -2533,33 +2568,36 @@ var OpenSpecWatcher = class extends EventEmitter {
 	start() {
 		this.stop();
 		this.watchDir(this.specsDir, (filename, eventType) => {
-			const match = filename.match(/^([^/]+)\//);
-			if (match) this.emitDebounced(`spec:${match[1]}`, {
+			const segments = watchedPathSegments(filename);
+			const id = segments.length > 1 ? segments[0] : void 0;
+			if (id) this.emitDebounced(`spec:${id}`, {
 				type: "spec",
 				action: eventType === "rename" ? "create" : "update",
-				id: match[1],
-				path: join(this.specsDir, filename),
+				id,
+				path: join(this.specsDir, ...segments),
 				timestamp: Date.now()
 			});
 		});
 		this.watchDir(this.changesDir, (filename, eventType) => {
-			if (filename.startsWith("archive/")) return;
-			const match = filename.match(/^([^/]+)\//);
-			if (match) this.emitDebounced(`change:${match[1]}`, {
+			const segments = watchedPathSegments(filename);
+			if (segments[0] === "archive") return;
+			const id = segments.length > 1 ? segments[0] : void 0;
+			if (id) this.emitDebounced(`change:${id}`, {
 				type: "change",
 				action: eventType === "rename" ? "create" : "update",
-				id: match[1],
-				path: join(this.changesDir, filename),
+				id,
+				path: join(this.changesDir, ...segments),
 				timestamp: Date.now()
 			});
 		});
 		this.watchDir(this.archiveDir, (filename, eventType) => {
-			const match = filename.match(/^([^/]+)\//);
-			if (match) this.emitDebounced(`archive:${match[1]}`, {
+			const segments = watchedPathSegments(filename);
+			const id = segments.length > 1 ? segments[0] : void 0;
+			if (id) this.emitDebounced(`archive:${id}`, {
 				type: "archive",
 				action: eventType === "rename" ? "create" : "update",
-				id: match[1],
-				path: join(this.archiveDir, filename),
+				id,
+				path: join(this.archiveDir, ...segments),
 				timestamp: Date.now()
 			});
 		});
@@ -2577,11 +2615,22 @@ var OpenSpecWatcher = class extends EventEmitter {
 	* Stop watching for file changes
 	*/
 	stop() {
-		for (const watcher of this.watchers) watcher.close();
+		for (const watcher of this.takeWatchers()) watcher.close();
+	}
+	/** Close every watcher and wait until native filesystem handles are released. */
+	async close() {
+		await Promise.all(this.takeWatchers().map((watcher) => new Promise((resolve$1) => {
+			watcher.once("close", resolve$1);
+			watcher.close();
+		})));
+	}
+	takeWatchers() {
+		const watchers = this.watchers;
 		this.watchers = [];
 		for (const timer of this.debounceTimers.values()) clearTimeout(timer);
 		this.debounceTimers.clear();
 		this.emit("stopped");
+		return watchers;
 	}
 	/**
 	* Watch a directory recursively
@@ -2682,6 +2731,218 @@ function sanitizePersistedSettings(value, rules) {
 	return sanitized;
 }
 
+//#endregion
+//#region src/child-process-tree.ts
+const execFileAsync$1 = promisify$1(execFile$1);
+const WINDOWS_PROCESS_TABLE_MAX_BUFFER = 16 * 1024 * 1024;
+function hasChildExited(child) {
+	return child.exitCode !== null || child.signalCode !== null;
+}
+function normalizeWindowsExecutablePath(path) {
+	return win32.normalize(path).toLowerCase();
+}
+function isWindowsProcessRecord(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const row = value;
+	return typeof row.ProcessId === "number" && typeof row.ParentProcessId === "number" && (typeof row.ExecutablePath === "string" || row.ExecutablePath === null);
+}
+/** Read the current Windows process table used for exact ancestry and root ownership checks. */
+async function readWindowsProcessTable() {
+	const { stdout } = await execFileAsync$1("powershell.exe", [
+		"-NoLogo",
+		"-NoProfile",
+		"-NonInteractive",
+		"-Command",
+		"[Console]::OutputEncoding = [Text.UTF8Encoding]::new($false); Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,ExecutablePath | ConvertTo-Json -Compress"
+	], {
+		encoding: "utf8",
+		maxBuffer: WINDOWS_PROCESS_TABLE_MAX_BUFFER,
+		windowsHide: true
+	});
+	const json = stdout.trim();
+	if (json.length === 0) return [];
+	const parsed = JSON.parse(json);
+	return (Array.isArray(parsed) ? parsed : [parsed]).filter(isWindowsProcessRecord);
+}
+/** Terminate a Windows tree only when the root PID still owns the expected executable. */
+async function terminateWindowsProcessTreeByIdentity(rootPid, expectedExecutablePath) {
+	const root = (await readWindowsProcessTable()).find((row) => row.ProcessId === rootPid);
+	if (!root) return;
+	const expectedExecutable = normalizeWindowsExecutablePath(expectedExecutablePath);
+	const actualExecutable = root.ExecutablePath ? normalizeWindowsExecutablePath(root.ExecutablePath) : null;
+	if (actualExecutable !== expectedExecutable) throw new Error(`Refusing to terminate PID ${rootPid}: expected ${expectedExecutable}, observed ${actualExecutable ?? "no executable path"}.`);
+	try {
+		await execFileAsync$1("taskkill.exe", [
+			"/PID",
+			String(rootPid),
+			"/T",
+			"/F"
+		], { windowsHide: true });
+	} catch (error) {
+		if (!(await readWindowsProcessTable()).some((row) => row.ProcessId === rootPid)) return;
+		throw error;
+	}
+}
+async function terminateWindowsProcessTree(child) {
+	const rootPid = child.pid;
+	if (rootPid === void 0 || hasChildExited(child)) return;
+	await terminateWindowsProcessTreeByIdentity(rootPid, child.spawnfile);
+}
+/** Request termination of one spawned child and every Windows descendant it owns. */
+async function terminateChildProcessTree(child, signal = "SIGTERM") {
+	if (child.pid === void 0) {
+		child.kill(signal);
+		return;
+	}
+	if (process$1.platform === "win32") {
+		await terminateWindowsProcessTree(child);
+		return;
+	}
+	if (hasChildExited(child)) return;
+	child.kill(signal);
+}
+
+//#endregion
+//#region src/command-invocation.ts
+/**
+* Orthogonal intents (created 2026-08-09 Asia/Shanghai):
+* 1. Resolve caller-environment Windows commands to native argv-preserving executable boundaries.
+* 2. Project standard npm-style shims and explicit Node shebang launchers onto their real Node executable.
+* 3. Prefer native executables, route shell-sensitive pnpm through Corepack, and reject opaque command shims.
+*
+* Original request (2026-08-04): "Make pnpm openspecui start and equivalent package scripts work on Windows."
+*/
+const WINDOWS_NATIVE_EXTENSIONS = new Set([".com", ".exe"]);
+function isBareCommand(command$1) {
+	return !/[\\/]/.test(command$1);
+}
+function commandName(command$1) {
+	return basename(command$1, extname(command$1)).toLowerCase();
+}
+function requiresShellIndependentInvocation(args) {
+	return args.some((argument) => /[%^&|<>"]/.test(argument) || argument.endsWith("\\"));
+}
+function systemExecutable(name, env) {
+	return resolve(env.SystemRoot ?? env.SYSTEMROOT ?? process$1.env.SystemRoot ?? "C:\\Windows", "System32", name);
+}
+function findWindowsCommandCandidates(command$1, options) {
+	const env = options.env ?? process$1.env;
+	const result = spawnSync(systemExecutable("where.exe", env), [command$1], {
+		cwd: options.cwd,
+		encoding: "utf8",
+		env,
+		windowsHide: true
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw new Error(result.stderr.trim() || `Unable to resolve ${command$1} from PATH.`);
+	return result.stdout.split(/\r?\n/).map((candidate) => candidate.trim()).filter(Boolean);
+}
+function tryFindWindowsCommandCandidates(command$1, options) {
+	try {
+		return findWindowsCommandCandidates(command$1, options);
+	} catch {
+		return [];
+	}
+}
+function explicitCommandCandidates(command$1, cwd) {
+	const absolute = isAbsolute(command$1) ? command$1 : resolve(cwd, command$1);
+	if (extname(absolute)) return [absolute];
+	return [
+		`${absolute}.exe`,
+		`${absolute}.cmd`,
+		absolute
+	].filter(existsSync);
+}
+function commandCandidates(command$1, options) {
+	if (isBareCommand(command$1)) return findWindowsCommandCandidates(command$1, options);
+	return explicitCommandCandidates(command$1, options.cwd ?? process$1.cwd());
+}
+function findNativeExecutable(candidates) {
+	return candidates.find((candidate) => WINDOWS_NATIVE_EXTENSIONS.has(extname(candidate).toLowerCase())) ?? null;
+}
+function findNodeExecutable(commandShim, options) {
+	const siblingNode = resolve(dirname$1(commandShim), "node.exe");
+	if (existsSync(siblingNode)) return siblingNode;
+	const fromPath = findNativeExecutable(findWindowsCommandCandidates("node", options));
+	if (fromPath) return fromPath;
+	if (process$1.release.name === "node" && extname(process$1.execPath).toLowerCase() === ".exe") return process$1.execPath;
+	throw new Error(`Unable to resolve the Node executable required by ${commandShim}.`);
+}
+function resolveNodeCommandShim(commandShim, args, options) {
+	const source = readFileSync(commandShim, "utf8");
+	if (!/(?:node(?:\.exe)?|node_exe|npm_node_execpath|_prog)/i.test(source)) return null;
+	const entries = [];
+	for (const match of source.matchAll(/%~dp0([^"\r\n]*?\.(?:c|m)?js)/gi)) {
+		const relativeEntry = match[1]?.trim().replace(/^[\\/]+/, "");
+		if (!relativeEntry) continue;
+		const entry$1 = resolve(dirname$1(commandShim), relativeEntry);
+		if (existsSync(entry$1)) entries.push(entry$1);
+	}
+	const entry = entries.at(-1);
+	if (!entry) return null;
+	return {
+		command: findNodeExecutable(commandShim, options),
+		args: [entry, ...args]
+	};
+}
+function resolveCommandShim(candidates, args, options) {
+	for (const candidate of candidates) {
+		if (extname(candidate).toLowerCase() !== ".cmd") continue;
+		const invocation = resolveNodeCommandShim(candidate, args, options);
+		if (invocation) return invocation;
+	}
+	return null;
+}
+function resolveNodeShebangInvocation(candidates, args, options) {
+	for (const candidate of candidates) {
+		if (!existsSync(candidate) || extname(candidate).toLowerCase() === ".cmd") continue;
+		const firstLine = readFileSync(candidate, "utf8").split(/\r?\n/, 1)[0]?.trim() ?? "";
+		if (!/^#!.*(?:\/|\s)node(?:\.exe)?(?:\s|$)/i.test(firstLine)) continue;
+		return {
+			command: findNodeExecutable(candidate, options),
+			args: [candidate, ...args]
+		};
+	}
+	return null;
+}
+/** Resolve one Windows command without projecting argv through cmd.exe. */
+function resolveWindowsCommandInvocation(command$1, args, options = {}) {
+	const candidates = commandCandidates(command$1, options);
+	const name = commandName(command$1);
+	const shellSensitive = requiresShellIndependentInvocation(args);
+	if (name === "pnpm" && shellSensitive) {
+		const corepack = findNativeExecutable(tryFindWindowsCommandCandidates("corepack", options));
+		if (corepack) return {
+			command: corepack,
+			args: ["pnpm", ...args]
+		};
+	}
+	if (name === "npm" && shellSensitive) {
+		const shimInvocation$1 = resolveCommandShim(candidates, args, options);
+		if (shimInvocation$1) return shimInvocation$1;
+	}
+	const executable = findNativeExecutable(candidates);
+	if (executable) return {
+		command: executable,
+		args: [...args]
+	};
+	const shimInvocation = resolveCommandShim(candidates, args, options);
+	if (shimInvocation) return shimInvocation;
+	const shebangInvocation = resolveNodeShebangInvocation(candidates, args, options);
+	if (shebangInvocation) return shebangInvocation;
+	const commandShim = candidates.find((candidate) => extname(candidate).toLowerCase() === ".cmd");
+	if (commandShim) throw new Error(`${commandShim} is an opaque Windows command shim; refusing to reinterpret argv through cmd.exe.`);
+	throw new Error(`${command$1} did not resolve to a native Windows executable or Node command shim.`);
+}
+/** Resolve one command using the caller's cwd and environment while preserving POSIX behavior. */
+function resolveCommandInvocation(command$1, args, options = {}) {
+	if (process$1.platform !== "win32") return {
+		command: command$1,
+		args: [...args]
+	};
+	return resolveWindowsCommandInvocation(command$1, args, options);
+}
+
 //#endregion
 //#region src/spawn-safe.ts
 function getSpawnErrorCode(err) {
@@ -2697,11 +2958,20 @@ function formatSpawnError(err) {
 		message: `${message}${code ? ` (${code})` : ""}`
 	};
 }
+/** Spawn without a shell after resolving one caller-environment native argv boundary. */
 function spawnSafe(command$1, args, options) {
 	try {
+		const invocation = resolveCommandInvocation(command$1, args, {
+			cwd: typeof options.cwd === "string" ? options.cwd : void 0,
+			env: options.env
+		});
 		return {
 			ok: true,
-			child: crossSpawn(command$1, [...args], options)
+			child: spawn(invocation.command, invocation.args, {
+				...options,
+				shell: false,
+				windowsHide: options.windowsHide ?? true
+			})
 		};
 	} catch (err) {
 		return {
@@ -2710,12 +2980,7 @@ function spawnSafe(command$1, args, options) {
 		};
 	}
 }
-function killChild(child, signal = "SIGTERM") {
-	try {
-		child.kill(signal);
-	} catch {}
-}
-const EAGER_JSON_EXIT_GRACE_MS = 25;
+const EAGER_JSON_EXIT_GRACE_MS = 100;
 const BUFFERED_FORCE_KILL_DELAY_MS = 1e3;
 function runBufferedCommand(options) {
 	return new Promise((resolve$1) => {
@@ -2769,11 +3034,17 @@ function runBufferedCommand(options) {
 		let timedOut = false;
 		let settled = false;
 		let eagerJsonTimer = null;
+		let eagerJsonImmediate = null;
 		let forceKillTimer = null;
-		const clearEagerJsonTimer = () => {
-			if (!eagerJsonTimer) return;
-			clearTimeout(eagerJsonTimer);
-			eagerJsonTimer = null;
+		const clearEagerJsonResolution = () => {
+			if (eagerJsonTimer) {
+				clearTimeout(eagerJsonTimer);
+				eagerJsonTimer = null;
+			}
+			if (eagerJsonImmediate) {
+				clearImmediate(eagerJsonImmediate);
+				eagerJsonImmediate = null;
+			}
 		};
 		const clearForceKillTimer = () => {
 			if (!forceKillTimer) return;
@@ -2785,11 +3056,11 @@ function runBufferedCommand(options) {
 				phases.terminationRequestedAt = performance.now();
 				observe("termination-requested", { reason });
 			}
-			killChild(child);
+			terminateChildProcessTree(child).catch(() => void 0);
 			if (forceKillTimer) return;
 			forceKillTimer = setTimeout(() => {
 				forceKillTimer = null;
-				if (!phases.exitAt && !phases.closeAt) killChild(child, "SIGKILL");
+				if (!phases.exitAt && !phases.closeAt) terminateChildProcessTree(child, "SIGKILL").catch(() => void 0);
 			}, BUFFERED_FORCE_KILL_DELAY_MS);
 		};
 		let clearTimer = () => {};
@@ -2811,7 +3082,7 @@ function runBufferedCommand(options) {
 			if (settled) return;
 			settled = true;
 			clearTimer();
-			clearEagerJsonTimer();
+			clearEagerJsonResolution();
 			if (reason !== "eager-json") clearForceKillTimer();
 			phases.resultResolvedAt = performance.now();
 			phases.resultReason = reason;
@@ -2835,14 +3106,18 @@ function runBufferedCommand(options) {
 				observe("json-complete-observed");
 				eagerJsonTimer = setTimeout(() => {
 					eagerJsonTimer = null;
-					if (settled || phases.exitAt) return;
-					phases.eagerResolved = true;
-					requestTermination("eager-json");
-					finish("eager-json", {
-						stdout,
-						stderr,
-						exitCode: 0,
-						timedOut
+					if (settled || phases.exitAt || child.exitCode !== null || stderr.length > 0) return;
+					eagerJsonImmediate = setImmediate(() => {
+						eagerJsonImmediate = null;
+						if (settled || phases.exitAt || child.exitCode !== null || stderr.length > 0) return;
+						phases.eagerResolved = true;
+						requestTermination("eager-json");
+						finish("eager-json", {
+							stdout,
+							stderr,
+							exitCode: 0,
+							timedOut
+						});
 					});
 				}, EAGER_JSON_EXIT_GRACE_MS);
 			} catch {}
@@ -2855,7 +3130,7 @@ function runBufferedCommand(options) {
 			stderr += data.toString();
 		});
 		child.on("exit", (exitCode, signal) => {
-			clearEagerJsonTimer();
+			clearEagerJsonResolution();
 			clearForceKillTimer();
 			if (!phases.exitAt) {
 				phases.exitAt = performance.now();
@@ -2902,7 +3177,10 @@ function runBufferedCommand(options) {
 * 4. Preserve reactive config reads and serialized config writes.
 * 5. Resolve Windows `where` candidates by PATHEXT so the executable shim is preferred over the
 *    extension-less script (issue #209 hotfix).
+* 6. Hide runner-probe subprocess console windows (`windowsHide`) so a console-less Windows daemon
+*    never flashes a cmd window while resolving or sniffing the CLI runner.
 *
+* Original request (2026-08-14): "在Windows平台上，执行命令总是会弹出cmd窗口，这个可否统一隐藏，你先调查一下原因"
 * Original request (2026-07-14): "openspec 1.6.0 已经放出，我们需要开始进行适配。"
 * Independent review correction (2026-07-20): Global CLI installation must retire cached and
 * in-flight runner authority.
@@ -3113,7 +3391,8 @@ async function resolveShellExecutablePath(command$1, cwd, env) {
 				cwd,
 				env,
 				encoding: "utf8",
-				timeout: 5e3
+				timeout: 5e3,
+				windowsHide: true
 			});
 			return pickWindowsExecutablePath(stdout$1.split(/\r?\n/), env.PATHEXT);
 		}
@@ -3284,7 +3563,8 @@ async function sniffGlobalCli() {
 	const [localResult, latestVersion] = await Promise.all([execFileAsync(resolvedCommand, ["--version"], {
 		env,
 		timeout: 1e4,
-		encoding: "utf8"
+		encoding: "utf8",
+		windowsHide: true
 	}).catch((err) => ({ error: err })), fetchLatestVersion()]);
 	if ("error" in localResult) {
 		const error = localResult.error instanceof Error ? localResult.error.message : String(localResult.error);
@@ -4461,14 +4741,17 @@ const ownersByChild = /* @__PURE__ */ new WeakMap();
 //#endregion
 //#region src/openspec-cli-worker.ts
 /**
-* Orthogonal intents (updated 2026-07-31 Asia/Shanghai):
+* Orthogonal intents (updated 2026-08-06 Asia/Shanghai):
 * 1. Resolve an installed OpenSpec package's importable CLI module from its configured runner and
 *    distinguish objective module absence from Worker startup/execution failure.
 * 2. Execute one buffered OpenSpec command inside an isolated Node Worker with project cwd semantics.
 * 3. Project Worker stdout, stderr, cancellation, and settlement through the buffered spawn contract.
+* 4. Treat observed Worker stderr as exit-owned evidence and settle it through the real Worker exit
+*    instead of eager JSON retirement.
 *
 * Original request (2026-07-31): "直接寻址到本地 openspec 背后的 js，直接用 worker_thread 来运行它。"
 * Original request (2026-07-31): "通过 OPENSPEC_SPAWN_MODE=process|worker 来进行区分两种模式。"
+* Original request (2026-08-06): "continue"
 */
 const OPENSPEC_SPAWN_MODE_ENV = "OPENSPEC_SPAWN_MODE";
 /** Objective signal that no importable OpenSpec CLI JavaScript module exists behind the runner. */
@@ -4597,6 +4880,18 @@ function runOpenSpecCliWorker(options) {
 		let completedExitCode = null;
 		let workerError;
 		let aborted = false;
+		let eagerJsonTimer = null;
+		let eagerJsonImmediate = null;
+		const clearEagerJsonResolution = () => {
+			if (eagerJsonTimer) {
+				clearTimeout(eagerJsonTimer);
+				eagerJsonTimer = null;
+			}
+			if (eagerJsonImmediate) {
+				clearImmediate(eagerJsonImmediate);
+				eagerJsonImmediate = null;
+			}
+		};
 		const observe = (phase, evidence = {}) => options.onPhase?.({
 			phase,
 			at: performance$1.now(),
@@ -4605,6 +4900,7 @@ function runOpenSpecCliWorker(options) {
 		const finish = (reason, exitCode) => {
 			if (settled) return;
 			settled = true;
+			clearEagerJsonResolution();
 			phases.resultResolvedAt = performance$1.now();
 			phases.resultReason = reason;
 			observe("result-resolved", { reason });
@@ -4680,12 +4976,21 @@ function runOpenSpecCliWorker(options) {
 					observe("first-stdout-observed");
 				}
 				stdout += data.toString();
-				if (options.eagerResolveJson && !phases.eagerResolved && stdout.trimStart().startsWith("{")) try {
+				if (options.eagerResolveJson && !phases.jsonCompleteAt && stdout.trimStart().startsWith("{")) try {
 					JSON.parse(stdout);
-					phases.eagerResolved = true;
 					phases.jsonCompleteAt = performance$1.now();
 					observe("json-complete-observed");
-					requestTermination("eager-json");
+					eagerJsonTimer = setTimeout(() => {
+						eagerJsonTimer = null;
+						if (settled || phases.exitAt || workerError || completedExitCode !== null || stderr.length > 0) return;
+						eagerJsonImmediate = setImmediate(() => {
+							eagerJsonImmediate = null;
+							if (settled || phases.exitAt || workerError || completedExitCode !== null || stderr.length > 0) return;
+							phases.eagerResolved = true;
+							requestTermination("eager-json");
+							finish("eager-json", 0);
+						});
+					}, EAGER_JSON_EXIT_GRACE_MS);
 				} catch {}
 			});
 			worker.stderr.on("data", (data) => {
@@ -4704,6 +5009,7 @@ function runOpenSpecCliWorker(options) {
 			});
 			worker.once("exit", (workerExitCode) => {
 				options.signal?.removeEventListener("abort", onAbort);
+				clearEagerJsonResolution();
 				phases.exitAt = performance$1.now();
 				const exitCode = aborted ? null : phases.eagerResolved ? 0 : completedExitCode ?? workerExitCode;
 				observe("exit-observed", { exitCode });
@@ -4724,10 +5030,10 @@ function runOpenSpecCliWorker(options) {
 //#endregion
 //#region src/cli-executor.ts
 /**
-* Orthogonal intents (updated 2026-08-02 Asia/Shanghai):
+* Orthogonal intents (updated 2026-08-08 Asia/Shanghai):
 * 1. Execute buffered CLI work through process/Worker backends with runner recovery,
 *    observer-explicit OTel phase evidence, bounded probes, and owner-scoped disposal.
-* 2. Own streaming CLI processes through cancellation request, escalation, and confirmed settlement.
+* 2. Own streaming CLI process trees through cancellation request, escalation, and confirmed settlement.
 * 3. Retain lifecycle helpers and add the fixed-path, tools-none project bootstrap stream.
 * 4. Expose the physically separated OpenSpec 1.6 typed command facade.
 * 5. Clear the Core-owned direct-child slot independently from stream settlement, and keep
@@ -4745,6 +5051,7 @@ function runOpenSpecCliWorker(options) {
 * Original request (2026-07-31): "在主线程，通过 OPENSPEC_SPAWN_MODE=process|worker 来进行区分两种模式。"
 * Original request (2026-08-02): initialize the Launch Project with `openspec init <path> --tools=none`.
 * Review correction (2026-08-02): streamed command evidence must preserve argv boundaries.
+* Original request (2026-08-04): "Make pnpm openspecui start and equivalent package scripts work on Windows."
 */
 /** Failure raised when even forced termination cannot confirm child-process close. */
 var CliStreamTerminationError = class extends Error {
@@ -5321,14 +5628,10 @@ var CliExecutor = class {
 		const requestChildTermination = (child) => {
 			if (terminationStarted || settled) return;
 			terminationStarted = true;
-			try {
-				child.kill("SIGTERM");
-			} catch {}
+			terminateChildProcessTree(child).catch(() => {});
 			terminationTimer = setTimeout(() => {
 				if (settled || !childOwner.owns(child)) return;
-				try {
-					child.kill("SIGKILL");
-				} catch {}
+				terminateChildProcessTree(child, "SIGKILL").catch(() => {});
 				forceCloseTimer = setTimeout(() => {
 					if (!settled && childOwner.owns(child)) failTermination();
 				}, STREAM_FORCE_CLOSE_TIMEOUT_MS);
@@ -8085,4 +8388,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { ACCESS_GATE_CREDENTIAL_BYTES, AI_TOOLS, ActiveRootMutationSchema, ActiveRootOfficialConfigSchema, ActiveRootRevisionSchema, ActiveRootStructuredUpdateSchema, AgentDeliveryModeSchema, AgentDeliveryPolicyUpdateSchema, AgentDeliveryProfileSchema, AgentDeliveryWorkflowSchema, ApplyInstructionsContextFilesSchema, ApplyInstructionsProjectionSchema, ApplyInstructionsSchema, ApplyTaskSchema, ArchiveInstructionsSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, BUILTIN_SOUND_IDS, BUILTIN_SOUND_OPTIONS, BUILTIN_TERMINAL_SPAWN_COMMANDS, BatchTranslateEventSchema, BatchTranslateInputSchema, BuiltinSoundIdSchema, CODE_EDITOR_THEME_VALUES, CUSTOM_SOUND_ADD_VALUE, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliApplyInstructionsSchema, CliArchiveInstructionsSchema, CliArchiveSchema, CliArtifactInstructionsSchema, CliChangeListSchema, CliContextSchema, CliDiagnosticFailureSchema, CliDiagnosticSchema, CliDoctorReferenceEntrySchema, CliDoctorSchema, CliExecutor, CliJsonValueSchema, CliProjectionCommandError, CliProjectionCommandEvidenceSchema, CliProjectionFailureSchema, CliProjectionInvalidationCauseSchema, CliProjectionNoticeSchema, CliProjectionStateNameSchema, CliReferenceIndexEntrySchema, CliRootSchema, CliRootSourceSchema, CliShowSpecDocumentSchema, CliShowSpecSchema, CliSpecListSchema, CliStoreCleanupSchema, CliStoreDoctorEntrySchema, CliStoreDoctorSchema, CliStoreListSchema, CliStoreMutationSchema, CliStoreSchema, CliStreamTerminationError, CliValidateSchema, CliWorkflowStatusSchema, CodeEditorThemeSchema, ConfigManager, CustomSoundHashSchema, CustomSoundIdSchema, CustomSoundMetadataFileSchema, CustomSoundMetadataSchema, DASHBOARD_METRIC_KEYS, DEFAULT_BELL_SOUND_ID, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_GLOBAL_SETTINGS, DEFAULT_NOTIFICATION_SOUND_ID, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT, DEFAULT_TRANSLATION_ENGINE_ID, DOCUMENT_TRANSLATION_DISPLAY_MODES, DashboardConfigSchema, DashboardGitSnapshotSchema, DashboardOverviewSchema, DashboardSummaryIdentitySchema, DashboardSummaryInvalidationCauseSchema, DashboardSummaryInvalidationSchema, DashboardSummaryProjectionSchema, DashboardSummaryProjectionStateSchema, DashboardTrendsProjectionSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, DocumentTranslationConfigSchema, DocumentTranslationConfigUpdateSchema, DocumentTranslationDisplayModeSchema, DocumentTranslationGlobalSettingsUpdateSchema, EnvironmentDefaultStoreUpdateSchema, EnvironmentGlobalConfigValueSchema, EnvironmentGlobalFileProjectionDataSchema, EnvironmentGlobalFileProjectionStateSchema, EnvironmentGlobalProjectionDataSchema, EnvironmentGlobalProjectionStateSchema, FILE_PREVIEW_KINDS, GitConfigSchema, GlobalSettingsManager, HOSTED_SHELL_PROTOCOL_VERSION, LEGACY_SOUND_ID_MAP, LOCAL_MODEL_PROFILE_DEFINITIONS, LocalModelAssetLogSchema, LocalModelAssetPlanSnapshotSchema, LocalModelAssetStateSchema, LocalModelDownloadStatusSchema, LocalModelLifecycleFileStateSchema, LocalModelLifecycleGroupStateSchema, LocalModelProfileLoadStateSchema, LocalModelProfileManifestFileSchema, LocalModelProfileManifestGroupSchema, LocalModelProfileManifestSchema, LocalModelProfileStatusSchema, MAX_ACTIVE_ROOT_CONTEXT_BYTES, MAX_TRANSLATION_CACHE_ENTRY_LIMIT, MIN_TRANSLATION_CACHE_ENTRY_LIMIT, ManagedLocalCatalogSourceSchema, MarkdownParser, MarkdownReadingPluginRegistry, NOTIFICATION_SOUND_OPTIONS, NOTIFICATION_SOUND_VALUES, NotificationActionSchema, NotificationGroupKeySchema, NotificationPublishInputSchema, NotificationRecordSchema, NotificationSettingsSchema, NotificationSoundSchema, NotificationSourceSchema, OFFICIAL_APP_BASE_URL, OPENSPECUI_DOCUMENT_HOOK_VERSION, OPENSPECUI_RUNTIME_CAPABILITIES, OPENSPECUI_WORKFLOW_HOOK_VERSION, OPENSPEC_SPAWN_MODE_ENV, OPEN_SPEC_DATA_DIRECTORY_NAME, OPEN_SPEC_DATA_HOME_OBSERVATION_TARGETS, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, OPSX_AGENT_INVOCATION_MODE_VALUES, OPSX_ALL_WORKFLOWS, OPSX_ARTIFACT_INPUT_ACTIONS, OPSX_CHANGE_INPUT_ACTIONS, OPSX_COMMAND_CAPABLE_WORKFLOWS, OPSX_CORE_PROFILE_WORKFLOWS, OPSX_TEXT_INPUT_ACTIONS, OPSX_WORKFLOW_LABELS, OPSX_WORKFLOW_TO_SKILL_DIR, OPSX_WORKFLOW_TO_SKILL_DIR as TOOL_WORKFLOW_TO_SKILL_DIR, OpenSpecAdapter, OpenSpecCliContractExecutor, OpenSpecDataHomeObserver, OpenSpecUIConfigSchema, OpenSpecUIGlobalSettingsSchema, OpenSpecUIGlobalSettingsUpdateSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxCliEvidenceSchema, OpsxConfigBundleSchema, OpsxConfigSchema, OpsxKernel, OpsxStatusEvidenceSchema, OwnedSpecIdentitySchema, PINNED_AGENT_GENERATOR_VERSION, PlanningCliProjectionDataSchema, PlanningCliProjectionSelectorSchema, PlanningCliProjectionStateSchema, PlanningConfigJsonValueSchema, PlanningConfigReferenceSchema, ProjectBindingUpdateSchema, ProjectWatcher, PtyAttachMessageSchema, PtyBellResponseSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyProcessTitleResponseSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, RUNTIME_INVALIDATION_FACETS, ReactiveContext, ReactiveObservationEnvironment, ReactiveState, ReferencedSpecIdentitySchema, RequirementSchema, RuntimeInvalidationIndex, RuntimeRootInvalidationRegistry, SERVE_PRESENTATION_MODES, SERVICE_TRANSLATION_ENGINE_IDS, SILENT_SOUND_ID, ScenarioStepKeywordSchema, ScenarioStepSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, ServePresentationModeSchema, ServiceTranslationEngineIdSchema, SoundConfigIdSchema, SoundIdSchema, SpecCatalogSchema, SpecCommandEvidenceSchema, SpecDocumentProjectionSchema, SpecIdentitySchema, SpecSchema, StoreDoctorResultSchema, StoreListResultSchema, StoreMutationLifecycleEventSchema, StoreMutationResultSchema, StoreMutationSchema, StoreMutationStartResponseSchema, TERMINAL_BELL_SOUND_OPTIONS, TERMINAL_BELL_SOUND_VALUES, TERMINAL_COMMAND_FIELD_TYPE_VALUES, TERMINAL_SHELL_QUOTE_STYLE_VALUES, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TRANSLATION_CACHE_POLICY_VERSION, TRANSLATION_ENGINE_IDS, TRANSLATION_ENGINE_MANIFESTS, TRANSLATOR_CONTRACT_VERSION, TaskSchema, TemplateContentMapSchema, TemplateContentSchema, TemplatesSchema, TerminalBellSoundSchema, TerminalCommandFieldSchema, TerminalConfigSchema, TerminalControlParser, TerminalCwdTargetSchema, TerminalInvocationSettingsSchema, TerminalNotificationParser, TerminalRendererEngineSchema, TerminalShellProfileSchema, TerminalShellQuoteStyleSchema, TerminalSpawnCommandSchema, TerminalThemeModeSchema, TerminalThemeSchema, TrackedTaskProgressSchema, TranslationCacheEntrySchema, TranslationCacheReadInputSchema, TranslationCacheSettingsSchema, TranslationCacheSettingsUpdateSchema, TranslationCacheStatsSchema, TranslationCacheWriteInputSchema, TranslationDownloadFilePlanSchema, TranslationDownloadGroupPlanSchema, TranslationEngineAssetStateSchema, TranslationEngineAssetStatusSchema, TranslationEngineDependencyStateSchema, TranslationEngineDependencyStatusSchema, TranslationEngineGlobalSettingsSchema, TranslationEngineGlobalSettingsUpdateSchema, TranslationEngineIdSchema, TranslationEngineInstallLogEventSchema, TranslationEngineInstallLogStreamSchema, TranslationEngineLifecycleEventSchema, TranslationEngineLifecycleStatusSchema, TranslationEngineProjectSettingsSchema, TranslationEngineProjectSettingsUpdateSchema, TranslationEngineRuntimeStateSchema, TranslationEngineRuntimeStatusSchema, TranslationLocalCt2SettingsSchema, TranslationLocalCt2SettingsUpdateSchema, TranslationLocalLlamaSettingsSchema, TranslationLocalLlamaSettingsUpdateSchema, TranslationLocalSettingsSchema, TranslationLocalSettingsUpdateSchema, TranslationOpenAISettingsSchema, TranslationOpenAISettingsUpdateSchema, VIRTUAL_PROJECT_DIRNAME, Validator, accessGateFingerprint, acquireWatcher, acquireWatcherRoot, annotateOpenSpecFacts, annotateOpenSpecMarkdown, applyAgentDeliveryPolicy, asEnvUri, buildBackendHealthPayload, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, buildLocalDownloadPlanFromRepositoryFiles, buildLocalDownloadPlanFromRuntimeProfileFiles, buildMarkdownParentMap, buildOpsxEntityDetail, buildRuntimePackageInstallCommand, buildSpecCatalog, builtinOpenSpecReadingPlugin, checkLocalDirectionalModelLanguagePair, classifyStoreCliResult, clearCache, cliProjectionStates, closeAllProjectWatchers, closeAllWatchers, compareAndWriteAtomicPhysicalReactiveFile, computeEnvUri, constantTimeEqual, contextStorage, createApplyInstructionProgress, createCleanCliEnv, createCliProjectionStateSchema, createDocumentChecklistSummary, createFileChangeObservable, createMarkdownReadingDocument, createMarkdownReadingDocumentFromFacts, createOpenSpecReadingPlugin, createPhysicalReactiveDirectory, createStaticSpecCatalogOwnedProjection, createStaticSpecCatalogReferenceProjection, createStaticSpecCatalogReferenceSource, createToolInitStateProjection, createTrackedTaskProgress, createTranslationEngineLifecycleStatus, customHashFromSoundId, deriveTrackedTaskPhase, detectRuntimePackageManager, generateAccessGateCredential, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getBuiltinSoundUrl, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDefaultGlobalSettingsPath, getDetectedProjectTools, getExternalCodexCommandObservationRoot, getManagedLocalTranslationEngineManifest, getMarkdownAnnotation, getMarkdownAnnotationsForFact, getMarkdownFactSpan, getMarkdownHeadingEnd, getMarkdownHeadingFacts, getNotificationGroupKey, getNotificationGroupLabel, getOpenSpecAnnotation, getOpenSpecAnnotationsForFact, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, getOpsxEntityMetadataPath, getOpsxEntityRootRelativePath, getProjectWatcher, getRootContextCliSelector, getSpecCatalogEntry, getTerminalCommandDefaultValues, getToolById, getToolInitStates, getTranslationEngineLifecycleMessage, getTranslationEngineManifest, getWatcherRuntimeStatus, groupNotifications, hasCapability, inferFileMime, inferFilePreviewKind, inferLocalDirectionalModelLanguagePair, inspectActiveRootOfficialConfig, inspectEnvironmentDefaultStore, inspectProjectBinding, isBackendHealthRuntimeMetadata, isBatchTranslationAbort, isDirectionalManagedLocalTranslationEngineId, isGlobPattern, isHostedBackendHealthResponse, isManagedLocalTranslationEngineId, isMarkdownTaskSourcePath, isOpsxCoreWorkflowSelection, isOpsxGlobPattern, isPreviewableFile, isReferencedSpecIdentity, isSupportedEmbeddedUiUrl, isTerminalMutationStatus, isTerminalRendererEngine, isTextLikeFile, isTextLikeMime, isToolConfigured, isTranslationEngineDependencyReady, isTranslationEngineRuntimeReady, isWatcherPoolInitialized, loadOpenSpecAgentCommandContents, mergeSpecCatalog, normalizeAccessGatePassword, normalizeAgentDeliveryPolicy, normalizeBatchTranslationError, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, normalizeLegacySoundId, normalizeOpsxEntityPath, openSpecAnnotationRules, opsxGlobToRegex, opsxPathMatchesPattern, parseCliCommand, parseCliCommandResult, parseMarkdownFacts, parseMarkdownTasks, parseOpenSpecMarkdownToSpec, parseOpsxEntityMetadata, parseOpsxSchemaDetail, patchActiveRootOfficialFields, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown, projectTaskProjectionsFromMarkdownFiles, quoteTerminalShellArg, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, redactSnapshotForPublication, removePhysicalReactivePath, renderTerminalCommandArgs, renderTerminalSpawnCommandLine, requireCanonicalOpenSpecEntityId, requireCanonicalOpenSpecSpecId, requireOpenSpecEntityRelativePath, resolveHostedAppBaseUrl, resolveOpenSpecDataScope, resolveOpenSpecSpawnMode, resolveRootContext, resolveRuntimePackageInstallStrategy, resolveTerminalShellDefaults, runControlledTranslationTask, runPhysicalReactivePathMutation, selectLocalDownloadGroup, shouldShowTranslationEngineInstallGate, snapshotHasAbsolutePath, sniffGlobalCli, sortMarkdownReadingPlugins, soundIdFromCustomHash, specDocumentDisplayPath, specIdentityFromRoute, specIdentityKey, specRoutePath, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, toCliProjectionCommandEvidence, toCliProjectionFailure, toCliProjectionNotice, toMarkdownFactKind, toOpsxDisplayPath, toPersistedGlobalSettings, toStoreFeatureResult, toggleMarkdownTask, trimMarkdownSlice, updateProjectBindingContent, updateReactiveFileCache, validateActiveRootRawYaml, writeAtomicPhysicalReactiveFile, writePhysicalReactiveFile };
+export { ACCESS_GATE_CREDENTIAL_BYTES, AI_TOOLS, ActiveRootMutationSchema, ActiveRootOfficialConfigSchema, ActiveRootRevisionSchema, ActiveRootStructuredUpdateSchema, AgentDeliveryModeSchema, AgentDeliveryPolicyUpdateSchema, AgentDeliveryProfileSchema, AgentDeliveryWorkflowSchema, ApplyInstructionsContextFilesSchema, ApplyInstructionsProjectionSchema, ApplyInstructionsSchema, ApplyTaskSchema, ArchiveInstructionsSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, BUILTIN_SOUND_IDS, BUILTIN_SOUND_OPTIONS, BUILTIN_TERMINAL_SPAWN_COMMANDS, BatchTranslateEventSchema, BatchTranslateInputSchema, BuiltinSoundIdSchema, CODE_EDITOR_THEME_VALUES, CUSTOM_SOUND_ADD_VALUE, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliApplyInstructionsSchema, CliArchiveInstructionsSchema, CliArchiveSchema, CliArtifactInstructionsSchema, CliChangeListSchema, CliContextSchema, CliDiagnosticFailureSchema, CliDiagnosticSchema, CliDoctorReferenceEntrySchema, CliDoctorSchema, CliExecutor, CliJsonValueSchema, CliProjectionCommandError, CliProjectionCommandEvidenceSchema, CliProjectionFailureSchema, CliProjectionInvalidationCauseSchema, CliProjectionNoticeSchema, CliProjectionStateNameSchema, CliReferenceIndexEntrySchema, CliRootSchema, CliRootSourceSchema, CliShowSpecDocumentSchema, CliShowSpecSchema, CliSpecListSchema, CliStoreCleanupSchema, CliStoreDoctorEntrySchema, CliStoreDoctorSchema, CliStoreListSchema, CliStoreMutationSchema, CliStoreSchema, CliStreamTerminationError, CliValidateSchema, CliWorkflowStatusSchema, CodeEditorThemeSchema, ConfigManager, CustomSoundHashSchema, CustomSoundIdSchema, CustomSoundMetadataFileSchema, CustomSoundMetadataSchema, DASHBOARD_METRIC_KEYS, DEFAULT_BELL_SOUND_ID, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_GLOBAL_SETTINGS, DEFAULT_NOTIFICATION_SOUND_ID, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, DEFAULT_TRANSLATION_CACHE_ENTRY_LIMIT, DEFAULT_TRANSLATION_ENGINE_ID, DOCUMENT_TRANSLATION_DISPLAY_MODES, DashboardConfigSchema, DashboardGitSnapshotSchema, DashboardOverviewSchema, DashboardSummaryIdentitySchema, DashboardSummaryInvalidationCauseSchema, DashboardSummaryInvalidationSchema, DashboardSummaryProjectionSchema, DashboardSummaryProjectionStateSchema, DashboardTrendsProjectionSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, DocumentTranslationConfigSchema, DocumentTranslationConfigUpdateSchema, DocumentTranslationDisplayModeSchema, DocumentTranslationGlobalSettingsUpdateSchema, EnvironmentDefaultStoreUpdateSchema, EnvironmentGlobalConfigValueSchema, EnvironmentGlobalFileProjectionDataSchema, EnvironmentGlobalFileProjectionStateSchema, EnvironmentGlobalProjectionDataSchema, EnvironmentGlobalProjectionStateSchema, FILE_PREVIEW_KINDS, GitConfigSchema, GlobalSettingsManager, HOSTED_SHELL_PROTOCOL_VERSION, LEGACY_SOUND_ID_MAP, LOCAL_MODEL_PROFILE_DEFINITIONS, LocalModelAssetLogSchema, LocalModelAssetPlanSnapshotSchema, LocalModelAssetStateSchema, LocalModelDownloadStatusSchema, LocalModelLifecycleFileStateSchema, LocalModelLifecycleGroupStateSchema, LocalModelProfileLoadStateSchema, LocalModelProfileManifestFileSchema, LocalModelProfileManifestGroupSchema, LocalModelProfileManifestSchema, LocalModelProfileStatusSchema, MAX_ACTIVE_ROOT_CONTEXT_BYTES, MAX_TRANSLATION_CACHE_ENTRY_LIMIT, MIN_TRANSLATION_CACHE_ENTRY_LIMIT, ManagedLocalCatalogSourceSchema, MarkdownParser, MarkdownReadingPluginRegistry, NOTIFICATION_SOUND_OPTIONS, NOTIFICATION_SOUND_VALUES, NotificationActionSchema, NotificationGroupKeySchema, NotificationPublishInputSchema, NotificationRecordSchema, NotificationSettingsSchema, NotificationSoundSchema, NotificationSourceSchema, OFFICIAL_APP_BASE_URL, OPENSPECUI_DOCUMENT_HOOK_VERSION, OPENSPECUI_RUNTIME_CAPABILITIES, OPENSPECUI_WORKFLOW_HOOK_VERSION, OPENSPEC_SPAWN_MODE_ENV, OPEN_SPEC_DATA_DIRECTORY_NAME, OPEN_SPEC_DATA_HOME_OBSERVATION_TARGETS, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, OPSX_AGENT_INVOCATION_MODE_VALUES, OPSX_ALL_WORKFLOWS, OPSX_ARTIFACT_INPUT_ACTIONS, OPSX_CHANGE_INPUT_ACTIONS, OPSX_COMMAND_CAPABLE_WORKFLOWS, OPSX_CORE_PROFILE_WORKFLOWS, OPSX_TEXT_INPUT_ACTIONS, OPSX_WORKFLOW_LABELS, OPSX_WORKFLOW_TO_SKILL_DIR, OPSX_WORKFLOW_TO_SKILL_DIR as TOOL_WORKFLOW_TO_SKILL_DIR, OpenSpecAdapter, OpenSpecCliContractExecutor, OpenSpecDataHomeObserver, OpenSpecUIConfigSchema, OpenSpecUIGlobalSettingsSchema, OpenSpecUIGlobalSettingsUpdateSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxCliEvidenceSchema, OpsxConfigBundleSchema, OpsxConfigSchema, OpsxKernel, OpsxStatusEvidenceSchema, OwnedSpecIdentitySchema, PINNED_AGENT_GENERATOR_VERSION, PlanningCliProjectionDataSchema, PlanningCliProjectionSelectorSchema, PlanningCliProjectionStateSchema, PlanningConfigJsonValueSchema, PlanningConfigReferenceSchema, ProjectBindingUpdateSchema, ProjectWatcher, PtyAttachMessageSchema, PtyBellResponseSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyProcessTitleResponseSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, RUNTIME_INVALIDATION_FACETS, ReactiveContext, ReactiveObservationEnvironment, ReactiveState, ReferencedSpecIdentitySchema, RequirementSchema, RuntimeInvalidationIndex, RuntimeRootInvalidationRegistry, SERVE_PRESENTATION_MODES, SERVICE_TRANSLATION_ENGINE_IDS, SILENT_SOUND_ID, ScenarioStepKeywordSchema, ScenarioStepSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, ServePresentationModeSchema, ServiceTranslationEngineIdSchema, SoundConfigIdSchema, SoundIdSchema, SpecCatalogSchema, SpecCommandEvidenceSchema, SpecDocumentProjectionSchema, SpecIdentitySchema, SpecSchema, StoreDoctorResultSchema, StoreListResultSchema, StoreMutationLifecycleEventSchema, StoreMutationResultSchema, StoreMutationSchema, StoreMutationStartResponseSchema, TERMINAL_BELL_SOUND_OPTIONS, TERMINAL_BELL_SOUND_VALUES, TERMINAL_COMMAND_FIELD_TYPE_VALUES, TERMINAL_SHELL_QUOTE_STYLE_VALUES, TERMINAL_THEME_MODE_VALUES, TERMINAL_THEME_VALUES, TRANSLATION_CACHE_POLICY_VERSION, TRANSLATION_ENGINE_IDS, TRANSLATION_ENGINE_MANIFESTS, TRANSLATOR_CONTRACT_VERSION, TaskSchema, TemplateContentMapSchema, TemplateContentSchema, TemplatesSchema, TerminalBellSoundSchema, TerminalCommandFieldSchema, TerminalConfigSchema, TerminalControlParser, TerminalCwdTargetSchema, TerminalInvocationSettingsSchema, TerminalNotificationParser, TerminalRendererEngineSchema, TerminalShellProfileSchema, TerminalShellQuoteStyleSchema, TerminalSpawnCommandSchema, TerminalThemeModeSchema, TerminalThemeSchema, TrackedTaskProgressSchema, TranslationCacheEntrySchema, TranslationCacheReadInputSchema, TranslationCacheSettingsSchema, TranslationCacheSettingsUpdateSchema, TranslationCacheStatsSchema, TranslationCacheWriteInputSchema, TranslationDownloadFilePlanSchema, TranslationDownloadGroupPlanSchema, TranslationEngineAssetStateSchema, TranslationEngineAssetStatusSchema, TranslationEngineDependencyStateSchema, TranslationEngineDependencyStatusSchema, TranslationEngineGlobalSettingsSchema, TranslationEngineGlobalSettingsUpdateSchema, TranslationEngineIdSchema, TranslationEngineInstallLogEventSchema, TranslationEngineInstallLogStreamSchema, TranslationEngineLifecycleEventSchema, TranslationEngineLifecycleStatusSchema, TranslationEngineProjectSettingsSchema, TranslationEngineProjectSettingsUpdateSchema, TranslationEngineRuntimeStateSchema, TranslationEngineRuntimeStatusSchema, TranslationLocalCt2SettingsSchema, TranslationLocalCt2SettingsUpdateSchema, TranslationLocalLlamaSettingsSchema, TranslationLocalLlamaSettingsUpdateSchema, TranslationLocalSettingsSchema, TranslationLocalSettingsUpdateSchema, TranslationOpenAISettingsSchema, TranslationOpenAISettingsUpdateSchema, VIRTUAL_PROJECT_DIRNAME, Validator, accessGateFingerprint, acquireWatcher, acquireWatcherRoot, annotateOpenSpecFacts, annotateOpenSpecMarkdown, applyAgentDeliveryPolicy, asEnvUri, buildBackendHealthPayload, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, buildLocalDownloadPlanFromRepositoryFiles, buildLocalDownloadPlanFromRuntimeProfileFiles, buildMarkdownParentMap, buildOpsxEntityDetail, buildRuntimePackageInstallCommand, buildSpecCatalog, builtinOpenSpecReadingPlugin, checkLocalDirectionalModelLanguagePair, classifyStoreCliResult, clearCache, cliProjectionStates, closeAllProjectWatchers, closeAllWatchers, compareAndWriteAtomicPhysicalReactiveFile, computeEnvUri, constantTimeEqual, contextStorage, createApplyInstructionProgress, createCleanCliEnv, createCliProjectionStateSchema, createDocumentChecklistSummary, createFileChangeObservable, createMarkdownReadingDocument, createMarkdownReadingDocumentFromFacts, createOpenSpecReadingPlugin, createPhysicalReactiveDirectory, createStaticSpecCatalogOwnedProjection, createStaticSpecCatalogReferenceProjection, createStaticSpecCatalogReferenceSource, createToolInitStateProjection, createTrackedTaskProgress, createTranslationEngineLifecycleStatus, customHashFromSoundId, deriveTrackedTaskPhase, detectRuntimePackageManager, generateAccessGateCredential, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getBuiltinSoundUrl, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDefaultGlobalSettingsPath, getDetectedProjectTools, getExternalCodexCommandObservationRoot, getManagedLocalTranslationEngineManifest, getMarkdownAnnotation, getMarkdownAnnotationsForFact, getMarkdownFactSpan, getMarkdownHeadingEnd, getMarkdownHeadingFacts, getNotificationGroupKey, getNotificationGroupLabel, getOpenSpecAnnotation, getOpenSpecAnnotationsForFact, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, getOpsxEntityMetadataPath, getOpsxEntityRootRelativePath, getProjectWatcher, getRootContextCliSelector, getSpecCatalogEntry, getTerminalCommandDefaultValues, getToolById, getToolInitStates, getTranslationEngineLifecycleMessage, getTranslationEngineManifest, getWatcherRuntimeStatus, groupNotifications, hasCapability, inferFileMime, inferFilePreviewKind, inferLocalDirectionalModelLanguagePair, inspectActiveRootOfficialConfig, inspectEnvironmentDefaultStore, inspectProjectBinding, isBackendHealthRuntimeMetadata, isBatchTranslationAbort, isDirectionalManagedLocalTranslationEngineId, isGlobPattern, isHostedBackendHealthResponse, isManagedLocalTranslationEngineId, isMarkdownTaskSourcePath, isOpsxCoreWorkflowSelection, isOpsxGlobPattern, isPreviewableFile, isReferencedSpecIdentity, isSupportedEmbeddedUiUrl, isTerminalMutationStatus, isTerminalRendererEngine, isTextLikeFile, isTextLikeMime, isToolConfigured, isTranslationEngineDependencyReady, isTranslationEngineRuntimeReady, isWatcherPoolInitialized, loadOpenSpecAgentCommandContents, mergeSpecCatalog, normalizeAccessGatePassword, normalizeAgentDeliveryPolicy, normalizeBatchTranslationError, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, normalizeLegacySoundId, normalizeOpsxEntityPath, openSpecAnnotationRules, opsxGlobToRegex, opsxPathMatchesPattern, parseCliCommand, parseCliCommandResult, parseMarkdownFacts, parseMarkdownTasks, parseOpenSpecMarkdownToSpec, parseOpsxEntityMetadata, parseOpsxSchemaDetail, patchActiveRootOfficialFields, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown, projectTaskProjectionsFromMarkdownFiles, quoteTerminalShellArg, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, redactSnapshotForPublication, removePhysicalReactivePath, renderTerminalCommandArgs, renderTerminalSpawnCommandLine, replaceFileAtomically, requireCanonicalOpenSpecEntityId, requireCanonicalOpenSpecSpecId, requireOpenSpecEntityRelativePath, resolveCommandInvocation, resolveHostedAppBaseUrl, resolveOpenSpecDataScope, resolveOpenSpecSpawnMode, resolveRootContext, resolveRuntimePackageInstallStrategy, resolveTerminalShellDefaults, resolveWindowsCommandInvocation, runControlledTranslationTask, runPhysicalReactivePathMutation, selectLocalDownloadGroup, shouldShowTranslationEngineInstallGate, snapshotHasAbsolutePath, sniffGlobalCli, sortMarkdownReadingPlugins, soundIdFromCustomHash, spawnSafe, specDocumentDisplayPath, specIdentityFromRoute, specIdentityKey, specRoutePath, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, terminateChildProcessTree, terminateWindowsProcessTreeByIdentity, toCliProjectionCommandEvidence, toCliProjectionFailure, toCliProjectionNotice, toMarkdownFactKind, toOpsxDisplayPath, toPersistedGlobalSettings, toStoreFeatureResult, toggleMarkdownTask, trimMarkdownSlice, updateProjectBindingContent, updateReactiveFileCache, validateActiveRootRawYaml, writeAtomicPhysicalReactiveFile, writePhysicalReactiveFile };