@openspecui/core 4.1.0 → 6.0.0-beta.0

package/dist/index.mjs

@@ -1,142 +1,60 @@
-import { a as normalizeOpsxEntityPath, c as parseOpsxEntityMetadata, i as isOpsxGlobPattern, n as getOpsxEntityMetadataPath, o as opsxGlobToRegex, r as getOpsxEntityRootRelativePath, s as opsxPathMatchesPattern, t as buildOpsxEntityDetail } from "./opsx-entity-c7m5CbgU.mjs";
-import { t as parseOpsxSchemaDetail } from "./opsx-schema-detail-BH82X6aU.mjs";
-import { n as toMarkdownFactKind, t as parseMarkdownFacts } from "./markdown-facts-BBCTe_qq.mjs";
-import { a as getMarkdownAnnotation, c as getMarkdownHeadingEnd, d as trimMarkdownSlice, i as createMarkdownReadingDocumentFromFacts, l as getMarkdownHeadingFacts, n as buildMarkdownParentMap, o as getMarkdownAnnotationsForFact, r as createMarkdownReadingDocument, s as getMarkdownFactSpan, t as MarkdownReadingPluginRegistry, u as sortMarkdownReadingPlugins } from "./markdown-reading-DdcB7run.mjs";
-import { a as getOpenSpecAnnotationsForFact, i as getOpenSpecAnnotation, n as annotateOpenSpecMarkdown, o as openSpecAnnotationRules, r as builtinOpenSpecReadingPlugin, t as annotateOpenSpecFacts } from "./openspec-annotations-D_6Pz7k4.mjs";
-import { a as getOpenSpecReadingSections, c as projectOpenSpecMarkdown, i as getOpenSpecProjectionAnnotation, n as OPEN_SPEC_SPEC_PROJECTION_ID, o as parseOpenSpecMarkdownToSpec, r as createOpenSpecReadingPlugin, s as projectAnnotatedOpenSpecToSpec, t as OPEN_SPEC_READING_SECTIONS_PROJECTION_ID } from "./openspec-projection-B8s-KWQ7.mjs";
-import { i as projectTasksFromMarkdownFiles, n as isMarkdownTaskSourcePath, r as parseMarkdownTasks, t as computeTaskProgress } from "./task-progress-DhHYHnTv.mjs";
-import { $ as shouldShowTranslationEngineInstallGate, A as TranslationEngineIdSchema, B as TranslationLocalLlamaSettingsUpdateSchema, C as TranslationDownloadGroupPlanSchema, D as TranslationEngineDependencyStatusSchema, E as TranslationEngineDependencyStateSchema, F as TranslationEngineRuntimeStateSchema, G as createTranslationEngineLifecycleStatus, H as TranslationLocalSettingsUpdateSchema, I as TranslationEngineRuntimeStatusSchema, J as getTranslationEngineManifest, K as getManagedLocalTranslationEngineManifest, L as TranslationLocalCt2SettingsSchema, M as TranslationEngineInstallLogStreamSchema, N as TranslationEngineLifecycleEventSchema, O as TranslationEngineGlobalSettingsSchema, P as TranslationEngineLifecycleStatusSchema, Q as isTranslationEngineRuntimeReady, R as TranslationLocalCt2SettingsUpdateSchema, S as TranslationDownloadFilePlanSchema, T as TranslationEngineAssetStatusSchema, U as TranslationOpenAISettingsSchema, V as TranslationLocalSettingsSchema, W as TranslationOpenAISettingsUpdateSchema, X as isManagedLocalTranslationEngineId, Y as isDirectionalManagedLocalTranslationEngineId, Z as isTranslationEngineDependencyReady, _ as SERVICE_TRANSLATION_ENGINE_IDS, a as LocalModelAssetLogSchema, b as TRANSLATION_ENGINE_MANIFESTS, c as LocalModelDownloadStatusSchema, d as LocalModelProfileLoadStateSchema, et as isBatchTranslationAbort, f as LocalModelProfileManifestFileSchema, g as ManagedLocalCatalogSourceSchema, h as LocalModelProfileStatusSchema, i as DEFAULT_TRANSLATION_ENGINE_ID, j as TranslationEngineInstallLogEventSchema, k as TranslationEngineGlobalSettingsUpdateSchema, l as LocalModelLifecycleFileStateSchema, m as LocalModelProfileManifestSchema, n as BatchTranslateInputSchema, nt as runControlledTranslationTask, o as LocalModelAssetPlanSnapshotSchema, p as LocalModelProfileManifestGroupSchema, q as getTranslationEngineLifecycleMessage, s as LocalModelAssetStateSchema, t as BatchTranslateEventSchema, tt as normalizeBatchTranslationError, u as LocalModelLifecycleGroupStateSchema, v as ServiceTranslationEngineIdSchema, w as TranslationEngineAssetStateSchema, x as TRANSLATOR_CONTRACT_VERSION, y as TRANSLATION_ENGINE_IDS, z as TranslationLocalLlamaSettingsSchema } from "./translator-DbUT1Ayn.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-D4YK18I3.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-CB3ubSnj.mjs";
-import { n as terminalNotificationEventToPublishInput, t as TerminalControlParser } from "./terminal-control-VpTuh17B.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-AKAcmeKT.mjs";
-import { n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSoundSchema, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-TBoU2jSK.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-cevliJw2.mjs";
-import { i as selectLocalDownloadGroup, n as buildLocalDownloadPlanFromRepositoryFiles, r as buildLocalDownloadPlanFromRuntimeProfileFiles, t as LOCAL_MODEL_PROFILE_DEFINITIONS } from "./local-download-profiles-kpNEcdF_.mjs";
-import { n as inferLocalDirectionalModelLanguagePair, t as checkLocalDirectionalModelLanguagePair } from "./translation-language-pair-DZ_WNp_M.mjs";
-import { a as buildEmbeddedUiLaunchUrl, c as isHostedBackendHealthResponse, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as buildBackendHealthPayload, l as isSupportedEmbeddedUiUrl, n as OFFICIAL_APP_BASE_URL, o as buildHostedLaunchUrl, r as OPENSPECUI_RUNTIME_CAPABILITIES, s as isBackendHealthRuntimeMetadata, t as HOSTED_SHELL_PROTOCOL_VERSION, u as normalizeEmbeddedUiUrl } from "./hosted-app-CzMRiEgY.mjs";
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-CUCOrHcM.mjs";
-import { i as toStoreFeatureResult, n as StoreListResultSchema, r as classifyStoreCliOutput, t as StoreDoctorResultSchema } from "./store-types-Cu41QSww.mjs";
-import { a as TerminalInvocationSettingsSchema, c as TerminalSpawnCommandSchema, f as quoteTerminalShellArg, g as resolveTerminalShellDefaults, h as renderTerminalSpawnCommandLine, i as TerminalCommandFieldSchema, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, o as TerminalShellProfileSchema, p as renderTerminalCommandArgs, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalShellQuoteStyleSchema, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, u as getTerminalCommandDefaultValues } from "./terminal-invocation-C2MCNBhK.mjs";
-import { mkdir, readFile, rename, writeFile } from "fs/promises";
+import { _ as isTextLikeMime, a as DeltaSpecSchema, c as ScenarioStepSchema, d as TrackedTaskProgressSchema, f as FILE_PREVIEW_KINDS, g as isTextLikeFile, h as isPreviewableFile, i as DeltaSchema, l as SpecSchema, m as inferFilePreviewKind, n as ChangeSchema, o as RequirementSchema, p as inferFileMime, r as DeltaOperationType, s as ScenarioStepKeywordSchema, t as ChangeFileSchema, u as TaskSchema } from "./schemas-BFroDdOC.mjs";
+import { a as normalizeOpsxEntityPath, c as parseOpsxEntityMetadata, i as isOpsxGlobPattern, n as getOpsxEntityMetadataPath, o as opsxGlobToRegex, r as getOpsxEntityRootRelativePath, s as opsxPathMatchesPattern, t as buildOpsxEntityDetail } from "./opsx-entity-Cn_Zu1J3.mjs";
+import { t as parseOpsxSchemaDetail } from "./opsx-schema-detail-Beis4Ba2.mjs";
+import { n as toMarkdownFactKind, t as parseMarkdownFacts } from "./markdown-facts-BUqLvFRf.mjs";
+import { a as getMarkdownAnnotation, c as getMarkdownHeadingEnd, d as trimMarkdownSlice, i as createMarkdownReadingDocumentFromFacts, l as getMarkdownHeadingFacts, n as buildMarkdownParentMap, o as getMarkdownAnnotationsForFact, r as createMarkdownReadingDocument, s as getMarkdownFactSpan, t as MarkdownReadingPluginRegistry, u as sortMarkdownReadingPlugins } from "./markdown-reading-mG4OAbDO.mjs";
+import { a as getOpenSpecAnnotationsForFact, i as getOpenSpecAnnotation, n as annotateOpenSpecMarkdown, o as openSpecAnnotationRules, r as builtinOpenSpecReadingPlugin, t as annotateOpenSpecFacts } from "./openspec-annotations-DCfqBMal.mjs";
+import { a as getOpenSpecReadingSections, c as projectOpenSpecMarkdown, i as getOpenSpecProjectionAnnotation, n as OPEN_SPEC_SPEC_PROJECTION_ID, o as parseOpenSpecMarkdownToSpec, r as createOpenSpecReadingPlugin, s as projectAnnotatedOpenSpecToSpec, t as OPEN_SPEC_READING_SECTIONS_PROJECTION_ID } from "./openspec-projection-DCgToo0Q.mjs";
+import { a as isMarkdownTaskSourcePath, c as toggleMarkdownTask, i as deriveTrackedTaskPhase, n as createDocumentChecklistSummary, o as parseMarkdownTasks, r as createTrackedTaskProgress, s as projectTaskProjectionsFromMarkdownFiles, t as createApplyInstructionProgress } from "./task-progress-B_IWVXjA.mjs";
+import { a as CliRootSchema, i as CliReferenceIndexEntrySchema, n as CliDiagnosticSchema, o as CliRootSourceSchema, r as CliDoctorReferenceEntrySchema, t as CliDiagnosticFailureSchema } from "./common-D8YUK9dA.mjs";
+import { A as CliSchemasSchema, B as CliStoreCleanupSchema, C as CliArtifactInstructionsSuccessSchema, F as CliValidateSchema, G as CliStoreSchema, H as CliStoreDoctorSchema, I as CliWorkflowStatusSchema, K as parseCliCommandResult, L as CliWorkflowStatusSuccessSchema, M as CliShowSpecSchema, N as CliSpecListSchema, R as CliContextSchema, S as CliArtifactInstructionsSchema, T as CliChangeListSchema, U as CliStoreListSchema, V as CliStoreDoctorEntrySchema, W as CliStoreMutationSchema, _ as OpenSpecCliContractExecutor, a as SpecDocumentProjectionSchema, b as CliApplyInstructionsSuccessSchema, c as createStaticSpecCatalogOwnedProjection, d as getSpecCatalogEntry, f as isReferencedSpecIdentity, g as specRoutePath, h as specIdentityKey, i as SpecCommandEvidenceSchema, j as CliShowSpecDocumentSchema, l as createStaticSpecCatalogReferenceProjection, m as specIdentityFromRoute, n as ReferencedSpecIdentitySchema, o as SpecIdentitySchema, p as mergeSpecCatalog, r as SpecCatalogSchema, s as buildSpecCatalog, t as OwnedSpecIdentitySchema, u as createStaticSpecCatalogReferenceSource, x as CliArchiveSchema, y as CliApplyInstructionsSchema, z as CliDoctorSchema } from "./spec-catalog-ZGuiZ4CE.mjs";
+import { a as CliProjectionInvalidationCauseSchema, d as toCliProjectionCommandEvidence, f as toCliProjectionFailure, i as CliProjectionFailureSchema, l as cliProjectionStates, n as CliProjectionCommandError, o as CliProjectionNoticeSchema, p as toCliProjectionNotice, r as CliProjectionCommandEvidenceSchema, s as CliProjectionStateNameSchema, t as CliJsonValueSchema, u as createCliProjectionStateSchema } from "./cli-projection-vO3-FJg5.mjs";
+import { $ as shouldShowTranslationEngineInstallGate, A as TranslationEngineIdSchema, B as TranslationLocalLlamaSettingsUpdateSchema, C as TranslationDownloadGroupPlanSchema, D as TranslationEngineDependencyStatusSchema, E as TranslationEngineDependencyStateSchema, F as TranslationEngineRuntimeStateSchema, G as createTranslationEngineLifecycleStatus, H as TranslationLocalSettingsUpdateSchema, I as TranslationEngineRuntimeStatusSchema, J as getTranslationEngineManifest, K as getManagedLocalTranslationEngineManifest, L as TranslationLocalCt2SettingsSchema, M as TranslationEngineInstallLogStreamSchema, N as TranslationEngineLifecycleEventSchema, O as TranslationEngineGlobalSettingsSchema, P as TranslationEngineLifecycleStatusSchema, Q as isTranslationEngineRuntimeReady, R as TranslationLocalCt2SettingsUpdateSchema, S as TranslationDownloadFilePlanSchema, T as TranslationEngineAssetStatusSchema, U as TranslationOpenAISettingsSchema, V as TranslationLocalSettingsSchema, W as TranslationOpenAISettingsUpdateSchema, X as isManagedLocalTranslationEngineId, Y as isDirectionalManagedLocalTranslationEngineId, Z as isTranslationEngineDependencyReady, _ as SERVICE_TRANSLATION_ENGINE_IDS, a as LocalModelAssetLogSchema, b as TRANSLATION_ENGINE_MANIFESTS, c as LocalModelDownloadStatusSchema, d as LocalModelProfileLoadStateSchema, et as isBatchTranslationAbort, f as LocalModelProfileManifestFileSchema, g as ManagedLocalCatalogSourceSchema, h as LocalModelProfileStatusSchema, i as DEFAULT_TRANSLATION_ENGINE_ID, j as TranslationEngineInstallLogEventSchema, k as TranslationEngineGlobalSettingsUpdateSchema, l as LocalModelLifecycleFileStateSchema, m as LocalModelProfileManifestSchema, n as BatchTranslateInputSchema, nt as runControlledTranslationTask, o as LocalModelAssetPlanSnapshotSchema, p as LocalModelProfileManifestGroupSchema, q as getTranslationEngineLifecycleMessage, s as LocalModelAssetStateSchema, t as BatchTranslateEventSchema, tt as normalizeBatchTranslationError, u as LocalModelLifecycleGroupStateSchema, v as ServiceTranslationEngineIdSchema, w as TranslationEngineAssetStateSchema, x as TRANSLATOR_CONTRACT_VERSION, y as TRANSLATION_ENGINE_IDS, z as TranslationLocalLlamaSettingsSchema } from "./translator-Cjtv4tya.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-CeJFGMoy.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-NXwveBqq.mjs";
+import { n as terminalNotificationEventToPublishInput, t as TerminalControlParser } from "./terminal-control-BSAlOTs8.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-C2bxAzX_.mjs";
+import { n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSoundSchema, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-d6KItUeJ.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-B8iRttTR.mjs";
+import { i as selectLocalDownloadGroup, n as buildLocalDownloadPlanFromRepositoryFiles, r as buildLocalDownloadPlanFromRuntimeProfileFiles, t as LOCAL_MODEL_PROFILE_DEFINITIONS } from "./local-download-profiles-odzOdf96.mjs";
+import { n as inferLocalDirectionalModelLanguagePair, t as checkLocalDirectionalModelLanguagePair } from "./translation-language-pair-Bbhk-LAC.mjs";
+import { C as TemplateContentMapSchema, E as isGlobPattern, S as SchemaResolutionSchema, T as TemplatesSchema, _ as OpsxConfigBundleSchema, a as PlanningCliProjectionDataSchema, b as SchemaDetailSchema, c as ApplyInstructionsContextFilesSchema, d as ApplyTaskSchema, f as ArtifactInstructionsSchema, g as OpsxCliEvidenceSchema, h as DependencyInfoSchema, i as EnvironmentGlobalProjectionStateSchema, l as ApplyInstructionsProjectionSchema, m as ChangeStatusSchema, n as EnvironmentGlobalFileProjectionStateSchema, o as PlanningCliProjectionSelectorSchema, p as ArtifactStatusSchema, r as EnvironmentGlobalProjectionDataSchema, s as PlanningCliProjectionStateSchema, t as EnvironmentGlobalFileProjectionDataSchema, u as ApplyInstructionsSchema, v as OpsxStatusEvidenceSchema, w as TemplateContentSchema, x as SchemaInfoSchema, y as SchemaArtifactSchema } from "./planning-cli-projection-DIRxeq2H.mjs";
+import { a as OPSX_CORE_PROFILE_WORKFLOWS, c as OPSX_WORKFLOW_TO_SKILL_DIR, i as OPSX_COMMAND_CAPABLE_WORKFLOWS, l as isOpsxCoreWorkflowSelection, n as OPSX_ARTIFACT_INPUT_ACTIONS, o as OPSX_TEXT_INPUT_ACTIONS, r as OPSX_CHANGE_INPUT_ACTIONS, s as OPSX_WORKFLOW_LABELS, t as OPSX_ALL_WORKFLOWS } from "./opsx-workflows-Ccc6U7IR.mjs";
+import { a as DASHBOARD_METRIC_KEYS, c as DashboardSummaryProjectionSchema, i as DashboardSummaryProjectionStateSchema, l as DashboardTrendsProjectionSchema, n as DashboardSummaryInvalidationCauseSchema, o as DashboardGitSnapshotSchema, r as DashboardSummaryInvalidationSchema, s as DashboardOverviewSchema, t as DashboardSummaryIdentitySchema } from "./dashboard-summary-transport-D2VBAIxg.mjs";
+import { i as StoreMutationStartResponseSchema, n as StoreMutationResultSchema, r as StoreMutationSchema, t as StoreMutationLifecycleEventSchema } from "./store-mutation-protocol-CSwD-xPO.mjs";
+import { a as StoreListResultSchema, n as StoreDoctorResultSchema, o as classifyStoreCliResult, s as toStoreFeatureResult } from "./store-types-DlX1REBg.mjs";
+import { S as isTerminalMutationStatus, b as asEnvUri, t as HOSTED_SHELL_PROTOCOL_VERSION, v as OPENSPECUI_RUNTIME_CAPABILITIES, x as hasCapability } from "./hosted-contract-CcRnb51e.mjs";
+import { a as buildHostedLaunchUrl, c as isSupportedEmbeddedUiUrl, d as resolveHostedAppBaseUrl, i as buildEmbeddedUiLaunchUrl, l as normalizeEmbeddedUiUrl, n as OFFICIAL_APP_BASE_URL, o as isBackendHealthRuntimeMetadata, r as buildBackendHealthPayload, s as isHostedBackendHealthResponse, u as normalizeHostedAppBaseUrl } from "./hosted-app-BPU4OR41.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-D13XV20v.mjs";
+import { a as TerminalInvocationSettingsSchema, c as TerminalSpawnCommandSchema, f as quoteTerminalShellArg, g as resolveTerminalShellDefaults, h as renderTerminalSpawnCommandLine, i as TerminalCommandFieldSchema, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, o as TerminalShellProfileSchema, p as renderTerminalCommandArgs, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalShellQuoteStyleSchema, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, u as getTerminalCommandDefaultValues } from "./terminal-invocation-0p-j2eSP.mjs";
+import { mkdir, writeFile } from "fs/promises";
 import { dirname, join } from "path";
-import { AsyncLocalStorage } from "node:async_hooks";
-import { mkdir as mkdir$1, readFile as readFile$1, readdir, stat, writeFile as writeFile$1 } from "node:fs/promises";
-import { basename, dirname as dirname$1, join as join$1, matchesGlob, relative, resolve, sep } from "node:path";
+import { isMap, parseDocument } from "yaml";
+import { lstat, mkdir as mkdir$1, readFile, readdir, realpath, 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 { existsSync, lstatSync, readFileSync, realpathSync } from "node:fs";
+import { AsyncLocalStorage } from "node:async_hooks";
 import { z } from "zod";
 import { EventEmitter } from "events";
 import { watch } from "fs";
 import { exec, execFile, spawn } from "child_process";
 import { promisify } from "util";
-import { homedir } from "node:os";
+import { homedir, platform } from "node:os";
+import { createHash, randomBytes } from "node:crypto";
 
-//#region src/file-preview.ts
-const MIME_BY_EXTENSION = new Map([
-	[".md", "text/markdown"],
-	[".markdown", "text/markdown"],
-	[".mdown", "text/markdown"],
-	[".mkd", "text/markdown"],
-	[".txt", "text/plain"],
-	[".log", "text/plain"],
-	[".yaml", "application/yaml"],
-	[".yml", "application/yaml"],
-	[".json", "application/json"],
-	[".jsonc", "application/json"],
-	[".toml", "application/toml"],
-	[".ini", "text/plain"],
-	[".cfg", "text/plain"],
-	[".conf", "text/plain"],
-	[".html", "text/html"],
-	[".htm", "text/html"],
-	[".svg", "image/svg+xml"],
-	[".png", "image/png"],
-	[".jpg", "image/jpeg"],
-	[".jpeg", "image/jpeg"],
-	[".gif", "image/gif"],
-	[".webp", "image/webp"],
-	[".avif", "image/avif"],
-	[".bmp", "image/bmp"],
-	[".mp3", "audio/mpeg"],
-	[".wav", "audio/wav"],
-	[".ogg", "audio/ogg"],
-	[".oga", "audio/ogg"],
-	[".m4a", "audio/mp4"],
-	[".aac", "audio/aac"],
-	[".flac", "audio/flac"],
-	[".mp4", "video/mp4"],
-	[".m4v", "video/mp4"],
-	[".webm", "video/webm"],
-	[".mov", "video/quicktime"],
-	[".mkv", "video/x-matroska"],
-	[".ogv", "video/ogg"],
-	[".pdf", "application/pdf"],
-	[".js", "text/javascript"],
-	[".jsx", "text/javascript"],
-	[".ts", "text/typescript"],
-	[".tsx", "text/typescript"],
-	[".css", "text/css"],
-	[".sh", "text/plain"],
-	[".py", "text/plain"],
-	[".rs", "text/plain"],
-	[".go", "text/plain"],
-	[".java", "text/plain"],
-	[".c", "text/plain"],
-	[".cc", "text/plain"],
-	[".cpp", "text/plain"],
-	[".h", "text/plain"],
-	[".hpp", "text/plain"]
-]);
-const TEXT_MIME_PREFIXES = ["text/"];
-const TEXT_MIME_VALUES = new Set([
-	"application/json",
-	"application/yaml",
-	"application/toml",
-	"application/xml",
-	"image/svg+xml"
-]);
-const FILE_PREVIEW_KINDS = [
-	"markdown",
-	"html",
-	"image",
-	"audio",
-	"video",
-	"pdf",
-	"text",
-	"none"
-];
-function getExtension(path) {
-	const normalized = path.replace(/\\/g, "/");
-	const name = normalized.split("/").pop() ?? normalized;
-	const dotIndex = name.lastIndexOf(".");
-	if (dotIndex < 0) return "";
-	return name.slice(dotIndex).toLowerCase();
-}
-function inferFileMime(path) {
-	return MIME_BY_EXTENSION.get(getExtension(path)) ?? null;
-}
-function inferFilePreviewKind(path, mime) {
-	const resolvedMime = mime ?? inferFileMime(path);
-	if (!resolvedMime) return "none";
-	if (resolvedMime === "text/markdown") return "markdown";
-	if (resolvedMime === "text/html") return "html";
-	if (resolvedMime.startsWith("image/")) return resolvedMime === "image/svg+xml" ? "text" : "image";
-	if (resolvedMime.startsWith("audio/")) return "audio";
-	if (resolvedMime.startsWith("video/")) return "video";
-	if (resolvedMime === "application/pdf") return "pdf";
-	if (isTextLikeMime(resolvedMime)) return "text";
-	return "none";
-}
-function isTextLikeMime(mime) {
-	if (!mime) return false;
-	if (TEXT_MIME_VALUES.has(mime)) return true;
-	return TEXT_MIME_PREFIXES.some((prefix) => mime.startsWith(prefix));
-}
-function isTextLikeFile(path, mime) {
-	return isTextLikeMime(mime ?? inferFileMime(path));
-}
-function isPreviewableFile(path, mime) {
-	return inferFilePreviewKind(path, mime) !== "none";
+//#region src/entity-id.ts
+/** Return one path-safe OpenSpec entity id or reject it before filesystem access. */
+function requireCanonicalOpenSpecEntityId(value, field) {
+	if (value.length === 0 || value !== value.trim() || value === "." || value === ".." || value.includes("/") || value.includes("\\") || value.includes("\0")) throw new Error(`Invalid ${field}: expected one canonical path segment.`);
+	return value;
+}
+/** Return one normalized entity-relative path or glob without parent traversal. */
+function requireOpenSpecEntityRelativePath(value, field) {
+	const normalizedSeparators = value.replace(/\\/g, "/");
+	if (normalizedSeparators.length === 0 || normalizedSeparators.includes("\0") || normalizedSeparators.startsWith("/") || /^[A-Za-z]:/.test(normalizedSeparators) || normalizedSeparators.split("/").includes("..")) throw new Error(`Invalid ${field}: expected an entity-relative path.`);
+	const normalizedPath = normalizedSeparators.split("/").filter((segment) => segment.length > 0 && segment !== ".").join("/");
+	if (!normalizedPath) throw new Error(`Invalid ${field}: expected an entity-relative path.`);
+	return normalizedPath;
 }
 
 //#endregion
@@ -206,7 +124,11 @@ var MarkdownParser = class {
 				});
 			}
 		}
-		const tasks = this.parseTasks(tasksContent);
+		const taskProjections = projectTaskProjectionsFromMarkdownFiles(tasksContent.length > 0 ? [{
+			path: "tasks.md",
+			type: "file",
+			content: tasksContent
+		}] : []);
 		const deltasFromDeltaSpecs = this.parseDeltasFromDeltaSpecs(options?.deltaSpecs);
 		const deltasFromWhatChanges = this.parseDeltasFromWhatChanges(whatChanges);
 		const combinedDeltas = deltasFromDeltaSpecs.length > 0 ? deltasFromDeltaSpecs : deltas;
@@ -217,11 +139,8 @@ var MarkdownParser = class {
 			why: why.trim(),
 			whatChanges: whatChanges.trim(),
 			deltas: finalDeltas,
-			tasks,
-			progress: {
-				total: tasks.length,
-				completed: tasks.filter((t) => t.completed).length
-			},
+			trackedTaskProgress: taskProjections.trackedTaskProgress,
+			documentChecklistSummary: taskProjections.documentChecklistSummary,
 			design: options?.design,
 			deltaSpecs: options?.deltaSpecs
 		};
@@ -381,171 +300,6 @@ var MarkdownParser = class {
 	}
 };
 
-//#endregion
-//#region src/reactive-fs/reactive-state.ts
-/**
-* 全局的 AsyncLocalStorage，用于在异步调用链中传递 ReactiveContext
-* 这是实现依赖收集的核心机制
-*/
-const contextStorage = new AsyncLocalStorage();
-/**
-* 响应式状态类，类似 Signal.State
-*
-* 核心机制：
-* - get() 时自动注册到当前 ReactiveContext 的依赖列表
-* - set() 时如果值变化，通知所有依赖的 Context
-*/
-var ReactiveState = class {
-	currentValue;
-	equals;
-	/** 所有依赖此状态的 Context */
-	subscribers = /* @__PURE__ */ new Set();
-	constructor(initialValue, options) {
-		this.currentValue = initialValue;
-		this.equals = options?.equals ?? ((a, b) => a === b);
-	}
-	/**
-	* 获取当前值
-	* 如果在 ReactiveContext 中调用，会自动注册依赖
-	*/
-	get() {
-		const context = contextStorage.getStore();
-		if (context) {
-			context.track(this);
-			this.subscribers.add(context);
-		}
-		return this.currentValue;
-	}
-	/**
-	* 设置新值
-	* 如果值变化，通知所有订阅者
-	* @returns 是否发生了变化
-	*/
-	set(newValue) {
-		if (this.equals(this.currentValue, newValue)) return false;
-		this.currentValue = newValue;
-		for (const context of this.subscribers) context.notifyChange();
-		return true;
-	}
-	/**
-	* 取消订阅
-	* 当 Context 销毁时调用
-	*/
-	unsubscribe(context) {
-		this.subscribers.delete(context);
-	}
-	/**
-	* 获取当前订阅者数量（用于调试）
-	*/
-	get subscriberCount() {
-		return this.subscribers.size;
-	}
-};
-
-//#endregion
-//#region src/reactive-fs/reactive-context.ts
-function createPromiseWithResolvers() {
-	let resolve$1;
-	let reject;
-	return {
-		promise: new Promise((res, rej) => {
-			resolve$1 = res;
-			reject = rej;
-		}),
-		resolve: resolve$1,
-		reject
-	};
-}
-/**
-* 响应式上下文，管理依赖收集和变更通知
-*
-* 核心机制：
-* - 在 stream() 中执行任务时，通过 AsyncLocalStorage 传递 this
-* - 任务中的所有 ReactiveState.get() 调用都会自动注册依赖
-* - 当任何依赖变更时，重新执行任务并 yield 新结果
-*/
-var ReactiveContext = class {
-	/** 当前追踪的依赖 */
-	dependencies = /* @__PURE__ */ new Set();
-	/** 等待变更的 Promise */
-	changePromise;
-	/** 是否已销毁 */
-	destroyed = false;
-	/**
-	* 追踪依赖
-	* 由 ReactiveState.get() 调用
-	*/
-	track(state) {
-		if (!this.destroyed) this.dependencies.add(state);
-	}
-	/**
-	* 通知变更
-	* 由 ReactiveState.set() 调用
-	*/
-	notifyChange() {
-		if (!this.destroyed && this.changePromise) this.changePromise.resolve();
-	}
-	/**
-	* 运行响应式任务流
-	* 每次依赖变更时重新执行任务并 yield 结果
-	*
-	* @param task 要执行的异步任务
-	* @param signal 用于取消的 AbortSignal
-	*/
-	async *stream(task, signal) {
-		try {
-			while (!signal?.aborted && !this.destroyed) {
-				this.clearDependencies();
-				this.changePromise = createPromiseWithResolvers();
-				yield await contextStorage.run(this, task);
-				if (this.dependencies.size === 0) break;
-				await Promise.race([this.changePromise.promise, signal ? this.waitForAbort(signal) : new Promise(() => {})]);
-				if (signal?.aborted) break;
-			}
-		} finally {
-			this.destroy();
-		}
-	}
-	/**
-	* 执行一次任务（非响应式）
-	* 用于初始数据获取
-	*/
-	async runOnce(task) {
-		return contextStorage.run(this, task);
-	}
-	/**
-	* 清理依赖
-	*/
-	clearDependencies() {
-		for (const state of this.dependencies) state.unsubscribe(this);
-		this.dependencies.clear();
-	}
-	/**
-	* 销毁上下文
-	* @param reason 可选的销毁原因，如果提供则 reject changePromise
-	*/
-	destroy(reason) {
-		this.destroyed = true;
-		this.clearDependencies();
-		if (reason && this.changePromise) this.changePromise.reject(reason);
-		this.changePromise = void 0;
-	}
-	/**
-	* 等待 AbortSignal
-	*/
-	waitForAbort(signal) {
-		return new Promise((_, reject) => {
-			if (signal.aborted) {
-				reject(new DOMException("Aborted", "AbortError"));
-				return;
-			}
-			signal.addEventListener("abort", () => {
-				reject(new DOMException("Aborted", "AbortError"));
-			});
-		});
-	}
-};
-
 //#endregion
 //#region src/reactive-fs/path-realpath.ts
 /**
@@ -591,6 +345,10 @@ const DEFAULT_IGNORE = [
 const RECOVERY_INTERVAL_MS = 3e3;
 /** 路径语义检查间隔 (ms) */
 const PATH_LIVENESS_INTERVAL_MS = 3e3;
+function isStrictAncestorPath(ancestorPath, candidatePath) {
+	const childPath = relative(ancestorPath, candidatePath);
+	return childPath !== "" && childPath !== ".." && !isAbsolute(childPath) && !childPath.startsWith(`..${sep}`);
+}
 /**
 * 项目监听器
 *
@@ -780,6 +538,8 @@ var ProjectWatcher = class {
 				sub.callback(matchedEvents);
 			} catch (err) {
 				console.error(`[ProjectWatcher] Callback error for ${sub.path}:`, err);
+			} finally {
+				sub.awaitingPathCreation = sub.watchAncestorsWhileMissing && !existsSync(sub.path);
 			}
 		}
 	}
@@ -788,6 +548,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;
 		else {
 			const eventDir = dirname$1(eventPath);
@@ -812,6 +573,8 @@ var ProjectWatcher = class {
 		this.pathSubscriptions.set(id, {
 			path: normalizedPath,
 			watchChildren: options.watchChildren ?? false,
+			watchAncestorsWhileMissing: options.watchAncestorsWhileMissing ?? false,
+			awaitingPathCreation: (options.watchAncestorsWhileMissing ?? false) && !existsSync(normalizedPath),
 			callback
 		});
 		return () => {
@@ -1002,177 +765,265 @@ async function closeAllProjectWatchers() {
 //#endregion
 //#region src/reactive-fs/watcher-pool.ts
 /**
-* 获取路径的真实路径（解析符号链接）
+* Orthogonal intents (updated 2026-07-28 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.
+*
+* 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.
 */
+const DEBOUNCE_MS = 100;
 function getRealPath(path) {
 	return resolveRealPathThroughExistingAncestor(path);
 }
-/**
-* 全局 ProjectWatcher 实例
-* 通过 initWatcherPool 初始化
-*/
-let globalProjectWatcher = null;
-let globalProjectDir = null;
-/** 默认防抖时间 (ms) */
-const DEBOUNCE_MS = 100;
-/** 路径订阅缓存 */
+function getExistingWatcherRoot(rootPath) {
+	let currentPath = rootPath;
+	while (!existsSync(currentPath)) {
+		const parentPath = dirname$1(currentPath);
+		if (parentPath === currentPath) return currentPath;
+		currentPath = parentPath;
+	}
+	return currentPath;
+}
+function pathBelongsToRoot(path, rootPath) {
+	const relativePath = relative(rootPath, path);
+	return relativePath === "" || !relativePath.startsWith("..") && !isAbsolute(relativePath);
+}
+const watcherRoots = /* @__PURE__ */ new Map();
+const closingWatcherRoots = /* @__PURE__ */ new Map();
+const physicalWatcherReferences = /* @__PURE__ */ new Map();
+const closingPhysicalWatchers = /* @__PURE__ */ new Map();
 const subscriptionCache = /* @__PURE__ */ new Map();
-/** 防抖定时器 */
 const debounceTimers = /* @__PURE__ */ new Map();
 const watcherRuntimeStatusListeners = /* @__PURE__ */ new Set();
-let releaseProjectWatcherRuntimeSubscription = null;
 function emitWatcherRuntimeStatus() {
 	const status = getWatcherRuntimeStatus();
 	for (const listener of watcherRuntimeStatusListeners) listener(status);
 }
-function bindProjectWatcherRuntimeStatus() {
-	releaseProjectWatcherRuntimeSubscription?.();
-	releaseProjectWatcherRuntimeSubscription = null;
-	if (!globalProjectWatcher) {
-		emitWatcherRuntimeStatus();
-		return;
+function findWatcherRoot(path) {
+	let selected = null;
+	for (const root of watcherRoots.values()) if (root.referenceCount > 0 && root.watcher.isInitialized && pathBelongsToRoot(path, root.rootPath) && (!selected || root.rootPath.length > selected.rootPath.length)) selected = root;
+	return selected;
+}
+function dispatchSubscription(cacheKey, subscription) {
+	const existingTimer = debounceTimers.get(cacheKey);
+	if (existingTimer) clearTimeout(existingTimer);
+	const timer = setTimeout(() => {
+		debounceTimers.delete(cacheKey);
+		const current = subscriptionCache.get(cacheKey);
+		if (current !== subscription) return;
+		for (const callback of current.callbacks) try {
+			callback();
+		} catch (error) {
+			console.error(`[watcher-pool] Callback error for ${subscription.path}:`, error);
+		}
+	}, subscription.debounceMs);
+	debounceTimers.set(cacheKey, timer);
+}
+function rebindSubscription(cacheKey, subscription) {
+	const root = findWatcherRoot(subscription.path);
+	if (subscription.rootPath === root?.rootPath) return;
+	subscription.unsubscribe?.();
+	subscription.unsubscribe = null;
+	subscription.rootPath = null;
+	if (!root) return;
+	try {
+		subscription.unsubscribe = root.watcher.subscribeSync(subscription.path, () => dispatchSubscription(cacheKey, subscription), {
+			watchChildren: subscription.recursive,
+			watchAncestorsWhileMissing: subscription.watchAncestorsWhileMissing
+		});
+		subscription.rootPath = root.rootPath;
+	} catch (error) {
+		subscription.onError?.();
+		console.error(`[watcher-pool] Failed to bind ${subscription.path}:`, error);
 	}
+}
+function rebindAllSubscriptions() {
+	for (const [cacheKey, subscription] of subscriptionCache) rebindSubscription(cacheKey, subscription);
+}
+function createWatcherRoot(rootPath) {
+	const physicalRootPath = getExistingWatcherRoot(rootPath);
+	const existingPhysical = physicalWatcherReferences.get(physicalRootPath);
+	const watcher = existingPhysical?.watcher ?? getProjectWatcher(physicalRootPath);
+	if (existingPhysical) existingPhysical.referenceCount += 1;
+	else physicalWatcherReferences.set(physicalRootPath, {
+		watcher,
+		referenceCount: 1
+	});
+	const record = {
+		rootPath,
+		physicalRootPath,
+		watcher,
+		referenceCount: 0,
+		ready: Promise.resolve(),
+		releaseRuntimeStatus: () => {}
+	};
+	watcherRoots.set(rootPath, record);
 	const forward = () => {
+		rebindAllSubscriptions();
 		emitWatcherRuntimeStatus();
 	};
-	releaseProjectWatcherRuntimeSubscription = globalProjectWatcher.subscribeRuntimeStatus(forward, { emitCurrent: false });
+	record.releaseRuntimeStatus = watcher.subscribeRuntimeStatus(forward, { emitCurrent: false });
+	record.ready = watcher.init().then(() => {
+		rebindAllSubscriptions();
+		emitWatcherRuntimeStatus();
+	});
+	return record;
+}
+async function releaseWatcherRootReference(record) {
+	if (watcherRoots.get(record.rootPath) !== record || record.referenceCount === 0) return;
+	record.referenceCount -= 1;
+	if (record.referenceCount > 0) {
+		emitWatcherRuntimeStatus();
+		return;
+	}
+	watcherRoots.delete(record.rootPath);
+	record.releaseRuntimeStatus();
+	rebindAllSubscriptions();
+	const physical = physicalWatcherReferences.get(record.physicalRootPath);
+	if (!physical || physical.referenceCount <= 0) {
+		emitWatcherRuntimeStatus();
+		return;
+	}
+	physical.referenceCount -= 1;
+	if (physical.referenceCount > 0) {
+		emitWatcherRuntimeStatus();
+		return;
+	}
+	physicalWatcherReferences.delete(record.physicalRootPath);
+	const closing = record.watcher.close().finally(() => {
+		if (closingWatcherRoots.get(record.rootPath) === closing) closingWatcherRoots.delete(record.rootPath);
+		if (closingPhysicalWatchers.get(record.physicalRootPath) === closing) closingPhysicalWatchers.delete(record.physicalRootPath);
+		emitWatcherRuntimeStatus();
+	});
+	closingWatcherRoots.set(record.rootPath, closing);
+	closingPhysicalWatchers.set(record.physicalRootPath, closing);
 	emitWatcherRuntimeStatus();
+	await closing;
 }
-/**
-* 初始化 watcher pool
-*
-* 必须在使用 acquireWatcher 之前调用。
-* 通常由 server 在启动时调用。
-*
-* @param projectDir 项目根目录
-*/
-async function initWatcherPool(projectDir) {
-	const normalizedDir = getRealPath(projectDir);
-	if (globalProjectWatcher && globalProjectDir === normalizedDir) return;
-	if (globalProjectWatcher) {
-		releaseProjectWatcherRuntimeSubscription?.();
-		releaseProjectWatcherRuntimeSubscription = null;
-		await globalProjectWatcher.close();
-	}
-	globalProjectDir = normalizedDir;
-	globalProjectWatcher = getProjectWatcher(normalizedDir);
-	bindProjectWatcherRuntimeStatus();
-	await globalProjectWatcher.init();
+/** Acquire one physical observation root and release it when the returned lease is no longer used. */
+async function acquireWatcherRoot(rootPath) {
+	const normalizedRoot = getRealPath(rootPath);
+	const physicalRootPath = getExistingWatcherRoot(normalizedRoot);
+	await Promise.all([closingWatcherRoots.get(normalizedRoot), closingPhysicalWatchers.get(physicalRootPath)]);
+	const record = watcherRoots.get(normalizedRoot) ?? createWatcherRoot(normalizedRoot);
+	record.referenceCount += 1;
+	emitWatcherRuntimeStatus();
+	try {
+		await record.ready;
+	} catch (error) {
+		await releaseWatcherRootReference(record);
+		throw error;
+	}
+	let released = false;
+	return async () => {
+		if (released) return;
+		released = true;
+		await releaseWatcherRootReference(record);
+	};
 }
 /**
-* 获取或创建文件/目录监听器
+* Acquire a shared path subscription.
 *
-* 特性：
-* - 使用 @parcel/watcher 监听项目根目录
-* - 自动处理新创建的目录（解决 init 后无法监听的问题）
-* - 同一路径共享订阅
-* - 引用计数管理生命周期
-* - 内置防抖机制
-*
-* @param path 要监听的路径
-* @param onChange 变更回调
-* @param options 监听选项
-* @returns 释放函数，调用后取消订阅
+* The subscription remains pending when no active root contains the path and binds automatically
+* after a matching root is acquired. This keeps static reads inert without making later live reads
+* permanently lose observation.
 */
 function acquireWatcher(path, onChange, options = {}) {
-	if (!globalProjectWatcher || !globalProjectWatcher.isInitialized) return () => {};
 	const normalizedPath = getRealPath(path);
-	const debounceMs = options.debounceMs ?? DEBOUNCE_MS;
-	const isRecursive = options.recursive ?? false;
-	const cacheKey = `${normalizedPath}:${isRecursive}`;
+	const recursive = options.recursive ?? false;
+	const watchAncestorsWhileMissing = options.watchAncestorsWhileMissing ?? false;
+	const cacheKey = `${normalizedPath}:${recursive}:${watchAncestorsWhileMissing}`;
 	let subscription = subscriptionCache.get(cacheKey);
 	if (!subscription) {
-		const unsubscribe = globalProjectWatcher.subscribeSync(normalizedPath, () => {
-			const existingTimer = debounceTimers.get(cacheKey);
-			if (existingTimer) clearTimeout(existingTimer);
-			const timer = setTimeout(() => {
-				debounceTimers.delete(cacheKey);
-				const currentSub = subscriptionCache.get(cacheKey);
-				if (currentSub) for (const cb of currentSub.callbacks) try {
-					cb();
-				} catch (err) {
-					console.error(`[watcher-pool] Callback error for ${normalizedPath}:`, err);
-				}
-			}, debounceMs);
-			debounceTimers.set(cacheKey, timer);
-		}, { watchChildren: isRecursive });
 		subscription = {
 			path: normalizedPath,
+			recursive,
+			watchAncestorsWhileMissing,
+			debounceMs: options.debounceMs ?? DEBOUNCE_MS,
 			callbacks: /* @__PURE__ */ new Set(),
-			unsubscribe,
+			rootPath: null,
+			unsubscribe: null,
 			onError: options.onError
 		};
 		subscriptionCache.set(cacheKey, subscription);
+		rebindSubscription(cacheKey, subscription);
 	}
 	subscription.callbacks.add(onChange);
+	let released = false;
 	return () => {
-		const currentSub = subscriptionCache.get(cacheKey);
-		if (!currentSub) return;
-		currentSub.callbacks.delete(onChange);
-		if (currentSub.callbacks.size === 0) {
-			currentSub.unsubscribe();
-			subscriptionCache.delete(cacheKey);
-			const timer = debounceTimers.get(cacheKey);
-			if (timer) {
-				clearTimeout(timer);
-				debounceTimers.delete(cacheKey);
-			}
+		if (released) return;
+		released = true;
+		const current = subscriptionCache.get(cacheKey);
+		if (!current) return;
+		current.callbacks.delete(onChange);
+		if (current.callbacks.size > 0) return;
+		current.unsubscribe?.();
+		subscriptionCache.delete(cacheKey);
+		const timer = debounceTimers.get(cacheKey);
+		if (timer) {
+			clearTimeout(timer);
+			debounceTimers.delete(cacheKey);
 		}
 	};
 }
-/**
-* 获取当前活跃的监听器数量（用于调试）
-*/
 function getActiveWatcherCount() {
 	return subscriptionCache.size;
 }
-/**
-* 关闭所有监听器（用于测试清理）
-*/
+/** Close the entire process-level pool. Intended for runtime teardown and test isolation. */
 async function closeAllWatchers() {
-	for (const [key, sub] of subscriptionCache) {
-		sub.unsubscribe();
-		const timer = debounceTimers.get(key);
+	for (const [cacheKey, subscription] of subscriptionCache) {
+		subscription.unsubscribe?.();
+		const timer = debounceTimers.get(cacheKey);
 		if (timer) clearTimeout(timer);
 	}
 	subscriptionCache.clear();
 	debounceTimers.clear();
-	if (globalProjectWatcher) {
-		releaseProjectWatcherRuntimeSubscription?.();
-		releaseProjectWatcherRuntimeSubscription = null;
-		await globalProjectWatcher.close();
-		globalProjectWatcher = null;
-		globalProjectDir = null;
-	}
+	const records = [...watcherRoots.values()];
+	watcherRoots.clear();
+	for (const record of records) {
+		record.referenceCount = 0;
+		record.releaseRuntimeStatus();
+	}
+	const physicalWatchers = [...physicalWatcherReferences.values()].map(({ watcher }) => watcher);
+	physicalWatcherReferences.clear();
+	await Promise.all([
+		...physicalWatchers.map((watcher) => watcher.close()),
+		...closingWatcherRoots.values(),
+		...closingPhysicalWatchers.values()
+	]);
+	closingWatcherRoots.clear();
+	closingPhysicalWatchers.clear();
 	emitWatcherRuntimeStatus();
 }
-/**
-* 检查 watcher pool 是否已初始化
-*/
 function isWatcherPoolInitialized() {
-	return globalProjectWatcher !== null && globalProjectWatcher.isInitialized;
-}
-/**
-* 获取当前监听的项目目录
-*/
-function getWatchedProjectDir() {
-	return globalProjectDir;
+	return [...watcherRoots.values()].some((root) => root.watcher.isInitialized);
 }
-/**
-* 获取 watcher 运行时状态
-*/
 function getWatcherRuntimeStatus() {
-	if (!globalProjectWatcher) return null;
-	const runtime = globalProjectWatcher.runtimeStatus;
+	const roots = [...watcherRoots.values()].filter((root) => root.referenceCount > 0).map((root) => {
+		const runtime = root.watcher.runtimeStatus;
+		return {
+			rootPath: root.rootPath,
+			referenceCount: root.referenceCount,
+			initialized: root.watcher.isInitialized,
+			subscriptionCount: root.watcher.subscriptionCount,
+			generation: runtime.generation,
+			reinitializeCount: runtime.reinitializeCount,
+			lastReinitializeReason: runtime.lastReinitializeReason,
+			reinitializeReasonCounts: runtime.reinitializeReasonCounts,
+			projectResidency: runtime.projectResidency
+		};
+	}).sort((left, right) => left.rootPath.localeCompare(right.rootPath));
+	if (roots.length === 0) return null;
 	return {
-		projectDir: globalProjectDir,
-		initialized: globalProjectWatcher.isInitialized,
-		subscriptionCount: globalProjectWatcher.subscriptionCount,
-		generation: runtime.generation,
-		reinitializeCount: runtime.reinitializeCount,
-		lastReinitializeReason: runtime.lastReinitializeReason,
-		reinitializeReasonCounts: runtime.reinitializeReasonCounts,
-		projectResidency: runtime.projectResidency
+		initialized: roots.some((root) => root.initialized),
+		rootCount: roots.length,
+		subscriptionCount: roots.reduce((count, root) => count + root.subscriptionCount, 0),
+		roots
 	};
 }
 function subscribeWatcherRuntimeStatus(listener, options = {}) {
@@ -1184,26 +1035,301 @@ function subscribeWatcherRuntimeStatus(listener, options = {}) {
 }
 
 //#endregion
-//#region src/reactive-fs/reactive-fs.ts
-/** 状态缓存：路径 -> ReactiveState */
-const stateCache$1 = /* @__PURE__ */ new Map();
-/** 监听器释放函数缓存 */
-const releaseCache$1 = /* @__PURE__ */ new Map();
-/** 缺失路径重校验定时器缓存 */
-const missingPathPollCache = /* @__PURE__ */ new Map();
-/** Native watcher can miss a create event on some CI filesystems; missing paths get a low-frequency fallback. */
-const MISSING_PATH_POLL_MS = 1e3;
-function stopMissingPathPoll(key) {
-	const timer = missingPathPollCache.get(key);
-	if (!timer) return;
-	clearInterval(timer);
-	missingPathPollCache.delete(key);
-}
-function ensureMissingPathPoll(key, poll) {
-	if (!isWatcherPoolInitialized() || missingPathPollCache.has(key)) return;
-	const timer = setInterval(() => {
-		poll();
-	}, MISSING_PATH_POLL_MS);
+//#region src/reactive-fs/observation-environment.ts
+/**
+* Orthogonal intents (created 2026-07-16 Asia/Shanghai):
+* 1. Own the dynamic observation-root set for one backend runtime environment.
+* 2. Reference-count repeated logical acquisition inside that environment.
+* 3. Share physical root watchers through the process-level watcher pool.
+* 4. Release every root deterministically during environment teardown.
+*
+* Original request (2026-07-15): "Reactive observation supports a reference-counted dynamic set of roots per runtime environment."
+*/
+/** Runtime-environment owner for all roots observed by one backend process. */
+var ReactiveObservationEnvironment = class {
+	roots = /* @__PURE__ */ new Map();
+	disposed = false;
+	async acquireRoot(rootPath) {
+		if (this.disposed) throw new Error("Cannot acquire an observation root after environment teardown.");
+		const normalizedRoot = resolveRealPathThroughExistingAncestor(rootPath);
+		let record = this.roots.get(normalizedRoot);
+		if (!record) {
+			record = {
+				rootPath: normalizedRoot,
+				referenceCount: 0,
+				lease: acquireWatcherRoot(normalizedRoot)
+			};
+			this.roots.set(normalizedRoot, record);
+		}
+		record.referenceCount += 1;
+		try {
+			await record.lease;
+		} catch (error) {
+			record.referenceCount -= 1;
+			if (record.referenceCount === 0 && this.roots.get(normalizedRoot) === record) this.roots.delete(normalizedRoot);
+			throw error;
+		}
+		let released = false;
+		return async () => {
+			if (released) return;
+			released = true;
+			const current = this.roots.get(normalizedRoot);
+			if (current !== record || current.referenceCount === 0) return;
+			current.referenceCount -= 1;
+			if (current.referenceCount > 0) return;
+			this.roots.delete(normalizedRoot);
+			await (await current.lease)();
+		};
+	}
+	getRoots() {
+		return [...this.roots.values()].map(({ rootPath, referenceCount }) => ({
+			rootPath,
+			referenceCount
+		})).sort((left, right) => left.rootPath.localeCompare(right.rootPath));
+	}
+	async dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		const records = [...this.roots.values()];
+		this.roots.clear();
+		await Promise.all(records.map(async (record) => {
+			await (await record.lease)();
+		}));
+	}
+};
+
+//#endregion
+//#region src/reactive-fs/reactive-state.ts
+/**
+* 全局的 AsyncLocalStorage，用于在异步调用链中传递 ReactiveContext
+* 这是实现依赖收集的核心机制
+*/
+const contextStorage = new AsyncLocalStorage();
+/**
+* 响应式状态类，类似 Signal.State
+*
+* 核心机制：
+* - get() 时自动注册到当前 ReactiveContext 的依赖列表
+* - set() 时如果值变化，通知所有依赖的 Context
+*/
+var ReactiveState = class {
+	currentValue;
+	equals;
+	/** 所有依赖此状态的 Context */
+	subscribers = /* @__PURE__ */ new Set();
+	constructor(initialValue, options) {
+		this.currentValue = initialValue;
+		this.equals = options?.equals ?? ((a, b) => a === b);
+	}
+	/**
+	* 获取当前值
+	* 如果在 ReactiveContext 中调用，会自动注册依赖
+	*/
+	get() {
+		const context = contextStorage.getStore();
+		if (context) {
+			context.track(this);
+			this.subscribers.add(context);
+		}
+		return this.currentValue;
+	}
+	/**
+	* 设置新值
+	* 如果值变化，通知所有订阅者
+	* @returns 是否发生了变化
+	*/
+	set(newValue) {
+		if (this.equals(this.currentValue, newValue)) return false;
+		this.currentValue = newValue;
+		for (const context of this.subscribers) context.notifyChange();
+		return true;
+	}
+	/**
+	* 取消订阅
+	* 当 Context 销毁时调用
+	*/
+	unsubscribe(context) {
+		this.subscribers.delete(context);
+	}
+	/**
+	* 获取当前订阅者数量（用于调试）
+	*/
+	get subscriberCount() {
+		return this.subscribers.size;
+	}
+};
+
+//#endregion
+//#region src/reactive-fs/reactive-context.ts
+/**
+* Orthogonal intents (updated 2026-07-26 Asia/Shanghai):
+* 1. Collect reactive dependencies for asynchronous projections.
+* 2. Coalesce dependency changes into replacement task executions.
+* 3. Expose opt-in recompute lifecycle without changing yielded data.
+*
+* Original request (2026-07-22): "整个过程中，几乎都在 Loading。"
+* Original request (2026-07-26): "真正基于文件、甚至是文件内容结构的变更去拉取更新。"
+*/
+function createPromiseWithResolvers() {
+	let resolve$1;
+	let reject;
+	return {
+		promise: new Promise((res, rej) => {
+			resolve$1 = res;
+			reject = rej;
+		}),
+		resolve: resolve$1,
+		reject
+	};
+}
+/**
+* 响应式上下文，管理依赖收集和变更通知
+*
+* 核心机制：
+* - 在 stream() 中执行任务时，通过 AsyncLocalStorage 传递 this
+* - 任务中的所有 ReactiveState.get() 调用都会自动注册依赖
+* - 当任何依赖变更时，重新执行任务并 yield 新结果
+*/
+var ReactiveContext = class {
+	/** 当前追踪的依赖 */
+	dependencies = /* @__PURE__ */ new Set();
+	/** 等待变更的 Promise */
+	changePromise;
+	/** 是否已销毁 */
+	destroyed = false;
+	/** 当前任务执行期间是否已有依赖变化，使其结果不再可提交 */
+	changePending = false;
+	/**
+	* 追踪依赖
+	* 由 ReactiveState.get() 调用
+	*/
+	track(state) {
+		if (!this.destroyed) this.dependencies.add(state);
+	}
+	/**
+	* 通知变更
+	* 由 ReactiveState.set() 调用
+	*/
+	notifyChange() {
+		if (this.destroyed) return;
+		this.changePending = true;
+		this.changePromise?.resolve();
+	}
+	/**
+	* 运行响应式任务流
+	* 每次依赖变更时重新执行任务并 yield 结果
+	*
+	* @param task 要执行的异步任务
+	* @param signal 用于取消的 AbortSignal
+	* @param observer 可选的依赖重算生命周期观察器
+	*/
+	async *stream(task, signal, observer) {
+		let abortPromise = null;
+		try {
+			while (!signal?.aborted && !this.destroyed) {
+				this.clearDependencies();
+				this.changePending = false;
+				this.changePromise = createPromiseWithResolvers();
+				let result;
+				try {
+					result = await contextStorage.run(this, task);
+				} catch (error) {
+					if (this.changePending) {
+						if (signal?.aborted) break;
+						observer?.onRecomputeStarted();
+						continue;
+					}
+					throw error;
+				}
+				if (signal?.aborted) break;
+				if (this.changePending) {
+					if (signal?.aborted) break;
+					observer?.onRecomputeStarted();
+					continue;
+				}
+				yield result;
+				if (this.dependencies.size === 0) break;
+				abortPromise ??= signal ? this.waitForAbort(signal) : new Promise(() => {});
+				await Promise.race([this.changePromise.promise, abortPromise]);
+				if (signal?.aborted) break;
+				observer?.onRecomputeStarted();
+			}
+		} finally {
+			this.destroy();
+		}
+	}
+	/**
+	* 执行一次任务（非响应式）
+	* 用于初始数据获取
+	*/
+	async runOnce(task) {
+		return contextStorage.run(this, task);
+	}
+	/**
+	* 清理依赖
+	*/
+	clearDependencies() {
+		for (const state of this.dependencies) state.unsubscribe(this);
+		this.dependencies.clear();
+	}
+	/**
+	* 销毁上下文
+	* @param reason 可选的销毁原因，如果提供则 reject changePromise
+	*/
+	destroy(reason) {
+		this.destroyed = true;
+		this.clearDependencies();
+		if (reason && this.changePromise) this.changePromise.reject(reason);
+		this.changePromise = void 0;
+	}
+	/**
+	* 等待 AbortSignal
+	*/
+	waitForAbort(signal) {
+		return new Promise((_, reject) => {
+			if (signal.aborted) {
+				reject(new DOMException("Aborted", "AbortError"));
+				return;
+			}
+			signal.addEventListener("abort", () => {
+				reject(new DOMException("Aborted", "AbortError"));
+			});
+		});
+	}
+};
+
+//#endregion
+//#region src/reactive-fs/reactive-fs.ts
+/**
+* Orthogonal intents (updated 2026-07-16 Asia/Shanghai):
+* 1. Cache reactive file, directory, existence, and stat reads.
+* 2. Bind cached reads to shared watcher roots and missing-path fallback checks.
+* 3. Settle overlapping cached projections as one coherent post-mutation snapshot.
+* 4. Release watcher, polling, state, and refresh registrations together.
+*
+* Original request (2026-07-16): "direct filesystem mutations update reactive state before returning."
+*/
+/** 状态缓存：路径 -> ReactiveState */
+const stateCache$1 = /* @__PURE__ */ new Map();
+/** Cache refreshers retained so owned writes can settle projections without watcher timing. */
+const refreshCache = /* @__PURE__ */ new Map();
+/** 监听器释放函数缓存 */
+const releaseCache$1 = /* @__PURE__ */ new Map();
+/** 缺失路径重校验定时器缓存 */
+const missingPathPollCache = /* @__PURE__ */ new Map();
+/** Native watcher can miss a create event on some CI filesystems; missing paths get a low-frequency fallback. */
+const MISSING_PATH_POLL_MS = 1e3;
+function stopMissingPathPoll(key) {
+	const timer = missingPathPollCache.get(key);
+	if (!timer) return;
+	clearInterval(timer);
+	missingPathPollCache.delete(key);
+}
+function ensureMissingPathPoll(key, poll) {
+	if (!isWatcherPoolInitialized() || missingPathPollCache.has(key)) return;
+	const timer = setInterval(() => {
+		poll();
+	}, MISSING_PATH_POLL_MS);
 	timer.unref?.();
 	missingPathPollCache.set(key, timer);
 }
@@ -1224,7 +1350,7 @@ async function reactiveReadFile(filepath) {
 	const key = `file:${normalizedPath}`;
 	const getValue = async () => {
 		try {
-			return await readFile$1(normalizedPath, "utf-8");
+			return await readFile(normalizedPath, "utf-8");
 		} catch {
 			return null;
 		}
@@ -1234,16 +1360,28 @@ async function reactiveReadFile(filepath) {
 		const initialValue = await getValue();
 		state = new ReactiveState(initialValue);
 		stateCache$1.set(key, state);
-		const refresh = async () => {
+		const prepareRefresh = async () => {
 			const newValue = await getValue();
-			state.set(newValue);
-			if (newValue === null) ensureMissingPathPoll(key, refresh);
-			else stopMissingPathPoll(key);
+			return () => {
+				state.set(newValue);
+				if (newValue === null) ensureMissingPathPoll(key, refresh);
+				else stopMissingPathPoll(key);
+			};
+		};
+		const refresh = async () => {
+			(await prepareRefresh())();
 		};
+		refreshCache.set(key, {
+			kind: "file",
+			path: normalizedPath,
+			prepareRefresh,
+			refresh
+		});
 		if (initialValue === null) ensureMissingPathPoll(key, refresh);
 		const release = acquireWatcher(dirname$1(normalizedPath), refresh, { onError: () => {
 			stopMissingPathPoll(key);
 			stateCache$1.delete(key);
+			refreshCache.delete(key);
 			releaseCache$1.delete(key);
 		} });
 		releaseCache$1.set(key, release);
@@ -1259,6 +1397,31 @@ function updateReactiveFileCache(filepath, content) {
 	const key = `file:${resolve(filepath)}`;
 	stateCache$1.get(key)?.set(content);
 }
+function containsPath(rootPath, candidatePath) {
+	const childPath = relative(rootPath, candidatePath);
+	return childPath === "" || !isAbsolute(childPath) && !childPath.startsWith(`..${sep}`) && childPath !== "..";
+}
+function pathsOverlap(firstPath, secondPath) {
+	return containsPath(firstPath, secondPath) || containsPath(secondPath, firstPath);
+}
+async function settleReactivePathMutationInternal(path, exactFileContent) {
+	const normalizedPath = resolve(path);
+	const registrations = [...refreshCache.values()].filter((registration) => pathsOverlap(registration.path, normalizedPath));
+	const commits = await Promise.all(registrations.flatMap((registration) => exactFileContent !== void 0 && registration.kind === "file" && registration.path === normalizedPath ? [] : [registration.prepareRefresh()]));
+	for (const commit of commits) commit();
+	if (exactFileContent !== void 0) updateReactiveFileCache(normalizedPath, exactFileContent);
+}
+/** Re-read and atomically publish every cached projection overlapping one committed path mutation. */
+async function settleReactivePathMutation(path) {
+	await settleReactivePathMutationInternal(path);
+}
+/**
+* Publish a successful file write to every cached projection whose value can change.
+* File content is set from the committed bytes; directory/existence/stat views re-read disk.
+*/
+async function settleReactiveFileWrite(filepath, content) {
+	await settleReactivePathMutationInternal(filepath, content);
+}
 /**
 * 响应式读取目录内容
 *
@@ -1292,16 +1455,29 @@ async function reactiveReadDir(dirpath, options = {}) {
 	if (!state) {
 		state = new ReactiveState(await getValue(), { equals: (a, b) => a.length === b.length && a.every((v, i) => v === b[i]) });
 		stateCache$1.set(key, state);
-		const release = acquireWatcher(normalizedPath, async () => {
+		const prepareRefresh = async () => {
 			const newValue = await getValue();
-			state.set(newValue);
-		}, {
+			return () => {
+				state.set(newValue);
+			};
+		};
+		const refresh = async () => {
+			(await prepareRefresh())();
+		};
+		const release = acquireWatcher(normalizedPath, refresh, {
 			recursive: true,
 			onError: () => {
 				stateCache$1.delete(key);
+				refreshCache.delete(key);
 				releaseCache$1.delete(key);
 			}
 		});
+		refreshCache.set(key, {
+			kind: "directory",
+			path: normalizedPath,
+			prepareRefresh,
+			refresh
+		});
 		releaseCache$1.set(key, release);
 	}
 	return state.get();
@@ -1328,16 +1504,28 @@ async function reactiveExists(path) {
 		const initialValue = await getValue();
 		state = new ReactiveState(initialValue);
 		stateCache$1.set(key, state);
-		const refresh = async () => {
+		const prepareRefresh = async () => {
 			const newValue = await getValue();
-			state.set(newValue);
-			if (newValue) stopMissingPathPoll(key);
-			else ensureMissingPathPoll(key, refresh);
+			return () => {
+				state.set(newValue);
+				if (newValue) stopMissingPathPoll(key);
+				else ensureMissingPathPoll(key, refresh);
+			};
+		};
+		const refresh = async () => {
+			(await prepareRefresh())();
 		};
+		refreshCache.set(key, {
+			kind: "exists",
+			path: normalizedPath,
+			prepareRefresh,
+			refresh
+		});
 		if (!initialValue) ensureMissingPathPoll(key, refresh);
 		const release = acquireWatcher(dirname$1(normalizedPath), refresh, { onError: () => {
 			stopMissingPathPoll(key);
 			stateCache$1.delete(key);
+			refreshCache.delete(key);
 			releaseCache$1.delete(key);
 		} });
 		releaseCache$1.set(key, release);
@@ -1375,16 +1563,28 @@ async function reactiveStat(path) {
 			return a.isDirectory === b.isDirectory && a.isFile === b.isFile && a.mtime === b.mtime && a.birthtime === b.birthtime;
 		} });
 		stateCache$1.set(key, state);
-		const refresh = async () => {
+		const prepareRefresh = async () => {
 			const newValue = await getValue();
-			state.set(newValue);
-			if (newValue === null) ensureMissingPathPoll(key, refresh);
-			else stopMissingPathPoll(key);
+			return () => {
+				state.set(newValue);
+				if (newValue === null) ensureMissingPathPoll(key, refresh);
+				else stopMissingPathPoll(key);
+			};
 		};
+		const refresh = async () => {
+			(await prepareRefresh())();
+		};
+		refreshCache.set(key, {
+			kind: "stat",
+			path: normalizedPath,
+			prepareRefresh,
+			refresh
+		});
 		if (initialValue === null) ensureMissingPathPoll(key, refresh);
 		const release = acquireWatcher(dirname$1(normalizedPath), refresh, { onError: () => {
 			stopMissingPathPoll(key);
 			stateCache$1.delete(key);
+			refreshCache.delete(key);
 			releaseCache$1.delete(key);
 		} });
 		releaseCache$1.set(key, release);
@@ -1392,30 +1592,154 @@ async function reactiveStat(path) {
 	return state.get();
 }
 /**
-* 清除指定路径的缓存（用于测试）
+* 清除指定路径的缓存（用于测试）
+*/
+function clearCache(path) {
+	if (path) {
+		const normalizedPath = resolve(path);
+		for (const [key, release] of releaseCache$1) if (key.includes(normalizedPath)) {
+			release();
+			stopMissingPathPoll(key);
+			releaseCache$1.delete(key);
+			stateCache$1.delete(key);
+			refreshCache.delete(key);
+		}
+	} else {
+		for (const release of releaseCache$1.values()) release();
+		releaseCache$1.clear();
+		for (const timer of missingPathPollCache.values()) clearInterval(timer);
+		missingPathPollCache.clear();
+		stateCache$1.clear();
+		refreshCache.clear();
+	}
+}
+/**
+* 获取缓存大小（用于调试）
+*/
+function getCacheSize() {
+	return stateCache$1.size;
+}
+
+//#endregion
+//#region src/physical-reactive-file-writer.ts
+/**
+* Orthogonal intents (updated 2026-07-16 Asia/Shanghai):
+* 1. Own lexical and existing-ancestor physical confinement for root-scoped mutations.
+* 2. Execute UTF-8 write, directory-create, remove, and guarded external mutations.
+* 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."
+*/
+function isMissingPath(error) {
+	return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+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.`);
+}
+async function readLstat(path) {
+	try {
+		return await lstat(path);
+	} catch (error) {
+		if (isMissingPath(error)) return null;
+		throw error;
+	}
+}
+async function assertNearestExistingAncestor(lexicalRoot, physicalRoot, candidatePath) {
+	let currentPath = candidatePath;
+	while (true) {
+		if (await readLstat(currentPath)) {
+			let physicalPath;
+			try {
+				physicalPath = await realpath(currentPath);
+			} catch (error) {
+				throw new Error("Mutation target could not be resolved inside the physical root.", { cause: error });
+			}
+			ensureContained(physicalRoot, physicalPath, "physical");
+			return;
+		}
+		if (currentPath === lexicalRoot) throw new Error("Mutation root no longer exists.");
+		const parentPath = dirname$1(currentPath);
+		ensureContained(lexicalRoot, parentPath, "lexical");
+		currentPath = parentPath;
+	}
+}
+async function resolveMutationTarget(input) {
+	const normalizedRelativePath = input.relativePath.replace(/\\/g, "/");
+	if (!normalizedRelativePath || normalizedRelativePath.includes("\0") || isAbsolute(normalizedRelativePath) || /^[A-Za-z]:\//.test(normalizedRelativePath) || normalizedRelativePath.split("/").includes("..")) throw new Error("Mutation target must be a non-empty root-relative path.");
+	const lexicalRoot = resolve(input.rootPath);
+	const targetPath = resolve(lexicalRoot, normalizedRelativePath);
+	ensureContained(lexicalRoot, targetPath, "lexical");
+	if (targetPath === lexicalRoot) throw new Error("Mutation target cannot be the ownership root.");
+	return {
+		lexicalRoot,
+		physicalRoot: await realpath(lexicalRoot),
+		targetPath
+	};
+}
+async function assertMutationTarget(target) {
+	await assertNearestExistingAncestor(target.lexicalRoot, target.physicalRoot, target.targetPath);
+	if ((await readLstat(target.targetPath))?.isSymbolicLink()) throw new Error("Mutation target escaped the physical root through a symbolic link.");
+}
+async function runResolvedPhysicalReactivePathMutation(input, mutation, settle = settleReactivePathMutation) {
+	const target = await resolveMutationTarget(input);
+	await assertMutationTarget(target);
+	const outcome = await mutation(target).then((value) => ({
+		success: true,
+		value
+	}), (error) => ({
+		success: false,
+		error
+	}));
+	const finalizationFailures = [];
+	await assertMutationTarget(target).catch((error) => finalizationFailures.push(error));
+	await settle(target.targetPath).catch((error) => finalizationFailures.push(error));
+	if (!outcome.success) {
+		if (finalizationFailures.length > 0) throw new AggregateError([outcome.error, ...finalizationFailures], "Physical/reactive mutation and settlement failed.");
+		throw outcome.error;
+	}
+	if (finalizationFailures.length > 0) throw new AggregateError(finalizationFailures, "Physical/reactive mutation settlement failed.");
+	return outcome.value;
+}
+/**
+* Write one UTF-8 file inside an existing physical root and synchronously settle reactive readers.
+*
+* Existing ancestors and the final target are resolved immediately before the write. This rejects
+* observed symlink escapes but cannot make path checks race-free against concurrent filesystem
+* replacement on platforms without a directory-handle-relative write primitive.
 */
-function clearCache(path) {
-	if (path) {
-		const normalizedPath = resolve(path);
-		for (const [key, release] of releaseCache$1) if (key.includes(normalizedPath)) {
-			release();
-			stopMissingPathPoll(key);
-			releaseCache$1.delete(key);
-			stateCache$1.delete(key);
-		}
-	} else {
-		for (const release of releaseCache$1.values()) release();
-		releaseCache$1.clear();
-		for (const timer of missingPathPollCache.values()) clearInterval(timer);
-		missingPathPollCache.clear();
-		stateCache$1.clear();
-	}
+async function writePhysicalReactiveFile(input) {
+	await runResolvedPhysicalReactivePathMutation(input, async (target) => {
+		await mkdir$1(dirname$1(target.targetPath), { recursive: true });
+		await assertMutationTarget(target);
+		await writeFile$1(target.targetPath, input.content, "utf8");
+	}, (targetPath) => settleReactiveFileWrite(targetPath, input.content));
+}
+/** Create one root-confined directory and synchronously settle overlapping reactive readers. */
+async function createPhysicalReactiveDirectory(input) {
+	await runResolvedPhysicalReactivePathMutation(input, async (target) => {
+		await mkdir$1(target.targetPath, { recursive: true });
+	});
+}
+/** Remove one root-confined file or directory and synchronously settle descendant projections. */
+async function removePhysicalReactivePath(input) {
+	await runResolvedPhysicalReactivePathMutation(input, async (target) => {
+		await rm(target.targetPath, {
+			recursive: true,
+			force: true
+		});
+	});
 }
 /**
-* 获取缓存大小（用于调试）
+* Guard and settle a mutation performed by an external owner such as the OpenSpec CLI.
+*
+* The pre/post checks reject observed symlink escape, but cannot close replacement races between
+* checks and the external process. Hard-link aliases are likewise not identifiable from the path.
 */
-function getCacheSize() {
-	return stateCache$1.size;
+async function runPhysicalReactivePathMutation(input, mutation) {
+	return runResolvedPhysicalReactivePathMutation(input, () => mutation());
 }
 
 //#endregion
@@ -1501,6 +1825,16 @@ var Validator = class {
 //#endregion
 //#region src/adapter.ts
 /**
+* Orthogonal intents (updated 2026-07-23 Asia/Shanghai):
+* 1. Read and mutate one CLI-selected planning root through reactive filesystem APIs.
+* 2. Project Specs, Changes, Archives, and schema-neutral entity files.
+* 3. Keep tracked workflow tasks distinct from document checklist analytics.
+* 4. Preserve filesystem provenance and mutation boundaries for server consumers.
+* 5. Expose one bounded Change row projection for progressive list delivery without warming workflow details.
+*
+* Original request (2026-07-15): "Split formal tracked progress, document checklist statistics, and Apply instruction progress into non-interchangeable facts."
+*/
+/**
 * OpenSpec filesystem adapter
 * Handles reading, writing, and managing OpenSpec files
 */
@@ -1563,29 +1897,33 @@ var OpenSpecAdapter = class {
 			exclude: ["archive"]
 		});
 	}
+	/** Read one active Change row without resolving workflow Status, Apply, or artifact instructions. */
+	async readChangeMeta(id) {
+		const canonicalId = requireCanonicalOpenSpecEntityId(id, "changeId");
+		const changeDir = join(this.changesDir, canonicalId);
+		const [change, taskProjection, timeInfo] = await Promise.all([
+			this.readChange(canonicalId),
+			this.readChangeTaskProjection(canonicalId),
+			this.getFileTimeInfo(changeDir)
+		]);
+		return {
+			id: canonicalId,
+			name: change?.name ?? canonicalId,
+			trackedTaskProgress: taskProjection.trackedTaskProgress,
+			documentChecklistSummary: taskProjection.documentChecklistSummary,
+			createdAt: timeInfo?.createdAt ?? 0,
+			updatedAt: timeInfo?.updatedAt ?? 0
+		};
+	}
 	/**
-	* List changes with metadata (id, name, progress, and time info)
+	* List changes with metadata, separated task projections, and time info.
 	* Returns every change directory, including schema-specific layouts that
 	* don't use proposal.md/tasks.md.
 	* Sorted by updatedAt descending (most recent first)
 	*/
 	async listChangesWithMeta() {
 		const ids = await this.listChanges();
-		return (await Promise.all(ids.map(async (id) => {
-			const changeDir = join(this.changesDir, id);
-			const [change, taskProjection, timeInfo] = await Promise.all([
-				this.readChange(id),
-				this.readChangeTaskProjection(id),
-				this.getFileTimeInfo(changeDir)
-			]);
-			return {
-				id,
-				name: change?.name ?? id,
-				progress: taskProjection.progress,
-				createdAt: timeInfo?.createdAt ?? 0,
-				updatedAt: timeInfo?.updatedAt ?? 0
-			};
-		}))).sort((a, b) => b.updatedAt - a.updatedAt);
+		return (await Promise.all(ids.map((id) => this.readChangeMeta(id)))).sort((a, b) => b.updatedAt - a.updatedAt);
 	}
 	async listArchivedChanges() {
 		return reactiveReadDir(this.archiveDir, { directoriesOnly: true });
@@ -1604,7 +1942,8 @@ var OpenSpecAdapter = class {
 			return {
 				id,
 				name: id,
-				progress: taskProjection.progress,
+				trackedTaskProgress: taskProjection.trackedTaskProgress,
+				documentChecklistSummary: taskProjection.documentChecklistSummary,
 				createdAt: timeInfo?.createdAt ?? 0,
 				updatedAt: timeInfo?.updatedAt ?? 0
 			};
@@ -1632,7 +1971,8 @@ var OpenSpecAdapter = class {
 		}
 	}
 	async readSpecRaw(specId) {
-		return reactiveReadFile(join(this.specsDir, specId, "spec.md"));
+		const canonicalSpecId = requireCanonicalOpenSpecEntityId(specId, "specId");
+		return reactiveReadFile(join(this.specsDir, canonicalSpecId, "spec.md"));
 	}
 	async readChange(changeId) {
 		try {
@@ -1647,28 +1987,33 @@ var OpenSpecAdapter = class {
 		}
 	}
 	async readChangeFiles(changeId) {
-		const changeRoot = join(this.changesDir, changeId);
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		const changeRoot = join(this.changesDir, canonicalChangeId);
 		return this.readFilesUnderRoot(changeRoot);
 	}
 	async readArchivedChangeFiles(changeId) {
-		const archiveRoot = join(this.archiveDir, changeId);
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		const archiveRoot = join(this.archiveDir, canonicalChangeId);
 		return this.readFilesUnderRoot(archiveRoot);
 	}
 	async readChangeTaskProjection(changeId) {
-		return this.readEntityTaskProjection(join(this.changesDir, changeId));
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		return this.readEntityTaskProjection(join(this.changesDir, canonicalChangeId));
 	}
 	async readArchivedChangeTaskProjection(changeId) {
-		return this.readEntityTaskProjection(join(this.archiveDir, changeId));
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		return this.readEntityTaskProjection(join(this.archiveDir, canonicalChangeId));
 	}
 	async readEntityDetail(stage, id, options = {}) {
-		const root = stage === "change" ? join(this.changesDir, id) : join(this.archiveDir, id);
+		const canonicalId = requireCanonicalOpenSpecEntityId(id, "changeId");
+		const root = stage === "change" ? join(this.changesDir, canonicalId) : join(this.archiveDir, canonicalId);
 		const files = await this.readFilesUnderRoot(root);
 		if (files.length === 0) {
 			if (!(await reactiveStat(root))?.isDirectory) return null;
 		}
 		return buildOpsxEntityDetail({
 			stage,
-			id,
+			id: canonicalId,
 			files,
 			schemas: options.schemas,
 			schemaDiagnostics: options.schemaDiagnostics
@@ -1722,13 +2067,14 @@ var OpenSpecAdapter = class {
 	async readEntityTaskProjection(root) {
 		const files = await this.readFilesUnderRoot(root);
 		const metadata = parseOpsxEntityMetadata(files.find((file) => file.type === "file" && file.path === ".openspec.yaml")?.content ?? null);
-		return projectTasksFromMarkdownFiles(files, {
+		return projectTaskProjectionsFromMarkdownFiles(files, {
 			schemaDetail: metadata.schemaName ? await this.readProjectSchemaDetail(metadata.schemaName) : null,
 			hasSchemaMetadata: Boolean(metadata.schemaName)
 		});
 	}
 	async readChangeRaw(changeId) {
-		const changeDir = join(this.changesDir, changeId);
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		const changeDir = join(this.changesDir, canonicalChangeId);
 		const proposalPath = join(changeDir, "proposal.md");
 		const tasksPath = join(changeDir, "tasks.md");
 		const designPath = join(changeDir, "design.md");
@@ -1779,7 +2125,8 @@ var OpenSpecAdapter = class {
 	* Read raw archived change files (reactive)
 	*/
 	async readArchivedChangeRaw(changeId) {
-		const archiveChangeDir = join(this.archiveDir, changeId);
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		const archiveChangeDir = join(this.archiveDir, canonicalChangeId);
 		const proposalPath = join(archiveChangeDir, "proposal.md");
 		const tasksPath = join(archiveChangeDir, "tasks.md");
 		const designPath = join(archiveChangeDir, "design.md");
@@ -1799,26 +2146,35 @@ var OpenSpecAdapter = class {
 		};
 	}
 	async writeSpec(specId, content) {
-		const specDir = join(this.specsDir, specId);
-		await mkdir(specDir, { recursive: true });
-		await writeFile(join(specDir, "spec.md"), content, "utf-8");
+		const canonicalSpecId = requireCanonicalOpenSpecEntityId(specId, "specId");
+		await writePhysicalReactiveFile({
+			rootPath: this.projectDir,
+			relativePath: join("openspec", "specs", canonicalSpecId, "spec.md"),
+			content
+		});
 	}
 	async writeChange(changeId, proposal, tasks) {
-		const changeDir = join(this.changesDir, changeId);
-		await mkdir(changeDir, { recursive: true });
-		await writeFile(join(changeDir, "proposal.md"), proposal, "utf-8");
-		if (tasks !== void 0) await writeFile(join(changeDir, "tasks.md"), tasks, "utf-8");
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		await writePhysicalReactiveFile({
+			rootPath: this.projectDir,
+			relativePath: join("openspec", "changes", canonicalChangeId, "proposal.md"),
+			content: proposal
+		});
+		if (tasks !== void 0) await writePhysicalReactiveFile({
+			rootPath: this.projectDir,
+			relativePath: join("openspec", "changes", canonicalChangeId, "tasks.md"),
+			content: tasks
+		});
 	}
-	async archiveChange(changeId) {
-		try {
-			const changeDir = join(this.changesDir, changeId);
-			const archivePath = join(this.archiveDir, changeId);
-			await mkdir(this.archiveDir, { recursive: true });
-			await rename(changeDir, archivePath);
-			return true;
-		} catch {
-			return false;
-		}
+	/** Write one validated Change or Archive entity file through the shared physical/reactive owner. */
+	async writeEntityFile(stage, changeId, path, content) {
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		const relativePath = requireOpenSpecEntityRelativePath(path, "path");
+		await writePhysicalReactiveFile({
+			rootPath: this.projectDir,
+			relativePath: join(getOpsxEntityRootRelativePath(stage, canonicalChangeId), relativePath),
+			content
+		});
 	}
 	async init() {
 		await mkdir(this.specsDir, { recursive: true });
@@ -1835,36 +2191,6 @@ This project uses OpenSpec for spec-driven development.
 - \`changes/archive/\` - Completed changes
 `, "utf-8");
 	}
-	/**
-	* Toggle a task's completion status in tasks.md
-	* @param changeId - The change ID
-	* @param taskIndex - 1-based task index
-	* @param completed - New completion status
-	*/
-	async toggleTask(changeId, taskIndex, completed) {
-		try {
-			const tasksPath = join(this.changesDir, changeId, "tasks.md");
-			const lines = (await readFile(tasksPath, "utf-8")).split("\n");
-			let currentTaskIndex = 0;
-			for (let i = 0; i < lines.length; i++) {
-				const taskMatch = lines[i].match(/^([-*]\s+)\[([ xX])\](\s+.*)$/);
-				if (taskMatch) {
-					currentTaskIndex++;
-					if (currentTaskIndex === taskIndex) {
-						const prefix = taskMatch[1];
-						const suffix = taskMatch[3];
-						lines[i] = `${prefix}${completed ? "[x]" : "[ ]"}${suffix}`;
-						break;
-					}
-				}
-			}
-			if (currentTaskIndex < taskIndex) return false;
-			await writeFile(tasksPath, lines.join("\n"), "utf-8");
-			return true;
-		} catch {
-			return false;
-		}
-	}
 	async validateSpec(specId) {
 		const spec = await this.readSpec(specId);
 		if (!spec) return {
@@ -1898,8 +2224,8 @@ This project uses OpenSpec for spec-driven development.
 		const validSpecs = specs.filter((s) => s !== null);
 		const validChanges = changes.filter((c) => c !== null);
 		const totalRequirements = validSpecs.reduce((sum, s) => sum + s.requirements.length, 0);
-		const totalTasks = validChanges.reduce((sum, c) => sum + c.progress.total, 0);
-		const completedTasks = validChanges.reduce((sum, c) => sum + c.progress.completed, 0);
+		const totalTasks = validChanges.reduce((sum, change) => sum + change.trackedTaskProgress.total, 0);
+		const completedTasks = validChanges.reduce((sum, change) => sum + change.trackedTaskProgress.completed, 0);
 		return {
 			specs: validSpecs,
 			changes: validChanges,
@@ -1918,135 +2244,150 @@ This project uses OpenSpec for spec-driven development.
 };
 
 //#endregion
-//#region src/schemas.ts
+//#region src/planning-config.ts
 /**
-* Zod schemas and TypeScript types for OpenSpec documents.
+* Orthogonal intents (updated 2026-07-27 Asia/Shanghai):
+* 1. Define distinct Project Binding, Active Root, and reactive Environment Global config projections.
+* 2. Inspect launch-project Store/Reference declarations without replacing CLI Root Context truth.
+* 3. Update only binding fields while preserving unrelated YAML fields and comments.
+* 4. Describe a typed launch-write result separately from asynchronous Root Context convergence.
+* 5. Separate CLI-owned Environment Global facts from the file-native editable document owner.
 *
-* OpenSpec uses a structured format for specifications and change proposals:
-* - Spec: A specification document with requirements and scenarios
-* - Change: A change proposal with deltas and tasks
-* - Task: A trackable work item within a change
-*
-* @module schemas
-*/
-/**
-* File metadata for a change directory entry.
-*/
-const ChangeFileSchema = z.object({
-	path: z.string(),
-	type: z.enum(["file", "directory"]),
-	content: z.string().optional(),
-	size: z.number().optional(),
-	mime: z.string().optional(),
-	previewKind: z.enum(FILE_PREVIEW_KINDS).optional()
-});
-const ScenarioStepKeywordSchema = z.enum([
-	"GIVEN",
-	"WHEN",
-	"THEN",
-	"AND",
-	"BUT"
-]);
-const ScenarioStepSchema = z.object({
-	keyword: ScenarioStepKeywordSchema,
-	contentMarkdown: z.string(),
-	rawText: z.string()
-});
-/**
-* A requirement within a specification.
-* Requirements should use RFC 2119 keywords (SHALL, MUST, etc.)
-*/
-const RequirementSchema = z.object({
-	id: z.string(),
-	title: z.string(),
-	bodyMarkdown: z.string(),
-	text: z.string(),
-	scenarios: z.array(z.object({
-		title: z.string(),
-		bodyMarkdown: z.string(),
-		rawText: z.string(),
-		steps: z.array(ScenarioStepSchema).optional()
-	}))
-});
-/**
-* A specification document.
-* Located at: openspec/specs/{id}/spec.md
-*/
-const SpecSchema = z.object({
-	id: z.string(),
-	name: z.string(),
-	overview: z.string(),
-	requirements: z.array(RequirementSchema),
-	metadata: z.object({
-		version: z.string().default("1.0.0"),
-		format: z.literal("openspec").default("openspec"),
-		sourcePath: z.string().optional()
-	}).optional()
-});
-/**
-* A delta describes changes to a spec within a change proposal.
-* Deltas track which specs are affected and how.
-*/
-const DeltaOperationType = z.enum([
-	"ADDED",
-	"MODIFIED",
-	"REMOVED",
-	"RENAMED"
-]);
-const DeltaSchema = z.object({
-	spec: z.string(),
-	operation: DeltaOperationType,
-	description: z.string(),
-	requirement: RequirementSchema.optional(),
-	requirements: z.array(RequirementSchema).optional(),
-	rename: z.object({
-		from: z.string(),
-		to: z.string()
-	}).optional()
-});
-/**
-* A task within a change proposal.
-* Tasks are parsed from tasks.md using checkbox syntax: - [ ] or - [x]
+* Original request (2026-07-15): "Config ownership separates launch-project binding, active-root config, and environment-global config."
+* Original request (2026-07-18): "Profile/Drift must refresh with external environment config changes."
+* Derived requirement (2026-07-19): "Project Binding returns launch-write, root preview, and transition evidence."
 */
-const TaskSchema = z.object({
-	id: z.string(),
-	text: z.string(),
-	completed: z.boolean(),
-	section: z.string().optional()
-});
-/**
-* A delta spec file from changes/{id}/specs/{specId}/spec.md
-* Contains the proposed changes to a spec
-*/
-const DeltaSpecSchema = z.object({
-	specId: z.string(),
-	content: z.string()
-});
-/**
-* A change proposal document.
-* Located at: openspec/changes/{id}/proposal.md + tasks.md
-*
-* Change proposals describe why a change is needed, what will change,
-* which specs are affected (deltas), and trackable tasks.
-*/
-const ChangeSchema = z.object({
-	id: z.string(),
-	name: z.string(),
-	why: z.string(),
-	whatChanges: z.string(),
-	deltas: z.array(DeltaSchema),
-	tasks: z.array(TaskSchema),
-	progress: z.object({
-		total: z.number(),
-		completed: z.number()
-	}),
-	design: z.string().optional(),
-	deltaSpecs: z.array(DeltaSpecSchema).optional(),
-	metadata: z.object({
-		version: z.string().default("1.0.0"),
-		format: z.literal("openspec-change").default("openspec-change")
-	}).optional()
-});
+/** Runtime schema for JSON values accepted by OpenSpec global configuration. */
+const PlanningConfigJsonValueSchema = z.lazy(() => z.union([
+	z.string(),
+	z.number(),
+	z.boolean(),
+	z.null(),
+	z.array(PlanningConfigJsonValueSchema),
+	z.record(z.string(), PlanningConfigJsonValueSchema)
+]));
+/** Runtime schema for the complete environment-global OpenSpec configuration document. */
+const EnvironmentGlobalConfigValueSchema = z.record(z.string(), PlanningConfigJsonValueSchema);
+/** Runtime schema for one project-declared Store Reference entry. */
+const PlanningConfigReferenceSchema = z.object({
+	id: z.string().min(1),
+	remote: z.string().min(1).optional()
+}).strict();
+/** Runtime schema for project binding mutations. */
+const ProjectBindingUpdateSchema = z.object({
+	store: z.string().min(1).nullable().optional(),
+	references: z.array(PlanningConfigReferenceSchema).nullable().optional()
+}).refine((value) => value.store !== void 0 || value.references !== void 0, { message: "At least one Project Binding field is required." });
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function inspectReference(value) {
+	if (typeof value === "string" && value.length > 0) return { id: value };
+	if (!isRecord(value) || typeof value.id !== "string" || value.id.length === 0) return null;
+	if (value.remote === void 0) return { id: value.id };
+	if (typeof value.remote !== "string" || value.remote.length === 0) return null;
+	return {
+		id: value.id,
+		remote: value.remote
+	};
+}
+/** Inspect only launch-project binding declarations; Root Context remains the effective projection. */
+function inspectProjectBinding(content) {
+	const absent = {
+		store: {
+			state: "absent",
+			id: null
+		},
+		references: {
+			state: "absent",
+			entries: []
+		},
+		diagnostics: []
+	};
+	if (content === null || content.trim().length === 0) return absent;
+	const document = parseDocument(content);
+	if (document.errors.length > 0) return {
+		...absent,
+		diagnostics: [{
+			code: "config-unparseable",
+			message: document.errors.map((error) => error.message).join("\n")
+		}]
+	};
+	const raw = document.toJS();
+	if (raw === null) return absent;
+	if (!isRecord(raw)) return {
+		...absent,
+		diagnostics: [{
+			code: "config-not-mapping",
+			message: "OpenSpec config must be a YAML mapping."
+		}]
+	};
+	const diagnostics = [];
+	let store = {
+		state: "absent",
+		id: null
+	};
+	if (raw.store !== void 0) if (typeof raw.store === "string" && raw.store.length > 0) store = {
+		state: "declared",
+		id: raw.store
+	};
+	else {
+		store = {
+			state: "invalid",
+			id: null
+		};
+		diagnostics.push({
+			code: "store-not-string",
+			message: "The store field must be one non-empty Store id string."
+		});
+	}
+	let references = {
+		state: "absent",
+		entries: []
+	};
+	if (raw.references !== void 0) if (!Array.isArray(raw.references)) {
+		references = {
+			state: "invalid",
+			entries: []
+		};
+		diagnostics.push({
+			code: "references-not-array",
+			message: "The references field must be an array of Store declarations."
+		});
+	} else {
+		const entries = [];
+		let invalid = false;
+		for (const value of raw.references) {
+			const reference = inspectReference(value);
+			if (reference) entries.push(reference);
+			else invalid = true;
+		}
+		references = {
+			state: invalid ? "invalid" : "declared",
+			entries
+		};
+		if (invalid) diagnostics.push({
+			code: "reference-entry-invalid",
+			message: "One or more Reference declarations are not a Store id or { id, remote }."
+		});
+	}
+	return {
+		store,
+		references,
+		diagnostics
+	};
+}
+/** Update only `store` and `references`, retaining all unrelated YAML nodes and comments. */
+function updateProjectBindingContent(content, update) {
+	const document = parseDocument(content?.trim() ? content : "{}\n");
+	if (document.errors.length > 0) throw new Error(document.errors.map((error) => error.message).join("\n"));
+	if (document.contents !== null && !isMap(document.contents)) throw new Error("OpenSpec config must be a YAML mapping before Project Binding can be edited.");
+	if (update.store !== void 0) if (update.store === null) document.delete("store");
+	else document.set("store", update.store);
+	if (update.references !== void 0) if (update.references === null) document.delete("references");
+	else document.set("references", update.references.map((reference) => reference.remote === void 0 ? reference.id : reference));
+	return document.toString({ lineWidth: 0 });
+}
 
 //#endregion
 //#region src/watcher.ts
@@ -2327,6 +2668,20 @@ function runBufferedCommand(options) {
 
 //#endregion
 //#region src/config.ts
+/**
+* Orthogonal intents (updated 2026-07-20 Asia/Shanghai):
+* 1. Define and persist project-scoped OpenSpecUI settings.
+* 2. Resolve, diagnose, cache, and explicitly invalidate the OpenSpec CLI runner.
+* 3. Prevent retired in-flight runner resolutions from reclaiming cache ownership.
+* 4. Preserve reactive config reads and serialized config writes.
+*
+* 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.
+*
+* Compromise: configuration schemas and runtime management remain in one historical physical file;
+* splitting that public surface is outside the bounded 6.13 correction.
+*/
 const execAsync = promisify(exec);
 const execFileAsync = promisify(execFile);
 const CLI_PROBE_TIMEOUT_MS = 2e4;
@@ -3078,6 +3433,7 @@ var ConfigManager = class {
 	configPath;
 	projectDir;
 	resolvedRunner = null;
+	resolvedRunnerGeneration = 0;
 	resolvingRunnerPromise = null;
 	writeChain = Promise.resolve();
 	constructor(projectDir) {
@@ -3205,13 +3561,15 @@ var ConfigManager = class {
 	async resolveCliRunner() {
 		if (this.resolvedRunner) return this.resolvedRunner;
 		if (this.resolvingRunnerPromise) return this.resolvingRunnerPromise;
-		this.resolvingRunnerPromise = this.resolveCliRunnerUncached().then((runner) => {
-			this.resolvedRunner = runner;
+		const generation = this.resolvedRunnerGeneration;
+		const resolution = this.resolveCliRunnerUncached().then((runner) => {
+			if (this.resolvedRunnerGeneration === generation && this.resolvingRunnerPromise === resolution) this.resolvedRunner = runner;
 			return runner;
 		}).finally(() => {
-			this.resolvingRunnerPromise = null;
+			if (this.resolvingRunnerPromise === resolution) this.resolvingRunnerPromise = null;
 		});
-		return this.resolvingRunnerPromise;
+		this.resolvingRunnerPromise = resolution;
+		return resolution;
 	}
 	async resolveCliRunnerUncached() {
 		const config = await this.readConfig();
@@ -3244,9 +3602,13 @@ var ConfigManager = class {
 		return this.resolveCliRunner();
 	}
 	/**
-	* 清理 CLI 解析缓存（用于 ENOENT 自愈）
+	* Retire the resolved and in-flight CLI runner generation.
+	*
+	* Existing callers still receive their own resolution result, but a retired resolution cannot
+	* repopulate the shared cache or clear a newer pending owner.
 	*/
 	invalidateResolvedCliRunner() {
+		this.resolvedRunnerGeneration += 1;
 		this.resolvedRunner = null;
 		this.resolvingRunnerPromise = null;
 	}
@@ -3729,8 +4091,61 @@ function buildRuntimePackageInstallCommand(input) {
 	}) ?? null;
 }
 
+//#endregion
+//#region src/cli-stream-child-owner.ts
+/** Internal owner for the direct child of one CLI stream. */
+var CliStreamChildOwner = class {
+	#currentChild = null;
+	#releaseCount = 0;
+	claim(child) {
+		if (this.#currentChild !== null) throw new Error("Cannot claim a second child before releasing the current CLI stream child");
+		this.#currentChild = child;
+		ownersByChild.set(child, this);
+	}
+	owns(child) {
+		return this.#currentChild === child;
+	}
+	release(child) {
+		if (!this.owns(child)) return false;
+		this.#currentChild = null;
+		this.#releaseCount += 1;
+		return true;
+	}
+	get currentChild() {
+		return this.#currentChild;
+	}
+	inspect() {
+		return {
+			currentChild: this.#currentChild,
+			releaseCount: this.#releaseCount
+		};
+	}
+};
+const ownersByChild = /* @__PURE__ */ new WeakMap();
+
 //#endregion
 //#region src/cli-executor.ts
+/** Failure raised when even forced termination cannot confirm child-process close. */
+var CliStreamTerminationError = class extends Error {
+	constructor(command) {
+		super(`CLI stream did not close after forced termination: ${command}`);
+		this.name = "CliStreamTerminationError";
+	}
+};
+const STREAM_TERMINATION_GRACE_MS = 1e3;
+const STREAM_FORCE_CLOSE_TIMEOUT_MS = 1e3;
+function createDeferred() {
+	let resolve$1;
+	let reject;
+	return {
+		promise: new Promise((resolvePromise, rejectPromise) => {
+			resolve$1 = resolvePromise;
+			reject = rejectPromise;
+		}),
+		resolve: resolve$1,
+		reject
+	};
+}
 /**
 * CLI 执行器
 *
@@ -3738,9 +4153,11 @@ function buildRuntimePackageInstallCommand(input) {
 * 所有命令都使用 shell: false，避免 shell 注入风险。
 */
 var CliExecutor = class {
+	contracts;
 	constructor(configManager, projectDir) {
 		this.configManager = configManager;
 		this.projectDir = projectDir;
+		this.contracts = new OpenSpecCliContractExecutor((args) => this.execute(args));
 	}
 	async buildCommandArray(args) {
 		return [...await this.configManager.getCliCommand(), ...args];
@@ -3828,8 +4245,8 @@ var CliExecutor = class {
 	*/
 	async validate(type, id) {
 		const args = ["validate"];
-		if (type) args.push(type);
 		if (id) args.push(id);
+		if (type) args.push("--type", type);
 		return this.execute(args);
 	}
 	/**
@@ -3858,37 +4275,14 @@ var CliExecutor = class {
 		return this.execute(args);
 	}
 	/**
-	* 执行 openspec store list --json
-	*
-	* Beta 功能（Stores）。返回原始 CliResult；数据归类（ok / 异常一数据不兼容 /
-	* 异常二指令变更）由调用方用 classifyStoreCliOutput 完成。这样 CliExecutor 保持单一职责。
-	* Spec: openspec-cli-integration › Stores CLI Query Mapping / Beta Feature Fault Tolerance。
-	*/
-	async listStores() {
-		return this.execute([
-			"store",
-			"list",
-			"--json"
-		]);
-	}
-	/**
-	* 执行 openspec store doctor [--json] [id]
-	*
-	* Beta 功能（Stores）。同 listStores，归类交给调用方。
-	*/
-	async doctorStores(id) {
-		const args = ["store", "doctor"];
-		if (id) args.push(id);
-		args.push("--json");
-		return this.execute(args);
-	}
-	/**
 	* 流式执行 openspec validate
 	*/
-	validateStream(type, id, onEvent) {
+	validateStream(options, onEvent) {
 		const args = ["validate"];
-		if (type) args.push(type);
-		if (id) args.push(id);
+		if (options.id) args.push(options.id);
+		if (options.type) args.push("--type", options.type);
+		if (options.strict) args.push("--strict");
+		if (options.store !== void 0) args.push("--store", options.store);
 		return this.executeStream(args, onEvent);
 	}
 	/**
@@ -3920,28 +4314,78 @@ var CliExecutor = class {
 	/**
 	* 流式执行 CLI 命令
 	*/
-	async executeStream(args, onEvent) {
-		let cancelled = false;
-		let activeChild = null;
+	executeStream(args, onEvent) {
+		return this.createStreamHandle(async () => this.buildCommandArray(args), onEvent, () => this.configManager.invalidateResolvedCliRunner());
+	}
+	createStreamHandle(resolveCommand, onEvent, retryRunner) {
+		const settlement = createDeferred();
+		let settled = false;
+		let cancelRequested = false;
+		let terminationStarted = false;
+		const childOwner = new CliStreamChildOwner();
+		let activeCommand = "CLI command";
+		let terminationTimer = null;
+		let forceCloseTimer = null;
+		const clearTerminationTimers = () => {
+			if (terminationTimer) clearTimeout(terminationTimer);
+			if (forceCloseTimer) clearTimeout(forceCloseTimer);
+			terminationTimer = null;
+			forceCloseTimer = null;
+		};
+		const settle = (value) => {
+			if (settled) return;
+			settled = true;
+			clearTerminationTimers();
+			onEvent({
+				type: "exit",
+				exitCode: value.exitCode
+			});
+			settlement.resolve(value);
+		};
+		const failTermination = () => {
+			if (settled) return;
+			settled = true;
+			clearTerminationTimers();
+			settlement.reject(new CliStreamTerminationError(activeCommand));
+		};
+		const requestChildTermination = (child) => {
+			if (terminationStarted || settled) return;
+			terminationStarted = true;
+			try {
+				child.kill("SIGTERM");
+			} catch {}
+			terminationTimer = setTimeout(() => {
+				if (settled || !childOwner.owns(child)) return;
+				try {
+					child.kill("SIGKILL");
+				} catch {}
+				forceCloseTimer = setTimeout(() => {
+					if (!settled && childOwner.owns(child)) failTermination();
+				}, STREAM_FORCE_CLOSE_TIMEOUT_MS);
+			}, STREAM_TERMINATION_GRACE_MS);
+		};
 		const start = async (allowRetry) => {
-			if (cancelled) return;
+			if (cancelRequested || settled) return;
 			let fullCommand;
 			try {
-				fullCommand = await this.buildCommandArray(args);
+				fullCommand = await resolveCommand();
 			} catch (err) {
+				if (cancelRequested || settled) return;
 				onEvent({
 					type: "stderr",
 					data: err instanceof Error ? err.message : String(err)
 				});
-				onEvent({
-					type: "exit",
+				settle({
+					reason: "startup-failed",
 					exitCode: null
 				});
 				return;
 			}
+			if (cancelRequested || settled) return;
+			activeCommand = fullCommand.join(" ");
 			onEvent({
 				type: "command",
-				data: fullCommand.join(" ")
+				data: activeCommand
 			});
 			const [cmd, ...cmdArgs] = fullCommand;
 			const started = spawnSafe(cmd, cmdArgs, {
@@ -3951,8 +4395,8 @@ var CliExecutor = class {
 			});
 			if (!started.ok) {
 				const { code, message } = started.error;
-				if (allowRetry && code === "ENOENT" && !cancelled) {
-					this.configManager.invalidateResolvedCliRunner();
+				if (allowRetry && code === "ENOENT" && !cancelRequested && retryRunner) {
+					retryRunner();
 					start(false);
 					return;
 				}
@@ -3960,14 +4404,18 @@ var CliExecutor = class {
 					type: "stderr",
 					data: message
 				});
-				onEvent({
-					type: "exit",
+				settle({
+					reason: "startup-failed",
 					exitCode: null
 				});
 				return;
 			}
 			const child = started.child;
-			activeChild = child;
+			childOwner.claim(child);
+			let childSpawned = false;
+			child.once("spawn", () => {
+				childSpawned = true;
+			});
 			child.stdout?.on("data", (data) => {
 				onEvent({
 					type: "stdout",
@@ -3981,19 +4429,26 @@ var CliExecutor = class {
 				});
 			});
 			child.on("close", (exitCode) => {
-				if (activeChild !== child) return;
-				activeChild = null;
-				onEvent({
-					type: "exit",
+				if (!childOwner.owns(child)) return;
+				childOwner.release(child);
+				settle({
+					reason: cancelRequested ? "cancelled" : "exited",
 					exitCode
 				});
 			});
 			child.on("error", (err) => {
-				if (activeChild !== child) return;
-				activeChild = null;
+				if (!childOwner.owns(child)) return;
 				const { code, message } = formatSpawnError(err);
-				if (allowRetry && code === "ENOENT" && !cancelled) {
-					this.configManager.invalidateResolvedCliRunner();
+				if (childSpawned) {
+					onEvent({
+						type: "stderr",
+						data: message
+					});
+					return;
+				}
+				childOwner.release(child);
+				if (allowRetry && code === "ENOENT" && !cancelRequested && retryRunner) {
+					retryRunner();
 					start(false);
 					return;
 				}
@@ -4001,18 +4456,29 @@ var CliExecutor = class {
 					type: "stderr",
 					data: message
 				});
-				onEvent({
-					type: "exit",
+				settle({
+					reason: cancelRequested ? "cancelled" : "startup-failed",
 					exitCode: null
 				});
 			});
 		};
-		await start(true);
-		return () => {
-			cancelled = true;
-			activeChild?.kill();
-			activeChild = null;
+		start(true);
+		const handle = {
+			settled: settlement.promise,
+			cancel: () => {
+				if (cancelRequested || settled) return settlement.promise;
+				cancelRequested = true;
+				const child = childOwner.currentChild;
+				if (child) requestChildTermination(child);
+				else settle({
+					reason: "cancelled",
+					exitCode: null
+				});
+				return settlement.promise;
+			}
 		};
+		settlement.promise.catch(() => {});
+		return handle;
 	}
 	/**
 	* 流式执行 openspec init
@@ -4038,6 +4504,7 @@ var CliExecutor = class {
 		];
 		if (options.skipSpecs) args.push("--skip-specs");
 		if (options.noValidate) args.push("--no-validate");
+		if (options.store !== void 0) args.push("--store", options.store);
 		return this.executeStream(args, onEvent);
 	}
 	/**
@@ -4048,89 +4515,421 @@ var CliExecutor = class {
 	*/
 	executeCommandStream(command, onEvent) {
 		const [cmd, ...cmdArgs] = command;
-		if (cmd === "openspec") {
-			let cancelResolved = null;
-			let cancelled = false;
-			this.executeStream([...cmdArgs], onEvent).then((cancel) => {
-				if (cancelled) {
-					cancel();
-					return;
-				}
-				cancelResolved = cancel;
-			}).catch((err) => {
-				onEvent({
-					type: "stderr",
-					data: err instanceof Error ? err.message : String(err)
-				});
-				onEvent({
-					type: "exit",
-					exitCode: null
-				});
-			});
-			return () => {
-				cancelled = true;
-				cancelResolved?.();
-			};
+		if (cmd === "openspec") return this.executeStream([...cmdArgs], onEvent);
+		return this.createStreamHandle(() => [cmd, ...cmdArgs], onEvent);
+	}
+};
+
+//#endregion
+//#region src/runtime-invalidation.ts
+/**
+* Orthogonal intents (created 2026-07-16 Asia/Shanghai):
+* 1. Define runtime invalidation facet identity without carrying projected domain data.
+* 2. Expose monotonic generations as ReactiveContext dependencies.
+* 3. Coalesce direct-listener pushes per facet while generations advance synchronously.
+*
+* Original request (2026-07-15): "Push 通知变更，然后让多端基于订阅拉取更新。"
+*/
+/** Complete runtime projection facet vocabulary. */
+const RUNTIME_INVALIDATION_FACETS = [
+	"project",
+	"stores",
+	"worksets",
+	"schemas",
+	"context"
+];
+/** Environment-local invalidation identity. Authoritative data stays in CLI-backed projections. */
+var RuntimeInvalidationIndex = class {
+	generations = /* @__PURE__ */ new Map();
+	states = /* @__PURE__ */ new Map();
+	listeners = /* @__PURE__ */ new Set();
+	pendingNotifications = /* @__PURE__ */ new Map();
+	notificationScheduled = false;
+	constructor() {
+		for (const facet of RUNTIME_INVALIDATION_FACETS) {
+			this.generations.set(facet, 0);
+			this.states.set(facet, new ReactiveState(0));
 		}
-		onEvent({
-			type: "command",
-			data: command.join(" ")
-		});
-		const started = spawnSafe(cmd, cmdArgs, {
-			cwd: this.projectDir,
-			shell: false,
-			env: createCleanCliEnv()
+	}
+	current(facet) {
+		return this.generations.get(facet) ?? 0;
+	}
+	track(...facets) {
+		return facets.map((facet) => ({
+			facet,
+			generation: this.states.get(facet)?.get() ?? 0
+		}));
+	}
+	invalidate(facets) {
+		const tokens = [...new Set(facets)].map((facet) => {
+			const generation = this.current(facet) + 1;
+			this.generations.set(facet, generation);
+			this.states.get(facet)?.set(generation);
+			return {
+				facet,
+				generation
+			};
 		});
-		if (!started.ok) {
-			onEvent({
-				type: "stderr",
-				data: started.error.message
-			});
-			onEvent({
-				type: "exit",
-				exitCode: null
-			});
-			return () => {};
+		this.enqueueNotifications(tokens);
+		return tokens;
+	}
+	enqueueNotifications(tokens) {
+		for (const record of this.listeners) {
+			let pending = this.pendingNotifications.get(record);
+			for (const token of tokens) {
+				if (!record.facets.has(token.facet)) continue;
+				pending ??= /* @__PURE__ */ new Map();
+				pending.set(token.facet, token);
+			}
+			if (pending) this.pendingNotifications.set(record, pending);
 		}
-		const child = started.child;
-		child.stdout?.on("data", (data) => {
-			onEvent({
-				type: "stdout",
-				data: data.toString()
-			});
-		});
-		child.stderr?.on("data", (data) => {
-			onEvent({
-				type: "stderr",
-				data: data.toString()
+		if (this.pendingNotifications.size === 0 || this.notificationScheduled) return;
+		this.notificationScheduled = true;
+		queueMicrotask(() => this.flushNotifications());
+	}
+	flushNotifications() {
+		const notifications = this.pendingNotifications;
+		this.pendingNotifications = /* @__PURE__ */ new Map();
+		this.notificationScheduled = false;
+		for (const [record, pending] of notifications) {
+			if (!this.listeners.has(record)) continue;
+			const tokens = RUNTIME_INVALIDATION_FACETS.flatMap((facet) => {
+				const token = pending.get(facet);
+				return token ? [token] : [];
 			});
-		});
-		child.on("close", (exitCode) => {
-			onEvent({
-				type: "exit",
-				exitCode
+			if (tokens.length === 0) continue;
+			try {
+				record.listener(tokens);
+			} catch (error) {
+				console.error("Runtime invalidation listener failed:", error);
+			}
+		}
+	}
+	subscribe(facets, listener) {
+		const record = {
+			facets: new Set(facets),
+			listener
+		};
+		this.listeners.add(record);
+		return () => {
+			this.listeners.delete(record);
+			this.pendingNotifications.delete(record);
+		};
+	}
+};
+
+//#endregion
+//#region src/open-spec-data-home-observer.ts
+/**
+* Orthogonal intents (updated 2026-07-28 Asia/Shanghai):
+* 1. Own the effective OpenSpec data-home observation lease for one runtime environment.
+* 2. Map registry, Workset, and schema paths to their objective invalidation facets.
+* 3. Keep Store, Workset, schema, and Context projections responsible for fresh pulls.
+* 4. Release the path subscription and root lease deterministically.
+* 5. Settle initially missing official targets from bounded ancestor creation without invalidating unrelated content.
+*
+* Original request (2026-07-15): "有效 OpenSpec data home 的变化要让所有端拉取最新投影。"
+* Original request (2026-07-26): "真正基于文件、甚至是文件内容结构的变更去拉取更新。"
+* Remote CI fixed point (2026-07-28): data-home Schema creation may arrive as an ancestor event on Linux.
+*/
+/** Official OpenSpec 1.6 data-home paths and the projections whose inputs they can change. */
+const OPEN_SPEC_DATA_HOME_OBSERVATION_TARGETS = [
+	{
+		relativePath: "stores/registry.yaml",
+		recursive: false,
+		facets: ["stores", "context"]
+	},
+	{
+		relativePath: "worksets",
+		recursive: true,
+		facets: ["worksets"]
+	},
+	{
+		relativePath: "schemas",
+		recursive: true,
+		facets: ["schemas", "context"]
+	}
+];
+/** Observe one effective OpenSpec data home without parsing or owning its domain data. */
+var OpenSpecDataHomeObserver = class {
+	dataHomePath;
+	environment;
+	invalidation;
+	startPromise = null;
+	releasePathSubscriptions = [];
+	releaseRoot = null;
+	disposed = false;
+	state = "idle";
+	constructor(options) {
+		this.dataHomePath = options.dataHomePath;
+		this.environment = options.environment;
+		this.invalidation = options.invalidation;
+	}
+	start() {
+		if (this.disposed) return Promise.reject(/* @__PURE__ */ new Error("Cannot start data-home observation after teardown."));
+		if (this.startPromise) return this.startPromise;
+		this.state = "starting";
+		this.releasePathSubscriptions = OPEN_SPEC_DATA_HOME_OBSERVATION_TARGETS.map((target) => {
+			const targetPath = join$1(this.dataHomePath, target.relativePath);
+			let wasPresent = existsSync(targetPath);
+			return acquireWatcher(targetPath, () => {
+				const isPresent = existsSync(targetPath);
+				if (wasPresent || isPresent) this.invalidation.invalidate(target.facets);
+				wasPresent = isPresent;
+			}, {
+				recursive: target.recursive,
+				watchAncestorsWhileMissing: true
 			});
 		});
-		child.on("error", (err) => {
-			const { message } = formatSpawnError(err);
-			onEvent({
-				type: "stderr",
-				data: message
-			});
-			onEvent({
-				type: "exit",
-				exitCode: null
-			});
+		const startPromise = this.environment.acquireRoot(this.dataHomePath).then(async (releaseRoot) => {
+			if (this.disposed) {
+				await releaseRoot();
+				return;
+			}
+			this.releaseRoot = releaseRoot;
+			this.state = "active";
+		}).catch((error) => {
+			this.releasePathSubscriptions.forEach((release) => release());
+			this.releasePathSubscriptions = [];
+			if (!this.disposed) this.state = "failed";
+			if (this.startPromise === startPromise) this.startPromise = null;
+			throw error;
 		});
+		this.startPromise = startPromise;
+		return this.startPromise;
+	}
+	/** Current lease state used by the bounded watcher-failure fallback. */
+	getState() {
+		return this.state;
+	}
+	async dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		this.state = "disposed";
+		this.releasePathSubscriptions.forEach((release) => release());
+		this.releasePathSubscriptions = [];
+		await this.startPromise?.catch(() => {});
+		const releaseRoot = this.releaseRoot;
+		this.releaseRoot = null;
+		await releaseRoot?.();
+	}
+};
+
+//#endregion
+//#region src/open-spec-data-scope.ts
+/**
+* Orthogonal intents (created 2026-07-16 Asia/Shanghai):
+* 1. Project the inherited OpenSpec user-data root without introducing project overrides.
+* 2. Match OpenSpec 1.6 XDG and platform fallback rules exactly.
+* 3. Preserve the environment source as read-only diagnostic evidence.
+*
+* Original request (2026-07-15): "OpenSpecUI inherits the launch environment's XDG_DATA_HOME."
+*/
+/** Directory name appended to the selected platform user-data root. */
+const OPEN_SPEC_DATA_DIRECTORY_NAME = "openspec";
+function joinPlatformPath(platform$1, ...segments) {
+	return platform$1 === "win32" ? win32.join(...segments) : posix.join(...segments);
+}
+/** Resolve the read-only data-scope diagnostic using OpenSpec 1.6's platform rules. */
+function resolveOpenSpecDataScope(options = {}) {
+	const env = options.env ?? process.env;
+	const platform$1 = options.platform ?? platform();
+	const homedir$1 = options.homedir ?? homedir();
+	if (env.XDG_DATA_HOME) return {
+		path: joinPlatformPath(platform$1, env.XDG_DATA_HOME, OPEN_SPEC_DATA_DIRECTORY_NAME),
+		source: "xdg-data-home",
+		environmentVariable: "XDG_DATA_HOME"
+	};
+	if (platform$1 === "win32" && env.LOCALAPPDATA) return {
+		path: joinPlatformPath(platform$1, env.LOCALAPPDATA, OPEN_SPEC_DATA_DIRECTORY_NAME),
+		source: "local-app-data",
+		environmentVariable: "LOCALAPPDATA"
+	};
+	return {
+		path: platform$1 === "win32" ? joinPlatformPath(platform$1, homedir$1, "AppData", "Local", OPEN_SPEC_DATA_DIRECTORY_NAME) : joinPlatformPath(platform$1, homedir$1, ".local", "share", OPEN_SPEC_DATA_DIRECTORY_NAME),
+		source: "user-home-default",
+		environmentVariable: null
+	};
+}
+
+//#endregion
+//#region src/root-context.ts
+/** Derive the only CLI selector that preserves an already resolved Root Context. */
+function getRootContextCliSelector(rootContext) {
+	const planningRoot = rootContext.planningRoot;
+	if (!planningRoot) throw new Error("Cannot derive a CLI selector without a resolved planning root.");
+	if (planningRoot.source !== "store") return {};
+	if (!rootContext.storeId) throw new Error("OpenSpec reported an explicit Store root without a Store id.");
+	return { store: rootContext.storeId };
+}
+function commandMessage(evidence, fallback) {
+	return evidence.contractError || evidence.stderr.trim() || evidence.diagnostics.map((diagnostic) => diagnostic.message).join("\n") || fallback;
+}
+function publicCommandEvidence(evidence) {
+	if (!evidence) return null;
+	return {
+		success: evidence.success,
+		stdout: evidence.stdout,
+		stderr: evidence.stderr,
+		exitCode: evidence.exitCode,
+		diagnostics: evidence.diagnostics,
+		...evidence.contractError ? { contractError: evidence.contractError } : {}
+	};
+}
+function createRootContext(options, cli, doctor, context, observedAt) {
+	const doctorData = doctor?.data ?? null;
+	const contextData = context?.data ?? null;
+	const planningRoot = doctorData?.root ?? null;
+	return {
+		launchProject: { path: options.launchProjectDir },
+		planningRoot,
+		storeId: planningRoot?.store_id ?? doctorData?.store?.id ?? null,
+		cli,
+		references: doctorData?.references ?? [],
+		contextMembers: contextData?.members ?? [],
+		dataScope: resolveOpenSpecDataScope(options),
+		diagnostics: {
+			root: planningRoot?.status ?? [],
+			doctor: doctorData?.status ?? doctor?.diagnostics ?? [],
+			context: contextData?.status ?? context?.diagnostics ?? []
+		},
+		evidence: {
+			doctor: publicCommandEvidence(doctor),
+			context: publicCommandEvidence(context)
+		},
+		observedAt
+	};
+}
+function errorState(attempt, code, message) {
+	return {
+		state: "error",
+		data: null,
+		attempt,
+		error: {
+			code,
+			message
+		},
+		observedAt: attempt.observedAt
+	};
+}
+function rootsMatch(doctor, context) {
+	return doctor.path === context.path && doctor.source === context.source && (doctor.store_id === void 0 || context.store_id === void 0 || doctor.store_id === context.store_id);
+}
+function classifyRootContext(attempt, doctor, context) {
+	const { cli, planningRoot, references } = attempt;
+	if (!cli.available) return errorState(attempt, "cli-unavailable", cli.error ?? "OpenSpec CLI is unavailable.");
+	if (!doctor) return errorState(attempt, "resolver-failed", "OpenSpec Doctor did not return command evidence.");
+	if (doctor.contractError) return errorState(attempt, "doctor-contract-drift", commandMessage(doctor, "OpenSpec Doctor returned an incompatible payload."));
+	if (!doctor.success) return errorState(attempt, "doctor-command-failed", commandMessage(doctor, "OpenSpec Doctor failed."));
+	if (!planningRoot) return errorState(attempt, "root-unresolved", "OpenSpec Doctor did not resolve a planning root.");
+	if (!planningRoot.healthy) return errorState(attempt, "root-unhealthy", planningRoot.status.map((diagnostic) => diagnostic.message).join("\n") || "OpenSpec Doctor reported an unhealthy planning root.");
+	if (!context) return errorState(attempt, "resolver-failed", "OpenSpec Context did not return command evidence.");
+	if (context.contractError) return errorState(attempt, "context-contract-drift", commandMessage(context, "OpenSpec Context returned an incompatible payload."));
+	if (!context.success) return errorState(attempt, "context-command-failed", commandMessage(context, "OpenSpec Context failed."));
+	if (!context.data?.root || !rootsMatch(planningRoot, context.data.root)) return errorState(attempt, "context-root-mismatch", "OpenSpec Doctor and Context did not report the same planning root.");
+	const failedReference = references.flatMap((reference) => reference.status).find((diagnostic) => diagnostic.severity === "error");
+	if (failedReference) return errorState(attempt, "references-unresolved", failedReference.message);
+	return {
+		state: "ready",
+		data: attempt,
+		attempt: null,
+		error: null,
+		observedAt: attempt.observedAt
+	};
+}
+function unavailableCli(error) {
+	return {
+		available: false,
+		error: error instanceof Error ? error.message : String(error)
+	};
+}
+/** Resolve one current Root Context attempt from official CLI projections and process scope. */
+async function resolveRootContext(options) {
+	const observedAt = options.now?.() ?? Date.now();
+	let cli;
+	try {
+		cli = await options.cliExecutor.checkAvailability();
+	} catch (error) {
+		cli = unavailableCli(error);
+	}
+	if (!cli.available) return classifyRootContext(createRootContext(options, cli, null, null, observedAt), null, null);
+	const selector = {};
+	const [doctorSettled, contextSettled] = await Promise.allSettled([options.cliExecutor.contracts.doctorRoot(selector), options.cliExecutor.contracts.context(selector)]);
+	const doctor = doctorSettled.status === "fulfilled" ? doctorSettled.value : null;
+	const context = contextSettled.status === "fulfilled" ? contextSettled.value : null;
+	const attempt = createRootContext(options, cli, doctor, context, observedAt);
+	if (doctorSettled.status === "rejected" || contextSettled.status === "rejected") {
+		let failure;
+		if (doctorSettled.status === "rejected") failure = doctorSettled.reason;
+		else if (contextSettled.status === "rejected") failure = contextSettled.reason;
+		return errorState(attempt, "resolver-failed", failure instanceof Error ? failure.message : String(failure));
+	}
+	return classifyRootContext(attempt, doctor, context);
+}
+
+//#endregion
+//#region src/runtime-root-invalidation.ts
+/**
+* Orthogonal intents (created 2026-07-16 Asia/Shanghai):
+* 1. Map dynamic filesystem roots to selected runtime invalidation facets.
+* 2. Share one recursive path subscription for repeated normalized roots.
+* 3. Release root subscriptions after their final logical owner or registry teardown.
+*
+* Original request (2026-07-15): "Launch-project and connected planning-root changes invalidate their project/context facets."
+*/
+/** Reference-counted path-to-facet mapping; physical watcher roots remain separately owned. */
+var RuntimeRootInvalidationRegistry = class {
+	records = /* @__PURE__ */ new Map();
+	constructor(invalidation, facets) {
+		this.invalidation = invalidation;
+		this.facets = facets;
+	}
+	acquireRoot(rootPath) {
+		const normalizedRoot = resolveRealPathThroughExistingAncestor(rootPath);
+		let record = this.records.get(normalizedRoot);
+		if (!record) {
+			record = {
+				rootPath: normalizedRoot,
+				referenceCount: 0,
+				releasePath: acquireWatcher(normalizedRoot, () => this.invalidation.invalidate(this.facets), { recursive: true })
+			};
+			this.records.set(normalizedRoot, record);
+		}
+		record.referenceCount += 1;
+		let released = false;
 		return () => {
-			child.kill();
+			if (released) return;
+			released = true;
+			const current = this.records.get(normalizedRoot);
+			if (current !== record || current.referenceCount === 0) return;
+			current.referenceCount -= 1;
+			if (current.referenceCount > 0) return;
+			current.releasePath();
+			this.records.delete(normalizedRoot);
 		};
 	}
+	getRoots() {
+		return [...this.records.values()].map(({ rootPath, referenceCount }) => ({
+			rootPath,
+			referenceCount
+		})).sort((left, right) => left.rootPath.localeCompare(right.rootPath));
+	}
+	dispose() {
+		const records = [...this.records.values()];
+		this.records.clear();
+		for (const record of records) record.releasePath();
+	}
 };
 
 //#endregion
 //#region src/tool-config.ts
 /**
+* Orthogonal intents (updated 2026-07-15 Asia/Shanghai):
+* 1. Mirror official OpenSpec AI tool metadata and generated skill names.
+* 2. Detect configured project-local AI tool roots reactively.
+*
+* Original request (2026-07-15): "Oh My Pi、Trae 的完整交付链。"
+*
 * 工具配置检测模块
 *
 * 对齐 @fission-ai/openspec 的 skills 体系，
@@ -4145,6 +4944,7 @@ const SKILL_NAMES = [
 	"openspec-new-change",
 	"openspec-continue-change",
 	"openspec-apply-change",
+	"openspec-update-change",
 	"openspec-ff-change",
 	"openspec-sync-specs",
 	"openspec-archive-change",
@@ -4314,6 +5114,27 @@ const AI_TOOLS = [
 		successLabel: "Kiro",
 		skillsDir: ".kiro"
 	},
+	{
+		name: "Lingma",
+		value: "lingma",
+		available: true,
+		successLabel: "Lingma",
+		skillsDir: ".lingma"
+	},
+	{
+		name: "Mistral Vibe",
+		value: "vibe",
+		available: true,
+		successLabel: "Mistral Vibe",
+		skillsDir: ".vibe"
+	},
+	{
+		name: "Oh My Pi",
+		value: "oh-my-pi",
+		available: true,
+		successLabel: "Oh My Pi",
+		skillsDir: ".omp"
+	},
 	{
 		name: "OpenCode",
 		value: "opencode",
@@ -4335,20 +5156,6 @@ const AI_TOOLS = [
 		successLabel: "Qoder",
 		skillsDir: ".qoder"
 	},
-	{
-		name: "Lingma",
-		value: "lingma",
-		available: true,
-		successLabel: "Lingma",
-		skillsDir: ".lingma"
-	},
-	{
-		name: "Mistral Vibe",
-		value: "vibe",
-		available: true,
-		successLabel: "Mistral Vibe",
-		skillsDir: ".vibe"
-	},
 	{
 		name: "Qwen Code",
 		value: "qwen",
@@ -4491,22 +5298,23 @@ async function isToolConfigured(projectDir, toolId) {
 
 //#endregion
 //#region src/tool-init-state.ts
-const TOOL_WORKFLOW_TO_SKILL_DIR = {
-	propose: "openspec-propose",
-	explore: "openspec-explore",
-	new: "openspec-new-change",
-	continue: "openspec-continue-change",
-	apply: "openspec-apply-change",
-	ff: "openspec-ff-change",
-	sync: "openspec-sync-specs",
-	archive: "openspec-archive-change",
-	"bulk-archive": "openspec-bulk-archive-change",
-	verify: "openspec-verify-change",
-	onboard: "openspec-onboard"
-};
-const ALL_TOOL_WORKFLOWS = Object.keys(TOOL_WORKFLOW_TO_SKILL_DIR);
+/**
+* Orthogonal intents (updated 2026-07-28 Asia/Shanghai):
+* 1. Map official OPSX workflows to generated skill and command locations.
+* 2. Project launch-local skills and physically scoped tool command initialization state.
+* 3. Provide the runtime owner with the same external Codex command root used by command projection.
+* 4. Bound reactive observation through existing parent inventories while preserving fresh one-shot reads.
+*
+* Original request (2026-07-15): "sync、update、Oh My Pi、Trae 的完整交付链。"
+* Remote CI fixed point (2026-07-28): Launch-local skill creation must converge when its tool root was absent at initial projection.
+*/
+/** Return the external runtime directory containing official Codex command prompts. */
+function getExternalCodexCommandObservationRoot() {
+	return join$1(resolveCodexHome(), "prompts");
+}
+const ALL_TOOL_WORKFLOWS = [...OPSX_ALL_WORKFLOWS];
 function toKnownWorkflows(workflows) {
-	return workflows.filter((workflow) => workflow in TOOL_WORKFLOW_TO_SKILL_DIR);
+	return workflows.filter((workflow) => workflow in OPSX_WORKFLOW_TO_SKILL_DIR);
 }
 function resolveCodexHome() {
 	const configuredHome = process.env.CODEX_HOME?.trim();
@@ -4537,10 +5345,12 @@ const TOOL_COMMAND_PATHS = {
 		primary: (projectDir, workflow) => resolve(projectDir, ".opencode", "commands", `opsx-${workflow}.md`),
 		legacy: [(projectDir, workflow) => resolve(projectDir, ".opencode", "command", `opsx-${workflow}.md`)]
 	},
+	"oh-my-pi": { primary: (projectDir, workflow) => resolve(projectDir, ".omp", "commands", `opsx-${workflow}.md`) },
 	pi: { primary: (projectDir, workflow) => resolve(projectDir, ".pi", "prompts", `opsx-${workflow}.md`) },
 	qoder: { primary: (projectDir, workflow) => resolve(projectDir, ".qoder", "commands", "opsx", `${workflow}.md`) },
 	qwen: { primary: (projectDir, workflow) => resolve(projectDir, ".qwen", "commands", `opsx-${workflow}.toml`) },
 	roocode: { primary: (projectDir, workflow) => resolve(projectDir, ".roo", "commands", `opsx-${workflow}.md`) },
+	trae: { primary: (projectDir, workflow) => resolve(projectDir, ".trae", "commands", `opsx-${workflow}.md`) },
 	windsurf: { primary: (projectDir, workflow) => resolve(projectDir, ".windsurf", "workflows", `opsx-${workflow}.md`) }
 };
 function resolveToolCommandArtifact(projectDir, toolId, workflow) {
@@ -4555,7 +5365,7 @@ function resolveToolCommandArtifact(projectDir, toolId, workflow) {
 function getSkillArtifacts(projectDir, skillsDir) {
 	return ALL_TOOL_WORKFLOWS.map((workflow) => ({
 		workflow,
-		path: resolve(projectDir, skillsDir, "skills", TOOL_WORKFLOW_TO_SKILL_DIR[workflow], "SKILL.md")
+		path: resolve(projectDir, skillsDir, "skills", OPSX_WORKFLOW_TO_SKILL_DIR[workflow], "SKILL.md")
 	}));
 }
 function getCommandArtifacts(projectDir, toolId) {
@@ -4565,7 +5375,7 @@ function getCommandArtifacts(projectDir, toolId) {
 	});
 }
 function invalidateToolInitCaches(projectDir) {
-	const cacheRoots = /* @__PURE__ */ new Set();
+	const cacheRoots = new Set([resolve(projectDir)]);
 	for (const tool of AI_TOOLS) {
 		if (tool.skillsDir) cacheRoots.add(resolve(projectDir, tool.skillsDir));
 		for (const commandArtifact of getCommandArtifacts(projectDir, tool.value)) {
@@ -4575,13 +5385,34 @@ function invalidateToolInitCaches(projectDir) {
 	}
 	for (const root of cacheRoots) clearCache(root);
 }
-async function getExistingArtifactPaths(entries) {
-	const paths = entries.flatMap((entry) => [entry.path, ...entry.legacyPaths ?? []]);
-	const presence = await Promise.all(paths.map(async (path) => ({
-		path,
-		exists: await reactiveExists(path)
+async function readArtifactDirectory(dir) {
+	return new Set(await reactiveReadDir(dir, { includeHidden: true }));
+}
+async function getExistingSkillPaths(projectDir, skillsDir, entries, projectRootEntries) {
+	const toolRoot = resolve(projectDir, skillsDir);
+	if (!projectRootEntries.has(basename(toolRoot))) return /* @__PURE__ */ new Set();
+	if (!(await readArtifactDirectory(toolRoot)).has("skills")) return /* @__PURE__ */ new Set();
+	const rootEntries = await readArtifactDirectory(resolve(toolRoot, "skills"));
+	const presentEntries = entries.filter((entry) => rootEntries.has(basename(dirname$1(entry.path))));
+	const directoryEntries = await Promise.all(presentEntries.map(async (entry) => ({
+		entry,
+		files: await readArtifactDirectory(dirname$1(entry.path))
+	})));
+	return new Set(directoryEntries.filter(({ entry, files }) => files.has(basename(entry.path))).map(({ entry }) => entry.path));
+}
+async function getExistingCommandPaths(entries) {
+	const pathsByDirectory = /* @__PURE__ */ new Map();
+	for (const entry of entries) for (const path of [entry.path, ...entry.legacyPaths ?? []]) {
+		const directory = dirname$1(path);
+		const paths = pathsByDirectory.get(directory) ?? [];
+		paths.push(path);
+		pathsByDirectory.set(directory, paths);
+	}
+	const directoryEntries = await Promise.all([...pathsByDirectory].map(async ([directory, paths]) => ({
+		paths,
+		files: await readArtifactDirectory(directory)
 	})));
-	return new Set(presence.filter((entry) => entry.exists).map((entry) => entry.path));
+	return new Set(directoryEntries.flatMap(({ paths, files }) => paths.filter((path) => files.has(basename(path)))));
 }
 function hasExistingArtifact(entry, existingPaths) {
 	return existingPaths.has(entry.path) || (entry.legacyPaths?.some((legacyPath) => existingPaths.has(legacyPath)) ?? false);
@@ -4601,17 +5432,17 @@ function collectUnexpectedWorkflows(entries, desiredWorkflowSet, existingPaths)
 function collectLegacyWorkflows(entries, existingPaths) {
 	return entries.filter((entry) => hasLegacyArtifact(entry, existingPaths)).map((entry) => entry.workflow);
 }
-async function getToolInitStates(projectDir, options) {
-	invalidateToolInitCaches(projectDir);
+async function projectToolInitStates(projectDir, options) {
 	const desiredWorkflows = toKnownWorkflows(options.workflows);
 	const desiredWorkflowSet = new Set(desiredWorkflows);
 	const shouldGenerateSkills = options.delivery !== "commands";
 	const shouldGenerateCommands = options.delivery !== "skills";
+	const projectRootEntries = await readArtifactDirectory(projectDir);
 	return Promise.all(AI_TOOLS.filter((tool) => tool.skillsDir).map(async (tool) => {
 		const skillArtifacts = getSkillArtifacts(projectDir, tool.skillsDir);
 		const commandArtifacts = getCommandArtifacts(projectDir, tool.value);
-		const existingSkillPaths = await getExistingArtifactPaths(skillArtifacts);
-		const existingCommandPaths = await getExistingArtifactPaths(commandArtifacts);
+		const existingSkillPaths = await getExistingSkillPaths(projectDir, tool.skillsDir, skillArtifacts, projectRootEntries);
+		const existingCommandPaths = await getExistingCommandPaths(commandArtifacts);
 		const expectedSkillArtifacts = shouldGenerateSkills ? skillArtifacts.filter((entry) => desiredWorkflowSet.has(entry.workflow)) : [];
 		const expectedCommandArtifacts = shouldGenerateCommands ? commandArtifacts.filter((entry) => desiredWorkflowSet.has(entry.workflow)) : [];
 		const missingSkillWorkflows = collectMissingWorkflows(expectedSkillArtifacts, existingSkillPaths);
@@ -4646,165 +5477,167 @@ async function getToolInitStates(projectDir, options) {
 		};
 	}));
 }
-
-//#endregion
-//#region src/dashboard-types.ts
-const DASHBOARD_METRIC_KEYS = [
-	"specifications",
-	"requirements",
-	"activeChanges",
-	"inProgressChanges",
-	"completedChanges",
-	"taskCompletionPercent"
-];
+/** Read a fresh one-shot Project Tool artifact inventory. */
+async function getToolInitStates(projectDir, options) {
+	invalidateToolInitCaches(projectDir);
+	return projectToolInitStates(projectDir, options);
+}
+/** Create a retained Tool inventory task that must be executed by one ReactiveContext. */
+function createToolInitStateProjection(projectDir, options) {
+	const projectionOptions = {
+		delivery: options.delivery,
+		workflows: [...options.workflows]
+	};
+	return () => projectToolInitStates(projectDir, projectionOptions);
+}
 
 //#endregion
 //#region src/hooks.ts
-const OPENSPECUI_HOOKS_VERSION = 1;
+const OPENSPECUI_DOCUMENT_HOOK_VERSION = 1;
+const OPENSPECUI_WORKFLOW_HOOK_VERSION = 2;
 
 //#endregion
-//#region src/opsx-types.ts
-/** Check if an outputPath contains glob pattern characters */
-function isGlobPattern(pattern) {
-	return pattern.includes("*") || pattern.includes("?") || pattern.includes("[");
-}
-const ArtifactStatusSchema = z.object({
-	id: z.string(),
-	outputPath: z.string(),
-	status: z.enum([
-		"done",
-		"ready",
-		"blocked"
-	]),
-	missingDeps: z.array(z.string()).optional(),
-	relativePath: z.string().optional()
-});
-const ChangeStatusSchema = z.object({
-	changeName: z.string(),
-	schemaName: z.string(),
-	isComplete: z.boolean(),
-	applyRequires: z.array(z.string()),
-	artifacts: z.array(ArtifactStatusSchema)
-});
-const DependencyInfoSchema = z.object({
-	id: z.string(),
-	done: z.boolean(),
-	path: z.string(),
-	description: z.string()
-});
-const ApplyTaskSchema = z.object({
-	id: z.string(),
-	description: z.string(),
-	done: z.boolean()
-});
-const ApplyInstructionsContextFilePathsSchema = z.union([z.string(), z.array(z.string())]).transform((paths) => Array.isArray(paths) ? paths : [paths]);
-const ApplyInstructionsContextFilesSchema = z.record(ApplyInstructionsContextFilePathsSchema);
-const ApplyInstructionsSchema = z.object({
-	changeName: z.string(),
-	changeDir: z.string(),
-	schemaName: z.string(),
-	contextFiles: ApplyInstructionsContextFilesSchema,
-	progress: z.object({
-		total: z.number(),
-		complete: z.number(),
-		remaining: z.number()
-	}),
-	tasks: z.array(ApplyTaskSchema),
-	state: z.enum([
-		"blocked",
-		"all_done",
-		"ready"
-	]),
-	missingArtifacts: z.array(z.string()).optional(),
-	instruction: z.string()
-});
-const NullableString = z.string().nullable().optional();
-const ArtifactInstructionsSchema = z.object({
-	changeName: z.string(),
-	artifactId: z.string(),
-	schemaName: z.string(),
-	changeDir: z.string(),
-	outputPath: z.string(),
-	description: z.string(),
-	instruction: NullableString,
-	context: NullableString,
-	rules: z.array(z.string()).optional().nullable(),
-	template: z.string(),
-	dependencies: z.array(DependencyInfoSchema),
-	unlocks: z.array(z.string())
-});
-const SchemaInfoSchema = z.object({
-	name: z.string(),
-	description: z.string().optional(),
-	artifacts: z.array(z.string()),
-	source: z.enum([
-		"project",
-		"user",
-		"package"
-	])
-});
-const SchemaResolutionSchema = z.object({
-	name: z.string(),
-	source: z.enum([
-		"project",
-		"user",
-		"package"
-	]),
-	path: z.string(),
-	displayPath: z.string().optional(),
-	shadows: z.array(z.object({
-		source: z.enum([
-			"project",
-			"user",
-			"package"
-		]),
-		path: z.string(),
-		displayPath: z.string().optional()
-	}))
-});
-const TemplatesSchema = z.record(z.object({
-	path: z.string(),
-	displayPath: z.string().optional(),
-	source: z.enum([
-		"project",
-		"user",
-		"package"
-	])
-}));
-const SchemaArtifactSchema = z.object({
-	id: z.string(),
-	outputPath: z.string(),
-	description: z.string().optional(),
-	template: z.string().optional(),
-	instruction: z.string().optional(),
-	requires: z.array(z.string())
-});
-const SchemaDetailSchema = z.object({
-	name: z.string(),
-	description: z.string().optional(),
-	version: z.union([z.string(), z.number()]).optional(),
-	artifacts: z.array(SchemaArtifactSchema),
-	applyRequires: z.array(z.string()),
-	applyTracks: z.string().optional(),
-	applyInstruction: z.string().optional()
-});
+//#region src/hosted-protocol.ts
+/**
+* Orthogonal intents (updated 2026-07-25 Asia/Shanghai):
+* 1. Compute opaque environment identity and Access Gate credentials with Node crypto.
+* 2. Re-export browser-safe hosted identity/capability/mutation facts without making this Node entry browser-safe.
+*
+* Original request (2026-07-15): "我们可以在 cli 上新增一个 --auth 或者 --password。"
+* Migrated from `packages/app/src/types/{env-uri,capabilities,store-mutation}.ts` so the backend is the
+* authoritative producer and both App and Server share one typed contract.
+*
+* Key invariants (AGENTS.md):
+*  - `envUri` is backend-issued, opaque, non-dereferenceable; it identifies host identity + effective
+*    OpenSpec data home. Multiple processes/ports/projects share one envUri when that pair is unchanged.
+*  - Capabilities are objective compatibility facts, never permissions, authorization, or workflow state.
+*  - Store mutations are backend-owned: `accepted -> running -> succeeded | failed`; unrecoverable
+*    terminal loss is `indeterminate`, never fabricated as failure or cancellation. V1 has no Cancel
+*    and no automatic retry. A client request id deduplicates starts within one backend process.
+*  - The Access Gate is one shared Bearer credential for the whole backend boundary; it is not an
+*    account, role, ACL, or permission system, and it provides no transport confidentiality.
+*/
+/**
+* Compute a stable opaque `envUri` from backend host identity plus effective OpenSpec data home.
+* The inputs are hashed so the returned URI never exposes either component; only pair equality matters.
+*/
+function computeEnvUri(options) {
+	const dataHome = options.dataHome ?? "";
+	return asEnvUri(`openspecui-env://1/${createHash("sha256").update(`${options.hostIdentity}\u0000${dataHome}`).digest("hex")}`);
+}
+/** Required byte length of a generated `--auth` credential (256 bits of entropy). */
+const ACCESS_GATE_CREDENTIAL_BYTES = 32;
+/** Base64url-encode without padding. */
+function base64url(bytes) {
+	return Buffer.from(bytes).toString("base64url");
+}
+/** Compute a short SHA-256 fingerprint suitable for safe display. */
+function accessGateFingerprint(credential) {
+	return createHash("sha256").update(credential).digest("hex").slice(0, 16);
+}
+/** Generate a high-entropy Bearer credential for `--auth` and return the complete gate record. */
+function generateAccessGateCredential() {
+	const credential = base64url(randomBytes(ACCESS_GATE_CREDENTIAL_BYTES));
+	return {
+		credential,
+		fingerprint: accessGateFingerprint(credential),
+		authorizationHeader: `Bearer ${credential}`
+	};
+}
+/**
+* Normalize an operator-supplied `--password` secret into the same Bearer gate record. The secret is
+* used verbatim as the credential (no hashing) so the gate is a single shared secret comparison.
+*/
+function normalizeAccessGatePassword(password) {
+	const credential = password;
+	return {
+		credential,
+		fingerprint: accessGateFingerprint(credential),
+		authorizationHeader: `Bearer ${credential}`
+	};
+}
+/** Constant-time comparison of two equal-length secrets to mitigate timing side channels. */
+function constantTimeEqual(a, b) {
+	const left = Buffer.from(a);
+	const right = Buffer.from(b);
+	if (left.length !== right.length) {
+		left.compare(left);
+		return false;
+	}
+	return left.compare(right) === 0;
+}
 
 //#endregion
-//#region src/opsx-kernel.ts
-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}`);
+//#region src/snapshot-redaction.ts
+function isAbsoluteFsPath$1(path) {
+	const normalized = path.replace(/\\/g, "/");
+	return normalized.startsWith("/") || /^[A-Za-z]:\//.test(normalized);
+}
+/**
+* Redact an absolute path to a display-safe relative fragment. Absolute filesystem locations must
+* never survive into a published snapshot; only the trailing relative segment is retained so a reader
+* still understands the artifact's repository-relative location.
+*/
+function redactPath(raw) {
+	if (!raw) return raw;
+	const normalized = raw.replace(/\\/g, "/");
+	if (!isAbsoluteFsPath$1(normalized)) return normalized;
+	return normalized.split("/").filter(Boolean).slice(-2).join("/");
+}
+/** Deep-clone helper that preserves JSON-serializable snapshot shape without mutating input. */
+function cloneSnapshot(snapshot) {
+	return JSON.parse(JSON.stringify(snapshot));
+}
+/**
+* Produce a publication-safe copy of `snapshot`. Removes absolute project/Store/data-home/registry
+* paths, host identity, and raw path-bearing diagnostics, and clears the Git remote URL unless the
+* Reference export policy is explicitly `include`. Display-safe relative paths (`displayPath`,
+* repository-relative fragments) and human-readable labels are preserved.
+*
+* This is the single redaction boundary for static export privacy (Section 7.8). Callers must run it
+* immediately before serializing the published `data.json` / SSG site.
+*/
+function redactSnapshotForPublication(snapshot) {
+	const redacted = cloneSnapshot(snapshot);
+	const root = redacted.meta.root;
+	if (root && root.planningRootPath) root.planningRootPath = redactPath(root.planningRootPath);
+	if (redacted.git && redacted.meta.referencePolicy?.kind !== "include") redacted.git.repositoryUrl = null;
+	const opsx = redacted.opsx;
+	if (opsx) {
+		for (const resolution of Object.values(opsx.schemaResolutions)) {
+			if (typeof resolution.path === "string") resolution.path = redactPath(resolution.path);
+			for (const shadow of resolution.shadows ?? []) if (typeof shadow.path === "string") shadow.path = redactPath(shadow.path);
+		}
+		for (const artifactMap of Object.values(opsx.templates)) for (const info of Object.values(artifactMap)) if (typeof info.path === "string") info.path = redactPath(info.path);
+		if (opsx.templateContents) {
+			for (const artifactMap of Object.values(opsx.templateContents)) for (const entry of Object.values(artifactMap)) if (typeof entry.path === "string") entry.path = redactPath(entry.path);
+		}
 	}
-	const result = schema.safeParse(parsed);
-	if (!result.success) throw new Error(`${label} returned unexpected JSON: ${result.error.message}`);
-	return result.data;
+	if (opsx?.changeMetadata) {
+		for (const [id, raw] of Object.entries(opsx.changeMetadata)) if (typeof raw === "string") opsx.changeMetadata[id] = raw.replace(/(?:\/[\w.\-@]+){2,}(?=\s|"|$)/g, (match) => redactPath(match));
+	}
+	return redacted;
+}
+/** True when any string field in the snapshot still carries an absolute filesystem path. */
+function snapshotHasAbsolutePath(snapshot) {
+	const text = JSON.stringify(snapshot);
+	return /\b(?:\/[\w.\-@]+){2,}/.test(text) || /[A-Za-z]:\//.test(text);
 }
+
+//#endregion
+//#region src/opsx-kernel.ts
+/**
+* Orthogonal intents (updated 2026-07-27 Asia/Shanghai):
+* 1. Maintain reactive CLI-backed projections and their direct typed Projection Work readers.
+* 2. Share and release per-entity streams through one planning-root kernel lifecycle.
+* 3. Keep OpenSpec configuration ownership outside the workflow projection cache.
+* 4. Preserve typed Status/Instructions provenance with the resolved root selector.
+* 5. Keep Change enumeration business truth in the typed CLI result while files only invalidate it.
+*
+* Original request (2026-07-15): "Planning-root adapters and services consume the CLI-resolved root."
+* Original request (2026-07-23): "OPSX Status 不应等待完整 Kernel warmup，且必须保留 CLI evidence。"
+* Original request (2026-07-26): "展开全面的接口升级和内核升级和测试升级。"
+*/
 function toRelativePath(root, absolutePath) {
 	return relative(root, absolutePath).split(sep).join("/");
 }
@@ -4849,6 +5682,12 @@ async function readEntriesUnderRoot(root) {
 	};
 	return collectEntries(root);
 }
+function requireCanonicalArtifactLocation(changeId, outputPath) {
+	return {
+		changeId: requireCanonicalOpenSpecEntityId(changeId, "changeId"),
+		outputPath: requireOpenSpecEntityRelativePath(outputPath, "outputPath")
+	};
+}
 function splitRelativePathSegments(path) {
 	return path.replace(/\\/g, "/").split("/").filter(Boolean);
 }
@@ -4861,7 +5700,8 @@ function getGlobStaticPrefix(outputPath) {
 	return lastSlashIndex === -1 ? "" : staticPrefix.slice(0, lastSlashIndex);
 }
 async function readGlobArtifactFiles(projectDir, changeId, outputPath) {
-	return (await readEntriesUnderRoot(join$1(projectDir, "openspec", "changes", changeId))).filter((entry) => entry.type === "file" && matchesGlob(entry.path, outputPath)).map((entry) => ({
+	const location = requireCanonicalArtifactLocation(changeId, outputPath);
+	return (await readEntriesUnderRoot(join$1(projectDir, "openspec", "changes", location.changeId))).filter((entry) => entry.type === "file" && matchesGlob(entry.path, location.outputPath)).map((entry) => ({
 		path: entry.path,
 		type: "file",
 		content: entry.content ?? ""
@@ -4904,8 +5744,9 @@ async function touchDirectoryTree(rootDir) {
 	}));
 }
 async function touchArtifactOutputDeps(projectDir, changeId, outputPath) {
-	const changeDir = join$1(projectDir, "openspec", "changes", changeId);
-	const normalizedOutputPath = outputPath.replace(/\\/g, "/");
+	const location = requireCanonicalArtifactLocation(changeId, outputPath);
+	const changeDir = join$1(projectDir, "openspec", "changes", location.changeId);
+	const normalizedOutputPath = location.outputPath;
 	if (isGlobPattern(normalizedOutputPath)) {
 		const staticPrefix = getGlobStaticPrefix(normalizedOutputPath);
 		if (staticPrefix) await touchDirectoryPathDeps(changeDir, staticPrefix);
@@ -4916,16 +5757,44 @@ async function touchArtifactOutputDeps(projectDir, changeId, outputPath) {
 	if (parentPath) await touchDirectoryPathDeps(changeDir, parentPath);
 	await reactiveExists(join$1(changeDir, normalizedOutputPath));
 }
+function requireCommandData(label, result, schema) {
+	const parsed = schema.safeParse(result.data);
+	if (result.success && parsed.success) return parsed.data;
+	throw new CliProjectionCommandError(result.contractError || result.stderr.trim() || result.diagnostics.map((diagnostic) => diagnostic.message).join("\n") || `${label} failed (exit ${result.exitCode ?? "null"})`, result);
+}
+function readOpsxRoot(data) {
+	const parsed = z.object({ root: CliRootSchema }).passthrough().safeParse(data);
+	return parsed.success ? parsed.data.root : void 0;
+}
+function createOpsxCliEvidence(result, command, rootSelector) {
+	const root = readOpsxRoot(result.data);
+	return OpsxCliEvidenceSchema.parse({
+		command,
+		success: result.success,
+		stdout: result.stdout,
+		stderr: result.stderr,
+		exitCode: result.exitCode,
+		payload: result.payload,
+		diagnostics: result.diagnostics,
+		...result.contractError ? { contractError: result.contractError } : {},
+		selector: rootSelector.store === void 0 ? {} : { store: rootSelector.store },
+		...root ? { root } : {}
+	});
+}
+function createOpsxStatusEvidence(result, rootSelector) {
+	return OpsxStatusEvidenceSchema.parse(createOpsxCliEvidence(result, "status", rootSelector));
+}
 var OpsxKernel = class {
 	projectDir;
 	cliExecutor;
+	runtimeInvalidation;
+	rootSelector;
 	controller = new AbortController();
 	warmupPromise = null;
 	_streamReady = /* @__PURE__ */ new Map();
 	_statusList = new ReactiveState([]);
 	_schemas = new ReactiveState([]);
 	_changeIds = new ReactiveState([]);
-	_projectConfig = new ReactiveState(null);
 	_schemaResolutions = /* @__PURE__ */ new Map();
 	_schemaDetails = /* @__PURE__ */ new Map();
 	_schemaFiles = /* @__PURE__ */ new Map();
@@ -4939,9 +5808,11 @@ var OpsxKernel = class {
 	_artifactOutputs = /* @__PURE__ */ new Map();
 	_globArtifactFiles = /* @__PURE__ */ new Map();
 	_entityControllers = /* @__PURE__ */ new Map();
-	constructor(projectDir, cliExecutor) {
+	constructor(projectDir, cliExecutor, runtimeInvalidation, rootSelector) {
 		this.projectDir = projectDir;
 		this.cliExecutor = cliExecutor;
+		this.runtimeInvalidation = runtimeInvalidation;
+		this.rootSelector = rootSelector;
 	}
 	async warmup() {
 		if (this.warmupPromise) return this.warmupPromise;
@@ -4956,11 +5827,7 @@ var OpsxKernel = class {
 	}
 	async runWarmup() {
 		const signal = this.controller.signal;
-		await Promise.all([
-			this.startStreamOnce("global:schemas", this._schemas, () => this.fetchSchemas(), signal),
-			this.startStreamOnce("global:change-ids", this._changeIds, () => this.fetchChangeIds(), signal),
-			this.startStreamOnce("global:project-config", this._projectConfig, () => this.fetchProjectConfig(), signal)
-		]);
+		await Promise.all([this.startStreamOnce("global:schemas", this._schemas, () => this.fetchSchemas(), signal), this.startStreamOnce("global:change-ids", this._changeIds, () => this.fetchChangeIds(), signal)]);
 		const schemas = this._schemas.get();
 		await Promise.all(schemas.map((s) => this.warmupSchema(s.name, signal)));
 		const changeIds = this._changeIds.get();
@@ -4985,9 +5852,6 @@ var OpsxKernel = class {
 	getChangeIds() {
 		return this._changeIds.get();
 	}
-	getProjectConfig() {
-		return this._projectConfig.get();
-	}
 	getTemplates(schema) {
 		const key = schema ?? "";
 		const state = this._templates.get(key);
@@ -5224,10 +6088,16 @@ var OpsxKernel = class {
 		for (const key of this._streamReady.keys()) if (key.startsWith(prefix)) this._streamReady.delete(key);
 	}
 	async fetchSchemas() {
+		return (await this.fetchSchemasProjection()).value;
+	}
+	async fetchSchemasProjection() {
+		this.runtimeInvalidation.track("schemas");
 		await touchOpsxProjectDeps(this.projectDir);
-		const result = await this.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");
+		const result = await this.cliExecutor.contracts.schemas();
+		return {
+			value: requireCommandData("openspec schemas", result, CliSchemasSchema),
+			evidence: toCliProjectionCommandEvidence(result)
+		};
 	}
 	async fetchChangeIds() {
 		return reactiveReadDir(join$1(this.projectDir, "openspec", "changes"), {
@@ -5236,22 +6106,40 @@ var OpsxKernel = class {
 			exclude: ["archive"]
 		});
 	}
-	async fetchProjectConfig() {
-		return reactiveReadFile(join$1(this.projectDir, "openspec", "config.yaml"));
+	async fetchChangeListProjection() {
+		await this.fetchChangeIds();
+		const result = await this.cliExecutor.contracts.listChanges(this.rootSelector);
+		return {
+			value: requireCommandData("openspec list", result, CliChangeListSchema).changes.map(({ name }) => name),
+			evidence: toCliProjectionCommandEvidence(result)
+		};
 	}
 	async fetchStatus(changeId, schema) {
 		await touchOpsxProjectDeps(this.projectDir);
 		await touchOpsxChangeDeps(this.projectDir, changeId);
-		const args = [
-			"status",
-			"--json",
-			"--change",
-			changeId
-		];
-		if (schema) args.push("--schema", schema);
-		const result = await this.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 result = await this.cliExecutor.contracts.workflowStatus(changeId, {
+			...this.rootSelector,
+			...schema ? { schema } : {}
+		});
+		const evidence = createOpsxStatusEvidence(result, this.rootSelector);
+		const data = requireCommandData("openspec status", result, CliWorkflowStatusSuccessSchema);
+		const status = ChangeStatusSchema.parse({
+			changeName: data.changeName,
+			schemaName: data.schemaName,
+			isComplete: data.isComplete,
+			applyRequires: data.applyRequires,
+			artifacts: data.artifacts,
+			provenance: {
+				kind: "cli",
+				planningHome: data.planningHome,
+				changeRoot: data.changeRoot,
+				artifactPaths: data.artifactPaths,
+				nextSteps: data.nextSteps,
+				actionContext: data.actionContext,
+				root: data.root,
+				evidence
+			}
+		});
 		const changeRelDir = `openspec/changes/${changeId}`;
 		for (const artifact of status.artifacts) {
 			artifact.relativePath = `${changeRelDir}/${artifact.outputPath}`;
@@ -5268,57 +6156,71 @@ var OpsxKernel = class {
 	async fetchInstructions(changeId, artifact, schema) {
 		await touchOpsxProjectDeps(this.projectDir);
 		await touchOpsxChangeDeps(this.projectDir, changeId);
-		const args = [
-			"instructions",
-			artifact,
-			"--json",
-			"--change",
-			changeId
-		];
-		if (schema) args.push("--schema", schema);
-		const result = await this.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");
+		const result = await this.cliExecutor.contracts.artifactInstructions(changeId, artifact, {
+			...this.rootSelector,
+			...schema ? { schema } : {}
+		});
+		const data = requireCommandData("openspec instructions", result, CliArtifactInstructionsSuccessSchema);
+		return ArtifactInstructionsSchema.parse({
+			...data,
+			evidence: createOpsxCliEvidence(result, "instructions", this.rootSelector)
+		});
 	}
 	async fetchApplyInstructions(changeId, schema) {
 		await touchOpsxProjectDeps(this.projectDir);
 		await touchOpsxChangeDeps(this.projectDir, changeId);
-		const args = [
-			"instructions",
-			"apply",
-			"--json",
-			"--change",
-			changeId
-		];
-		if (schema) args.push("--schema", schema);
-		const result = await this.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");
+		const result = await this.cliExecutor.contracts.applyInstructions(changeId, {
+			...this.rootSelector,
+			...schema ? { schema } : {}
+		});
+		const data = requireCommandData("openspec instructions apply", result, CliApplyInstructionsSuccessSchema);
+		const instructions = ApplyInstructionsSchema.parse({
+			...data,
+			evidence: createOpsxCliEvidence(result, "instructions apply", this.rootSelector)
+		});
+		const changeDir = join$1(this.projectDir, "openspec", "changes", changeId);
+		const [files, schemaDetail] = await Promise.all([readEntriesUnderRoot(changeDir), this.fetchSchemaResolution(instructions.schemaName).then((resolution) => this.fetchSchemaDetailAtResolution(instructions.schemaName, resolution)).catch(() => null)]);
+		const { trackedTaskProgress } = projectTaskProjectionsFromMarkdownFiles(files, {
+			schemaDetail,
+			hasSchemaMetadata: true
+		});
+		return {
+			...instructions,
+			applyInstructionProgress: createApplyInstructionProgress(instructions.applyInstructionProgress, trackedTaskProgress)
+		};
 	}
 	async fetchSchemaResolution(name) {
+		return (await this.fetchSchemaResolutionProjection(name)).value;
+	}
+	async fetchSchemaResolutionProjection(name) {
 		await touchOpsxProjectDeps(this.projectDir);
-		const result = await this.cliExecutor.schemaWhich(name);
-		if (!result.success) throw new Error(result.stderr || `openspec schema which failed (exit ${result.exitCode ?? "null"})`);
-		const parsed = parseCliJson(result.stdout, SchemaResolutionSchema, "openspec schema which");
+		const result = await this.cliExecutor.contracts.schemaWhich(name);
+		const value = requireCommandData("openspec schema which", result, SchemaResolutionSchema);
 		return {
-			...parsed,
-			displayPath: toOpsxDisplayPath(parsed.path, {
-				source: parsed.source,
-				projectDir: this.projectDir
-			}),
-			shadows: parsed.shadows.map((shadow) => ({
-				...shadow,
-				displayPath: toOpsxDisplayPath(shadow.path, {
-					source: shadow.source,
+			evidence: toCliProjectionCommandEvidence(result),
+			value: {
+				...value,
+				displayPath: toOpsxDisplayPath(value.path, {
+					source: value.source,
 					projectDir: this.projectDir
-				})
-			}))
+				}),
+				shadows: value.shadows.map((shadow) => ({
+					...shadow,
+					displayPath: toOpsxDisplayPath(shadow.path, {
+						source: shadow.source,
+						projectDir: this.projectDir
+					})
+				}))
+			}
 		};
 	}
 	async fetchSchemaDetail(name) {
 		await touchOpsxProjectDeps(this.projectDir);
 		await this.ensureSchemaResolution(name);
-		const schemaPath = join$1(this.getSchemaResolution(name).path, "schema.yaml");
+		return this.fetchSchemaDetailAtResolution(name, this.getSchemaResolution(name));
+	}
+	async fetchSchemaDetailAtResolution(name, resolution) {
+		const schemaPath = join$1(resolution.path, "schema.yaml");
 		const content = await reactiveReadFile(schemaPath);
 		if (!content) throw new Error(`schema.yaml not found at ${schemaPath}`);
 		return parseSchemaYamlInline(content, name, schemaPath);
@@ -5334,22 +6236,29 @@ var OpsxKernel = class {
 		return reactiveReadFile(join$1(this.getSchemaResolution(name).path, "schema.yaml"));
 	}
 	async fetchTemplates(schema) {
+		return (await this.fetchTemplatesProjection(schema)).value;
+	}
+	async fetchTemplatesProjection(schema) {
 		await touchOpsxProjectDeps(this.projectDir);
-		const result = await this.cliExecutor.templates(schema);
-		if (!result.success) throw new Error(result.stderr || `openspec templates failed (exit ${result.exitCode ?? "null"})`);
-		const templates = parseCliJson(result.stdout, TemplatesSchema, "openspec templates");
-		return Object.fromEntries(Object.entries(templates).map(([artifactId, info]) => [artifactId, {
-			...info,
-			path: toAbsoluteProjectPath(this.projectDir, info.path),
-			displayPath: toOpsxDisplayPath(info.path, {
-				source: info.source,
-				projectDir: this.projectDir
-			})
-		}]));
+		const result = await this.cliExecutor.contracts.templates(schema);
+		const templates = requireCommandData("openspec templates", result, TemplatesSchema);
+		return {
+			value: Object.fromEntries(Object.entries(templates).map(([artifactId, info]) => [artifactId, {
+				...info,
+				path: toAbsoluteProjectPath(this.projectDir, info.path),
+				displayPath: toOpsxDisplayPath(info.path, {
+					source: info.source,
+					projectDir: this.projectDir
+				})
+			}])),
+			evidence: toCliProjectionCommandEvidence(result)
+		};
 	}
 	async fetchTemplateContents(schema) {
 		await this.ensureTemplates(schema);
-		const templates = this.getTemplates(schema);
+		return this.readTemplateContents(this.getTemplates(schema));
+	}
+	async readTemplateContents(templates) {
 		const entries = await Promise.all(Object.entries(templates).map(async ([artifactId, info]) => {
 			return [artifactId, {
 				content: await reactiveReadFile(info.path),
@@ -5367,7 +6276,67 @@ var OpsxKernel = class {
 		return reactiveReadFile(join$1(this.projectDir, "openspec", "changes", changeId, ".openspec.yaml"));
 	}
 	async fetchArtifactOutput(changeId, outputPath) {
-		return reactiveReadFile(join$1(this.projectDir, "openspec", "changes", changeId, outputPath));
+		const location = requireCanonicalArtifactLocation(changeId, outputPath);
+		return reactiveReadFile(join$1(this.projectDir, "openspec", "changes", location.changeId, location.outputPath));
+	}
+	/** Execute one Status projection with dependencies owned by the caller's reactive generation. */
+	readStatusProjection(changeId, schema) {
+		return this.fetchStatus(changeId, schema);
+	}
+	/** Execute CLI-owned Change enumeration with file dependencies owned by the caller's Work generation. */
+	readChangeListProjection() {
+		return this.fetchChangeListProjection();
+	}
+	/** Execute the current Change Status list without joining the Kernel's retained entity streams. */
+	async readStatusListProjection() {
+		const changeList = await this.fetchChangeListProjection();
+		return {
+			value: await Promise.all(changeList.value.map((changeId) => this.fetchStatus(changeId))),
+			evidence: changeList.evidence
+		};
+	}
+	/** Execute one artifact-instructions projection in the caller-owned Work generation. */
+	readInstructionsProjection(changeId, artifact, schema) {
+		return this.fetchInstructions(changeId, artifact, schema);
+	}
+	/** Execute one Apply-instructions projection in the caller-owned Work generation. */
+	readApplyInstructionsProjection(changeId, schema) {
+		return this.fetchApplyInstructions(changeId, schema);
+	}
+	/** Execute the aggregate Schema bundle while retaining exact resolved-file dependencies. */
+	async readConfigBundleProjection() {
+		const schemasProjection = await this.fetchSchemasProjection();
+		const details = await Promise.all(schemasProjection.value.map(async ({ name }) => {
+			const resolution = await this.fetchSchemaResolutionProjection(name);
+			return {
+				name,
+				detail: await this.fetchSchemaDetailAtResolution(name, resolution.value).catch(() => null),
+				resolution
+			};
+		}));
+		return {
+			value: {
+				schemas: schemasProjection.value,
+				schemaDetails: Object.fromEntries(details.map(({ name, detail }) => [name, detail])),
+				schemaResolutions: Object.fromEntries(details.map(({ name, resolution }) => [name, resolution.value]))
+			},
+			evidence: {
+				schemas: schemasProjection.evidence,
+				schemaResolutions: Object.fromEntries(details.map(({ name, resolution }) => [name, resolution.evidence]))
+			}
+		};
+	}
+	/** Execute one CLI template-index projection. */
+	readTemplatesProjection(schema) {
+		return this.fetchTemplatesProjection(schema);
+	}
+	/** Execute one template-content projection from the CLI-selected template index. */
+	async readTemplateContentsProjection(schema) {
+		const templates = await this.fetchTemplatesProjection(schema);
+		return {
+			value: await this.readTemplateContents(templates.value),
+			evidence: templates.evidence
+		};
 	}
 	async ensureSchemas() {
 		await this.startStreamOnce("global:schemas", this._schemas, () => this.fetchSchemas(), this.controller.signal);
@@ -5375,36 +6344,38 @@ var OpsxKernel = class {
 	async ensureChangeIds() {
 		await this.startStreamOnce("global:change-ids", this._changeIds, () => this.fetchChangeIds(), this.controller.signal);
 	}
-	async ensureProjectConfig() {
-		await this.startStreamOnce("global:project-config", this._projectConfig, () => this.fetchProjectConfig(), this.controller.signal);
-	}
 	async ensureStatusList() {
 		await this.startStreamOnce("global:status-list", this._statusList, () => this.fetchStatusList(), this.controller.signal);
 	}
 	async ensureStatus(changeId, schema) {
-		const key = `${changeId}:${schema ?? ""}`;
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		const key = `${canonicalChangeId}:${schema ?? ""}`;
 		if (!this._statuses.has(key)) this._statuses.set(key, new ReactiveState(null));
-		await this.startStreamOnce(`change:${changeId}:status:${schema ?? ""}`, this._statuses.get(key), () => this.fetchStatus(changeId, schema), this.controller.signal);
+		await this.startStreamOnce(`change:${canonicalChangeId}:status:${schema ?? ""}`, this._statuses.get(key), () => this.fetchStatus(canonicalChangeId, schema), this.controller.signal);
 	}
 	async ensureInstructions(changeId, artifact, schema) {
-		const key = `${changeId}:${artifact}:${schema ?? ""}`;
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		const key = `${canonicalChangeId}:${artifact}:${schema ?? ""}`;
 		if (!this._instructions.has(key)) this._instructions.set(key, new ReactiveState(null));
-		await this.startStreamOnce(`change:${changeId}:instructions:${artifact}:${schema ?? ""}`, this._instructions.get(key), () => this.fetchInstructions(changeId, artifact, schema), this.controller.signal);
+		await this.startStreamOnce(`change:${canonicalChangeId}:instructions:${artifact}:${schema ?? ""}`, this._instructions.get(key), () => this.fetchInstructions(canonicalChangeId, artifact, schema), this.controller.signal);
 	}
 	async ensureApplyInstructions(changeId, schema) {
-		const key = `${changeId}:${schema ?? ""}`;
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		const key = `${canonicalChangeId}:${schema ?? ""}`;
 		if (!this._applyInstructions.has(key)) this._applyInstructions.set(key, new ReactiveState(null));
-		await this.startStreamOnce(`change:${changeId}:apply:${schema ?? ""}`, this._applyInstructions.get(key), () => this.fetchApplyInstructions(changeId, schema), this.controller.signal);
+		await this.startStreamOnce(`change:${canonicalChangeId}:apply:${schema ?? ""}`, this._applyInstructions.get(key), () => this.fetchApplyInstructions(canonicalChangeId, schema), this.controller.signal);
 	}
 	async ensureArtifactOutput(changeId, outputPath) {
-		const key = `${changeId}:${outputPath}`;
+		const location = requireCanonicalArtifactLocation(changeId, outputPath);
+		const key = `${location.changeId}:${location.outputPath}`;
 		if (!this._artifactOutputs.has(key)) this._artifactOutputs.set(key, new ReactiveState(null));
-		await this.startStreamOnce(`change:${changeId}:output:${outputPath}`, this._artifactOutputs.get(key), () => this.fetchArtifactOutput(changeId, outputPath), this.controller.signal);
+		await this.startStreamOnce(`change:${location.changeId}:output:${location.outputPath}`, this._artifactOutputs.get(key), () => this.fetchArtifactOutput(location.changeId, location.outputPath), this.controller.signal);
 	}
 	async ensureGlobArtifactFiles(changeId, outputPath) {
-		const key = `${changeId}:${outputPath}`;
+		const location = requireCanonicalArtifactLocation(changeId, outputPath);
+		const key = `${location.changeId}:${location.outputPath}`;
 		if (!this._globArtifactFiles.has(key)) this._globArtifactFiles.set(key, new ReactiveState([]));
-		await this.startStreamOnce(`change:${changeId}:glob:${outputPath}`, this._globArtifactFiles.get(key), () => readGlobArtifactFiles(this.projectDir, changeId, outputPath), this.controller.signal);
+		await this.startStreamOnce(`change:${location.changeId}:glob:${location.outputPath}`, this._globArtifactFiles.get(key), () => readGlobArtifactFiles(this.projectDir, location.changeId, location.outputPath), this.controller.signal);
 	}
 	async ensureSchemaResolution(name) {
 		if (!this._schemaResolutions.has(name)) this._schemaResolutions.set(name, new ReactiveState(null));
@@ -5433,8 +6404,9 @@ var OpsxKernel = class {
 		await this.startStreamOnce(`schema:${key}:template-contents`, this._templateContents.get(key), () => this.fetchTemplateContents(schema), this.controller.signal);
 	}
 	async ensureChangeMetadata(changeId) {
-		if (!this._changeMetadata.has(changeId)) this._changeMetadata.set(changeId, new ReactiveState(null));
-		await this.startStreamOnce(`change:${changeId}:metadata`, this._changeMetadata.get(changeId), () => this.fetchChangeMetadata(changeId), this.controller.signal);
+		const canonicalChangeId = requireCanonicalOpenSpecEntityId(changeId, "changeId");
+		if (!this._changeMetadata.has(canonicalChangeId)) this._changeMetadata.set(canonicalChangeId, new ReactiveState(null));
+		await this.startStreamOnce(`change:${canonicalChangeId}:metadata`, this._changeMetadata.get(canonicalChangeId), () => this.fetchChangeMetadata(canonicalChangeId), this.controller.signal);
 	}
 	combineSignals(a, b) {
 		const ctrl = new AbortController();
@@ -5454,12 +6426,23 @@ function parseSchemaYamlInline(content, fallbackName, path) {
 
 //#endregion
 //#region src/pty-protocol.ts
+/**
+* Orthogonal intents (updated 2026-07-22 Asia/Shanghai):
+* 1. Define the type-safe PTY client/server transport protocol.
+* 2. Preserve explicit launch-project or planning-root cwd identity across create/list/reconnect.
+* 3. Carry terminal output, control metadata, lifecycle, and failure messages.
+* 4. Carry opaque planning-root generation evidence through PTY creation and guarded workflow input.
+*
+* Original request (2026-07-16): "3.8 Terminal exposes explicit launch-project cwd and planning-root cwd while preserving inherited XDG_DATA_HOME"
+* Owner-reported defect (2026-07-21): Same-generation Agent terminals are unavailable to Send.
+*/
 const PositiveInt = z.number().int().positive();
 const PtyPlatformSchema = z.enum([
 	"windows",
 	"macos",
 	"common"
 ]);
+const TerminalCwdTargetSchema = z.enum(["launch-project", "planning-root"]);
 const CloseCallbackUrlSchema = z.union([z.string(), z.record(z.string())]);
 const PtySessionInfoSchema = z.object({
 	id: z.string().min(1),
@@ -5470,7 +6453,10 @@ const PtySessionInfoSchema = z.object({
 	isExited: z.boolean(),
 	exitCode: z.number().int().nullable(),
 	closeTip: z.string().optional(),
-	closeCallbackUrl: CloseCallbackUrlSchema.optional()
+	closeCallbackUrl: CloseCallbackUrlSchema.optional(),
+	cwdTarget: TerminalCwdTargetSchema,
+	initialCwd: z.string().min(1),
+	rootGeneration: z.string().min(1).nullable()
 });
 const PtyCreateMessageSchema = z.object({
 	type: z.literal("create"),
@@ -5479,6 +6465,8 @@ const PtyCreateMessageSchema = z.object({
 	rows: PositiveInt.optional(),
 	command: z.string().min(1).optional(),
 	args: z.array(z.string()).optional(),
+	cwdTarget: TerminalCwdTargetSchema,
+	expectedRootGeneration: z.string().min(1).optional(),
 	closeTip: z.string().optional(),
 	closeCallbackUrl: CloseCallbackUrlSchema.optional()
 });
@@ -5487,6 +6475,14 @@ const PtyInputMessageSchema = z.object({
 	sessionId: z.string().min(1),
 	data: z.string()
 });
+/** A workflow payload whose terminal and current Planning-root generation require Server approval. */
+const PtyWorkflowInputMessageSchema = z.object({
+	type: z.literal("workflow-input"),
+	requestId: z.string().min(1),
+	sessionId: z.string().min(1),
+	expectedRootGeneration: z.string().min(1),
+	data: z.string()
+});
 const PtyResizeMessageSchema = z.object({
 	type: z.literal("resize"),
 	sessionId: z.string().min(1),
@@ -5507,6 +6503,7 @@ const PtyListMessageSchema = z.object({ type: z.literal("list") });
 const PtyClientMessageSchema = z.discriminatedUnion("type", [
 	PtyCreateMessageSchema,
 	PtyInputMessageSchema,
+	PtyWorkflowInputMessageSchema,
 	PtyResizeMessageSchema,
 	PtyCloseMessageSchema,
 	PtyAttachMessageSchema,
@@ -5516,7 +6513,23 @@ const PtyCreatedResponseSchema = z.object({
 	type: z.literal("created"),
 	requestId: z.string().min(1),
 	sessionId: z.string().min(1),
-	platform: PtyPlatformSchema
+	platform: PtyPlatformSchema,
+	cwdTarget: TerminalCwdTargetSchema,
+	initialCwd: z.string().min(1),
+	rootGeneration: z.string().min(1).nullable()
+});
+/** Confirms that guarded workflow input reached the Server-owned PTY session. */
+const PtyWorkflowInputAcceptedResponseSchema = z.object({
+	type: z.literal("workflow-input-accepted"),
+	requestId: z.string().min(1),
+	sessionId: z.string().min(1)
+});
+/** Rejects guarded workflow input before PTY write while preserving the Server-owned reason. */
+const PtyWorkflowInputRejectedResponseSchema = z.object({
+	type: z.literal("workflow-input-rejected"),
+	requestId: z.string().min(1),
+	sessionId: z.string().min(1),
+	message: z.string().min(1)
 });
 const PtyOutputResponseSchema = z.object({
 	type: z.literal("output"),
@@ -5585,7 +6598,8 @@ const PtyErrorCodeSchema = z.enum([
 	"INVALID_JSON",
 	"INVALID_MESSAGE",
 	"SESSION_NOT_FOUND",
-	"PTY_CREATE_FAILED"
+	"PTY_CREATE_FAILED",
+	"UNAUTHORIZED"
 ]);
 const PtyErrorResponseSchema = z.object({
 	type: z.literal("error"),
@@ -5595,6 +6609,8 @@ const PtyErrorResponseSchema = z.object({
 });
 const PtyServerMessageSchema = z.discriminatedUnion("type", [
 	PtyCreatedResponseSchema,
+	PtyWorkflowInputAcceptedResponseSchema,
+	PtyWorkflowInputRejectedResponseSchema,
 	PtyOutputResponseSchema,
 	PtyExitResponseSchema,
 	PtyTitleResponseSchema,
@@ -5609,4 +6625,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { AI_TOOLS, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, ApplyTaskSchema, 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, CliExecutor, 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, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, DocumentTranslationConfigSchema, DocumentTranslationConfigUpdateSchema, DocumentTranslationDisplayModeSchema, DocumentTranslationGlobalSettingsUpdateSchema, 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_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_HOOKS_VERSION, OPENSPECUI_RUNTIME_CAPABILITIES, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecUIGlobalSettingsSchema, OpenSpecUIGlobalSettingsUpdateSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxConfigSchema, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBellResponseSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyProcessTitleResponseSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SERVICE_TRANSLATION_ENGINE_IDS, SILENT_SOUND_ID, ScenarioStepKeywordSchema, ScenarioStepSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, ServiceTranslationEngineIdSchema, SoundConfigIdSchema, SoundIdSchema, SpecSchema, StoreDoctorResultSchema, StoreListResultSchema, 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, TOOL_WORKFLOW_TO_SKILL_DIR, TRANSLATION_CACHE_POLICY_VERSION, TRANSLATION_ENGINE_IDS, TRANSLATION_ENGINE_MANIFESTS, TRANSLATOR_CONTRACT_VERSION, TaskSchema, TemplatesSchema, TerminalBellSoundSchema, TerminalCommandFieldSchema, TerminalConfigSchema, TerminalControlParser, TerminalInvocationSettingsSchema, TerminalNotificationParser, TerminalRendererEngineSchema, TerminalShellProfileSchema, TerminalShellQuoteStyleSchema, TerminalSpawnCommandSchema, TerminalThemeModeSchema, TerminalThemeSchema, 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, acquireWatcher, annotateOpenSpecFacts, annotateOpenSpecMarkdown, buildBackendHealthPayload, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, buildLocalDownloadPlanFromRepositoryFiles, buildLocalDownloadPlanFromRuntimeProfileFiles, buildMarkdownParentMap, buildOpsxEntityDetail, buildRuntimePackageInstallCommand, builtinOpenSpecReadingPlugin, checkLocalDirectionalModelLanguagePair, classifyStoreCliOutput, clearCache, closeAllProjectWatchers, closeAllWatchers, computeTaskProgress, contextStorage, createCleanCliEnv, createFileChangeObservable, createMarkdownReadingDocument, createMarkdownReadingDocumentFromFacts, createOpenSpecReadingPlugin, createTranslationEngineLifecycleStatus, customHashFromSoundId, detectRuntimePackageManager, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getBuiltinSoundUrl, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDefaultGlobalSettingsPath, getDetectedProjectTools, getManagedLocalTranslationEngineManifest, getMarkdownAnnotation, getMarkdownAnnotationsForFact, getMarkdownFactSpan, getMarkdownHeadingEnd, getMarkdownHeadingFacts, getNotificationGroupKey, getNotificationGroupLabel, getOpenSpecAnnotation, getOpenSpecAnnotationsForFact, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, getOpsxEntityMetadataPath, getOpsxEntityRootRelativePath, getProjectWatcher, getTerminalCommandDefaultValues, getToolById, getToolInitStates, getTranslationEngineLifecycleMessage, getTranslationEngineManifest, getWatchedProjectDir, getWatcherRuntimeStatus, groupNotifications, inferFileMime, inferFilePreviewKind, inferLocalDirectionalModelLanguagePair, initWatcherPool, isBackendHealthRuntimeMetadata, isBatchTranslationAbort, isDirectionalManagedLocalTranslationEngineId, isGlobPattern, isHostedBackendHealthResponse, isManagedLocalTranslationEngineId, isMarkdownTaskSourcePath, isOpsxGlobPattern, isPreviewableFile, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isTextLikeFile, isTextLikeMime, isToolConfigured, isTranslationEngineDependencyReady, isTranslationEngineRuntimeReady, isWatcherPoolInitialized, normalizeBatchTranslationError, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, normalizeLegacySoundId, normalizeOpsxEntityPath, openSpecAnnotationRules, opsxGlobToRegex, opsxPathMatchesPattern, parseCliCommand, parseMarkdownFacts, parseMarkdownTasks, parseOpenSpecMarkdownToSpec, parseOpsxEntityMetadata, parseOpsxSchemaDetail, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown, projectTasksFromMarkdownFiles, quoteTerminalShellArg, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, renderTerminalCommandArgs, renderTerminalSpawnCommandLine, resolveHostedAppBaseUrl, resolveRuntimePackageInstallStrategy, resolveTerminalShellDefaults, runControlledTranslationTask, selectLocalDownloadGroup, shouldShowTranslationEngineInstallGate, sniffGlobalCli, sortMarkdownReadingPlugins, soundIdFromCustomHash, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, toMarkdownFactKind, toOpsxDisplayPath, toPersistedGlobalSettings, toStoreFeatureResult, trimMarkdownSlice };
+export { ACCESS_GATE_CREDENTIAL_BYTES, AI_TOOLS, ApplyInstructionsContextFilesSchema, ApplyInstructionsProjectionSchema, ApplyInstructionsSchema, ApplyTaskSchema, 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, 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, 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_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, 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, 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, SERVICE_TRANSLATION_ENGINE_IDS, SILENT_SOUND_ID, ScenarioStepKeywordSchema, ScenarioStepSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, 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, asEnvUri, buildBackendHealthPayload, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, buildLocalDownloadPlanFromRepositoryFiles, buildLocalDownloadPlanFromRuntimeProfileFiles, buildMarkdownParentMap, buildOpsxEntityDetail, buildRuntimePackageInstallCommand, buildSpecCatalog, builtinOpenSpecReadingPlugin, checkLocalDirectionalModelLanguagePair, classifyStoreCliResult, clearCache, cliProjectionStates, closeAllProjectWatchers, closeAllWatchers, 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, inspectProjectBinding, isBackendHealthRuntimeMetadata, isBatchTranslationAbort, isDirectionalManagedLocalTranslationEngineId, isGlobPattern, isHostedBackendHealthResponse, isManagedLocalTranslationEngineId, isMarkdownTaskSourcePath, isOpsxCoreWorkflowSelection, isOpsxGlobPattern, isPreviewableFile, isReferencedSpecIdentity, isSupportedEmbeddedUiUrl, isTerminalMutationStatus, isTerminalRendererEngine, isTextLikeFile, isTextLikeMime, isToolConfigured, isTranslationEngineDependencyReady, isTranslationEngineRuntimeReady, isWatcherPoolInitialized, mergeSpecCatalog, normalizeAccessGatePassword, normalizeBatchTranslationError, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, normalizeLegacySoundId, normalizeOpsxEntityPath, openSpecAnnotationRules, opsxGlobToRegex, opsxPathMatchesPattern, parseCliCommand, parseCliCommandResult, parseMarkdownFacts, parseMarkdownTasks, parseOpenSpecMarkdownToSpec, parseOpsxEntityMetadata, parseOpsxSchemaDetail, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown, projectTaskProjectionsFromMarkdownFiles, quoteTerminalShellArg, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, redactSnapshotForPublication, removePhysicalReactivePath, renderTerminalCommandArgs, renderTerminalSpawnCommandLine, requireCanonicalOpenSpecEntityId, requireOpenSpecEntityRelativePath, resolveHostedAppBaseUrl, resolveOpenSpecDataScope, resolveRootContext, resolveRuntimePackageInstallStrategy, resolveTerminalShellDefaults, runControlledTranslationTask, runPhysicalReactivePathMutation, selectLocalDownloadGroup, shouldShowTranslationEngineInstallGate, snapshotHasAbsolutePath, sniffGlobalCli, sortMarkdownReadingPlugins, soundIdFromCustomHash, specIdentityFromRoute, specIdentityKey, specRoutePath, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, toCliProjectionCommandEvidence, toCliProjectionFailure, toCliProjectionNotice, toMarkdownFactKind, toOpsxDisplayPath, toPersistedGlobalSettings, toStoreFeatureResult, toggleMarkdownTask, trimMarkdownSlice, updateProjectBindingContent, updateReactiveFileCache, writePhysicalReactiveFile };