@percepta/create 3.1.4 → 3.2.0

package/dist/index.js

@@ -1,1155 +1,1168 @@
 #!/usr/bin/env node
-import {
-  VALID_PROJECT_TYPES,
-  isValidProjectType,
-  promptProjectDetails,
-  toKebabCase,
-  toSnakeCase,
-  toTitleCase,
-  validateProjectName
-} from "./chunk-CO3YWUD6.js";
-import {
-  derivePlaceholders,
-  writeManifest
-} from "./chunk-V5EJIUBJ.js";
-
-// src/index.ts
 import { program } from "commander";
-
-// src/commands/create.ts
-import path7 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-import fs7 from "fs-extra";
+import { execFile, execSync, spawn } from "node:child_process";
+import path from "node:path";
 import chalk from "chalk";
-import ora from "ora";
-import { execSync, spawn } from "child_process";
-
-// src/utils/copy-template.ts
-import path from "path";
-import { fileURLToPath } from "url";
 import fs from "fs-extra";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = path.dirname(__filename);
-var SKIP_DIRS = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".git",
-  ".next",
-  "dist",
-  ".turbo",
-  ".vercel",
-  ".cursor"
+import ora from "ora";
+import { fileURLToPath } from "node:url";
+import { parse } from "yaml";
+import { randomBytes } from "node:crypto";
+import inquirer from "inquirer";
+import validateNpmPackageName from "validate-npm-package-name";
+import { promisify } from "node:util";
+//#region src/utils/case-converters.ts
+/** Lowercase, hyphenated, npm-package-name-safe form: "My Cool App" → "my-cool-app". */
+function toKebabCase(str) {
+	return str.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+/** Display form derived from a kebab-case name: "my-cool-app" → "My Cool App". */
+function toTitleCase(str) {
+	return str.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
+/** Identifier form for env vars and DB names: "my-cool-app" → "my_cool_app". */
+function toSnakeCase(str) {
+	return str.replace(/-/g, "_");
+}
+//#endregion
+//#region src/utils/copy-template.ts
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const SKIP_DIRS$1 = new Set([
+	"node_modules",
+	".git",
+	".next",
+	"dist",
+	".turbo",
+	".vercel",
+	".cursor"
 ]);
-var SKIP_FILES = /* @__PURE__ */ new Set([
-  "pnpm-lock.yaml",
-  "package-lock.json",
-  "yarn.lock",
-  ".DS_Store"
+const SKIP_FILES$1 = new Set([
+	"pnpm-lock.yaml",
+	"package-lock.json",
+	"yarn.lock",
+	".DS_Store"
 ]);
-var TEMPLATE_FILE_MAPPINGS = {
-  "package.json.template": "package.json",
-  "gitignore.template": ".gitignore",
-  "env.example.template": ".env.example",
-  "npmrc.template": ".npmrc"
+const TEMPLATE_FILE_MAPPINGS = {
+	"package.json.template": "package.json",
+	"gitignore.template": ".gitignore",
+	"env.example.template": ".env.example",
+	"npmrc.template": ".npmrc"
 };
 function shouldSkip(src) {
-  const basename = path.basename(src);
-  if (SKIP_DIRS.has(basename)) return true;
-  if (SKIP_FILES.has(basename)) return true;
-  return false;
+	const basename = path.basename(src);
+	if (SKIP_DIRS$1.has(basename)) return true;
+	if (SKIP_FILES$1.has(basename)) return true;
+	return false;
 }
 function getTemplateDir(templateType) {
-  return path.resolve(__dirname, "../templates", templateType);
+	return path.resolve(__dirname, "../templates", templateType);
 }
 async function copyTemplate(targetDir, templateType) {
-  const templateDir = getTemplateDir(templateType);
-  if (!await fs.pathExists(templateDir)) {
-    throw new Error(`Template directory not found: ${templateDir}`);
-  }
-  await fs.ensureDir(targetDir);
-  await fs.copy(templateDir, targetDir, {
-    filter: (src) => !shouldSkip(src)
-  });
-  for (const [templateName, targetName] of Object.entries(
-    TEMPLATE_FILE_MAPPINGS
-  )) {
-    const templatePath = path.join(targetDir, templateName);
-    const targetPath = path.join(targetDir, targetName);
-    if (await fs.pathExists(templatePath)) {
-      await fs.move(templatePath, targetPath, { overwrite: true });
-    }
-  }
-  if (templateType === "webapp") {
-    const agentsPath = path.join(targetDir, "AGENTS.md");
-    const claudePath = path.join(targetDir, "CLAUDE.md");
-    if (await fs.pathExists(agentsPath)) {
-      if (await fs.pathExists(claudePath)) {
-        await fs.remove(claudePath);
-      }
-      await fs.ensureSymlink("AGENTS.md", claudePath);
-    }
-  }
+	const templateDir = getTemplateDir(templateType);
+	if (!await fs.pathExists(templateDir)) throw new Error(`Template directory not found: ${templateDir}`);
+	await fs.ensureDir(targetDir);
+	await fs.copy(templateDir, targetDir, { filter: (src) => !shouldSkip(src) });
+	for (const [templateName, targetName] of Object.entries(TEMPLATE_FILE_MAPPINGS)) {
+		const templatePath = path.join(targetDir, templateName);
+		const targetPath = path.join(targetDir, targetName);
+		if (await fs.pathExists(templatePath)) await fs.move(templatePath, targetPath, { overwrite: true });
+	}
+	if (templateType === "webapp") {
+		const agentsPath = path.join(targetDir, "AGENTS.md");
+		const claudePath = path.join(targetDir, "CLAUDE.md");
+		if (await fs.pathExists(agentsPath)) {
+			if (await fs.pathExists(claudePath)) await fs.remove(claudePath);
+			await fs.ensureSymlink("AGENTS.md", claudePath);
+		}
+	}
 }
-
-// src/utils/replace-placeholders.ts
-import path2 from "path";
-import fs2 from "fs-extra";
-var PLACEHOLDERS = {
-  __APP_NAME__: "name",
-  __APP_TITLE__: "title",
-  __DB_NAME__: "dbName",
-  __APP_NAME_UPPER__: "nameUpper",
-  __APP_NAME_SNAKE__: "nameSnake",
-  __REPO_NAME__: "repoName",
-  __REPO_NAME_SNAKE__: "repoNameSnake"
+//#endregion
+//#region src/utils/detect-monorepo.ts
+const NOT_FOUND = {
+	found: false,
+	rootDir: null,
+	workspacePatterns: [],
+	packageDir: null
+};
+/**
+* Walk up from `startDir` looking for pnpm-workspace.yaml.
+* If found, parse it and derive the package directory.
+*/
+async function detectMonorepo(startDir) {
+	let current = path.resolve(startDir);
+	const root = path.parse(current).root;
+	while (current !== root) {
+		const workspaceFile = path.join(current, "pnpm-workspace.yaml");
+		if (await fs.pathExists(workspaceFile)) try {
+			const parsed = parse(await fs.readFile(workspaceFile, "utf-8"));
+			if (!parsed?.packages || !Array.isArray(parsed.packages)) return NOT_FOUND;
+			const workspacePatterns = parsed.packages;
+			const firstPattern = workspacePatterns[0];
+			if (!firstPattern) return NOT_FOUND;
+			const baseDir = firstPattern.replace(/\/?\*.*$/, "").trim();
+			const packageDir = path.join(current, baseDir);
+			return {
+				found: true,
+				rootDir: current,
+				workspacePatterns,
+				packageDir
+			};
+		} catch {
+			return NOT_FOUND;
+		}
+		current = path.dirname(current);
+	}
+	return NOT_FOUND;
+}
+//#endregion
+//#region src/utils/env-local.ts
+/**
+* Writes .env.local for the webapp template with real generated values for
+* BETTER_AUTH_SECRET and ENCRYPTION_SECRET_KEY so the user can run dev/seed
+* immediately. Also writes deploy/ryvn/percepta-test.secrets.env with separate
+* generated values that can be imported into Ryvn for the deployed installation.
+* The .env.example file remains the documentation source.
+*
+* Each generated file is a no-op if it already exists.
+*/
+async function generateEnvLocal(packageDir) {
+	const examplePath = path.join(packageDir, ".env.example");
+	const localPath = path.join(packageDir, ".env.local");
+	if (!await fs.pathExists(examplePath)) return;
+	if (!await fs.pathExists(localPath)) {
+		const authSecret = randomBytes(32).toString("base64");
+		const encKey = randomBytes(16).toString("hex");
+		const content = (await fs.readFile(examplePath, "utf-8")).replace(/^BETTER_AUTH_SECRET=.*$/m, `BETTER_AUTH_SECRET=${authSecret}`).replace(/^ENCRYPTION_SECRET_KEY=.*$/m, `ENCRYPTION_SECRET_KEY=${encKey}`);
+		await fs.writeFile(localPath, content);
+	}
+	const ryvnSecretsPath = path.join(packageDir, "deploy", "ryvn", "percepta-test.secrets.env");
+	if (await fs.pathExists(ryvnSecretsPath)) return;
+	const deployAuthSecret = randomBytes(32).toString("base64");
+	const deployEncKey = randomBytes(16).toString("hex");
+	const deploySecrets = [
+		`BETTER_AUTH_SECRET=${deployAuthSecret}`,
+		`ENCRYPTION_SECRET_KEY=${deployEncKey}`,
+		"",
+		"# Langfuse and LLM demo credentials are inherited from the demos-commons Ryvn variable group.",
+		""
+	].join("\n");
+	await fs.ensureDir(path.dirname(ryvnSecretsPath));
+	await fs.writeFile(ryvnSecretsPath, deploySecrets);
+}
+//#endregion
+//#region src/utils/manifest.ts
+const MANIFEST_FILENAME = ".mosaic-template.json";
+function getManifestPath(dir) {
+	return path.join(dir, MANIFEST_FILENAME);
+}
+async function readManifest(dir) {
+	const manifestPath = getManifestPath(dir);
+	if (!await fs.pathExists(manifestPath)) throw new Error(`No ${MANIFEST_FILENAME} found in ${dir}. Run 'create init' to create one.`);
+	const content = await fs.readFile(manifestPath, "utf-8");
+	try {
+		return JSON.parse(content);
+	} catch (error) {
+		throw new Error(`Invalid JSON in ${MANIFEST_FILENAME}: ${error.message}`);
+	}
+}
+async function writeManifest(dir, manifest) {
+	const manifestPath = getManifestPath(dir);
+	await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+}
+async function manifestExists(dir) {
+	return fs.pathExists(getManifestPath(dir));
+}
+function derivePlaceholders(appName, appTitle, repoName = appName) {
+	const nameSnake = appName.replace(/-/g, "_");
+	const repoNameSnake = repoName.replace(/-/g, "_");
+	return {
+		__APP_NAME__: appName,
+		__APP_TITLE__: appTitle,
+		__DB_NAME__: nameSnake + "_db",
+		__APP_NAME_UPPER__: appName.toUpperCase(),
+		__APP_NAME_SNAKE__: nameSnake,
+		__REPO_NAME__: repoName,
+		__REPO_NAME_SNAKE__: repoNameSnake
+	};
+}
+function resolveMosaicTemplatePath(options) {
+	if (options.mosaicTemplatePath) return path.resolve(options.mosaicTemplatePath);
+	if (process.env.MOSAIC_TEMPLATE_PATH) return path.resolve(process.env.MOSAIC_TEMPLATE_PATH);
+	throw new Error("Mosaic repo path required. Use --mosaic-template-path or set MOSAIC_TEMPLATE_PATH.");
+}
+//#endregion
+//#region src/utils/validate.ts
+function validateProjectName(name) {
+	const result = validateNpmPackageName(name);
+	if (!result.validForNewPackages) return {
+		valid: false,
+		error: [...result.errors || [], ...result.warnings || []][0] || "Invalid package name"
+	};
+	return { valid: true };
+}
+//#endregion
+//#region src/utils/prompts.ts
+const VALID_PROJECT_TYPES = [
+	"monorepo",
+	"webapp",
+	"library"
+];
+function isValidProjectType(value) {
+	return typeof value === "string" && VALID_PROJECT_TYPES.includes(value);
+}
+async function promptName(message) {
+	const { name } = await inquirer.prompt([{
+		type: "input",
+		name: "name",
+		message,
+		filter: toKebabCase,
+		validate: (input) => {
+			const result = validateProjectName(toKebabCase(input));
+			return result.valid || result.error || "Invalid project name";
+		}
+	}]);
+	return name;
+}
+/**
+* Outside a monorepo we collect the repo name first, then ask a single
+* "is it a webapp?" Y/n. Yes (default) → monorepo + webapp, no → bare
+* monorepo. Library at the top level is rare enough that we leave it as a
+* `--type library` flag rather than a third prompt option. The repo name is
+* collected separately from any initial package name so a customer monorepo
+* is not forced to share its first app's name.
+*/
+async function promptOutsideMonorepoType() {
+	const { webapp } = await inquirer.prompt([{
+		type: "confirm",
+		name: "webapp",
+		message: "Initialize with a webapp?",
+		default: true
+	}]);
+	return webapp ? "webapp" : "monorepo";
+}
+/**
+* Inside a monorepo, both webapp and library are common, so present them as
+* a numbered rawlist — user presses 1 or 2 + Enter. Defaults to webapp.
+*/
+async function promptInsideMonorepoType() {
+	const { projectType } = await inquirer.prompt([{
+		type: "rawlist",
+		name: "projectType",
+		message: "What kind of package?",
+		default: "webapp",
+		choices: [{
+			name: "Webapp  — A Next.js webapp",
+			value: "webapp"
+		}, {
+			name: "Library — A TypeScript library",
+			value: "library"
+		}]
+	}]);
+	return projectType;
+}
+async function promptProjectDetails(defaults) {
+	const inMonorepo = defaults.monorepoContext?.found ?? false;
+	const cwd = defaults.cwd ?? process.cwd();
+	let projectType;
+	let finalName;
+	if (inMonorepo) {
+		projectType = defaults.projectType ?? await promptInsideMonorepoType();
+		await defaults.beforeNamePrompt?.(projectType);
+		finalName = defaults.name || await promptName("Package name?");
+	} else {
+		const repoName = defaults.repoName || (defaults.projectType === "monorepo" ? defaults.name : void 0) || await promptName("Repo name?");
+		const repoTitle = toTitleCase(repoName);
+		projectType = defaults.projectType ?? await promptOutsideMonorepoType();
+		await defaults.beforeNamePrompt?.(projectType);
+		if (projectType === "monorepo") {
+			finalName = repoName;
+			const finalTitle = repoTitle;
+			const finalDirectory = path.resolve(cwd, repoName);
+			return {
+				projectType,
+				directory: finalDirectory,
+				name: finalName,
+				title: finalTitle,
+				installDeps: !defaults.skipInstall,
+				monorepoName: repoName,
+				monorepoTitle: repoTitle
+			};
+		}
+		const packageNamePrompt = projectType === "webapp" ? "Webapp name?" : "Library name?";
+		finalName = defaults.name || await promptName(packageNamePrompt);
+		const finalTitle = toTitleCase(finalName);
+		const finalDirectory = path.resolve(cwd, repoName);
+		return {
+			projectType,
+			directory: finalDirectory,
+			name: finalName,
+			title: finalTitle,
+			installDeps: !defaults.skipInstall,
+			monorepoName: repoName,
+			monorepoTitle: repoTitle
+		};
+	}
+	const finalTitle = finalName ? toTitleCase(finalName) : "";
+	const finalDirectory = !inMonorepo && finalName ? path.resolve(cwd, finalName) : "";
+	return {
+		projectType,
+		directory: finalDirectory,
+		name: finalName,
+		title: finalTitle,
+		installDeps: !defaults.skipInstall
+	};
+}
+//#endregion
+//#region src/utils/relocate-workflows.ts
+/**
+* Moves per-app GitHub Actions workflows from the package's .github/workflows
+* directory to the monorepo root, where GitHub Actions actually picks them up.
+*
+* Only moves files whose names start with the app name (e.g.
+* `myapp-ryvn-release.yaml`). Generic workflows like `ci.yml` are left in
+* place — those are an unrelated monorepo-vs-package concern.
+*
+* Cleans up an empty `.github/workflows` (and empty parent `.github`) after
+* the move.
+*/
+async function relocateWorkflowsToRoot(packageDir, monorepoRoot, appName) {
+	const sourceDir = path.join(packageDir, ".github", "workflows");
+	if (!await fs.pathExists(sourceDir)) return;
+	const targetDir = path.join(monorepoRoot, ".github", "workflows");
+	await fs.ensureDir(targetDir);
+	const entries = await fs.readdir(sourceDir);
+	for (const name of entries) {
+		if (!name.startsWith(`${appName}-`)) continue;
+		if (!/\.(ya?ml)$/.test(name)) continue;
+		await fs.move(path.join(sourceDir, name), path.join(targetDir, name), { overwrite: true });
+	}
+	if ((await fs.readdir(sourceDir)).length === 0) {
+		await fs.rmdir(sourceDir);
+		const packageGithub = path.join(packageDir, ".github");
+		if ((await fs.readdir(packageGithub)).length === 0) await fs.rmdir(packageGithub);
+	}
+}
+//#endregion
+//#region src/utils/replace-placeholders.ts
+const PLACEHOLDERS = {
+	__APP_NAME__: "name",
+	__APP_TITLE__: "title",
+	__DB_NAME__: "dbName",
+	__APP_NAME_UPPER__: "nameUpper",
+	__APP_NAME_SNAKE__: "nameSnake",
+	__REPO_NAME__: "repoName",
+	__REPO_NAME_SNAKE__: "repoNameSnake"
 };
-var SKIP_DIRS2 = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".git",
-  ".next",
-  "dist",
-  ".turbo",
-  ".vercel"
+const SKIP_DIRS = new Set([
+	"node_modules",
+	".git",
+	".next",
+	"dist",
+	".turbo",
+	".vercel"
 ]);
-var SKIP_FILES2 = /* @__PURE__ */ new Set([
-  "pnpm-lock.yaml",
-  "package-lock.json",
-  "yarn.lock"
+const SKIP_FILES = new Set([
+	"pnpm-lock.yaml",
+	"package-lock.json",
+	"yarn.lock"
 ]);
-var PROCESSABLE_EXTENSIONS = /* @__PURE__ */ new Set([
-  ".ts",
-  ".tsx",
-  ".js",
-  ".jsx",
-  ".json",
-  ".yml",
-  ".yaml",
-  ".md",
-  ".env",
-  ".sql",
-  ".tf",
-  ".tfvars",
-  ".sh",
-  ".mjs",
-  ".cjs"
+const PROCESSABLE_EXTENSIONS = new Set([
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".json",
+	".yml",
+	".yaml",
+	".md",
+	".env",
+	".sql",
+	".tf",
+	".tfvars",
+	".sh",
+	".zed",
+	".mjs",
+	".cjs"
 ]);
-var PROCESSABLE_FILENAMES = /* @__PURE__ */ new Set([
-  "Dockerfile",
-  ".env.example",
-  ".env.local",
-  "terraform.tfvars.example"
+const PROCESSABLE_FILENAMES = new Set([
+	"Dockerfile",
+	".env.example",
+	".env.local",
+	"terraform.tfvars.example"
 ]);
 function shouldProcessFile(filePath) {
-  const fileName = path2.basename(filePath);
-  const ext = path2.extname(filePath);
-  if (SKIP_FILES2.has(fileName)) return false;
-  if (PROCESSABLE_FILENAMES.has(fileName)) return true;
-  return PROCESSABLE_EXTENSIONS.has(ext);
+	const fileName = path.basename(filePath);
+	const ext = path.extname(filePath);
+	if (SKIP_FILES.has(fileName)) return false;
+	if (PROCESSABLE_FILENAMES.has(fileName)) return true;
+	return PROCESSABLE_EXTENSIONS.has(ext);
 }
 async function replaceInFile(filePath, config) {
-  let content;
-  try {
-    content = await fs2.readFile(filePath, "utf-8");
-  } catch {
-    return false;
-  }
-  let modified = false;
-  let newContent = content;
-  const sortedEntries = Object.entries(PLACEHOLDERS).sort(
-    (a, b) => b[0].length - a[0].length
-  );
-  for (const [placeholder, configKey] of sortedEntries) {
-    const value = config[configKey];
-    if (newContent.includes(placeholder)) {
-      newContent = newContent.split(placeholder).join(value);
-      modified = true;
-    }
-  }
-  if (modified) {
-    await fs2.writeFile(filePath, newContent);
-    return true;
-  }
-  return false;
+	let content;
+	try {
+		content = await fs.readFile(filePath, "utf-8");
+	} catch {
+		return false;
+	}
+	let modified = false;
+	let newContent = content;
+	const sortedEntries = Object.entries(PLACEHOLDERS).sort((a, b) => b[0].length - a[0].length);
+	for (const [placeholder, configKey] of sortedEntries) {
+		const value = config[configKey];
+		if (newContent.includes(placeholder)) {
+			newContent = newContent.split(placeholder).join(value);
+			modified = true;
+		}
+	}
+	if (modified) {
+		await fs.writeFile(filePath, newContent);
+		return true;
+	}
+	return false;
 }
 function substituteName(name, config) {
-  const sortedEntries = Object.entries(PLACEHOLDERS).sort(
-    (a, b) => b[0].length - a[0].length
-  );
-  let result = name;
-  for (const [placeholder, configKey] of sortedEntries) {
-    if (result.includes(placeholder)) {
-      result = result.split(placeholder).join(
-        config[configKey]
-      );
-    }
-  }
-  return result;
+	const sortedEntries = Object.entries(PLACEHOLDERS).sort((a, b) => b[0].length - a[0].length);
+	let result = name;
+	for (const [placeholder, configKey] of sortedEntries) if (result.includes(placeholder)) result = result.split(placeholder).join(config[configKey]);
+	return result;
 }
 async function processDirectory(dirPath, config, stats) {
-  const entries = await fs2.readdir(dirPath, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path2.join(dirPath, entry.name);
-    if (entry.isDirectory()) {
-      if (!SKIP_DIRS2.has(entry.name)) {
-        await processDirectory(fullPath, config, stats);
-      }
-    } else if (entry.isFile() && shouldProcessFile(fullPath)) {
-      stats.processed++;
-      if (await replaceInFile(fullPath, config)) {
-        stats.modified++;
-      }
-      const renamed = substituteName(entry.name, config);
-      if (renamed !== entry.name) {
-        await fs2.move(fullPath, path2.join(dirPath, renamed), {
-          overwrite: true
-        });
-      }
-    }
-  }
+	const entries = await fs.readdir(dirPath, { withFileTypes: true });
+	for (const entry of entries) {
+		const fullPath = path.join(dirPath, entry.name);
+		if (entry.isDirectory()) {
+			if (!SKIP_DIRS.has(entry.name)) await processDirectory(fullPath, config, stats);
+		} else if (entry.isFile() && shouldProcessFile(fullPath)) {
+			stats.processed++;
+			if (await replaceInFile(fullPath, config)) stats.modified++;
+			const renamed = substituteName(entry.name, config);
+			if (renamed !== entry.name) await fs.move(fullPath, path.join(dirPath, renamed), { overwrite: true });
+		}
+	}
 }
 async function replacePlaceholders(targetDir, config) {
-  const stats = { processed: 0, modified: 0 };
-  await processDirectory(targetDir, config, stats);
-  return stats;
-}
-
-// src/utils/detect-monorepo.ts
-import path3 from "path";
-import fs3 from "fs-extra";
-import { parse } from "yaml";
-var NOT_FOUND = {
-  found: false,
-  rootDir: null,
-  workspacePatterns: [],
-  packageDir: null
-};
-async function detectMonorepo(startDir) {
-  let current = path3.resolve(startDir);
-  const root = path3.parse(current).root;
-  while (current !== root) {
-    const workspaceFile = path3.join(current, "pnpm-workspace.yaml");
-    if (await fs3.pathExists(workspaceFile)) {
-      try {
-        const content = await fs3.readFile(workspaceFile, "utf-8");
-        const parsed = parse(content);
-        if (!parsed?.packages || !Array.isArray(parsed.packages)) {
-          return NOT_FOUND;
-        }
-        const workspacePatterns = parsed.packages;
-        const firstPattern = workspacePatterns[0];
-        if (!firstPattern) {
-          return NOT_FOUND;
-        }
-        const baseDir = firstPattern.replace(/\/?\*.*$/, "").trim();
-        const packageDir = path3.join(current, baseDir);
-        return {
-          found: true,
-          rootDir: current,
-          workspacePatterns,
-          packageDir
-        };
-      } catch {
-        return NOT_FOUND;
-      }
-    }
-    current = path3.dirname(current);
-  }
-  return NOT_FOUND;
-}
-
-// src/utils/env-local.ts
-import path4 from "path";
-import { randomBytes } from "crypto";
-import fs4 from "fs-extra";
-async function generateEnvLocal(packageDir) {
-  const examplePath = path4.join(packageDir, ".env.example");
-  const localPath = path4.join(packageDir, ".env.local");
-  if (!await fs4.pathExists(examplePath)) return;
-  if (!await fs4.pathExists(localPath)) {
-    const authSecret = randomBytes(32).toString("base64");
-    const encKey = randomBytes(16).toString("hex");
-    const content = (await fs4.readFile(examplePath, "utf-8")).replace(/^BETTER_AUTH_SECRET=.*$/m, `BETTER_AUTH_SECRET=${authSecret}`).replace(/^ENCRYPTION_SECRET_KEY=.*$/m, `ENCRYPTION_SECRET_KEY=${encKey}`);
-    await fs4.writeFile(localPath, content);
-  }
-  const ryvnSecretsPath = path4.join(
-    packageDir,
-    "deploy",
-    "ryvn",
-    "percepta-test.secrets.env"
-  );
-  if (await fs4.pathExists(ryvnSecretsPath)) return;
-  const deployAuthSecret = randomBytes(32).toString("base64");
-  const deployEncKey = randomBytes(16).toString("hex");
-  const deploySecrets = [
-    `BETTER_AUTH_SECRET=${deployAuthSecret}`,
-    `ENCRYPTION_SECRET_KEY=${deployEncKey}`,
-    "",
-    "# Langfuse and LLM demo credentials are inherited from the demos-commons Ryvn variable group.",
-    ""
-  ].join("\n");
-  await fs4.ensureDir(path4.dirname(ryvnSecretsPath));
-  await fs4.writeFile(ryvnSecretsPath, deploySecrets);
-}
-
-// src/utils/relocate-workflows.ts
-import path5 from "path";
-import fs5 from "fs-extra";
-async function relocateWorkflowsToRoot(packageDir, monorepoRoot, appName) {
-  const sourceDir = path5.join(packageDir, ".github", "workflows");
-  if (!await fs5.pathExists(sourceDir)) return;
-  const targetDir = path5.join(monorepoRoot, ".github", "workflows");
-  await fs5.ensureDir(targetDir);
-  const entries = await fs5.readdir(sourceDir);
-  for (const name of entries) {
-    if (!name.startsWith(`${appName}-`)) continue;
-    if (!/\.(ya?ml)$/.test(name)) continue;
-    await fs5.move(path5.join(sourceDir, name), path5.join(targetDir, name), {
-      overwrite: true
-    });
-  }
-  if ((await fs5.readdir(sourceDir)).length === 0) {
-    await fs5.rmdir(sourceDir);
-    const packageGithub = path5.join(packageDir, ".github");
-    if ((await fs5.readdir(packageGithub)).length === 0) {
-      await fs5.rmdir(packageGithub);
-    }
-  }
+	const stats = {
+		processed: 0,
+		modified: 0
+	};
+	await processDirectory(targetDir, config, stats);
+	return stats;
 }
-
-// src/utils/resolve-percepta-versions.ts
-import path6 from "path";
-import { execFile } from "child_process";
-import { promisify } from "util";
-import fs6 from "fs-extra";
-var execFileAsync = promisify(execFile);
-var DEPENDENCY_SECTIONS = [
-  "dependencies",
-  "devDependencies",
-  "optionalDependencies",
-  "peerDependencies"
+//#endregion
+//#region src/utils/resolve-percepta-versions.ts
+const execFileAsync = promisify(execFile);
+const DEPENDENCY_SECTIONS = [
+	"dependencies",
+	"devDependencies",
+	"optionalDependencies",
+	"peerDependencies"
 ];
 function getPerceptaPackages(pkg) {
-  const names = /* @__PURE__ */ new Set();
-  for (const section of DEPENDENCY_SECTIONS) {
-    const deps = pkg[section];
-    if (!deps) continue;
-    for (const name of Object.keys(deps)) {
-      if (name.startsWith("@percepta/")) {
-        names.add(name);
-      }
-    }
-  }
-  return [...names].sort();
+	const names = /* @__PURE__ */ new Set();
+	for (const section of DEPENDENCY_SECTIONS) {
+		const deps = pkg[section];
+		if (!deps) continue;
+		for (const name of Object.keys(deps)) if (name.startsWith("@percepta/")) names.add(name);
+	}
+	return [...names].sort();
 }
 async function npmViewDistTagLatest(packageName, cwd) {
-  const { stdout } = await execFileAsync(
-    "npm",
-    ["view", packageName, "dist-tags.latest", "--silent"],
-    {
-      cwd,
-      encoding: "utf8",
-      timeout: 5e3
-    }
-  );
-  const version = stdout.trim();
-  return version.length > 0 ? version : null;
+	const { stdout } = await execFileAsync("npm", [
+		"view",
+		packageName,
+		"dist-tags.latest",
+		"--silent"
+	], {
+		cwd,
+		encoding: "utf8",
+		timeout: 5e3
+	});
+	const version = stdout.trim();
+	return version.length > 0 ? version : null;
 }
 async function resolvePerceptaVersionsInPackageJson(packageJsonPath, lookupLatest = npmViewDistTagLatest) {
-  const cwd = path6.dirname(packageJsonPath);
-  const pkg = await fs6.readJson(packageJsonPath);
-  const packageNames = getPerceptaPackages(pkg);
-  const resolved = {};
-  const failed = [];
-  const results = await Promise.all(
-    packageNames.map(async (packageName) => {
-      try {
-        return {
-          packageName,
-          latest: await lookupLatest(packageName, cwd)
-        };
-      } catch {
-        return { packageName, latest: null };
-      }
-    })
-  );
-  for (const { packageName, latest } of results) {
-    if (!latest) {
-      failed.push(packageName);
-      continue;
-    }
-    resolved[packageName] = latest;
-    for (const section of DEPENDENCY_SECTIONS) {
-      const deps = pkg[section];
-      if (deps?.[packageName]) {
-        deps[packageName] = latest;
-      }
-    }
-  }
-  if (Object.keys(resolved).length > 0) {
-    await fs6.writeJson(packageJsonPath, pkg, { spaces: 2 });
-    await fs6.appendFile(packageJsonPath, "\n");
-  }
-  return { resolved, failed };
+	const cwd = path.dirname(packageJsonPath);
+	const pkg = await fs.readJson(packageJsonPath);
+	const packageNames = getPerceptaPackages(pkg);
+	const resolved = {};
+	const failed = [];
+	const results = await Promise.all(packageNames.map(async (packageName) => {
+		try {
+			return {
+				packageName,
+				latest: await lookupLatest(packageName, cwd)
+			};
+		} catch {
+			return {
+				packageName,
+				latest: null
+			};
+		}
+	}));
+	for (const { packageName, latest } of results) {
+		if (!latest) {
+			failed.push(packageName);
+			continue;
+		}
+		resolved[packageName] = latest;
+		for (const section of DEPENDENCY_SECTIONS) {
+			const deps = pkg[section];
+			if (deps?.[packageName]) deps[packageName] = latest;
+		}
+	}
+	if (Object.keys(resolved).length > 0) {
+		await fs.writeJson(packageJsonPath, pkg, { spaces: 2 });
+		await fs.appendFile(packageJsonPath, "\n");
+	}
+	return {
+		resolved,
+		failed
+	};
 }
-
-// src/commands/create.ts
-var PACKAGE_MANAGER = "pnpm";
+//#endregion
+//#region src/utils/template-versions.ts
+const FALLBACK_TEMPLATE_VERSION = "1.0.0";
+function readTemplateVersions() {
+	const currentDir = path.dirname(fileURLToPath(import.meta.url));
+	const candidates = [path.resolve(currentDir, "../template-versions.json"), path.resolve(currentDir, "../../template-versions.json")];
+	for (const versionsPath of candidates) try {
+		const content = fs.readFileSync(versionsPath, "utf-8");
+		return JSON.parse(content);
+	} catch {}
+	return {};
+}
+function getTemplateVersion(templateType) {
+	return readTemplateVersions()[templateType] ?? FALLBACK_TEMPLATE_VERSION;
+}
+//#endregion
+//#region src/commands/create.ts
+const PACKAGE_MANAGER = "pnpm";
+/** Paths in copy-paste shell commands (POSIX-style). */
 function shPath(p) {
-  return p.split(path7.sep).join("/");
+	return p.split(path.sep).join("/");
 }
+/** Non-blocking install so ora can animate (execSync would block timers). */
 function runPackageManagerInstall(packageManager, cwd, args = ["install"]) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(packageManager, args, {
-      cwd,
-      stdio: "ignore"
-    });
-    child.on("error", reject);
-    child.on("close", (code) => {
-      if (code === 0) resolve();
-      else
-        reject(
-          new Error(
-            `${packageManager} ${args.join(" ")} exited with code ${code ?? "unknown"}`
-          )
-        );
-    });
-  });
+	return new Promise((resolve, reject) => {
+		const child = spawn(packageManager, args, {
+			cwd,
+			stdio: "ignore"
+		});
+		child.on("error", reject);
+		child.on("close", (code) => {
+			if (code === 0) resolve();
+			else reject(/* @__PURE__ */ new Error(`${packageManager} ${args.join(" ")} exited with code ${code ?? "unknown"}`));
+		});
+	});
 }
-function runWebappSetup(packageManager, cwd) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(packageManager, ["run", "setup"], { cwd, stdio: "inherit" });
-    child.on("error", reject);
-    child.on("close", (code) => {
-      if (code === 0) resolve();
-      else reject(new Error(`${packageManager} run setup exited with code ${code ?? "unknown"}`));
-    });
-  });
+/**
+* Runs the monorepo-root `setup` script (docker + access + db + seed).
+* Uses `pnpm run setup` (not `pnpm setup`) because `pnpm setup` is a pnpm builtin that configures
+* PNPM_HOME in the user's shell rc — it ignores the package.json script of the same name.
+*/
+function runWebappSetup(packageManager, monorepoRoot) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(packageManager, ["run", "setup"], {
+			cwd: monorepoRoot,
+			stdio: "inherit"
+		});
+		child.on("error", reject);
+		child.on("close", (code) => {
+			if (code === 0) resolve();
+			else reject(/* @__PURE__ */ new Error(`${packageManager} run setup exited with code ${code ?? "unknown"}`));
+		});
+	});
 }
-var ANSI_PATTERN = /\x1b\[[0-9;]*[a-zA-Z]/g;
+/**
+* Spawns `pnpm dev` in the package directory and resolves once Next reports
+* "Ready in" (so we know the server is accepting requests). Returns the child
+* process so the caller can await its exit when the user hits Ctrl+C.
+*
+* Captures the actual URL Next picked (Next falls back to 3001+ if 3000 is
+* taken) so the caller can open the right one in the browser.
+*/
+const ANSI_PATTERN = /\u001b\[[0-9;]*[a-zA-Z]/g;
 function spawnDevServer(packageManager, cwd) {
-  const child = spawn(packageManager, ["run", "dev"], {
-    cwd,
-    stdio: ["inherit", "pipe", "pipe"]
-  });
-  const ready = new Promise((resolve, reject) => {
-    let resolved = false;
-    let detectedUrl = "http://localhost:3000";
-    let buffer = "";
-    const onChunk = (chunk) => {
-      const text = chunk.toString();
-      process.stdout.write(text);
-      buffer = (buffer + text).slice(-4096).replace(ANSI_PATTERN, "");
-      const urlMatch = buffer.match(/Local:\s+(https?:\/\/\S+?)(?:\s|$)/i);
-      if (urlMatch?.[1]) detectedUrl = urlMatch[1].trim();
-      if (!resolved && /Ready in /i.test(buffer)) {
-        resolved = true;
-        resolve({ url: detectedUrl });
-      }
-    };
-    child.stdout?.on("data", onChunk);
-    child.stderr?.on("data", (chunk) => process.stderr.write(chunk));
-    child.on("error", reject);
-    child.on("close", (code) => {
-      if (!resolved) {
-        reject(new Error(`${packageManager} run dev exited with code ${code ?? "unknown"} before becoming ready`));
-      }
-    });
-  });
-  return { child, ready };
+	const child = spawn(packageManager, ["run", "dev"], {
+		cwd,
+		stdio: [
+			"inherit",
+			"pipe",
+			"pipe"
+		]
+	});
+	return {
+		child,
+		ready: new Promise((resolve, reject) => {
+			let resolved = false;
+			let detectedUrl = "http://localhost:3000";
+			let buffer = "";
+			const onChunk = (chunk) => {
+				const text = chunk.toString();
+				process.stdout.write(text);
+				buffer = (buffer + text).slice(-4096).replace(ANSI_PATTERN, "");
+				const urlMatch = buffer.match(/Local:\s+(https?:\/\/\S+?)(?:\s|$)/i);
+				if (urlMatch?.[1]) detectedUrl = urlMatch[1].trim();
+				if (!resolved && /Ready in /i.test(buffer)) {
+					resolved = true;
+					resolve({ url: detectedUrl });
+				}
+			};
+			child.stdout?.on("data", onChunk);
+			child.stderr?.on("data", (chunk) => process.stderr.write(chunk));
+			child.on("error", reject);
+			child.on("close", (code) => {
+				if (!resolved) reject(/* @__PURE__ */ new Error(`${packageManager} run dev exited with code ${code ?? "unknown"} before becoming ready`));
+			});
+		})
+	};
 }
+/**
+* Cross-platform "open this URL in the user's default browser". Returns true
+* if the launcher process spawned, false on synchronous failure. The empty
+* `error` listener swallows the asynchronous error event that fires when the
+* launcher binary is missing (e.g. minimal Linux without `xdg-open`) — without
+* it, that event becomes an uncaught exception that kills the CLI mid-run.
+*/
 function openInBrowser(url) {
-  const cmd = process.platform === "darwin" ? ["open", url] : process.platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
-  try {
-    const child = spawn(cmd[0], cmd.slice(1), { stdio: "ignore", detached: true });
-    child.on("error", () => {
-    });
-    child.unref();
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function autoRunWebapp(packageDir) {
-  const packageManager = PACKAGE_MANAGER;
-  console.log();
-  console.log(chalk.bold("Running setup (docker, db, seed)..."));
-  console.log();
-  try {
-    await runWebappSetup(packageManager, packageDir);
-  } catch (error) {
-    console.log();
-    console.log(
-      chalk.yellow("!"),
-      "Setup failed. You can re-run it manually:",
-      chalk.cyan(`cd ${packageDir} && ${packageManager} run setup`)
-    );
-    console.log(chalk.dim(error.message));
-    return false;
-  }
-  console.log();
-  console.log(chalk.bold("Starting dev server..."));
-  console.log();
-  const { child, ready } = spawnDevServer(packageManager, packageDir);
-  const closed = new Promise((resolve) => {
-    child.on("close", () => resolve());
-  });
-  let url = "http://localhost:3000";
-  try {
-    ({ url } = await ready);
-  } catch (error) {
-    console.log();
-    console.log(chalk.yellow("!"), "Dev server failed to become ready.");
-    console.log(chalk.dim(error.message));
-    return false;
-  }
-  if (openInBrowser(url)) {
-    console.log();
-    console.log(chalk.green("\u2714"), "Opened", chalk.cyan(url));
-  } else {
-    console.log();
-    console.log(chalk.dim("Open"), chalk.cyan(url), chalk.dim("in your browser."));
-  }
-  await closed;
-  return true;
+	const cmd = process.platform === "darwin" ? ["open", url] : process.platform === "win32" ? [
+		"cmd",
+		"/c",
+		"start",
+		"",
+		url
+	] : ["xdg-open", url];
+	try {
+		const child = spawn(cmd[0], cmd.slice(1), {
+			stdio: "ignore",
+			detached: true
+		});
+		child.on("error", () => {});
+		child.unref();
+		return true;
+	} catch {
+		return false;
+	}
 }
-function readTemplateVersions() {
-  const versionsPath = path7.resolve(
-    path7.dirname(fileURLToPath2(import.meta.url)),
-    "../template-versions.json"
-  );
-  try {
-    const content = fs7.readFileSync(versionsPath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return {};
-  }
+/**
+* Post-scaffold orchestration for webapps: run root setup (docker + access + db + seed),
+* start the dev server, open the served URL in the user's browser, then hand
+* control to the dev server until the user exits with Ctrl+C.
+*
+* Returns true if the dev server got running (caller should NOT print next
+* steps in that case — the user is already in the running app). Returns
+* false on any failure so the caller can print manual fallback steps.
+*
+* Callers should only invoke this when install actually succeeded —
+* starting setup without node_modules will leave an orphan Docker container.
+*/
+async function autoRunWebapp(packageDir, monorepoRoot) {
+	const packageManager = PACKAGE_MANAGER;
+	console.log();
+	console.log(chalk.bold("Running setup (docker, access, db, seed)..."));
+	console.log();
+	try {
+		await runWebappSetup(packageManager, monorepoRoot);
+	} catch (error) {
+		console.log();
+		console.log(chalk.yellow("!"), "Setup failed. You can re-run it manually:", chalk.cyan(`cd ${monorepoRoot} && ${packageManager} run setup`));
+		console.log(chalk.dim(error.message));
+		return false;
+	}
+	console.log();
+	console.log(chalk.bold("Starting dev server..."));
+	console.log();
+	const { child, ready } = spawnDevServer(packageManager, packageDir);
+	const closed = new Promise((resolve) => {
+		child.on("close", () => resolve());
+	});
+	let url = "http://localhost:3000";
+	try {
+		({url} = await ready);
+	} catch (error) {
+		console.log();
+		console.log(chalk.yellow("!"), "Dev server failed to become ready.");
+		console.log(chalk.dim(error.message));
+		return false;
+	}
+	if (openInBrowser(url)) {
+		console.log();
+		console.log(chalk.green("✔"), "Opened", chalk.cyan(url));
+	} else {
+		console.log();
+		console.log(chalk.dim("Open"), chalk.cyan(url), chalk.dim("in your browser."));
+	}
+	await closed;
+	return true;
 }
 async function writeMosaicFiles(packageDir, config, projectType) {
-  const templateVersions = readTemplateVersions();
-  const manifest = {
-    templateType: projectType,
-    templateVersion: templateVersions[projectType] || "1.0.0",
-    templateCommit: "npm",
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    placeholders: derivePlaceholders(config.name, config.title, config.repoName),
-    source: {
-      templatePath: `packages/create-mosaic-module/templates/${projectType}`
-    }
-  };
-  await writeManifest(packageDir, manifest);
-  const notesPath = path7.join(packageDir, "mosaic-template-notes.md");
-  await fs7.writeFile(
-    notesPath,
-    `# Mosaic Divergence Notes
-
-Document intentional differences from the ${projectType} template here.
-Claude reads this file during sync to preserve your customizations.
-
-## Intentional Divergences
-
-_None yet \u2014 freshly created from template._
-`
-  );
+	await writeManifest(packageDir, {
+		templateType: projectType,
+		templateVersion: getTemplateVersion(projectType),
+		templateCommit: "npm",
+		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+		placeholders: derivePlaceholders(config.name, config.title, config.repoName),
+		source: { templatePath: `packages/create-mosaic-module/templates/${projectType}` }
+	});
+	const notesPath = path.join(packageDir, "mosaic-template-notes.md");
+	await fs.writeFile(notesPath, `# Mosaic Divergence Notes\n\nDocument intentional differences from the ${projectType} template here.\nClaude reads this file during sync to preserve your customizations.\n\n## Intentional Divergences\n\n_None yet — freshly created from template._\n`);
 }
 function buildAppConfig(name, title = toTitleCase(name), repoName = name) {
-  return {
-    name,
-    title,
-    dbName: `${toSnakeCase(name)}_db`,
-    nameUpper: name.toUpperCase(),
-    nameSnake: toSnakeCase(name),
-    repoName,
-    repoNameSnake: toSnakeCase(repoName)
-  };
+	return {
+		name,
+		title,
+		dbName: `${toSnakeCase(name)}_db`,
+		nameUpper: name.toUpperCase(),
+		nameSnake: toSnakeCase(name),
+		repoName,
+		repoNameSnake: toSnakeCase(repoName)
+	};
 }
+/** Copy the monorepo template into `targetDir` and replace its placeholders. */
 async function scaffoldMonorepo(targetDir, config) {
-  const monoSpinner = ora("Copying monorepo template...").start();
-  try {
-    await copyTemplate(targetDir, "monorepo");
-    monoSpinner.succeed("Copied monorepo template");
-  } catch (error) {
-    monoSpinner.fail("Failed to copy monorepo template");
-    console.error(error);
-    process.exit(1);
-  }
-  const replaceSpinner = ora("Replacing monorepo placeholders...").start();
-  try {
-    const stats = await replacePlaceholders(targetDir, config);
-    replaceSpinner.succeed(
-      `Replaced placeholders in ${stats.modified} monorepo files`
-    );
-  } catch (error) {
-    replaceSpinner.fail("Failed to replace monorepo placeholders");
-    console.error(error);
-    process.exit(1);
-  }
+	const monoSpinner = ora("Copying monorepo template...").start();
+	try {
+		await copyTemplate(targetDir, "monorepo");
+		monoSpinner.succeed("Copied monorepo template");
+	} catch (error) {
+		monoSpinner.fail("Failed to copy monorepo template");
+		console.error(error);
+		process.exit(1);
+	}
+	const replaceSpinner = ora("Replacing monorepo placeholders...").start();
+	try {
+		const stats = await replacePlaceholders(targetDir, config);
+		replaceSpinner.succeed(`Replaced placeholders in ${stats.modified} monorepo files`);
+	} catch (error) {
+		replaceSpinner.fail("Failed to replace monorepo placeholders");
+		console.error(error);
+		process.exit(1);
+	}
 }
+/**
+* Add a package (webapp or library) to a monorepo: copy the template into
+* `packageDir`, replace placeholders, write the Mosaic manifest, and run the
+* webapp-only post-copy steps (.env.local, workflow relocation) when applicable.
+*/
 async function addPackageToMonorepo(args) {
-  const { packageDir, monorepoRoot, projectType, config } = args;
-  const copySpinner = ora("Copying package template...").start();
-  try {
-    await copyTemplate(packageDir, projectType);
-    copySpinner.succeed("Copied package template");
-  } catch (error) {
-    copySpinner.fail("Failed to copy package template");
-    console.error(error);
-    process.exit(1);
-  }
-  const replaceSpinner = ora("Replacing package placeholders...").start();
-  try {
-    const stats = await replacePlaceholders(packageDir, config);
-    replaceSpinner.succeed(
-      `Replaced placeholders in ${stats.modified} package files`
-    );
-  } catch (error) {
-    replaceSpinner.fail("Failed to replace package placeholders");
-    console.error(error);
-    process.exit(1);
-  }
-  await writeMosaicFiles(packageDir, config, projectType);
-  if (projectType === "webapp") {
-    await resolvePerceptaPackageVersions(packageDir);
-    await generateEnvLocal(packageDir);
-    await relocateWorkflowsToRoot(packageDir, monorepoRoot, config.name);
-  }
+	const { packageDir, monorepoRoot, projectType, config } = args;
+	const copySpinner = ora("Copying package template...").start();
+	try {
+		await copyTemplate(packageDir, projectType);
+		copySpinner.succeed("Copied package template");
+	} catch (error) {
+		copySpinner.fail("Failed to copy package template");
+		console.error(error);
+		process.exit(1);
+	}
+	const replaceSpinner = ora("Replacing package placeholders...").start();
+	try {
+		const stats = await replacePlaceholders(packageDir, config);
+		replaceSpinner.succeed(`Replaced placeholders in ${stats.modified} package files`);
+	} catch (error) {
+		replaceSpinner.fail("Failed to replace package placeholders");
+		console.error(error);
+		process.exit(1);
+	}
+	await writeMosaicFiles(packageDir, config, projectType);
+	if (projectType === "webapp") {
+		await resolvePerceptaPackageVersions(packageDir);
+		await generateEnvLocal(packageDir);
+		await relocateWorkflowsToRoot(packageDir, monorepoRoot, config.name);
+	}
 }
 async function resolvePerceptaPackageVersions(packageDir) {
-  const packageJsonPath = path7.join(packageDir, "package.json");
-  if (!await fs7.pathExists(packageJsonPath)) return;
-  const spinner = ora("Resolving latest @percepta/* versions...").start();
-  try {
-    const result = await resolvePerceptaVersionsInPackageJson(packageJsonPath);
-    const count = Object.keys(result.resolved).length;
-    if (result.failed.length > 0) {
-      spinner.warn(
-        `Resolved ${count} @percepta/* versions; kept existing ranges for ${result.failed.join(", ")}`
-      );
-    } else {
-      spinner.succeed(`Resolved ${count} @percepta/* versions`);
-    }
-  } catch (error) {
-    spinner.warn(
-      "Could not resolve latest @percepta/* versions; kept template ranges"
-    );
-    console.log(chalk.dim(error.message));
-  }
+	const packageJsonPath = path.join(packageDir, "package.json");
+	if (!await fs.pathExists(packageJsonPath)) return;
+	const spinner = ora("Resolving latest @percepta/* versions...").start();
+	try {
+		const result = await resolvePerceptaVersionsInPackageJson(packageJsonPath);
+		const count = Object.keys(result.resolved).length;
+		if (result.failed.length > 0) spinner.warn(`Resolved ${count} @percepta/* versions; kept existing ranges for ${result.failed.join(", ")}`);
+		else spinner.succeed(`Resolved ${count} @percepta/* versions`);
+	} catch (error) {
+		spinner.warn("Could not resolve latest @percepta/* versions; kept template ranges");
+		console.log(chalk.dim(error.message));
+	}
 }
+/** Initialize a git repo at `targetDir` with an initial commit. Best-effort. */
 function initGitRepo(targetDir) {
-  const gitSpinner = ora("Initializing git repository...").start();
-  try {
-    execSync("git init", { cwd: targetDir, stdio: "ignore" });
-    execSync("git add -A", { cwd: targetDir, stdio: "ignore" });
-    execSync('git commit -m "Initial commit from @percepta/create"', {
-      cwd: targetDir,
-      stdio: "ignore"
-    });
-    gitSpinner.succeed("Initialized git repository");
-  } catch {
-    gitSpinner.warn("Failed to initialize git repository");
-  }
+	const gitSpinner = ora("Initializing git repository...").start();
+	try {
+		execSync("git init", {
+			cwd: targetDir,
+			stdio: "ignore"
+		});
+		execSync("git add -A", {
+			cwd: targetDir,
+			stdio: "ignore"
+		});
+		execSync("git commit -m \"Initial commit from @percepta/create\"", {
+			cwd: targetDir,
+			stdio: "ignore"
+		});
+		gitSpinner.succeed("Initialized git repository");
+	} catch {
+		gitSpinner.warn("Failed to initialize git repository");
+	}
 }
+/**
+* Run `pnpm install` at the monorepo root with a spinner. Returns true if
+* install ran successfully; false if it failed or was skipped.
+*/
 async function installAtMonorepoRoot(monorepoRoot, installDeps) {
-  if (!installDeps) return false;
-  const spinner = ora(
-    `Installing dependencies with ${PACKAGE_MANAGER}...`
-  ).start();
-  try {
-    await runPackageManagerInstall(PACKAGE_MANAGER, monorepoRoot);
-    spinner.succeed("Installed dependencies");
-    return true;
-  } catch {
-    spinner.warn(
-      `Failed to install dependencies. Run '${PACKAGE_MANAGER} install' from monorepo root.`
-    );
-    return false;
-  }
+	if (!installDeps) return false;
+	const spinner = ora(`Installing dependencies with ${PACKAGE_MANAGER}...`).start();
+	try {
+		await runPackageManagerInstall(PACKAGE_MANAGER, monorepoRoot);
+		spinner.succeed("Installed dependencies");
+		return true;
+	} catch {
+		spinner.warn(`Failed to install dependencies. Run '${PACKAGE_MANAGER} install' from monorepo root.`);
+		return false;
+	}
 }
-async function maybeAutoRunWebapp(packageDir, projectType, installSucceeded) {
-  if (!packageDir || projectType !== "webapp" || !installSucceeded) return false;
-  return autoRunWebapp(packageDir);
+/**
+* For webapp scaffolds with a successful install, hand off to autoRunWebapp
+* (setup → dev → open browser). No-op otherwise. Returns true if the dev
+* server actually started — caller skips manual next-steps in that case.
+*
+* Gated on `installSucceeded` because starting setup without node_modules
+* leaves an orphan Docker container.
+*/
+async function maybeAutoRunWebapp(packageDir, monorepoRoot, projectType, installSucceeded) {
+	if (!packageDir || projectType !== "webapp" || !installSucceeded) return false;
+	return autoRunWebapp(packageDir, monorepoRoot);
 }
 function getProjectTypeLabel(projectType) {
-  switch (projectType) {
-    case "monorepo":
-      return "pnpm monorepo";
-    case "webapp":
-      return "Next.js webapp";
-    case "library":
-      return "TypeScript library";
-    default: {
-      const exhaustiveCheck = projectType;
-      throw new Error(`Unknown project type: ${exhaustiveCheck}`);
-    }
-  }
+	switch (projectType) {
+		case "monorepo": return "pnpm monorepo";
+		case "webapp": return "Next.js webapp";
+		case "library": return "TypeScript library";
+		default: throw new Error(`Unknown project type: ${String(projectType)}`);
+	}
 }
 function requireNpmTokenForWebappInstall(projectType, installDeps) {
-  if (projectType !== "webapp" || !installDeps || process.env.NPM_TOKEN) {
-    return;
-  }
-  console.log();
-  console.error(chalk.red("Error: NPM_TOKEN environment variable is not set."));
-  console.error(
-    chalk.dim("  Required to install private @percepta/* packages.")
-  );
-  console.error();
-  console.error("  1. Grab the npm token from 1Password:");
-  console.error(
-    chalk.cyan(
-      "     https://start.1password.com/open/i?a=5TX2B4O3QNE4FNQ2A7ZJZDRRBI&v=j7trpyuqh7gt635dtuj6y4pwjm&i=cmmdi5trji7ctkn3fseakf4mgi&h=aitco.1password.com"
-    )
-  );
-  console.error("  2. Add to ~/.zshrc:");
-  console.error(chalk.cyan('     export NPM_TOKEN="<paste-token>"'));
-  console.error(
-    "  3. Open a new terminal (or " + chalk.cyan("source ~/.zshrc") + ") and re-run."
-  );
-  console.error();
-  console.error(
-    chalk.dim(
-      "  Or pass --skip-install to scaffold without running install."
-    )
-  );
-  process.exit(1);
+	if (projectType !== "webapp" || !installDeps || process.env.NPM_TOKEN) return;
+	console.log();
+	console.error(chalk.red("Error: NPM_TOKEN environment variable is not set."));
+	console.error(chalk.dim("  Required to install private @percepta/* packages."));
+	console.error();
+	console.error("  1. Grab the npm token from 1Password:");
+	console.error(chalk.cyan("     https://start.1password.com/open/i?a=5TX2B4O3QNE4FNQ2A7ZJZDRRBI&v=j7trpyuqh7gt635dtuj6y4pwjm&i=cmmdi5trji7ctkn3fseakf4mgi&h=aitco.1password.com"));
+	console.error("  2. Add to ~/.zshrc:");
+	console.error(chalk.cyan("     export NPM_TOKEN=\"<paste-token>\""));
+	console.error("  3. Open a new terminal (or " + chalk.cyan("source ~/.zshrc") + ") and re-run.");
+	console.error();
+	console.error(chalk.dim("  Or pass --skip-install to scaffold without running install."));
+	process.exit(1);
 }
 async function createProject(options) {
-  const cwd = await resolveCreateCwd(options.cwd);
-  if (options.type !== void 0 && !isValidProjectType(options.type)) {
-    console.error(
-      chalk.red(
-        `Error: Invalid package type "${options.type}". Valid types are: ${VALID_PROJECT_TYPES.join(", ")}`
-      )
-    );
-    process.exit(1);
-  }
-  console.log();
-  console.log(chalk.bold("Creating a new Mosaic package..."));
-  console.log();
-  const monorepoContext = await detectMonorepo(cwd);
-  if (options.type === "monorepo" && monorepoContext.found) {
-    console.error(
-      chalk.red(
-        `Error: Already inside a monorepo at ${monorepoContext.rootDir}. Choose 'webapp' or 'library' to add a package, or run from outside the monorepo.`
-      )
-    );
-    process.exit(1);
-  }
-  if (monorepoContext.found) {
-    console.log(
-      chalk.dim("  Detected monorepo at"),
-      chalk.cyan(monorepoContext.rootDir)
-    );
-  } else {
-    console.log(
-      chalk.dim(
-        "  No monorepo detected. A new monorepo will be created."
-      )
-    );
-  }
-  console.log();
-  const projectName = options.name;
-  const repoName = options.repoName;
-  if (options.yes && !projectName) {
-    console.error(
-      chalk.red("Error: --name is required when using --yes flag")
-    );
-    process.exit(1);
-  }
-  if (projectName) {
-    const validation = validateProjectName(toKebabCase(projectName));
-    if (!validation.valid) {
-      console.error(chalk.red(`Invalid project name: ${validation.error}`));
-      process.exit(1);
-    }
-  }
-  if (repoName) {
-    const validation = validateProjectName(toKebabCase(repoName));
-    if (!validation.valid) {
-      console.error(chalk.red(`Invalid repo name: ${validation.error}`));
-      process.exit(1);
-    }
-  }
-  let answers;
-  if (options.yes) {
-    const projectType = options.type || "webapp";
-    requireNpmTokenForWebappInstall(projectType, !options.skipInstall);
-    const kebabName = toKebabCase(projectName);
-    const kebabRepoName = repoName ? toKebabCase(repoName) : kebabName;
-    const directory = monorepoContext.found && monorepoContext.packageDir ? path7.join(monorepoContext.packageDir, kebabName) : path7.resolve(cwd, kebabRepoName);
-    answers = {
-      projectType,
-      directory,
-      name: kebabName,
-      title: toTitleCase(kebabName),
-      installDeps: !options.skipInstall,
-      monorepoName: monorepoContext.found ? void 0 : kebabRepoName,
-      monorepoTitle: monorepoContext.found ? void 0 : toTitleCase(kebabRepoName)
-    };
-  } else {
-    answers = await promptProjectDetails({
-      projectType: options.type,
-      name: projectName ? toKebabCase(projectName) : void 0,
-      repoName: repoName ? toKebabCase(repoName) : void 0,
-      skipInstall: options.skipInstall,
-      monorepoContext,
-      cwd,
-      beforeNamePrompt: (projectType) => requireNpmTokenForWebappInstall(projectType, !options.skipInstall)
-    });
-    if (monorepoContext.found && monorepoContext.packageDir && !answers.directory) {
-      answers.directory = path7.join(monorepoContext.packageDir, answers.name);
-    }
-  }
-  const monorepoName = answers.monorepoName ?? answers.name;
-  const monorepoTitle = answers.monorepoTitle ?? toTitleCase(monorepoName);
-  const monorepoConfig = buildAppConfig(monorepoName, monorepoTitle);
-  const configRepoName = monorepoContext.found ? path7.basename(monorepoContext.rootDir) : monorepoName;
-  const config = buildAppConfig(answers.name, answers.title, configRepoName);
-  const typeLabel = getProjectTypeLabel(answers.projectType);
-  if (monorepoContext.found) {
-    const monorepoRoot = monorepoContext.rootDir;
-    const packageDir = monorepoContext.packageDir ? path7.join(monorepoContext.packageDir, answers.name) : answers.directory;
-    console.log(chalk.dim("  Package type:"), typeLabel);
-    console.log(chalk.dim("  Target:"), packageDir);
-    console.log(chalk.dim("  Name:"), config.name);
-    console.log(chalk.dim("  Title:"), config.title);
-    if (answers.projectType === "webapp") {
-      console.log(chalk.dim("  Database:"), config.dbName);
-    }
-    console.log();
-    if (await fs7.pathExists(packageDir)) {
-      const files = await fs7.readdir(packageDir);
-      if (files.length > 0) {
-        console.error(
-          chalk.red(`Error: Directory ${packageDir} is not empty.`)
-        );
-        process.exit(1);
-      }
-    }
-    if (answers.projectType !== "monorepo") {
-      await addPackageToMonorepo({
-        packageDir,
-        monorepoRoot,
-        projectType: answers.projectType,
-        config
-      });
-    }
-    await warnIfMissingRootNpmrc(monorepoRoot);
-    const installSucceeded = await installAtMonorepoRoot(
-      monorepoRoot,
-      answers.installDeps
-    );
-    console.log();
-    console.log(
-      chalk.green("\u2714"),
-      chalk.bold(`Created ${typeLabel} at`),
-      chalk.cyan(path7.relative(monorepoRoot, packageDir))
-    );
-    console.log();
-    const devStarted = await maybeAutoRunWebapp(
-      packageDir,
-      answers.projectType,
-      installSucceeded
-    );
-    if (devStarted) return;
-    printNextStepsExisting(answers, packageDir);
-  } else {
-    const isBareMonorepo = answers.projectType === "monorepo";
-    const monorepoRoot = answers.directory;
-    const packageDir = isBareMonorepo ? null : path7.join(monorepoRoot, "packages", answers.name);
-    if (isBareMonorepo) {
-      console.log(chalk.dim("  Type:"), typeLabel);
-      console.log(chalk.dim("  Directory:"), monorepoRoot);
-      console.log(chalk.dim("  Repo name:"), monorepoConfig.name);
-      console.log(chalk.dim("  Title:"), monorepoConfig.title);
-    } else {
-      console.log(chalk.dim("  Package type:"), typeLabel);
-      console.log(chalk.dim("  Monorepo directory:"), monorepoRoot);
-      console.log(chalk.dim("  Repo name:"), monorepoConfig.name);
-      console.log(chalk.dim("  Package:"), `packages/${answers.name}/`);
-      console.log(chalk.dim("  Name:"), config.name);
-      console.log(chalk.dim("  Title:"), config.title);
-      if (answers.projectType === "webapp") {
-        console.log(chalk.dim("  Database:"), config.dbName);
-      }
-    }
-    console.log();
-    if (await fs7.pathExists(monorepoRoot)) {
-      const files = await fs7.readdir(monorepoRoot);
-      if (files.length > 0) {
-        console.error(
-          chalk.red(`Error: Directory ${monorepoRoot} is not empty.`)
-        );
-        process.exit(1);
-      }
-    }
-    await scaffoldMonorepo(monorepoRoot, monorepoConfig);
-    if (packageDir && answers.projectType !== "monorepo") {
-      await addPackageToMonorepo({
-        packageDir,
-        monorepoRoot,
-        projectType: answers.projectType,
-        config
-      });
-    }
-    initGitRepo(monorepoRoot);
-    const installSucceeded = await installAtMonorepoRoot(
-      monorepoRoot,
-      answers.installDeps
-    );
-    console.log();
-    console.log(
-      chalk.green("\u2714"),
-      chalk.bold(isBareMonorepo ? `Created ${typeLabel} at` : "Created monorepo at"),
-      chalk.cyan(monorepoRoot)
-    );
-    if (!isBareMonorepo) {
-      console.log(
-        chalk.green("\u2714"),
-        chalk.bold(`Created ${typeLabel} at`),
-        chalk.cyan(`packages/${answers.name}/`)
-      );
-    }
-    console.log();
-    const devStarted = await maybeAutoRunWebapp(
-      packageDir,
-      answers.projectType,
-      installSucceeded
-    );
-    if (devStarted) return;
-    printNextStepsNew(answers, monorepoRoot);
-  }
+	const cwd = await resolveCreateCwd(options.cwd);
+	if (options.type !== void 0 && !isValidProjectType(options.type)) {
+		console.error(chalk.red(`Error: Invalid package type "${options.type}". Valid types are: ${VALID_PROJECT_TYPES.join(", ")}`));
+		process.exit(1);
+	}
+	console.log();
+	console.log(chalk.bold("Creating a new Mosaic package..."));
+	console.log();
+	const monorepoContext = await detectMonorepo(cwd);
+	if (options.type === "monorepo" && monorepoContext.found) {
+		console.error(chalk.red(`Error: Already inside a monorepo at ${monorepoContext.rootDir}. Choose 'webapp' or 'library' to add a package, or run from outside the monorepo.`));
+		process.exit(1);
+	}
+	if (monorepoContext.found) console.log(chalk.dim("  Detected monorepo at"), chalk.cyan(monorepoContext.rootDir));
+	else console.log(chalk.dim("  No monorepo detected. A new monorepo will be created."));
+	console.log();
+	const projectName = options.name;
+	const repoName = options.repoName;
+	if (options.yes && !projectName) {
+		console.error(chalk.red("Error: --name is required when using --yes flag"));
+		process.exit(1);
+	}
+	if (projectName) {
+		const validation = validateProjectName(toKebabCase(projectName));
+		if (!validation.valid) {
+			console.error(chalk.red(`Invalid project name: ${validation.error}`));
+			process.exit(1);
+		}
+	}
+	if (repoName) {
+		const validation = validateProjectName(toKebabCase(repoName));
+		if (!validation.valid) {
+			console.error(chalk.red(`Invalid repo name: ${validation.error}`));
+			process.exit(1);
+		}
+	}
+	let answers;
+	if (options.yes) {
+		const projectType = options.type || "webapp";
+		requireNpmTokenForWebappInstall(projectType, !options.skipInstall);
+		const kebabName = toKebabCase(projectName);
+		const kebabRepoName = repoName ? toKebabCase(repoName) : kebabName;
+		answers = {
+			projectType,
+			directory: monorepoContext.found && monorepoContext.packageDir ? path.join(monorepoContext.packageDir, kebabName) : path.resolve(cwd, kebabRepoName),
+			name: kebabName,
+			title: toTitleCase(kebabName),
+			installDeps: !options.skipInstall,
+			monorepoName: monorepoContext.found ? void 0 : kebabRepoName,
+			monorepoTitle: monorepoContext.found ? void 0 : toTitleCase(kebabRepoName)
+		};
+	} else {
+		answers = await promptProjectDetails({
+			projectType: options.type,
+			name: projectName ? toKebabCase(projectName) : void 0,
+			repoName: repoName ? toKebabCase(repoName) : void 0,
+			skipInstall: options.skipInstall,
+			monorepoContext,
+			cwd,
+			beforeNamePrompt: (projectType) => requireNpmTokenForWebappInstall(projectType, !options.skipInstall)
+		});
+		if (monorepoContext.found && monorepoContext.packageDir && !answers.directory) answers.directory = path.join(monorepoContext.packageDir, answers.name);
+	}
+	const monorepoName = answers.monorepoName ?? answers.name;
+	const monorepoConfig = buildAppConfig(monorepoName, answers.monorepoTitle ?? toTitleCase(monorepoName));
+	const configRepoName = monorepoContext.found ? path.basename(monorepoContext.rootDir) : monorepoName;
+	const config = buildAppConfig(answers.name, answers.title, configRepoName);
+	const typeLabel = getProjectTypeLabel(answers.projectType);
+	if (monorepoContext.found) {
+		const monorepoRoot = monorepoContext.rootDir;
+		const packageDir = monorepoContext.packageDir ? path.join(monorepoContext.packageDir, answers.name) : answers.directory;
+		console.log(chalk.dim("  Package type:"), typeLabel);
+		console.log(chalk.dim("  Target:"), packageDir);
+		console.log(chalk.dim("  Name:"), config.name);
+		console.log(chalk.dim("  Title:"), config.title);
+		if (answers.projectType === "webapp") console.log(chalk.dim("  Database:"), config.dbName);
+		console.log();
+		if (await fs.pathExists(packageDir)) {
+			if ((await fs.readdir(packageDir)).length > 0) {
+				console.error(chalk.red(`Error: Directory ${packageDir} is not empty.`));
+				process.exit(1);
+			}
+		}
+		if (answers.projectType !== "monorepo") await addPackageToMonorepo({
+			packageDir,
+			monorepoRoot,
+			projectType: answers.projectType,
+			config
+		});
+		await warnIfMissingRootNpmrc(monorepoRoot);
+		const installSucceeded = await installAtMonorepoRoot(monorepoRoot, answers.installDeps);
+		console.log();
+		console.log(chalk.green("✔"), chalk.bold(`Created ${typeLabel} at`), chalk.cyan(path.relative(monorepoRoot, packageDir)));
+		console.log();
+		if (await maybeAutoRunWebapp(packageDir, monorepoRoot, answers.projectType, installSucceeded)) return;
+		printNextStepsExisting(answers, packageDir);
+	} else {
+		const isBareMonorepo = answers.projectType === "monorepo";
+		const monorepoRoot = answers.directory;
+		const packageDir = isBareMonorepo ? null : path.join(monorepoRoot, "packages", answers.name);
+		if (isBareMonorepo) {
+			console.log(chalk.dim("  Type:"), typeLabel);
+			console.log(chalk.dim("  Directory:"), monorepoRoot);
+			console.log(chalk.dim("  Repo name:"), monorepoConfig.name);
+			console.log(chalk.dim("  Title:"), monorepoConfig.title);
+		} else {
+			console.log(chalk.dim("  Package type:"), typeLabel);
+			console.log(chalk.dim("  Monorepo directory:"), monorepoRoot);
+			console.log(chalk.dim("  Repo name:"), monorepoConfig.name);
+			console.log(chalk.dim("  Package:"), `packages/${answers.name}/`);
+			console.log(chalk.dim("  Name:"), config.name);
+			console.log(chalk.dim("  Title:"), config.title);
+			if (answers.projectType === "webapp") console.log(chalk.dim("  Database:"), config.dbName);
+		}
+		console.log();
+		if (await fs.pathExists(monorepoRoot)) {
+			if ((await fs.readdir(monorepoRoot)).length > 0) {
+				console.error(chalk.red(`Error: Directory ${monorepoRoot} is not empty.`));
+				process.exit(1);
+			}
+		}
+		await scaffoldMonorepo(monorepoRoot, monorepoConfig);
+		if (packageDir && answers.projectType !== "monorepo") await addPackageToMonorepo({
+			packageDir,
+			monorepoRoot,
+			projectType: answers.projectType,
+			config
+		});
+		initGitRepo(monorepoRoot);
+		const installSucceeded = await installAtMonorepoRoot(monorepoRoot, answers.installDeps);
+		console.log();
+		console.log(chalk.green("✔"), chalk.bold(isBareMonorepo ? `Created ${typeLabel} at` : "Created monorepo at"), chalk.cyan(monorepoRoot));
+		if (!isBareMonorepo) console.log(chalk.green("✔"), chalk.bold(`Created ${typeLabel} at`), chalk.cyan(`packages/${answers.name}/`));
+		console.log();
+		if (await maybeAutoRunWebapp(packageDir, monorepoRoot, answers.projectType, installSucceeded)) return;
+		printNextStepsNew(answers, monorepoRoot);
+	}
 }
 async function resolveCreateCwd(cwdOption) {
-  const cwd = cwdOption ? path7.resolve(cwdOption) : process.cwd();
-  let stat;
-  try {
-    stat = await fs7.stat(cwd);
-  } catch {
-    console.error(chalk.red(`Error: --cwd directory does not exist: ${cwd}`));
-    process.exit(1);
-  }
-  if (!stat.isDirectory()) {
-    console.error(chalk.red(`Error: --cwd is not a directory: ${cwd}`));
-    process.exit(1);
-  }
-  return cwd;
+	const cwd = cwdOption ? path.resolve(cwdOption) : process.cwd();
+	let stat;
+	try {
+		stat = await fs.stat(cwd);
+	} catch {
+		console.error(chalk.red(`Error: --cwd directory does not exist: ${cwd}`));
+		process.exit(1);
+	}
+	if (!stat.isDirectory()) {
+		console.error(chalk.red(`Error: --cwd is not a directory: ${cwd}`));
+		process.exit(1);
+	}
+	return cwd;
 }
 function printWebappNextSteps(params) {
-  const {
-    pm,
-    answers,
-    variant,
-    monorepoRelativePath,
-    packageRelativePath
-  } = params;
-  const repoRel = shPath(monorepoRelativePath) || ".";
-  const pkgFromRoot = `packages/${answers.name}`;
-  const pnpmSteps = ["pnpm run setup", "pnpm dev"];
-  if (variant === "new") {
-    const oneLinerParts2 = [];
-    if (repoRel !== ".") oneLinerParts2.push(`cd ${repoRel}`);
-    if (!answers.installDeps) oneLinerParts2.push(`${pm} install`);
-    oneLinerParts2.push(`cd ${pkgFromRoot}`);
-    oneLinerParts2.push(...pnpmSteps);
-    console.log(chalk.bold("Copy-paste (from your current directory):"));
-    console.log();
-    console.log(chalk.cyan(`  ${oneLinerParts2.join(" && ")}`));
-    console.log();
-    console.log(chalk.bold("Or step by step:"));
-    console.log();
-    let step2 = 1;
-    if (repoRel !== ".") {
-      console.log(chalk.dim(`  ${step2++}.`), `cd ${repoRel}`);
-    }
-    if (!answers.installDeps) {
-      console.log(chalk.dim(`  ${step2++}.`), `${pm} install`);
-    }
-    console.log(chalk.dim(`  ${step2++}.`), `cd ${pkgFromRoot}`);
-    for (const cmd of pnpmSteps) {
-      console.log(chalk.dim(`  ${step2++}.`), cmd);
-    }
-    return;
-  }
-  const pkgRel = shPath(packageRelativePath ?? ".") || ".";
-  const oneLinerParts = [];
-  if (!answers.installDeps) {
-    if (repoRel !== ".") oneLinerParts.push(`cd ${repoRel}`);
-    oneLinerParts.push(`${pm} install`, `cd ${pkgFromRoot}`);
-  } else if (pkgRel !== ".") {
-    oneLinerParts.push(`cd ${pkgRel}`);
-  }
-  oneLinerParts.push(...pnpmSteps);
-  console.log(chalk.bold("Copy-paste (from your current directory):"));
-  console.log();
-  console.log(chalk.cyan(`  ${oneLinerParts.join(" && ")}`));
-  console.log();
-  console.log(chalk.bold("Or step by step:"));
-  console.log();
-  let step = 1;
-  if (!answers.installDeps) {
-    if (repoRel !== ".") {
-      console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
-    }
-    console.log(chalk.dim(`  ${step++}.`), `${pm} install`);
-    console.log(chalk.dim(`  ${step++}.`), `cd ${pkgFromRoot}`);
-  } else if (pkgRel !== ".") {
-    console.log(chalk.dim(`  ${step++}.`), `cd ${pkgRel}`);
-  }
-  for (const cmd of pnpmSteps) {
-    console.log(chalk.dim(`  ${step++}.`), cmd);
-  }
+	const { pm, answers, variant, monorepoRelativePath, packageRelativePathFromRoot } = params;
+	const repoRel = shPath(monorepoRelativePath) || ".";
+	const pkgFromRoot = shPath(packageRelativePathFromRoot ?? `packages/${answers.name}`) || ".";
+	const setupStep = "pnpm run setup";
+	const devStep = "pnpm dev";
+	if (variant === "new") {
+		const oneLinerParts = [];
+		if (repoRel !== ".") oneLinerParts.push(`cd ${repoRel}`);
+		if (!answers.installDeps) oneLinerParts.push(`${pm} install`);
+		oneLinerParts.push(setupStep);
+		oneLinerParts.push(`cd ${pkgFromRoot}`);
+		oneLinerParts.push(devStep);
+		console.log(chalk.bold("Copy-paste (from your current directory):"));
+		console.log();
+		console.log(chalk.cyan(`  ${oneLinerParts.join(" && ")}`));
+		console.log();
+		console.log(chalk.bold("Or step by step:"));
+		console.log();
+		let step = 1;
+		if (repoRel !== ".") console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
+		if (!answers.installDeps) console.log(chalk.dim(`  ${step++}.`), `${pm} install`);
+		console.log(chalk.dim(`  ${step++}.`), setupStep);
+		console.log(chalk.dim(`  ${step++}.`), `cd ${pkgFromRoot}`);
+		console.log(chalk.dim(`  ${step++}.`), devStep);
+		return;
+	}
+	const oneLinerParts = [];
+	if (repoRel !== ".") oneLinerParts.push(`cd ${repoRel}`);
+	if (!answers.installDeps) oneLinerParts.push(`${pm} install`);
+	oneLinerParts.push(setupStep, `cd ${pkgFromRoot}`, devStep);
+	console.log(chalk.bold("Copy-paste (from your current directory):"));
+	console.log();
+	console.log(chalk.cyan(`  ${oneLinerParts.join(" && ")}`));
+	console.log();
+	console.log(chalk.bold("Or step by step:"));
+	console.log();
+	let step = 1;
+	if (repoRel !== ".") console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
+	if (!answers.installDeps) console.log(chalk.dim(`  ${step++}.`), `${pm} install`);
+	console.log(chalk.dim(`  ${step++}.`), setupStep);
+	console.log(chalk.dim(`  ${step++}.`), `cd ${pkgFromRoot}`);
+	console.log(chalk.dim(`  ${step++}.`), devStep);
 }
 async function warnIfMissingRootNpmrc(rootDir) {
-  const rootNpmrc = path7.join(rootDir, ".npmrc");
-  let contents = "";
-  if (await fs7.pathExists(rootNpmrc)) {
-    contents = await fs7.readFile(rootNpmrc, "utf8");
-  }
-  if (contents.includes("@percepta:registry")) {
-    return;
-  }
-  console.log();
-  console.log(
-    chalk.yellow("!"),
-    chalk.bold("Root .npmrc is missing @percepta registry config.")
-  );
-  console.log(
-    chalk.dim(
-      "  pnpm reads .npmrc from the workspace root, so add these lines to"
-    )
-  );
-  console.log(chalk.dim(`  ${path7.join(rootDir, ".npmrc")}:`));
-  console.log();
-  console.log(
-    chalk.cyan("    @percepta:registry=https://registry.npmjs.org/")
-  );
-  console.log(
-    chalk.cyan("    //registry.npmjs.org/:_authToken=${NPM_TOKEN}")
-  );
-  console.log();
+	const rootNpmrc = path.join(rootDir, ".npmrc");
+	let contents = "";
+	if (await fs.pathExists(rootNpmrc)) contents = await fs.readFile(rootNpmrc, "utf8");
+	if (contents.includes("@percepta:registry")) return;
+	console.log();
+	console.log(chalk.yellow("!"), chalk.bold("Root .npmrc is missing @percepta registry config."));
+	console.log(chalk.dim("  pnpm reads .npmrc from the workspace root, so add these lines to"));
+	console.log(chalk.dim(`  ${path.join(rootDir, ".npmrc")}:`));
+	console.log();
+	console.log(chalk.cyan("    @percepta:registry=https://registry.npmjs.org/"));
+	console.log(chalk.cyan("    //registry.npmjs.org/:_authToken=${NPM_TOKEN}"));
+	console.log();
 }
 function printNextStepsNew(answers, targetDir) {
-  const pm = PACKAGE_MANAGER;
-  const relativePath = path7.relative(process.cwd(), targetDir) || ".";
-  console.log("Next steps:");
-  console.log();
-  switch (answers.projectType) {
-    case "monorepo": {
-      let step = 1;
-      const repoRel = shPath(relativePath);
-      if (repoRel !== ".") {
-        console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
-      }
-      if (!answers.installDeps) {
-        console.log(chalk.dim(`  ${step++}.`), `${pm} install`);
-      }
-      console.log(
-        chalk.dim(`  ${step++}.`),
-        `Add a package: ${chalk.cyan(`npx @percepta/create --type webapp <name>`)}`
-      );
-      break;
-    }
-    case "webapp":
-      printWebappNextSteps({
-        pm,
-        answers,
-        variant: "new",
-        monorepoRelativePath: relativePath
-      });
-      break;
-    case "library": {
-      let step = 1;
-      const repoRel = shPath(relativePath);
-      if (repoRel !== ".") {
-        console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
-      }
-      if (!answers.installDeps) {
-        console.log(chalk.dim(`  ${step++}.`), `${pm} install`);
-      }
-      console.log(
-        chalk.dim(`  ${step++}.`),
-        `cd packages/${answers.name}`
-      );
-      console.log(chalk.dim(`  ${step++}.`), `${pm} dev`);
-      console.log(
-        chalk.dim(`  ${step++}.`),
-        `Edit src/index.ts to add your library code`
-      );
-      break;
-    }
-  }
-  console.log();
-  console.log(
-    chalk.dim("For more information, see the README.md in your project.")
-  );
-  console.log();
+	const pm = PACKAGE_MANAGER;
+	const relativePath = path.relative(process.cwd(), targetDir) || ".";
+	console.log("Next steps:");
+	console.log();
+	switch (answers.projectType) {
+		case "monorepo": {
+			let step = 1;
+			const repoRel = shPath(relativePath);
+			if (repoRel !== ".") console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
+			if (!answers.installDeps) console.log(chalk.dim(`  ${step++}.`), `${pm} install`);
+			console.log(chalk.dim(`  ${step++}.`), `Add a package: ${chalk.cyan(`npx @percepta/create --type webapp <name>`)}`);
+			break;
+		}
+		case "webapp":
+			printWebappNextSteps({
+				pm,
+				answers,
+				variant: "new",
+				monorepoRelativePath: relativePath
+			});
+			break;
+		case "library": {
+			let step = 1;
+			const repoRel = shPath(relativePath);
+			if (repoRel !== ".") console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
+			if (!answers.installDeps) console.log(chalk.dim(`  ${step++}.`), `${pm} install`);
+			console.log(chalk.dim(`  ${step++}.`), `cd packages/${answers.name}`);
+			console.log(chalk.dim(`  ${step++}.`), `${pm} dev`);
+			console.log(chalk.dim(`  ${step++}.`), `Edit src/index.ts to add your library code`);
+			break;
+		}
+	}
+	console.log();
+	console.log(chalk.dim("For more information, see the README.md in your project."));
+	console.log();
 }
 function printNextStepsExisting(answers, packageDir) {
-  const pm = PACKAGE_MANAGER;
-  const packageRelativePath = path7.relative(process.cwd(), packageDir) || ".";
-  const monorepoRoot = path7.dirname(path7.dirname(packageDir));
-  const monorepoRelativePath = path7.relative(process.cwd(), monorepoRoot) || ".";
-  console.log("Next steps:");
-  console.log();
-  switch (answers.projectType) {
-    case "webapp":
-      printWebappNextSteps({
-        pm,
-        answers,
-        variant: "existing",
-        monorepoRelativePath,
-        packageRelativePath
-      });
-      break;
-    case "library": {
-      let step = 1;
-      const pkgRel = shPath(packageRelativePath);
-      if (pkgRel !== ".") {
-        console.log(chalk.dim(`  ${step++}.`), `cd ${pkgRel}`);
-      }
-      console.log(chalk.dim(`  ${step++}.`), `${pm} dev`);
-      console.log(
-        chalk.dim(`  ${step++}.`),
-        "Edit src/index.ts to add your library code"
-      );
-      break;
-    }
-  }
-  console.log();
-  console.log(
-    chalk.dim("For more information, see the README.md in your project.")
-  );
-  console.log();
+	const pm = PACKAGE_MANAGER;
+	const packageRelativePath = path.relative(process.cwd(), packageDir) || ".";
+	const monorepoRoot = path.dirname(path.dirname(packageDir));
+	const monorepoRelativePath = path.relative(process.cwd(), monorepoRoot) || ".";
+	const packageRelativePathFromRoot = path.relative(monorepoRoot, packageDir) || ".";
+	console.log("Next steps:");
+	console.log();
+	switch (answers.projectType) {
+		case "webapp":
+			printWebappNextSteps({
+				pm,
+				answers,
+				variant: "existing",
+				monorepoRelativePath,
+				packageRelativePathFromRoot
+			});
+			break;
+		case "library": {
+			let step = 1;
+			const pkgRel = shPath(packageRelativePath);
+			if (pkgRel !== ".") console.log(chalk.dim(`  ${step++}.`), `cd ${pkgRel}`);
+			console.log(chalk.dim(`  ${step++}.`), `${pm} dev`);
+			console.log(chalk.dim(`  ${step++}.`), "Edit src/index.ts to add your library code");
+			break;
+		}
+	}
+	console.log();
+	console.log(chalk.dim("For more information, see the README.md in your project."));
+	console.log();
 }
-
-// src/index.ts
-var packageJson = {
-  name: "@percepta/create",
-  version: "1.0.0"
-};
-program.name("create").description("Scaffold and manage Mosaic packages").version(packageJson.version);
+//#endregion
+//#region src/index.ts
+program.name("create").description("Scaffold and manage Mosaic packages").version({
+	name: "@percepta/create",
+	version: "1.0.0"
+}.version);
 program.command("create", { isDefault: true }).description("Scaffold a new Mosaic package").option("-t, --type <type>", "Package type: monorepo, webapp, or library").option("--name <name>", "Package/app name").option("--repo-name <name>", "Repository name when creating a new monorepo").option("--cwd <dir>", "Run create as if started from this directory").option("--skip-install", "Skip dependency installation (also skips the auto-run setup + dev + browser)", false).option("-y, --yes", "Skip all prompts and use defaults", false).action(createProject);
-program.command("status").description("Show template sync status for current app").option(
-  "--mosaic-template-path <path>",
-  "Path to local mosaic repo checkout"
-).action(async (options) => {
-  const { statusCommand } = await import("./status-QW5TQDYY.js");
-  await statusCommand(options);
+program.command("status").description("Show template sync status for current app").option("--mosaic-template-path <path>", "Path to local mosaic repo checkout").action(async (options) => {
+	const { statusCommand } = await import("./status-CKe4aKso.js");
+	await statusCommand(options);
 });
-program.command("sync").description("Generate downstream sync context (template \u2192 app)").option(
-  "--mosaic-template-path <path>",
-  "Path to local mosaic repo checkout"
-).option("--to <version>", "Target template version (default: latest)").action(async (options) => {
-  const { syncCommand } = await import("./sync-RLBZDOFB.js");
-  await syncCommand(options);
+program.command("sync").description("Generate downstream sync context (template → app)").option("--mosaic-template-path <path>", "Path to local mosaic repo checkout").option("--to <version>", "Target template version (default: latest)").action(async (options) => {
+	const { syncCommand } = await import("./sync-D1vkoofl.js");
+	await syncCommand(options);
 });
-program.command("upstream").description("Generate upstream context (app \u2192 template)").option(
-  "--mosaic-template-path <path>",
-  "Path to local mosaic repo checkout"
-).option("--files <patterns...>", "Specific files to propose upstream").action(async (options) => {
-  const { upstreamCommand } = await import("./upstream-TQFVPMEG.js");
-  await upstreamCommand(options);
+program.command("upstream").description("Generate upstream context (app → template)").option("--mosaic-template-path <path>", "Path to local mosaic repo checkout").option("--files <patterns...>", "Specific files to propose upstream").action(async (options) => {
+	const { upstreamCommand } = await import("./upstream-D-LH_1z4.js");
+	await upstreamCommand(options);
 });
 program.command("init").description("Add .mosaic-template.json to an existing app").option("-t, --type <type>", "Template type (e.g., webapp, library)").option("--template-version <version>", "Template version to set").action(async (options) => {
-  const { initCommand } = await import("./init-EQZ2TCSJ.js");
-  await initCommand(options);
+	const { initCommand } = await import("./init-CtCp7Tv2.js");
+	await initCommand(options);
 });
 program.parse();
+//#endregion
+export { manifestExists as a, writeManifest as c, derivePlaceholders as i, VALID_PROJECT_TYPES as n, readManifest as o, isValidProjectType as r, resolveMosaicTemplatePath as s, getTemplateVersion as t };
+
+//# sourceMappingURL=index.js.map