@percepta/create 3.0.1 → 3.1.2

package/README.md

@@ -8,7 +8,7 @@ Scaffold and manage Mosaic packages.
 npx @percepta/create
 ```
 
-That's it. The CLI prompts you for the project name and (depending on context) whether it's a webapp. Defaults yield a running app — sign in as `admin@example.com` / `password`.
+That's it. The CLI prompts you for the package type, repo name, and package name as needed. Defaults yield a running app — sign in as `admin@example.com` / `password`.
 
 ## Options (mostly for automation)
 
@@ -17,7 +17,9 @@ The bare command above is the canonical UX. The flags below exist for tests and
 | Option | Description |
 |--------|-------------|
 | `-t, --type <type>` | Package type: `monorepo`, `webapp`, or `library` (skips the type prompt) |
-| `--name <name>` | Project name (skips the name prompt) |
+| `--name <name>` | Package/app name (skips the package name prompt) |
+| `--repo-name <name>` | Repo name when creating a new monorepo (skips the repo name prompt) |
+| `--cwd <dir>` | Run as if the CLI was started from `<dir>` |
 | `--skip-install` | Skip dependency installation, which also skips the auto-run setup + dev + browser, leaving you with manual next-steps |
 | `-y, --yes` | Skip all prompts; requires `--name` |
 
@@ -33,7 +35,7 @@ The bare command above is the canonical UX. The flags below exist for tests and
 
 `create` auto-detects whether you're inside an existing pnpm monorepo (by walking up for `pnpm-workspace.yaml`) and changes its prompts accordingly:
 
-- **Outside a monorepo** — pick `Monorepo` (default) or `Library`. If `Monorepo`, you're asked "Initialize with a webapp?" (Y/n, default Y). Picking the webapp option scaffolds a monorepo with a webapp inside `packages/<name>/`. Declining gives you an empty monorepo.
+- **Outside a monorepo** — you're asked "Initialize with a webapp?" (Y/n, default Y), then for the repo name. Picking the webapp option also asks for the webapp name and scaffolds it inside `packages/<webapp-name>/`. Declining gives you an empty monorepo.
 - **Inside a monorepo** — pick `Webapp` (default) or `Library` to add a new package under the workspace pattern.
 
 ## Happy-path: zero-friction webapp
@@ -41,9 +43,10 @@ The bare command above is the canonical UX. The flags below exist for tests and
 When you scaffold a webapp (the default flow), `create` automatically runs:
 
 1. `pnpm install` (at the monorepo root)
-2. `pnpm run setup` — Docker Compose Postgres + Drizzle migrations + seed user
-3. `pnpm dev` — Next.js dev server
-4. Opens the served URL in your default browser
+2. `pnpm install --ignore-workspace` (inside the webapp package, to create the Docker build lockfile)
+3. `pnpm run setup` — Docker Compose Postgres + Drizzle migrations + seed user
+4. `pnpm dev` — Next.js dev server
+5. Opens the served URL in your default browser
 
 Sign in as `admin@example.com` / `password` to start building.
 
@@ -74,9 +77,13 @@ pnpm build
 ### Testing locally
 
 ```bash
-pnpm build
-npm link
-create test-app
+pnpm create:local --cwd /tmp --name test-app --yes --skip-install
+```
+
+From the repo root, the same script can be run with a filter:
+
+```bash
+pnpm --filter @percepta/create create:local --cwd /tmp --name test-app --yes --skip-install
 ```
 
 ### Syncing template files

package/dist/{chunk-GEVZERMP.js → chunk-CG7IJSB4.js}

@@ -77,17 +77,48 @@ async function promptInsideMonorepoType() {
 }
 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 {
-    finalName = defaults.name || await promptName("Project name?");
     projectType = defaults.projectType ?? await promptOutsideMonorepoType();
+    await defaults.beforeNamePrompt?.(projectType);
+    const repoName = defaults.repoName || (projectType === "monorepo" ? defaults.name : void 0) || await promptName("Repo name?");
+    const repoTitle = toTitleCase(repoName);
+    if (projectType === "monorepo") {
+      finalName = repoName;
+      const finalTitle3 = repoTitle;
+      const finalDirectory3 = path.resolve(cwd, repoName);
+      return {
+        projectType,
+        directory: finalDirectory3,
+        name: finalName,
+        title: finalTitle3,
+        installDeps: !defaults.skipInstall,
+        monorepoName: repoName,
+        monorepoTitle: repoTitle
+      };
+    }
+    const packageNamePrompt = projectType === "webapp" ? "Webapp name?" : "Library name?";
+    finalName = defaults.name || await promptName(packageNamePrompt);
+    const finalTitle2 = toTitleCase(finalName);
+    const finalDirectory2 = path.resolve(cwd, repoName);
+    return {
+      projectType,
+      directory: finalDirectory2,
+      name: finalName,
+      title: finalTitle2,
+      installDeps: !defaults.skipInstall,
+      monorepoName: repoName,
+      monorepoTitle: repoTitle
+    };
   }
   const finalTitle = finalName ? toTitleCase(finalName) : "";
-  const finalDirectory = !inMonorepo && finalName ? path.resolve(process.cwd(), finalName) : "";
+  const finalDirectory = !inMonorepo && finalName ? path.resolve(cwd, finalName) : "";
   return {
     projectType,
     directory: finalDirectory,

package/dist/{chunk-R4FWPE4A.js → chunk-DCM7JOSC.js}

@@ -11,14 +11,14 @@ function getLatestTemplateTag(type, repoPath) {
       { cwd: repoPath, encoding: "utf-8" }
     ).trim();
     if (!tags) return null;
-    return tags.split("\n")[0];
+    return tags.split("\n")[0] ?? null;
   } catch {
     return null;
   }
 }
 function getTemplateVersionFromTag(tag) {
   const parts = tag.split("/");
-  return parts[parts.length - 1];
+  return parts[parts.length - 1] ?? "";
 }
 function getTemplateDiff(repoPath, templatePath, fromTag, toTag) {
   return execFileSync(