openspecui 0.7.7 → 0.8.0

package/dist/cli.mjs

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
-import { a as __commonJS, o as __toESM, t as startServer } from "./src-BTqFItR8.mjs";
+import { o as __commonJS, r as OpenSpecAdapter, s as __toESM, t as startServer } from "./src-BtPH0zlP.mjs";
 import { createRequire } from "node:module";
 import { fileURLToPath } from "url";
 import { basename, dirname, extname, join, normalize, relative, resolve } from "path";
 import { dirname as dirname$1, join as join$1, resolve as resolve$1 } from "node:path";
-import { readFileSync, readdirSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { readFileSync as readFileSync$1, readdirSync as readdirSync$1, statSync as statSync$1, writeFile } from "fs";
 import { format, inspect } from "util";
 import { fileURLToPath as fileURLToPath$1 } from "node:url";
 import { notStrictEqual, strictEqual } from "assert";
+import { spawn } from "node:child_process";
 
 //#region ../../node_modules/.pnpm/cliui@9.0.1/node_modules/cliui/build/lib/index.js
 const align = {
@@ -1603,8 +1604,8 @@ 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$1 = fileURLToPath(import.meta.url);
-const mainFilename = __dirname$1.substring(0, __dirname$1.lastIndexOf("node_modules"));
+const __dirname$2 = fileURLToPath(import.meta.url);
+const mainFilename = __dirname$2.substring(0, __dirname$2.lastIndexOf("node_modules"));
 const require = createRequire(import.meta.url);
 var esm_default = {
 	assert: {
@@ -1648,7 +1649,7 @@ var esm_default = {
 	},
 	stringWidth,
 	y18n: y18n_default({
-		directory: resolve(__dirname$1, "../../../locales"),
+		directory: resolve(__dirname$2, "../../../locales"),
 		updateFiles: false
 	})
 };
@@ -4501,6 +4502,210 @@ function isYargsInstance(y) {
 const Yargs = YargsFactory(esm_default);
 var yargs_default = Yargs;
 
+//#endregion
+//#region src/export.ts
+const __dirname$1 = dirname$1(fileURLToPath$1(import.meta.url));
+const WEB_PACKAGE_VERSION = "0.8.0";
+/**
+* Generate a complete data snapshot of the OpenSpec project
+* (Kept for backwards compatibility and testing)
+*/
+async function generateSnapshot(projectDir) {
+	const adapter = new OpenSpecAdapter(projectDir);
+	if (!await adapter.isInitialized()) throw new Error(`OpenSpec not initialized in ${projectDir}`);
+	const specsMeta = await adapter.listSpecsWithMeta();
+	const specs = await Promise.all(specsMeta.map(async (meta) => {
+		const raw = await adapter.readSpecRaw(meta.id);
+		const parsed = await adapter.readSpec(meta.id);
+		return {
+			id: meta.id,
+			name: meta.name,
+			content: raw || "",
+			overview: parsed?.overview || "",
+			requirements: parsed?.requirements || [],
+			createdAt: meta.createdAt,
+			updatedAt: meta.updatedAt
+		};
+	}));
+	const changesMeta = await adapter.listChangesWithMeta();
+	const changes = await Promise.all(changesMeta.map(async (meta) => {
+		const change = await adapter.readChange(meta.id);
+		if (!change) return null;
+		const files = await adapter.readChangeFiles(meta.id);
+		const proposalFile = files.find((f) => f.path === "proposal.md");
+		const tasksFile = files.find((f) => f.path === "tasks.md");
+		const designFile = files.find((f) => f.path === "design.md");
+		const deltas = (change.deltaSpecs || []).map((ds) => ({
+			capability: ds.specId,
+			content: ds.content || ""
+		}));
+		return {
+			id: meta.id,
+			name: meta.name,
+			proposal: proposalFile?.content || "",
+			tasks: tasksFile?.content,
+			design: designFile?.content,
+			why: change.why || "",
+			whatChanges: change.whatChanges || "",
+			parsedTasks: change.tasks || [],
+			deltas,
+			progress: meta.progress,
+			createdAt: meta.createdAt,
+			updatedAt: meta.updatedAt
+		};
+	}));
+	const archivesMeta = await adapter.listArchivedChangesWithMeta();
+	const archives = await Promise.all(archivesMeta.map(async (meta) => {
+		const files = await adapter.readArchivedChangeFiles(meta.id);
+		const proposalFile = files.find((f) => f.path === "proposal.md");
+		const tasksFile = files.find((f) => f.path === "tasks.md");
+		const designFile = files.find((f) => f.path === "design.md");
+		const change = await adapter.readArchivedChange(meta.id);
+		return {
+			id: meta.id,
+			name: meta.name || meta.id,
+			proposal: proposalFile?.content || "",
+			tasks: tasksFile?.content,
+			design: designFile?.content,
+			why: change?.why || "",
+			whatChanges: change?.whatChanges || "",
+			parsedTasks: change?.tasks || [],
+			createdAt: meta.createdAt,
+			updatedAt: meta.updatedAt
+		};
+	}));
+	let projectMd;
+	let agentsMd;
+	try {
+		projectMd = await adapter.readProjectMd() ?? void 0;
+	} catch {}
+	try {
+		agentsMd = await adapter.readAgentsMd() ?? void 0;
+	} catch {}
+	return {
+		meta: {
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			version: WEB_PACKAGE_VERSION,
+			projectDir
+		},
+		dashboard: {
+			specsCount: specs.length,
+			changesCount: changes.filter((c) => c !== null).length,
+			archivesCount: archives.length
+		},
+		specs,
+		changes: changes.filter((c) => c !== null),
+		archives,
+		projectMd,
+		agentsMd
+	};
+}
+/**
+* Detect the package manager being used
+*/
+function detectPackageManager() {
+	const userAgent = process.env.npm_config_user_agent || "";
+	if (userAgent.includes("pnpm")) return "pnpm";
+	if (userAgent.includes("yarn")) return "yarn";
+	if (userAgent.includes("bun")) return "bun";
+	return "npm";
+}
+/**
+* Get the command to execute a package binary
+*/
+function getExecCommand(pm) {
+	const packageSpec = WEB_PACKAGE_VERSION.startsWith("__") ? "@openspecui/web" : `@openspecui/web@${WEB_PACKAGE_VERSION}`;
+	switch (pm) {
+		case "pnpm": return {
+			cmd: "pnpm",
+			args: ["dlx", packageSpec]
+		};
+		case "yarn": return {
+			cmd: "yarn",
+			args: ["dlx", packageSpec]
+		};
+		case "bun": return {
+			cmd: "bunx",
+			args: [packageSpec]
+		};
+		case "npm":
+		default: return {
+			cmd: "npx",
+			args: [packageSpec]
+		};
+	}
+}
+/**
+* Check if running in local monorepo development mode
+* Returns the path to local SSG CLI if available, null otherwise
+*/
+function findLocalSSGCli() {
+	const localSsgTs = join$1(__dirname$1, "..", "..", "web", "src", "ssg", "cli.ts");
+	if (existsSync(localSsgTs)) return localSsgTs;
+	return null;
+}
+/**
+* Export the OpenSpec UI as a static website with SSG (pre-rendered HTML)
+*
+* This function:
+* 1. Generates a data snapshot from the openspec/ directory
+* 2. Writes data.json to the output directory
+* 3. Delegates to @openspecui/web's SSG CLI for rendering
+*
+* In development (monorepo), it uses the local web package.
+* In production, it uses npx/pnpm dlx to fetch the published package.
+*/
+async function exportStaticSite(options) {
+	const { projectDir, outputDir, basePath, clean, open, previewPort, previewHost } = options;
+	if (clean && existsSync(outputDir)) rmSync(outputDir, { recursive: true });
+	mkdirSync(outputDir, { recursive: true });
+	console.log("Generating data snapshot...");
+	const snapshot = await generateSnapshot(projectDir);
+	const dataJsonPath = join$1(outputDir, "data.json");
+	writeFileSync(dataJsonPath, JSON.stringify(snapshot, null, 2));
+	console.log(`Data snapshot written to ${dataJsonPath}`);
+	const ssgOnlyArgs = [
+		"--data",
+		dataJsonPath,
+		"--output",
+		outputDir
+	];
+	if (basePath !== void 0) ssgOnlyArgs.push("--base-path", basePath);
+	if (open) {
+		ssgOnlyArgs.push("--open");
+		if (previewPort !== void 0) ssgOnlyArgs.push("--preview-port", String(previewPort));
+		if (previewHost !== void 0) ssgOnlyArgs.push("--host", previewHost);
+	}
+	const localCli = findLocalSSGCli();
+	let cmd;
+	let args;
+	if (localCli) {
+		cmd = "npx";
+		args = [
+			"tsx",
+			localCli,
+			...ssgOnlyArgs
+		];
+	} else {
+		const execCmd = getExecCommand(detectPackageManager());
+		cmd = execCmd.cmd;
+		args = [...execCmd.args, ...ssgOnlyArgs];
+	}
+	return new Promise((resolvePromise, reject) => {
+		const child = spawn(cmd, args, {
+			stdio: "inherit",
+			cwd: projectDir
+		});
+		child.on("close", (code) => {
+			if (code === 0) resolvePromise();
+			else reject(/* @__PURE__ */ new Error(`SSG export failed with exit code ${code}`));
+		});
+		child.on("error", (err) => {
+			reject(/* @__PURE__ */ new Error(`Failed to start SSG CLI: ${err.message}`));
+		});
+	});
+}
+
 //#endregion
 //#region src/cli.ts
 const __dirname = dirname$1(fileURLToPath$1(import.meta.url));
@@ -4517,62 +4722,109 @@ function getVersion() {
 }
 async function main() {
 	const originalCwd = process.env.INIT_CWD || process.cwd();
-	const argv = await yargs_default(hideBin(process.argv)).scriptName("openspecui").usage("$0 [project-dir]", "Visual interface for spec-driven development", (yargs) => {
+	await yargs_default(hideBin(process.argv)).scriptName("openspecui").command(["$0 [project-dir]", "start [project-dir]"], "Start the OpenSpec UI server", (yargs) => {
 		return yargs.positional("project-dir", {
 			describe: "Project directory containing openspec/",
 			type: "string"
+		}).option("port", {
+			alias: "p",
+			describe: "Port to run the server on",
+			type: "number",
+			default: 3100
+		}).option("dir", {
+			alias: "d",
+			describe: "Project directory containing openspec/",
+			type: "string"
+		}).option("open", {
+			describe: "Automatically open the browser",
+			type: "boolean",
+			default: true
 		});
-	}).option("port", {
-		alias: "p",
-		describe: "Port to run the server on",
-		type: "number",
-		default: 3100
-	}).option("dir", {
-		alias: "d",
-		describe: "Project directory containing openspec/",
-		type: "string"
-	}).option("open", {
-		describe: "Automatically open the browser",
-		type: "boolean",
-		default: true
-	}).example("$0", "Start in current directory").example("$0 ./my-project", "Start with specific project").example("$0 -p 8080", "Start on custom port").example("$0 --dir=./my-project", "Start with specific project").example("$0 --no-open", "Start without opening browser").version(getVersion()).alias("v", "version").help().alias("h", "help").parse();
-	const projectDir = resolve$1(originalCwd, argv["project-dir"] || argv.dir || ".");
-	console.log(`
+	}, async (argv) => {
+		const projectDir = resolve$1(originalCwd, argv["project-dir"] || argv.dir || ".");
+		console.log(`
 ┌─────────────────────────────────────────────┐
 │           OpenSpec UI                       │
 │   Visual interface for spec-driven dev      │
 └─────────────────────────────────────────────┘
 `);
-	console.log(`📁 Project: ${projectDir}`);
-	console.log("");
-	try {
-		const server = await startServer({
-			projectDir,
-			port: argv.port,
-			open: argv.open
-		});
-		if (server.port !== server.preferredPort) console.log(`⚠️  Port ${server.preferredPort} is in use, using ${server.port} instead`);
-		console.log(`✅ Server running at ${server.url}`);
+		console.log(`📁 Project: ${projectDir}`);
 		console.log("");
-		if (argv.open) {
-			await (await import("./open-BTGRjBxH.mjs")).default(server.url);
-			console.log("🌐 Browser opened");
+		try {
+			const server = await startServer({
+				projectDir,
+				port: argv.port,
+				open: argv.open
+			});
+			if (server.port !== server.preferredPort) console.log(`⚠️  Port ${server.preferredPort} is in use, using ${server.port} instead`);
+			console.log(`✅ Server running at ${server.url}`);
+			console.log("");
+			if (argv.open) {
+				await (await import("./open-CgagzOBo.mjs")).default(server.url);
+				console.log("🌐 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();
+				process.exit(0);
+			});
+			process.on("SIGTERM", async () => {
+				await server.close();
+				process.exit(0);
+			});
+		} catch (error) {
+			console.error("❌ Failed to start server:", error);
+			process.exit(1);
 		}
-		console.log("");
-		console.log("Press Ctrl+C to stop the server");
-		process.on("SIGINT", async () => {
-			console.log("\n\n👋 Shutting down...");
-			await server.close();
-			process.exit(0);
-		});
-		process.on("SIGTERM", async () => {
-			await server.close();
-			process.exit(0);
+	}).command("export", "Export OpenSpec UI as a static website (alias for @openspecui/web ssg)", (yargs) => {
+		return yargs.option("output", {
+			alias: "o",
+			describe: "Output directory for static export",
+			type: "string",
+			demandOption: true
+		}).option("dir", {
+			alias: "d",
+			describe: "Project directory containing openspec/",
+			type: "string"
+		}).option("base-path", {
+			alias: "b",
+			describe: "Base path for deployment (e.g., /docs/ or ./)",
+			type: "string"
+		}).option("clean", {
+			alias: "c",
+			describe: "Clean output directory before export",
+			type: "boolean"
+		}).option("open", {
+			describe: "Start preview server and open in browser after export",
+			type: "boolean"
+		}).option("preview-port", {
+			describe: "Port for the preview server (used with --open)",
+			type: "number"
+		}).option("preview-host", {
+			describe: "Host for the preview server (used with --open)",
+			type: "string"
 		});
-	} catch (error) {
-		console.error("❌ Failed to start server:", error);
-		process.exit(1);
-	}
+	}, async (argv) => {
+		const projectDir = resolve$1(originalCwd, argv.dir || ".");
+		const outputDir = resolve$1(originalCwd, argv.output);
+		try {
+			await exportStaticSite({
+				projectDir,
+				outputDir,
+				basePath: argv["base-path"],
+				clean: argv.clean,
+				open: argv.open,
+				previewPort: argv["preview-port"],
+				previewHost: argv["preview-host"]
+			});
+			if (!argv.open) process.exit(0);
+		} catch (error) {
+			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 to ./dist directory").example("$0 export --output ./public", "Export to ./public directory").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();
 }
 main();
 

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { i as ACPAgents, n as createServer, r as ProviderManager, t as startServer } from "./src-BTqFItR8.mjs";
+import { a as ACPAgents, i as ProviderManager, n as createServer, t as startServer } from "./src-BtPH0zlP.mjs";
 
 export { ACPAgents, ProviderManager, createServer, startServer };

package/dist/{open-BTGRjBxH.mjs → open-CgagzOBo.mjs}

@@ -3,10 +3,10 @@ import path from "node:path";
 import fs$1 from "node:fs";
 import os from "node:os";
 import { fileURLToPath } from "node:url";
+import childProcess, { execFile } from "node:child_process";
 import process from "node:process";
 import { Buffer } from "node:buffer";
 import { promisify } from "node:util";
-import childProcess, { execFile } from "node:child_process";
 
 //#region ../../node_modules/.pnpm/is-docker@3.0.0/node_modules/is-docker/index.js
 let isDockerCached;

package/dist/{src-BTqFItR8.mjs → src-BtPH0zlP.mjs}

@@ -13395,10 +13395,7 @@ async function initWatcherPool(projectDir) {
 * @returns 释放函数，调用后取消订阅
 */
 function acquireWatcher(path$1, onChange, options = {}) {
-	if (!globalProjectWatcher || !globalProjectWatcher.isInitialized) {
-		console.warn("[watcher-pool] ProjectWatcher not initialized. Call initWatcherPool first.");
-		return () => {};
-	}
+	if (!globalProjectWatcher || !globalProjectWatcher.isInitialized) return () => {};
 	const normalizedPath = getRealPath(path$1);
 	const debounceMs = options.debounceMs ?? DEBOUNCE_MS;
 	const isRecursive = options.recursive ?? false;
@@ -15850,4 +15847,4 @@ async function startServer$1(options = {}) {
 }
 
 //#endregion
-export { __commonJS$1 as a, ACPAgents as i, createServer$2 as n, __toESM$1 as o, ProviderManager as r, startServer$1 as t };
+export { ACPAgents as a, ProviderManager as i, createServer$2 as n, __commonJS$1 as o, OpenSpecAdapter as r, __toESM$1 as s, startServer$1 as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openspecui",
-  "version": "0.7.7",
+  "version": "0.8.0",
   "description": "OpenSpec UI - Visual interface for spec-driven development",
   "type": "module",
   "main": "dist/index.mjs",