create-questpie 2.0.0 → 2.0.2

package/README.md

@@ -19,8 +19,11 @@ bunx create-questpie my-app
 | Flag                    | Description                                 |
 | ----------------------- | ------------------------------------------- |
 | `-t, --template <name>` | Template to use (default: `tanstack-start`) |
+| `--database <name>`     | Database name (default: derived from name)  |
 | `--no-install`          | Skip dependency installation                |
 | `--no-git`              | Skip git initialization                     |
+| `--no-skills`           | Skip project-local QUESTPIE agent skills    |
+| `--no-generate`         | Skip post-install QUESTPIE codegen          |
 
 ## Templates
 
@@ -69,16 +72,17 @@ my-app/
 
 ```bash
 cd my-app
-cp .env.example .env              # Set DATABASE_URL
-bun questpie migrate              # Run migrations
-bun dev                           # Start dev server
+docker compose up -d
+bun run scaffold:verify           # Regenerate codegen + type-check
+bun run migrate                   # Run migrations
+bun run dev                       # Start dev server
 
 # Add entities (auto-runs codegen)
-bun questpie add collection products
-bun questpie add global marketing
+bunx questpie add collection products
+bunx questpie add global marketing
 ```
 
-`questpie add` runs codegen automatically. Use `bunx questpie generate` only when you create files manually.
+The scaffolder creates `.env` from `.env.example`, installs project-local QUESTPIE agent skills under `.agents/skills`, and runs `questpie:generate` after dependency installation by default. `questpie add` runs codegen automatically. Use `bun run questpie:generate` only when you create files manually.
 
 ## Documentation
 

package/dist/index.mjs

@@ -2,9 +2,9 @@
 import { Command } from "commander";
 import * as p from "@clack/prompts";
 import pc from "picocolors";
-import { execSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 import { existsSync } from "node:fs";
-import { cp, readFile, readdir, rename, writeFile } from "node:fs/promises";
+import { cp, mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 
 //#region src/templates.ts
@@ -62,6 +62,12 @@ function installDependencies(cwd, packageManager) {
 		stdio: "inherit"
 	});
 }
+function runPackageScript(cwd, packageManager, script) {
+	execFileSync(packageManager === "npm" ? "npm" : packageManager, packageManager === "npm" ? ["run", script] : ["run", script], {
+		cwd,
+		stdio: "inherit"
+	});
+}
 function detectPackageManager() {
 	const userAgent = process.env.npm_config_user_agent;
 	if (userAgent) {
@@ -81,10 +87,26 @@ const label = {
 //#endregion
 //#region src/prompts.ts
 async function runPrompts(args) {
+	if (!Boolean(process.stdin.isTTY && process.stdout.isTTY)) {
+		if (!args.projectName) throw new Error("Project name is required in non-interactive mode.");
+		if (!isValidPackageName(args.projectName)) throw new Error("Invalid package name (use lowercase, hyphens, no spaces).");
+		return {
+			projectName: args.projectName,
+			templateId: args.templateId ?? templates[0].id,
+			databaseName: args.databaseName ?? toDbName(args.projectName),
+			installDeps: args.installDeps ?? true,
+			initGit: args.initGit ?? true,
+			installSkills: args.installSkills ?? true,
+			runCodegen: args.runCodegen ?? true
+		};
+	}
 	p.intro(pc.bgCyan(pc.black(" QUESTPIE — Create a new project ")));
 	const questions = await p.group({
 		projectName: () => {
-			if (args.projectName) return Promise.resolve(args.projectName);
+			if (args.projectName) {
+				if (!isValidPackageName(args.projectName)) throw new Error("Invalid package name (use lowercase, hyphens, no spaces).");
+				return Promise.resolve(args.projectName);
+			}
 			return p.text({
 				message: "Project name",
 				placeholder: "my-questpie-app",
@@ -128,6 +150,21 @@ async function runPrompts(args) {
 				message: "Initialize git repository?",
 				initialValue: true
 			});
+		},
+		installSkills: () => {
+			if (args.installSkills !== void 0) return Promise.resolve(args.installSkills);
+			return p.confirm({
+				message: "Install QUESTPIE agent skills into the project?",
+				initialValue: true
+			});
+		},
+		runCodegen: ({ results }) => {
+			if (args.runCodegen !== void 0) return Promise.resolve(args.runCodegen);
+			if (args.installDeps === false || results.installDeps === false) return Promise.resolve(false);
+			return p.confirm({
+				message: "Run QUESTPIE codegen after installing dependencies?",
+				initialValue: true
+			});
 		}
 	}, { onCancel: () => {
 		p.cancel("Operation cancelled.");
@@ -138,7 +175,9 @@ async function runPrompts(args) {
 		templateId: questions.templateId,
 		databaseName: questions.databaseName,
 		installDeps: questions.installDeps,
-		initGit: questions.initGit
+		initGit: questions.initGit,
+		installSkills: questions.installSkills,
+		runCodegen: questions.runCodegen
 	};
 }
 
@@ -179,7 +218,7 @@ function isTextFile(filename) {
 	return TEXT_EXTENSIONS.has(ext);
 }
 async function replaceInFile(filePath, vars) {
-	const content = await readFile(filePath, "utf-8");
+	const content = (await readFile(filePath)).toString("utf-8");
 	const replaced = content.replace(TEMPLATE_VAR_REGEX, (match, key) => {
 		return key in vars ? vars[key] : match;
 	});
@@ -203,6 +242,50 @@ async function renameEnvExample(targetDir) {
 	const envPath = join(targetDir, "env.example");
 	if (existsSync(envPath)) await rename(envPath, join(targetDir, ".env.example"));
 }
+async function createLocalEnv(targetDir) {
+	const examplePath = join(targetDir, ".env.example");
+	const envPath = join(targetDir, ".env");
+	if (existsSync(examplePath) && !existsSync(envPath)) await cp(examplePath, envPath);
+}
+function getSkillSources(targetDir) {
+	return [{
+		name: "questpie",
+		candidates: [
+			resolve(import.meta.dirname, "..", "skills", "questpie"),
+			join(targetDir, "node_modules", "questpie", "skills", "questpie"),
+			resolve(import.meta.dirname, "..", "..", "questpie", "skills", "questpie"),
+			resolve(import.meta.dirname, "..", "..", "..", "skills", "questpie")
+		]
+	}, {
+		name: "questpie-admin",
+		candidates: [
+			resolve(import.meta.dirname, "..", "skills", "questpie-admin"),
+			join(targetDir, "node_modules", "@questpie", "admin", "skills", "questpie-admin"),
+			resolve(import.meta.dirname, "..", "..", "admin", "skills", "questpie-admin"),
+			resolve(import.meta.dirname, "..", "..", "..", "skills", "questpie-admin")
+		]
+	}];
+}
+async function installProjectSkills(targetDir) {
+	const installed = [];
+	const skillsDir = join(targetDir, ".agents", "skills");
+	for (const skill of getSkillSources(targetDir)) {
+		const source = skill.candidates.find((candidate) => existsSync(candidate));
+		if (!source) continue;
+		const destination = join(skillsDir, skill.name);
+		await mkdir(skillsDir, { recursive: true });
+		await rm(destination, {
+			recursive: true,
+			force: true
+		});
+		await cp(source, destination, {
+			recursive: true,
+			dereference: true
+		});
+		installed.push(skill.name);
+	}
+	return installed;
+}
 async function scaffold(options) {
 	const spinner = p.spinner();
 	const targetDir = resolve(process.cwd(), options.projectName);
@@ -214,7 +297,8 @@ async function scaffold(options) {
 		projectName: options.projectName,
 		databaseName: options.databaseName,
 		databaseUser: options.databaseName,
-		databasePassword: generatePassword()
+		databasePassword: generatePassword(),
+		authSecret: generatePassword(48)
 	};
 	spinner.start("Copying template files");
 	const templateDir = join(getTemplatesDir(), options.templateId);
@@ -228,17 +312,37 @@ async function scaffold(options) {
 	await renameGitignore(targetDir);
 	await renameEnvExample(targetDir);
 	await processDirectory(targetDir, vars);
+	await createLocalEnv(targetDir);
 	spinner.stop(label.success("Processed template variables"));
+	const pm = detectPackageManager();
 	if (options.installDeps) {
-		const pm$1 = detectPackageManager();
-		spinner.start(`Installing dependencies with ${pm$1}`);
+		spinner.start(`Installing dependencies with ${pm}`);
 		try {
-			installDependencies(targetDir, pm$1);
+			installDependencies(targetDir, pm);
 			spinner.stop(label.success("Installed dependencies"));
 		} catch {
 			spinner.stop(label.warn("Failed to install dependencies — run manually"));
 		}
 	}
+	if (options.installSkills) {
+		spinner.start("Installing QUESTPIE agent skills");
+		try {
+			const installedSkills = await installProjectSkills(targetDir);
+			if (installedSkills.length > 0) spinner.stop(label.success(`Installed skills: ${installedSkills.join(", ")}`));
+			else spinner.stop(label.warn("Could not find packaged skills — run `bunx skill add questpie/questpie` manually if available"));
+		} catch {
+			spinner.stop(label.warn("Failed to install skills — continuing"));
+		}
+	}
+	if (options.installDeps && options.runCodegen) {
+		spinner.start("Generating QUESTPIE app");
+		try {
+			runPackageScript(targetDir, pm, "scaffold:generate");
+			spinner.stop(label.success("Generated QUESTPIE app"));
+		} catch {
+			spinner.stop(label.warn("Failed to run codegen — run manually"));
+		}
+	}
 	if (options.initGit && isGitInstalled()) {
 		spinner.start("Initializing git repository");
 		try {
@@ -248,43 +352,54 @@ async function scaffold(options) {
 			spinner.stop(label.warn("Failed to initialize git — run manually"));
 		}
 	}
-	const pm = detectPackageManager();
-	const runCmd = pm === "npm" ? "npm run" : pm;
+	const runScript = (script) => pm === "npm" ? `npm run ${script}` : `${pm} run ${script}`;
+	const questpieBin = pm === "npm" ? "npx questpie" : "bunx questpie";
 	p.note([
 		`cd ${options.projectName}`,
 		"",
+		"# Review the generated environment",
+		"# .env has already been created from .env.example",
+		"",
 		"# Start PostgreSQL",
 		"docker compose up -d",
 		"",
+		"# Regenerate and type-check the scaffold",
+		runScript("scaffold:verify"),
+		"",
 		"# Run migrations",
-		`${runCmd} questpie migrate`,
+		runScript("migrate"),
 		"",
 		"# Start dev server",
-		`${runCmd} dev`,
+		runScript("dev"),
 		"",
 		"# Add entities (auto-runs codegen)",
-		`${runCmd} questpie add collection products`,
-		`${runCmd} questpie add global marketing`,
+		`${questpieBin} add collection products`,
+		`${questpieBin} add global marketing`,
 		"",
 		"# If you create files manually",
-		"bunx questpie generate"
+		runScript("questpie:generate")
 	].join("\n"), "Next steps");
 	p.outro(`${label.success("Done!")} Happy building with QUESTPIE!`);
 }
 
 //#endregion
 //#region src/index.ts
-new Command().name("create-questpie").description("Create a new QUESTPIE project").version("0.1.0").argument("[project-name]", "Name of the project").option("-t, --template <name>", "Template to use (default: tanstack-start)").option("--no-install", "Skip dependency installation").option("--no-git", "Skip git initialization").action(async (projectName, opts) => {
-	if (opts.template && !getTemplate(opts.template)) {
-		console.error(`Unknown template: ${opts.template}`);
+new Command().name("create-questpie").description("Create a new QUESTPIE project").version("2.0.1").argument("[project-name]", "Name of the project").option("-t, --template <name>", "Template to use (default: tanstack-start)").option("--database <name>", "Database name (default: derived from project name)").option("--no-install", "Skip dependency installation").option("--no-git", "Skip git initialization").option("--no-skills", "Skip installing project-local QUESTPIE agent skills").option("--no-generate", "Skip running QUESTPIE codegen after install").action(async (projectName, opts) => {
+	try {
+		if (opts.template && !getTemplate(opts.template)) throw new Error(`Unknown template: ${opts.template}`);
+		await scaffold(await runPrompts({
+			projectName,
+			templateId: opts.template,
+			databaseName: opts.database,
+			installDeps: opts.install === false ? false : void 0,
+			initGit: opts.git === false ? false : void 0,
+			installSkills: opts.skills === false ? false : void 0,
+			runCodegen: opts.generate === false ? false : void 0
+		}));
+	} catch (error) {
+		console.error(error instanceof Error ? error.message : String(error));
 		process.exit(1);
 	}
-	await scaffold(await runPrompts({
-		projectName,
-		templateId: opts.template,
-		installDeps: opts.install === false ? false : void 0,
-		initGit: opts.git === false ? false : void 0
-	}));
 }).parse();
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-questpie",
-	"version": "2.0.0",
+	"version": "2.0.2",
 	"description": "Create a new QUESTPIE project",
 	"keywords": [
 		"create",
@@ -20,7 +20,8 @@
 	},
 	"files": [
 		"dist",
-		"templates"
+		"templates",
+		"skills"
 	],
 	"type": "module",
 	"publishConfig": {
@@ -29,7 +30,8 @@
 	"scripts": {
 		"build": "tsdown",
 		"dev": "tsdown --watch",
-		"check-types": "tsc --noEmit"
+		"check-types": "tsc --noEmit",
+		"test": "bun test test"
 	},
 	"dependencies": {
 		"@clack/prompts": "^0.10.0",