@openspecui/core 2.1.7 → 2.3.0

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;
@@ -1861,6 +1885,7 @@ type DashboardGitEntry = DashboardGitCommitEntry | DashboardGitUncommittedEntry;
 interface DashboardGitWorktree {
   path: string;
   relativePath: string;
+  pathAvailable: boolean;
   branchName: string;
   detached: boolean;
   isCurrent: boolean;
@@ -2412,6 +2437,69 @@ interface ExportSnapshot {
   };
 }
 //#endregion
+//#region src/git-panel-types.d.ts
+type GitEntryCursor = string;
+type GitEntrySelector = {
+  type: 'uncommitted';
+} | {
+  type: 'commit';
+  hash: string;
+};
+type GitFileChangeType = 'added' | 'modified' | 'deleted' | 'renamed' | 'copied' | 'typechanged' | 'unmerged' | 'unknown';
+type GitPatchState = 'available' | 'binary' | 'too-large' | 'unavailable';
+type GitEntryFileSource = 'tracked' | 'untracked';
+type GitEntryFileDiff = ({
+  state: 'ready';
+} & DashboardGitDiffStats) | {
+  state: 'loading' | 'unavailable';
+  files: number;
+};
+type GitWorktreeSummary = Omit<DashboardGitWorktree, 'entries'>;
+interface GitEntriesPage {
+  items: DashboardGitEntry[];
+  nextCursor: GitEntryCursor | null;
+}
+interface GitEntryFileSummary {
+  fileId: string;
+  source: GitEntryFileSource;
+  path: string;
+  displayPath: string;
+  previousPath: string | null;
+  changeType: GitFileChangeType;
+  diff: GitEntryFileDiff;
+}
+interface GitEntryFilePatch extends GitEntryFileSummary {
+  patch: string | null;
+  state: GitPatchState;
+}
+interface GitEntryShell {
+  entry: DashboardGitEntry | null;
+  files: GitEntryFileSummary[];
+}
+interface GitEntryFiles {
+  files: GitEntryFileSummary[];
+  eagerFiles: GitEntryFilePatch[];
+  eagerPatchLineBudget: number;
+  eagerPatchLineCount: number;
+}
+interface GitEntryPatch {
+  file: GitEntryFilePatch | null;
+}
+type GitPatchFile = GitEntryFilePatch;
+interface GitEntryDetail {
+  entry: DashboardGitEntry | null;
+  files: GitEntryFilePatch[];
+}
+interface GitWorktreeOverview {
+  defaultBranch: string;
+  currentWorktree: GitWorktreeSummary | null;
+  otherWorktrees: GitWorktreeSummary[];
+}
+interface GitWorktreeHandoff {
+  projectDir: string;
+  serverUrl: string;
+}
+//#endregion
 //#region src/opsx-kernel.d.ts
 type TemplateContentMap = Record<string, {
   content: string | null;
@@ -2525,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;
@@ -2801,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;
@@ -2824,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;
@@ -2837,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;
@@ -2941,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;
@@ -2964,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;
@@ -2977,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;
@@ -3008,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 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

@@ -9,7 +9,7 @@ import { existsSync, lstatSync, realpathSync } from "node:fs";
 import { z } from "zod";
 import { EventEmitter } from "events";
 import { watch } from "fs";
-import { exec, spawn } from "child_process";
+import { exec, execFile, spawn } from "child_process";
 import { promisify } from "util";
 import { homedir } from "node:os";
 import { parse } from "yaml";
@@ -1922,6 +1922,7 @@ function createFileChangeObservable(watcher) {
 //#endregion
 //#region src/config.ts
 const execAsync = promisify(exec);
+const execFileAsync = promisify(execFile);
 const CLI_PROBE_TIMEOUT_MS = 2e4;
 const THEME_VALUES = [
 	"light",
@@ -2084,6 +2085,53 @@ function commandToString(commandParts) {
 	};
 	return commandParts.map(formatToken).join(" ").trim();
 }
+function isBareExecutableCommand(command) {
+	if (!command) return false;
+	if (command === "." || command === "..") return false;
+	return !/[\\/]/.test(command);
+}
+function quotePosixShellArg(value) {
+	return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+async function resolveShellExecutablePath(command, cwd, env) {
+	if (!isBareExecutableCommand(command)) return null;
+	try {
+		if (process.platform === "win32") {
+			const { stdout: stdout$1 } = await execFileAsync("where", [command], {
+				cwd,
+				env,
+				encoding: "utf8",
+				timeout: 5e3
+			});
+			return stdout$1.split(/\r?\n/).map((line) => line.trim()).find((line) => line.length > 0) || null;
+		}
+		const { stdout } = await execFileAsync(env.SHELL || process.env.SHELL || "/bin/sh", ["-lc", `command -v -- ${quotePosixShellArg(command)}`], {
+			cwd,
+			env,
+			encoding: "utf8",
+			timeout: 5e3
+		});
+		return stdout.split("\n").map((line) => line.trim()).find((line) => line.startsWith("/")) || null;
+	} catch {
+		return null;
+	}
+}
+async function expandCliRunnerCandidates(candidates, cwd, env) {
+	const expanded = [];
+	for (const candidate of candidates) {
+		const [command, ...rest] = candidate.commandParts;
+		if ((candidate.id === "openspec" || candidate.id === "configured" && command.trim().toLowerCase() === "openspec") && command) {
+			const shellResolved = await resolveShellExecutablePath(command, cwd, env);
+			if (shellResolved && shellResolved !== command) expanded.push({
+				...candidate,
+				source: `${candidate.source} (shell)`,
+				commandParts: [shellResolved, ...rest]
+			});
+		}
+		expanded.push(candidate);
+	}
+	return expanded;
+}
 function getRunnerPriorityFromUserAgent(userAgent) {
 	if (!userAgent) return null;
 	if (userAgent.startsWith("bun")) return "bunx";
@@ -2189,8 +2237,9 @@ async function probeCliRunner(candidate, cwd, env) {
 	});
 }
 async function resolveCliRunner(candidates, cwd, env) {
+	const expandedCandidates = await expandCliRunnerCandidates(candidates, cwd, env);
 	const attempts = [];
-	for (const candidate of candidates) {
+	for (const candidate of expandedCandidates) {
 		const attempt = await probeCliRunner(candidate, cwd, env);
 		attempts.push(attempt);
 		if (attempt.success) return {
@@ -2243,7 +2292,13 @@ async function fetchLatestVersion() {
 * 每次调用都会重新检测，不使用缓存。
 */
 async function sniffGlobalCli() {
-	const [localResult, latestVersion] = await Promise.all([execAsync("openspec --version", { timeout: 1e4 }).catch((err) => ({ error: err })), fetchLatestVersion()]);
+	const env = createCleanCliEnv();
+	const resolvedCommand = await resolveShellExecutablePath("openspec", process.cwd(), env) ?? "openspec";
+	const [localResult, latestVersion] = await Promise.all([execFileAsync(resolvedCommand, ["--version"], {
+		env,
+		timeout: 1e4,
+		encoding: "utf8"
+	}).catch((err) => ({ error: err })), fetchLatestVersion()]);
 	if ("error" in localResult) {
 		const error = localResult.error instanceof Error ? localResult.error.message : String(localResult.error);
 		if (error.includes("not found") || error.includes("ENOENT") || error.includes("not recognized")) return {
@@ -2289,6 +2344,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
@@ -2304,7 +2361,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 = {
@@ -2313,7 +2371,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;
@@ -2364,6 +2423,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) {
@@ -2450,6 +2512,10 @@ var ConfigManager = class {
 			dashboard: {
 				...current.dashboard,
 				...config.dashboard
+			},
+			git: {
+				...current.git,
+				...config.git
 			}
 		});
 		if (isPersistedConfigEmpty(persisted) && !fileExists) return;
@@ -4286,4 +4352,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.1.7",
+  "version": "2.3.0",
   "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"