@openspecui/core 1.2.0 → 1.6.0

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, {
-  path: string;
   type: "file" | "directory";
+  path: string;
   content?: string | undefined;
   size?: number | undefined;
 }, {
-  path: string;
   type: "file" | "directory";
+  path: string;
   content?: string | undefined;
   size?: number | undefined;
 }>;
@@ -1022,53 +1023,6 @@ declare function clearCache(path?: string): void;
  */
 declare function getCacheSize(): number;
 //#endregion
-//#region src/reactive-fs/watcher-pool.d.ts
-/**
- * 初始化 watcher pool
- *
- * 必须在使用 acquireWatcher 之前调用。
- * 通常由 server 在启动时调用。
- *
- * @param projectDir 项目根目录
- */
-declare function initWatcherPool(projectDir: string): Promise<void>;
-/**
- * 获取或创建文件/目录监听器
- *
- * 特性：
- * - 使用 @parcel/watcher 监听项目根目录
- * - 自动处理新创建的目录（解决 init 后无法监听的问题）
- * - 同一路径共享订阅
- * - 引用计数管理生命周期
- * - 内置防抖机制
- *
- * @param path 要监听的路径
- * @param onChange 变更回调
- * @param options 监听选项
- * @returns 释放函数，调用后取消订阅
- */
-declare function acquireWatcher(path: string, onChange: () => void, options?: {
-  recursive?: boolean;
-  debounceMs?: number;
-  onError?: () => void;
-}): () => void;
-/**
- * 获取当前活跃的监听器数量（用于调试）
- */
-declare function getActiveWatcherCount(): number;
-/**
- * 关闭所有监听器（用于测试清理）
- */
-declare function closeAllWatchers(): Promise<void>;
-/**
- * 检查 watcher pool 是否已初始化
- */
-declare function isWatcherPoolInitialized(): boolean;
-/**
- * 获取当前监听的项目目录
- */
-declare function getWatchedProjectDir(): string | null;
-//#endregion
 //#region src/reactive-fs/project-watcher.d.ts
 /**
  * 事件类型
@@ -1085,6 +1039,15 @@ interface WatchEvent {
  * 路径订阅回调
  */
 type PathCallback = (events: WatchEvent[]) => void;
+/** watcher 重建原因 */
+type ProjectWatcherReinitializeReason = 'drop-events' | 'watcher-error' | 'missing-project-dir' | 'project-dir-replaced' | 'manual';
+/** watcher 运行时状态（用于调试和运维观测） */
+interface ProjectWatcherRuntimeStatus {
+  generation: number;
+  reinitializeCount: number;
+  lastReinitializeReason: ProjectWatcherReinitializeReason | null;
+  reinitializeReasonCounts: Readonly<Record<ProjectWatcherReinitializeReason, number>>;
+}
 /**
  * 项目监听器
  *
@@ -1107,17 +1070,18 @@ declare class ProjectWatcher {
   private ignore;
   private initialized;
   private initPromise;
-  private healthCheckTimer;
-  private lastEventTime;
-  private healthCheckPending;
-  private enableHealthCheck;
   private reinitializeTimer;
   private reinitializePending;
+  private reinitializeReasonPending;
+  private pathLivenessTimer;
+  private projectDirFingerprint;
+  private generation;
+  private reinitializeCount;
+  private lastReinitializeReason;
+  private reinitializeReasonCounts;
   constructor(projectDir: string, options?: {
     debounceMs?: number;
     ignore?: string[];
-    /** 是否启用健康检查（默认 true） */
-    enableHealthCheck?: boolean;
   });
   /**
    * 初始化 watcher
@@ -1127,13 +1091,30 @@ declare class ProjectWatcher {
   private doInit;
   /**
    * 处理 watcher 错误
-   * 对于 FSEvents dropped 错误，触发延迟重建
+   * 统一走错误驱动重建流程
    */
   private handleWatcherError;
   /**
    * 延迟重建 watcher（防抖，避免频繁重建）
    */
   private scheduleReinitialize;
+  /**
+   * 读取项目目录指纹（目录不存在时返回 null）
+   * 用于检测 path 对应实体是否被替换（inode/dev 漂移）
+   */
+  private getProjectDirFingerprint;
+  /**
+   * 启动路径语义监测（避免 watcher 绑定到已失效句柄）
+   */
+  private startPathLivenessMonitor;
+  /**
+   * 停止路径语义监测
+   */
+  private stopPathLivenessMonitor;
+  /**
+   * 只读检查 projectDir 是否仍指向初始化时的目录实体
+   */
+  private checkPathLiveness;
   /**
    * 处理原始事件
    */
@@ -1180,26 +1161,13 @@ declare class ProjectWatcher {
    */
   get isInitialized(): boolean;
   /**
-   * 启动健康检查定时器
-   */
-  private startHealthCheck;
-  /**
-   * 停止健康检查定时器
-   */
-  private stopHealthCheck;
-  /**
-   * 执行健康检查
-   *
-   * 工作流程：
-   * 1. 如果最近有事件，无需检查
-   * 2. 如果上次探测还在等待中，说明 watcher 可能失效，尝试重建
-   * 3. 否则，创建临时文件触发事件，等待下次检查验证
+   * 获取 watcher 运行时状态
    */
-  private performHealthCheck;
+  get runtimeStatus(): ProjectWatcherRuntimeStatus;
   /**
-   * 发送探测：通过 utimesSync 修改项目目录的时间戳来触发 watcher 事件
+   * 记录重建统计
    */
-  private sendProbe;
+  private markReinitialized;
   /**
    * 重新初始化 watcher
    */
@@ -1222,6 +1190,63 @@ declare function getProjectWatcher(projectDir: string, options?: ConstructorPara
  */
 declare function closeAllProjectWatchers(): Promise<void>;
 //#endregion
+//#region src/reactive-fs/watcher-pool.d.ts
+/** watcher 运行时状态（供 server 订阅） */
+interface WatcherRuntimeStatus extends ProjectWatcherRuntimeStatus {
+  projectDir: string | null;
+  initialized: boolean;
+  subscriptionCount: number;
+}
+/**
+ * 初始化 watcher pool
+ *
+ * 必须在使用 acquireWatcher 之前调用。
+ * 通常由 server 在启动时调用。
+ *
+ * @param projectDir 项目根目录
+ */
+declare function initWatcherPool(projectDir: string): Promise<void>;
+/**
+ * 获取或创建文件/目录监听器
+ *
+ * 特性：
+ * - 使用 @parcel/watcher 监听项目根目录
+ * - 自动处理新创建的目录（解决 init 后无法监听的问题）
+ * - 同一路径共享订阅
+ * - 引用计数管理生命周期
+ * - 内置防抖机制
+ *
+ * @param path 要监听的路径
+ * @param onChange 变更回调
+ * @param options 监听选项
+ * @returns 释放函数，调用后取消订阅
+ */
+declare function acquireWatcher(path: string, onChange: () => void, options?: {
+  recursive?: boolean;
+  debounceMs?: number;
+  onError?: () => void;
+}): () => void;
+/**
+ * 获取当前活跃的监听器数量（用于调试）
+ */
+declare function getActiveWatcherCount(): number;
+/**
+ * 关闭所有监听器（用于测试清理）
+ */
+declare function closeAllWatchers(): Promise<void>;
+/**
+ * 检查 watcher pool 是否已初始化
+ */
+declare function isWatcherPoolInitialized(): boolean;
+/**
+ * 获取当前监听的项目目录
+ */
+declare function getWatchedProjectDir(): string | null;
+/**
+ * 获取 watcher 运行时状态
+ */
+declare function getWatcherRuntimeStatus(): WatcherRuntimeStatus | null;
+//#endregion
 //#region src/watcher.d.ts
 /**
  * File change event types
@@ -1284,6 +1309,9 @@ declare function createFileChangeObservable(watcher: OpenSpecWatcher): {
 };
 //#endregion
 //#region src/config.d.ts
+declare const TerminalRendererEngineSchema: z.ZodEnum<["xterm", "ghostty"]>;
+type TerminalRendererEngine = z.infer<typeof TerminalRendererEngineSchema>;
+declare function isTerminalRendererEngine(value: string): value is TerminalRendererEngine;
 type RunnerId = 'configured' | 'openspec' | 'npx' | 'bunx' | 'deno' | 'pnpm' | 'yarn';
 interface CliRunnerCandidate {
   id: RunnerId;
@@ -1355,20 +1383,31 @@ declare const TerminalConfigSchema: z.ZodObject<{
   cursorBlink: z.ZodDefault<z.ZodBoolean>;
   cursorStyle: z.ZodDefault<z.ZodEnum<["block", "underline", "bar"]>>;
   scrollback: z.ZodDefault<z.ZodNumber>;
+  rendererEngine: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
   fontSize: number;
   fontFamily: string;
   cursorBlink: boolean;
   cursorStyle: "block" | "underline" | "bar";
   scrollback: number;
+  rendererEngine: string;
 }, {
   fontSize?: number | undefined;
   fontFamily?: string | undefined;
   cursorBlink?: boolean | undefined;
   cursorStyle?: "block" | "underline" | "bar" | undefined;
   scrollback?: number | undefined;
+  rendererEngine?: string | undefined;
 }>;
 type TerminalConfig = z.infer<typeof TerminalConfigSchema>;
+declare const DashboardConfigSchema: z.ZodObject<{
+  trendPointLimit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+  trendPointLimit: number;
+}, {
+  trendPointLimit?: number | undefined;
+}>;
+type DashboardConfig = z.infer<typeof DashboardConfigSchema>;
 /**
  * OpenSpecUI 配置 Schema
  *
@@ -1397,18 +1436,29 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     cursorBlink: z.ZodDefault<z.ZodBoolean>;
     cursorStyle: z.ZodDefault<z.ZodEnum<["block", "underline", "bar"]>>;
     scrollback: z.ZodDefault<z.ZodNumber>;
+    rendererEngine: z.ZodDefault<z.ZodString>;
   }, "strip", z.ZodTypeAny, {
     fontSize: number;
     fontFamily: string;
     cursorBlink: boolean;
     cursorStyle: "block" | "underline" | "bar";
     scrollback: number;
+    rendererEngine: string;
   }, {
     fontSize?: number | undefined;
     fontFamily?: string | undefined;
     cursorBlink?: boolean | undefined;
     cursorStyle?: "block" | "underline" | "bar" | undefined;
     scrollback?: number | undefined;
+    rendererEngine?: string | undefined;
+  }>>;
+  /** Dashboard 配置 */
+  dashboard: z.ZodDefault<z.ZodObject<{
+    trendPointLimit: z.ZodDefault<z.ZodNumber>;
+  }, "strip", z.ZodTypeAny, {
+    trendPointLimit: number;
+  }, {
+    trendPointLimit?: number | undefined;
   }>>;
 }, "strip", z.ZodTypeAny, {
   cli: {
@@ -1422,6 +1472,10 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     cursorBlink: boolean;
     cursorStyle: "block" | "underline" | "bar";
     scrollback: number;
+    rendererEngine: string;
+  };
+  dashboard: {
+    trendPointLimit: number;
   };
 }, {
   cli?: {
@@ -1435,6 +1489,10 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     cursorBlink?: boolean | undefined;
     cursorStyle?: "block" | "underline" | "bar" | undefined;
     scrollback?: number | undefined;
+    rendererEngine?: string | undefined;
+  } | undefined;
+  dashboard?: {
+    trendPointLimit?: number | undefined;
   } | undefined;
 }>;
 type OpenSpecUIConfig = z.infer<typeof OpenSpecUIConfigSchema>;
@@ -1445,6 +1503,7 @@ type OpenSpecUIConfigUpdate = {
   };
   theme?: OpenSpecUIConfig['theme'];
   terminal?: Partial<TerminalConfig>;
+  dashboard?: Partial<DashboardConfig>;
 };
 /** 默认配置（静态，用于测试和类型） */
 declare const DEFAULT_CONFIG: OpenSpecUIConfig;
@@ -1663,6 +1722,99 @@ declare function getConfiguredTools(projectDir: string): Promise<string[]>;
  */
 declare function isToolConfigured(projectDir: string, toolId: string): Promise<boolean>;
 //#endregion
+//#region src/dashboard-types.d.ts
+declare const DASHBOARD_METRIC_KEYS: readonly ["specifications", "requirements", "activeChanges", "inProgressChanges", "completedChanges", "taskCompletionPercent"];
+type DashboardMetricKey = (typeof DASHBOARD_METRIC_KEYS)[number];
+interface DashboardTrendPoint {
+  ts: number;
+  value: number;
+}
+interface DashboardTriColorTrendPoint {
+  ts: number;
+  add: number;
+  modify: number;
+  delete: number;
+}
+type DashboardTrendKind = 'monotonic' | 'bidirectional';
+interface DashboardTrendMeta {
+  pointLimit: number;
+  lastUpdatedAt: number;
+}
+type DashboardCardAvailability = {
+  state: 'ok';
+} | {
+  state: 'invalid';
+  reason: 'semantic-uncomputable' | 'objective-history-unavailable';
+};
+interface DashboardSummary {
+  specifications: number;
+  requirements: number;
+  activeChanges: number;
+  inProgressChanges: number;
+  completedChanges: number;
+  archivedTasksCompleted: number;
+  tasksTotal: number;
+  tasksCompleted: number;
+  taskCompletionPercent: number | null;
+}
+interface DashboardGitDiffStats {
+  files: number;
+  insertions: number;
+  deletions: number;
+}
+interface DashboardGitCommitEntry {
+  type: 'commit';
+  hash: string;
+  title: string;
+  relatedChanges: string[];
+  diff: DashboardGitDiffStats;
+}
+interface DashboardGitUncommittedEntry {
+  type: 'uncommitted';
+  title: string;
+  relatedChanges: string[];
+  diff: DashboardGitDiffStats;
+}
+type DashboardGitEntry = DashboardGitCommitEntry | DashboardGitUncommittedEntry;
+interface DashboardGitWorktree {
+  path: string;
+  relativePath: string;
+  branchName: string;
+  isCurrent: boolean;
+  ahead: number;
+  behind: number;
+  diff: DashboardGitDiffStats;
+  entries: DashboardGitEntry[];
+}
+interface DashboardGitSnapshot {
+  defaultBranch: string;
+  worktrees: DashboardGitWorktree[];
+}
+interface DashboardOverview {
+  summary: DashboardSummary;
+  trends: Record<DashboardMetricKey, DashboardTrendPoint[]>;
+  triColorTrends: Record<DashboardMetricKey, DashboardTriColorTrendPoint[]>;
+  trendKinds: Record<DashboardMetricKey, DashboardTrendKind>;
+  cardAvailability: Record<DashboardMetricKey, DashboardCardAvailability>;
+  trendMeta: DashboardTrendMeta;
+  specifications: Array<{
+    id: string;
+    name: string;
+    requirements: number;
+    updatedAt: number;
+  }>;
+  activeChanges: Array<{
+    id: string;
+    name: string;
+    progress: {
+      total: number;
+      completed: number;
+    };
+    updatedAt: number;
+  }>;
+  git: DashboardGitSnapshot;
+}
+//#endregion
 //#region src/opsx-types.d.ts
 /** Check if an outputPath contains glob pattern characters */
 declare function isGlobPattern(pattern: string): boolean;
@@ -1673,14 +1825,14 @@ declare const ArtifactStatusSchema: z.ZodObject<{
   missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
   relativePath: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-  id: string;
   status: "done" | "ready" | "blocked";
+  id: string;
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
 }, {
-  id: string;
   status: "done" | "ready" | "blocked";
+  id: string;
   outputPath: string;
   missingDeps?: string[] | undefined;
   relativePath?: string | undefined;
@@ -1698,14 +1850,14 @@ declare const ChangeStatusSchema: z.ZodObject<{
     missingDeps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     relativePath: z.ZodOptional<z.ZodString>;
   }, "strip", z.ZodTypeAny, {
-    id: string;
     status: "done" | "ready" | "blocked";
+    id: string;
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
   }, {
-    id: string;
     status: "done" | "ready" | "blocked";
+    id: string;
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1716,8 +1868,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    id: string;
     status: "done" | "ready" | "blocked";
+    id: string;
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1728,8 +1880,8 @@ declare const ChangeStatusSchema: z.ZodObject<{
   isComplete: boolean;
   applyRequires: string[];
   artifacts: {
-    id: string;
     status: "done" | "ready" | "blocked";
+    id: string;
     outputPath: string;
     missingDeps?: string[] | undefined;
     relativePath?: string | undefined;
@@ -1742,13 +1894,13 @@ declare const DependencyInfoSchema: z.ZodObject<{
   path: z.ZodString;
   description: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-  id: string;
   path: string;
+  id: string;
   description: string;
   done: boolean;
 }, {
-  id: string;
   path: string;
+  id: string;
   description: string;
   done: boolean;
 }>;
@@ -1856,13 +2008,13 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
     path: z.ZodString;
     description: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }, {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }>, "many">;
@@ -1876,8 +2028,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }[];
@@ -1894,8 +2046,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    id: string;
     path: string;
+    id: string;
     description: string;
     done: boolean;
   }[];
@@ -1926,43 +2078,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, {
-  name: string;
   path: string;
+  name: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
     source: "project" | "user" | "package";
+    displayPath?: string | undefined;
   }[];
+  displayPath?: string | undefined;
 }, {
-  name: string;
   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<{
@@ -2067,6 +2230,25 @@ 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 */
   specs: Array<{
     id: string;
@@ -2136,8 +2318,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>;
   };
 }
@@ -2146,6 +2335,7 @@ interface ExportSnapshot {
 type TemplateContentMap = Record<string, {
   content: string | null;
   path: string;
+  displayPath?: string;
   source: TemplatesMap[string]['source'];
 }>;
 interface GlobArtifactFile {
@@ -2254,22 +2444,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;
@@ -2286,19 +2476,19 @@ declare const PtyCreateMessageSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>;
@@ -2376,19 +2566,19 @@ declare const PtyClientMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
 }, "strip", z.ZodTypeAny, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }, {
   type: "create";
   requestId: string;
-  command?: string | undefined;
-  args?: string[] | undefined;
   cols?: number | undefined;
   rows?: number | undefined;
+  command?: string | undefined;
+  args?: string[] | undefined;
   closeTip?: string | undefined;
   closeCallbackUrl?: string | Record<string, string> | undefined;
 }>, z.ZodObject<{
@@ -2530,22 +2720,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;
@@ -2553,12 +2743,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;
@@ -2566,12 +2756,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;
@@ -2584,14 +2774,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<{
@@ -2670,22 +2860,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;
@@ -2693,12 +2883,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;
@@ -2706,12 +2896,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;
@@ -2722,14 +2912,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>;
@@ -2737,4 +2927,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, DEFAULT_CONFIG, 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, 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 ToolConfig, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, acquireWatcher, buildCliRunnerCandidates, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getProjectWatcher, getToolById, getWatchedProjectDir, initWatcherPool, isGlobPattern, 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, 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, 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 };