@openspecui/core 1.5.0 → 1.6.2

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-RBULE8_G.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { z } from "zod";
 import { EventEmitter } from "events";
@@ -17,13 +18,13 @@ declare const ChangeFileSchema: z.ZodObject<{
   /** Optional byte size for files */
   size: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-  type: "file" | "directory";
   path: string;
+  type: "file" | "directory";
   content?: string | undefined;
   size?: number | undefined;
 }, {
-  type: "file" | "directory";
   path: string;
+  type: "file" | "directory";
   content?: string | undefined;
   size?: number | undefined;
 }>;
@@ -677,14 +678,16 @@ declare class OpenSpecAdapter {
   listChanges(): Promise<string[]>;
   /**
    * List changes with metadata (id, name, progress, and time info)
-   * Only returns changes that have valid proposal.md
+   * Returns every change directory, including schema-specific layouts that
+   * don't use proposal.md/tasks.md.
    * Sorted by updatedAt descending (most recent first)
    */
   listChangesWithMeta(): Promise<ChangeMeta[]>;
   listArchivedChanges(): Promise<string[]>;
   /**
    * List archived changes with metadata and time info
-   * Only returns archives that have valid proposal.md
+   * Returns every archive directory, including schema-specific layouts that
+   * don't use proposal.md/tasks.md.
    * Sorted by updatedAt descending (most recent first)
    */
   listArchivedChangesWithMeta(): Promise<ArchiveMeta[]>;
@@ -1308,8 +1311,11 @@ declare function createFileChangeObservable(watcher: OpenSpecWatcher): {
 };
 //#endregion
 //#region src/config.d.ts
+declare const CODE_EDITOR_THEME_VALUES: readonly ["github", "material", "vscode", "tokyo", "gruvbox", "monokai", "nord"];
 declare const TerminalRendererEngineSchema: z.ZodEnum<["xterm", "ghostty"]>;
 type TerminalRendererEngine = z.infer<typeof TerminalRendererEngineSchema>;
+declare const CodeEditorThemeSchema: z.ZodEnum<["github", "material", "vscode", "tokyo", "gruvbox", "monokai", "nord"]>;
+type CodeEditorTheme = z.infer<typeof CodeEditorThemeSchema>;
 declare function isTerminalRendererEngine(value: string): value is TerminalRendererEngine;
 type RunnerId = 'configured' | 'openspec' | 'npx' | 'bunx' | 'deno' | 'pnpm' | 'yarn';
 interface CliRunnerCandidate {
@@ -1428,6 +1434,14 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   }>>;
   /** 主题 */
   theme: z.ZodDefault<z.ZodEnum<["light", "dark", "system"]>>;
+  /** 代码编辑器配置 */
+  codeEditor: z.ZodDefault<z.ZodObject<{
+    theme: z.ZodDefault<z.ZodEnum<["github", "material", "vscode", "tokyo", "gruvbox", "monokai", "nord"]>>;
+  }, "strip", z.ZodTypeAny, {
+    theme: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord";
+  }, {
+    theme?: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord" | undefined;
+  }>>;
   /** 终端配置 */
   terminal: z.ZodDefault<z.ZodObject<{
     fontSize: z.ZodDefault<z.ZodNumber>;
@@ -1460,11 +1474,14 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     trendPointLimit?: number | undefined;
   }>>;
 }, "strip", z.ZodTypeAny, {
+  theme: "light" | "dark" | "system";
   cli: {
     command?: string | undefined;
     args?: string[] | undefined;
   };
-  theme: "light" | "dark" | "system";
+  codeEditor: {
+    theme: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord";
+  };
   terminal: {
     fontSize: number;
     fontFamily: string;
@@ -1477,11 +1494,14 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     trendPointLimit: number;
   };
 }, {
+  theme?: "light" | "dark" | "system" | undefined;
   cli?: {
     command?: string | undefined;
     args?: string[] | undefined;
   } | undefined;
-  theme?: "light" | "dark" | "system" | undefined;
+  codeEditor?: {
+    theme?: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord" | undefined;
+  } | undefined;
   terminal?: {
     fontSize?: number | undefined;
     fontFamily?: string | undefined;
@@ -1501,6 +1521,7 @@ type OpenSpecUIConfigUpdate = {
     args?: string[] | null;
   };
   theme?: OpenSpecUIConfig['theme'];
+  codeEditor?: Partial<OpenSpecUIConfig['codeEditor']>;
   terminal?: Partial<TerminalConfig>;
   dashboard?: Partial<DashboardConfig>;
 };
@@ -1824,14 +1845,14 @@ declare const ArtifactStatusSchema: z.ZodObject<{
   missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
   relativePath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  status: "done" | "ready" | "blocked";
   id: string;
+  status: "done" | "ready" | "blocked";
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
 }, {
-  status: "done" | "ready" | "blocked";
   id: string;
+  status: "done" | "ready" | "blocked";
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
@@ -1849,14 +1870,14 @@ declare const ChangeStatusSchema: z.ZodObject<{
     missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     relativePath: z.ZodOptional<z.ZodString>;
   }, "strip", z.ZodTypeAny, {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
   }, {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1867,8 +1888,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1879,8 +1900,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    status: "done" | "ready" | "blocked";
     id: string;
+    status: "done" | "ready" | "blocked";
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1893,13 +1914,13 @@ declare const DependencyInfoSchema: z.ZodObject<{
   path: z.ZodString;
   description: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-  path: string;
   id: string;
+  path: string;
   description: string;
   done: boolean;
 }, {
-  path: string;
   id: string;
+  path: string;
   description: string;
   done: boolean;
 }>;
@@ -2007,13 +2028,13 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
     path: z.ZodString;
     description: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }, {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }>, "many">;
@@ -2027,8 +2048,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }[];
@@ -2045,8 +2066,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }[];
@@ -2077,43 +2098,54 @@ 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;
+  path: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
     source: "project" | "user" | "package";
+    displayPath?: string | undefined;
   }[];
+  displayPath?: string | undefined;
 }, {
-  path: string;
   name: string;
+  path: 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<{
@@ -2218,6 +2250,23 @@ interface ExportSnapshot {
     changesCount: number;
     archivesCount: number;
   };
+  /** Git snapshot used by static dashboard */
+  git?: {
+    defaultBranch: string;
+    repositoryUrl: string | null;
+    latestCommitTs: number | null;
+    recentCommits: Array<{
+      hash: string;
+      title: string;
+      committedAt: number;
+      relatedChanges: string[];
+      diff: {
+        files: number;
+        insertions: number;
+        deletions: number;
+      };
+    }>;
+  };
   /** OpenSpecUI runtime config captured during export */
   config?: OpenSpecUIConfig;
   /** All specs with parsed content */
@@ -2289,8 +2338,15 @@ interface ExportSnapshot {
     configYaml?: string;
     schemas: SchemaInfo[];
     schemaDetails: Record<string, SchemaDetail>;
+    schemaYamls?: Record<string, string>;
     schemaResolutions: Record<string, SchemaResolution>;
     templates: Record<string, TemplatesMap>;
+    templateContents?: Record<string, Record<string, {
+      content: string | null;
+      path: string;
+      displayPath?: string;
+      source: 'project' | 'user' | 'package';
+    }>>;
     changeMetadata: Record<string, string | null>;
   };
 }
@@ -2299,6 +2355,7 @@ interface ExportSnapshot {
 type TemplateContentMap = Record<string, {
   content: string | null;
   path: string;
+  displayPath?: string;
   source: TemplatesMap[string]['source'];
 }>;
 interface GlobArtifactFile {
@@ -2407,22 +2464,22 @@ declare const PtySessionInfoSchema: z.ZodObject<{
   closeTip: z.ZodOptional<z.ZodString>;
   closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
 }, "strip", z.ZodTypeAny, {
+  id: string;
   command: string;
   args: string[];
   platform: "windows" | "macos" | "common";
   exitCode: number | null;
   title: string;
-  id: string;
   isExited: boolean;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
+  id: string;
   command: string;
   args: string[];
   platform: "windows" | "macos" | "common";
   exitCode: number | null;
   title: string;
-  id: string;
   isExited: boolean;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2439,19 +2496,19 @@ declare const PtyCreateMessageSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  cols?: number | undefined;
-  rows?: number | undefined;
   command?: string | undefined;
   args?: string[] | undefined;
+  cols?: number | undefined;
+  rows?: number | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  cols?: number | undefined;
-  rows?: number | undefined;
   command?: string | undefined;
   args?: string[] | undefined;
+  cols?: number | undefined;
+  rows?: number | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>;
@@ -2529,19 +2586,19 @@ declare const PtyClientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  cols?: number | undefined;
-  rows?: number | undefined;
   command?: string | undefined;
   args?: string[] | undefined;
+  cols?: number | undefined;
+  rows?: number | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  cols?: number | undefined;
-  rows?: number | undefined;
   command?: string | undefined;
   args?: string[] | undefined;
+  cols?: number | undefined;
+  rows?: number | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>, z.ZodObject<{
@@ -2683,22 +2740,22 @@ declare const PtyListResponseSchema: z.ZodObject<{
     closeTip: z.ZodOptional<z.ZodString>;
     closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
   }, "strip", z.ZodTypeAny, {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
   }, {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2706,12 +2763,12 @@ declare const PtyListResponseSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
   type: "list";
   sessions: {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2719,12 +2776,12 @@ declare const PtyListResponseSchema: z.ZodObject<{
 }, {
   type: "list";
   sessions: {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2737,14 +2794,14 @@ declare const PtyErrorResponseSchema: z.ZodObject<{
   message: z.ZodString;
   sessionId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND" | "PTY_CREATE_FAILED";
   message: string;
+  type: "error";
   sessionId?: string | undefined;
 }, {
-  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND" | "PTY_CREATE_FAILED";
   message: string;
+  type: "error";
   sessionId?: string | undefined;
 }>;
 declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -2823,22 +2880,22 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     closeTip: z.ZodOptional<z.ZodString>;
     closeCallbackUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
   }, "strip", z.ZodTypeAny, {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
   }, {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2846,12 +2903,12 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, "strip", z.ZodTypeAny, {
   type: "list";
   sessions: {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2859,12 +2916,12 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, {
   type: "list";
   sessions: {
+    id: string;
     command: string;
     args: string[];
     platform: "windows" | "macos" | "common";
     exitCode: number | null;
     title: string;
-    id: string;
     isExited: boolean;
     closeTip?: string | undefined;
     closeCallbackUrl?: string | Record<string, string> | undefined;
@@ -2875,14 +2932,14 @@ declare const PtyServerMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
   message: z.ZodString;
   sessionId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND" | "PTY_CREATE_FAILED";
   message: string;
+  type: "error";
   sessionId?: string | undefined;
 }, {
-  type: "error";
   code: "INVALID_JSON" | "INVALID_MESSAGE" | "SESSION_NOT_FOUND" | "PTY_CREATE_FAILED";
   message: string;
+  type: "error";
   sessionId?: string | undefined;
 }>]>;
 type PtyClientMessage = z.infer<typeof PtyClientMessageSchema>;
@@ -2890,4 +2947,4 @@ type PtyServerMessage = z.infer<typeof PtyServerMessageSchema>;
 type PtySessionInfo = z.infer<typeof PtySessionInfoSchema>;
 type PtyPlatform = z.infer<typeof PtyPlatformSchema>;
 //#endregion
-export { type AIToolOption, AI_TOOLS, type ApplyInstructions, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, 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 ExportSnapshot, type FileChangeEvent, type FileChangeType, MarkdownParser, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, OpsxKernel, type PathCallback, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, PtyAttachMessageSchema, PtyBufferResponseSchema, type PtyClientMessage, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, type PtyPlatform, PtyPlatformSchema, PtyResizeMessageSchema, type PtyServerMessage, PtyServerMessageSchema, type PtySessionInfo, PtyTitleResponseSchema, ReactiveContext, ReactiveState, type ReactiveStateOptions, type Requirement, RequirementSchema, type ResolvedCliRunner, type SchemaArtifact, SchemaArtifactSchema, type SchemaDetail, SchemaDetailSchema, type SchemaInfo, SchemaInfoSchema, type SchemaResolution, SchemaResolutionSchema, type Spec, type SpecMeta, SpecSchema, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type TerminalRendererEngine, TerminalRendererEngineSchema, type ToolConfig, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli };
+export { type AIToolOption, AI_TOOLS, type ApplyInstructions, ApplyInstructionsSchema, type ApplyTask, ApplyTaskSchema, type ArchiveMeta, type ArtifactInstructions, ArtifactInstructionsSchema, type ArtifactStatus, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, type Change, type ChangeFile, ChangeFileSchema, type ChangeMeta, ChangeSchema, type ChangeStatus, ChangeStatusSchema, CliExecutor, type CliResult, type CliRunnerAttempt, type CliSniffResult, type CliStreamEvent, type CodeEditorTheme, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, 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 ExportSnapshot, type FileChangeEvent, type FileChangeType, MarkdownParser, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, OpsxKernel, type PathCallback, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, PtyAttachMessageSchema, PtyBufferResponseSchema, type PtyClientMessage, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, type PtyPlatform, PtyPlatformSchema, PtyResizeMessageSchema, type PtyServerMessage, PtyServerMessageSchema, type PtySessionInfo, PtyTitleResponseSchema, ReactiveContext, ReactiveState, type ReactiveStateOptions, type Requirement, RequirementSchema, type ResolvedCliRunner, type SchemaArtifact, SchemaArtifactSchema, type SchemaDetail, SchemaDetailSchema, type SchemaInfo, SchemaInfoSchema, type SchemaResolution, SchemaResolutionSchema, type Spec, type SpecMeta, SpecSchema, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type TerminalRendererEngine, TerminalRendererEngineSchema, type ToolConfig, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli, toOpsxDisplayPath };

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-DYIjMsbM.mjs";
 import { mkdir, readFile, rename, writeFile } from "fs/promises";
 import { dirname, join } from "path";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -1363,47 +1364,50 @@ var OpenSpecAdapter = class {
 	}
 	/**
 	* List changes with metadata (id, name, progress, and time info)
-	* Only returns changes that have valid proposal.md
+	* 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 change = await this.readChange(id);
-			if (!change) return null;
-			const proposalPath = join(this.changesDir, id, "proposal.md");
-			const timeInfo = await this.getFileTimeInfo(proposalPath);
+			const changeDir = join(this.changesDir, id);
+			const timeInfo = await this.getFileTimeInfo(changeDir);
 			return {
 				id,
-				name: change.name,
-				progress: change.progress,
+				name: change?.name ?? id,
+				progress: change?.progress ?? {
+					total: 0,
+					completed: 0
+				},
 				createdAt: timeInfo?.createdAt ?? 0,
 				updatedAt: timeInfo?.updatedAt ?? 0
 			};
-		}))).filter((r) => r !== null).sort((a, b) => b.updatedAt - a.updatedAt);
+		}))).sort((a, b) => b.updatedAt - a.updatedAt);
 	}
 	async listArchivedChanges() {
 		return reactiveReadDir(this.archiveDir, { directoriesOnly: true });
 	}
 	/**
 	* List archived changes with metadata and time info
-	* Only returns archives that have valid proposal.md
+	* Returns every archive directory, including schema-specific layouts that
+	* don't use proposal.md/tasks.md.
 	* Sorted by updatedAt descending (most recent first)
 	*/
 	async listArchivedChangesWithMeta() {
 		const ids = await this.listArchivedChanges();
 		return (await Promise.all(ids.map(async (id) => {
 			const change = await this.readArchivedChange(id);
-			if (!change) return null;
-			const proposalPath = join(this.archiveDir, id, "proposal.md");
-			const timeInfo = await this.getFileTimeInfo(proposalPath);
+			const archiveDir = join(this.archiveDir, id);
+			const timeInfo = await this.getFileTimeInfo(archiveDir);
 			return {
 				id,
-				name: change.name,
+				name: change?.name ?? id,
 				createdAt: timeInfo?.createdAt ?? 0,
 				updatedAt: timeInfo?.updatedAt ?? 0
 			};
-		}))).filter((r) => r !== null).sort((a, b) => b.updatedAt - a.updatedAt);
+		}))).sort((a, b) => b.updatedAt - a.updatedAt);
 	}
 	/**
 	* Read project.md content (reactive)
@@ -1957,8 +1961,18 @@ const CURSOR_STYLE_VALUES = [
 	"underline",
 	"bar"
 ];
+const CODE_EDITOR_THEME_VALUES = [
+	"github",
+	"material",
+	"vscode",
+	"tokyo",
+	"gruvbox",
+	"monokai",
+	"nord"
+];
 const TERMINAL_RENDERER_ENGINE_VALUES = ["xterm", "ghostty"];
 const TerminalRendererEngineSchema = z.enum(TERMINAL_RENDERER_ENGINE_VALUES);
+const CodeEditorThemeSchema = z.enum(CODE_EDITOR_THEME_VALUES);
 function isTerminalRendererEngine(value) {
 	return TERMINAL_RENDERER_ENGINE_VALUES.includes(value);
 }
@@ -2303,6 +2317,7 @@ const TerminalConfigSchema = z.object({
 	rendererEngine: z.string().default("xterm")
 });
 const DashboardConfigSchema = z.object({ trendPointLimit: z.number().int().min(20).max(500).default(100) });
+const CodeEditorConfigSchema = z.object({ theme: CodeEditorThemeSchema.default("github") });
 /**
 * OpenSpecUI 配置 Schema
 *
@@ -2314,6 +2329,7 @@ const OpenSpecUIConfigSchema = z.object({
 		args: z.array(z.string()).optional()
 	}).default({}),
 	theme: z.enum(THEME_VALUES).default("system"),
+	codeEditor: CodeEditorConfigSchema.default(CodeEditorConfigSchema.parse({})),
 	terminal: TerminalConfigSchema.default(TerminalConfigSchema.parse({})),
 	dashboard: DashboardConfigSchema.default(DashboardConfigSchema.parse({}))
 });
@@ -2321,6 +2337,7 @@ const OpenSpecUIConfigSchema = z.object({
 const DEFAULT_CONFIG = {
 	cli: {},
 	theme: "system",
+	codeEditor: CodeEditorConfigSchema.parse({}),
 	terminal: TerminalConfigSchema.parse({}),
 	dashboard: DashboardConfigSchema.parse({})
 };
@@ -2385,6 +2402,10 @@ var ConfigManager = class {
 			...current,
 			cli: nextCli,
 			theme: config.theme ?? current.theme,
+			codeEditor: {
+				...current.codeEditor,
+				...config.codeEditor
+			},
 			terminal: {
 				...current.terminal,
 				...config.terminal
@@ -3226,17 +3247,20 @@ const SchemaResolutionSchema = z.object({
 		"package"
 	]),
 	path: z.string(),
+	displayPath: z.string().optional(),
 	shadows: z.array(z.object({
 		source: z.enum([
 			"project",
 			"user",
 			"package"
 		]),
-		path: z.string()
+		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",
@@ -3280,6 +3304,12 @@ function parseCliJson(raw, schema, label) {
 function toRelativePath(root, absolutePath) {
 	return relative(root, absolutePath).split(sep).join("/");
 }
+function isAbsoluteFsPath(path) {
+	return path.startsWith("/") || /^[A-Za-z]:\//.test(path);
+}
+function toAbsoluteProjectPath(projectDir, path) {
+	return isAbsoluteFsPath(path.replace(/\\/g, "/")) ? path : resolve(projectDir, path);
+}
 async function readEntriesUnderRoot(root) {
 	if (!(await reactiveStat(root))?.isDirectory) return [];
 	const collectEntries = async (dir) => {
@@ -3718,7 +3748,21 @@ var OpsxKernel = class {
 		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"})`);
-		return parseCliJson(result.stdout, SchemaResolutionSchema, "openspec schema which");
+		const parsed = parseCliJson(result.stdout, SchemaResolutionSchema, "openspec schema which");
+		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,
+					projectDir: this.projectDir
+				})
+			}))
+		};
 	}
 	async fetchSchemaDetail(name) {
 		await touchOpsxProjectDeps(this.projectDir);
@@ -3742,7 +3786,15 @@ var OpsxKernel = class {
 		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"})`);
-		return parseCliJson(result.stdout, TemplatesSchema, "openspec templates");
+		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
+			})
+		}]));
 	}
 	async fetchTemplateContents(schema) {
 		await this.ensureTemplates(schema);
@@ -3751,6 +3803,10 @@ var OpsxKernel = class {
 			return [artifactId, {
 				content: await reactiveReadFile(info.path),
 				path: info.path,
+				displayPath: info.displayPath ?? toOpsxDisplayPath(info.path, {
+					source: info.source,
+					projectDir: this.projectDir
+				}),
 				source: info.source
 			}];
 		}));
@@ -3999,4 +4055,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { AI_TOOLS, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, MarkdownParser, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SpecSchema, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, Validator, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli };
+export { AI_TOOLS, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, MarkdownParser, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxKernel, ProjectWatcher, PtyAttachMessageSchema, PtyBufferResponseSchema, PtyClientMessageSchema, PtyCloseMessageSchema, PtyCreateMessageSchema, PtyCreatedResponseSchema, PtyErrorCodeSchema, PtyErrorResponseSchema, PtyExitResponseSchema, PtyInputMessageSchema, PtyListMessageSchema, PtyListResponseSchema, PtyOutputResponseSchema, PtyPlatformSchema, PtyResizeMessageSchema, PtyServerMessageSchema, PtyTitleResponseSchema, ReactiveContext, ReactiveState, RequirementSchema, SchemaArtifactSchema, SchemaDetailSchema, SchemaInfoSchema, SchemaResolutionSchema, SpecSchema, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, sniffGlobalCli, toOpsxDisplayPath };

package/dist/opsx-display-path-DYIjMsbM.mjs

@@ -0,0 +1,63 @@
+//#region src/opsx-display-path.ts
+const VIRTUAL_PROJECT_DIRNAME = "project";
+const WINDOWS_DRIVE_PREFIX = /^[A-Za-z]:\//;
+function normalizeFsPath(path) {
+	return path.replace(/\\/g, "/").replace(/\/+$/g, "");
+}
+function isAbsolutePath(path) {
+	return path.startsWith("/") || WINDOWS_DRIVE_PREFIX.test(path);
+}
+function stripRelativePrefix(path) {
+	return path.replace(/^\.?\//, "");
+}
+function splitSegments(path) {
+	return normalizeFsPath(path).split("/").filter(Boolean);
+}
+function toNpmSpecifier(path) {
+	const normalized = normalizeFsPath(path);
+	const match = /(?:^|\/)node_modules\/(?:\.pnpm\/[^/]+\/node_modules\/)?(@[^/]+\/[^/]+|[^/]+)(\/.*)?/.exec(normalized);
+	const pkgName = match?.[1];
+	if (!pkgName) return null;
+	return `npm:${pkgName}${match[2] ?? ""}`;
+}
+function toVirtualProjectPath(path) {
+	return `${VIRTUAL_PROJECT_DIRNAME}:${stripRelativePrefix(path)}`;
+}
+function isPathInside(root, target) {
+	const normalizedRoot = normalizeFsPath(root);
+	const normalizedTarget = normalizeFsPath(target);
+	const rootLower = normalizedRoot.toLowerCase();
+	const targetLower = normalizedTarget.toLowerCase();
+	return targetLower === rootLower || targetLower.startsWith(`${rootLower}/`);
+}
+function toRelativeFromRoot(root, target) {
+	const rootSegments = splitSegments(root);
+	const targetSegments = splitSegments(target);
+	let index = 0;
+	while (index < rootSegments.length && index < targetSegments.length) {
+		if (rootSegments[index]?.toLowerCase() !== targetSegments[index]?.toLowerCase()) break;
+		index += 1;
+	}
+	return targetSegments.slice(index).join("/");
+}
+function findOpspecSlice(path) {
+	const segments = splitSegments(path);
+	const idx = segments.lastIndexOf("openspec");
+	if (idx < 0) return null;
+	return segments.slice(idx).join("/");
+}
+function toOpsxDisplayPath(absoluteOrRelativePath, options) {
+	const normalized = normalizeFsPath(absoluteOrRelativePath);
+	const npmSpecifier = toNpmSpecifier(normalized);
+	if (options?.source === "package" || npmSpecifier) {
+		if (npmSpecifier) return npmSpecifier;
+	}
+	if (!isAbsolutePath(normalized)) return toVirtualProjectPath(normalized);
+	if (options?.projectDir && isPathInside(options.projectDir, normalized)) return toVirtualProjectPath(toRelativeFromRoot(options.projectDir, normalized));
+	const openspecSlice = findOpspecSlice(normalized);
+	if (openspecSlice) return toVirtualProjectPath(openspecSlice);
+	return toVirtualProjectPath(splitSegments(normalized).slice(-4).join("/"));
+}
+
+//#endregion
+export { toOpsxDisplayPath as n, VIRTUAL_PROJECT_DIRNAME as t };

package/dist/opsx-display-path-RBULE8_G.d.mts

@@ -0,0 +1,8 @@
+//#region src/opsx-display-path.d.ts
+declare const VIRTUAL_PROJECT_DIRNAME = "project";
+declare function toOpsxDisplayPath(absoluteOrRelativePath: string, options?: {
+  source?: 'project' | 'user' | 'package';
+  projectDir?: string;
+}): string;
+//#endregion
+export { toOpsxDisplayPath as n, VIRTUAL_PROJECT_DIRNAME as t };

package/dist/opsx-display-path.d.mts

@@ -0,0 +1,2 @@
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-RBULE8_G.mjs";
+export { VIRTUAL_PROJECT_DIRNAME, toOpsxDisplayPath };

package/dist/opsx-display-path.mjs

@@ -0,0 +1,3 @@
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-DYIjMsbM.mjs";
+
+export { VIRTUAL_PROJECT_DIRNAME, toOpsxDisplayPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "1.5.0",
+  "version": "1.6.2",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -9,6 +9,10 @@
     ".": {
       "import": "./dist/index.mjs",
       "types": "./dist/index.d.mts"
+    },
+    "./opsx-display-path": {
+      "import": "./dist/opsx-display-path.mjs",
+      "types": "./dist/opsx-display-path.d.mts"
     }
   },
   "files": [
@@ -29,8 +33,8 @@
     "typescript": "^5.0.0"
   },
   "scripts": {
-    "build": "tsdown src/index.ts --format esm --dts",
-    "dev": "tsdown src/index.ts --format esm --dts --watch",
+    "build": "tsdown src/index.ts src/opsx-display-path.ts --format esm --dts",
+    "dev": "tsdown src/index.ts src/opsx-display-path.ts --format esm --dts --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"