openspecui 1.5.1 → 1.6.2

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as SchemaInfoSchema, c as CliExecutor, d as OpenSpecAdapter, f as __commonJS, i as SchemaDetailSchema, l as ConfigManager, o as SchemaResolutionSchema, p as __toESM, r as require_dist, s as TemplatesSchema, t as startServer, u as DEFAULT_CONFIG } from "./src-16GA3our.mjs";
+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-CVJCbdiP.mjs";
 import { createRequire } from "node:module";
 import { basename, dirname, extname, join, normalize, relative, resolve } from "path";
 import { readFile } from "node:fs/promises";
@@ -8,7 +8,8 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync
 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 { spawn } from "node:child_process";
+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";
 
@@ -4506,11 +4507,12 @@ var yargs_default = Yargs;
 //#endregion
 //#region package.json
 var import_dist = require_dist();
-var version = "1.5.1";
+var version = "1.6.2";
 
 //#endregion
 //#region src/export.ts
 const __dirname$1 = dirname$1(fileURLToPath$1(import.meta.url));
+const execFileAsync = promisify$1(execFile);
 function parseCliJson(raw, schema, label) {
 	const trimmed = raw.trim();
 	if (!trimmed) throw new Error(`${label} returned empty output`);
@@ -4559,6 +4561,184 @@ function parseSchemaYaml(content) {
 	if (!validated.success) throw new Error(`Invalid schema.yaml detail: ${validated.error.message}`);
 	return validated.data;
 }
+function isAbsoluteFsPath(path$1) {
+	const normalized = path$1.replace(/\\/g, "/");
+	return normalized.startsWith("/") || /^[A-Za-z]:\//.test(normalized);
+}
+function toAbsoluteProjectPath(projectDir, path$1) {
+	return isAbsoluteFsPath(path$1) ? path$1 : resolve$1(projectDir, path$1);
+}
+function normalizeGitPath(path$1) {
+	return path$1.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+function parseRelatedChanges(paths) {
+	const related = /* @__PURE__ */ new Set();
+	for (const rawPath of paths) {
+		const path$1 = normalizeGitPath(rawPath);
+		const activeMatch = /^openspec\/changes\/([^/]+)\//.exec(path$1);
+		if (activeMatch?.[1]) {
+			related.add(activeMatch[1]);
+			continue;
+		}
+		const archiveMatch = /^openspec\/changes\/archive\/([^/]+)\//.exec(path$1);
+		if (archiveMatch?.[1]) related.add(archiveMatch[1].replace(/^\d{4}-\d{2}-\d{2}-/, ""));
+	}
+	return [...related].sort((a, b) => a.localeCompare(b));
+}
+function parseNumstat(numstatOutput) {
+	let files = 0;
+	let insertions = 0;
+	let deletions = 0;
+	for (const line of numstatOutput.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		const [addRaw, delRaw] = trimmed.split("	");
+		if (!addRaw || !delRaw) continue;
+		files += 1;
+		if (addRaw !== "-") insertions += Number(addRaw) || 0;
+		if (delRaw !== "-") deletions += Number(delRaw) || 0;
+	}
+	return {
+		files,
+		insertions,
+		deletions
+	};
+}
+async function readDefaultBranch(projectDir) {
+	try {
+		const { stdout } = await execFileAsync("git", [
+			"symbolic-ref",
+			"--quiet",
+			"--short",
+			"refs/remotes/origin/HEAD"
+		], {
+			cwd: projectDir,
+			encoding: "utf8",
+			maxBuffer: 1024 * 1024
+		});
+		const branch = stdout.trim();
+		if (branch.length > 0) return branch;
+	} catch {}
+	try {
+		const { stdout } = await execFileAsync("git", [
+			"rev-parse",
+			"--abbrev-ref",
+			"HEAD"
+		], {
+			cwd: projectDir,
+			encoding: "utf8",
+			maxBuffer: 1024 * 1024
+		});
+		const branch = stdout.trim();
+		if (branch.length > 0 && branch !== "HEAD") return branch;
+	} catch {}
+	return "main";
+}
+function parseRecentCommitLog(output) {
+	const commits = [];
+	let current = null;
+	const pushCurrent = () => {
+		if (!current) return;
+		commits.push({
+			hash: current.hash,
+			title: current.title,
+			committedAt: current.committedAt,
+			relatedChanges: parseRelatedChanges(current.changedPaths),
+			diff: parseNumstat(current.numstatLines.join("\n"))
+		});
+		current = null;
+	};
+	for (const line of output.split("\n")) {
+		if (line.startsWith("__COMMIT__	")) {
+			pushCurrent();
+			const [_, hash, tsRaw, ...titleParts] = line.split("	");
+			const committedAt = Number(tsRaw) * 1e3;
+			current = {
+				hash: hash ?? "",
+				title: titleParts.join("	").trim() || (hash ? hash.slice(0, 8) : "commit"),
+				committedAt: Number.isFinite(committedAt) && committedAt > 0 ? committedAt : 0,
+				numstatLines: [],
+				changedPaths: []
+			};
+			continue;
+		}
+		if (!current) continue;
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		const [addRaw, delRaw, ...pathParts] = trimmed.split("	");
+		if (!addRaw || !delRaw || pathParts.length === 0) continue;
+		const path$1 = pathParts.join("	");
+		current.numstatLines.push(`${addRaw}\t${delRaw}\t${path$1}`);
+		current.changedPaths.push(path$1);
+	}
+	pushCurrent();
+	return commits.filter((commit) => commit.hash.length > 0);
+}
+function normalizeRepositoryUrl(raw) {
+	const value = raw.trim();
+	if (!value) return null;
+	if (value.startsWith("http://") || value.startsWith("https://")) return value.replace(/\.git$/i, "");
+	const gitAtMatch = /^git@([^:]+):(.+)$/.exec(value);
+	if (gitAtMatch?.[1] && gitAtMatch[2]) return `https://${gitAtMatch[1]}/${gitAtMatch[2].replace(/\.git$/i, "")}`;
+	if (value.startsWith("ssh://")) try {
+		const parsed = new URL(value);
+		const pathname = parsed.pathname.replace(/^\/+/, "").replace(/\.git$/i, "");
+		if (!pathname) return null;
+		return `https://${parsed.hostname}/${pathname}`;
+	} catch {}
+	return value.replace(/\.git$/i, "");
+}
+async function readSnapshotGit(projectDir) {
+	try {
+		const defaultBranch = await readDefaultBranch(projectDir);
+		const { stdout: latestTsRaw } = await execFileAsync("git", [
+			"log",
+			"-1",
+			"--format=%ct"
+		], {
+			cwd: projectDir,
+			encoding: "utf8",
+			maxBuffer: 1024 * 1024
+		});
+		const latestSeconds = Number(latestTsRaw.trim());
+		const latestCommitTs = Number.isFinite(latestSeconds) && latestSeconds > 0 ? latestSeconds * 1e3 : null;
+		let repositoryUrl = null;
+		try {
+			const { stdout: remoteRaw } = await execFileAsync("git", [
+				"config",
+				"--get",
+				"remote.origin.url"
+			], {
+				cwd: projectDir,
+				encoding: "utf8",
+				maxBuffer: 1024 * 1024
+			});
+			repositoryUrl = normalizeRepositoryUrl(remoteRaw);
+		} catch {
+			repositoryUrl = null;
+		}
+		const { stdout: logOutput } = await execFileAsync("git", [
+			"log",
+			"-n",
+			"5",
+			"--format=__COMMIT__%x09%H%x09%ct%x09%s",
+			"--numstat",
+			"--"
+		], {
+			cwd: projectDir,
+			encoding: "utf8",
+			maxBuffer: 8 * 1024 * 1024
+		});
+		return {
+			defaultBranch,
+			repositoryUrl,
+			latestCommitTs,
+			recentCommits: parseRecentCommitLog(logOutput)
+		};
+	} catch {
+		return;
+	}
+}
 /**
 * Generate a complete data snapshot of the OpenSpec project
 * (Kept for backwards compatibility and testing)
@@ -4586,12 +4766,11 @@ async function generateSnapshot(projectDir) {
 	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) => ({
+		const deltas = (change?.deltaSpecs || []).map((ds) => ({
 			capability: ds.specId,
 			content: ds.content || ""
 		}));
@@ -4601,11 +4780,11 @@ async function generateSnapshot(projectDir) {
 			proposal: proposalFile?.content || "",
 			tasks: tasksFile?.content,
 			design: designFile?.content,
-			why: change.why || "",
-			whatChanges: change.whatChanges || "",
-			parsedTasks: change.tasks || [],
+			why: change?.why || "",
+			whatChanges: change?.whatChanges || "",
+			parsedTasks: change?.tasks || [],
 			deltas,
-			progress: meta.progress,
+			progress: change?.progress ?? meta.progress,
 			createdAt: meta.createdAt,
 			updatedAt: meta.updatedAt
 		};
@@ -4641,8 +4820,10 @@ async function generateSnapshot(projectDir) {
 	let configYaml;
 	let schemas = [];
 	const schemaDetails = {};
+	const schemaYamls = {};
 	const schemaResolutions = {};
 	const templates = {};
+	const templateContents = {};
 	const changeMetadata = {};
 	try {
 		configYaml = await readFile(join$1(projectDir, "openspec", "config.yaml"), "utf-8");
@@ -4660,16 +4841,56 @@ async function generateSnapshot(projectDir) {
 			const resolutionResult = await cliExecutor.schemaWhich(schema.name);
 			if (resolutionResult.success) {
 				const resolution = parseCliJson(resolutionResult.stdout, SchemaResolutionSchema, "openspec schema which");
-				schemaResolutions[schema.name] = resolution;
+				schemaResolutions[schema.name] = {
+					...resolution,
+					displayPath: toOpsxDisplayPath(resolution.path, {
+						source: resolution.source,
+						projectDir
+					}),
+					shadows: resolution.shadows.map((shadow) => ({
+						...shadow,
+						displayPath: toOpsxDisplayPath(shadow.path, {
+							source: shadow.source,
+							projectDir
+						})
+					}))
+				};
 				try {
 					const schemaContent = await readFile(join$1(resolution.path, "schema.yaml"), "utf-8");
 					schemaDetails[schema.name] = parseSchemaYaml(schemaContent);
+					schemaYamls[schema.name] = schemaContent;
 				} catch {}
 			}
 		} catch {}
 		try {
 			const templatesResult = await cliExecutor.templates(schema.name);
-			if (templatesResult.success) templates[schema.name] = parseCliJson(templatesResult.stdout, TemplatesSchema, "openspec templates");
+			if (templatesResult.success) {
+				const parsedTemplates = parseCliJson(templatesResult.stdout, TemplatesSchema, "openspec templates");
+				const normalizedTemplates = Object.fromEntries(Object.entries(parsedTemplates).map(([artifactId, info]) => [artifactId, {
+					...info,
+					path: toAbsoluteProjectPath(projectDir, info.path),
+					displayPath: toOpsxDisplayPath(info.path, {
+						source: info.source,
+						projectDir
+					})
+				}]));
+				templates[schema.name] = normalizedTemplates;
+				const contents = await Promise.all(Object.entries(normalizedTemplates).map(async ([artifactId, info]) => {
+					let content = null;
+					try {
+						content = await readFile(info.path, "utf-8");
+					} catch {
+						content = null;
+					}
+					return [artifactId, {
+						content,
+						path: info.path,
+						displayPath: info.displayPath,
+						source: info.source
+					}];
+				}));
+				templateContents[schema.name] = Object.fromEntries(contents);
+			}
 		} catch {}
 	}
 	try {
@@ -4680,6 +4901,7 @@ async function generateSnapshot(projectDir) {
 			changeMetadata[changeId] = null;
 		}
 	} catch {}
+	const git = await readSnapshotGit(projectDir);
 	return {
 		meta: {
 			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -4691,9 +4913,10 @@ async function generateSnapshot(projectDir) {
 			changesCount: changes.filter((c) => c !== null).length,
 			archivesCount: archives.length
 		},
+		git,
 		config: uiConfig,
 		specs,
-		changes: changes.filter((c) => c !== null),
+		changes,
 		archives,
 		projectMd,
 		agentsMd,
@@ -4701,8 +4924,10 @@ async function generateSnapshot(projectDir) {
 			configYaml,
 			schemas,
 			schemaDetails,
+			schemaYamls,
 			schemaResolutions,
 			templates,
+			templateContents,
 			changeMetadata
 		}
 	};
@@ -4723,7 +4948,7 @@ function runCommand(cmd, args, cwd) {
 		const child = spawn(cmd, args, {
 			stdio: "inherit",
 			cwd,
-			shell: true
+			shell: false
 		});
 		child.on("close", (code) => {
 			if (code === 0) resolvePromise();
@@ -4757,7 +4982,7 @@ function detectPackageManager() {
 	return "npm";
 }
 /**
-* Get the command to run a local binary (like vite)
+* Get the command to run a binary in a package-manager agnostic way.
 */
 function getRunCommand(pm, bin) {
 	switch (pm) {
@@ -4767,11 +4992,11 @@ function getRunCommand(pm, bin) {
 		};
 		case "pnpm": return {
 			cmd: "pnpm",
-			args: ["exec", bin]
+			args: ["dlx", bin]
 		};
 		case "yarn": return {
 			cmd: "yarn",
-			args: [bin]
+			args: ["dlx", bin]
 		};
 		case "deno": return {
 			cmd: "deno",
@@ -5043,6 +5268,10 @@ async function main() {
 		}).option("preview-port", {
 			describe: "Port for the preview server (used with --open)",
 			type: "number"
+		}).option("port", {
+			alias: "p",
+			describe: "Alias of --open --preview-port <port>",
+			type: "number"
 		}).option("preview-host", {
 			describe: "Host for the preview server (used with --open)",
 			type: "string"
@@ -5050,6 +5279,8 @@ async function main() {
 	}, async (argv) => {
 		const projectDir = resolve$1(originalCwd, argv.dir || ".");
 		const outputDir = resolve$1(originalCwd, argv.output);
+		const previewPort = argv.port ?? argv["preview-port"];
+		const shouldOpen = argv.open || argv.port !== void 0;
 		try {
 			await exportStaticSite({
 				projectDir,
@@ -5057,16 +5288,16 @@ async function main() {
 				format: argv.format,
 				basePath: argv["base-path"],
 				clean: argv.clean,
-				open: argv.open,
-				previewPort: argv["preview-port"],
+				open: shouldOpen,
+				previewPort,
 				previewHost: argv["preview-host"]
 			});
-			if (!argv.open) process.exit(0);
+			if (!shouldOpen) 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 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();
+	}).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();
 }
 main();
 

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { n as createServer, t as startServer } from "./src-16GA3our.mjs";
+import { n as createServer, t as startServer } from "./src-CVJCbdiP.mjs";
 
 export { createServer, startServer };