openspecui 0.9.0 → 0.9.1

package/dist/cli.mjs

@@ -2647,14 +2647,14 @@ function usage(yargs, shim$2) {
 		if (shim$2.process.stdColumns) return Math.min(maxWidth$1, shim$2.process.stdColumns);
 		else return maxWidth$1;
 	}
-	let version = null;
+	let version$1 = null;
 	self.version = (ver) => {
-		version = ver;
+		version$1 = ver;
 	};
 	self.showVersion = (level) => {
 		const logger = yargs.getInternalMethods().getLoggerInstance();
 		if (!level) level = "error";
-		(typeof level === "function" ? level : logger[level])(version);
+		(typeof level === "function" ? level : logger[level])(version$1);
 	};
 	self.reset = function reset(localLookup) {
 		failMessage = null;
@@ -4502,10 +4502,13 @@ function isYargsInstance(y) {
 const Yargs = YargsFactory(esm_default);
 var yargs_default = Yargs;
 
+//#endregion
+//#region package.json
+var version = "0.9.1";
+
 //#endregion
 //#region src/export.ts
 const __dirname$1 = dirname$1(fileURLToPath$1(import.meta.url));
-const WEB_PACKAGE_VERSION = "0.9.0";
 /**
 * Generate a complete data snapshot of the OpenSpec project
 * (Kept for backwards compatibility and testing)
@@ -4585,7 +4588,7 @@ async function generateSnapshot(projectDir) {
 	return {
 		meta: {
 			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-			version: WEB_PACKAGE_VERSION,
+			version,
 			projectDir
 		},
 		dashboard: {
@@ -4601,62 +4604,50 @@ async function generateSnapshot(projectDir) {
 	};
 }
 /**
-* Detect the package manager being used
+* Check if running in local monorepo development mode
+* Returns the path to web package root if available, null otherwise
 */
-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";
+function findLocalWebPackage() {
+	if (existsSync(join$1(__dirname$1, "..", "..", "web", "package.json"))) return join$1(__dirname$1, "..", "..", "web");
+	return null;
 }
 /**
-* Get the command to execute a package binary
+* Run a command and wait for it to complete
 */
-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]
-		};
-	}
+function runCommand(cmd, args, cwd) {
+	return new Promise((resolvePromise, reject) => {
+		const child = spawn(cmd, args, {
+			stdio: "inherit",
+			cwd
+		});
+		child.on("close", (code) => {
+			if (code === 0) resolvePromise();
+			else reject(/* @__PURE__ */ new Error(`Command failed with exit code ${code}`));
+		});
+		child.on("error", (err) => reject(err));
+	});
 }
 /**
-* Check if running in local monorepo development mode
-* Returns the path to local SSG CLI if available, null otherwise
+* Export as JSON only (data.json)
 */
-function findLocalSSGCli() {
-	const localSsgTs = join$1(__dirname$1, "..", "..", "web", "src", "ssg", "cli.ts");
-	if (existsSync(localSsgTs)) return localSsgTs;
-	return null;
+async function exportJson(options) {
+	const { projectDir, outputDir, clean } = 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(`\nExported to ${dataJsonPath}`);
+	console.log(`  Specs: ${snapshot.specs.length}`);
+	console.log(`  Changes: ${snapshot.changes.length}`);
+	console.log(`  Archives: ${snapshot.archives.length}`);
 }
 /**
-* 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.
+* Export as static HTML site
 */
-async function exportStaticSite(options) {
-	const { projectDir, outputDir, basePath, clean, open, previewPort, previewHost } = options;
+async function exportHtml(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...");
@@ -4664,46 +4655,63 @@ async function exportStaticSite(options) {
 	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 = [
+	const localWebPkg = findLocalWebPackage();
+	if (localWebPkg) {
+		console.log("\n[Local dev mode] Running SSG from local web package...");
+		console.log("\nBuilding client assets...");
+		await runCommand("pnpm", ["build:client"], localWebPkg);
+		console.log("Building SSR bundle...");
+		await runCommand("pnpm", ["build:server"], localWebPkg);
+		console.log("Pre-rendering pages...");
+		const clientDistDir = join$1(localWebPkg, "dist", "client");
+		await runCommand("npx", [
 			"tsx",
-			localCli,
-			...ssgOnlyArgs
-		];
+			"src/ssg/prerender.ts",
+			"--data",
+			dataJsonPath,
+			"--output",
+			clientDistDir,
+			"--base-path",
+			basePath
+		], localWebPkg);
+		console.log("\nCopying to output directory...");
+		const { cpSync } = await import("node:fs");
+		cpSync(clientDistDir, outputDir, { recursive: true });
+		writeFileSync(join$1(outputDir, "data.json"), JSON.stringify(snapshot, null, 2));
+		console.log(`\nExport complete: ${outputDir}`);
 	} else {
-		const execCmd = getExecCommand(detectPackageManager());
-		cmd = execCmd.cmd;
-		args = [...execCmd.args, ...ssgOnlyArgs];
+		console.log("\nNote: HTML export requires @openspecui/web to be installed locally.");
+		console.log("For production SSG, run these commands:");
+		console.log("  npm install @openspecui/web");
+		console.log("  cd node_modules/@openspecui/web");
+		console.log("  pnpm build:ssg");
+		console.log(`  npx tsx src/ssg/prerender.ts --data ${dataJsonPath} --output ${outputDir}`);
+		console.log("\nData exported to data.json. Run the above commands to generate HTML.");
+		return;
+	}
+	if (open) {
+		console.log("\nStarting preview server...");
+		const previewArgs = [
+			"vite",
+			"preview",
+			"--outDir",
+			resolve$1(outputDir)
+		];
+		if (previewPort) previewArgs.push("--port", String(previewPort));
+		if (previewHost) previewArgs.push("--host", previewHost);
+		previewArgs.push("--open");
+		await runCommand("npx", previewArgs, outputDir);
 	}
-	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}`));
-		});
-	});
+}
+/**
+* Export the OpenSpec project
+*
+* @param options Export options
+* @param options.format 'html' (default) - full static site, 'json' - data only
+*/
+async function exportStaticSite(options) {
+	if ((options.format || "html") === "json") await exportJson(options);
+	else await exportHtml(options);
 }
 
 //#endregion
@@ -4778,12 +4786,18 @@ async function main() {
 			console.error("❌ Failed to start server:", error);
 			process.exit(1);
 		}
-	}).command("export", "Export OpenSpec UI as a static website (alias for @openspecui/web ssg)", (yargs) => {
+	}).command("export", "Export OpenSpec project as static website or JSON data", (yargs) => {
 		return yargs.option("output", {
 			alias: "o",
-			describe: "Output directory for static export",
+			describe: "Output directory for export",
 			type: "string",
 			demandOption: true
+		}).option("format", {
+			alias: "f",
+			describe: "Export format",
+			type: "string",
+			choices: ["html", "json"],
+			default: "html"
 		}).option("dir", {
 			alias: "d",
 			describe: "Project directory containing openspec/",
@@ -4813,6 +4827,7 @@ async function main() {
 			await exportStaticSite({
 				projectDir,
 				outputDir,
+				format: argv.format,
 				basePath: argv["base-path"],
 				clean: argv.clean,
 				open: argv.open,
@@ -4824,7 +4839,7 @@ 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 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();
+	}).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 --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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openspecui",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "OpenSpec UI - Visual interface for spec-driven development",
   "type": "module",
   "main": "dist/index.mjs",
@@ -31,6 +31,7 @@
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
     "yargs": "^18.0.0",
+    "@openspecui/web": "0.9.0",
     "@openspecui/server": "0.9.0"
   },
   "scripts": {