@keystrokehq/cli 0.1.35 → 0.1.36

package/dist/index.mjs

@@ -8,7 +8,7 @@ import { basename, dirname, isAbsolute, join, relative, resolve } from "node:pat
 import { Entry } from "@napi-rs/keyring";
 import { confirm, input, select } from "@inquirer/prompts";
 import { existsSync, lstatSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { access, copyFile, lstat, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
+import { access, lstat, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
 import { spawn, spawnSync } from "node:child_process";
 import { pathToFileURL } from "node:url";
 //#region ../../node_modules/.pnpm/ky@2.0.2/node_modules/ky/distribution/errors/KyError.js
@@ -6483,8 +6483,7 @@ function registerBuildCommand(program) {
 			await buildApp({ root });
 			process.stdout.write(`Built ${root}\n`);
 		} catch (error) {
-			const message = error instanceof Error ? error.message : "Build failed";
-			process.stderr.write(`${message}\n`);
+			process.stderr.write(`Build failed: ${formatCliError(error, "unknown error")}\n`);
 			process.exitCode = 1;
 		}
 	});
@@ -6607,8 +6606,11 @@ async function runDeploy(options) {
 }
 function registerDeployCommand(program) {
 	program.command("deploy").description("Build, upload, and deploy the project to the platform").option("--dir <path>", "Project directory", process.cwd()).option("--filter <entry>", "Build and deploy only matching module entry keys (repeatable)", (value, previous) => [...previous, value], []).action(async (options) => {
+		let config;
 		try {
-			const projectId = await resolveActiveProjectId(createCliConfig(), resolveProjectRoot(options.dir));
+			config = createCliConfig();
+			const root = resolveProjectRoot(options.dir);
+			const projectId = await resolveActiveProjectId(config, root);
 			if (!projectId) throw new Error("Usage: keystroke deploy --project <slug> (or run `keystroke project link --project <slug>`)");
 			await runDeploy({
 				dir: options.dir,
@@ -6616,8 +6618,8 @@ function registerDeployCommand(program) {
 				filter: options.filter.length > 0 ? options.filter : void 0
 			});
 		} catch (error) {
-			const message = error instanceof Error ? error.message : "Deploy failed";
-			process.stderr.write(`${message}\n`);
+			const message = formatCliError(error, "unknown error", { webUrl: config ? getWebUrl(config) : void 0 });
+			process.stderr.write(`Deploy failed: ${message}\n`);
 			process.exitCode = 1;
 		}
 	});
@@ -7030,7 +7032,7 @@ const INIT_CATALOG_VERSIONS = {
 	vitest: "^4.1.7",
 	"@types/node": "^25.9.1"
 };
-const INIT_KEYSTROKE_VERSION = "^0.1.27";
+const INIT_KEYSTROKE_VERSION = "^0.1.28";
 //#endregion
 //#region src/init/copy-template.ts
 function renderTemplate(content, variables) {
@@ -7121,23 +7123,28 @@ async function applyPlaygroundManifest(targetDir, projectName, monorepoRoot) {
 }
 //#endregion
 //#region src/skills/agents-guide-version.ts
-const BUNDLE_VERSION_FILENAME = ".bundle-version";
-const LEGACY_BUNDLE_VERSION_RELATIVE_PATH = join("skills", BUNDLE_VERSION_FILENAME);
+const VERSION_MARKER_RE = /<!-- keystroke-agents-guide: (.+?) -->/;
 function agentsGuideDir(projectRoot) {
 	return join(projectRoot, ".agents");
 }
-function bundleVersionPath(projectRoot) {
-	return join(agentsGuideDir(projectRoot), BUNDLE_VERSION_FILENAME);
+function agentsMdPath(projectRoot) {
+	return join(projectRoot, "AGENTS.md");
 }
-async function readBundleVersion(projectRoot) {
-	for (const path of [bundleVersionPath(projectRoot), join(agentsGuideDir(projectRoot), LEGACY_BUNDLE_VERSION_RELATIVE_PATH)]) try {
-		return (await readFile(path, "utf8")).trim();
-	} catch {}
-	return null;
+/**
+* Append the CLI version as a trailing HTML comment so auto-sync can detect
+* staleness without writing a sidecar `.agents/` directory. The marker is
+* invisible in rendered markdown and re-stamped (not stacked) on each write.
+*/
+function stampAgentsGuideVersion(content, version = readCliVersion()) {
+	const stripped = content.replace(/\n*<!-- keystroke-agents-guide: .+? -->\n*$/, "\n");
+	return `${stripped.endsWith("\n") ? stripped : `${stripped}\n`}\n<!-- keystroke-agents-guide: ${version} -->\n`;
 }
-async function writeBundleVersion(projectRoot) {
-	await mkdir(agentsGuideDir(projectRoot), { recursive: true });
-	await writeFile(bundleVersionPath(projectRoot), `${readCliVersion()}\n`);
+async function readBundleVersion(projectRoot) {
+	try {
+		return (await readFile(agentsMdPath(projectRoot), "utf8")).match(VERSION_MARKER_RE)?.[1]?.trim() ?? null;
+	} catch {
+		return null;
+	}
 }
 //#endregion
 //#region src/skills/resolve-skills-bundle-dir.ts
@@ -7166,11 +7173,10 @@ async function ensureSymlink(target, linkPath) {
 /** Writes AGENTS.md from the CLI bundle and recreates the CLAUDE.md symlink. */
 async function scaffoldAgentsGuide(projectRoot, fromModuleUrl = import.meta.url) {
 	const bundleDir = resolveSkillsBundleDir(fromModuleUrl);
-	const agentsMdPath = join(projectRoot, "AGENTS.md");
-	if ((await lstat(agentsMdPath).catch(() => null))?.isSymbolicLink()) await rm(agentsMdPath, { force: true });
-	await writeFile(agentsMdPath, await readFile(join(bundleDir, "_AGENTS.md"), "utf8"));
-	await ensureSymlink(relative(dirname(join(projectRoot, "CLAUDE.md")), agentsMdPath), join(projectRoot, "CLAUDE.md"));
-	await writeBundleVersion(projectRoot);
+	const guidePath = agentsMdPath(projectRoot);
+	if ((await lstat(guidePath).catch(() => null))?.isSymbolicLink()) await rm(guidePath, { force: true });
+	await writeFile(guidePath, stampAgentsGuideVersion(await readFile(join(bundleDir, "_AGENTS.md"), "utf8")));
+	await ensureSymlink(relative(dirname(join(projectRoot, "CLAUDE.md")), guidePath), join(projectRoot, "CLAUDE.md"));
 }
 //#endregion
 //#region src/project/write-project-config.ts
@@ -7305,7 +7311,6 @@ async function runInit(options) {
 	if (playgroundRoot) await applyPlaygroundManifest(targetDir, projectName, playgroundRoot);
 	else await scaffoldProjectDotfiles(targetDir);
 	await scaffoldAgentsGuide(targetDir);
-	await copyFile(join(targetDir, ".env.example"), join(targetDir, ".env"));
 	if (options.project || options.organization) writeLinkedProjectConfig({
 		...options.project ? { project: options.project } : {},
 		...options.organization ? { organization: options.organization } : {}
@@ -7683,11 +7688,12 @@ function registerProjectCommand(program) {
 			process.exitCode = 1;
 		}
 	});
-	project.command("metrics").description("List rollup metrics for projects in the active organization").option("--project <slug>", "Return metrics for a single project").option("--admin", "List all org resources (org owner or admin only)").action(async (options) => {
+	project.command("metrics").description("List rollup metrics for projects in the active organization").option("--admin", "List all org resources (org owner or admin only)").action(async (options) => {
 		const config = createCliConfig();
 		try {
+			const projectRef = getCliTargetOptions().projectId;
 			await runProjectMetrics(config, {
-				...options.project ? { projectRef: options.project } : {},
+				...projectRef ? { projectRef } : {},
 				...options.admin ? { admin: true } : {}
 			});
 		} catch (error) {