@openspecui/core 2.3.7 → 3.0.1

package/dist/hosted-app.d.mts

@@ -1,2 +1,2 @@
-import { a as HostedBackendHealthResponse, c as buildHostedVersionManifestUrl, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as HostedAppVersionManifest, l as isHostedAppVersionManifest, n as HostedAppChannelManifest, o as OFFICIAL_APP_BASE_URL, p as resolveHostedChannelForVersion, r as HostedAppCompatibilityEntry, s as buildHostedLaunchUrl, t as HostedAppChannelKind, u as isHostedBackendHealthResponse } from "./hosted-app-BP6Xje0B.mjs";
+import { a as HostedBackendHealthResponse, c as buildHostedVersionManifestUrl, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as HostedAppVersionManifest, l as isHostedAppVersionManifest, n as HostedAppChannelManifest, o as OFFICIAL_APP_BASE_URL, p as resolveHostedChannelForVersion, r as HostedAppCompatibilityEntry, s as buildHostedLaunchUrl, t as HostedAppChannelKind, u as isHostedBackendHealthResponse } from "./hosted-app-Dy4D7wV9.mjs";
 export { HostedAppChannelKind, HostedAppChannelManifest, HostedAppCompatibilityEntry, HostedAppVersionManifest, HostedBackendHealthResponse, OFFICIAL_APP_BASE_URL, buildHostedLaunchUrl, buildHostedVersionManifestUrl, isHostedAppVersionManifest, isHostedBackendHealthResponse, normalizeHostedAppBaseUrl, resolveHostedAppBaseUrl, resolveHostedChannelForVersion };

package/dist/hosted-app.mjs

@@ -1,3 +1,3 @@
-import { a as isHostedBackendHealthResponse, c as resolveHostedChannelForVersion, i as isHostedAppVersionManifest, n as buildHostedLaunchUrl, o as normalizeHostedAppBaseUrl, r as buildHostedVersionManifestUrl, s as resolveHostedAppBaseUrl, t as OFFICIAL_APP_BASE_URL } from "./hosted-app-C1JDznip.mjs";
+import { a as isHostedBackendHealthResponse, c as resolveHostedChannelForVersion, i as isHostedAppVersionManifest, n as buildHostedLaunchUrl, o as normalizeHostedAppBaseUrl, r as buildHostedVersionManifestUrl, s as resolveHostedAppBaseUrl, t as OFFICIAL_APP_BASE_URL } from "./hosted-app-Bv10mEdq.mjs";
 
 export { OFFICIAL_APP_BASE_URL, buildHostedLaunchUrl, buildHostedVersionManifestUrl, isHostedAppVersionManifest, isHostedBackendHealthResponse, normalizeHostedAppBaseUrl, resolveHostedAppBaseUrl, resolveHostedChannelForVersion };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { a as HostedBackendHealthResponse, c as buildHostedVersionManifestUrl, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as HostedAppVersionManifest, l as isHostedAppVersionManifest, n as HostedAppChannelManifest, o as OFFICIAL_APP_BASE_URL, p as resolveHostedChannelForVersion, r as HostedAppCompatibilityEntry, s as buildHostedLaunchUrl, t as HostedAppChannelKind, u as isHostedBackendHealthResponse } from "./hosted-app-BP6Xje0B.mjs";
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-Cb-CVa6h.mjs";
+import { a as HostedBackendHealthResponse, c as buildHostedVersionManifestUrl, d as normalizeHostedAppBaseUrl, f as resolveHostedAppBaseUrl, i as HostedAppVersionManifest, l as isHostedAppVersionManifest, n as HostedAppChannelManifest, o as OFFICIAL_APP_BASE_URL, p as resolveHostedChannelForVersion, r as HostedAppCompatibilityEntry, s as buildHostedLaunchUrl, t as HostedAppChannelKind, u as isHostedBackendHealthResponse } from "./hosted-app-Dy4D7wV9.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-C1H1ryBL.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { z } from "zod";
 import { EventEmitter } from "events";
@@ -1326,8 +1326,11 @@ declare function createFileChangeObservable(watcher: OpenSpecWatcher): {
 //#endregion
 //#region src/config.d.ts
 declare const CODE_EDITOR_THEME_VALUES: readonly ["github", "material", "vscode", "tokyo", "gruvbox", "monokai", "nord"];
+declare const OPSX_AGENT_INVOCATION_MODE_VALUES: readonly ["compose", "command"];
 declare const TerminalRendererEngineSchema: z.ZodEnum<["xterm", "ghostty"]>;
 type TerminalRendererEngine = z.infer<typeof TerminalRendererEngineSchema>;
+declare const OpsxAgentInvocationModeSchema: z.ZodEnum<["compose", "command"]>;
+type OpsxAgentInvocationMode = z.infer<typeof OpsxAgentInvocationModeSchema>;
 declare const CodeEditorThemeSchema: z.ZodEnum<["github", "material", "vscode", "tokyo", "gruvbox", "monokai", "nord"]>;
 type CodeEditorTheme = z.infer<typeof CodeEditorThemeSchema>;
 declare function isTerminalRendererEngine(value: string): value is TerminalRendererEngine;
@@ -1436,6 +1439,14 @@ declare const GitConfigSchema: z.ZodObject<{
   diffEagerLineBudget?: number | undefined;
 }>;
 type GitConfig = z.infer<typeof GitConfigSchema>;
+declare const OpsxConfigSchema: z.ZodObject<{
+  agentInvocationMode: z.ZodDefault<z.ZodEnum<["compose", "command"]>>;
+}, "strip", z.ZodTypeAny, {
+  agentInvocationMode: "command" | "compose";
+}, {
+  agentInvocationMode?: "command" | "compose" | undefined;
+}>;
+type OpsxConfig = z.infer<typeof OpsxConfigSchema>;
 /**
  * OpenSpecUI 配置 Schema
  *
@@ -1467,6 +1478,14 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
   }>>;
   /** Hosted app 基础 URL（空字符串表示使用官方默认值） */
   appBaseUrl: z.ZodDefault<z.ZodString>;
+  /** OPSX workflow invocation preferences */
+  opsx: z.ZodDefault<z.ZodObject<{
+    agentInvocationMode: z.ZodDefault<z.ZodEnum<["compose", "command"]>>;
+  }, "strip", z.ZodTypeAny, {
+    agentInvocationMode: "command" | "compose";
+  }, {
+    agentInvocationMode?: "command" | "compose" | undefined;
+  }>>;
   /** 终端配置 */
   terminal: z.ZodDefault<z.ZodObject<{
     fontSize: z.ZodDefault<z.ZodNumber>;
@@ -1516,6 +1535,9 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     theme: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord";
   };
   appBaseUrl: string;
+  opsx: {
+    agentInvocationMode: "command" | "compose";
+  };
   terminal: {
     fontSize: number;
     fontFamily: string;
@@ -1540,6 +1562,9 @@ declare const OpenSpecUIConfigSchema: z.ZodObject<{
     theme?: "github" | "material" | "vscode" | "tokyo" | "gruvbox" | "monokai" | "nord" | undefined;
   } | undefined;
   appBaseUrl?: string | undefined;
+  opsx?: {
+    agentInvocationMode?: "command" | "compose" | undefined;
+  } | undefined;
   terminal?: {
     fontSize?: number | undefined;
     fontFamily?: string | undefined;
@@ -1564,6 +1589,7 @@ type OpenSpecUIConfigUpdate = {
   theme?: OpenSpecUIConfig['theme'];
   codeEditor?: Partial<OpenSpecUIConfig['codeEditor']>;
   appBaseUrl?: OpenSpecUIConfig['appBaseUrl'];
+  opsx?: Partial<OpsxConfig>;
   terminal?: Partial<TerminalConfig>;
   dashboard?: Partial<DashboardConfig>;
   git?: Partial<GitConfig>;
@@ -1763,6 +1789,8 @@ interface AIToolOption {
   successLabel?: string;
   /** 技能目录（相对项目根目录） */
   skillsDir?: string;
+  /** 自动检测路径；存在任一路径即表示项目已有该工具配置 */
+  detectionPaths?: string[];
 }
 /**
  * 完整的工具配置（元信息 + skills 目录）
@@ -1841,6 +1869,7 @@ interface ToolInitState {
   missingCommandWorkflows: ToolWorkflowId[];
   unexpectedSkillWorkflows: ToolWorkflowId[];
   unexpectedCommandWorkflows: ToolWorkflowId[];
+  legacyCommandWorkflows: ToolWorkflowId[];
 }
 declare function getToolInitStates(projectDir: string, options: {
   delivery: ToolInitDelivery;
@@ -2048,11 +2077,12 @@ declare const ApplyTaskSchema: z.ZodObject<{
   done: boolean;
 }>;
 type ApplyTask = z.infer<typeof ApplyTaskSchema>;
+declare const ApplyInstructionsContextFilesSchema: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
 declare const ApplyInstructionsSchema: z.ZodObject<{
   changeName: z.ZodString;
   changeDir: z.ZodString;
   schemaName: z.ZodString;
-  contextFiles: z.ZodRecord<z.ZodString, z.ZodString>;
+  contextFiles: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
   progress: z.ZodObject<{
     total: z.ZodNumber;
     complete: z.ZodNumber;
@@ -2096,7 +2126,7 @@ declare const ApplyInstructionsSchema: z.ZodObject<{
   changeName: string;
   schemaName: string;
   changeDir: string;
-  contextFiles: Record<string, string>;
+  contextFiles: Record<string, string[]>;
   state: "ready" | "blocked" | "all_done";
   instruction: string;
   missingArtifacts?: string[] | undefined;
@@ -2114,7 +2144,7 @@ declare const ApplyInstructionsSchema: z.ZodObject<{
   changeName: string;
   schemaName: string;
   changeDir: string;
-  contextFiles: Record<string, string>;
+  contextFiles: Record<string, string | string[]>;
   state: "ready" | "blocked" | "all_done";
   instruction: string;
   missingArtifacts?: string[] | undefined;
@@ -3145,4 +3175,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, 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 };
+export { type AIToolOption, AI_TOOLS, type ApplyInstructions, ApplyInstructionsContextFilesSchema, 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, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, type OpenSpecUIConfig, OpenSpecUIConfigSchema, type OpenSpecUIConfigUpdate, OpenSpecWatcher, type OpsxAgentInvocationMode, OpsxAgentInvocationModeSchema, type OpsxConfig, OpsxConfigSchema, 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

@@ -1,5 +1,5 @@
-import { a as isHostedBackendHealthResponse, c as resolveHostedChannelForVersion, i as isHostedAppVersionManifest, n as buildHostedLaunchUrl, o as normalizeHostedAppBaseUrl, r as buildHostedVersionManifestUrl, s as resolveHostedAppBaseUrl, t as OFFICIAL_APP_BASE_URL } from "./hosted-app-C1JDznip.mjs";
-import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-DDK7QA5y.mjs";
+import { a as isHostedBackendHealthResponse, c as resolveHostedChannelForVersion, i as isHostedAppVersionManifest, n as buildHostedLaunchUrl, o as normalizeHostedAppBaseUrl, r as buildHostedVersionManifestUrl, s as resolveHostedAppBaseUrl, t as OFFICIAL_APP_BASE_URL } from "./hosted-app-Bv10mEdq.mjs";
+import { n as toOpsxDisplayPath, t as VIRTUAL_PROJECT_DIRNAME } from "./opsx-display-path-Cja3Bt1P.mjs";
 import { mkdir, readFile, rename, writeFile } from "fs/promises";
 import { dirname, join } from "path";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -2117,7 +2117,9 @@ const CODE_EDITOR_THEME_VALUES = [
 	"nord"
 ];
 const TERMINAL_RENDERER_ENGINE_VALUES = ["xterm", "ghostty"];
+const OPSX_AGENT_INVOCATION_MODE_VALUES = ["compose", "command"];
 const TerminalRendererEngineSchema = z.enum(TERMINAL_RENDERER_ENGINE_VALUES);
+const OpsxAgentInvocationModeSchema = z.enum(OPSX_AGENT_INVOCATION_MODE_VALUES);
 const CodeEditorThemeSchema = z.enum(CODE_EDITOR_THEME_VALUES);
 function isTerminalRendererEngine(value) {
 	return TERMINAL_RENDERER_ENGINE_VALUES.includes(value);
@@ -2495,6 +2497,7 @@ const DashboardConfigSchema = z.object({ trendPointLimit: z.number().int().min(2
 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") });
+const OpsxConfigSchema = z.object({ agentInvocationMode: OpsxAgentInvocationModeSchema.default("compose") });
 /**
 * OpenSpecUI 配置 Schema
 *
@@ -2508,6 +2511,7 @@ const OpenSpecUIConfigSchema = z.object({
 	theme: z.enum(THEME_VALUES).default("system"),
 	codeEditor: CodeEditorConfigSchema.default(CodeEditorConfigSchema.parse({})),
 	appBaseUrl: z.string().default(""),
+	opsx: OpsxConfigSchema.default(OpsxConfigSchema.parse({})),
 	terminal: TerminalConfigSchema.default(TerminalConfigSchema.parse({})),
 	dashboard: DashboardConfigSchema.default(DashboardConfigSchema.parse({})),
 	git: GitConfigSchema.default(GitConfigSchema.parse({}))
@@ -2518,6 +2522,7 @@ const DEFAULT_CONFIG = {
 	theme: "system",
 	codeEditor: CodeEditorConfigSchema.parse({}),
 	appBaseUrl: "",
+	opsx: OpsxConfigSchema.parse({}),
 	terminal: TerminalConfigSchema.parse({}),
 	dashboard: DashboardConfigSchema.parse({}),
 	git: GitConfigSchema.parse({})
@@ -2560,6 +2565,9 @@ function toPersistedConfig(config, options = {}) {
 	if (config.codeEditor.theme !== DEFAULT_CONFIG.codeEditor.theme) codeEditor.theme = config.codeEditor.theme;
 	if (hasOwnEntries(codeEditor)) persisted.codeEditor = codeEditor;
 	if (config.appBaseUrl !== DEFAULT_CONFIG.appBaseUrl) persisted.appBaseUrl = config.appBaseUrl;
+	const opsx = {};
+	if (config.opsx.agentInvocationMode !== DEFAULT_CONFIG.opsx.agentInvocationMode) opsx.agentInvocationMode = config.opsx.agentInvocationMode;
+	if (hasOwnEntries(opsx)) persisted.opsx = opsx;
 	const terminal = {};
 	if (config.terminal.fontSize !== DEFAULT_CONFIG.terminal.fontSize) terminal.fontSize = config.terminal.fontSize;
 	if (config.terminal.fontFamily !== DEFAULT_CONFIG.terminal.fontFamily) terminal.fontFamily = config.terminal.fontFamily;
@@ -2653,6 +2661,10 @@ var ConfigManager = class {
 				...config.codeEditor
 			},
 			appBaseUrl: config.appBaseUrl ?? current.appBaseUrl,
+			opsx: {
+				...current.opsx,
+				...config.opsx
+			},
 			terminal: {
 				...current.terminal,
 				...config.terminal
@@ -3213,6 +3225,13 @@ const AI_TOOLS = [
 		successLabel: "Auggie",
 		skillsDir: ".augment"
 	},
+	{
+		name: "Bob Shell",
+		value: "bob",
+		available: true,
+		successLabel: "Bob Shell",
+		skillsDir: ".bob"
+	},
 	{
 		name: "Claude Code",
 		value: "claude",
@@ -3234,6 +3253,13 @@ const AI_TOOLS = [
 		successLabel: "Codex",
 		skillsDir: ".codex"
 	},
+	{
+		name: "ForgeCode",
+		value: "forgecode",
+		available: true,
+		successLabel: "ForgeCode",
+		skillsDir: ".forge"
+	},
 	{
 		name: "CodeBuddy Code (CLI)",
 		value: "codebuddy",
@@ -3288,7 +3314,16 @@ const AI_TOOLS = [
 		value: "github-copilot",
 		available: true,
 		successLabel: "GitHub Copilot",
-		skillsDir: ".github"
+		skillsDir: ".github",
+		detectionPaths: [
+			".github/copilot-instructions.md",
+			".github/instructions",
+			".github/workflows/copilot-setup-steps.yml",
+			".github/prompts",
+			".github/agents",
+			".github/skills",
+			".github/.mcp.json"
+		]
 	},
 	{
 		name: "iFlow",
@@ -3297,6 +3332,13 @@ const AI_TOOLS = [
 		successLabel: "iFlow",
 		skillsDir: ".iflow"
 	},
+	{
+		name: "Junie",
+		value: "junie",
+		available: true,
+		successLabel: "Junie",
+		skillsDir: ".junie"
+	},
 	{
 		name: "Kilo Code",
 		value: "kilocode",
@@ -3332,6 +3374,13 @@ const AI_TOOLS = [
 		successLabel: "Qoder",
 		skillsDir: ".qoder"
 	},
+	{
+		name: "Lingma",
+		value: "lingma",
+		available: true,
+		successLabel: "Lingma",
+		skillsDir: ".lingma"
+	},
 	{
 		name: "Qwen Code",
 		value: "qwen",
@@ -3388,7 +3437,8 @@ function getAllTools() {
 async function getDetectedProjectTools(projectDir) {
 	return (await Promise.all(AI_TOOLS.map(async (tool) => {
 		if (!tool.skillsDir) return null;
-		return await reactiveExists(join$1(projectDir, tool.skillsDir)) ? tool : null;
+		const detectionPaths = tool.detectionPaths && tool.detectionPaths.length > 0 ? tool.detectionPaths : [tool.skillsDir];
+		return (await Promise.all(detectionPaths.map((path) => reactiveExists(join$1(projectDir, path))))).some(Boolean) ? tool : null;
 	}))).filter((tool) => tool !== null);
 }
 /**
@@ -3494,33 +3544,45 @@ function resolveCodexHome() {
 	const configuredHome = process.env.CODEX_HOME?.trim();
 	return resolve(configuredHome ? configuredHome : join$1(homedir(), ".codex"));
 }
-function resolveToolCommandPath(projectDir, toolId, workflow) {
-	switch (toolId) {
-		case "amazon-q": return resolve(projectDir, ".amazonq", "prompts", `opsx-${workflow}.md`);
-		case "antigravity": return resolve(projectDir, ".agent", "workflows", `opsx-${workflow}.md`);
-		case "auggie": return resolve(projectDir, ".augment", "commands", `opsx-${workflow}.md`);
-		case "claude": return resolve(projectDir, ".claude", "commands", "opsx", `${workflow}.md`);
-		case "cline": return resolve(projectDir, ".clinerules", "workflows", `opsx-${workflow}.md`);
-		case "codebuddy": return resolve(projectDir, ".codebuddy", "commands", "opsx", `${workflow}.md`);
-		case "codex": return resolve(resolveCodexHome(), "prompts", `opsx-${workflow}.md`);
-		case "continue": return resolve(projectDir, ".continue", "prompts", `opsx-${workflow}.prompt`);
-		case "costrict": return resolve(projectDir, ".cospec", "openspec", "commands", `opsx-${workflow}.md`);
-		case "crush": return resolve(projectDir, ".crush", "commands", "opsx", `${workflow}.md`);
-		case "cursor": return resolve(projectDir, ".cursor", "commands", `opsx-${workflow}.md`);
-		case "factory": return resolve(projectDir, ".factory", "commands", `opsx-${workflow}.md`);
-		case "gemini": return resolve(projectDir, ".gemini", "commands", "opsx", `${workflow}.toml`);
-		case "github-copilot": return resolve(projectDir, ".github", "prompts", `opsx-${workflow}.prompt.md`);
-		case "iflow": return resolve(projectDir, ".iflow", "commands", `opsx-${workflow}.md`);
-		case "kilocode": return resolve(projectDir, ".kilocode", "workflows", `opsx-${workflow}.md`);
-		case "kiro": return resolve(projectDir, ".kiro", "prompts", `opsx-${workflow}.prompt.md`);
-		case "opencode": return resolve(projectDir, ".opencode", "command", `opsx-${workflow}.md`);
-		case "pi": return resolve(projectDir, ".pi", "prompts", `opsx-${workflow}.md`);
-		case "qoder": return resolve(projectDir, ".qoder", "commands", "opsx", `${workflow}.md`);
-		case "qwen": return resolve(projectDir, ".qwen", "commands", `opsx-${workflow}.toml`);
-		case "roocode": return resolve(projectDir, ".roo", "commands", `opsx-${workflow}.md`);
-		case "windsurf": return resolve(projectDir, ".windsurf", "workflows", `opsx-${workflow}.md`);
-		default: return null;
-	}
+const TOOL_COMMAND_PATHS = {
+	"amazon-q": { primary: (projectDir, workflow) => resolve(projectDir, ".amazonq", "prompts", `opsx-${workflow}.md`) },
+	antigravity: { primary: (projectDir, workflow) => resolve(projectDir, ".agent", "workflows", `opsx-${workflow}.md`) },
+	auggie: { primary: (projectDir, workflow) => resolve(projectDir, ".augment", "commands", `opsx-${workflow}.md`) },
+	bob: { primary: (projectDir, workflow) => resolve(projectDir, ".bob", "commands", `opsx-${workflow}.md`) },
+	claude: { primary: (projectDir, workflow) => resolve(projectDir, ".claude", "commands", "opsx", `${workflow}.md`) },
+	cline: { primary: (projectDir, workflow) => resolve(projectDir, ".clinerules", "workflows", `opsx-${workflow}.md`) },
+	codebuddy: { primary: (projectDir, workflow) => resolve(projectDir, ".codebuddy", "commands", "opsx", `${workflow}.md`) },
+	codex: { primary: (_projectDir, workflow) => resolve(resolveCodexHome(), "prompts", `opsx-${workflow}.md`) },
+	continue: { primary: (projectDir, workflow) => resolve(projectDir, ".continue", "prompts", `opsx-${workflow}.prompt`) },
+	costrict: { primary: (projectDir, workflow) => resolve(projectDir, ".cospec", "openspec", "commands", `opsx-${workflow}.md`) },
+	crush: { primary: (projectDir, workflow) => resolve(projectDir, ".crush", "commands", "opsx", `${workflow}.md`) },
+	cursor: { primary: (projectDir, workflow) => resolve(projectDir, ".cursor", "commands", `opsx-${workflow}.md`) },
+	factory: { primary: (projectDir, workflow) => resolve(projectDir, ".factory", "commands", `opsx-${workflow}.md`) },
+	gemini: { primary: (projectDir, workflow) => resolve(projectDir, ".gemini", "commands", "opsx", `${workflow}.toml`) },
+	"github-copilot": { primary: (projectDir, workflow) => resolve(projectDir, ".github", "prompts", `opsx-${workflow}.prompt.md`) },
+	iflow: { primary: (projectDir, workflow) => resolve(projectDir, ".iflow", "commands", `opsx-${workflow}.md`) },
+	junie: { primary: (projectDir, workflow) => resolve(projectDir, ".junie", "commands", `opsx-${workflow}.md`) },
+	kilocode: { primary: (projectDir, workflow) => resolve(projectDir, ".kilocode", "workflows", `opsx-${workflow}.md`) },
+	kiro: { primary: (projectDir, workflow) => resolve(projectDir, ".kiro", "prompts", `opsx-${workflow}.prompt.md`) },
+	lingma: { primary: (projectDir, workflow) => resolve(projectDir, ".lingma", "commands", "opsx", `${workflow}.md`) },
+	opencode: {
+		primary: (projectDir, workflow) => resolve(projectDir, ".opencode", "commands", `opsx-${workflow}.md`),
+		legacy: [(projectDir, workflow) => resolve(projectDir, ".opencode", "command", `opsx-${workflow}.md`)]
+	},
+	pi: { primary: (projectDir, workflow) => resolve(projectDir, ".pi", "prompts", `opsx-${workflow}.md`) },
+	qoder: { primary: (projectDir, workflow) => resolve(projectDir, ".qoder", "commands", "opsx", `${workflow}.md`) },
+	qwen: { primary: (projectDir, workflow) => resolve(projectDir, ".qwen", "commands", `opsx-${workflow}.toml`) },
+	roocode: { primary: (projectDir, workflow) => resolve(projectDir, ".roo", "commands", `opsx-${workflow}.md`) },
+	windsurf: { primary: (projectDir, workflow) => resolve(projectDir, ".windsurf", "workflows", `opsx-${workflow}.md`) }
+};
+function resolveToolCommandArtifact(projectDir, toolId, workflow) {
+	const config = TOOL_COMMAND_PATHS[toolId];
+	if (!config) return null;
+	return {
+		workflow,
+		path: config.primary(projectDir, workflow),
+		legacyPaths: config.legacy?.map((resolvePath) => resolvePath(projectDir, workflow))
+	};
 }
 function getSkillArtifacts(projectDir, skillsDir) {
 	return ALL_TOOL_WORKFLOWS.map((workflow) => ({
@@ -3530,39 +3592,46 @@ function getSkillArtifacts(projectDir, skillsDir) {
 }
 function getCommandArtifacts(projectDir, toolId) {
 	return ALL_TOOL_WORKFLOWS.flatMap((workflow) => {
-		const path = resolveToolCommandPath(projectDir, toolId, workflow);
-		return path ? [{
-			workflow,
-			path
-		}] : [];
+		const artifact = resolveToolCommandArtifact(projectDir, toolId, workflow);
+		return artifact ? [artifact] : [];
 	});
 }
 function invalidateToolInitCaches(projectDir) {
 	const cacheRoots = /* @__PURE__ */ new Set();
 	for (const tool of AI_TOOLS) {
 		if (tool.skillsDir) cacheRoots.add(resolve(projectDir, tool.skillsDir));
-		for (const workflow of ALL_TOOL_WORKFLOWS) {
-			const commandPath = resolveToolCommandPath(projectDir, tool.value, workflow);
-			if (commandPath) cacheRoots.add(dirname$1(commandPath));
+		for (const commandArtifact of getCommandArtifacts(projectDir, tool.value)) {
+			cacheRoots.add(dirname$1(commandArtifact.path));
+			for (const legacyPath of commandArtifact.legacyPaths ?? []) cacheRoots.add(dirname$1(legacyPath));
 		}
 	}
 	for (const root of cacheRoots) clearCache(root);
 }
 async function getExistingArtifactPaths(entries) {
-	const presence = await Promise.all(entries.map(async (entry) => ({
-		path: entry.path,
-		exists: await reactiveExists(entry.path)
+	const paths = entries.flatMap((entry) => [entry.path, ...entry.legacyPaths ?? []]);
+	const presence = await Promise.all(paths.map(async (path) => ({
+		path,
+		exists: await reactiveExists(path)
 	})));
 	return new Set(presence.filter((entry) => entry.exists).map((entry) => entry.path));
 }
+function hasExistingArtifact(entry, existingPaths) {
+	return existingPaths.has(entry.path) || (entry.legacyPaths?.some((legacyPath) => existingPaths.has(legacyPath)) ?? false);
+}
+function hasLegacyArtifact(entry, existingPaths) {
+	return entry.legacyPaths?.some((legacyPath) => existingPaths.has(legacyPath)) ?? false;
+}
 function countExisting(entries, existingPaths) {
-	return entries.reduce((count, entry) => count + (existingPaths.has(entry.path) ? 1 : 0), 0);
+	return entries.reduce((count, entry) => count + (hasExistingArtifact(entry, existingPaths) ? 1 : 0), 0);
 }
 function collectMissingWorkflows(entries, existingPaths) {
-	return entries.filter((entry) => !existingPaths.has(entry.path)).map((entry) => entry.workflow);
+	return entries.filter((entry) => !hasExistingArtifact(entry, existingPaths)).map((entry) => entry.workflow);
 }
 function collectUnexpectedWorkflows(entries, desiredWorkflowSet, existingPaths) {
-	return entries.filter((entry) => !desiredWorkflowSet.has(entry.workflow) && existingPaths.has(entry.path)).map((entry) => entry.workflow);
+	return entries.filter((entry) => !desiredWorkflowSet.has(entry.workflow) && hasExistingArtifact(entry, existingPaths)).map((entry) => entry.workflow);
+}
+function collectLegacyWorkflows(entries, existingPaths) {
+	return entries.filter((entry) => hasLegacyArtifact(entry, existingPaths)).map((entry) => entry.workflow);
 }
 async function getToolInitStates(projectDir, options) {
 	invalidateToolInitCaches(projectDir);
@@ -3581,6 +3650,7 @@ async function getToolInitStates(projectDir, options) {
 		const missingCommandWorkflows = collectMissingWorkflows(expectedCommandArtifacts, existingCommandPaths);
 		const unexpectedSkillWorkflows = collectUnexpectedWorkflows(shouldGenerateSkills ? skillArtifacts : skillArtifacts, shouldGenerateSkills ? desiredWorkflowSet : /* @__PURE__ */ new Set(), existingSkillPaths);
 		const unexpectedCommandWorkflows = collectUnexpectedWorkflows(shouldGenerateCommands ? commandArtifacts : commandArtifacts, shouldGenerateCommands ? desiredWorkflowSet : /* @__PURE__ */ new Set(), existingCommandPaths);
+		const legacyCommandWorkflows = collectLegacyWorkflows(commandArtifacts, existingCommandPaths);
 		const expectedSkillCount = expectedSkillArtifacts.length;
 		const presentExpectedSkillCount = expectedSkillCount - missingSkillWorkflows.length;
 		const detectedSkillCount = countExisting(skillArtifacts, existingSkillPaths);
@@ -3603,7 +3673,8 @@ async function getToolInitStates(projectDir, options) {
 			missingSkillWorkflows,
 			missingCommandWorkflows,
 			unexpectedSkillWorkflows,
-			unexpectedCommandWorkflows
+			unexpectedCommandWorkflows,
+			legacyCommandWorkflows
 		};
 	}));
 }
@@ -3654,11 +3725,13 @@ const ApplyTaskSchema = z.object({
 	description: z.string(),
 	done: z.boolean()
 });
+const ApplyInstructionsContextFilePathsSchema = z.union([z.string(), z.array(z.string())]).transform((paths) => Array.isArray(paths) ? paths : [paths]);
+const ApplyInstructionsContextFilesSchema = z.record(ApplyInstructionsContextFilePathsSchema);
 const ApplyInstructionsSchema = z.object({
 	changeName: z.string(),
 	changeDir: z.string(),
 	schemaName: z.string(),
-	contextFiles: z.record(z.string()),
+	contextFiles: ApplyInstructionsContextFilesSchema,
 	progress: z.object({
 		total: z.number(),
 		complete: z.number(),
@@ -4514,4 +4587,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, subscribeWatcherRuntimeStatus, toOpsxDisplayPath };
+export { AI_TOOLS, ApplyInstructionsContextFilesSchema, 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, OPSX_AGENT_INVOCATION_MODE_VALUES, OpenSpecAdapter, OpenSpecUIConfigSchema, OpenSpecWatcher, OpsxAgentInvocationModeSchema, OpsxConfigSchema, 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/dist/openspec-compat.d.mts

@@ -0,0 +1,32 @@
+//#region src/openspec-compat.d.ts
+declare const OPENSPECUI_TARGET_MAJOR = 3;
+declare const OPENSPEC_CLI_TARGET_SERIES = "1.3";
+declare const OPENSPEC_CLI_LEGACY_SERIES = "1.2";
+declare const OPENSPEC_CLI_MIN_VERSION = "1.2.0";
+declare const OPENSPEC_CLI_TARGET_MIN_VERSION = "1.3.0";
+declare const OPENSPEC_CLI_NEXT_SERIES_MIN_VERSION = "1.4.0";
+declare const OPENSPEC_CLI_ACCEPTED_RANGE = ">=1.2.0 <1.4.0";
+declare const OPENSPEC_CLI_RECOMMENDED_RANGE = ">=1.3.0 <1.4.0";
+declare const OPENSPEC_CLI_LEGACY_RANGE = ">=1.2.0 <1.3.0";
+declare const OPENSPEC_CLI_REFERENCE_TAG_PATTERN = "v1.3.*";
+interface OpenSpecCliVersion {
+  major: number;
+  minor: number;
+  patch: number;
+}
+type OpenSpecCliCompatibilityStatus = 'current' | 'legacy-compatible' | 'unsupported' | 'unknown';
+interface OpenSpecCliCompatibility {
+  rawVersion: string | undefined;
+  version: OpenSpecCliVersion | null;
+  status: OpenSpecCliCompatibilityStatus;
+  supported: boolean;
+  recommended: boolean;
+  blocksCoreInteractions: boolean;
+  message: string;
+}
+declare function parseOpenSpecCliVersion(raw: string | undefined): OpenSpecCliVersion | null;
+declare function formatOpenSpecCliVersion(version: OpenSpecCliVersion): string;
+declare function compareOpenSpecCliVersions(left: OpenSpecCliVersion, right: OpenSpecCliVersion): number;
+declare function classifyOpenSpecCliVersion(rawVersion: string | undefined): OpenSpecCliCompatibility;
+//#endregion
+export { OPENSPECUI_TARGET_MAJOR, OPENSPEC_CLI_ACCEPTED_RANGE, OPENSPEC_CLI_LEGACY_RANGE, OPENSPEC_CLI_LEGACY_SERIES, OPENSPEC_CLI_MIN_VERSION, OPENSPEC_CLI_NEXT_SERIES_MIN_VERSION, OPENSPEC_CLI_RECOMMENDED_RANGE, OPENSPEC_CLI_REFERENCE_TAG_PATTERN, OPENSPEC_CLI_TARGET_MIN_VERSION, OPENSPEC_CLI_TARGET_SERIES, OpenSpecCliCompatibility, OpenSpecCliCompatibilityStatus, OpenSpecCliVersion, classifyOpenSpecCliVersion, compareOpenSpecCliVersions, formatOpenSpecCliVersion, parseOpenSpecCliVersion };

package/dist/openspec-compat.mjs

@@ -0,0 +1,75 @@
+//#region src/openspec-compat.ts
+const OPENSPECUI_TARGET_MAJOR = 3;
+const OPENSPEC_CLI_TARGET_SERIES = "1.3";
+const OPENSPEC_CLI_LEGACY_SERIES = "1.2";
+const OPENSPEC_CLI_MIN_VERSION = "1.2.0";
+const OPENSPEC_CLI_TARGET_MIN_VERSION = "1.3.0";
+const OPENSPEC_CLI_NEXT_SERIES_MIN_VERSION = "1.4.0";
+const OPENSPEC_CLI_ACCEPTED_RANGE = ">=1.2.0 <1.4.0";
+const OPENSPEC_CLI_RECOMMENDED_RANGE = ">=1.3.0 <1.4.0";
+const OPENSPEC_CLI_LEGACY_RANGE = ">=1.2.0 <1.3.0";
+const OPENSPEC_CLI_REFERENCE_TAG_PATTERN = "v1.3.*";
+function parseOpenSpecCliVersion(raw) {
+	if (!raw) return null;
+	const match = raw.match(/(\d+)\.(\d+)\.(\d+)/);
+	if (!match) return null;
+	return {
+		major: Number(match[1]),
+		minor: Number(match[2]),
+		patch: Number(match[3])
+	};
+}
+function formatOpenSpecCliVersion(version) {
+	return `${version.major}.${version.minor}.${version.patch}`;
+}
+function compareOpenSpecCliVersions(left, right) {
+	if (left.major !== right.major) return left.major - right.major;
+	if (left.minor !== right.minor) return left.minor - right.minor;
+	return left.patch - right.patch;
+}
+function isSeries(version, series) {
+	const [major, minor] = series.split(".").map((part) => Number(part));
+	return version.major === major && version.minor === minor;
+}
+function classifyOpenSpecCliVersion(rawVersion) {
+	const version = parseOpenSpecCliVersion(rawVersion);
+	if (!version) return {
+		rawVersion,
+		version: null,
+		status: "unknown",
+		supported: false,
+		recommended: false,
+		blocksCoreInteractions: true,
+		message: "Unable to parse OpenSpec CLI version."
+	};
+	if (isSeries(version, OPENSPEC_CLI_TARGET_SERIES)) return {
+		rawVersion,
+		version,
+		status: "current",
+		supported: true,
+		recommended: true,
+		blocksCoreInteractions: false,
+		message: `OpenSpec CLI ${formatOpenSpecCliVersion(version)} matches the OpenSpecUI ${OPENSPECUI_TARGET_MAJOR}.x target line.`
+	};
+	if (isSeries(version, OPENSPEC_CLI_LEGACY_SERIES)) return {
+		rawVersion,
+		version,
+		status: "legacy-compatible",
+		supported: true,
+		recommended: false,
+		blocksCoreInteractions: false,
+		message: `OpenSpec CLI ${formatOpenSpecCliVersion(version)} is legacy-compatible with OpenSpecUI ${OPENSPECUI_TARGET_MAJOR}.x. Upgrade to ${OPENSPEC_CLI_RECOMMENDED_RANGE} for the current line.`
+	};
+	return {
+		rawVersion,
+		version,
+		status: "unsupported",
+		supported: false,
+		recommended: false,
+		blocksCoreInteractions: true,
+		message: `Detected OpenSpec CLI ${formatOpenSpecCliVersion(version)}, but OpenSpecUI ${OPENSPECUI_TARGET_MAJOR}.x accepts ${OPENSPEC_CLI_ACCEPTED_RANGE}.`
+	};
+}
+
+//#endregion
+export { OPENSPECUI_TARGET_MAJOR, OPENSPEC_CLI_ACCEPTED_RANGE, OPENSPEC_CLI_LEGACY_RANGE, OPENSPEC_CLI_LEGACY_SERIES, OPENSPEC_CLI_MIN_VERSION, OPENSPEC_CLI_NEXT_SERIES_MIN_VERSION, OPENSPEC_CLI_RECOMMENDED_RANGE, OPENSPEC_CLI_REFERENCE_TAG_PATTERN, OPENSPEC_CLI_TARGET_MIN_VERSION, OPENSPEC_CLI_TARGET_SERIES, classifyOpenSpecCliVersion, compareOpenSpecCliVersions, formatOpenSpecCliVersion, parseOpenSpecCliVersion };

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

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

package/dist/opsx-display-path.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/core",
-  "version": "2.3.7",
+  "version": "3.0.1",
   "description": "Core OpenSpec adapter and parser",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -18,6 +18,10 @@
       "import": "./dist/hosted-app.mjs",
       "types": "./dist/hosted-app.d.mts"
     },
+    "./openspec-compat": {
+      "import": "./dist/openspec-compat.mjs",
+      "types": "./dist/openspec-compat.d.mts"
+    },
     "./opsx-display-path": {
       "import": "./dist/opsx-display-path.mjs",
       "types": "./dist/opsx-display-path.d.mts"
@@ -27,8 +31,8 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/hosted-app.ts --format esm --dts",
-    "dev": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/hosted-app.ts --format esm --dts --watch",
+    "build": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/hosted-app.ts src/openspec-compat.ts --format esm --dts",
+    "dev": "tsdown src/index.ts src/dashboard-display.ts src/opsx-display-path.ts src/hosted-app.ts src/openspec-compat.ts --format esm --dts --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"