@openspecui/server 4.0.2 → 5.0.0

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { a as resolveCt2ModelDownloadPlanFromRepositoryFiles } from "./src-Dh_UAz5C.mjs";
 import { t as resolveGgufModelDownloadPlanFromRepositoryFiles } from "./src-CZfiVL_-.mjs";
-import { BatchTranslateInputSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, CustomSoundHashSchema, DASHBOARD_METRIC_KEYS, DashboardConfigSchema, DocumentTranslationConfigUpdateSchema, GitConfigSchema, GlobalSettingsManager, LocalModelAssetStateSchema, LocalModelLifecycleFileStateSchema, LocalModelLifecycleGroupStateSchema, LocalModelProfileManifestSchema, MarkdownParser, NotificationPublishInputSchema, NotificationSettingsSchema, OPENSPECUI_HOOKS_VERSION, OpenSpecAdapter, OpenSpecUIGlobalSettingsUpdateSchema, OpenSpecWatcher, OpsxConfigSchema, OpsxKernel, PtyClientMessageSchema, ReactiveContext, ServiceTranslationEngineIdSchema, TRANSLATION_ENGINE_MANIFESTS, TerminalConfigSchema, TerminalControlParser, TerminalRendererEngineSchema, TranslationCacheReadInputSchema, TranslationCacheWriteInputSchema, TranslationEngineIdSchema, TranslationEngineLifecycleStatusSchema, buildBackendHealthPayload, buildLocalDownloadPlanFromRepositoryFiles, buildRuntimePackageInstallCommand, checkLocalDirectionalModelLanguagePair, clearCache, createCleanCliEnv, createTranslationEngineLifecycleStatus, detectRuntimePackageManager, getAllTools, getAvailableTools, getConfiguredTools, getDefaultCliCommandString, getDetectedProjectTools, getManagedLocalTranslationEngineManifest, getOpsxEntityRootRelativePath, getToolInitStates, getTranslationEngineLifecycleMessage, getWatcherRuntimeStatus, inferFileMime, inferFilePreviewKind, initWatcherPool, isDirectionalManagedLocalTranslationEngineId, isManagedLocalTranslationEngineId, isTranslationEngineDependencyReady, isTranslationEngineRuntimeReady, isWatcherPoolInitialized, normalizeBatchTranslationError, normalizeOpsxEntityPath, parseOpsxEntityMetadata, parseOpsxSchemaDetail, resolveRuntimePackageInstallStrategy, resolveTerminalShellDefaults, selectLocalDownloadGroup, shouldShowTranslationEngineInstallGate, sniffGlobalCli, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput } from "@openspecui/core";
+import { BatchTranslateInputSchema, CliExecutor, CodeEditorThemeSchema, ConfigManager, CustomSoundHashSchema, DASHBOARD_METRIC_KEYS, DashboardConfigSchema, DocumentTranslationConfigUpdateSchema, GitConfigSchema, GlobalSettingsManager, LocalModelAssetStateSchema, LocalModelLifecycleFileStateSchema, LocalModelLifecycleGroupStateSchema, LocalModelProfileManifestSchema, MarkdownParser, NotificationPublishInputSchema, NotificationSettingsSchema, OPENSPECUI_HOOKS_VERSION, OpenSpecAdapter, OpenSpecUIGlobalSettingsUpdateSchema, OpenSpecWatcher, OpsxConfigSchema, OpsxKernel, PtyClientMessageSchema, ReactiveContext, ServiceTranslationEngineIdSchema, StoreDoctorResultSchema, StoreListResultSchema, TRANSLATION_ENGINE_MANIFESTS, TerminalConfigSchema, TerminalControlParser, TerminalRendererEngineSchema, TranslationCacheReadInputSchema, TranslationCacheWriteInputSchema, TranslationEngineIdSchema, TranslationEngineLifecycleStatusSchema, buildBackendHealthPayload, buildLocalDownloadPlanFromRepositoryFiles, buildRuntimePackageInstallCommand, checkLocalDirectionalModelLanguagePair, classifyStoreCliOutput, clearCache, createCleanCliEnv, createTranslationEngineLifecycleStatus, detectRuntimePackageManager, getAllTools, getAvailableTools, getConfiguredTools, getDefaultCliCommandString, getDetectedProjectTools, getManagedLocalTranslationEngineManifest, getOpsxEntityRootRelativePath, getToolInitStates, getTranslationEngineLifecycleMessage, getWatcherRuntimeStatus, inferFileMime, inferFilePreviewKind, initWatcherPool, isDirectionalManagedLocalTranslationEngineId, isManagedLocalTranslationEngineId, isTranslationEngineDependencyReady, isTranslationEngineRuntimeReady, isWatcherPoolInitialized, normalizeBatchTranslationError, normalizeOpsxEntityPath, parseOpsxEntityMetadata, parseOpsxSchemaDetail, resolveRuntimePackageInstallStrategy, resolveTerminalShellDefaults, selectLocalDownloadGroup, shouldShowTranslationEngineInstallGate, sniffGlobalCli, subscribeWatcherRuntimeStatus, terminalNotificationEventToPublishInput, toStoreFeatureResult } from "@openspecui/core";
 import { basename, dirname, extname, join, matchesGlob, relative, resolve, sep } from "node:path";
 import { access, copyFile, lstat, mkdir, open, readFile, readlink, realpath, rename, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -10156,6 +10156,112 @@ const gitRouter = router({
 	})
 });
 /**
+* Stores router — read-only discovery of machine-registered OpenSpec stores (beta).
+*
+* 实现 beta 功能容错范式（spec: openspec-cli-integration › Beta Feature Fault Tolerance）：
+* 后端对 `openspec store list/doctor --json` 做宽松解析，把失败归类为两类异常，**永不抛未捕获错误**。
+*  - 异常一（数据不兼容）：exit 0 但 zod 宽松验证失败 → available=false + error.kind='data-incompatible'
+*  - 异常二（指令变更/缺失）：非零退出 → available=false + error.kind='command-unavailable'
+* 两种异常都尽力携带 cliVersion（版本信息非常重要）。前端据此决定"显示错误+版本"或"隐藏入口"。
+*/
+const STORES_LIST_CACHE_TTL_MS = 3e4;
+let cachedCliVersion = null;
+async function resolveCliVersion(ctx) {
+	const now = Date.now();
+	if (cachedCliVersion && cachedCliVersion.expiresAt > now) return cachedCliVersion.value;
+	try {
+		const availability = await ctx.cliExecutor.checkAvailability();
+		cachedCliVersion = {
+			value: availability.version,
+			expiresAt: now + STORES_LIST_CACHE_TTL_MS
+		};
+		return availability.version;
+	} catch {
+		cachedCliVersion = {
+			value: void 0,
+			expiresAt: now + STORES_LIST_CACHE_TTL_MS
+		};
+		return;
+	}
+}
+async function fetchStoresList(ctx) {
+	const cliVersion = await resolveCliVersion(ctx).catch(() => void 0);
+	try {
+		const result = await ctx.cliExecutor.listStores();
+		return toStoreFeatureResult(classifyStoreCliOutput({
+			success: result.success,
+			stdout: result.stdout,
+			stderr: result.stderr,
+			parse: (stdout) => StoreListResultSchema.parse(JSON.parse(stdout)),
+			cliVersion
+		}), {
+			fromData: (data) => {
+				const parsed = data;
+				return Array.isArray(parsed.stores) ? parsed.stores : [];
+			},
+			fallback: [],
+			cliVersion
+		});
+	} catch (error) {
+		return {
+			available: false,
+			stores: [],
+			error: {
+				kind: "command-unavailable",
+				message: error instanceof Error ? error.message : String(error),
+				...cliVersion ? { cliVersion } : {}
+			},
+			...cliVersion ? { cliVersion } : {}
+		};
+	}
+}
+async function fetchStoresDoctor(ctx, id) {
+	const cliVersion = await resolveCliVersion(ctx).catch(() => void 0);
+	try {
+		const result = await ctx.cliExecutor.doctorStores(id);
+		return toStoreFeatureResult(classifyStoreCliOutput({
+			success: result.success,
+			stdout: result.stdout,
+			stderr: result.stderr,
+			parse: (stdout) => StoreDoctorResultSchema.parse(JSON.parse(stdout)),
+			cliVersion
+		}), {
+			fromData: (data) => {
+				const parsed = data;
+				return Array.isArray(parsed.stores) ? parsed.stores : [];
+			},
+			fallback: [],
+			cliVersion
+		});
+	} catch (error) {
+		return {
+			available: false,
+			stores: [],
+			error: {
+				kind: "command-unavailable",
+				message: error instanceof Error ? error.message : String(error),
+				...cliVersion ? { cliVersion } : {}
+			},
+			...cliVersion ? { cliVersion } : {}
+		};
+	}
+}
+const storesRouter = router({
+	list: publicProcedure.query(({ ctx }) => fetchStoresList(ctx)),
+	doctor: publicProcedure.input(z.object({ id: z.string().optional() }).optional()).query(({ ctx, input }) => fetchStoresDoctor(ctx, input?.id)),
+	subscribe: publicProcedure.subscription(({ ctx }) => {
+		return observable((emit) => {
+			const push = () => {
+				fetchStoresList(ctx).then((result) => emit.next(result)).catch(() => {});
+			};
+			push();
+			const timer = setInterval(push, 5e3);
+			timer.unref();
+			return () => clearInterval(timer);
+		});
+	})
+});
+/**
 * Main app router
 */
 const appRouter = router({
@@ -10177,6 +10283,7 @@ const appRouter = router({
 	sounds: soundsRouter,
 	cli: cliRouter,
 	opsx: opsxRouter,
+	stores: storesRouter,
 	kv: kvRouter,
 	search: searchRouter,
 	system: systemRouter

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openspecui/server",
-  "version": "4.0.2",
+  "version": "5.0.0",
   "type": "module",
   "main": "dist/index.mjs",
   "exports": {
@@ -24,8 +24,8 @@
     "@hono/node-server": "^1.14.1",
     "@huggingface/hub": "^2.12.0",
     "@lydell/node-pty": "^1.1.0",
-    "@openspecui/core": "4.0.2",
-    "@openspecui/search": "4.0.2",
+    "@openspecui/core": "5.0.0",
+    "@openspecui/search": "5.0.0",
     "@trpc/server": "^11.0.0",
     "better-sqlite3": "^12.5.0",
     "hono": "^4.7.3",