openspecui 2.0.2 → 2.1.0

package/dist/cli.mjs

@@ -1,16 +1,17 @@
 #!/usr/bin/env node
-import { a as SchemaInfoSchema, c as toOpsxDisplayPath, d as DEFAULT_CONFIG, f as OpenSpecAdapter, i as SchemaDetailSchema, l as CliExecutor, m as __toESM, o as SchemaResolutionSchema, p as __commonJS, r as require_dist, s as TemplatesSchema, t as startServer, u as ConfigManager } from "./src-Cx7GJTGT.mjs";
+import { a as SchemaInfoSchema, c as toOpsxDisplayPath, d as CliExecutor, f as ConfigManager, g as __toESM, h as __commonJS, i as SchemaDetailSchema, l as buildHostedLaunchUrl, m as OpenSpecAdapter, o as SchemaResolutionSchema, p as DEFAULT_CONFIG, r as require_dist, s as TemplatesSchema, t as startServer, u as resolveHostedAppBaseUrl } from "./src-B5XQ-ERE.mjs";
 import { createRequire } from "node:module";
+import { createServer } from "node:net";
 import { basename, dirname, extname, join, normalize, relative, resolve } from "path";
 import { readFile } from "node:fs/promises";
 import { dirname as dirname$1, join as join$1, resolve as resolve$1 } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { readFileSync as readFileSync$1, readdirSync as readdirSync$1, statSync as statSync$1, writeFile as writeFile$1 } from "fs";
 import { format, inspect } from "util";
-import { fileURLToPath } from "url";
+import { fileURLToPath } from "node:url";
+import { fileURLToPath as fileURLToPath$1 } from "url";
 import { execFile, spawn } from "node:child_process";
 import { promisify as promisify$1 } from "node:util";
-import { fileURLToPath as fileURLToPath$1 } from "node:url";
 import { notStrictEqual, strictEqual } from "assert";
 
 //#region ../../node_modules/.pnpm/cliui@9.0.1/node_modules/cliui/build/lib/index.js
@@ -1606,7 +1607,7 @@ var require_get_caller_file = /* @__PURE__ */ __commonJS({ "../../node_modules/.
 //#endregion
 //#region ../../node_modules/.pnpm/yargs@18.0.0/node_modules/yargs/lib/platform-shims/esm.mjs
 var import_get_caller_file = /* @__PURE__ */ __toESM(require_get_caller_file(), 1);
-const __dirname$2 = fileURLToPath(import.meta.url);
+const __dirname$2 = fileURLToPath$1(import.meta.url);
 const mainFilename = __dirname$2.substring(0, __dirname$2.lastIndexOf("node_modules"));
 const require = createRequire(import.meta.url);
 var esm_default = {
@@ -1647,7 +1648,7 @@ var esm_default = {
 	require,
 	getCallerFile: () => {
 		const callerFile = (0, import_get_caller_file.default)(3);
-		return callerFile.match(/^file:\/\//) ? fileURLToPath(callerFile) : callerFile;
+		return callerFile.match(/^file:\/\//) ? fileURLToPath$1(callerFile) : callerFile;
 	},
 	stringWidth,
 	y18n: y18n_default({
@@ -4507,11 +4508,11 @@ var yargs_default = Yargs;
 //#endregion
 //#region package.json
 var import_dist = require_dist();
-var version = "2.0.2";
+var version = "2.1.0";
 
 //#endregion
 //#region src/export.ts
-const __dirname$1 = dirname$1(fileURLToPath$1(import.meta.url));
+const __dirname$1 = dirname$1(fileURLToPath(import.meta.url));
 const execFileAsync = promisify$1(execFile);
 function parseCliJson(raw, schema, label) {
 	const trimmed = raw.trim();
@@ -4943,7 +4944,7 @@ function findLocalWebPackage() {
 /**
 * Run a command and wait for it to complete
 */
-function runCommand(cmd, args, cwd) {
+function runCommand$1(cmd, args, cwd) {
 	return new Promise((resolvePromise, reject) => {
 		const child = spawn(cmd, args, {
 			stdio: "inherit",
@@ -5110,7 +5111,7 @@ async function exportHtml(options) {
 	if (isLocalPackageRange(webPackageRange)) {
 		if (!localWebPkg) throw new Error(`Detected local/dev @openspecui/web range "${webPackageRange}" but local web package was not found`);
 		console.log("\n[Local dev mode] Running SSG from local web package...");
-		await runCommand("pnpm", [
+		await runCommand$1("pnpm", [
 			"tsx",
 			join$1(localWebPkg, "src", "ssg", "cli.ts"),
 			"--data",
@@ -5125,7 +5126,7 @@ async function exportHtml(options) {
 		const pm = detectPackageManager();
 		const execCmd = getExecCommand(pm, `@openspecui/web@${webPackageRange || version}`);
 		try {
-			await runCommand(execCmd.cmd, [
+			await runCommand$1(execCmd.cmd, [
 				...execCmd.args,
 				"--data",
 				dataJsonPath,
@@ -5152,7 +5153,7 @@ async function exportHtml(options) {
 		if (previewHost) viteArgs.push("--host", previewHost);
 		viteArgs.push("--open");
 		const { cmd, args } = getRunCommand(detectPackageManager(), "vite");
-		await runCommand(cmd, [...args, ...viteArgs], outputDir);
+		await runCommand$1(cmd, [...args, ...viteArgs], outputDir);
 	}
 }
 /**
@@ -5166,12 +5167,210 @@ async function exportStaticSite(options) {
 	else await exportHtml(options);
 }
 
+//#endregion
+//#region src/hosted-app.ts
+function buildHostedAppLaunchUrl(options) {
+	return buildHostedLaunchUrl({
+		baseUrl: options.baseUrl,
+		apiBaseUrl: options.apiBaseUrl
+	});
+}
+function resolveEffectiveHostedAppBaseUrl(options) {
+	return resolveHostedAppBaseUrl(options);
+}
+
+//#endregion
+//#region src/local-hosted-app-dev.ts
+const LOCAL_HOSTED_APP_DEV_DEFAULT_PORT = 13005;
+function resolveLocalHostedAppWorkspace(cliDir) {
+	const repoRoot = resolve$1(cliDir, "..", "..", "..");
+	const rootPackageJson = join$1(repoRoot, "package.json");
+	const appPackageJson = join$1(repoRoot, "packages", "app", "package.json");
+	if (!existsSync(rootPackageJson) || !existsSync(appPackageJson)) return null;
+	return {
+		repoRoot,
+		appDir: join$1(repoRoot, "packages", "app"),
+		webDistDir: join$1(repoRoot, "packages", "web", "dist")
+	};
+}
+function shouldUseLocalHostedAppDevMode(options) {
+	return options.appValue === "" && options.workspace !== null;
+}
+function createHostedAppWebBuildCommand(workspace) {
+	return {
+		command: resolvePnpmCommand(),
+		args: [
+			"--filter",
+			"@openspecui/web",
+			"build"
+		],
+		cwd: workspace.repoRoot,
+		env: { ...process.env }
+	};
+}
+function createLocalHostedAppDevCommand(options) {
+	return {
+		command: resolvePnpmCommand(),
+		args: [
+			"--filter",
+			"@openspecui/app",
+			"exec",
+			"vite",
+			"--host",
+			"127.0.0.1",
+			"--port",
+			String(options.port),
+			"--strictPort"
+		],
+		cwd: options.workspace.repoRoot,
+		env: {
+			...process.env,
+			OPENSPECUI_APP_DEV_MODE: "1",
+			OPENSPECUI_APP_DEV_WEB_DIST: options.workspace.webDistDir,
+			OPENSPECUI_APP_DEV_VERSION: options.resolvedVersion
+		}
+	};
+}
+async function startLocalHostedAppDev(options) {
+	await ensureLocalHostedAppWebDist(options.workspace);
+	const port = await findAvailablePort(options.preferredPort ?? LOCAL_HOSTED_APP_DEV_DEFAULT_PORT);
+	const command$1 = createLocalHostedAppDevCommand({
+		workspace: options.workspace,
+		port,
+		resolvedVersion: options.resolvedVersion
+	});
+	const child = spawn(command$1.command, command$1.args, {
+		cwd: command$1.cwd,
+		env: command$1.env,
+		stdio: "inherit",
+		detached: process.platform !== "win32"
+	});
+	const baseUrl = `http://127.0.0.1:${port}`;
+	try {
+		await waitForHostedAppDevReady({
+			baseUrl,
+			child,
+			timeoutMs: options.readinessTimeoutMs ?? 15e3
+		});
+	} catch (error) {
+		await stopChildProcess(child);
+		throw error;
+	}
+	return {
+		baseUrl,
+		close: () => stopChildProcess(child)
+	};
+}
+async function ensureLocalHostedAppWebDist(workspace) {
+	const command$1 = createHostedAppWebBuildCommand(workspace);
+	console.log("🛠️  Building packages/web for local hosted app dev...");
+	await runCommand(command$1);
+}
+function resolvePnpmCommand() {
+	return process.platform === "win32" ? "pnpm.cmd" : "pnpm";
+}
+async function runCommand(command$1) {
+	await new Promise((resolvePromise, rejectPromise) => {
+		const child = spawn(command$1.command, command$1.args, {
+			cwd: command$1.cwd,
+			env: command$1.env,
+			stdio: "inherit"
+		});
+		child.once("error", (error) => {
+			rejectPromise(error);
+		});
+		child.once("exit", (code, signal) => {
+			if (code === 0) {
+				resolvePromise();
+				return;
+			}
+			rejectPromise(/* @__PURE__ */ new Error(`Command failed: ${command$1.command} ${command$1.args.join(" ")} (${signal ? `signal ${signal}` : `exit ${code ?? "unknown"}`})`));
+		});
+	});
+}
+async function waitForHostedAppDevReady(options) {
+	let exitMessage = null;
+	let startupError = null;
+	options.child.once("error", (error) => {
+		startupError = error;
+	});
+	options.child.once("exit", (code, signal) => {
+		exitMessage = signal ? `signal ${signal}` : `exit ${code ?? "unknown"}`;
+	});
+	const deadline = Date.now() + options.timeoutMs;
+	while (Date.now() < deadline) {
+		if (startupError) throw startupError;
+		if (exitMessage) throw new Error(`Local hosted app dev server exited before becoming ready (${exitMessage})`);
+		try {
+			if ((await fetch(`${options.baseUrl}/version.json`, {
+				headers: { accept: "application/json" },
+				cache: "no-store"
+			})).ok) return;
+		} catch {}
+		await delay(250);
+	}
+	throw new Error(`Timed out waiting for local hosted app dev server at ${options.baseUrl}`);
+}
+async function stopChildProcess(child) {
+	if (child.exitCode !== null || child.signalCode !== null) return;
+	killChildProcess(child, "SIGTERM");
+	if (await waitForChildExit(child, 5e3)) return;
+	killChildProcess(child, "SIGKILL");
+	await waitForChildExit(child, 1e3);
+}
+function killChildProcess(child, signal) {
+	if (process.platform !== "win32" && child.pid) try {
+		process.kill(-child.pid, signal);
+		return;
+	} catch {}
+	child.kill(signal);
+}
+function waitForChildExit(child, timeoutMs) {
+	return new Promise((resolvePromise) => {
+		const timer = setTimeout(() => {
+			cleanup();
+			resolvePromise(false);
+		}, timeoutMs);
+		const onExit = () => {
+			cleanup();
+			resolvePromise(true);
+		};
+		const cleanup = () => {
+			clearTimeout(timer);
+			child.off("exit", onExit);
+		};
+		child.once("exit", onExit);
+	});
+}
+function delay(ms) {
+	return new Promise((resolve$2) => {
+		setTimeout(resolve$2, ms);
+	});
+}
+async function isPortAvailable(port) {
+	return await new Promise((resolve$2) => {
+		const server = createServer();
+		server.once("error", () => {
+			resolve$2(false);
+		});
+		server.once("listening", () => {
+			server.close(() => resolve$2(true));
+		});
+		server.listen(port, "127.0.0.1");
+	});
+}
+async function findAvailablePort(startPort, maxAttempts = 10) {
+	for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+		const port = startPort + attempt;
+		if (await isPortAvailable(port)) return port;
+	}
+	throw new Error(`No available port found in range ${startPort}-${startPort + maxAttempts - 1}`);
+}
+
 //#endregion
 //#region src/cli.ts
-const __dirname = dirname$1(fileURLToPath$1(import.meta.url));
-/**
-* Read version from package.json
-*/
+const __dirname = dirname$1(fileURLToPath(import.meta.url));
+const DEFAULT_HOSTED_CORS_ORIGINS = ["http://localhost:5173", "http://localhost:3000"];
 function getVersion() {
 	try {
 		const pkgPath = join$1(__dirname, "..", "package.json");
@@ -5180,6 +5379,11 @@ function getVersion() {
 		return "0.0.0";
 	}
 }
+function buildHostedCorsOrigins(baseUrl) {
+	const origins = new Set(DEFAULT_HOSTED_CORS_ORIGINS);
+	origins.add(new URL(baseUrl).origin);
+	return [...origins];
+}
 async function main() {
 	const originalCwd = process.env.INIT_CWD || process.cwd();
 	await yargs_default(hideBin(process.argv)).scriptName("openspecui").command(["$0 [project-dir]", "start [project-dir]"], "Start the OpenSpec UI server", (yargs) => {
@@ -5199,9 +5403,13 @@ async function main() {
 			describe: "Automatically open the browser",
 			type: "boolean",
 			default: true
+		}).option("app", {
+			describe: "Open the hosted app at the official or custom base URL. Supports --app and --app=<baseUrl>.",
+			type: "string"
 		});
 	}, async (argv) => {
 		const projectDir = resolve$1(originalCwd, argv["project-dir"] || argv.dir || ".");
+		const useHostedApp = argv.app !== void 0;
 		console.log(`
 ┌─────────────────────────────────────────────┐
 │           OpenSpec UI                       │
@@ -5210,31 +5418,69 @@ async function main() {
 `);
 		console.log(`📁 Project: ${projectDir}`);
 		console.log("");
+		let server = null;
+		let localHostedApp = null;
 		try {
-			const server = await startServer({
+			const localVersion = getVersion();
+			let hostedBaseUrl = null;
+			if (useHostedApp) {
+				const workspace = resolveLocalHostedAppWorkspace(__dirname);
+				const localHostedAppMode = {
+					appValue: argv.app,
+					workspace
+				};
+				if (shouldUseLocalHostedAppDevMode(localHostedAppMode)) {
+					localHostedApp = await startLocalHostedAppDev({
+						workspace: localHostedAppMode.workspace,
+						resolvedVersion: localVersion
+					});
+					hostedBaseUrl = localHostedApp.baseUrl;
+				} else {
+					const config = await new ConfigManager(projectDir).readConfig();
+					hostedBaseUrl = resolveEffectiveHostedAppBaseUrl({
+						override: argv.app,
+						configured: config.appBaseUrl
+					});
+				}
+			}
+			server = await startServer({
 				projectDir,
 				port: argv.port,
-				open: argv.open
+				open: false,
+				corsOrigins: hostedBaseUrl ? buildHostedCorsOrigins(hostedBaseUrl) : void 0
 			});
 			if (server.port !== server.preferredPort) console.log(`⚠️  Port ${server.preferredPort} is in use, using ${server.port} instead`);
 			console.log(`✅ Server running at ${server.url}`);
+			let browserUrl = server.url;
+			if (useHostedApp && hostedBaseUrl) {
+				browserUrl = buildHostedAppLaunchUrl({
+					baseUrl: hostedBaseUrl,
+					apiBaseUrl: server.url
+				});
+				console.log(`🌐 Hosted app base: ${hostedBaseUrl}`);
+				console.log(`🔗 Hosted URL: ${browserUrl}`);
+			}
 			console.log("");
 			if (argv.open) {
-				await (await import("./open-DDagk2eo.mjs")).default(server.url);
-				console.log("🌐 Browser opened");
+				await (await import("./open-DfwCb8mL.mjs")).default(browserUrl);
+				console.log(useHostedApp ? "🌐 Hosted app opened" : "🌐 Browser opened");
 			}
 			console.log("");
 			console.log("Press Ctrl+C to stop the server");
 			process.on("SIGINT", async () => {
 				console.log("\n\n👋 Shutting down...");
-				await server.close();
+				await localHostedApp?.close();
+				await server?.close();
 				process.exit(0);
 			});
 			process.on("SIGTERM", async () => {
-				await server.close();
+				await localHostedApp?.close();
+				await server?.close();
 				process.exit(0);
 			});
 		} catch (error) {
+			await localHostedApp?.close();
+			await server?.close();
 			console.error("❌ Failed to start server:", error);
 			process.exit(1);
 		}
@@ -5297,9 +5543,12 @@ async function main() {
 			console.error("❌ Export failed:", error);
 			process.exit(1);
 		}
-	}).example("$0", "Start server in current directory").example("$0 ./my-project", "Start server with specific project").example("$0 -p 8080", "Start server on custom port").example("$0 export -o ./dist", "Export HTML to ./dist directory").example("$0 export -o ./dist -f json", "Export JSON data only").example("$0 export -o ./dist -p 8092", "Export and open preview on port 8092").example("$0 export -o ./dist --base-path=/docs/", "Export for subdirectory deployment").example("$0 export -o ./dist --clean", "Clean output directory before export").version(getVersion()).alias("v", "version").help().alias("h", "help").parse();
+	}).help().alias("help", "h").version(getVersion()).alias("version", "v").strict().parseAsync();
 }
-main();
+main().catch((error) => {
+	console.error("Fatal error:", error);
+	process.exit(1);
+});
 
 //#endregion
 export {  };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { n as createServer, t as startServer } from "./src-Cx7GJTGT.mjs";
+import { n as createServer, t as startServer } from "./src-B5XQ-ERE.mjs";
 
 export { createServer, startServer };

package/dist/{open-DDagk2eo.mjs → open-DfwCb8mL.mjs}

@@ -1,9 +1,9 @@
 import fs, { constants } from "node:fs/promises";
 import path from "node:path";
 import fs$1 from "node:fs";
+import { fileURLToPath } from "node:url";
 import childProcess, { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { fileURLToPath } from "node:url";
 import process from "node:process";
 import { Buffer } from "node:buffer";
 import os from "node:os";

package/dist/{src-Cx7GJTGT.mjs → src-B5XQ-ERE.mjs}

@@ -8,18 +8,18 @@ import { mkdir, readFile, rename, writeFile } from "fs/promises";
 import { dirname, join } from "path";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { mkdir as mkdir$1, readFile as readFile$1, readdir, rm, stat, writeFile as writeFile$1 } from "node:fs/promises";
-import { dirname as dirname$1, join as join$1, matchesGlob, relative as relative$1, resolve as resolve$1, sep } from "node:path";
+import { basename as basename$1, dirname as dirname$1, join as join$1, matchesGlob, relative as relative$1, resolve as resolve$1, sep } from "node:path";
 import { existsSync, lstatSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { EventEmitter } from "events";
 import { watch } from "fs";
 import { exec, spawn } from "child_process";
 import { promisify } from "util";
+import { fileURLToPath } from "node:url";
 import * as pty from "@lydell/node-pty";
 import { execFile } from "node:child_process";
 import { EventEmitter as EventEmitter$1 } from "node:events";
 import { promisify as promisify$1 } from "node:util";
 import { Worker as Worker$1 } from "node:worker_threads";
-import { fileURLToPath } from "node:url";
 
 //#region rolldown:runtime
 var __create$1 = Object.create;
@@ -6308,6 +6308,7 @@ const OpenSpecUIConfigSchema = objectType({
 	}).default({}),
 	theme: enumType(THEME_VALUES).default("system"),
 	codeEditor: CodeEditorConfigSchema.default(CodeEditorConfigSchema.parse({})),
+	appBaseUrl: stringType().default(""),
 	terminal: TerminalConfigSchema.default(TerminalConfigSchema.parse({})),
 	dashboard: DashboardConfigSchema.default(DashboardConfigSchema.parse({}))
 });
@@ -6316,6 +6317,7 @@ const DEFAULT_CONFIG = {
 	cli: {},
 	theme: "system",
 	codeEditor: CodeEditorConfigSchema.parse({}),
+	appBaseUrl: "",
 	terminal: TerminalConfigSchema.parse({}),
 	dashboard: DashboardConfigSchema.parse({})
 };
@@ -6384,6 +6386,7 @@ var ConfigManager = class {
 				...current.codeEditor,
 				...config.codeEditor
 			},
+			appBaseUrl: config.appBaseUrl ?? current.appBaseUrl,
 			terminal: {
 				...current.terminal,
 				...config.terminal
@@ -7134,6 +7137,37 @@ const DASHBOARD_METRIC_KEYS = [
 	"taskCompletionPercent"
 ];
 
+//#endregion
+//#region ../core/src/hosted-app.ts
+const OFFICIAL_APP_BASE_URL = "https://app.openspecui.com";
+function withHttpsProtocol(value) {
+	if (/^[a-zA-Z][a-zA-Z\d+.-]*:\/\//.test(value)) return value;
+	return `https://${value}`;
+}
+function normalizeHostedAppBaseUrl(input) {
+	const trimmed = input.trim();
+	if (!trimmed) throw new Error("Hosted app base URL must not be empty");
+	let parsed;
+	try {
+		parsed = new URL(withHttpsProtocol(trimmed));
+	} catch (error) {
+		throw new Error(`Invalid hosted app base URL: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	parsed.hash = "";
+	parsed.search = "";
+	const pathname = parsed.pathname.replace(/\/+$/, "");
+	parsed.pathname = pathname.length > 0 ? pathname : "/";
+	return parsed.toString().replace(/\/$/, parsed.pathname === "/" ? "" : "");
+}
+function resolveHostedAppBaseUrl(options) {
+	return normalizeHostedAppBaseUrl(options.override?.trim() || options.configured?.trim() || OFFICIAL_APP_BASE_URL);
+}
+function buildHostedLaunchUrl(options) {
+	const url = new URL(normalizeHostedAppBaseUrl(options.baseUrl));
+	url.searchParams.set("api", options.apiBaseUrl);
+	return url.toString();
+}
+
 //#endregion
 //#region ../core/src/opsx-display-path.ts
 const VIRTUAL_PROJECT_DIRNAME = "project";
@@ -24287,35 +24321,12 @@ async function fetchDashboardOverview(ctx, reason = "dashboard-refresh") {
 		ctx.adapter.listChangesWithMeta(),
 		ctx.adapter.listArchivedChangesWithMeta()
 	]);
-	await ctx.kernel.waitForWarmup();
-	await ctx.kernel.ensureStatusList();
-	const statusList = ctx.kernel.getStatusList();
-	const changeMetaMap = new Map(changeMetas.map((change) => [change.id, change]));
-	const activeChangeIds = new Set([...changeMetas.map((change) => change.id), ...statusList.map((status) => status.changeName)]);
-	const statusByChange = new Map(statusList.map((status) => [status.changeName, status]));
-	const activeChanges = (await Promise.all([...activeChangeIds].map(async (changeId) => {
-		const status = statusByChange.get(changeId);
-		const changeMeta = changeMetaMap.get(changeId);
-		const statInfo = await reactiveStat(join$1(ctx.projectDir, "openspec", "changes", changeId));
-		let progress = changeMeta?.progress ?? {
-			total: 0,
-			completed: 0
-		};
-		if (status) try {
-			await ctx.kernel.ensureApplyInstructions(changeId, status.schemaName);
-			const apply = ctx.kernel.getApplyInstructions(changeId, status.schemaName);
-			progress = {
-				total: apply.progress.total,
-				completed: apply.progress.complete
-			};
-		} catch {}
-		return {
-			id: changeId,
-			name: changeMeta?.name ?? changeId,
-			progress,
-			updatedAt: changeMeta?.updatedAt ?? statInfo?.mtime ?? 0
-		};
-	}))).sort((a, b) => b.updatedAt - a.updatedAt);
+	const activeChanges = changeMetas.map((changeMeta) => ({
+		id: changeMeta.id,
+		name: changeMeta.name ?? changeMeta.id,
+		progress: changeMeta.progress,
+		updatedAt: changeMeta.updatedAt
+	})).sort((a, b) => b.updatedAt - a.updatedAt);
 	const archivedChanges = (await Promise.all(archiveMetas.map(async (meta) => {
 		const change = await ctx.adapter.readArchivedChange(meta.id);
 		if (!change) return null;
@@ -24667,6 +24678,7 @@ const configRouter = router({
 			"system"
 		]).optional(),
 		codeEditor: objectType({ theme: CodeEditorThemeSchema.optional() }).optional(),
+		appBaseUrl: stringType().optional(),
 		terminal: TerminalConfigSchema.omit({ rendererEngine: true }).partial().extend({ rendererEngine: TerminalRendererEngineSchema.optional() }).optional(),
 		dashboard: DashboardConfigSchema.partial().optional()
 	})).mutation(async ({ ctx, input }) => {
@@ -24674,9 +24686,10 @@ const configRouter = router({
 		const hasCliArgs = input.cli !== void 0 && Object.prototype.hasOwnProperty.call(input.cli, "args");
 		if (hasCliCommand && !hasCliArgs) {
 			await ctx.configManager.setCliCommand(input.cli?.command ?? "");
-			if (input.theme !== void 0 || input.codeEditor !== void 0 || input.terminal !== void 0 || input.dashboard !== void 0) await ctx.configManager.writeConfig({
+			if (input.theme !== void 0 || input.codeEditor !== void 0 || input.appBaseUrl !== void 0 || input.terminal !== void 0 || input.dashboard !== void 0) await ctx.configManager.writeConfig({
 				theme: input.theme,
 				codeEditor: input.codeEditor,
+				appBaseUrl: input.appBaseUrl,
 				terminal: input.terminal,
 				dashboard: input.dashboard
 			});
@@ -25438,6 +25451,17 @@ var SearchService = class {
 *
 * @module server
 */
+const __dirname$1 = dirname$1(fileURLToPath(import.meta.url));
+function getServerPackageVersion() {
+	try {
+		const packageJsonPath = join$1(__dirname$1, "..", "package.json");
+		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+		return typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
+	} catch {
+		return "0.0.0";
+	}
+}
+const SERVER_PACKAGE_VERSION = getServerPackageVersion();
 /**
 * Create an OpenSpecUI HTTP server with optional WebSocket support
 */
@@ -25458,7 +25482,9 @@ function createServer$2(config) {
 		return c.json({
 			status: "ok",
 			projectDir: config.projectDir,
-			watcherEnabled: !!watcher
+			projectName: basename$1(config.projectDir) || config.projectDir,
+			watcherEnabled: !!watcher,
+			openspecuiVersion: SERVER_PACKAGE_VERSION
 		});
 	});
 	app.use("/trpc/*", async (c) => {
@@ -25590,9 +25616,6 @@ async function startServer(config, setupApp) {
 //#endregion
 //#region src/index.ts
 const __dirname = dirname$1(fileURLToPath(import.meta.url));
-/**
-* Get the path to the web assets directory
-*/
 function getWebAssetsDir() {
 	const devPath = join$1(__dirname, "..", "..", "web", "dist");
 	const prodPath = join$1(__dirname, "..", "web");
@@ -25600,9 +25623,6 @@ function getWebAssetsDir() {
 	if (existsSync(devPath)) return devPath;
 	throw new Error("Web assets not found. Make sure to build the web package first.");
 }
-/**
-* Setup static file serving middleware for the Hono app
-*/
 function setupStaticFiles(app) {
 	const webDir = getWebAssetsDir();
 	const mimeTypes = {
@@ -25639,18 +25659,15 @@ function setupStaticFiles(app) {
 		return c.notFound();
 	});
 }
-/**
-* Start the OpenSpec UI server with WebSocket support for realtime updates.
-* Includes static file serving for the web UI.
-*/
 async function startServer$1(options = {}) {
-	const { projectDir = process.cwd(), port = 3100, enableWatcher = true } = options;
+	const { projectDir = process.cwd(), port = 3100, enableWatcher = true, corsOrigins } = options;
 	return await startServer({
 		projectDir,
 		port,
-		enableWatcher
+		enableWatcher,
+		corsOrigins
 	}, setupStaticFiles);
 }
 
 //#endregion
-export { SchemaInfoSchema as a, toOpsxDisplayPath as c, DEFAULT_CONFIG as d, OpenSpecAdapter as f, SchemaDetailSchema as i, CliExecutor as l, __toESM$1 as m, createServer$2 as n, SchemaResolutionSchema as o, __commonJS$1 as p, require_dist as r, TemplatesSchema as s, startServer$1 as t, ConfigManager as u };
+export { SchemaInfoSchema as a, toOpsxDisplayPath as c, CliExecutor as d, ConfigManager as f, __toESM$1 as g, __commonJS$1 as h, SchemaDetailSchema as i, buildHostedLaunchUrl as l, OpenSpecAdapter as m, createServer$2 as n, SchemaResolutionSchema as o, DEFAULT_CONFIG as p, require_dist as r, TemplatesSchema as s, startServer$1 as t, resolveHostedAppBaseUrl as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openspecui",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "OpenSpec UI - Visual interface for spec-driven development",
   "type": "module",
   "main": "dist/index.mjs",
@@ -19,7 +19,8 @@
   "dependencies": {
     "@lydell/node-pty": "^1.1.0",
     "@parcel/watcher": "^2.5.1",
-    "yaml": "^2.8.0"
+    "yaml": "^2.8.0",
+    "semver": "^7.7.3"
   },
   "devDependencies": {
     "@hono/node-server": "^1.14.1",
@@ -33,8 +34,9 @@
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
     "yargs": "^18.0.0",
-    "@openspecui/web": "2.0.1",
-    "@openspecui/server": "2.0.2"
+    "@types/semver": "^7.7.1",
+    "@openspecui/server": "2.1.0",
+    "@openspecui/web": "2.1.0"
   },
   "scripts": {
     "build": "pnpm run build:web && pnpm run build:copy-web && tsdown",