@askrjs/cli 0.0.2 → 0.0.4

package/dist/cli.js

@@ -1,11 +1,5 @@
 #!/usr/bin/env node
 import { t as isDirectExecution } from "./is-direct-execution-Cdlr-ZUl.js";
-import { t as runAddCli } from "./add-DqhqRzBQ.js";
-import { n as runSkillsCli } from "./skills-Bh0mEhIx.js";
-import { runCreateCli } from "./create.js";
-import { runOpenApiCli } from "./openapi.js";
-import { runSsgCli } from "./ssg.js";
-import { t as runUpdateCli } from "./update-DyW1na5V.js";
 import path from "node:path";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
@@ -40,10 +34,13 @@ function printHelp(io = console) {
 	io.log("Commands:");
 	io.log("  add        Generate pages or declared actions into an Askr project");
 	io.log("  create     Create a new Askr app from a template or product prompt");
+	io.log("  generate   Generate an @askrjs/fetch client from OpenAPI");
 	io.log("  openapi    Generate or check an OpenAPI YAML artifact");
 	io.log("  skills     Install or sync Askr agent skills");
 	io.log("  ssg        Run static-site generation");
-	io.log("  update     Plan or apply dependency manifest updates");
+	io.log("  outdated   List available dependency updates");
+	io.log("  update     Apply safe dependency updates");
+	io.log("  upgrade    Apply latest peer-compatible dependency upgrades");
 	io.log("");
 	io.log("Options:");
 	io.log("  --help, -h     Show help");
@@ -58,7 +55,9 @@ function printHelp(io = console) {
 	io.log("  askr openapi --check");
 	io.log("  askr skills review foundation --cwd ./candidate-app");
 	io.log("  askr ssg --config ./ssg.config.ts --output ./dist/static");
-	io.log("  askr update -u");
+	io.log("  askr outdated");
+	io.log("  askr update");
+	io.log("  askr upgrade");
 }
 async function runCli(args = process.argv.slice(2), io = console) {
 	const command = args[0];
@@ -70,12 +69,42 @@ async function runCli(args = process.argv.slice(2), io = console) {
 		printHelp(io);
 		return 0;
 	}
-	if (command === "create") return runCreateCli(args.slice(1), io);
-	if (command === "add") return runAddCli(args.slice(1), io);
-	if (command === "ssg") return runSsgCli(args.slice(1), void 0, io);
-	if (command === "openapi") return runOpenApiCli(args.slice(1), io);
-	if (command === "skills") return runSkillsCli(args.slice(1), io);
-	if (command === "update") return runUpdateCli(args.slice(1), io);
+	if (command === "create") {
+		const { runCreateCli } = await import("./create.js");
+		return runCreateCli(args.slice(1), io);
+	}
+	if (command === "add") {
+		const { runAddCli } = await import("./add.js");
+		return runAddCli(args.slice(1), io);
+	}
+	if (command === "generate") {
+		const { runGenerateCli } = await import("./generate.js");
+		return runGenerateCli(args.slice(1), io);
+	}
+	if (command === "ssg") {
+		const { runSsgCli } = await import("./ssg.js");
+		return runSsgCli(args.slice(1), void 0, io);
+	}
+	if (command === "openapi") {
+		const { runOpenApiCli } = await import("./openapi.js");
+		return runOpenApiCli(args.slice(1), io);
+	}
+	if (command === "skills") {
+		const { runSkillsCli } = await import("./skills.js");
+		return runSkillsCli(args.slice(1), io);
+	}
+	if (command === "update") {
+		const { runUpdateCli } = await import("./update.js");
+		return runUpdateCli(args.slice(1), io);
+	}
+	if (command === "upgrade") {
+		const { runUpgradeCli } = await import("./update.js");
+		return runUpgradeCli(args.slice(1), io);
+	}
+	if (command === "outdated") {
+		const { runOutdatedCli } = await import("./update.js");
+		return runOutdatedCli(args.slice(1), io);
+	}
 	io.error(`Unknown command: ${command}`);
 	io.error("Run `askr --help` to see available commands.");
 	return 1;
@@ -87,5 +116,3 @@ async function main() {
 if (isDirectExecution(import.meta.url)) main();
 //#endregion
 export { runCli };
-
-//# sourceMappingURL=cli.js.map

package/dist/create.d.ts

@@ -0,0 +1,5 @@
+//#region src/bin/create.d.ts
+type CliIo = Pick<Console, "error" | "log">;
+declare function runCreateCli(args?: string[], io?: CliIo): Promise<number>;
+//#endregion
+export { runCreateCli };

package/dist/create.js

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 import { t as isDirectExecution } from "./is-direct-execution-Cdlr-ZUl.js";
-import { t as installBundledSkills } from "./skills-Bh0mEhIx.js";
+import { t as installBundledSkills } from "./skills-B7CbWur9.js";
+import { n as publishStagedDirectory, t as createSiblingStage } from "./directory-swap-DWoHtx7C.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
+import { isUtf8 } from "node:buffer";
 import readline from "node:readline";
 //#region src/bin/create.ts
 const TEMPLATE_LABELS = {
@@ -396,8 +398,8 @@ const TEMPLATE_INSPECT_PATHS = {
 	ssr: [
 		"AGENTS.md",
 		"src/main.tsx",
-		"src/server-entry.tsx",
-		"src/pages/_routes.tsx",
+		"src/entry-server.tsx",
+		"src/routes.tsx",
 		"server.ts"
 	],
 	ssg: [
@@ -432,7 +434,7 @@ const TEMPLATE_GOLDEN_EXAMPLES = {
 	],
 	ssr: [
 		"src/main.tsx",
-		"src/pages/_routes.tsx",
+		"src/routes.tsx",
 		"server.ts"
 	],
 	ssg: [
@@ -462,7 +464,7 @@ function helpText() {
 		"askr create - Project scaffolding for Askr",
 		"",
 		"Usage:",
-		"  askr create [template] <name> [--prompt <text>] [--no-install] [--no-skills]",
+		"  askr create [template] <name> [--dir <path>] [--prompt <text>] [--no-install] [--no-skills]",
 		"  askr create --prompt <text> [name] [--no-install] [--no-skills]",
 		"",
 		"Templates:",
@@ -470,6 +472,7 @@ function helpText() {
 		"",
 		"Options:",
 		"  --prompt <text>  Infer the best template from a product prompt and emit a builder blueprint",
+		"  --dir <path>     Explicit output directory (defaults to ./<name>)",
 		"  --no-install     Skip dependency installation",
 		"  --no-skills      Skip bundled Askr skill installation into skills/",
 		"  --help, -h       Show help",
@@ -495,6 +498,8 @@ async function prompt(question) {
 }
 function detectPm() {
 	const ua = process.env.npm_config_user_agent || "";
+	if (ua.startsWith("pnpm")) return "pnpm";
+	if (ua.startsWith("bun")) return "bun";
 	if (ua.startsWith("yarn")) return "yarn";
 	if (ua.startsWith("npm")) return "npm";
 	return "npm";
@@ -522,7 +527,12 @@ async function copyDir(src, dest, replacements) {
 			await copyDir(srcPath, destPath, replacements);
 			continue;
 		}
-		const replaced = (await fs.readFile(srcPath)).toString("utf8").replace(/\{\{\s*appName\s*\}\}/g, replacements.appName).replace(/\{\{appName\}\}/g, replacements.appName);
+		const buffer = await fs.readFile(srcPath);
+		if (!isUtf8(buffer)) {
+			await fs.writeFile(destPath, buffer);
+			continue;
+		}
+		const replaced = buffer.toString("utf8").replace(/\{\{\s*appName\s*\}\}/g, replacements.appName).replace(/\{\{appName\}\}/g, replacements.appName);
 		await fs.writeFile(destPath, replaced, "utf8");
 	}
 }
@@ -548,17 +558,24 @@ function parseArgs(args) {
 	let help = false;
 	let promptText = "";
 	let skills = true;
+	let targetDir = "";
 	const errors = [];
 	for (let i = 0; i < args.length; i += 1) {
 		const arg = args[i];
 		if (arg === "--no-install") install = false;
 		else if (arg === "--no-skills") skills = false;
-		else if (arg === "--prompt") if (i + 1 >= args.length) errors.push("Missing value for --prompt");
+		else if (arg === "--prompt") if (i + 1 >= args.length || args[i + 1].startsWith("-")) errors.push("Missing value for --prompt");
 		else {
 			promptText = normalizePromptText(args[i + 1]);
 			i += 1;
 		}
+		else if (arg === "--dir") if (i + 1 >= args.length || args[i + 1].startsWith("-")) errors.push("Missing value for --dir");
+		else {
+			targetDir = args[i + 1];
+			i += 1;
+		}
 		else if (arg === "--help" || arg === "-h") help = true;
+		else if (arg.startsWith("-")) errors.push(`Unknown option: ${arg}`);
 		else positional.push(arg);
 	}
 	return {
@@ -567,9 +584,15 @@ function parseArgs(args) {
 		help,
 		promptText,
 		skills,
-		errors
+		errors,
+		targetDir
 	};
 }
+function validateAppName(name) {
+	if (name.length > 214) return "App name must be 214 characters or fewer";
+	if (!/^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/.test(name)) return "App name must be a lowercase npm package name without path separators";
+	if (/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])$/.test(name)) return `App name is reserved on Windows: ${name}`;
+}
 function normalizePromptText(promptText) {
 	return promptText.trim().replace(/\s+/g, " ");
 }
@@ -810,7 +833,17 @@ async function runCreateCli(args = process.argv.slice(2), io = console) {
 		io.error("App name is required");
 		return 1;
 	}
-	const target = path.resolve(process.cwd(), name);
+	const nameError = validateAppName(name);
+	if (nameError) {
+		io.error(nameError);
+		return 1;
+	}
+	const expectedPositionals = explicitTemplate ? 2 : 1;
+	if (parsed.positional.length > expectedPositionals) {
+		io.error("Too many positional arguments");
+		return 1;
+	}
+	const target = path.resolve(process.cwd(), parsed.targetDir || name);
 	const templateDir = await findTemplateDir(templateType);
 	try {
 		await fs.access(templateDir);
@@ -819,7 +852,12 @@ async function runCreateCli(args = process.argv.slice(2), io = console) {
 		return 1;
 	}
 	try {
-		if (await fs.stat(target).catch(() => null)) {
+		const stat = await fs.stat(target).catch(() => null);
+		if (stat) {
+			if (!stat.isDirectory()) {
+				io.error(`Target exists and is not a directory: ${target}`);
+				return 1;
+			}
 			if ((await fs.readdir(target).catch(() => [])).length > 0) {
 				io.error(`Directory ${target} already exists and is not empty.`);
 				return 1;
@@ -844,28 +882,48 @@ async function runCreateCli(args = process.argv.slice(2), io = console) {
 	}
 	io.log(`Creating ${TEMPLATE_LABELS[templateType]} project: ${name}...`);
 	io.log("");
+	let stagingTarget;
+	try {
+		stagingTarget = await createSiblingStage(target, "askr-create");
+	} catch (error) {
+		io.error("Failed to prepare project output");
+		io.error(error instanceof Error ? error.message : String(error));
+		return 1;
+	}
 	try {
-		await copyDir(templateDir, target, { appName: name });
+		await copyDir(templateDir, stagingTarget, { appName: name });
 	} catch (error) {
+		await fs.rm(stagingTarget, {
+			recursive: true,
+			force: true
+		});
 		io.error("Failed to copy template");
 		io.error(error instanceof Error ? error.message : String(error));
 		return 1;
 	}
 	try {
-		await writeBlueprintFiles(target, blueprint);
+		await writeBlueprintFiles(stagingTarget, blueprint);
 	} catch (error) {
+		await fs.rm(stagingTarget, {
+			recursive: true,
+			force: true
+		});
 		io.error("Failed to write project blueprint");
 		io.error(error instanceof Error ? error.message : String(error));
 		return 1;
 	}
 	if (parsed.skills) try {
 		const { bundledNames, targetSkillsDir } = await installBundledSkills({
-			cwd: target,
+			cwd: stagingTarget,
 			force: true
 		});
 		io.log(`Installed ${bundledNames.length} bundled Askr skills into ${path.basename(targetSkillsDir)}/`);
 		io.log("");
 	} catch (error) {
+		await fs.rm(stagingTarget, {
+			recursive: true,
+			force: true
+		});
 		io.error("Failed to install bundled Askr skills");
 		io.error(error instanceof Error ? error.message : String(error));
 		return 1;
@@ -874,35 +932,57 @@ async function runCreateCli(args = process.argv.slice(2), io = console) {
 		io.log("Skipping bundled Askr skill installation (--no-skills)");
 		io.log("");
 	}
+	const pm = detectPm();
 	if (!parsed.install) {
+		try {
+			await publishStagedDirectory(stagingTarget, target);
+		} catch (error) {
+			await fs.rm(stagingTarget, {
+				recursive: true,
+				force: true
+			});
+			io.error("Failed to publish generated project");
+			io.error(error instanceof Error ? error.message : String(error));
+			return 1;
+		}
 		io.log("Skipping dependency installation (--no-install)");
 		io.log("");
 		io.log("Next steps:");
 		io.log(`  cd ${name}`);
 		io.log("  review .askr/builder-brief.md");
 		if (!parsed.skills) io.log("  askr skills install");
-		io.log("  npm install");
-		io.log("  npm run dev");
+		io.log(`  ${pm} install`);
+		io.log(`  ${pm} run dev`);
 		return 0;
 	}
-	const pm = detectPm();
 	io.log(`Installing dependencies with ${pm}...`);
 	io.log("");
 	const result = spawnSync(pm, ["install"], {
-		cwd: target,
+		cwd: stagingTarget,
 		stdio: "inherit",
 		shell: process.platform === "win32"
 	});
+	if (result.status !== 0) {
+		await fs.rm(stagingTarget, {
+			recursive: true,
+			force: true
+		});
+		io.error(`Dependency installation with ${pm} failed; no project files were published.`);
+		if (result.error) io.error(result.error.message);
+		return 1;
+	}
 	io.log("");
 	io.log(`Success! Created ${name}`);
 	io.log("");
-	if (result.status !== 0) {
-		io.log("Dependency installation failed. Please run manually:");
-		io.log(`  cd ${name}`);
-		io.log("  review .askr/builder-brief.md");
-		if (!parsed.skills) io.log("  askr skills install");
-		io.log(`  ${pm} install`);
-		io.log(`  ${pm} run dev`);
+	try {
+		await publishStagedDirectory(stagingTarget, target);
+	} catch (error) {
+		await fs.rm(stagingTarget, {
+			recursive: true,
+			force: true
+		});
+		io.error("Failed to publish generated project");
+		io.error(error instanceof Error ? error.message : String(error));
 		return 1;
 	}
 	io.log("Next steps:");
@@ -919,5 +999,3 @@ async function main() {
 if (isDirectExecution(import.meta.url)) main();
 //#endregion
 export { runCreateCli };
-
-//# sourceMappingURL=create.js.map

package/dist/directory-swap-DWoHtx7C.js

@@ -0,0 +1,35 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+//#region src/directory-swap.ts
+async function exists(target) {
+	return Boolean(await fs.stat(target).catch(() => null));
+}
+async function createSiblingStage(target, label) {
+	const resolved = path.resolve(target);
+	const parent = path.dirname(resolved);
+	await fs.mkdir(parent, { recursive: true });
+	return fs.mkdtemp(path.join(parent, `.${path.basename(resolved)}.${label}-`));
+}
+async function publishStagedDirectory(stage, target) {
+	const resolvedTarget = path.resolve(target);
+	const backup = path.join(path.dirname(resolvedTarget), `.${path.basename(resolvedTarget)}.askr-backup-${randomUUID()}`);
+	const hadTarget = await exists(resolvedTarget);
+	let movedTarget = false;
+	try {
+		if (hadTarget) {
+			await fs.rename(resolvedTarget, backup);
+			movedTarget = true;
+		}
+		await fs.rename(stage, resolvedTarget);
+	} catch (error) {
+		if (movedTarget && !await exists(resolvedTarget) && await exists(backup)) await fs.rename(backup, resolvedTarget);
+		throw error;
+	}
+	if (movedTarget) await fs.rm(backup, {
+		recursive: true,
+		force: true
+	}).catch(() => void 0);
+}
+//#endregion
+export { publishStagedDirectory as n, createSiblingStage as t };