@percepta/create 4.1.11 → 4.1.13

package/dist/index.js

@@ -171,7 +171,7 @@ async function writeManifest(dir, manifest) {
 async function manifestExists(dir) {
 	return fs.pathExists(getManifestPath(dir));
 }
-function derivePlaceholders(appName, appTitle, repoName = appName, customerSlug = repoName, designTheme = DEFAULT_MOSAIC_DESIGN_THEME) {
+function derivePlaceholders(appName, appTitle, repoName = appName, customerSlug = repoName, designTheme = DEFAULT_MOSAIC_DESIGN_THEME, authMode = "username-password") {
 	const nameSnake = appName.replace(/-/g, "_");
 	const repoNameSnake = repoName.replace(/-/g, "_");
 	return {
@@ -183,7 +183,8 @@ function derivePlaceholders(appName, appTitle, repoName = appName, customerSlug
 		__REPO_NAME__: repoName,
 		__REPO_NAME_SNAKE__: repoNameSnake,
 		__CUSTOMER_SLUG__: customerSlug,
-		__MOSAIC_DESIGN_THEME__: designTheme
+		__MOSAIC_DESIGN_THEME__: designTheme,
+		__AUTH_MODE__: authMode
 	};
 }
 function resolveMosaicRepoPath(options) {
@@ -225,6 +226,14 @@ const VALID_PROJECT_TYPES = [
 	"webapp",
 	"library"
 ];
+const VALID_AUTH_MODES = [
+	"username-password",
+	"google",
+	"okta"
+];
+function isValidAuthMode(value) {
+	return typeof value === "string" && VALID_AUTH_MODES.includes(value);
+}
 function isValidProjectType(value) {
 	return typeof value === "string" && VALID_PROJECT_TYPES.includes(value);
 }
@@ -280,9 +289,71 @@ async function resolveDesignTheme(projectType, defaults) {
 	if (defaults.projectType && defaults.name) return DEFAULT_MOSAIC_DESIGN_THEME;
 	return promptDesignTheme();
 }
+async function promptWorkspaceAuthMode() {
+	const { authMode } = await inquirer.prompt([{
+		type: "rawlist",
+		name: "authMode",
+		message: "Workspace auth setup?",
+		default: "username-password",
+		choices: [
+			{
+				name: "Username/password — local Better Auth credentials",
+				value: "username-password"
+			},
+			{
+				name: "Google — Google OAuth via Better Auth",
+				value: "google"
+			},
+			{
+				name: "Okta — Okta OIDC via Better Auth",
+				value: "okta"
+			}
+		]
+	}]);
+	return authMode;
+}
+async function promptAppAuthMode(defaultAuthMode) {
+	const overrideChoices = [
+		{
+			name: "Username/password — local Better Auth credentials",
+			value: "username-password"
+		},
+		{
+			name: "Google — Google OAuth via Better Auth",
+			value: "google"
+		},
+		{
+			name: "Okta — Okta OIDC via Better Auth",
+			value: "okta"
+		}
+	].filter((choice) => choice.value !== defaultAuthMode);
+	const { authMode } = await inquirer.prompt([{
+		type: "rawlist",
+		name: "authMode",
+		message: "App auth setup?",
+		default: defaultAuthMode,
+		choices: [{
+			name: "Use workspace default",
+			value: defaultAuthMode
+		}, ...overrideChoices]
+	}]);
+	return authMode;
+}
+async function resolveWorkspaceAuthMode(defaults) {
+	if (defaults.authMode) return defaults.authMode;
+	if (defaults.projectType && defaults.name) return "username-password";
+	return promptWorkspaceAuthMode();
+}
+async function resolvePackageAuthMode(projectType, defaults) {
+	if (projectType !== "webapp") return void 0;
+	if (defaults.authMode) return defaults.authMode;
+	const workspaceAuthMode = defaults.workspaceAuthMode ?? "username-password";
+	if (defaults.projectType && defaults.name) return workspaceAuthMode;
+	return promptAppAuthMode(workspaceAuthMode);
+}
 /**
-* 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
+* Outside a monorepo we collect monorepo-level settings 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
@@ -330,6 +401,7 @@ async function promptProjectDetails(defaults) {
 		const customerSlug = await resolveCustomerSlug(defaults);
 		const repoName = defaults.repoName || (defaults.projectType === "monorepo" ? defaults.name : void 0) || await promptName("Repo name?", `${customerSlug}-os`);
 		const repoTitle = toTitleCase(repoName);
+		const authMode = await resolveWorkspaceAuthMode(defaults);
 		projectType = defaults.projectType ?? await promptOutsideMonorepoType();
 		await defaults.beforeNamePrompt?.(projectType);
 		if (projectType === "monorepo") {
@@ -343,6 +415,7 @@ async function promptProjectDetails(defaults) {
 				title: finalTitle,
 				installDeps: !defaults.skipInstall,
 				customerSlug,
+				authMode,
 				monorepoName: repoName,
 				monorepoTitle: repoTitle
 			};
@@ -360,12 +433,14 @@ async function promptProjectDetails(defaults) {
 			installDeps: !defaults.skipInstall,
 			customerSlug,
 			designTheme,
+			authMode,
 			monorepoName: repoName,
 			monorepoTitle: repoTitle
 		};
 	}
 	const finalTitle = finalName ? toTitleCase(finalName) : "";
 	const designTheme = await resolveDesignTheme(projectType, defaults);
+	const authMode = await resolvePackageAuthMode(projectType, defaults);
 	const finalDirectory = !inMonorepo && finalName ? path.resolve(cwd, finalName) : "";
 	return {
 		projectType,
@@ -373,7 +448,8 @@ async function promptProjectDetails(defaults) {
 		name: finalName,
 		title: finalTitle,
 		installDeps: !defaults.skipInstall,
-		designTheme
+		designTheme,
+		authMode
 	};
 }
 //#endregion
@@ -419,7 +495,9 @@ const PLACEHOLDERS = {
 	__CUSTOMER_SLUG__: "customerSlug",
 	__CREATE_PACKAGE__: "createPackage",
 	__CREATE_VERSION__: "createVersion",
-	__MOSAIC_DESIGN_THEME__: "designTheme"
+	__MOSAIC_DESIGN_THEME__: "designTheme",
+	__AUTH_MODE__: "authMode",
+	__AUTH_MODE_LABEL__: "authModeLabel"
 };
 const SKIP_DIRS = new Set([
 	"node_modules",
@@ -537,11 +615,12 @@ const WORKSPACE_MANIFEST_FILENAME = ".mosaic-workspace.json";
 function getWorkspaceManifestPath(rootDir) {
 	return path.join(rootDir, WORKSPACE_MANIFEST_FILENAME);
 }
-function createWorkspaceManifest({ customerSlug, createdAt = (/* @__PURE__ */ new Date()).toISOString() }) {
+function createWorkspaceManifest({ customerSlug, authMode, createdAt = (/* @__PURE__ */ new Date()).toISOString() }) {
 	const createPackage = readCreatePackageMetadata();
 	return {
 		schemaVersion: 1,
 		customerSlug,
+		authMode,
 		createPackage: createPackage.name,
 		createVersion: createPackage.version,
 		monorepoTemplateVersion: getTemplateVersion("monorepo"),
@@ -552,6 +631,9 @@ function createWorkspaceManifest({ customerSlug, createdAt = (/* @__PURE__ */ ne
 		createdAt
 	};
 }
+function getWorkspaceAuthMode(manifest) {
+	return manifest?.authMode ?? "username-password";
+}
 async function readWorkspaceManifest(rootDir) {
 	const manifestPath = getWorkspaceManifestPath(rootDir);
 	if (!await fs.pathExists(manifestPath)) return null;
@@ -778,13 +860,13 @@ async function writeMosaicFiles(packageDir, config, projectType, templateVersion
 		templateVersion,
 		templateCommit,
 		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-		placeholders: derivePlaceholders(config.name, config.title, config.repoName, config.customerSlug, config.designTheme),
+		placeholders: derivePlaceholders(config.name, config.title, config.repoName, config.customerSlug, config.designTheme, config.authMode),
 		source: { templatePath: `packages/blueberry/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, customerSlug = repoName, designTheme = DEFAULT_MOSAIC_DESIGN_THEME) {
+function buildAppConfig(name, title = toTitleCase(name), repoName = name, customerSlug = repoName, designTheme = DEFAULT_MOSAIC_DESIGN_THEME, authMode = "username-password") {
 	const createPackage = readCreatePackageMetadata();
 	return {
 		name,
@@ -797,7 +879,9 @@ function buildAppConfig(name, title = toTitleCase(name), repoName = name, custom
 		customerSlug,
 		createPackage: createPackage.name,
 		createVersion: createPackage.version,
-		designTheme
+		designTheme,
+		authMode,
+		authModeLabel: getAuthModeLabel(authMode)
 	};
 }
 /** Copy the monorepo template into `targetDir` and replace its placeholders. */
@@ -942,8 +1026,9 @@ async function runGeneratedProjectChecks(args) {
 * Gated on `installSucceeded` because starting setup without node_modules
 * leaves an orphan Docker container.
 */
-async function maybeAutoRunWebapp(packageDir, monorepoRoot, projectType, installSucceeded) {
+async function maybeAutoRunWebapp(packageDir, monorepoRoot, projectType, authMode, installSucceeded) {
 	if (!packageDir || projectType !== "webapp" || !installSucceeded) return false;
+	if (authMode !== "username-password") return false;
 	return autoRunWebapp(packageDir, monorepoRoot);
 }
 function getProjectTypeLabel(projectType) {
@@ -954,6 +1039,14 @@ function getProjectTypeLabel(projectType) {
 		default: throw new Error(`Unknown project type: ${String(projectType)}`);
 	}
 }
+function getAuthModeLabel(authMode) {
+	switch (authMode) {
+		case "username-password": return "Username/password";
+		case "google": return "Google OAuth";
+		case "okta": return "Okta OIDC";
+		default: throw new Error(`Unknown auth mode: ${String(authMode)}`);
+	}
+}
 function requireNpmTokenForWebappInstall(projectType, installDeps) {
 	if (projectType !== "webapp" || !installDeps || process.env.NPM_TOKEN) return;
 	console.log();
@@ -996,6 +1089,10 @@ async function createProject(options) {
 		console.error(chalk.red(`Error: Invalid design theme "${options.theme}". Valid themes are: ${VALID_MOSAIC_DESIGN_THEMES.join(", ")}`));
 		process.exit(1);
 	}
+	if (options.auth !== void 0 && !isValidAuthMode(options.auth)) {
+		console.error(chalk.red(`Error: Invalid auth setup "${options.auth}". Valid auth setups are: ${VALID_AUTH_MODES.join(", ")}`));
+		process.exit(1);
+	}
 	console.log();
 	console.log(chalk.bold("Creating a new Mosaic package..."));
 	console.log();
@@ -1012,8 +1109,10 @@ async function createProject(options) {
 	else console.log(chalk.dim("  No monorepo detected. A new monorepo will be created."));
 	console.log();
 	const workspaceManifest = monorepoContext.found ? await readWorkspaceManifest(monorepoContext.rootDir) : null;
+	const workspaceAuthMode = getWorkspaceAuthMode(workspaceManifest);
 	if (workspaceManifest) {
 		console.log(chalk.dim("  Workspace create version:"), chalk.cyan(`${workspaceManifest.createPackage}@${workspaceManifest.createVersion}`));
+		console.log(chalk.dim("  Workspace auth setup:"), chalk.cyan(getAuthModeLabel(workspaceAuthMode)));
 		console.log();
 	} else if (monorepoContext.found) {
 		console.log(chalk.yellow("!"), "No .mosaic-workspace.json found; using this CLI's bundled templates.");
@@ -1062,6 +1161,7 @@ async function createProject(options) {
 			installDeps: !options.skipInstall,
 			customerSlug: monorepoContext.found ? void 0 : customerSlug ?? kebabRepoName,
 			designTheme: projectType === "webapp" ? options.theme ?? "modern" : void 0,
+			authMode: options.auth ?? (monorepoContext.found ? workspaceAuthMode : "username-password"),
 			monorepoName: monorepoContext.found ? void 0 : kebabRepoName,
 			monorepoTitle: monorepoContext.found ? void 0 : toTitleCase(kebabRepoName)
 		};
@@ -1071,6 +1171,8 @@ async function createProject(options) {
 			name: projectName ? toKebabCase(projectName) : void 0,
 			customerSlug,
 			designTheme: options.theme,
+			authMode: options.auth,
+			workspaceAuthMode: monorepoContext.found ? workspaceAuthMode : void 0,
 			repoName: repoName ? toKebabCase(repoName) : void 0,
 			skipInstall: options.skipInstall,
 			monorepoContext,
@@ -1082,13 +1184,15 @@ async function createProject(options) {
 		});
 		if (monorepoContext.found && monorepoContext.packageDir && !answers.directory) answers.directory = path.join(monorepoContext.packageDir, answers.name);
 	}
+	const selectedAuthMode = answers.authMode ?? (monorepoContext.found ? workspaceAuthMode : "username-password");
+	answers.authMode = selectedAuthMode;
 	const monorepoName = answers.monorepoName ?? answers.name;
 	const monorepoTitle = answers.monorepoTitle ?? toTitleCase(monorepoName);
 	const newWorkspaceCustomerSlug = answers.customerSlug ?? monorepoName;
-	const monorepoConfig = buildAppConfig(monorepoName, monorepoTitle, monorepoName, newWorkspaceCustomerSlug, DEFAULT_MOSAIC_DESIGN_THEME);
+	const monorepoConfig = buildAppConfig(monorepoName, monorepoTitle, monorepoName, newWorkspaceCustomerSlug, DEFAULT_MOSAIC_DESIGN_THEME, selectedAuthMode);
 	const configRepoName = monorepoContext.found ? path.basename(monorepoContext.rootDir) : monorepoName;
 	const effectiveCustomerSlug = monorepoContext.found ? workspaceManifest?.customerSlug ?? configRepoName : newWorkspaceCustomerSlug;
-	const config = buildAppConfig(answers.name, answers.title, configRepoName, effectiveCustomerSlug, answers.designTheme);
+	const config = buildAppConfig(answers.name, answers.title, configRepoName, effectiveCustomerSlug, answers.designTheme, selectedAuthMode);
 	const typeLabel = getProjectTypeLabel(answers.projectType);
 	if (monorepoContext.found) {
 		const monorepoRoot = monorepoContext.rootDir;
@@ -1100,6 +1204,8 @@ async function createProject(options) {
 		if (answers.projectType === "webapp") {
 			console.log(chalk.dim("  Database:"), config.dbName);
 			console.log(chalk.dim("  Design theme:"), config.designTheme);
+			console.log(chalk.dim("  App auth setup:"), config.authModeLabel);
+			if (selectedAuthMode !== workspaceAuthMode) console.log(chalk.dim("  Workspace auth default:"), getAuthModeLabel(workspaceAuthMode));
 		}
 		console.log();
 		if (await fs.pathExists(packageDir)) {
@@ -1128,7 +1234,7 @@ async function createProject(options) {
 		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 && checksSucceeded)) return;
+		if (await maybeAutoRunWebapp(packageDir, monorepoRoot, answers.projectType, answers.authMode, installSucceeded && checksSucceeded)) return;
 		printNextStepsExisting(answers, packageDir, !installSucceeded);
 	} else {
 		const isBareMonorepo = answers.projectType === "monorepo";
@@ -1140,11 +1246,13 @@ async function createProject(options) {
 			console.log(chalk.dim("  Customer:"), newWorkspaceCustomerSlug);
 			console.log(chalk.dim("  Repo name:"), monorepoConfig.name);
 			console.log(chalk.dim("  Title:"), monorepoConfig.title);
+			console.log(chalk.dim("  Workspace auth setup:"), monorepoConfig.authModeLabel);
 		} else {
 			console.log(chalk.dim("  Package type:"), typeLabel);
 			console.log(chalk.dim("  Monorepo directory:"), monorepoRoot);
 			console.log(chalk.dim("  Customer:"), newWorkspaceCustomerSlug);
 			console.log(chalk.dim("  Repo name:"), monorepoConfig.name);
+			console.log(chalk.dim("  Workspace auth setup:"), monorepoConfig.authModeLabel);
 			console.log(chalk.dim("  Package:"), `packages/${answers.name}/`);
 			console.log(chalk.dim("  Name:"), config.name);
 			console.log(chalk.dim("  Title:"), config.title);
@@ -1161,7 +1269,10 @@ async function createProject(options) {
 			}
 		}
 		await scaffoldMonorepo(monorepoRoot, monorepoConfig);
-		const newWorkspaceManifest = createWorkspaceManifest({ customerSlug: newWorkspaceCustomerSlug });
+		const newWorkspaceManifest = createWorkspaceManifest({
+			customerSlug: newWorkspaceCustomerSlug,
+			authMode: selectedAuthMode
+		});
 		await writeWorkspaceManifest(monorepoRoot, newWorkspaceManifest);
 		if (packageDir && answers.projectType !== "monorepo") await addPackageToMonorepo({
 			packageDir,
@@ -1184,7 +1295,7 @@ async function createProject(options) {
 		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 && checksSucceeded)) return;
+		if (await maybeAutoRunWebapp(packageDir, monorepoRoot, answers.projectType, answers.authMode, installSucceeded && checksSucceeded)) return;
 		printNextStepsNew(answers, monorepoRoot, !installSucceeded);
 	}
 }
@@ -1209,6 +1320,7 @@ function printWebappNextSteps(params) {
 	const pkgFromRoot = shPath(packageRelativePathFromRoot ?? `packages/${answers.name}`) || ".";
 	const setupStep = "pnpm run setup";
 	const devStep = "pnpm dev";
+	printAuthSetupNotes(answers);
 	if (variant === "new") {
 		const oneLinerParts = [];
 		if (repoRel !== ".") oneLinerParts.push(`cd ${repoRel}`);
@@ -1247,6 +1359,32 @@ function printWebappNextSteps(params) {
 	console.log(chalk.dim(`  ${step++}.`), `cd ${pkgFromRoot}`);
 	console.log(chalk.dim(`  ${step++}.`), devStep);
 }
+function printAuthSetupNotes(answers) {
+	if (!answers.authMode) return;
+	switch (answers.authMode) {
+		case "username-password": return;
+		case "google":
+			console.log();
+			console.log(chalk.bold("Google auth setup:"));
+			console.log(chalk.dim("  Fill in"), chalk.cyan("GOOGLE_CLIENT_ID"), chalk.dim("and"), chalk.cyan("GOOGLE_CLIENT_SECRET"), chalk.dim("in each app environment before OAuth sign-in."));
+			console.log(chalk.dim("  Optional: set"), chalk.cyan("GOOGLE_HOSTED_DOMAIN"), chalk.dim("to hint/restrict the Google Workspace domain."));
+			console.log(chalk.dim("  Register redirect URIs:"), chalk.cyan("http://localhost:3000/api/auth/callback/google"), chalk.dim("and"), chalk.cyan("https://<app-host>/api/auth/callback/google"));
+			console.log(chalk.dim("  Provider users still need SpiceDB app access after sign-in; seed or grant access for their user."));
+			return;
+		case "okta":
+			console.log();
+			console.log(chalk.bold("Okta auth setup:"));
+			console.log(chalk.dim("  Fill in"), chalk.cyan("OKTA_CLIENT_ID"), chalk.dim(","), chalk.cyan("OKTA_CLIENT_SECRET"), chalk.dim("and"), chalk.cyan("OKTA_ISSUER"), chalk.dim("in each app environment before OAuth sign-in."));
+			console.log(chalk.dim("  Example issuer:"), chalk.cyan("https://dev-xxxxx.okta.com/oauth2/default"));
+			console.log(chalk.dim("  Register redirect URIs:"), chalk.cyan("http://localhost:3000/api/auth/oauth2/callback/okta"), chalk.dim("and"), chalk.cyan("https://<app-host>/api/auth/oauth2/callback/okta"));
+			console.log(chalk.dim("  Provider users still need SpiceDB app access after sign-in; seed or grant access for their user."));
+			return;
+		default: {
+			const exhaustiveCheck = answers.authMode;
+			throw new Error(`Unknown auth mode: ${String(exhaustiveCheck)}`);
+		}
+	}
+}
 async function warnIfMissingRootNpmrc(rootDir) {
 	const rootNpmrc = path.join(rootDir, ".npmrc");
 	let contents = "";
@@ -1268,6 +1406,7 @@ function printNextStepsNew(answers, targetDir, installNeeded) {
 	console.log();
 	switch (answers.projectType) {
 		case "monorepo": {
+			printAuthSetupNotes(answers);
 			let step = 1;
 			const repoRel = shPath(relativePath);
 			if (repoRel !== ".") console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
@@ -1285,6 +1424,7 @@ function printNextStepsNew(answers, targetDir, installNeeded) {
 			});
 			break;
 		case "library": {
+			printAuthSetupNotes(answers);
 			let step = 1;
 			const repoRel = shPath(relativePath);
 			if (repoRel !== ".") console.log(chalk.dim(`  ${step++}.`), `cd ${repoRel}`);
@@ -1342,8 +1482,8 @@ function printNextStepsExisting(answers, packageDir, installNeeded) {
 //#region src/index.ts
 const packageJson = readCreatePackageMetadata();
 program.name("create").description("Scaffold and manage Mosaic packages").version(packageJson.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("--customer <slug>", "Customer slug for the new monorepo").option("--theme <theme>", "Webapp design theme: modern, paper, or dense").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("add").description("Add a Mosaic package to the current monorepo").argument("[typeOrName]", "Package type (webapp/library) or package name").argument("[name]", "Package/app name").option("-t, --type <type>", "Package type: webapp or library").option("--name <name>", "Package/app name").option("--theme <theme>", "Webapp design theme: modern, paper, or dense").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(async (typeOrName, name, options) => {
+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("--customer <slug>", "Customer slug for the new monorepo").option("--theme <theme>", "Webapp design theme: modern, paper, or dense").option("--auth <mode>", "Workspace auth setup: username-password, google, or okta").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("add").description("Add a Mosaic package to the current monorepo").argument("[typeOrName]", "Package type (webapp/library) or package name").argument("[name]", "Package/app name").option("-t, --type <type>", "Package type: webapp or library").option("--name <name>", "Package/app name").option("--theme <theme>", "Webapp design theme: modern, paper, or dense").option("--auth <mode>", "App auth setup override: username-password, google, or okta").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(async (typeOrName, name, options) => {
 	let projectType = options.type;
 	let projectName = options.name;
 	if (typeOrName === "webapp" || typeOrName === "library") {