@openspecui/core 2.3.4 → 2.3.6

package/dist/index.d.mts

@@ -19,13 +19,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;
 }>;
@@ -306,11 +306,11 @@ declare const DeltaSpecSchema: z.ZodObject<{
   /** Raw markdown content of the delta spec */
   content: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-  content: string;
   specId: string;
-}, {
   content: string;
+}, {
   specId: string;
+  content: string;
 }>;
 type DeltaSpec = z.infer<typeof DeltaSpecSchema>;
 /**
@@ -488,11 +488,11 @@ declare const ChangeSchema: z.ZodObject<{
     /** Raw markdown content of the delta spec */
     content: z.ZodString;
   }, "strip", z.ZodTypeAny, {
-    content: string;
     specId: string;
-  }, {
     content: string;
+  }, {
     specId: string;
+    content: string;
   }>, "many">>;
   /** Optional metadata */
   metadata: z.ZodOptional<z.ZodObject<{
@@ -549,8 +549,8 @@ declare const ChangeSchema: z.ZodObject<{
   } | undefined;
   design?: string | undefined;
   deltaSpecs?: {
-    content: string;
     specId: string;
+    content: string;
   }[] | undefined;
 }, {
   id: string;
@@ -596,8 +596,8 @@ declare const ChangeSchema: z.ZodObject<{
   } | undefined;
   design?: string | undefined;
   deltaSpecs?: {
-    content: string;
     specId: string;
+    content: string;
   }[] | undefined;
 }>;
 type Change = z.infer<typeof ChangeSchema>;
@@ -803,8 +803,8 @@ declare class OpenSpecAdapter {
       } | undefined;
       design?: string | undefined;
       deltaSpecs?: {
-        content: string;
         specId: string;
+        content: string;
       }[] | undefined;
     }[];
     archivedCount: number;
@@ -1036,13 +1036,23 @@ interface WatchEvent {
 type PathCallback = (events: WatchEvent[]) => void;
 /** watcher 重建原因 */
 type ProjectWatcherReinitializeReason = 'drop-events' | 'watcher-error' | 'missing-project-dir' | 'project-dir-replaced' | 'manual';
+type ProjectResidencyEvictionReason = Extract<ProjectWatcherReinitializeReason, 'missing-project-dir' | 'project-dir-replaced'>;
+type ProjectResidencyStatus = {
+  state: 'active';
+} | {
+  state: 'evicted';
+  reason: ProjectResidencyEvictionReason;
+  detectedAt: number;
+};
 /** watcher 运行时状态（用于调试和运维观测） */
 interface ProjectWatcherRuntimeStatus {
   generation: number;
   reinitializeCount: number;
   lastReinitializeReason: ProjectWatcherReinitializeReason | null;
   reinitializeReasonCounts: Readonly<Record<ProjectWatcherReinitializeReason, number>>;
+  projectResidency: ProjectResidencyStatus;
 }
+type ProjectWatcherRuntimeStatusListener = (status: ProjectWatcherRuntimeStatus) => void;
 /**
  * 项目监听器
  *
@@ -1074,6 +1084,8 @@ declare class ProjectWatcher {
   private reinitializeCount;
   private lastReinitializeReason;
   private reinitializeReasonCounts;
+  private projectResidency;
+  private runtimeStatusListeners;
   constructor(projectDir: string, options?: {
     debounceMs?: number;
     ignore?: string[];
@@ -1159,10 +1171,16 @@ declare class ProjectWatcher {
    * 获取 watcher 运行时状态
    */
   get runtimeStatus(): ProjectWatcherRuntimeStatus;
+  subscribeRuntimeStatus(listener: ProjectWatcherRuntimeStatusListener, options?: {
+    emitCurrent?: boolean;
+  }): () => void;
   /**
    * 记录重建统计
    */
   private markReinitialized;
+  private markProjectResidencyActive;
+  private markProjectResidencyEvicted;
+  private emitRuntimeStatus;
   /**
    * 重新初始化 watcher
    */
@@ -1241,6 +1259,9 @@ declare function getWatchedProjectDir(): string | null;
  * 获取 watcher 运行时状态
  */
 declare function getWatcherRuntimeStatus(): WatcherRuntimeStatus | null;
+declare function subscribeWatcherRuntimeStatus(listener: (status: WatcherRuntimeStatus | null) => void, options?: {
+  emitCurrent?: boolean;
+}): () => void;
 //#endregion
 //#region src/watcher.d.ts
 /**
@@ -1933,14 +1954,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;
@@ -1958,14 +1979,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;
@@ -1976,8 +1997,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;
@@ -1988,8 +2009,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;
@@ -2002,13 +2023,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;
 }>;
@@ -2116,13 +2137,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">;
@@ -2136,8 +2157,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }[];
@@ -2154,8 +2175,8 @@ declare const ArtifactInstructionsSchema: z.ZodObject<{
   artifactId: string;
   template: string;
   dependencies: {
-    path: string;
     id: string;
+    path: string;
     description: string;
     done: boolean;
   }[];
@@ -2201,8 +2222,8 @@ declare const SchemaResolutionSchema: z.ZodObject<{
     displayPath?: string | undefined;
   }>, "many">;
 }, "strip", z.ZodTypeAny, {
-  path: string;
   name: string;
+  path: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
@@ -2211,8 +2232,8 @@ declare const SchemaResolutionSchema: z.ZodObject<{
   }[];
   displayPath?: string | undefined;
 }, {
-  path: string;
   name: string;
+  path: string;
   source: "project" | "user" | "package";
   shadows: {
     path: string;
@@ -2500,6 +2521,34 @@ interface GitWorktreeHandoff {
   serverUrl: string;
 }
 //#endregion
+//#region src/runtime-types.d.ts
+type ProjectRecoveryStatus = {
+  state: 'idle';
+} | {
+  state: 'evicted';
+  reason: ProjectResidencyEvictionReason;
+  detectedAt: number;
+} | {
+  state: 'resolving';
+  reason: ProjectResidencyEvictionReason;
+  detectedAt: number;
+} | {
+  state: 'ready';
+  reason: ProjectResidencyEvictionReason;
+  detectedAt: number;
+  handoff: GitWorktreeHandoff;
+} | {
+  state: 'unavailable';
+  reason: ProjectResidencyEvictionReason;
+  detectedAt: number;
+  message: string;
+} | {
+  state: 'failed';
+  reason: ProjectResidencyEvictionReason;
+  detectedAt: number;
+  message: string;
+};
+//#endregion
 //#region src/opsx-kernel.d.ts
 type TemplateContentMap = Record<string, {
   content: string | null;
@@ -2613,22 +2662,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;
@@ -2645,19 +2694,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;
 }>;
@@ -2735,19 +2784,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<{
@@ -2889,22 +2938,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;
@@ -2912,12 +2961,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;
@@ -2925,12 +2974,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;
@@ -2943,14 +2992,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<{
@@ -3029,22 +3078,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;
@@ -3052,12 +3101,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;
@@ -3065,12 +3114,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;
@@ -3081,14 +3130,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>;
@@ -3096,4 +3145,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, 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, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, 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, 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, type HostedAppChannelKind, type HostedAppChannelManifest, type HostedAppCompatibilityEntry, type HostedAppVersionManifest, type HostedBackendHealthResponse, MarkdownParser, OFFICIAL_APP_BASE_URL, 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, TOOL_WORKFLOW_TO_SKILL_DIR, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type TerminalRendererEngine, TerminalRendererEngineSchema, type ToolConfig, type ToolInitDelivery, type ToolInitState, type ToolInitStatus, type ToolWorkflowId, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, acquireWatcher, buildCliRunnerCandidates, buildHostedLaunchUrl, buildHostedVersionManifestUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, toOpsxDisplayPath };
+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, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, 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, 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, type HostedAppChannelKind, type HostedAppChannelManifest, type HostedAppCompatibilityEntry, type HostedAppVersionManifest, type HostedBackendHealthResponse, MarkdownParser, OFFICIAL_APP_BASE_URL, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, OpsxKernel, type PathCallback, type ProjectRecoveryStatus, type ProjectResidencyEvictionReason, type ProjectResidencyStatus, ProjectWatcher, type ProjectWatcherReinitializeReason, type ProjectWatcherRuntimeStatus, type ProjectWatcherRuntimeStatusListener, 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, TOOL_WORKFLOW_TO_SKILL_DIR, type Task, TaskSchema, type TemplateContentMap, type TemplatesMap, TemplatesSchema, type TerminalConfig, TerminalConfigSchema, type TerminalRendererEngine, TerminalRendererEngineSchema, type ToolConfig, type ToolInitDelivery, type ToolInitState, type ToolInitStatus, type ToolWorkflowId, VIRTUAL_PROJECT_DIRNAME, type ValidationIssue, type ValidationResult, Validator, type WatchEvent, type WatchEventType, type WatcherRuntimeStatus, acquireWatcher, buildCliRunnerCandidates, buildHostedLaunchUrl, buildHostedVersionManifestUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };

package/dist/index.mjs

@@ -542,6 +542,8 @@ var ProjectWatcher = class {
 		"project-dir-replaced": 0,
 		manual: 0
 	};
+	projectResidency = { state: "active" };
+	runtimeStatusListeners = /* @__PURE__ */ new Set();
 	constructor(projectDir, options = {}) {
 		this.projectDir = getRealPath$1(projectDir);
 		this.debounceMs = options.debounceMs ?? DEBOUNCE_MS$1;
@@ -571,7 +573,9 @@ var ProjectWatcher = class {
 		this.initialized = true;
 		this.generation += 1;
 		this.projectDirFingerprint = this.getProjectDirFingerprint();
+		this.projectResidency = { state: "active" };
 		this.startPathLivenessMonitor();
+		this.emitRuntimeStatus();
 	}
 	/**
 	* 处理 watcher 错误
@@ -644,18 +648,23 @@ var ProjectWatcher = class {
 		if (!this.initialized || this.reinitializePending) return;
 		const current = this.getProjectDirFingerprint();
 		if (current === null) {
+			this.markProjectResidencyEvicted("missing-project-dir");
 			console.warn("[ProjectWatcher] Project directory missing, scheduling reinitialize...");
 			this.scheduleReinitialize("missing-project-dir");
 			return;
 		}
 		if (this.projectDirFingerprint === null) {
 			this.projectDirFingerprint = current;
+			this.markProjectResidencyActive();
 			return;
 		}
 		if (current !== this.projectDirFingerprint) {
+			this.markProjectResidencyEvicted("project-dir-replaced");
 			console.warn("[ProjectWatcher] Project directory replaced, scheduling reinitialize...");
 			this.scheduleReinitialize("project-dir-replaced");
+			return;
 		}
+		this.markProjectResidencyActive();
 	}
 	/**
 	* 处理原始事件
@@ -755,7 +764,15 @@ var ProjectWatcher = class {
 			generation: this.generation,
 			reinitializeCount: this.reinitializeCount,
 			lastReinitializeReason: this.lastReinitializeReason,
-			reinitializeReasonCounts: { ...this.reinitializeReasonCounts }
+			reinitializeReasonCounts: { ...this.reinitializeReasonCounts },
+			projectResidency: { ...this.projectResidency }
+		};
+	}
+	subscribeRuntimeStatus(listener, options = {}) {
+		this.runtimeStatusListeners.add(listener);
+		if (options.emitCurrent !== false) listener(this.runtimeStatus);
+		return () => {
+			this.runtimeStatusListeners.delete(listener);
 		};
 	}
 	/**
@@ -765,6 +782,29 @@ var ProjectWatcher = class {
 		this.reinitializeCount += 1;
 		this.lastReinitializeReason = reason;
 		this.reinitializeReasonCounts[reason] += 1;
+		this.emitRuntimeStatus();
+	}
+	markProjectResidencyActive() {
+		if (this.projectResidency.state === "active") return;
+		this.projectResidency = { state: "active" };
+		this.emitRuntimeStatus();
+	}
+	markProjectResidencyEvicted(reason) {
+		if (this.projectResidency.state === "evicted" && this.projectResidency.reason === reason) return;
+		this.projectResidency = {
+			state: "evicted",
+			reason,
+			detectedAt: Date.now()
+		};
+		this.emitRuntimeStatus();
+	}
+	emitRuntimeStatus() {
+		const status = this.runtimeStatus;
+		for (const listener of this.runtimeStatusListeners) try {
+			listener(status);
+		} catch (error) {
+			console.error("[ProjectWatcher] Runtime status listener failed:", error);
+		}
 	}
 	/**
 	* 重新初始化 watcher
@@ -780,6 +820,7 @@ var ProjectWatcher = class {
 		this.initialized = false;
 		this.initPromise = null;
 		this.projectDirFingerprint = null;
+		this.emitRuntimeStatus();
 		if (!existsSync(this.projectDir)) {
 			console.warn("[ProjectWatcher] Project directory does not exist, waiting for it to be created...");
 			this.waitForProjectDir("missing-project-dir");
@@ -842,6 +883,8 @@ var ProjectWatcher = class {
 		this.initialized = false;
 		this.initPromise = null;
 		this.projectDirFingerprint = null;
+		this.projectResidency = { state: "active" };
+		this.emitRuntimeStatus();
 	}
 };
 /**
@@ -894,6 +937,25 @@ const DEBOUNCE_MS = 100;
 const subscriptionCache = /* @__PURE__ */ new Map();
 /** 防抖定时器 */
 const debounceTimers = /* @__PURE__ */ new Map();
+const watcherRuntimeStatusListeners = /* @__PURE__ */ new Set();
+let releaseProjectWatcherRuntimeSubscription = null;
+function emitWatcherRuntimeStatus() {
+	const status = getWatcherRuntimeStatus();
+	for (const listener of watcherRuntimeStatusListeners) listener(status);
+}
+function bindProjectWatcherRuntimeStatus() {
+	releaseProjectWatcherRuntimeSubscription?.();
+	releaseProjectWatcherRuntimeSubscription = null;
+	if (!globalProjectWatcher) {
+		emitWatcherRuntimeStatus();
+		return;
+	}
+	const forward = () => {
+		emitWatcherRuntimeStatus();
+	};
+	releaseProjectWatcherRuntimeSubscription = globalProjectWatcher.subscribeRuntimeStatus(forward, { emitCurrent: false });
+	emitWatcherRuntimeStatus();
+}
 /**
 * 初始化 watcher pool
 *
@@ -905,9 +967,14 @@ const debounceTimers = /* @__PURE__ */ new Map();
 async function initWatcherPool(projectDir) {
 	const normalizedDir = getRealPath(projectDir);
 	if (globalProjectWatcher && globalProjectDir === normalizedDir) return;
-	if (globalProjectWatcher) await globalProjectWatcher.close();
+	if (globalProjectWatcher) {
+		releaseProjectWatcherRuntimeSubscription?.();
+		releaseProjectWatcherRuntimeSubscription = null;
+		await globalProjectWatcher.close();
+	}
 	globalProjectDir = normalizedDir;
 	globalProjectWatcher = getProjectWatcher(normalizedDir);
+	bindProjectWatcherRuntimeStatus();
 	await globalProjectWatcher.init();
 }
 /**
@@ -989,10 +1056,13 @@ async function closeAllWatchers() {
 	subscriptionCache.clear();
 	debounceTimers.clear();
 	if (globalProjectWatcher) {
+		releaseProjectWatcherRuntimeSubscription?.();
+		releaseProjectWatcherRuntimeSubscription = null;
 		await globalProjectWatcher.close();
 		globalProjectWatcher = null;
 		globalProjectDir = null;
 	}
+	emitWatcherRuntimeStatus();
 }
 /**
 * 检查 watcher pool 是否已初始化
@@ -1019,7 +1089,15 @@ function getWatcherRuntimeStatus() {
 		generation: runtime.generation,
 		reinitializeCount: runtime.reinitializeCount,
 		lastReinitializeReason: runtime.lastReinitializeReason,
-		reinitializeReasonCounts: runtime.reinitializeReasonCounts
+		reinitializeReasonCounts: runtime.reinitializeReasonCounts,
+		projectResidency: runtime.projectResidency
+	};
+}
+function subscribeWatcherRuntimeStatus(listener, options = {}) {
+	watcherRuntimeStatusListeners.add(listener);
+	if (options.emitCurrent !== false) listener(getWatcherRuntimeStatus());
+	return () => {
+		watcherRuntimeStatusListeners.delete(listener);
 	};
 }
 
@@ -4436,4 +4514,4 @@ const PtyServerMessageSchema = z.discriminatedUnion("type", [
 ]);
 
 //#endregion
-export { AI_TOOLS, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, GitConfigSchema, MarkdownParser, OFFICIAL_APP_BASE_URL, 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, TOOL_WORKFLOW_TO_SKILL_DIR, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, buildHostedLaunchUrl, buildHostedVersionManifestUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, toOpsxDisplayPath };
+export { AI_TOOLS, ApplyInstructionsSchema, ApplyTaskSchema, ArtifactInstructionsSchema, ArtifactStatusSchema, CODE_EDITOR_THEME_VALUES, ChangeFileSchema, ChangeSchema, ChangeStatusSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, DASHBOARD_METRIC_KEYS, DEFAULT_CONFIG, DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, GitConfigSchema, MarkdownParser, OFFICIAL_APP_BASE_URL, 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, TOOL_WORKFLOW_TO_SKILL_DIR, TaskSchema, TemplatesSchema, TerminalConfigSchema, TerminalRendererEngineSchema, VIRTUAL_PROJECT_DIRNAME, Validator, acquireWatcher, buildCliRunnerCandidates, buildHostedLaunchUrl, buildHostedVersionManifestUrl, clearCache, closeAllProjectWatchers, closeAllWatchers, contextStorage, createCleanCliEnv, createFileChangeObservable, getActiveWatcherCount, getAllToolIds, getAllTools, getAvailableToolIds, getAvailableTools, getCacheSize, getConfiguredTools, getDefaultCliCommand, getDefaultCliCommandString, getDetectedProjectTools, getProjectWatcher, getToolById, getToolInitStates, getWatchedProjectDir, getWatcherRuntimeStatus, initWatcherPool, isGlobPattern, isHostedAppVersionManifest, isHostedBackendHealthResponse, isTerminalRendererEngine, isToolConfigured, isWatcherPoolInitialized, normalizeHostedAppBaseUrl, parseCliCommand, reactiveExists, reactiveReadDir, reactiveReadFile, reactiveStat, resolveHostedAppBaseUrl, resolveHostedChannelForVersion, sniffGlobalCli, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "2.3.4",
+  "version": "2.3.6",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",