superslate 0.3.0 → 0.8.0

package/dist/cli.js

@@ -1329,6 +1329,7 @@ function isUnicodeSupported() {
 }
 var unicode = isUnicodeSupported();
 var isCI = () => process.env.CI === "true";
+var isTTY = (o2) => o2.isTTY === true;
 var unicodeOr = (o2, e) => unicode ? o2 : e;
 var S_STEP_ACTIVE = unicodeOr("◆", "*");
 var S_STEP_CANCEL = unicodeOr("■", "x");
@@ -1591,6 +1592,46 @@ var u4 = {
   heavy: unicodeOr("━", "="),
   block: unicodeOr("█", "#")
 };
+function progress({
+  style: o2 = "heavy",
+  max: d = 100,
+  size: v = 40,
+  ...x
+} = {}) {
+  const r2 = spinner(x);
+  let a2 = 0, n3 = "";
+  const c2 = Math.max(1, d), l2 = Math.max(1, v), S = (t2) => {
+    switch (t2) {
+      case "initial":
+      case "active":
+        return (e) => styleText2("magenta", e);
+      case "error":
+      case "cancel":
+        return (e) => styleText2("red", e);
+      case "submit":
+        return (e) => styleText2("green", e);
+      default:
+        return (e) => styleText2("magenta", e);
+    }
+  }, p2 = (t2, e) => {
+    const m2 = Math.floor(a2 / c2 * l2);
+    return `${S(t2)(u4[o2].repeat(m2))}${styleText2("dim", u4[o2].repeat(l2 - m2))} ${e}`;
+  }, h2 = (t2 = "") => {
+    n3 = t2, r2.start(p2("initial", t2));
+  }, g2 = (t2 = 1, e) => {
+    a2 = Math.min(c2, t2 + a2), r2.message(p2("active", e ?? n3)), n3 = e ?? n3;
+  };
+  return {
+    start: h2,
+    stop: r2.stop,
+    cancel: r2.cancel,
+    error: r2.error,
+    clear: r2.clear,
+    advance: g2,
+    isCancelled: r2.isCancelled,
+    message: (t2) => g2(0, t2)
+  };
+}
 var SELECT_INSTRUCTIONS = [
   `${styleText2("dim", "↑/↓")} to navigate`,
   `${styleText2("dim", "Enter:")} confirm`
@@ -1640,7 +1681,7 @@ import { existsSync, readdirSync, statSync } from "fs";
 import { mkdir as mkdir5, mkdtemp as mkdtemp2, readFile as readFile6, readdir as readdir2, rename as rename2, rm as rm5, rmdir, stat as stat5 } from "fs/promises";
 import { createConnection, createServer } from "net";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname as dirname2, join as join8, relative as relative2, resolve as resolve4, sep } from "path";
+import { dirname as dirname3, join as join8, relative as relative2, resolve as resolve4, sep } from "path";
 
 // src/constants.ts
 var CLI_NAME = "superslate";
@@ -1653,6 +1694,7 @@ var BUYER_CLI_NAME = "create-app";
 var BUYER_CLI_PACKAGE_NAME = "create-app";
 var DEFAULT_SCOPE = "@app";
 var SOURCE_BRAND_NAME = "superslate";
+var DOCS_BASE_URL = "https://docs.superslate.dev";
 var DELIVERY_BASE_URL = "https://dl.superslate.dev";
 var DELIVERY_URL_VARIABLE = "SUPERSLATE_DELIVERY_URL";
 var LICENSE_KEY_VARIABLE2 = "SUPERSLATE_LICENSE_KEY";
@@ -2278,9 +2320,17 @@ function isExecutable(path) {
 
 // src/agent-setup.ts
 var CLIENTS = ["codex", "claude", "cursor"];
-var SERVER_NAME = "superslate-docs";
-var CODEX_START = "# superslate-agent-context:start";
-var CODEX_END = "# superslate-agent-context:end";
+var SERVER_NAME = "agent-docs";
+var CODEX_START = "# agent-context:start";
+var CODEX_END = "# agent-context:end";
+var AGENT_CONTEXT_TOOLS = [
+  "search_docs",
+  "search_implementation",
+  "get_repository_map",
+  "plan_change",
+  "get_invariants",
+  "get_verification"
+];
 function takeValue(args, index, flag) {
   const value = args[index + 1];
   if (!value || value.startsWith("-"))
@@ -2311,7 +2361,7 @@ function parseAgentSetupArguments(argv) {
 function agentSetupUsage(cliName) {
   return `Usage: ${cliName} agent setup [options]
 
-Connect local coding clients to this checkout's read-only superslate documentation server.
+Connect local coding clients to this checkout's read-only project context server.
 
 Options:
   --clients <list>  Comma-separated clients: codex,claude,cursor
@@ -2332,12 +2382,12 @@ async function findAgentRepositoryRoot(start = process.cwd()) {
     }
     const parent = dirname(current);
     if (parent === current)
-      throw new Error("Run agent setup inside a superslate repository.");
+      throw new Error("Run agent setup inside a project repository.");
     current = parent;
   }
 }
 function serverCommand(root) {
-  return { command: "pnpm", args: ["--dir", resolve(root), "superslate:mcp"] };
+  return { command: "pnpm", args: ["--dir", resolve(root), "agent:mcp"] };
 }
 function codexManagedBlock(root) {
   const server = serverCommand(root);
@@ -2347,7 +2397,7 @@ function codexManagedBlock(root) {
 command = ${JSON.stringify(server.command)}
 args = [${args}]
 required = false
-enabled_tools = ["search_docs", "get_repository_map", "plan_change", "get_invariants", "get_verification"]
+enabled_tools = ${JSON.stringify(AGENT_CONTEXT_TOOLS)}
 ${CODEX_END}`;
 }
 function mergeCodexConfig(existing, root) {
@@ -2356,14 +2406,14 @@ function mergeCodexConfig(existing, root) {
   const end = existing.indexOf(CODEX_END);
   if (start >= 0 || end >= 0) {
     if (start < 0 || end < start)
-      throw new Error("Codex config has an incomplete superslate block.");
+      throw new Error("Codex config has an incomplete agent-context block.");
     const after = end + CODEX_END.length;
     return `${existing.slice(0, start).trimEnd()}
 
 ${managed}${existing.slice(after)}`.trimStart();
   }
-  if (/^\[mcp_servers\.(?:superslate-docs|superslate_docs|"superslate-docs")\]$/m.test(existing)) {
-    throw new Error("Codex already has an unmanaged superslate-docs server; remove or rename it first.");
+  if (/^\[mcp_servers\.(?:agent-docs|agent_docs|"agent-docs")\]$/m.test(existing)) {
+    throw new Error("Codex already has an unmanaged agent-docs server; remove or rename it first.");
   }
   return `${existing.trimEnd()}${existing.trim() ? `
 
@@ -2389,7 +2439,7 @@ function mergeCursorConfig(existing, root) {
   const current = servers[SERVER_NAME];
   const desired = serverCommand(root);
   if (current !== undefined && JSON.stringify(current) !== JSON.stringify(desired)) {
-    throw new Error("Cursor already has a different superslate-docs server; remove or rename it first.");
+    throw new Error("Cursor already has a different agent-docs server; remove or rename it first.");
   }
   config.mcpServers = { ...servers, [SERVER_NAME]: desired };
   return `${JSON.stringify(config, null, 2)}
@@ -2419,7 +2469,7 @@ async function addGitInfoExcludes(root, paths) {
   const prefix = existing && !existing.endsWith(`
 `) ? `
 ` : "";
-  const marker = "# superslate local agent configuration";
+  const marker = "# Local agent configuration";
   const heading = existing.split(/\r?\n/).includes(marker) ? "" : `${marker}
 `;
   await atomicWrite(excludePath, `${existing}${prefix}${heading}${missing.join(`
@@ -2450,10 +2500,10 @@ async function configureClaude(root) {
   if (existing.exitCode === 0) {
     const combined = `${existing.stdout}
 ${existing.stderr}`;
-    if (combined.includes("superslate:mcp") && combined.includes(root)) {
+    if (combined.includes("agent:mcp") && combined.includes(root)) {
       return "Claude Code already has the matching local server.";
     }
-    throw new Error("Claude Code already has a different superslate-docs server; remove it first.");
+    throw new Error("Claude Code already has a different agent-docs server; remove it first.");
   }
   const server = serverCommand(root);
   const result = await capture(["claude", "mcp", "add", SERVER_NAME, "--scope", "local", "--", server.command, ...server.args], root);
@@ -2464,14 +2514,15 @@ ${existing.stderr}`;
   return "Configured Claude Code local project scope.";
 }
 async function smokeServer(root) {
-  const result = await capture(["pnpm", "--dir", root, "superslate:mcp", "--check", "--root", root], root);
+  const result = await capture(["pnpm", "--dir", root, "agent:mcp", "--check", "--root", root], root);
   if (result.exitCode !== 0) {
     const output = result.stderr.trim() || result.stdout.trim();
-    throw new Error(`superslate MCP self-check failed${output ? `: ${output}` : "."}`);
+    throw new Error(`Agent context MCP self-check failed${output ? `: ${output}` : "."}`);
   }
   const report = JSON.parse(result.stdout);
-  if (!report.ok || report.tools !== 5)
-    throw new Error("superslate MCP self-check was incomplete.");
+  if (!report.ok || report.tools !== AGENT_CONTEXT_TOOLS.length) {
+    throw new Error("Agent context MCP self-check was incomplete.");
+  }
 }
 function detectedClients() {
   return CLIENTS.filter((client) => {
@@ -2541,7 +2592,7 @@ async function runAgentSetup(argv, cliName) {
   const clients = await chooseClients(parsed);
   if (!clients)
     return;
-  intro2("superslate local agent context");
+  intro2("Local agent context");
   if (parsed.dryRun) {
     for (const client of clients) {
       log2.info(`${client}
@@ -2550,16 +2601,16 @@ ${dryRunDescription(client, root)}`);
     outro2("Dry run complete. No client configuration was changed.");
     return;
   }
-  const progress = spinner2();
-  progress.start("Testing the local MCP server");
+  const progress2 = spinner2();
+  progress2.start("Testing the local MCP server");
   await smokeServer(root);
-  progress.stop("Local MCP server passed its protocol self-check");
+  progress2.stop("Local MCP server passed its protocol self-check");
   for (const client of clients) {
     const result = client === "codex" ? await configureCodex(root) : client === "cursor" ? await configureCursor(root) : await configureClaude(root);
     log2.success(`${client}: ${result}`);
   }
   log2.info("Restart configured clients, then ask: “Use plan_change for my next feature.”");
-  outro2("superslate agent context is ready.");
+  outro2("Agent context is ready.");
 }
 
 // src/deployment-cli.ts
@@ -2694,7 +2745,8 @@ Create a GitHub environment named \`${config.environment}\` and configure:
 - a \`BACKEND_HCL\` secret containing the selected remote-state backend configuration;
 - a \`TFVARS_JSON\` secret containing only:
   - ${providerInputs};
-- \`VITE_TERMS_URL\` and \`VITE_PRIVACY_URL\`.
+- \`VITE_TERMS_URL\` and \`VITE_PRIVACY_URL\`, plus \`VITE_MARKETING_URL\` when the product has a
+  public marketing site.
 
 ## Cloud preparation
 
@@ -3203,7 +3255,8 @@ Create a GitHub environment named \`${config.environment}\` and configure:
 - a \`BACKEND_HCL\` secret containing the selected remote-state backend configuration;
 - a \`TFVARS_JSON\` secret containing only:
   - ${providerInputs};
-- \`VITE_TERMS_URL\` and \`VITE_PRIVACY_URL\`.
+- \`VITE_TERMS_URL\` and \`VITE_PRIVACY_URL\`, plus \`VITE_MARKETING_URL\` when the product has a
+  public marketing site.
 
 ## Cloud preparation
 
@@ -3290,14 +3343,14 @@ import { execFile } from "node:child_process";
 import { createHash } from "node:crypto";
 import { cp, lstat, mkdir as mkdir4, mkdtemp, readFile as readFile5, readdir, rm as rm4, stat as stat4, writeFile as writeFile4 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { basename, join as join7, relative, resolve as resolve3 } from "node:path";
+import { basename, dirname as dirname2, join as join7, relative, resolve as resolve3 } from "node:path";
 import { promisify } from "node:util";
 
 // src/delivery.ts
 import { createWriteStream } from "node:fs";
 import { rm as rm3 } from "node:fs/promises";
 import { join as join6 } from "node:path";
-import { Readable } from "node:stream";
+import { Readable, Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 var RELEASE_TAG_PATTERN2 = /^v\d+\.\d+\.\d+(?:-rc\.\d+)?$/;
 var INDEX_TIMEOUT_MS = 15000;
@@ -3357,7 +3410,24 @@ async function resolveRelease(licenseKey, baseUrl = deliveryBaseUrl()) {
   }
   return index;
 }
-async function downloadAsset(licenseKey, releaseTag, assetName, directory, baseUrl = deliveryBaseUrl()) {
+function readContentLength(response) {
+  const header = response.headers.get("content-length");
+  if (!header)
+    return;
+  const total = Number(header);
+  return Number.isSafeInteger(total) && total > 0 ? total : undefined;
+}
+function countBytes(total, onBytes) {
+  let received = 0;
+  return new Transform({
+    transform(chunk, _encoding, done) {
+      received += chunk.length;
+      onBytes(received, total);
+      done(null, chunk);
+    }
+  });
+}
+async function downloadAsset(licenseKey, releaseTag, assetName, directory, baseUrl = deliveryBaseUrl(), onBytes) {
   const response = await requestDelivery(`${baseUrl}/v1/source/${encodeURIComponent(releaseTag)}/${encodeURIComponent(assetName)}`, {
     headers: { authorization: `Bearer ${licenseKey}` },
     signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS)
@@ -3365,8 +3435,13 @@ async function downloadAsset(licenseKey, releaseTag, assetName, directory, baseU
   if (!response.body)
     throw new Error(`Source delivery returned an empty ${assetName}.`);
   const path = join6(directory, assetName);
+  const source = Readable.fromWeb(response.body);
   try {
-    await pipeline(Readable.fromWeb(response.body), createWriteStream(path));
+    if (onBytes) {
+      await pipeline(source, countBytes(readContentLength(response), onBytes), createWriteStream(path));
+    } else {
+      await pipeline(source, createWriteStream(path));
+    }
   } catch {
     await rm3(path, { force: true });
     throw new Error(`Downloading ${assetName} was interrupted. Try again in a few minutes.`);
@@ -3383,6 +3458,9 @@ var BRAND_MANIFEST = [
   { path: "apps/web/public/favicon/site.webmanifest", occurrences: 2 },
   { path: "apps/web/public/offline.html", occurrences: 6 },
   { path: "apps/docs/lib/shared.ts", occurrences: 1 },
+  { path: "apps/docs/README.md", occurrences: 1 },
+  { path: "README.md", occurrences: 1 },
+  { path: "docs/meta.json", occurrences: 1 },
   { path: "apps/server/.env.example", occurrences: 1 },
   { path: "apps/server/src/config/env.ts", occurrences: 2 },
   { path: "apps/server/src/config/env.test.ts", occurrences: 1 },
@@ -3406,6 +3484,7 @@ var BRAND_MANIFEST = [
   { path: "apps/server/email-templates/security-alert.html", occurrences: 4 },
   { path: "apps/server/email-templates/verify-email.html", occurrences: 5 },
   { path: "apps/server/email-templates/reset-password.html", occurrences: 5 },
+  { path: "apps/server/email-templates/organization-invitation.html", occurrences: 3 },
   { path: "apps/server/email-templates/welcome-email.html", occurrences: 8 }
 ];
 function validateAppName2(value) {
@@ -3454,7 +3533,7 @@ function rewriteBrandContent(content, brandName) {
   if (error)
     throw new Error(error);
   const escapedSourceBrand = SOURCE_BRAND_NAME.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const sourceBrandPattern = new RegExp(`\\b${escapedSourceBrand}\\b`, "g");
+  const sourceBrandPattern = new RegExp(`\\b${escapedSourceBrand}\\b`, "gi");
   const matches = content.match(sourceBrandPattern);
   if (brandName === SOURCE_BRAND_NAME || !matches)
     return { content, replacements: 0 };
@@ -3552,6 +3631,20 @@ function rewriteRootPackageName(content, appName) {
   return { content: `${JSON.stringify(parsed, null, 2)}
 `, replacements: 1 };
 }
+var WORKER_NAME_DECLARATION = /^name = "[^"]*"$/m;
+function rewriteWorkerName(content, appName) {
+  const error = validateAppName2(appName);
+  if (error)
+    throw new Error(error);
+  const declaration = content.match(WORKER_NAME_DECLARATION)?.[0];
+  if (!declaration) {
+    throw new Error("Cloudflare Worker configuration is missing a name declaration.");
+  }
+  const replacement = `name = "${appName}"`;
+  if (declaration === replacement)
+    return { content, replacements: 0 };
+  return { content: content.replace(WORKER_NAME_DECLARATION, replacement), replacements: 1 };
+}
 function replaceMarkdownSection(content, heading, replacement) {
   const marker = `## ${heading}
 `;
@@ -3604,6 +3697,12 @@ into this repository.
   }
   return rewritten;
 }
+var BUYER_README_HEADING = "## Create your product";
+function stripDistributionReadmeBootstrap(content) {
+  if (!content.includes(BUYER_README_HEADING))
+    return content;
+  return replaceMarkdownSection(content, "Create your product", "");
+}
 var REQUIRED_BUYER_CLI_CONSTANTS = ["CLI_NAME", "CLI_PACKAGE_NAME", "DEFAULT_SCOPE"];
 function rewriteBuyerCliConstants(content, scope, brandName) {
   const buyerVariablePrefix = BUYER_CLI_NAME.toUpperCase().replaceAll("-", "_");
@@ -3614,6 +3713,7 @@ function rewriteBuyerCliConstants(content, scope, brandName) {
     ["SOURCE_BRAND_NAME", brandName],
     ["TEMPLATE_REPOSITORY", "OWNER/REPOSITORY"],
     ["DELIVERY_BASE_URL", "https://releases.example.com"],
+    ["DOCS_BASE_URL", "https://docs.example.com"],
     ["DELIVERY_URL_VARIABLE", `${buyerVariablePrefix}_DELIVERY_URL`],
     ["LICENSE_KEY_VARIABLE", `${buyerVariablePrefix}_LICENSE_KEY`],
     ["LICENSE_KEY_PREFIX", "LICENSE-"]
@@ -3633,6 +3733,7 @@ function rewriteBuyerCliConstants(content, scope, brandName) {
     CLI_PACKAGE_NAME,
     SOURCE_BRAND_NAME,
     DELIVERY_BASE_URL,
+    DOCS_BASE_URL,
     DELIVERY_URL_VARIABLE,
     LICENSE_KEY_VARIABLE2,
     LICENSE_KEY_PREFIX
@@ -3716,12 +3817,16 @@ function isTemplatePathExcluded(relativePath) {
     return true;
   if (normalized === "internal" || normalized.startsWith("internal/"))
     return true;
+  if (normalized === "marketing" || normalized.startsWith("marketing/"))
+    return true;
   if (normalized === ".github/workflows/internal-commercial.yml")
     return true;
   if (normalized === "apps/worker" || normalized.startsWith("apps/worker/"))
     return true;
   if (parts.includes("dist") || parts.includes("out"))
     return true;
+  if (parts.includes(".next") || parts.includes(".source") || parts.includes(".turbo"))
+    return true;
   if (normalized === "bun.lock")
     return true;
   if (normalized === ".vercelignore")
@@ -3734,6 +3839,8 @@ function isTemplatePathExcluded(relativePath) {
     return true;
   if (normalized === "packages/create-app/src/cli-brand-contract.test.ts")
     return true;
+  if (normalized === "packages/create-app/src/commercial-contract.test.ts")
+    return true;
   if (normalized === "packages/create-app/LICENSE")
     return true;
   if (normalized === "packages/create-app/README.md")
@@ -3762,6 +3869,29 @@ async function assertEmptyTarget(targetDirectory) {
       throw error;
   }
 }
+async function trackedTemplatePaths(sourceDirectory) {
+  const topLevel = await execFileAsync("git", ["rev-parse", "--show-toplevel"], {
+    cwd: sourceDirectory
+  }).then((result) => resolve3(result.stdout.trim())).catch(() => {
+    return;
+  });
+  if (topLevel !== sourceDirectory)
+    return;
+  const { stdout: stdout2 } = await execFileAsync("git", ["ls-files", "-z"], {
+    cwd: sourceDirectory,
+    maxBuffer: 64 * 1024 * 1024
+  });
+  const tracked = new Set;
+  for (const path of stdout2.split("\x00")) {
+    if (!path)
+      continue;
+    tracked.add(path);
+    for (let parent = dirname2(path);parent !== "."; parent = dirname2(parent)) {
+      tracked.add(parent);
+    }
+  }
+  return tracked;
+}
 async function copyLocalTemplate(source, target) {
   const sourceDirectory = resolve3(source);
   const sourceStat = await lstat(sourceDirectory).catch(() => {
@@ -3769,29 +3899,28 @@ async function copyLocalTemplate(source, target) {
   });
   if (!sourceStat?.isDirectory())
     throw new Error(`Template path is not a directory: ${sourceDirectory}`);
-  await assertNoSymbolicLinks(sourceDirectory, sourceDirectory, true);
+  const tracked = await trackedTemplatePaths(sourceDirectory);
+  const isTemplatePathIncluded = (relativePath) => relativePath === "" || !isTemplatePathExcluded(relativePath) && (!tracked || tracked.has(relativePath));
+  await assertNoSymbolicLinks(sourceDirectory, sourceDirectory, isTemplatePathIncluded);
   await mkdir4(target, { recursive: true });
   await cp(sourceDirectory, target, {
     recursive: true,
-    filter: (path) => {
-      const relativePath = relative(sourceDirectory, path);
-      return relativePath === "" || !isTemplatePathExcluded(relativePath);
-    }
+    filter: (path) => isTemplatePathIncluded(relative(sourceDirectory, path).replaceAll("\\", "/"))
   });
   await assertNoSymbolicLinks(target);
 }
-async function assertNoSymbolicLinks(directory, root = directory, skipExcludedPaths = false) {
+async function assertNoSymbolicLinks(directory, root = directory, isIncluded) {
   const entries = await readdir(directory, { withFileTypes: true });
   for (const entry of entries) {
     const path = join7(directory, entry.name);
-    const relativePath = relative(root, path);
-    if (skipExcludedPaths && isTemplatePathExcluded(relativePath))
+    const relativePath = relative(root, path).replaceAll("\\", "/");
+    if (isIncluded && !isIncluded(relativePath))
       continue;
     if (entry.isSymbolicLink()) {
       throw new Error(`Template contains a symbolic link, which is not supported: ${path}`);
     }
     if (entry.isDirectory())
-      await assertNoSymbolicLinks(path, root, skipExcludedPaths);
+      await assertNoSymbolicLinks(path, root, isIncluded);
   }
 }
 function verifyReleaseMetadata(checksum, manifest, artifactName, digest, templateRef) {
@@ -3806,14 +3935,14 @@ function verifyReleaseMetadata(checksum, manifest, artifactName, digest, templat
     throw new Error(`${CLI_NAME2} release manifest does not match the downloaded source artifact.`);
   }
 }
-async function downloadLicensedTemplate(target, licenseKey, sourceVersion) {
+async function downloadLicensedTemplate(target, licenseKey, sourceVersion, onDownloadProgress) {
   const baseUrl = deliveryBaseUrl();
   const releaseTag = sourceVersion ?? (await resolveRelease(licenseKey, baseUrl)).latest;
   const { artifact, checksum: checksumName, manifest: manifestName } = releaseAssetNames(releaseTag);
   const temporaryDirectory = await mkdtemp(join7(tmpdir(), `${CLI_NAME2}-`));
   const extractedPath = join7(temporaryDirectory, "template");
   try {
-    const archivePath = await downloadAsset(licenseKey, releaseTag, artifact, temporaryDirectory, baseUrl);
+    const archivePath = await downloadAsset(licenseKey, releaseTag, artifact, temporaryDirectory, baseUrl, onDownloadProgress);
     await downloadAsset(licenseKey, releaseTag, checksumName, temporaryDirectory, baseUrl);
     await downloadAsset(licenseKey, releaseTag, manifestName, temporaryDirectory, baseUrl);
     const archive = await readFile5(archivePath);
@@ -3888,6 +4017,14 @@ async function applyBrandRewrite(target, brandName) {
   }
   return report;
 }
+async function renameFrontendWorker(target, appName) {
+  const workerPath = join7(target, "apps/web/wrangler.toml");
+  if (!await stat4(workerPath).catch(() => {
+    return;
+  }))
+    return;
+  await rewriteFile(workerPath, (content) => rewriteWorkerName(content, appName));
+}
 async function generateEnvironmentFiles(target, databasePort = 5432) {
   const serverExample = await readFile5(join7(target, "apps/server/.env.example"), "utf8");
   await writeFile4(join7(target, "apps/server/.env"), generateServerEnv(serverExample, undefined, databasePort));
@@ -3901,8 +4038,10 @@ async function generateEnvironmentFiles(target, databasePort = 5432) {
 async function neutralizeAgentInstructions(target) {
   const agentPath = join7(target, "AGENTS.md");
   const claudePath = join7(target, "CLAUDE.md");
+  const readmePath = join7(target, "README.md");
   await writeFile4(agentPath, rewriteBuyerAgentInstructions(await readFile5(agentPath, "utf8")));
   await writeFile4(claudePath, rewriteBuyerClaudeInstructions(await readFile5(claudePath, "utf8")));
+  await writeFile4(readmePath, stripDistributionReadmeBootstrap(await readFile5(readmePath, "utf8")));
   const rootPackagePath = join7(target, "package.json");
   await writeFile4(rootPackagePath, stripSellerOnlyRootScripts(await readFile5(rootPackagePath, "utf8")));
 }
@@ -3965,12 +4104,13 @@ async function scaffold(options) {
     if (options.from)
       await copyLocalTemplate(options.from, target);
     else if (options.licenseKey) {
-      await downloadLicensedTemplate(target, options.licenseKey, options.sourceVersion);
+      await downloadLicensedTemplate(target, options.licenseKey, options.sourceVersion, options.onDownloadProgress);
     } else {
       throw new Error(`A local source path or a ${CLI_NAME2} licence key is required.`);
     }
     const packagePath = join7(target, "package.json");
     const packageReplacements = await rewriteFile(packagePath, (content) => rewriteRootPackageName(content, options.appName));
+    await renameFrontendWorker(target, options.appName);
     const scope = await applyScopeRewrite(target, options.scope);
     await neutralizeAgentInstructions(target);
     await neutralizeSourceCli(target, options.scope, options.brandName);
@@ -4009,7 +4149,7 @@ Create a buyer-owned SaaS application from your licensed ${suggestBrandName(CLI_
 Options:
   --license-key <key> Licence key from your purchase (or set ${LICENSE_KEY_VARIABLE})
   --source-version <version> Pin an immutable release (default: the latest you are entitled to)
-  --from <path>       Use a local source checkout (maintainer/testing)
+  --from <path>       Use a local Git checkout, tracked files only (maintainer/testing)
   --scope <namespace> Advanced workspace namespace override (default: derived from brand)
   --brand <name>      Display name (default: derived from app name)
   --yes               Accept recommended defaults for omitted options
@@ -4222,7 +4362,7 @@ async function collectOptions(parsed) {
   };
 }
 async function readCliVersion() {
-  const packageJson = JSON.parse(await readFile6(resolve4(dirname2(fileURLToPath2(import.meta.url)), "../package.json"), "utf8"));
+  const packageJson = JSON.parse(await readFile6(resolve4(dirname3(fileURLToPath2(import.meta.url)), "../package.json"), "utf8"));
   if (!packageJson.version)
     throw new Error(`${CLI_NAME} package version is missing.`);
   return packageJson.version;
@@ -4305,35 +4445,71 @@ async function installDependencies(target) {
     throw new Error(`Dependency installation failed.${commandFailureOutput(stdout2, stderr)}`);
   }
 }
-async function runCapturedCommand(command, target) {
-  const { stdout: stdout2, stderr, exitCode } = await runCaptured2(command, { cwd: target });
-  if (exitCode !== 0) {
-    throw new Error(`${command.join(" ")} failed.${commandFailureOutput(stdout2, stderr)}`);
-  }
-}
 async function occupiedDevelopmentPorts() {
   const results = await Promise.all([5173, 8000].map(async (port) => ({ port, available: await isPortAvailable(port) })));
   return results.filter((result) => !result.available).map((result) => result.port);
 }
 async function startDevelopment(target) {
-  await runStep("Starting local Postgres", "Local Postgres is ready", () => runCapturedCommand(["docker", "compose", "up", "-d", "--wait", "postgres"], target));
   log.info(`Web  http://localhost:5173
 API  http://localhost:8000`);
   outro("Development servers are starting. Ctrl+C stops app servers; Postgres stays running.");
-  const exitCode = await runInherited(["vp", "run", "-r", "--parallel", "dev"], { cwd: target });
+  const exitCode = await runInherited(["pnpm", "run", "dev"], { cwd: target });
   if (exitCode !== 0 && exitCode !== 130) {
     throw new Error(`Development servers exited with code ${exitCode}.`);
   }
 }
-async function runStep(pending, complete, action, indicator = "dots") {
-  const progress = spinner({ indicator });
-  progress.start(pending);
+var BYTE_UNITS = ["B", "KB", "MB", "GB"];
+var BYTE_SCALE = 1024;
+var PROGRESS_MAX = 100;
+var PROGRESS_BAR_WIDTH = 40;
+var PROGRESS_MIN_INTERVAL_MS = 80;
+var PROGRESS_MIN_DELTA = 0.5;
+function formatBytes(bytes) {
+  let value = bytes;
+  let unit = 0;
+  while (value >= BYTE_SCALE && unit < BYTE_UNITS.length - 1) {
+    value /= BYTE_SCALE;
+    unit += 1;
+  }
+  return `${unit === 0 ? value : value.toFixed(1)} ${BYTE_UNITS[unit]}`;
+}
+function supportsAnimation() {
+  return isTTY(process.stdout) && !isCI();
+}
+function createScaffoldReporter(pending, expectsDownload) {
+  if (!expectsDownload || !supportsAnimation())
+    return { handle: spinner() };
+  const bar = progress({
+    style: "heavy",
+    size: PROGRESS_BAR_WIDTH,
+    max: PROGRESS_MAX
+  });
+  let shown = 0;
+  let emittedAt = 0;
+  return {
+    handle: bar,
+    onDownloadProgress: (received, total) => {
+      const percent = total ? Math.min(PROGRESS_MAX, received / total * PROGRESS_MAX) : shown;
+      const finished = total !== undefined && received >= total;
+      const now = performance.now();
+      if (!finished && now - emittedAt < PROGRESS_MIN_INTERVAL_MS && percent - shown < PROGRESS_MIN_DELTA) {
+        return;
+      }
+      emittedAt = now;
+      const label = finished ? pending : total === undefined ? `Downloading source  ${formatBytes(received)}` : `Downloading source  ${formatBytes(received)} / ${formatBytes(total)}`;
+      bar.advance(percent - shown, label);
+      shown = percent;
+    }
+  };
+}
+async function runStep(pending, complete, action, handle) {
+  handle.start(pending);
   try {
     const result = await action();
-    progress.stop(complete);
+    handle.stop(complete);
     return result;
   } catch (error) {
-    progress.error(`${pending} failed`);
+    handle.error(`${pending} failed`);
     throw error;
   }
 }
@@ -4342,10 +4518,12 @@ async function createApplication(options) {
   await assertTargetAvailable(target);
   assertSiblingTarget(options.from, target);
   const databasePort = await findAvailablePort();
-  await mkdir5(dirname2(target), { recursive: true });
-  const staging = await mkdtemp2(join8(dirname2(target), `.${options.appName}-${CLI_NAME}-`));
+  await mkdir5(dirname3(target), { recursive: true });
+  const staging = await mkdtemp2(join8(dirname3(target), `.${options.appName}-${CLI_NAME}-`));
+  const preparing = "Preparing your application";
+  const reporter = createScaffoldReporter(preparing, Boolean(options.licenseKey));
   try {
-    await runStep("Preparing your application", "Application source prepared", () => scaffold({
+    await runStep(preparing, "Application source prepared", () => scaffold({
       appName: options.appName,
       scope: options.scope,
       brandName: options.brandName,
@@ -4354,13 +4532,14 @@ async function createApplication(options) {
       licenseKey: options.licenseKey,
       sourceVersion: options.sourceVersion,
       initializeGit: options.initializeGit,
-      databasePort
-    }));
+      databasePort,
+      onDownloadProgress: reporter.onDownloadProgress
+    }), reporter.handle);
     if (options.deployment) {
-      await runStep("Configuring deployment", "Deployment target locked", () => applyDeploymentSelection2(staging, options.appName, options.deployment));
+      await runStep("Configuring deployment", "Deployment target locked", () => applyDeploymentSelection2(staging, options.appName, options.deployment), spinner());
     }
     if (options.installDependencies) {
-      await runStep("Installing dependencies with pnpm", "Dependencies installed with pnpm", () => installDependencies(staging), "timer");
+      await runStep("Installing dependencies with pnpm", "Dependencies installed with pnpm", () => installDependencies(staging), spinner({ indicator: "timer" }));
     }
     if (await stat5(target).catch(() => {
       return;
@@ -4378,12 +4557,7 @@ function completionDetails(target, options, databasePort) {
   const install = options.installDependencies ? [] : ["vp install --frozen-lockfile"];
   return {
     directory: `./${targetName}`,
-    commands: [
-      `cd ${targetName}`,
-      ...install,
-      "docker compose up -d postgres",
-      "vp run -r --parallel dev"
-    ].join(`
+    commands: [`cd ${targetName}`, ...install, "pnpm dev"].join(`
 `),
     database: `Postgres  localhost:${databasePort}`
   };
@@ -4470,6 +4644,7 @@ export {
   printRunnableCommands,
   parseArguments,
   occupiedDevelopmentPorts,
+  formatBytes,
   findAvailablePort,
   describeTargetConflict,
   collectLicenseKey

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superslate",
-  "version": "0.3.0",
+  "version": "0.8.0",
   "description": "Create a production-oriented SaaS application from superslate.",
   "keywords": [
     "bun",
@@ -39,8 +39,9 @@
   },
   "devDependencies": {
     "@clack/prompts": "^1.7.0",
-    "@types/bun": "^1.3.14",
-    "typescript": "^7.0.2"
+    "@types/node": "^26.2.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
   },
   "engines": {
     "node": ">=20"