@percepta/create 3.0.1 → 3.1.0

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 and project name. Defaults yield a running app — sign in as `admin@example.com` / `password`.
 
 ## Options (mostly for automation)
 
@@ -33,7 +33,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) before the project name. Picking the webapp option scaffolds a monorepo with a webapp inside `packages/<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 +41,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.
 

package/dist/{chunk-GEVZERMP.js → chunk-7NPWSTCY.js}

@@ -81,10 +81,12 @@ async function promptProjectDetails(defaults) {
   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);
+    finalName = defaults.name || await promptName("Project name?");
   }
   const finalTitle = finalName ? toTitleCase(finalName) : "";
   const finalDirectory = !inMonorepo && finalName ? path.resolve(process.cwd(), finalName) : "";

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(

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   toSnakeCase,
   toTitleCase,
   validateProjectName
-} from "./chunk-GEVZERMP.js";
+} from "./chunk-7NPWSTCY.js";
 import {
   derivePlaceholders,
   writeManifest
@@ -17,9 +17,9 @@ import {
 import { program } from "commander";
 
 // src/commands/create.ts
-import path6 from "path";
+import path7 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import fs6 from "fs-extra";
+import fs7 from "fs-extra";
 import chalk from "chalk";
 import ora from "ora";
 import { execSync, spawn } from "child_process";
@@ -294,14 +294,90 @@ async function relocateWorkflowsToRoot(packageDir, monorepoRoot, appName) {
   }
 }
 
+// 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"
+];
+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();
+}
+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;
+}
+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 };
+}
+
 // src/commands/create.ts
 var PACKAGE_MANAGER = "pnpm";
 function shPath(p) {
-  return p.split(path6.sep).join("/");
+  return p.split(path7.sep).join("/");
 }
-function runPackageManagerInstall(packageManager, cwd) {
+function runPackageManagerInstall(packageManager, cwd, args = ["install"]) {
   return new Promise((resolve, reject) => {
-    const child = spawn(packageManager, ["install"], {
+    const child = spawn(packageManager, args, {
       cwd,
       stdio: "ignore"
     });
@@ -311,7 +387,7 @@ function runPackageManagerInstall(packageManager, cwd) {
       else
         reject(
           new Error(
-            `${packageManager} install exited with code ${code ?? "unknown"}`
+            `${packageManager} ${args.join(" ")} exited with code ${code ?? "unknown"}`
           )
         );
     });
@@ -415,12 +491,12 @@ async function autoRunWebapp(packageDir) {
   return true;
 }
 function readTemplateVersions() {
-  const versionsPath = path6.resolve(
-    path6.dirname(fileURLToPath2(import.meta.url)),
+  const versionsPath = path7.resolve(
+    path7.dirname(fileURLToPath2(import.meta.url)),
     "../template-versions.json"
   );
   try {
-    const content = fs6.readFileSync(versionsPath, "utf-8");
+    const content = fs7.readFileSync(versionsPath, "utf-8");
     return JSON.parse(content);
   } catch {
     return {};
@@ -439,8 +515,8 @@ async function writeMosaicFiles(packageDir, config, projectType) {
     }
   };
   await writeManifest(packageDir, manifest);
-  const notesPath = path6.join(packageDir, "mosaic-template-notes.md");
-  await fs6.writeFile(
+  const notesPath = path7.join(packageDir, "mosaic-template-notes.md");
+  await fs7.writeFile(
     notesPath,
     `# Mosaic Divergence Notes
 
@@ -499,10 +575,32 @@ async function addPackageToMonorepo(args) {
   }
   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));
+  }
+}
 function initGitRepo(targetDir) {
   const gitSpinner = ora("Initializing git repository...").start();
   try {
@@ -533,6 +631,27 @@ async function installAtMonorepoRoot(monorepoRoot, installDeps) {
     return false;
   }
 }
+async function installAtWebappPackage(packageDir, projectType, installDeps) {
+  if (!installDeps || !packageDir || projectType !== "webapp") {
+    return projectType !== "webapp";
+  }
+  const spinner = ora(
+    `Generating package lockfile with ${PACKAGE_MANAGER}...`
+  ).start();
+  try {
+    await runPackageManagerInstall(PACKAGE_MANAGER, packageDir, [
+      "install",
+      "--ignore-workspace"
+    ]);
+    spinner.succeed("Generated package lockfile");
+    return true;
+  } catch {
+    spinner.warn(
+      `Failed to generate package lockfile. Run '${PACKAGE_MANAGER} install --ignore-workspace' from ${packageDir}.`
+    );
+    return false;
+  }
+}
 async function maybeAutoRunWebapp(packageDir, projectType, installSucceeded) {
   if (!packageDir || projectType !== "webapp" || !installSucceeded) return false;
   return autoRunWebapp(packageDir);
@@ -551,6 +670,35 @@ function getProjectTypeLabel(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);
+}
 async function createProject(options) {
   if (options.type !== void 0 && !isValidProjectType(options.type)) {
     console.error(
@@ -603,8 +751,9 @@ async function createProject(options) {
   let answers;
   if (options.yes) {
     const projectType = options.type || "webapp";
+    requireNpmTokenForWebappInstall(projectType, !options.skipInstall);
     const kebabName = toKebabCase(projectName);
-    const directory = monorepoContext.found && monorepoContext.packageDir ? path6.join(monorepoContext.packageDir, kebabName) : path6.resolve(cwd, kebabName);
+    const directory = monorepoContext.found && monorepoContext.packageDir ? path7.join(monorepoContext.packageDir, kebabName) : path7.resolve(cwd, kebabName);
     answers = {
       projectType,
       directory,
@@ -617,34 +766,13 @@ async function createProject(options) {
       projectType: options.type,
       name: projectName ? toKebabCase(projectName) : void 0,
       skipInstall: options.skipInstall,
-      monorepoContext
+      monorepoContext,
+      beforeNamePrompt: (projectType) => requireNpmTokenForWebappInstall(projectType, !options.skipInstall)
     });
     if (monorepoContext.found && monorepoContext.packageDir && !answers.directory) {
-      answers.directory = path6.join(monorepoContext.packageDir, answers.name);
+      answers.directory = path7.join(monorepoContext.packageDir, answers.name);
     }
   }
-  if (answers.projectType === "webapp" && answers.installDeps && !process.env.NPM_TOKEN) {
-    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);
-  }
   const config = {
     name: answers.name,
     title: answers.title,
@@ -655,7 +783,7 @@ async function createProject(options) {
   const typeLabel = getProjectTypeLabel(answers.projectType);
   if (monorepoContext.found) {
     const monorepoRoot = monorepoContext.rootDir;
-    const packageDir = monorepoContext.packageDir ? path6.join(monorepoContext.packageDir, answers.name) : answers.directory;
+    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);
@@ -664,8 +792,8 @@ async function createProject(options) {
       console.log(chalk.dim("  Database:"), config.dbName);
     }
     console.log();
-    if (await fs6.pathExists(packageDir)) {
-      const files = await fs6.readdir(packageDir);
+    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.`)
@@ -682,15 +810,21 @@ async function createProject(options) {
       });
     }
     await warnIfMissingRootNpmrc(monorepoRoot);
-    const installSucceeded = await installAtMonorepoRoot(
+    const rootInstallSucceeded = await installAtMonorepoRoot(
       monorepoRoot,
       answers.installDeps
     );
+    const packageInstallSucceeded = await installAtWebappPackage(
+      packageDir,
+      answers.projectType,
+      answers.installDeps
+    );
+    const installSucceeded = answers.projectType === "webapp" ? rootInstallSucceeded && packageInstallSucceeded : rootInstallSucceeded;
     console.log();
     console.log(
       chalk.green("\u2714"),
       chalk.bold(`Created ${typeLabel} at`),
-      chalk.cyan(path6.relative(monorepoRoot, packageDir))
+      chalk.cyan(path7.relative(monorepoRoot, packageDir))
     );
     console.log();
     const devStarted = await maybeAutoRunWebapp(
@@ -703,7 +837,7 @@ async function createProject(options) {
   } else {
     const isBareMonorepo = answers.projectType === "monorepo";
     const monorepoRoot = answers.directory;
-    const packageDir = isBareMonorepo ? null : path6.join(monorepoRoot, "packages", answers.name);
+    const packageDir = isBareMonorepo ? null : path7.join(monorepoRoot, "packages", answers.name);
     if (isBareMonorepo) {
       console.log(chalk.dim("  Type:"), typeLabel);
       console.log(chalk.dim("  Directory:"), monorepoRoot);
@@ -720,8 +854,8 @@ async function createProject(options) {
       }
     }
     console.log();
-    if (await fs6.pathExists(monorepoRoot)) {
-      const files = await fs6.readdir(monorepoRoot);
+    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.`)
@@ -739,10 +873,16 @@ async function createProject(options) {
       });
     }
     initGitRepo(monorepoRoot);
-    const installSucceeded = await installAtMonorepoRoot(
+    const rootInstallSucceeded = await installAtMonorepoRoot(
       monorepoRoot,
       answers.installDeps
     );
+    const packageInstallSucceeded = await installAtWebappPackage(
+      packageDir,
+      answers.projectType,
+      answers.installDeps
+    );
+    const installSucceeded = answers.projectType === "webapp" ? rootInstallSucceeded && packageInstallSucceeded : rootInstallSucceeded;
     console.log();
     console.log(
       chalk.green("\u2714"),
@@ -776,12 +916,15 @@ function printWebappNextSteps(params) {
   } = params;
   const repoRel = shPath(monorepoRelativePath) || ".";
   const pkgFromRoot = `packages/${answers.name}`;
+  const packageInstallStep = `${pm} install --ignore-workspace`;
   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}`, ...pnpmSteps);
+    oneLinerParts2.push(`cd ${pkgFromRoot}`);
+    if (!answers.installDeps) oneLinerParts2.push(packageInstallStep);
+    oneLinerParts2.push(...pnpmSteps);
     console.log(chalk.bold("Copy-paste (from your current directory):"));
     console.log();
     console.log(chalk.cyan(`  ${oneLinerParts2.join(" && ")}`));
@@ -796,6 +939,9 @@ function printWebappNextSteps(params) {
       console.log(chalk.dim(`  ${step2++}.`), `${pm} install`);
     }
     console.log(chalk.dim(`  ${step2++}.`), `cd ${pkgFromRoot}`);
+    if (!answers.installDeps) {
+      console.log(chalk.dim(`  ${step2++}.`), packageInstallStep);
+    }
     for (const cmd of pnpmSteps) {
       console.log(chalk.dim(`  ${step2++}.`), cmd);
     }
@@ -805,7 +951,7 @@ function printWebappNextSteps(params) {
   const oneLinerParts = [];
   if (!answers.installDeps) {
     if (repoRel !== ".") oneLinerParts.push(`cd ${repoRel}`);
-    oneLinerParts.push(`${pm} install`, `cd ${pkgFromRoot}`);
+    oneLinerParts.push(`${pm} install`, `cd ${pkgFromRoot}`, packageInstallStep);
   } else if (pkgRel !== ".") {
     oneLinerParts.push(`cd ${pkgRel}`);
   }
@@ -823,6 +969,7 @@ function printWebappNextSteps(params) {
     }
     console.log(chalk.dim(`  ${step++}.`), `${pm} install`);
     console.log(chalk.dim(`  ${step++}.`), `cd ${pkgFromRoot}`);
+    console.log(chalk.dim(`  ${step++}.`), packageInstallStep);
   } else if (pkgRel !== ".") {
     console.log(chalk.dim(`  ${step++}.`), `cd ${pkgRel}`);
   }
@@ -831,10 +978,10 @@ function printWebappNextSteps(params) {
   }
 }
 async function warnIfMissingRootNpmrc(rootDir) {
-  const rootNpmrc = path6.join(rootDir, ".npmrc");
+  const rootNpmrc = path7.join(rootDir, ".npmrc");
   let contents = "";
-  if (await fs6.pathExists(rootNpmrc)) {
-    contents = await fs6.readFile(rootNpmrc, "utf8");
+  if (await fs7.pathExists(rootNpmrc)) {
+    contents = await fs7.readFile(rootNpmrc, "utf8");
   }
   if (contents.includes("@percepta:registry")) {
     return;
@@ -849,7 +996,7 @@ async function warnIfMissingRootNpmrc(rootDir) {
       "  pnpm reads .npmrc from the workspace root, so add these lines to"
     )
   );
-  console.log(chalk.dim(`  ${path6.join(rootDir, ".npmrc")}:`));
+  console.log(chalk.dim(`  ${path7.join(rootDir, ".npmrc")}:`));
   console.log();
   console.log(
     chalk.cyan("    @percepta:registry=https://registry.npmjs.org/")
@@ -861,7 +1008,7 @@ async function warnIfMissingRootNpmrc(rootDir) {
 }
 function printNextStepsNew(answers, options, targetDir) {
   const pm = PACKAGE_MANAGER;
-  const relativePath = path6.relative(process.cwd(), targetDir) || ".";
+  const relativePath = path7.relative(process.cwd(), targetDir) || ".";
   console.log("Next steps:");
   console.log();
   switch (answers.projectType) {
@@ -917,9 +1064,9 @@ function printNextStepsNew(answers, options, targetDir) {
 }
 function printNextStepsExisting(answers, options, packageDir) {
   const pm = PACKAGE_MANAGER;
-  const packageRelativePath = path6.relative(process.cwd(), packageDir) || ".";
-  const monorepoRoot = path6.dirname(path6.dirname(packageDir));
-  const monorepoRelativePath = path6.relative(process.cwd(), monorepoRoot) || ".";
+  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) {
@@ -964,25 +1111,25 @@ program.command("status").description("Show template sync status for current app
   "--mosaic-template-path <path>",
   "Path to local mosaic repo checkout"
 ).action(async (options) => {
-  const { statusCommand } = await import("./status-MITGDLTT.js");
+  const { statusCommand } = await import("./status-BTHGN6QH.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-J4SFZHDX.js");
+  const { syncCommand } = await import("./sync-3Q27L7XZ.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-AQI7P4EU.js");
+  const { upstreamCommand } = await import("./upstream-C5KFAHVR.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-Z4VGBHAK.js");
+  const { initCommand } = await import("./init-NP6GRXLL.js");
   await initCommand(options);
 });
 program.parse();

package/dist/{init-Z4VGBHAK.js → init-NP6GRXLL.js}

@@ -1,7 +1,7 @@
 import {
   VALID_PROJECT_TYPES,
   isValidProjectType
-} from "./chunk-GEVZERMP.js";
+} from "./chunk-7NPWSTCY.js";
 import {
   derivePlaceholders,
   manifestExists,

package/dist/{status-MITGDLTT.js → status-BTHGN6QH.js}

@@ -1,7 +1,7 @@
 import {
   getLatestTemplateTag,
   getTemplateVersionFromTag
-} from "./chunk-R4FWPE4A.js";
+} from "./chunk-DCM7JOSC.js";
 import {
   readManifest
 } from "./chunk-WMJT7CB5.js";

package/dist/{sync-J4SFZHDX.js → sync-3Q27L7XZ.js}

@@ -2,7 +2,7 @@ import {
   getLatestTemplateTag,
   getTemplateDiff,
   getTemplateVersionFromTag
-} from "./chunk-R4FWPE4A.js";
+} from "./chunk-DCM7JOSC.js";
 import {
   readManifest,
   resolveMosaicTemplatePath

package/dist/{upstream-AQI7P4EU.js → upstream-C5KFAHVR.js}

@@ -1,6 +1,6 @@
 import {
   getFileAtTag
-} from "./chunk-R4FWPE4A.js";
+} from "./chunk-DCM7JOSC.js";
 import {
   readManifest,
   resolveMosaicTemplatePath

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@percepta/create",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Scaffold a new Mosaic package",
   "type": "module",
   "bin": {

package/templates/webapp/.github/workflows/__APP_NAME__-ryvn-release.yaml

@@ -9,7 +9,7 @@ on:
       - "packages/__APP_NAME__/scripts/**"
       - "packages/__APP_NAME__/Dockerfile"
       - "packages/__APP_NAME__/package.json"
-      - "pnpm-lock.yaml"
+      - "packages/__APP_NAME__/pnpm-lock.yaml"
       - ".github/workflows/__APP_NAME__-ryvn-release.yaml"
   pull_request:
     branches:
@@ -19,7 +19,7 @@ on:
       - "packages/__APP_NAME__/scripts/**"
       - "packages/__APP_NAME__/Dockerfile"
       - "packages/__APP_NAME__/package.json"
-      - "pnpm-lock.yaml"
+      - "packages/__APP_NAME__/pnpm-lock.yaml"
   workflow_dispatch:
 
 env:
@@ -66,6 +66,7 @@ jobs:
           service_name: ${{ env.SERVICE_NAME }}
           version: ${{ steps.generate-tag.outputs.version }}
           build_only: ${{ !(github.ref == format('refs/heads/{0}', github.event.repository.default_branch) || steps.generate-tag.outputs.isPreview == 'true') }}
+          build_args: NPM_TOKEN=${{ secrets.NPM_TOKEN }}
           ryvn_client_id: ${{ secrets.RYVN_CLIENT_ID }}
           ryvn_client_secret: ${{ secrets.RYVN_CLIENT_SECRET }}
 

package/templates/webapp/AGENTS.md

@@ -24,7 +24,7 @@ Next.js 15 full-stack application scaffolded from the Mosaic webapp template via
 - Logger messages must be plain string literals, not variables or templates
 - `no-process-env` is enforced — use `getEnvConfig()` from `src/config/`
 - Use `@percepta/design` components before writing custom UI
-- Use `AsyncContent` from `@percepta/components` for loading/error states
+- For loading/error states, use local UI or add `@percepta/components` if you want `AsyncContent`
 - Tailwind CSS for all styling; icons from `lucide-react`
 
 ## Project Structure
@@ -114,10 +114,16 @@ export default [
 
 Vitest config is also available via `@percepta/build/vitest`.
 
-### @percepta/components — React Utilities
+### @percepta/components — Optional React Utilities
 
 Async data handling and hooks for React Query:
 
+Install this package first if you want these helpers:
+
+```bash
+pnpm add @percepta/components
+```
+
 - **`AsyncContent<T>`** — renders loading spinner, error state, or children based on a React Query result. Use this for all data-fetching UI.
 - **`AsyncArrayContent<T[]>`** — same but for multiple parallel queries
 - **`ErrorContainer`** — consistent error display

package/templates/webapp/Dockerfile

@@ -45,7 +45,6 @@ ENV BASE_PATH=${BASE_PATH}
 # Copy built app from builder stage
 COPY --from=builder /app/.next/standalone ./
 COPY --from=builder /app/.next/static ./.next/static
-COPY --from=builder /app/public ./public
 
 # Copy scripts and source files needed for start.sh and runtime
 COPY --from=builder /app/scripts ./scripts

package/templates/webapp/README.md

@@ -134,6 +134,7 @@ pnpm db:seed
 | `DATABASE_USERNAME` | Database user | `postgres` |
 | `DATABASE_PASSWORD` | Database password | `postgres` |
 | `DATABASE_NAME` | Database name | `__DB_NAME__` |
+| `DATABASE_SCHEMA` | Optional Postgres schema/search path | - |
 | `DATABASE_USE_SSL` | Enable SSL | `false` |
 
 ### Security