@openspecui/core 3.6.1 → 3.7.0

package/dist/index.d.mts

@@ -1,14 +1,18 @@
-import { a as buildHostedLaunchUrl, c as normalizeEmbeddedUiUrl, i as buildEmbeddedUiLaunchUrl, l as normalizeHostedAppBaseUrl, n as HostedBackendHealthResponse, o as isHostedBackendHealthResponse, r as OFFICIAL_APP_BASE_URL, s as isSupportedEmbeddedUiUrl, t as HOSTED_SHELL_PROTOCOL_VERSION, u as resolveHostedAppBaseUrl } from "./hosted-app-DZrYivji.mjs";
-import { A as Spec, C as DeltaSpec, D as ScenarioStep, E as RequirementSchema, M as Task, N as TaskSchema, O as ScenarioStepKeywordSchema, S as DeltaSchema, T as Requirement, _ as ChangeFileSchema, a as OpenSpecReadingSectionsProjection, b as DeltaOperation, c as ProjectedOpenSpecDocument, d as getOpenSpecReadingSections, f as parseOpenSpecMarkdownToSpec, g as ChangeFile, h as Change, i as OpenSpecProjectionOptions, j as SpecSchema, k as ScenarioStepSchema, l as createOpenSpecReadingPlugin, m as projectOpenSpecMarkdown, n as OPEN_SPEC_SPEC_PROJECTION_ID, o as OpenSpecRequirementBlock, p as projectAnnotatedOpenSpecToSpec, r as OpenSpecHeadingSection, s as OpenSpecScenarioBlock, t as OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, u as getOpenSpecProjectionAnnotation, v as ChangeSchema, w as DeltaSpecSchema, x as DeltaOperationType, y as Delta } from "./openspec-projection-DmB448No.mjs";
-import { a as MarkdownSourceRange, i as MarkdownSourcePoint, n as MarkdownFactKind, o as parseMarkdownFacts, r as MarkdownFactsDocument, s as toMarkdownFactKind, t as MarkdownFact } from "./markdown-facts-f3kXnqXb.mjs";
-import { _ as getMarkdownFactSpan, a as MarkdownAnnotationRule, b as trimMarkdownSlice, c as MarkdownProjectionRule, d as MarkdownReadingPlugin, f as buildMarkdownParentMap, g as getMarkdownAnnotationsForFact, h as getMarkdownAnnotation, i as MarkdownAnnotationInput, l as MarkdownReadingDocument, m as createMarkdownReadingDocumentFromFacts, n as MarkdownAnnotationConfidence, o as MarkdownFactSpan, p as createMarkdownReadingDocument, r as MarkdownAnnotationContext, s as MarkdownProjectionContext, t as MarkdownAnnotation, u as MarkdownReadingLookup, v as getMarkdownHeadingEnd, y as getMarkdownHeadingFacts } from "./markdown-reading-D36W693c.mjs";
-import { c as OpenSpecScenarioStepKeyword, d as annotateOpenSpecMarkdown, f as builtinOpenSpecReadingPlugin, h as openSpecAnnotationRules, l as OpenSpecSemanticKind, m as getOpenSpecAnnotationsForFact, n as OpenSpecAnnotation, p as getOpenSpecAnnotation, r as OpenSpecAnnotationConfidence, t as AnnotatedOpenSpecDocument, u as annotateOpenSpecFacts } from "./openspec-annotations-CJmYcfAu.mjs";
-import { D as normalizeLegacySoundId, E as getBuiltinSoundUrl, O as soundIdFromCustomHash, S as SoundIdSchema, T as customHashFromSoundId, a as BuiltinSoundOption, b as SoundConfigIdSchema, c as CustomSoundHashSchema, d as CustomSoundMetadata, f as CustomSoundMetadataFile, g as DEFAULT_NOTIFICATION_SOUND_ID, h as DEFAULT_BELL_SOUND_ID, i as BuiltinSoundIdSchema, l as CustomSoundId, m as CustomSoundMetadataSchema, n as BUILTIN_SOUND_OPTIONS, o as CUSTOM_SOUND_ADD_VALUE, p as CustomSoundMetadataFileSchema, r as BuiltinSoundId, s as CustomSoundHash, t as BUILTIN_SOUND_IDS, u as CustomSoundIdSchema, v as LEGACY_SOUND_ID_MAP, x as SoundId, y as SILENT_SOUND_ID } from "./sounds-B0sH3QwE.mjs";
-import { A as TerminalNotificationProtocol, D as TerminalControlEvent, E as groupNotifications, M as TerminalPromptState, N as TerminalTitleTarget, O as TerminalControlParseResult, P as terminalNotificationEventToPublishInput, T as getNotificationGroupLabel, _ as NotificationSource, b as TerminalNotificationParseResult, c as NotificationGroupKeySchema, d as NotificationRecord, f as NotificationRecordSchema, g as NotificationSoundSchema, h as NotificationSound, i as NotificationActionSchema, j as TerminalProgressState, k as TerminalControlParser, l as NotificationPublishInput, m as NotificationSettingsSchema, n as NOTIFICATION_SOUND_VALUES, o as NotificationGroup, p as NotificationSettings, r as NotificationAction, s as NotificationGroupKey, t as NOTIFICATION_SOUND_OPTIONS, u as NotificationPublishInputSchema, v as NotificationSourceSchema, w as getNotificationGroupKey, x as TerminalNotificationParser, y as TerminalNotificationEvent } from "./notifications-CCV2bgWG.mjs";
-import { i as TerminalBellSoundSchema, n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSound, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-qSc6nZUI.mjs";
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-CkV9sq_j.mjs";
-import { $ as PtyServerMessageSchema, B as PtyCreatedResponseSchema, C as TerminalSpawnCommand, E as getTerminalCommandDefaultValues, F as PtyBufferResponseSchema, G as PtyListMessageSchema, H as PtyErrorResponseSchema, I as PtyClientMessage, J as PtyPlatform, K as PtyListResponseSchema, L as PtyClientMessageSchema, M as resolveTerminalShellDefaults, N as PtyAttachMessageSchema, O as quoteTerminalShellArg, P as PtyBellResponseSchema, Q as PtyServerMessage, R as PtyCloseMessageSchema, S as TerminalShellQuoteStyleSchema, U as PtyExitResponseSchema, V as PtyErrorCodeSchema, W as PtyInputMessageSchema, X as PtyProcessTitleResponseSchema, Y as PtyPlatformSchema, Z as PtyResizeMessageSchema, _ as TerminalShellDefaults, b as TerminalShellProfileSchema, c as TerminalCommandFieldSchema, et as PtySessionInfo, g as TerminalInvocationSettingsSchema, h as TerminalInvocationSettings, i as TerminalCommandArgument, j as renderTerminalSpawnCommandLine, k as renderTerminalCommandArgs, l as TerminalCommandFieldValue, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, q as PtyOutputResponseSchema, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalCommandField, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, tt as PtyTitleResponseSchema, u as TerminalCommandFieldValues, w as TerminalSpawnCommandSchema, x as TerminalShellQuoteStyle, y as TerminalShellProfile, z as PtyCreateMessageSchema } from "./terminal-invocation-BCqjtd4p.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-lPZGfVA_.mjs";
+import { a as DocumentTranslationDisplayModeSchema, i as DocumentTranslationDisplayMode, n as DocumentTranslationConfig, r as DocumentTranslationConfigSchema, t as DOCUMENT_TRANSLATION_DISPLAY_MODES } from "./document-translation-CuCbRCNb.mjs";
+import { a as buildHostedLaunchUrl, c as normalizeEmbeddedUiUrl, i as buildEmbeddedUiLaunchUrl, l as normalizeHostedAppBaseUrl, n as HostedBackendHealthResponse, o as isHostedBackendHealthResponse, r as OFFICIAL_APP_BASE_URL, s as isSupportedEmbeddedUiUrl, t as HOSTED_SHELL_PROTOCOL_VERSION, u as resolveHostedAppBaseUrl } from "./hosted-app-DHrXW3jc.mjs";
+import { A as SchemaArtifactSchema, C as ArtifactStatus, D as DependencyInfo, E as ChangeStatusSchema, F as SchemaResolution, I as SchemaResolutionSchema, L as TemplatesMap, M as SchemaDetailSchema, N as SchemaInfo, O as DependencyInfoSchema, P as SchemaInfoSchema, R as TemplatesSchema, S as ArtifactInstructionsSchema, T as ChangeStatus, _ as ApplyInstructionsContextFilesSchema, a as OpsxEntityFile, b as ApplyTaskSchema, c as buildOpsxEntityDetail, d as isOpsxGlobPattern, f as normalizeOpsxEntityPath, g as ApplyInstructions, h as parseOpsxEntityMetadata, i as OpsxEntityDiagnostic, j as SchemaDetail, k as SchemaArtifact, l as getOpsxEntityMetadataPath, m as opsxPathMatchesPattern, n as OpsxEntityArtifactFile, o as OpsxEntityReadOptions, p as opsxGlobToRegex, r as OpsxEntityDetail, s as OpsxEntityStage, t as OpsxEntityArtifact, u as getOpsxEntityRootRelativePath, v as ApplyInstructionsSchema, w as ArtifactStatusSchema, x as ArtifactInstructions, y as ApplyTask, z as isGlobPattern } from "./opsx-entity-Cz89hbt3.mjs";
+import { _ as SpecSchema, a as Delta, c as DeltaSchema, d as Requirement, f as RequirementSchema, g as Spec, h as ScenarioStepSchema, i as ChangeSchema, l as DeltaSpec, m as ScenarioStepKeywordSchema, n as ChangeFile, o as DeltaOperation, p as ScenarioStep, r as ChangeFileSchema, s as DeltaOperationType, t as Change, u as DeltaSpecSchema, v as Task, y as TaskSchema } from "./schemas-q7tGvvxx.mjs";
+import { a as MarkdownSourceRange, i as MarkdownSourcePoint, n as MarkdownFactKind, o as parseMarkdownFacts, r as MarkdownFactsDocument, s as toMarkdownFactKind, t as MarkdownFact } from "./markdown-facts-DxElzSsp.mjs";
+import { S as trimMarkdownSlice, _ as getMarkdownAnnotationsForFact, a as MarkdownAnnotationRule, b as getMarkdownHeadingFacts, c as MarkdownProjectionRule, d as MarkdownReadingPlugin, f as MarkdownReadingPluginRegistry, g as getMarkdownAnnotation, h as createMarkdownReadingDocumentFromFacts, i as MarkdownAnnotationInput, l as MarkdownReadingDocument, m as createMarkdownReadingDocument, n as MarkdownAnnotationConfidence, o as MarkdownFactSpan, p as buildMarkdownParentMap, r as MarkdownAnnotationContext, s as MarkdownProjectionContext, t as MarkdownAnnotation, u as MarkdownReadingLookup, v as getMarkdownFactSpan, x as sortMarkdownReadingPlugins, y as getMarkdownHeadingEnd } from "./markdown-reading-BC6uFgx0.mjs";
+import { c as OpenSpecScenarioStepKeyword, d as annotateOpenSpecMarkdown, f as builtinOpenSpecReadingPlugin, h as openSpecAnnotationRules, l as OpenSpecSemanticKind, m as getOpenSpecAnnotationsForFact, n as OpenSpecAnnotation, p as getOpenSpecAnnotation, r as OpenSpecAnnotationConfidence, t as AnnotatedOpenSpecDocument, u as annotateOpenSpecFacts } from "./openspec-annotations-DKP1Uuho.mjs";
+import { a as OpenSpecReadingSectionsProjection, c as ProjectedOpenSpecDocument, d as getOpenSpecReadingSections, f as parseOpenSpecMarkdownToSpec, i as OpenSpecProjectionOptions, l as createOpenSpecReadingPlugin, m as projectOpenSpecMarkdown, n as OPEN_SPEC_SPEC_PROJECTION_ID, o as OpenSpecRequirementBlock, p as projectAnnotatedOpenSpecToSpec, r as OpenSpecHeadingSection, s as OpenSpecScenarioBlock, t as OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, u as getOpenSpecProjectionAnnotation } from "./openspec-projection-Co3CUAHe.mjs";
+import { D as normalizeLegacySoundId, E as getBuiltinSoundUrl, O as soundIdFromCustomHash, S as SoundIdSchema, T as customHashFromSoundId, a as BuiltinSoundOption, b as SoundConfigIdSchema, c as CustomSoundHashSchema, d as CustomSoundMetadata, f as CustomSoundMetadataFile, g as DEFAULT_NOTIFICATION_SOUND_ID, h as DEFAULT_BELL_SOUND_ID, i as BuiltinSoundIdSchema, l as CustomSoundId, m as CustomSoundMetadataSchema, n as BUILTIN_SOUND_OPTIONS, o as CUSTOM_SOUND_ADD_VALUE, p as CustomSoundMetadataFileSchema, r as BuiltinSoundId, s as CustomSoundHash, t as BUILTIN_SOUND_IDS, u as CustomSoundIdSchema, v as LEGACY_SOUND_ID_MAP, x as SoundId, y as SILENT_SOUND_ID } from "./sounds-BORGLPIt.mjs";
+import { A as TerminalNotificationProtocol, D as TerminalControlEvent, E as groupNotifications, M as TerminalPromptState, N as TerminalTitleTarget, O as TerminalControlParseResult, P as terminalNotificationEventToPublishInput, T as getNotificationGroupLabel, _ as NotificationSource, b as TerminalNotificationParseResult, c as NotificationGroupKeySchema, d as NotificationRecord, f as NotificationRecordSchema, g as NotificationSoundSchema, h as NotificationSound, i as NotificationActionSchema, j as TerminalProgressState, k as TerminalControlParser, l as NotificationPublishInput, m as NotificationSettingsSchema, n as NOTIFICATION_SOUND_VALUES, o as NotificationGroup, p as NotificationSettings, r as NotificationAction, s as NotificationGroupKey, t as NOTIFICATION_SOUND_OPTIONS, u as NotificationPublishInputSchema, v as NotificationSourceSchema, w as getNotificationGroupKey, x as TerminalNotificationParser, y as TerminalNotificationEvent } from "./notifications-CbKmEdCU.mjs";
+import { i as TerminalBellSoundSchema, n as TERMINAL_BELL_SOUND_VALUES, r as TerminalBellSound, t as TERMINAL_BELL_SOUND_OPTIONS } from "./terminal-audio-Dmi6lR7o.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-BKUYCqwP.mjs";
+import { $ as PtyServerMessageSchema, B as PtyCreatedResponseSchema, C as TerminalSpawnCommand, E as getTerminalCommandDefaultValues, F as PtyBufferResponseSchema, G as PtyListMessageSchema, H as PtyErrorResponseSchema, I as PtyClientMessage, J as PtyPlatform, K as PtyListResponseSchema, L as PtyClientMessageSchema, M as resolveTerminalShellDefaults, N as PtyAttachMessageSchema, O as quoteTerminalShellArg, P as PtyBellResponseSchema, Q as PtyServerMessage, R as PtyCloseMessageSchema, S as TerminalShellQuoteStyleSchema, U as PtyExitResponseSchema, V as PtyErrorCodeSchema, W as PtyInputMessageSchema, X as PtyProcessTitleResponseSchema, Y as PtyPlatformSchema, Z as PtyResizeMessageSchema, _ as TerminalShellDefaults, b as TerminalShellProfileSchema, c as TerminalCommandFieldSchema, et as PtySessionInfo, g as TerminalInvocationSettingsSchema, h as TerminalInvocationSettings, i as TerminalCommandArgument, j as renderTerminalSpawnCommandLine, k as renderTerminalCommandArgs, l as TerminalCommandFieldValue, n as TERMINAL_COMMAND_FIELD_TYPE_VALUES, q as PtyOutputResponseSchema, r as TERMINAL_SHELL_QUOTE_STYLE_VALUES, s as TerminalCommandField, t as BUILTIN_TERMINAL_SPAWN_COMMANDS, tt as PtyTitleResponseSchema, u as TerminalCommandFieldValues, w as TerminalSpawnCommandSchema, x as TerminalShellQuoteStyle, y as TerminalShellProfile, z as PtyCreateMessageSchema } from "./terminal-invocation-C733ofmf.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-DdhVuegL.mjs";
+import { n as parseOpsxSchemaDetail, t as ParsedOpsxSchemaDetail } from "./opsx-schema-detail-CuDl2xjZ.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { z } from "zod";
 import { EventEmitter } from "events";
@@ -116,6 +120,7 @@ declare class OpenSpecAdapter {
   readChange(changeId: string): Promise<Change | null>;
   readChangeFiles(changeId: string): Promise<ChangeFile[]>;
   readArchivedChangeFiles(changeId: string): Promise<ChangeFile[]>;
+  readEntityDetail(stage: 'change' | 'archive', id: string, options?: OpsxEntityReadOptions): Promise<OpsxEntityDetail | null>;
   private readFilesUnderRoot;
   private collectChangeFiles;
   readChangeRaw(changeId: string): Promise<{
@@ -158,8 +163,8 @@ declare class OpenSpecAdapter {
       name: string;
       overview: string;
       requirements: {
-        id: string;
         title: string;
+        id: string;
         text: string;
         bodyMarkdown: string;
         scenarios: {
@@ -182,6 +187,10 @@ declare class OpenSpecAdapter {
     changes: {
       id: string;
       name: string;
+      progress: {
+        completed: number;
+        total: number;
+      };
       why: string;
       whatChanges: string;
       deltas: {
@@ -189,8 +198,8 @@ declare class OpenSpecAdapter {
         spec: string;
         operation: "ADDED" | "MODIFIED" | "REMOVED" | "RENAMED";
         requirements?: {
-          id: string;
           title: string;
+          id: string;
           text: string;
           bodyMarkdown: string;
           scenarios: {
@@ -205,8 +214,8 @@ declare class OpenSpecAdapter {
           }[];
         }[] | undefined;
         requirement?: {
-          id: string;
           title: string;
+          id: string;
           text: string;
           bodyMarkdown: string;
           scenarios: {
@@ -231,10 +240,6 @@ declare class OpenSpecAdapter {
         completed: boolean;
         section?: string | undefined;
       }[];
-      progress: {
-        completed: number;
-        total: number;
-      };
       metadata?: {
         version: string;
         format: "openspec-change";
@@ -851,7 +856,7 @@ declare const TerminalConfigSchema: z.ZodObject<{
   lightTheme: z.ZodDefault<z.ZodEnum<["default-light", "default-dark", "monokai", "nord", "solarized-light", "solarized-dark"]>>;
   darkTheme: z.ZodDefault<z.ZodEnum<["default-light", "default-dark", "monokai", "nord", "solarized-light", "solarized-dark"]>>;
   rendererEngine: z.ZodDefault<z.ZodString>;
-  bellSound: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"silent">, z.ZodEnum<["builtin:Basso", "builtin:Blow", "builtin:Bottle", "builtin:Frog", "builtin:Funk", "builtin:Glass", "builtin:Hero", "builtin:Morse", "builtin:Ping", "builtin:Pop", "builtin:Purr", "builtin:Sosumi", "builtin:Submarine", "builtin:Tink"]>, z.ZodType<`custom:${string}`, z.ZodTypeDef, `custom:${string}`>]>, "silent" | "builtin:Tink" | "builtin:Blow" | "builtin:Basso" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | `custom:${string}`, unknown>>;
+  bellSound: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"silent">, z.ZodEnum<["builtin:Basso", "builtin:Blow", "builtin:Bottle", "builtin:Frog", "builtin:Funk", "builtin:Glass", "builtin:Hero", "builtin:Morse", "builtin:Ping", "builtin:Pop", "builtin:Purr", "builtin:Sosumi", "builtin:Submarine", "builtin:Tink"]>, z.ZodType<`custom:${string}`, z.ZodTypeDef, `custom:${string}`>]>, "silent" | "builtin:Basso" | "builtin:Blow" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | "builtin:Tink" | `custom:${string}`, unknown>>;
   bellVolume: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
   fontSize: number;
@@ -863,7 +868,7 @@ declare const TerminalConfigSchema: z.ZodObject<{
   lightTheme: "default-light" | "default-dark" | "monokai" | "nord" | "solarized-light" | "solarized-dark";
   darkTheme: "default-light" | "default-dark" | "monokai" | "nord" | "solarized-light" | "solarized-dark";
   rendererEngine: string;
-  bellSound: "silent" | "builtin:Tink" | "builtin:Blow" | "builtin:Basso" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | `custom:${string}`;
+  bellSound: "silent" | "builtin:Basso" | "builtin:Blow" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | "builtin:Tink" | `custom:${string}`;
   bellVolume: number;
 }, {
   fontSize?: number | undefined;
@@ -954,7 +959,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     lightTheme: z.ZodDefault<z.ZodEnum<["default-light", "default-dark", "monokai", "nord", "solarized-light", "solarized-dark"]>>;
     darkTheme: z.ZodDefault<z.ZodEnum<["default-light", "default-dark", "monokai", "nord", "solarized-light", "solarized-dark"]>>;
     rendererEngine: z.ZodDefault<z.ZodString>;
-    bellSound: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"silent">, z.ZodEnum<["builtin:Basso", "builtin:Blow", "builtin:Bottle", "builtin:Frog", "builtin:Funk", "builtin:Glass", "builtin:Hero", "builtin:Morse", "builtin:Ping", "builtin:Pop", "builtin:Purr", "builtin:Sosumi", "builtin:Submarine", "builtin:Tink"]>, z.ZodType<`custom:${string}`, z.ZodTypeDef, `custom:${string}`>]>, "silent" | "builtin:Tink" | "builtin:Blow" | "builtin:Basso" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | `custom:${string}`, unknown>>;
+    bellSound: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"silent">, z.ZodEnum<["builtin:Basso", "builtin:Blow", "builtin:Bottle", "builtin:Frog", "builtin:Funk", "builtin:Glass", "builtin:Hero", "builtin:Morse", "builtin:Ping", "builtin:Pop", "builtin:Purr", "builtin:Sosumi", "builtin:Submarine", "builtin:Tink"]>, z.ZodType<`custom:${string}`, z.ZodTypeDef, `custom:${string}`>]>, "silent" | "builtin:Basso" | "builtin:Blow" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | "builtin:Tink" | `custom:${string}`, unknown>>;
     bellVolume: z.ZodDefault<z.ZodNumber>;
   }, "strip", z.ZodTypeAny, {
     fontSize: number;
@@ -966,7 +971,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     lightTheme: "default-light" | "default-dark" | "monokai" | "nord" | "solarized-light" | "solarized-dark";
     darkTheme: "default-light" | "default-dark" | "monokai" | "nord" | "solarized-light" | "solarized-dark";
     rendererEngine: string;
-    bellSound: "silent" | "builtin:Tink" | "builtin:Blow" | "builtin:Basso" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | `custom:${string}`;
+    bellSound: "silent" | "builtin:Basso" | "builtin:Blow" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | "builtin:Tink" | `custom:${string}`;
     bellVolume: number;
   }, {
     fontSize?: number | undefined;
@@ -999,11 +1004,11 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   }>>;
   /** Notification preferences */
   notifications: z.ZodDefault<z.ZodObject<{
-    sound: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"silent">, z.ZodEnum<["builtin:Basso", "builtin:Blow", "builtin:Bottle", "builtin:Frog", "builtin:Funk", "builtin:Glass", "builtin:Hero", "builtin:Morse", "builtin:Ping", "builtin:Pop", "builtin:Purr", "builtin:Sosumi", "builtin:Submarine", "builtin:Tink"]>, z.ZodType<`custom:${string}`, z.ZodTypeDef, `custom:${string}`>]>, "silent" | "builtin:Tink" | "builtin:Blow" | "builtin:Basso" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | `custom:${string}`, unknown>>;
+    sound: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"silent">, z.ZodEnum<["builtin:Basso", "builtin:Blow", "builtin:Bottle", "builtin:Frog", "builtin:Funk", "builtin:Glass", "builtin:Hero", "builtin:Morse", "builtin:Ping", "builtin:Pop", "builtin:Purr", "builtin:Sosumi", "builtin:Submarine", "builtin:Tink"]>, z.ZodType<`custom:${string}`, z.ZodTypeDef, `custom:${string}`>]>, "silent" | "builtin:Basso" | "builtin:Blow" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | "builtin:Tink" | `custom:${string}`, unknown>>;
     volume: z.ZodDefault<z.ZodNumber>;
     systemNotificationsEnabled: z.ZodDefault<z.ZodBoolean>;
   }, "strip", z.ZodTypeAny, {
-    sound: "silent" | "builtin:Tink" | "builtin:Blow" | "builtin:Basso" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | `custom:${string}`;
+    sound: "silent" | "builtin:Basso" | "builtin:Blow" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | "builtin:Tink" | `custom:${string}`;
     volume: number;
     systemNotificationsEnabled: boolean;
   }, {
@@ -1011,6 +1016,20 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     volume?: number | undefined;
     systemNotificationsEnabled?: boolean | undefined;
   }>>;
+  /** Browser-side document translation preferences */
+  translation: z.ZodDefault<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    targetLanguage: z.ZodDefault<z.ZodString>;
+    displayMode: z.ZodDefault<z.ZodEnum<["direct", "bilingual"]>>;
+  }, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    targetLanguage: string;
+    displayMode: "direct" | "bilingual";
+  }, {
+    enabled?: boolean | undefined;
+    targetLanguage?: string | undefined;
+    displayMode?: "direct" | "bilingual" | undefined;
+  }>>;
 }, "strip", z.ZodTypeAny, {
   terminal: {
     fontSize: number;
@@ -1022,7 +1041,7 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     lightTheme: "default-light" | "default-dark" | "monokai" | "nord" | "solarized-light" | "solarized-dark";
     darkTheme: "default-light" | "default-dark" | "monokai" | "nord" | "solarized-light" | "solarized-dark";
     rendererEngine: string;
-    bellSound: "silent" | "builtin:Tink" | "builtin:Blow" | "builtin:Basso" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | `custom:${string}`;
+    bellSound: "silent" | "builtin:Basso" | "builtin:Blow" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | "builtin:Tink" | `custom:${string}`;
     bellVolume: number;
   };
   theme: "light" | "dark" | "system";
@@ -1044,10 +1063,15 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     diffEagerLineBudget: number;
   };
   notifications: {
-    sound: "silent" | "builtin:Tink" | "builtin:Blow" | "builtin:Basso" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | `custom:${string}`;
+    sound: "silent" | "builtin:Basso" | "builtin:Blow" | "builtin:Bottle" | "builtin:Frog" | "builtin:Funk" | "builtin:Glass" | "builtin:Hero" | "builtin:Morse" | "builtin:Ping" | "builtin:Pop" | "builtin:Purr" | "builtin:Sosumi" | "builtin:Submarine" | "builtin:Tink" | `custom:${string}`;
     volume: number;
     systemNotificationsEnabled: boolean;
   };
+  translation: {
+    enabled: boolean;
+    targetLanguage: string;
+    displayMode: "direct" | "bilingual";
+  };
 }, {
   terminal?: {
     fontSize?: number | undefined;
@@ -1085,6 +1109,11 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     volume?: number | undefined;
     systemNotificationsEnabled?: boolean | undefined;
   } | undefined;
+  translation?: {
+    enabled?: boolean | undefined;
+    targetLanguage?: string | undefined;
+    displayMode?: "direct" | "bilingual" | undefined;
+  } | undefined;
 }>;
 type OpenSpecUIConfig = z.infer<typeof OpenSpecUIConfigSchema>;
 type OpenSpecUIConfigUpdate = {
@@ -1100,6 +1129,7 @@ type OpenSpecUIConfigUpdate = {
   dashboard?: Partial<DashboardConfig>;
   git?: Partial<GitConfig>;
   notifications?: Partial<NotificationSettings>;
+  translation?: Partial<DocumentTranslationConfig>;
 };
 /** 默认配置（静态，用于测试和类型） */
 declare const DEFAULT_CONFIG: OpenSpecUIConfig;
@@ -1480,405 +1510,6 @@ interface DashboardOverview {
   git: DashboardGitSnapshot;
 }
 //#endregion
-//#region src/opsx-types.d.ts
-/** Check if an outputPath contains glob pattern characters */
-declare function isGlobPattern(pattern: string): boolean;
-declare const ArtifactStatusSchema: z.ZodObject<{
-  id: z.ZodString;
-  outputPath: z.ZodString;
-  status: z.ZodEnum<["done", "ready", "blocked"]>;
-  missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-  relativePath: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-  status: "done" | "ready" | "blocked";
-  id: string;
-  outputPath: string;
-  missingDeps?: string[] | undefined;
-  relativePath?: string | undefined;
-}, {
-  status: "done" | "ready" | "blocked";
-  id: string;
-  outputPath: string;
-  missingDeps?: string[] | undefined;
-  relativePath?: string | undefined;
-}>;
-type ArtifactStatus = z.infer<typeof ArtifactStatusSchema>;
-declare const ChangeStatusSchema: z.ZodObject<{
-  changeName: z.ZodString;
-  schemaName: z.ZodString;
-  isComplete: z.ZodBoolean;
-  applyRequires: z.ZodArray<z.ZodString, "many">;
-  artifacts: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    outputPath: z.ZodString;
-    status: z.ZodEnum<["done", "ready", "blocked"]>;
-    missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    relativePath: z.ZodOptional<z.ZodString>;
-  }, "strip", z.ZodTypeAny, {
-    status: "done" | "ready" | "blocked";
-    id: string;
-    outputPath: string;
-    missingDeps?: string[] | undefined;
-    relativePath?: string | undefined;
-  }, {
-    status: "done" | "ready" | "blocked";
-    id: string;
-    outputPath: string;
-    missingDeps?: string[] | undefined;
-    relativePath?: string | undefined;
-  }>, "many">;
-}, "strip", z.ZodTypeAny, {
-  changeName: string;
-  schemaName: string;
-  isComplete: boolean;
-  applyRequires: string[];
-  artifacts: {
-    status: "done" | "ready" | "blocked";
-    id: string;
-    outputPath: string;
-    missingDeps?: string[] | undefined;
-    relativePath?: string | undefined;
-  }[];
-}, {
-  changeName: string;
-  schemaName: string;
-  isComplete: boolean;
-  applyRequires: string[];
-  artifacts: {
-    status: "done" | "ready" | "blocked";
-    id: string;
-    outputPath: string;
-    missingDeps?: string[] | undefined;
-    relativePath?: string | undefined;
-  }[];
-}>;
-type ChangeStatus = z.infer<typeof ChangeStatusSchema>;
-declare const DependencyInfoSchema: z.ZodObject<{
-  id: z.ZodString;
-  done: z.ZodBoolean;
-  path: z.ZodString;
-  description: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-  path: string;
-  id: string;
-  description: string;
-  done: boolean;
-}, {
-  path: string;
-  id: string;
-  description: string;
-  done: boolean;
-}>;
-type DependencyInfo = z.infer<typeof DependencyInfoSchema>;
-declare const ApplyTaskSchema: z.ZodObject<{
-  id: z.ZodString;
-  description: z.ZodString;
-  done: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-  id: string;
-  description: string;
-  done: boolean;
-}, {
-  id: string;
-  description: string;
-  done: boolean;
-}>;
-type ApplyTask = z.infer<typeof ApplyTaskSchema>;
-declare const ApplyInstructionsContextFilesSchema: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
-declare const ApplyInstructionsSchema: z.ZodObject<{
-  changeName: z.ZodString;
-  changeDir: z.ZodString;
-  schemaName: z.ZodString;
-  contextFiles: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
-  progress: z.ZodObject<{
-    total: z.ZodNumber;
-    complete: z.ZodNumber;
-    remaining: z.ZodNumber;
-  }, "strip", z.ZodTypeAny, {
-    total: number;
-    complete: number;
-    remaining: number;
-  }, {
-    total: number;
-    complete: number;
-    remaining: number;
-  }>;
-  tasks: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    description: z.ZodString;
-    done: z.ZodBoolean;
-  }, "strip", z.ZodTypeAny, {
-    id: string;
-    description: string;
-    done: boolean;
-  }, {
-    id: string;
-    description: string;
-    done: boolean;
-  }>, "many">;
-  state: z.ZodEnum<["blocked", "all_done", "ready"]>;
-  missingArtifacts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-  instruction: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-  tasks: {
-    id: string;
-    description: string;
-    done: boolean;
-  }[];
-  progress: {
-    total: number;
-    complete: number;
-    remaining: number;
-  };
-  state: "ready" | "blocked" | "all_done";
-  changeName: string;
-  schemaName: string;
-  changeDir: string;
-  contextFiles: Record<string, string[]>;
-  instruction: string;
-  missingArtifacts?: string[] | undefined;
-}, {
-  tasks: {
-    id: string;
-    description: string;
-    done: boolean;
-  }[];
-  progress: {
-    total: number;
-    complete: number;
-    remaining: number;
-  };
-  state: "ready" | "blocked" | "all_done";
-  changeName: string;
-  schemaName: string;
-  changeDir: string;
-  contextFiles: Record<string, string | string[]>;
-  instruction: string;
-  missingArtifacts?: string[] | undefined;
-}>;
-type ApplyInstructions = z.infer<typeof ApplyInstructionsSchema>;
-declare const ArtifactInstructionsSchema: z.ZodObject<{
-  changeName: z.ZodString;
-  artifactId: z.ZodString;
-  schemaName: z.ZodString;
-  changeDir: z.ZodString;
-  outputPath: z.ZodString;
-  description: z.ZodString;
-  instruction: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  rules: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
-  template: z.ZodString;
-  dependencies: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    done: z.ZodBoolean;
-    path: z.ZodString;
-    description: z.ZodString;
-  }, "strip", z.ZodTypeAny, {
-    path: string;
-    id: string;
-    description: string;
-    done: boolean;
-  }, {
-    path: string;
-    id: string;
-    description: string;
-    done: boolean;
-  }>, "many">;
-  unlocks: z.ZodArray<z.ZodString, "many">;
-}, "strip", z.ZodTypeAny, {
-  description: string;
-  template: string;
-  outputPath: string;
-  changeName: string;
-  schemaName: string;
-  changeDir: string;
-  artifactId: string;
-  dependencies: {
-    path: string;
-    id: string;
-    description: string;
-    done: boolean;
-  }[];
-  unlocks: string[];
-  instruction?: string | null | undefined;
-  context?: string | null | undefined;
-  rules?: string[] | null | undefined;
-}, {
-  description: string;
-  template: string;
-  outputPath: string;
-  changeName: string;
-  schemaName: string;
-  changeDir: string;
-  artifactId: string;
-  dependencies: {
-    path: string;
-    id: string;
-    description: string;
-    done: boolean;
-  }[];
-  unlocks: string[];
-  instruction?: string | null | undefined;
-  context?: string | null | undefined;
-  rules?: string[] | null | undefined;
-}>;
-type ArtifactInstructions = z.infer<typeof ArtifactInstructionsSchema>;
-declare const SchemaInfoSchema: z.ZodObject<{
-  name: z.ZodString;
-  description: z.ZodOptional<z.ZodString>;
-  artifacts: z.ZodArray<z.ZodString, "many">;
-  source: z.ZodEnum<["project", "user", "package"]>;
-}, "strip", z.ZodTypeAny, {
-  name: string;
-  source: "project" | "user" | "package";
-  artifacts: string[];
-  description?: string | undefined;
-}, {
-  name: string;
-  source: "project" | "user" | "package";
-  artifacts: string[];
-  description?: string | undefined;
-}>;
-type SchemaInfo = z.infer<typeof SchemaInfoSchema>;
-declare const SchemaResolutionSchema: z.ZodObject<{
-  name: z.ZodString;
-  source: z.ZodEnum<["project", "user", "package"]>;
-  path: z.ZodString;
-  displayPath: z.ZodOptional<z.ZodString>;
-  shadows: z.ZodArray<z.ZodObject<{
-    source: z.ZodEnum<["project", "user", "package"]>;
-    path: z.ZodString;
-    displayPath: z.ZodOptional<z.ZodString>;
-  }, "strip", z.ZodTypeAny, {
-    path: string;
-    source: "project" | "user" | "package";
-    displayPath?: string | undefined;
-  }, {
-    path: string;
-    source: "project" | "user" | "package";
-    displayPath?: string | undefined;
-  }>, "many">;
-}, "strip", z.ZodTypeAny, {
-  path: string;
-  name: string;
-  source: "project" | "user" | "package";
-  shadows: {
-    path: string;
-    source: "project" | "user" | "package";
-    displayPath?: string | undefined;
-  }[];
-  displayPath?: string | undefined;
-}, {
-  path: string;
-  name: string;
-  source: "project" | "user" | "package";
-  shadows: {
-    path: string;
-    source: "project" | "user" | "package";
-    displayPath?: string | undefined;
-  }[];
-  displayPath?: string | undefined;
-}>;
-type SchemaResolution = z.infer<typeof SchemaResolutionSchema>;
-declare const TemplatesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
-  path: z.ZodString;
-  displayPath: z.ZodOptional<z.ZodString>;
-  source: z.ZodEnum<["project", "user", "package"]>;
-}, "strip", z.ZodTypeAny, {
-  path: string;
-  source: "project" | "user" | "package";
-  displayPath?: string | undefined;
-}, {
-  path: string;
-  source: "project" | "user" | "package";
-  displayPath?: string | undefined;
-}>>;
-type TemplatesMap = z.infer<typeof TemplatesSchema>;
-declare const SchemaArtifactSchema: z.ZodObject<{
-  id: z.ZodString;
-  outputPath: z.ZodString;
-  description: z.ZodOptional<z.ZodString>;
-  template: z.ZodOptional<z.ZodString>;
-  instruction: z.ZodOptional<z.ZodString>;
-  requires: z.ZodArray<z.ZodString, "many">;
-}, "strip", z.ZodTypeAny, {
-  id: string;
-  outputPath: string;
-  requires: string[];
-  description?: string | undefined;
-  template?: string | undefined;
-  instruction?: string | undefined;
-}, {
-  id: string;
-  outputPath: string;
-  requires: string[];
-  description?: string | undefined;
-  template?: string | undefined;
-  instruction?: string | undefined;
-}>;
-type SchemaArtifact = z.infer<typeof SchemaArtifactSchema>;
-declare const SchemaDetailSchema: z.ZodObject<{
-  name: z.ZodString;
-  description: z.ZodOptional<z.ZodString>;
-  version: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-  artifacts: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    outputPath: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    template: z.ZodOptional<z.ZodString>;
-    instruction: z.ZodOptional<z.ZodString>;
-    requires: z.ZodArray<z.ZodString, "many">;
-  }, "strip", z.ZodTypeAny, {
-    id: string;
-    outputPath: string;
-    requires: string[];
-    description?: string | undefined;
-    template?: string | undefined;
-    instruction?: string | undefined;
-  }, {
-    id: string;
-    outputPath: string;
-    requires: string[];
-    description?: string | undefined;
-    template?: string | undefined;
-    instruction?: string | undefined;
-  }>, "many">;
-  applyRequires: z.ZodArray<z.ZodString, "many">;
-  applyTracks: z.ZodOptional<z.ZodString>;
-  applyInstruction: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-  name: string;
-  applyRequires: string[];
-  artifacts: {
-    id: string;
-    outputPath: string;
-    requires: string[];
-    description?: string | undefined;
-    template?: string | undefined;
-    instruction?: string | undefined;
-  }[];
-  description?: string | undefined;
-  version?: string | number | undefined;
-  applyTracks?: string | undefined;
-  applyInstruction?: string | undefined;
-}, {
-  name: string;
-  applyRequires: string[];
-  artifacts: {
-    id: string;
-    outputPath: string;
-    requires: string[];
-    description?: string | undefined;
-    template?: string | undefined;
-    instruction?: string | undefined;
-  }[];
-  description?: string | undefined;
-  version?: string | number | undefined;
-  applyTracks?: string | undefined;
-  applyInstruction?: string | undefined;
-}>;
-type SchemaDetail = z.infer<typeof SchemaDetailSchema>;
-//#endregion
 //#region src/export-types.d.ts
 /**
  * Complete snapshot of an OpenSpec project for static export
@@ -1981,22 +1612,8 @@ interface ExportSnapshot {
   archives: Array<{
     id: string;
     name: string;
-    /** Processed proposal markdown shown by default in static OpenSpecUI. */
-    proposal: string;
-    /** Original source proposal markdown. */
-    sourceProposal?: string;
-    tasks?: string;
-    sourceTasks?: string;
-    design?: string;
-    sourceDesign?: string;
-    why: string;
-    whatChanges: string;
-    parsedTasks: Array<{
-      id: string;
-      text: string;
-      completed: boolean;
-      section?: string;
-    }>;
+    /** Schema-neutral archived entity detail used by archive views, search, and dashboard facts. */
+    entity: OpsxEntityDetail;
     createdAt: number;
     updatedAt: number;
   }>;
@@ -2109,11 +1726,14 @@ type DocumentReadModeV1 = 'source' | 'processed';
 /** Stable identity for the OpenSpec document currently being read. */
 interface DocumentRefV1 {
   stage: 'project' | 'main' | 'change' | 'archive';
-  kind: 'project' | 'spec' | 'proposal' | 'design' | 'tasks' | 'delta-spec';
+  kind: 'project' | 'spec' | 'proposal' | 'design' | 'tasks' | 'delta-spec' | 'artifact';
   relativePath: string;
   absolutePath: string;
   specId?: string;
   changeId?: string;
+  schemaName?: string;
+  artifactId?: string;
+  artifactOutputPath?: string;
 }
 /** Context passed to `onReadDocument`. */
 interface ReadDocumentContextV1 {
@@ -2336,4 +1956,4 @@ declare class OpsxKernel {
   private combineSignals;
 }
 //#endregion
-export { type AIToolOption, AI_TOOLS, type AnnotatedOpenSpecDocument, type ApplyInstructions, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, BUILTIN_SOUND_IDS, BUILTIN_SOUND_OPTIONS, BUILTIN_TERMINAL_SPAWN_COMMANDS, type BuiltinSoundId, BuiltinSoundIdSchema, type BuiltinSoundOption, CODE_EDITOR_THEME_VALUES, CUSTOM_SOUND_ADD_VALUE, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, type CodeEditorTheme, CodeEditorThemeSchema, ConfigManager, type CustomSoundHash, CustomSoundHashSchema, type CustomSoundId, CustomSoundIdSchema, type CustomSoundMetadata, type CustomSoundMetadataFile, CustomSoundMetadataFileSchema, CustomSoundMetadataSchema, DASHBOARD_METRIC_KEYS, DEFAULT_BELL_SOUND_ID, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_NOTIFICATION_SOUND_ID, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, type DashboardCardAvailability, type DashboardConfig, DashboardConfigSchema, type DashboardGitCommitEntry, type DashboardGitDiffStats, type DashboardGitEntry, type DashboardGitSnapshot, type DashboardGitUncommittedEntry, type DashboardGitWorktree, type DashboardMetricKey, type DashboardOverview, type DashboardSummary, type DashboardTrendKind, type DashboardTrendMeta, type DashboardTrendPoint, type DashboardTriColorTrendPoint, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type DependencyInfo, DependencyInfoSchema, type DocumentConsumerV1, type DocumentReadModeV1, type DocumentRefV1, type ExportSnapshot, type FileChangeEvent, type FileChangeType, type GitConfig, GitConfigSchema, type GitEntriesPage, type GitEntryCursor, type GitEntryDetail, type GitEntryFileDiff, type GitEntryFilePatch, type GitEntryFileSource, type GitEntryFileSummary, type GitEntryFiles, type GitEntryPatch, type GitEntrySelector, type GitEntryShell, type GitFileChangeType, type GitPatchFile, type GitPatchState, type GitWorktreeHandoff, type GitWorktreeOverview, type GitWorktreeSummary, HOSTED_SHELL_PROTOCOL_VERSION, type HookDiagnosticLevel, type HookDiagnosticV1, type HookLifecycleV1, type HostedBackendHealthResponse, LEGACY_SOUND_ID_MAP, type MarkdownAnnotation, type MarkdownAnnotationConfidence, type MarkdownAnnotationContext, type MarkdownAnnotationInput, type MarkdownAnnotationRule, type MarkdownFact, type MarkdownFactKind, type MarkdownFactSpan, type MarkdownFactsDocument, MarkdownParser, type MarkdownProjectionContext, type MarkdownProjectionRule, type MarkdownReadingDocument, type MarkdownReadingLookup, type MarkdownReadingPlugin, type MarkdownSourcePoint, type MarkdownSourceRange, NOTIFICATION_SOUND_OPTIONS, NOTIFICATION_SOUND_VALUES, type NotificationAction, NotificationActionSchema, type NotificationGroup, type NotificationGroupKey, NotificationGroupKeySchema, type NotificationPublishInput, NotificationPublishInputSchema, type NotificationRecord, NotificationRecordSchema, type NotificationSettings, NotificationSettingsSchema, type NotificationSound, NotificationSoundSchema, type NotificationSource, NotificationSourceSchema, OFFICIAL_APP_BASE_URL, OPENSPECUI_HOOKS_VERSION, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, OPSX_AGENT_INVOCATION_MODE_VALUES, type OnReadDocumentHookV1, type OnRunWorkflowHookV1, OpenSpecAdapter, type OpenSpecAnnotation, type OpenSpecAnnotationConfidence, type OpenSpecHeadingSection, type OpenSpecProjectionOptions, type OpenSpecReadingSectionsProjection, type OpenSpecRequirementBlock, type OpenSpecScenarioBlock, type OpenSpecScenarioStepKeyword, type OpenSpecSemanticKind, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, type OpenSpecUIHooksV1, OpenSpecWatcher, type OpsxAgentInvocationMode, OpsxAgentInvocationModeSchema, type OpsxConfig, OpsxConfigSchema, OpsxKernel, type PathCallback, type ProjectRecoveryStatus, type ProjectResidencyEvictionReason, type ProjectResidencyStatus, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, type ProjectWatcherRuntimeStatusListener, type ProjectedOpenSpecDocument, PtyAttachMessageSchema, PtyBellResponseSchema, PtyBufferResponseSchema, type PtyClientMessage, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, type PtyPlatform, PtyPlatformSchema, PtyProcessTitleResponseSchema, PtyResizeMessageSchema, type PtyServerMessage, PtyServerMessageSchema, type PtySessionInfo, PtyTitleResponseSchema, ReactiveContext, ReactiveState, type ReactiveStateOptions, type ReadDocumentContextV1, type ReadDocumentResultV1, type Requirement, RequirementSchema, type ResolvedCliRunner, type RunWorkflowContextV1, type RunWorkflowInputV1, type RunWorkflowResultV1, SILENT_SOUND_ID, type ScenarioStep, ScenarioStepKeywordSchema, ScenarioStepSchema, type SchemaArtifact, SchemaArtifactSchema, type SchemaDetail, SchemaDetailSchema, type SchemaInfo, SchemaInfoSchema, type SchemaResolution, SchemaResolutionSchema, SoundConfigIdSchema, type SoundId, SoundIdSchema, type Spec, type SpecMeta, SpecSchema, 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, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalBellSound, TerminalBellSoundSchema, type TerminalCommandArgument, type TerminalCommandField, TerminalCommandFieldSchema, type TerminalCommandFieldValue, type TerminalCommandFieldValues, type TerminalConfig, TerminalConfigSchema, type TerminalControlEvent, type TerminalControlParseResult, TerminalControlParser, type TerminalInvocationSettings, TerminalInvocationSettingsSchema, type TerminalNotificationEvent, type TerminalNotificationParseResult, TerminalNotificationParser, type TerminalNotificationProtocol, type TerminalProgressState, type TerminalPromptState, type TerminalRendererEngine, TerminalRendererEngineSchema, type TerminalShellDefaults, type TerminalShellProfile, TerminalShellProfileSchema, type TerminalShellQuoteStyle, TerminalShellQuoteStyleSchema, type TerminalSpawnCommand, TerminalSpawnCommandSchema, type TerminalThemeId, type TerminalThemeMode, TerminalThemeModeSchema, TerminalThemeSchema, type TerminalTitleTarget, type ToolConfig, type ToolInitDelivery, type ToolInitState, type ToolInitStatus, type ToolWorkflowId, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, type WorkflowActionV1, type WorkflowInvocationModeResolutionV1, type WorkflowRequestedModeV1, acquireWatcher, annotateOpenSpecFacts, annotateOpenSpecMarkdown, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, buildMarkdownParentMap, builtinOpenSpecReadingPlugin, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, createMarkdownReadingDocument, createMarkdownReadingDocumentFromFacts, createOpenSpecReadingPlugin, customHashFromSoundId, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getBuiltinSoundUrl, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getMarkdownAnnotation, getMarkdownAnnotationsForFact, getMarkdownFactSpan, getMarkdownHeadingEnd, getMarkdownHeadingFacts, getNotificationGroupKey, getNotificationGroupLabel, getOpenSpecAnnotation, getOpenSpecAnnotationsForFact, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, getProjectWatcher, getTerminalCommandDefaultValues, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, groupNotifications, initWatcherPool, isGlobPattern, isHostedBackendHealthResponse, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, normalizeLegacySoundId, openSpecAnnotationRules, parseCliCommand, parseMarkdownFacts, parseOpenSpecMarkdownToSpec, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown, quoteTerminalShellArg, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, renderTerminalCommandArgs, renderTerminalSpawnCommandLine, resolveHostedAppBaseUrl, resolveTerminalShellDefaults, sniffGlobalCli, soundIdFromCustomHash, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, toMarkdownFactKind, toOpsxDisplayPath, trimMarkdownSlice };
+export { type AIToolOption, AI_TOOLS, type AnnotatedOpenSpecDocument, type ApplyInstructions, ApplyInstructionsContextFilesSchema, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, BUILTIN_SOUND_IDS, BUILTIN_SOUND_OPTIONS, BUILTIN_TERMINAL_SPAWN_COMMANDS, type BuiltinSoundId, BuiltinSoundIdSchema, type BuiltinSoundOption, CODE_EDITOR_THEME_VALUES, CUSTOM_SOUND_ADD_VALUE, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, type CodeEditorTheme, CodeEditorThemeSchema, ConfigManager, type CustomSoundHash, CustomSoundHashSchema, type CustomSoundId, CustomSoundIdSchema, type CustomSoundMetadata, type CustomSoundMetadataFile, CustomSoundMetadataFileSchema, CustomSoundMetadataSchema, DASHBOARD_METRIC_KEYS, DEFAULT_BELL_SOUND_ID, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DEFAULT_NOTIFICATION_SOUND_ID, DEFAULT_TERMINAL_DARK_THEME, DEFAULT_TERMINAL_LIGHT_THEME, DEFAULT_TERMINAL_THEME_MODE, DOCUMENT_TRANSLATION_DISPLAY_MODES, type DashboardCardAvailability, type DashboardConfig, DashboardConfigSchema, type DashboardGitCommitEntry, type DashboardGitDiffStats, type DashboardGitEntry, type DashboardGitSnapshot, type DashboardGitUncommittedEntry, type DashboardGitWorktree, type DashboardMetricKey, type DashboardOverview, type DashboardSummary, type DashboardTrendKind, type DashboardTrendMeta, type DashboardTrendPoint, type DashboardTriColorTrendPoint, type Delta, type DeltaOperation, DeltaOperationType, DeltaSchema, type DeltaSpec, DeltaSpecSchema, type DependencyInfo, DependencyInfoSchema, type DocumentConsumerV1, type DocumentReadModeV1, type DocumentRefV1, type DocumentTranslationConfig, DocumentTranslationConfigSchema, type DocumentTranslationDisplayMode, DocumentTranslationDisplayModeSchema, type ExportSnapshot, type FileChangeEvent, type FileChangeType, type GitConfig, GitConfigSchema, type GitEntriesPage, type GitEntryCursor, type GitEntryDetail, type GitEntryFileDiff, type GitEntryFilePatch, type GitEntryFileSource, type GitEntryFileSummary, type GitEntryFiles, type GitEntryPatch, type GitEntrySelector, type GitEntryShell, type GitFileChangeType, type GitPatchFile, type GitPatchState, type GitWorktreeHandoff, type GitWorktreeOverview, type GitWorktreeSummary, HOSTED_SHELL_PROTOCOL_VERSION, type HookDiagnosticLevel, type HookDiagnosticV1, type HookLifecycleV1, type HostedBackendHealthResponse, LEGACY_SOUND_ID_MAP, type MarkdownAnnotation, type MarkdownAnnotationConfidence, type MarkdownAnnotationContext, type MarkdownAnnotationInput, type MarkdownAnnotationRule, type MarkdownFact, type MarkdownFactKind, type MarkdownFactSpan, type MarkdownFactsDocument, MarkdownParser, type MarkdownProjectionContext, type MarkdownProjectionRule, type MarkdownReadingDocument, type MarkdownReadingLookup, type MarkdownReadingPlugin, MarkdownReadingPluginRegistry, type MarkdownSourcePoint, type MarkdownSourceRange, NOTIFICATION_SOUND_OPTIONS, NOTIFICATION_SOUND_VALUES, type NotificationAction, NotificationActionSchema, type NotificationGroup, type NotificationGroupKey, NotificationGroupKeySchema, type NotificationPublishInput, NotificationPublishInputSchema, type NotificationRecord, NotificationRecordSchema, type NotificationSettings, NotificationSettingsSchema, type NotificationSound, NotificationSoundSchema, type NotificationSource, NotificationSourceSchema, OFFICIAL_APP_BASE_URL, OPENSPECUI_HOOKS_VERSION, OPEN_SPEC_READING_SECTIONS_PROJECTION_ID, OPEN_SPEC_SPEC_PROJECTION_ID, OPSX_AGENT_INVOCATION_MODE_VALUES, type OnReadDocumentHookV1, type OnRunWorkflowHookV1, OpenSpecAdapter, type OpenSpecAnnotation, type OpenSpecAnnotationConfidence, type OpenSpecHeadingSection, type OpenSpecProjectionOptions, type OpenSpecReadingSectionsProjection, type OpenSpecRequirementBlock, type OpenSpecScenarioBlock, type OpenSpecScenarioStepKeyword, type OpenSpecSemanticKind, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, type OpenSpecUIHooksV1, OpenSpecWatcher, type OpsxAgentInvocationMode, OpsxAgentInvocationModeSchema, type OpsxConfig, OpsxConfigSchema, type OpsxEntityArtifact, type OpsxEntityArtifactFile, type OpsxEntityDetail, type OpsxEntityDiagnostic, type OpsxEntityFile, type OpsxEntityReadOptions, type OpsxEntityStage, OpsxKernel, type ParsedOpsxSchemaDetail, type PathCallback, type ProjectRecoveryStatus, type ProjectResidencyEvictionReason, type ProjectResidencyStatus, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, type ProjectWatcherRuntimeStatusListener, type ProjectedOpenSpecDocument, PtyAttachMessageSchema, PtyBellResponseSchema, PtyBufferResponseSchema, type PtyClientMessage, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, type PtyPlatform, PtyPlatformSchema, PtyProcessTitleResponseSchema, PtyResizeMessageSchema, type PtyServerMessage, PtyServerMessageSchema, type PtySessionInfo, PtyTitleResponseSchema, ReactiveContext, ReactiveState, type ReactiveStateOptions, type ReadDocumentContextV1, type ReadDocumentResultV1, type Requirement, RequirementSchema, type ResolvedCliRunner, type RunWorkflowContextV1, type RunWorkflowInputV1, type RunWorkflowResultV1, SILENT_SOUND_ID, type ScenarioStep, ScenarioStepKeywordSchema, ScenarioStepSchema, type SchemaArtifact, SchemaArtifactSchema, type SchemaDetail, SchemaDetailSchema, type SchemaInfo, SchemaInfoSchema, type SchemaResolution, SchemaResolutionSchema, SoundConfigIdSchema, type SoundId, SoundIdSchema, type Spec, type SpecMeta, SpecSchema, 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, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalBellSound, TerminalBellSoundSchema, type TerminalCommandArgument, type TerminalCommandField, TerminalCommandFieldSchema, type TerminalCommandFieldValue, type TerminalCommandFieldValues, type TerminalConfig, TerminalConfigSchema, type TerminalControlEvent, type TerminalControlParseResult, TerminalControlParser, type TerminalInvocationSettings, TerminalInvocationSettingsSchema, type TerminalNotificationEvent, type TerminalNotificationParseResult, TerminalNotificationParser, type TerminalNotificationProtocol, type TerminalProgressState, type TerminalPromptState, type TerminalRendererEngine, TerminalRendererEngineSchema, type TerminalShellDefaults, type TerminalShellProfile, TerminalShellProfileSchema, type TerminalShellQuoteStyle, TerminalShellQuoteStyleSchema, type TerminalSpawnCommand, TerminalSpawnCommandSchema, type TerminalThemeId, type TerminalThemeMode, TerminalThemeModeSchema, TerminalThemeSchema, type TerminalTitleTarget, type ToolConfig, type ToolInitDelivery, type ToolInitState, type ToolInitStatus, type ToolWorkflowId, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, type WorkflowActionV1, type WorkflowInvocationModeResolutionV1, type WorkflowRequestedModeV1, acquireWatcher, annotateOpenSpecFacts, annotateOpenSpecMarkdown, buildCliRunnerCandidates, buildEmbeddedUiLaunchUrl, buildHostedLaunchUrl, buildMarkdownParentMap, buildOpsxEntityDetail, builtinOpenSpecReadingPlugin, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, createMarkdownReadingDocument, createMarkdownReadingDocumentFromFacts, createOpenSpecReadingPlugin, customHashFromSoundId, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getBuiltinSoundUrl, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getMarkdownAnnotation, getMarkdownAnnotationsForFact, getMarkdownFactSpan, getMarkdownHeadingEnd, getMarkdownHeadingFacts, getNotificationGroupKey, getNotificationGroupLabel, getOpenSpecAnnotation, getOpenSpecAnnotationsForFact, getOpenSpecProjectionAnnotation, getOpenSpecReadingSections, getOpsxEntityMetadataPath, getOpsxEntityRootRelativePath, getProjectWatcher, getTerminalCommandDefaultValues, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, groupNotifications, initWatcherPool, isGlobPattern, isHostedBackendHealthResponse, isOpsxGlobPattern, isSupportedEmbeddedUiUrl, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeEmbeddedUiUrl, normalizeHostedAppBaseUrl, normalizeLegacySoundId, normalizeOpsxEntityPath, openSpecAnnotationRules, opsxGlobToRegex, opsxPathMatchesPattern, parseCliCommand, parseMarkdownFacts, parseOpenSpecMarkdownToSpec, parseOpsxEntityMetadata, parseOpsxSchemaDetail, projectAnnotatedOpenSpecToSpec, projectOpenSpecMarkdown, quoteTerminalShellArg, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, renderTerminalCommandArgs, renderTerminalSpawnCommandLine, resolveHostedAppBaseUrl, resolveTerminalShellDefaults, sniffGlobalCli, sortMarkdownReadingPlugins, soundIdFromCustomHash, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, toMarkdownFactKind, toOpsxDisplayPath, trimMarkdownSlice };