@openspecui/core 2.2.0 → 2.3.3

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, {
-  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;
 }>;
@@ -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;
@@ -1406,6 +1406,15 @@ declare const DashboardConfigSchema: z.ZodObject<{
   trendPointLimit?: number | undefined;
 }>;
 type DashboardConfig = z.infer<typeof DashboardConfigSchema>;
+declare const DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET = 1000;
+declare const GitConfigSchema: z.ZodObject<{
+  diffEagerLineBudget: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+  diffEagerLineBudget: number;
+}, {
+  diffEagerLineBudget?: number | undefined;
+}>;
+type GitConfig = z.infer<typeof GitConfigSchema>;
 /**
  * OpenSpecUI 配置 Schema
  *
@@ -1468,6 +1477,14 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   }, {
     trendPointLimit?: number | undefined;
   }>>;
+  /** Git detail 配置 */
+  git: z.ZodDefault<z.ZodObject<{
+    diffEagerLineBudget: z.ZodDefault<z.ZodNumber>;
+  }, "strip", z.ZodTypeAny, {
+    diffEagerLineBudget: number;
+  }, {
+    diffEagerLineBudget?: number | undefined;
+  }>>;
 }, "strip", z.ZodTypeAny, {
   theme: "light" | "dark" | "system";
   cli: {
@@ -1489,6 +1506,9 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   dashboard: {
     trendPointLimit: number;
   };
+  git: {
+    diffEagerLineBudget: number;
+  };
 }, {
   theme?: "light" | "dark" | "system" | undefined;
   cli?: {
@@ -1510,6 +1530,9 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   dashboard?: {
     trendPointLimit?: number | undefined;
   } | undefined;
+  git?: {
+    diffEagerLineBudget?: number | undefined;
+  } | undefined;
 }>;
 type OpenSpecUIConfig = z.infer<typeof OpenSpecUIConfigSchema>;
 type OpenSpecUIConfigUpdate = {
@@ -1522,6 +1545,7 @@ type OpenSpecUIConfigUpdate = {
   appBaseUrl?: OpenSpecUIConfig['appBaseUrl'];
   terminal?: Partial<TerminalConfig>;
   dashboard?: Partial<DashboardConfig>;
+  git?: Partial<GitConfig>;
 };
 /** 默认配置（静态，用于测试和类型） */
 declare const DEFAULT_CONFIG: OpenSpecUIConfig;
@@ -2452,8 +2476,13 @@ interface GitEntryShell {
   entry: DashboardGitEntry | null;
   files: GitEntryFileSummary[];
 }
+interface GitEntryFiles {
+  files: GitEntryFileSummary[];
+  eagerFiles: GitEntryFilePatch[];
+  eagerPatchLineBudget: number;
+  eagerPatchLineCount: number;
+}
 interface GitEntryPatch {
-  entry: DashboardGitEntry | null;
   file: GitEntryFilePatch | null;
 }
 type GitPatchFile = GitEntryFilePatch;
@@ -2584,22 +2613,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;
@@ -2860,22 +2889,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;
@@ -2883,12 +2912,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;
@@ -2896,12 +2925,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;
@@ -3000,22 +3029,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;
@@ -3023,12 +3052,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;
@@ -3036,12 +3065,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;
@@ -3067,4 +3096,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, 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 GitEntriesPage, type GitEntryCursor, type GitEntryDetail, type GitEntryFileDiff, type GitEntryFilePatch, type GitEntryFileSource, type GitEntryFileSummary, 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, 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 };

package/dist/index.mjs

@@ -1919,6 +1919,101 @@ function createFileChangeObservable(watcher) {
 	} };
 }
 
+//#endregion
+//#region src/spawn-safe.ts
+function getSpawnErrorCode(err) {
+	if (typeof err !== "object" || err === null || !("code" in err)) return;
+	const code = err.code;
+	return typeof code === "string" ? code : void 0;
+}
+function formatSpawnError(err) {
+	const message = err instanceof Error ? err.message : String(err);
+	const code = getSpawnErrorCode(err);
+	return {
+		code,
+		message: `${message}${code ? ` (${code})` : ""}`
+	};
+}
+function spawnSafe(command, args, options) {
+	try {
+		return {
+			ok: true,
+			child: spawn(command, [...args], options)
+		};
+	} catch (err) {
+		return {
+			ok: false,
+			error: formatSpawnError(err)
+		};
+	}
+}
+function killChild(child) {
+	try {
+		child.kill();
+	} catch {}
+}
+function runBufferedCommand(options) {
+	return new Promise((resolve$1) => {
+		const started = spawnSafe(options.command, options.args, {
+			cwd: options.cwd,
+			shell: false,
+			env: options.env
+		});
+		if (!started.ok) {
+			resolve$1({
+				stdout: "",
+				stderr: "",
+				exitCode: null,
+				timedOut: false,
+				spawnError: started.error
+			});
+			return;
+		}
+		const { child } = started;
+		let stdout = "";
+		let stderr = "";
+		let timedOut = false;
+		let settled = false;
+		let clearTimer = () => {};
+		if (options.timeoutMs !== void 0) {
+			const timer = setTimeout(() => {
+				timedOut = true;
+				killChild(child);
+			}, options.timeoutMs);
+			clearTimer = () => clearTimeout(timer);
+		}
+		const finish = (result) => {
+			if (settled) return;
+			settled = true;
+			clearTimer();
+			resolve$1(result);
+		};
+		child.stdout?.on("data", (data) => {
+			stdout += data.toString();
+		});
+		child.stderr?.on("data", (data) => {
+			stderr += data.toString();
+		});
+		child.on("error", (err) => {
+			finish({
+				stdout,
+				stderr,
+				exitCode: null,
+				timedOut,
+				spawnError: formatSpawnError(err)
+			});
+		});
+		child.on("close", (exitCode) => {
+			finish({
+				stdout,
+				stderr,
+				exitCode,
+				timedOut
+			});
+		});
+	});
+}
+
 //#endregion
 //#region src/config.ts
 const execAsync = promisify(exec);
@@ -2172,69 +2267,44 @@ function createCleanCliEnv(baseEnv = process.env) {
 }
 async function probeCliRunner(candidate, cwd, env) {
 	const [cmd, ...cmdArgs] = candidate.commandParts;
-	return new Promise((resolve$1) => {
-		let stdout = "";
-		let stderr = "";
-		let timedOut = false;
-		const timer = setTimeout(() => {
-			timedOut = true;
-			child.kill();
-		}, CLI_PROBE_TIMEOUT_MS);
-		const child = spawn(cmd, [...cmdArgs, "--version"], {
-			cwd,
-			shell: false,
-			env
-		});
-		child.stdout?.on("data", (data) => {
-			stdout += data.toString();
-		});
-		child.stderr?.on("data", (data) => {
-			stderr += data.toString();
-		});
-		child.on("error", (err) => {
-			clearTimeout(timer);
-			const code = err.code;
-			const suffix = code ? ` (${code})` : "";
-			resolve$1({
-				source: candidate.source,
-				command: commandToString(candidate.commandParts),
-				success: false,
-				error: `${err.message}${suffix}`,
-				exitCode: null
-			});
-		});
-		child.on("close", (exitCode) => {
-			clearTimeout(timer);
-			if (timedOut) {
-				resolve$1({
-					source: candidate.source,
-					command: commandToString(candidate.commandParts),
-					success: false,
-					error: "CLI probe timed out",
-					exitCode
-				});
-				return;
-			}
-			if (exitCode === 0) {
-				const version = stdout.trim().split("\n")[0] || void 0;
-				resolve$1({
-					source: candidate.source,
-					command: commandToString(candidate.commandParts),
-					success: true,
-					version,
-					exitCode
-				});
-				return;
-			}
-			resolve$1({
-				source: candidate.source,
-				command: commandToString(candidate.commandParts),
-				success: false,
-				error: stderr.trim() || `Exit code ${exitCode ?? "null"}`,
-				exitCode
-			});
-		});
+	const result = await runBufferedCommand({
+		command: cmd,
+		args: [...cmdArgs, "--version"],
+		cwd,
+		env,
+		timeoutMs: CLI_PROBE_TIMEOUT_MS
 	});
+	if (result.timedOut) return {
+		source: candidate.source,
+		command: commandToString(candidate.commandParts),
+		success: false,
+		error: "CLI probe timed out",
+		exitCode: result.exitCode
+	};
+	if (result.spawnError) return {
+		source: candidate.source,
+		command: commandToString(candidate.commandParts),
+		success: false,
+		error: result.spawnError.message,
+		exitCode: null
+	};
+	if (result.exitCode === 0) {
+		const version = result.stdout.trim().split("\n")[0] || void 0;
+		return {
+			source: candidate.source,
+			command: commandToString(candidate.commandParts),
+			success: true,
+			version,
+			exitCode: result.exitCode
+		};
+	}
+	return {
+		source: candidate.source,
+		command: commandToString(candidate.commandParts),
+		success: false,
+		error: result.stderr.trim() || `Exit code ${result.exitCode ?? "null"}`,
+		exitCode: result.exitCode
+	};
 }
 async function resolveCliRunner(candidates, cwd, env) {
 	const expandedCandidates = await expandCliRunnerCandidates(candidates, cwd, env);
@@ -2344,6 +2414,8 @@ const TerminalConfigSchema = z.object({
 	rendererEngine: z.string().default("xterm")
 });
 const DashboardConfigSchema = z.object({ trendPointLimit: z.number().int().min(20).max(500).default(100) });
+const DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET = 1e3;
+const GitConfigSchema = z.object({ diffEagerLineBudget: z.number().int().min(0).max(2e5).default(DEFAULT_GIT_DIFF_EAGER_LINE_BUDGET) });
 const CodeEditorConfigSchema = z.object({ theme: CodeEditorThemeSchema.default("github") });
 /**
 * OpenSpecUI 配置 Schema
@@ -2359,7 +2431,8 @@ const OpenSpecUIConfigSchema = z.object({
 	codeEditor: CodeEditorConfigSchema.default(CodeEditorConfigSchema.parse({})),
 	appBaseUrl: z.string().default(""),
 	terminal: TerminalConfigSchema.default(TerminalConfigSchema.parse({})),
-	dashboard: DashboardConfigSchema.default(DashboardConfigSchema.parse({}))
+	dashboard: DashboardConfigSchema.default(DashboardConfigSchema.parse({})),
+	git: GitConfigSchema.default(GitConfigSchema.parse({}))
 });
 /** 默认配置（静态，用于测试和类型） */
 const DEFAULT_CONFIG = {
@@ -2368,7 +2441,8 @@ const DEFAULT_CONFIG = {
 	codeEditor: CodeEditorConfigSchema.parse({}),
 	appBaseUrl: "",
 	terminal: TerminalConfigSchema.parse({}),
-	dashboard: DashboardConfigSchema.parse({})
+	dashboard: DashboardConfigSchema.parse({}),
+	git: GitConfigSchema.parse({})
 };
 function areStringArraysEqual(left, right) {
 	if (left === right) return true;
@@ -2419,6 +2493,9 @@ function toPersistedConfig(config, options = {}) {
 	const dashboard = {};
 	if (config.dashboard.trendPointLimit !== DEFAULT_CONFIG.dashboard.trendPointLimit) dashboard.trendPointLimit = config.dashboard.trendPointLimit;
 	if (hasOwnEntries(dashboard)) persisted.dashboard = dashboard;
+	const git = {};
+	if (config.git.diffEagerLineBudget !== DEFAULT_CONFIG.git.diffEagerLineBudget) git.diffEagerLineBudget = config.git.diffEagerLineBudget;
+	if (hasOwnEntries(git)) persisted.git = git;
 	return persisted;
 }
 function isPersistedConfigEmpty(config) {
@@ -2505,6 +2582,10 @@ var ConfigManager = class {
 			dashboard: {
 				...current.dashboard,
 				...config.dashboard
+			},
+			git: {
+				...current.git,
+				...config.git
 			}
 		});
 		if (isPersistedConfigEmpty(persisted) && !fileExists) return;
@@ -2645,42 +2726,27 @@ var CliExecutor = class {
 	async buildCommandArray(args) {
 		return [...await this.configManager.getCliCommand(), ...args];
 	}
-	runCommandOnce(fullCommand) {
+	async runCommandOnce(fullCommand) {
 		const [cmd, ...cmdArgs] = fullCommand;
-		return new Promise((resolve$1) => {
-			const child = spawn(cmd, cmdArgs, {
-				cwd: this.projectDir,
-				shell: false,
-				env: createCleanCliEnv()
-			});
-			let stdout = "";
-			let stderr = "";
-			child.stdout?.on("data", (data) => {
-				stdout += data.toString();
-			});
-			child.stderr?.on("data", (data) => {
-				stderr += data.toString();
-			});
-			child.on("close", (exitCode) => {
-				resolve$1({
-					success: exitCode === 0,
-					stdout,
-					stderr,
-					exitCode
-				});
-			});
-			child.on("error", (err) => {
-				const errorCode = err.code;
-				const errorMessage = err.message + (errorCode ? ` (${errorCode})` : "");
-				resolve$1({
-					success: false,
-					stdout,
-					stderr: stderr ? `${stderr}\n${errorMessage}` : errorMessage,
-					exitCode: null,
-					errorCode
-				});
-			});
+		const result = await runBufferedCommand({
+			command: cmd,
+			args: cmdArgs,
+			cwd: this.projectDir,
+			env: createCleanCliEnv()
 		});
+		if (result.spawnError) return {
+			success: false,
+			stdout: result.stdout,
+			stderr: result.stderr ? `${result.stderr}\n${result.spawnError.message}` : result.spawnError.message,
+			exitCode: null,
+			errorCode: result.spawnError.code
+		};
+		return {
+			success: result.exitCode === 0,
+			stdout: result.stdout,
+			stderr: result.stderr,
+			exitCode: result.exitCode
+		};
 	}
 	async executeInternal(args, allowRetry) {
 		let fullCommand;
@@ -2834,11 +2900,29 @@ var CliExecutor = class {
 				data: fullCommand.join(" ")
 			});
 			const [cmd, ...cmdArgs] = fullCommand;
-			const child = spawn(cmd, cmdArgs, {
+			const started = spawnSafe(cmd, cmdArgs, {
 				cwd: this.projectDir,
 				shell: false,
 				env: createCleanCliEnv()
 			});
+			if (!started.ok) {
+				const { code, message } = started.error;
+				if (allowRetry && code === "ENOENT" && !cancelled) {
+					this.configManager.invalidateResolvedCliRunner();
+					start(false);
+					return;
+				}
+				onEvent({
+					type: "stderr",
+					data: message
+				});
+				onEvent({
+					type: "exit",
+					exitCode: null
+				});
+				return;
+			}
+			const child = started.child;
 			activeChild = child;
 			child.stdout?.on("data", (data) => {
 				onEvent({
@@ -2863,8 +2947,7 @@ var CliExecutor = class {
 			child.on("error", (err) => {
 				if (activeChild !== child) return;
 				activeChild = null;
-				const code = err.code;
-				const message = err.message + (code ? ` (${code})` : "");
+				const { code, message } = formatSpawnError(err);
 				if (allowRetry && code === "ENOENT" && !cancelled) {
 					this.configManager.invalidateResolvedCliRunner();
 					start(false);
@@ -2949,11 +3032,23 @@ var CliExecutor = class {
 			type: "command",
 			data: command.join(" ")
 		});
-		const child = spawn(cmd, cmdArgs, {
+		const started = spawnSafe(cmd, cmdArgs, {
 			cwd: this.projectDir,
 			shell: false,
 			env: createCleanCliEnv()
 		});
+		if (!started.ok) {
+			onEvent({
+				type: "stderr",
+				data: started.error.message
+			});
+			onEvent({
+				type: "exit",
+				exitCode: null
+			});
+			return () => {};
+		}
+		const child = started.child;
 		child.stdout?.on("data", (data) => {
 			onEvent({
 				type: "stdout",
@@ -2973,10 +3068,10 @@ var CliExecutor = class {
 			});
 		});
 		child.on("error", (err) => {
-			const code = err.code;
+			const { message } = formatSpawnError(err);
 			onEvent({
 				type: "stderr",
-				data: err.message + (code ? ` (${code})` : "")
+				data: message
 			});
 			onEvent({
 				type: "exit",
@@ -4341,4 +4436,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, DashboardConfigSchema, DeltaOperationType, DeltaSchema, DeltaSpecSchema, DependencyInfoSchema, 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, toOpsxDisplayPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "2.2.0",
+  "version": "2.3.3",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -39,10 +39,10 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^2.1.9",
+    "@vitest/coverage-v8": "^4.1.0",
     "tsdown": "^0.16.6",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^4.1.0"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"