superslate 0.4.0 → 0.8.0

package/dist/cli.js

@@ -1681,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";
@@ -1694,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";
@@ -2319,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("-"))
@@ -2352,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
@@ -2373,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);
@@ -2388,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) {
@@ -2397,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() ? `
 
@@ -2430,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)}
@@ -2460,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(`
@@ -2491,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);
@@ -2505,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) => {
@@ -2582,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}
@@ -2600,7 +2610,7 @@ ${dryRunDescription(client, 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
@@ -2735,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
 
@@ -3244,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
 
@@ -3331,7 +3343,7 @@ 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
@@ -3446,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 },
@@ -3469,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) {
@@ -3517,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 };
@@ -3615,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}
 `;
@@ -3667,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("-", "_");
@@ -3677,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-"]
@@ -3696,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
@@ -3779,6 +3817,8 @@ 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/"))
@@ -3799,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")
@@ -3827,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(() => {
@@ -3834,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) {
@@ -3953,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));
@@ -3966,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")));
 }
@@ -4036,6 +4110,7 @@ async function scaffold(options) {
     }
     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);
@@ -4074,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
@@ -4287,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;
@@ -4443,8 +4518,8 @@ 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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superslate",
-  "version": "0.4.0",
+  "version": "0.8.0",
   "description": "Create a production-oriented SaaS application from superslate.",
   "keywords": [
     "bun",
@@ -39,7 +39,7 @@
   },
   "devDependencies": {
     "@clack/prompts": "^1.7.0",
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"
   },