create-thally-docs 0.9.0 → 0.10.1

package/dist/chunk-ORUAMPNF.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+
+// src/customize.ts
+import { cpSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+function readJsonObject(filePath, label) {
+  let value;
+  try {
+    value = JSON.parse(readFileSync(filePath, "utf8"));
+  } catch {
+    throw new Error(`The stable Thally starter contains invalid ${label}.`);
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`The stable Thally starter contains invalid ${label}.`);
+  }
+  return value;
+}
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function normalizedStarterLocales(locales) {
+  const normalized = [{ code: "en", label: "English" }];
+  const seen = /* @__PURE__ */ new Set(["en"]);
+  for (const locale of locales ?? []) {
+    const code = locale.code.trim().toLowerCase();
+    const label = locale.label.trim();
+    if (!/^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/.test(code) || !label || label.length > 80 || seen.has(code)) {
+      continue;
+    }
+    seen.add(code);
+    normalized.push({ code, label });
+  }
+  return normalized;
+}
+function updateStarterDocsConfig(targetDir, enableAiChat, repoUrl, i18nLocales) {
+  const configPath = join(targetDir, "docs.json");
+  const config = readJsonObject(configPath, "docs.json");
+  const ai = isRecord(config.ai) ? { ...config.ai } : {};
+  ai.chat = enableAiChat;
+  config.ai = ai;
+  const navbar = isRecord(config.navbar) ? { ...config.navbar } : {};
+  const existingLinks = Array.isArray(navbar.links) ? navbar.links : [];
+  const links = existingLinks.filter(
+    (link) => !isRecord(link) || link.type !== "github" && link.label !== "GitHub"
+  );
+  if (repoUrl) {
+    links.push({ label: "GitHub", href: repoUrl, type: "github" });
+  }
+  if (links.length > 0) navbar.links = links;
+  else delete navbar.links;
+  if (Object.keys(navbar).length > 0) config.navbar = navbar;
+  else delete config.navbar;
+  config.i18n = {
+    defaultLocale: "en",
+    locales: normalizedStarterLocales(i18nLocales)
+  };
+  writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+}
+function escapeTypeScriptString(value) {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\r/g, "\\r").replace(/\n/g, "\\n").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function replaceRequired(source, pattern, replacement, field) {
+  if (!pattern.test(source)) {
+    throw new Error(`The stable Thally starter is missing owner field ${field}.`);
+  }
+  return source.replace(pattern, replacement);
+}
+function updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl) {
+  if (!projectName.trim() || /[\0\r\n]/.test(projectName)) {
+    throw new Error("The documentation project name is invalid.");
+  }
+  if (!["primary", "secondary"].includes(brandPreset)) {
+    throw new Error("The documentation brand preset is invalid.");
+  }
+  const siteFile = join(targetDir, "src", "data", "site.ts");
+  if (!existsSync(siteFile)) {
+    throw new Error("The stable Thally starter is missing src/data/site.ts.");
+  }
+  const escapedName = escapeTypeScriptString(projectName);
+  const escapedDescription = escapeTypeScriptString(description);
+  const escapedRepoUrl = escapeTypeScriptString(repoUrl);
+  let source = readFileSync(siteFile, "utf8");
+  source = replaceRequired(
+    source,
+    /name:[ \t]*'(?:\\.|[^'\\\r\n])*'/,
+    `name: '${escapedName}'`,
+    "site.name"
+  );
+  source = replaceRequired(
+    source,
+    /description:[ \t]*(?:\r?\n[ \t]*)?'(?:\\.|[^'\\\r\n])*'/,
+    `description:
+    '${escapedDescription}'`,
+    "site.description"
+  );
+  source = replaceRequired(
+    source,
+    /const brandPreset:[ \t]*BrandPresetKey[ \t]*=[ \t]*'(?:\\.|[^'\\\r\n])*'/,
+    `const brandPreset: BrandPresetKey = '${brandPreset}'`,
+    "site.brandPreset"
+  );
+  source = replaceRequired(
+    source,
+    /repoUrl:[ \t]*'(?:\\.|[^'\\\r\n])*'/,
+    `repoUrl: '${escapedRepoUrl}'`,
+    "site.repoUrl"
+  );
+  source = source.replace(
+    /\{[ \t]*label:[ \t]*'GitHub',[ \t]*href:[ \t]*'(?:\\.|[^'\\\r\n])*'[ \t]*\}/,
+    `{ label: 'GitHub', href: '${escapedRepoUrl}' }`
+  );
+  source = source.replace(
+    /\{[ \t]*label:[ \t]*'Support',[ \t]*href:[ \t]*'(?:\\.|[^'\\\r\n])*'[ \t]*\}/,
+    `{ label: 'Support', href: '${escapedRepoUrl ? `${escapedRepoUrl}/issues/new` : ""}' }`
+  );
+  if (!repoUrl) {
+    source = source.replace(
+      /\r?\n[ \t]*\{[ \t]*label:[ \t]*'(?:GitHub|Support)',[ \t]*href:[ \t]*''[ \t]*\},?/g,
+      ""
+    );
+  }
+  writeFileSync(siteFile, source, "utf8");
+}
+function updatePackageIdentity(targetDir, packageName) {
+  const packagePath = join(targetDir, "package.json");
+  const packageJson = readJsonObject(packagePath, "package.json");
+  packageJson.name = packageName;
+  writeFileSync(packagePath, `${JSON.stringify(packageJson, null, 2)}
+`, "utf8");
+  const lockPath = join(targetDir, "package-lock.json");
+  if (!existsSync(lockPath)) return;
+  const lock = readJsonObject(lockPath, "package-lock.json");
+  lock.name = packageName;
+  if (isRecord(lock.packages) && isRecord(lock.packages[""])) {
+    lock.packages[""].name = packageName;
+  }
+  writeFileSync(lockPath, `${JSON.stringify(lock, null, 2)}
+`, "utf8");
+}
+function updateCloudflareRuntimeName(targetDir, packageName) {
+  const configPath = join(targetDir, "wrangler.jsonc");
+  if (!existsSync(configPath)) {
+    throw new Error("The stable Thally starter is missing wrangler.jsonc.");
+  }
+  const source = readFileSync(configPath, "utf8");
+  const pattern = /("name"\s*:\s*)"(?:\\.|[^"\\])*"/;
+  const updated = replaceRequired(
+    source,
+    pattern,
+    `$1${JSON.stringify(packageName)}`,
+    "wrangler.name"
+  );
+  writeFileSync(configPath, updated, "utf8");
+}
+function updateEnvExample(targetDir) {
+  const envFile = join(targetDir, ".env.example");
+  if (!existsSync(envFile)) return;
+  const envLocal = join(targetDir, ".env.local");
+  if (!existsSync(envLocal)) cpSync(envFile, envLocal);
+}
+function personalizeStarter(targetDir, options) {
+  updateStarterDocsConfig(
+    targetDir,
+    options.enableAiChat,
+    options.repoUrl,
+    options.i18nLocales
+  );
+  updateSiteConfig(
+    targetDir,
+    options.projectName,
+    options.description,
+    options.brandPreset,
+    options.repoUrl
+  );
+  updatePackageIdentity(targetDir, options.packageName);
+  updateCloudflareRuntimeName(targetDir, options.packageName);
+}
+
+export {
+  updateStarterDocsConfig,
+  updateSiteConfig,
+  updatePackageIdentity,
+  updateCloudflareRuntimeName,
+  updateEnvExample,
+  personalizeStarter
+};

package/dist/chunk-RLGB6QF3.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+// src/stable-scaffold-release.json
+var stable_scaffold_release_default = {
+  schemaVersion: 1,
+  id: "2026-08-05.9d281a7c.d44ad701",
+  source: {
+    repository: "thallylabs/starter",
+    commitSha: "9d281a7c209fa3ee187e325f87e72e7ad816f191",
+    treeSha: "8a46fb5d8f601251270ba3b477b6c786403c628b",
+    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/9d281a7c209fa3ee187e325f87e72e7ad816f191",
+    manifestPath: "starter-release.json",
+    manifestSha256: "b662c9d156e04918ea5ff6713c3b6f93db544de6822d7bb8ea3b78ca9c3f6779"
+  },
+  runtime: {
+    repository: "thallylabs/thally",
+    commitSha: "d44ad701f7045e019be71717b6fddde451372509",
+    treeSha: "0d2a4379dcca251373c802b7c3ea04fffd87fe7a",
+    contentSource: "assets",
+    identityContractVersion: 1
+  },
+  starterVersion: 2
+};
+
+// src/previous-scaffold-releases.json
+var previous_scaffold_releases_default = [
+  {
+    schemaVersion: 1,
+    id: "2026-08-05.04438581.baf29307",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "04438581a402d02e9f4308ff047c4c4a48d8169f",
+      treeSha: "c962a01b3b8b24ffdb65671c2f7805a47175ba42",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/04438581a402d02e9f4308ff047c4c4a48d8169f",
+      manifestPath: "starter-release.json",
+      manifestSha256: "e019c6416c6c6872114cdf9d9b5eec6579873f46f826748cf39254fd16628392"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "baf2930771baf449238bd6c68101ceb3af33ee96",
+      treeSha: "56f8217b4da6740015e4775d2ce0aeb60bc167a0",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 2
+  },
+  {
+    schemaVersion: 1,
+    id: "2026-08-05.d5fef916.f3817263",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "d5fef9167ea81f12a861deec5515a78a0f756781",
+      treeSha: "31c1e49342ce9f4122dc0cd60fe714868ca03150",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/d5fef9167ea81f12a861deec5515a78a0f756781",
+      manifestPath: "starter-release.json",
+      manifestSha256: "06cccd3496c368ef95a11b3afc15add610f261b8106e8371720b084adbf7fa5a"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "f38172638cd2cc944ac9ecda19c096ce4d9b4599",
+      treeSha: "d33ad60ad0acabee1cf950880c8bd908e83a002a",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 1
+  }
+];
+
+// src/release.ts
+var STABLE_SCAFFOLD_RELEASE = stable_scaffold_release_default;
+var SUPPORTED_SCAFFOLD_RELEASES = [
+  STABLE_SCAFFOLD_RELEASE,
+  ...previous_scaffold_releases_default
+];
+function isStableScaffoldRelease(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const candidate = value;
+  return candidate.schemaVersion === STABLE_SCAFFOLD_RELEASE.schemaVersion && candidate.id === STABLE_SCAFFOLD_RELEASE.id && candidate.starterVersion === STABLE_SCAFFOLD_RELEASE.starterVersion && candidate.source?.repository === STABLE_SCAFFOLD_RELEASE.source.repository && candidate.source?.commitSha === STABLE_SCAFFOLD_RELEASE.source.commitSha && candidate.source?.treeSha === STABLE_SCAFFOLD_RELEASE.source.treeSha && candidate.source?.archiveUrl === STABLE_SCAFFOLD_RELEASE.source.archiveUrl && candidate.source?.manifestPath === STABLE_SCAFFOLD_RELEASE.source.manifestPath && candidate.source?.manifestSha256 === STABLE_SCAFFOLD_RELEASE.source.manifestSha256 && candidate.runtime?.repository === STABLE_SCAFFOLD_RELEASE.runtime.repository && candidate.runtime?.commitSha === STABLE_SCAFFOLD_RELEASE.runtime.commitSha && candidate.runtime?.treeSha === STABLE_SCAFFOLD_RELEASE.runtime.treeSha && candidate.runtime?.contentSource === STABLE_SCAFFOLD_RELEASE.runtime.contentSource && candidate.runtime?.identityContractVersion === STABLE_SCAFFOLD_RELEASE.runtime.identityContractVersion;
+}
+
+export {
+  STABLE_SCAFFOLD_RELEASE,
+  SUPPORTED_SCAFFOLD_RELEASES,
+  isStableScaffoldRelease
+};

package/dist/chunk-TMXBINSI.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+import {
+  readStarterReleaseManifest
+} from "./chunk-IJXZ4YRL.js";
+import {
+  STABLE_SCAFFOLD_RELEASE
+} from "./chunk-RLGB6QF3.js";
+
+// src/download.ts
+import { Readable, Transform, pipeline } from "stream";
+import { promisify } from "util";
+import {
+  cpSync,
+  lstatSync,
+  mkdtempSync,
+  readdirSync,
+  renameSync,
+  rmdirSync,
+  rmSync
+} from "fs";
+import { tmpdir } from "os";
+import { dirname, join } from "path";
+import { extract } from "tar";
+var pipelineAsync = promisify(pipeline);
+var STARTER_FETCH_TIMEOUT_MS = 15e3;
+var MAX_COMPRESSED_ARCHIVE_BYTES = 64 * 1024 * 1024;
+var MAX_EXTRACTED_ARCHIVE_BYTES = 256 * 1024 * 1024;
+var MAX_ARCHIVE_FILE_BYTES = 32 * 1024 * 1024;
+var MAX_ARCHIVE_ENTRIES = 1e4;
+var STARTER_REPOSITORY = STABLE_SCAFFOLD_RELEASE.source.repository;
+var STARTER_COMMIT_SHA = STABLE_SCAFFOLD_RELEASE.source.commitSha;
+var STARTER_ARCHIVE_ROOT = `${STARTER_REPOSITORY.split("/").at(-1)}-${STARTER_COMMIT_SHA}`;
+function starterArchiveRoot(release) {
+  return `${release.source.repository.split("/").at(-1)}-${release.source.commitSha}`;
+}
+function validateStarterArchiveEntry(archivePath, entry, archiveRoot = STARTER_ARCHIVE_ROOT) {
+  if (!archivePath || archivePath.includes("\0") || archivePath.includes("\\") || archivePath.startsWith("/")) {
+    throw new Error("The stable Thally starter archive contains an unsafe path.");
+  }
+  const pathWithoutTrailingSlash = archivePath.endsWith("/") ? archivePath.slice(0, -1) : archivePath;
+  const parts = pathWithoutTrailingSlash.split("/");
+  const [root, ...relativeParts] = parts;
+  if (root !== archiveRoot || relativeParts.some((part) => !part || part === "." || part === "..")) {
+    throw new Error("The stable Thally starter archive contains an unsafe path.");
+  }
+  if (relativeParts.length === 0 && entry.type !== "Directory") {
+    throw new Error("The stable Thally starter archive has an invalid root entry.");
+  }
+  if (!["File", "OldFile", "Directory"].includes(entry.type)) {
+    throw new Error(
+      `The stable Thally starter archive contains unsupported entry type ${entry.type}.`
+    );
+  }
+  if (!Number.isSafeInteger(entry.size) || entry.size < 0 || entry.size > MAX_ARCHIVE_FILE_BYTES) {
+    throw new Error("The stable Thally starter archive contains an oversized file.");
+  }
+}
+function starterArchiveFilter(archiveRoot) {
+  let entryCount = 0;
+  let extractedBytes = 0;
+  return (path, entry) => {
+    if (!("type" in entry)) {
+      throw new Error("The starter archive filter requires extraction metadata.");
+    }
+    validateStarterArchiveEntry(path, entry, archiveRoot);
+    entryCount += 1;
+    extractedBytes += entry.size;
+    if (entryCount > MAX_ARCHIVE_ENTRIES || extractedBytes > MAX_EXTRACTED_ARCHIVE_BYTES) {
+      throw new Error("The stable Thally starter archive exceeds extraction limits.");
+    }
+    return true;
+  };
+}
+function compressedArchiveLimit() {
+  let compressedBytes = 0;
+  return new Transform({
+    transform(chunk, _encoding, callback) {
+      compressedBytes += chunk.length;
+      if (compressedBytes > MAX_COMPRESSED_ARCHIVE_BYTES) {
+        callback(new Error("The stable Thally starter archive is too large."));
+        return;
+      }
+      callback(null, chunk);
+    }
+  });
+}
+async function downloadStarter(targetDir, siteName, release = STABLE_SCAFFOLD_RELEASE, options = {}) {
+  if (options.announce !== false) {
+    console.log("");
+    console.log(`  \u23F3 Creating ${siteName?.trim() || "your docs site"}...`);
+  }
+  const targetEntry = lstatSync(targetDir);
+  if (!targetEntry.isDirectory() || targetEntry.isSymbolicLink()) {
+    throw new Error("The Thally starter target must be a regular directory.");
+  }
+  if (readdirSync(targetDir).length > 0) {
+    throw new Error("The Thally starter target directory must be empty.");
+  }
+  const response = await fetch(release.source.archiveUrl, {
+    headers: { accept: "application/gzip, application/octet-stream;q=0.9" },
+    cache: "no-store",
+    signal: AbortSignal.timeout(STARTER_FETCH_TIMEOUT_MS)
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to download the stable Thally starter: ${response.status} ${response.statusText}`
+    );
+  }
+  if (!response.body) {
+    throw new Error("The stable Thally starter response body is empty.");
+  }
+  const contentLength = Number(response.headers.get("content-length"));
+  if (Number.isFinite(contentLength) && contentLength > MAX_COMPRESSED_ARCHIVE_BYTES) {
+    throw new Error("The stable Thally starter archive is too large.");
+  }
+  const nodeStream = Readable.fromWeb(
+    response.body
+  );
+  const stagingDir = mkdtempSync(join(tmpdir(), "thally-starter-download-"));
+  try {
+    await pipelineAsync(
+      nodeStream,
+      compressedArchiveLimit(),
+      extract({
+        cwd: stagingDir,
+        strip: 1,
+        filter: starterArchiveFilter(starterArchiveRoot(release)),
+        preservePaths: false,
+        strict: true,
+        unlink: true,
+        maxDecompressionRatio: 100
+      })
+    );
+    readStarterReleaseManifest(stagingDir, release);
+    const deliveryDir = mkdtempSync(
+      join(dirname(targetDir), ".thally-starter-delivery-")
+    );
+    try {
+      for (const entry of readdirSync(stagingDir)) {
+        cpSync(join(stagingDir, entry), join(deliveryDir, entry), {
+          recursive: true,
+          errorOnExist: true
+        });
+      }
+      if (readdirSync(targetDir).length > 0) {
+        throw new Error("The Thally starter target changed during download.");
+      }
+      rmdirSync(targetDir);
+      renameSync(deliveryDir, targetDir);
+    } finally {
+      rmSync(deliveryDir, { recursive: true, force: true });
+    }
+  } finally {
+    rmSync(stagingDir, { recursive: true, force: true });
+  }
+}
+
+export {
+  STARTER_REPOSITORY,
+  STARTER_COMMIT_SHA,
+  STARTER_ARCHIVE_ROOT,
+  validateStarterArchiveEntry,
+  downloadStarter
+};

package/dist/customize.d.ts

@@ -1,93 +1,39 @@
 /**
- * Lowest `@thallylabs/cli` release a scaffold may declare.
+ * Documented owner-field personalization for the immutable starter tree.
  *
- * The managed builder depends on the Cloudflare-aware CLI contract, so a site
- * scaffolded from an older or locally-vendored template must not keep a
- * pre-Workers pin. This is a FLOOR, never an override: the canonical template
- * tracks the newest published CLI, and overwriting its pin with a constant that
- * has since aged past it silently downgrades every generated site. Raise it
- * only alongside a released CLI — `scaffold-hygiene.test.ts` fails if it ever
- * climbs above the version this monorepo publishes.
+ * Runtime source, authored pages, navigation structure, dependencies, CI, and
+ * repository policy all belong to `thallylabs/starter`. This module may change
+ * only the small set of fields an owner answers during creation.
  */
-declare const MIN_CLI_VERSION = "0.7.0";
-/**
- * Lowest `@thallylabs/mcp` release a scaffold may declare. Same floor semantics
- * as {@link MIN_CLI_VERSION}; it also stands in for the unresolvable `*` range
- * that older workspace-based templates used.
- */
-declare const MIN_MCP_VERSION = "0.9.0";
-/**
- * Resolve a dependency pin to at least `floor`, preferring what the template
- * already ships. An absent, unresolvable, or demonstrably older pin becomes the
- * floor; anything newer — or anything the comparison cannot rank — survives.
- */
-declare function raisePinToFloor(current: string | undefined, floor: string): string;
 interface StarterLocale {
     code: string;
     label: string;
 }
-interface StarterFile {
-    path: string;
-    content: string;
-}
-interface BuildStarterFilesOptions {
+interface StarterPersonalizationOptions {
     projectName: string;
-    enableAiChat?: boolean;
-    repoUrl?: string;
+    packageName: string;
+    description: string;
+    brandPreset: string;
+    repoUrl: string;
+    enableAiChat: boolean;
     i18nLocales?: Array<StarterLocale>;
 }
-declare function buildStarterDocsJson({ enableAiChat, repoUrl, i18nLocales, }: {
-    enableAiChat: boolean;
-    repoUrl?: string;
-    i18nLocales?: Array<{
-        code: string;
-        label: string;
-    }>;
-}): string;
 /**
- * Render the complete site-owned starter layer without reading or writing the
- * filesystem. CLI, MCP, and Thally Cloud consume these exact bytes so a new
- * site cannot vary by which creation entry point the user chose.
- */
-declare function buildStarterFiles({ projectName, enableAiChat, repoUrl, i18nLocales, }: BuildStarterFilesOptions): Array<StarterFile>;
-declare function writeStarterContent(targetDir: string, projectName: string, enableAiChat?: boolean, repoUrl?: string, i18nLocales?: Array<{
-    code: string;
-    label: string;
-}>): void;
-declare function writeStarterAgentGuide(targetDir: string, projectName: string): void;
-declare function writeStarterReadme(targetDir: string, projectName: string): void;
-/**
- * Write provider-portable Cloudflare Workers configuration into every scaffold.
+ * Personalize only the owner-controlled settings in `docs.json`.
  *
- * The files contain no account, route, bucket, or token identifiers. Thally
- * Cloud supplies those operational values while self-hosters can deploy the
- * same source tree to their own account without editing application internals.
+ * Authored tabs, groups, pages, theme choices, and every unrelated key remain
+ * byte-for-byte equivalent after JSON normalization.
  */
-declare function writeCloudflareRuntimeConfig(targetDir: string, slug: string): void;
+declare function updateStarterDocsConfig(targetDir: string, enableAiChat: boolean, repoUrl: string, i18nLocales?: Array<StarterLocale>): void;
+/** Personalize the documented identity and repository fields in `site.ts`. */
 declare function updateSiteConfig(targetDir: string, projectName: string, description: string, brandPreset: string, repoUrl: string): void;
-declare function patchApiReferenceGuard(targetDir: string): void;
-declare function patchTopBarNavigation(targetDir: string): void;
-declare function patchOpenApiFetch(targetDir: string): void;
+/** Rename only the root package identity; dependency pins belong to starter. */
+declare function updatePackageIdentity(targetDir: string, packageName: string): void;
+/** Update the provider-portable Worker name without recreating its config. */
+declare function updateCloudflareRuntimeName(targetDir: string, packageName: string): void;
+/** Copy the canonical environment guide to the ignored local filename. */
 declare function updateEnvExample(targetDir: string): void;
-/**
- * Normalize the canonical docs package for a newly named standalone site.
- * `thallylabs/docs` is already standalone, while this defensive cleanup also
- * keeps local or older monorepo-based sources safe to scaffold:
- *
- *   - `workspaces` points at a directory that doesn't exist in scaffolds.
- *   - `prebuild`/`pretest` invoke `packages:build`, which builds those absent
- *     workspaces. Runtime sources and embeddings stay in `prebuild`: both run
- *     standalone and supply request-time data in filesystem-free Workers.
- *   - The copied `package-lock.json` still resolves the monorepo's workspace
- *     graph; deleting it lets the scaffold's own `npm install` write a clean
- *     lockfile. Workspace-linked deps (e.g. @thallylabs/core) resolve from the
- *     npm registry instead, which is why the template must depend on published
- *     versions, never `workspace:*` specs.
- *
- * Also names the package after the site so `npm ls`/lockfiles read correctly.
- */
-declare function patchPackageJson(targetDir: string, slug: string): void;
-/** Ensure dependency folders are ignored at any depth in generated sites. */
-declare function patchGitignore(targetDir: string): void;
+/** Apply the complete, intentionally narrow owner-personalization contract. */
+declare function personalizeStarter(targetDir: string, options: StarterPersonalizationOptions): void;
 
-export { type BuildStarterFilesOptions, MIN_CLI_VERSION, MIN_MCP_VERSION, type StarterFile, type StarterLocale, buildStarterDocsJson, buildStarterFiles, patchApiReferenceGuard, patchGitignore, patchOpenApiFetch, patchPackageJson, patchTopBarNavigation, raisePinToFloor, updateEnvExample, updateSiteConfig, writeCloudflareRuntimeConfig, writeStarterAgentGuide, writeStarterContent, writeStarterReadme };
+export { type StarterLocale, type StarterPersonalizationOptions, personalizeStarter, updateCloudflareRuntimeName, updateEnvExample, updatePackageIdentity, updateSiteConfig, updateStarterDocsConfig };

package/dist/customize.js

@@ -1,37 +1,17 @@
 #!/usr/bin/env node
 import {
-  MIN_CLI_VERSION,
-  MIN_MCP_VERSION,
-  buildStarterDocsJson,
-  buildStarterFiles,
-  patchApiReferenceGuard,
-  patchGitignore,
-  patchOpenApiFetch,
-  patchPackageJson,
-  patchTopBarNavigation,
-  raisePinToFloor,
+  personalizeStarter,
+  updateCloudflareRuntimeName,
   updateEnvExample,
+  updatePackageIdentity,
   updateSiteConfig,
-  writeCloudflareRuntimeConfig,
-  writeStarterAgentGuide,
-  writeStarterContent,
-  writeStarterReadme
-} from "./chunk-BW7J7DJV.js";
+  updateStarterDocsConfig
+} from "./chunk-ORUAMPNF.js";
 export {
-  MIN_CLI_VERSION,
-  MIN_MCP_VERSION,
-  buildStarterDocsJson,
-  buildStarterFiles,
-  patchApiReferenceGuard,
-  patchGitignore,
-  patchOpenApiFetch,
-  patchPackageJson,
-  patchTopBarNavigation,
-  raisePinToFloor,
+  personalizeStarter,
+  updateCloudflareRuntimeName,
   updateEnvExample,
+  updatePackageIdentity,
   updateSiteConfig,
-  writeCloudflareRuntimeConfig,
-  writeStarterAgentGuide,
-  writeStarterContent,
-  writeStarterReadme
+  updateStarterDocsConfig
 };

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "./chunk-YWNWLSZ2.js";
+} from "./chunk-DGK6XREP.js";
 import {
   logo,
   readDocsJson,
@@ -9,9 +9,11 @@ import {
   slugify,
   success,
   writeDocsJson
-} from "./chunk-JNDRCCJV.js";
-import "./chunk-BW7J7DJV.js";
-import "./chunk-PJW4JJIT.js";
+} from "./chunk-2N74PW2Y.js";
+import "./chunk-ORUAMPNF.js";
+import "./chunk-TMXBINSI.js";
+import "./chunk-IJXZ4YRL.js";
+import "./chunk-RLGB6QF3.js";
 
 // src/index.ts
 import { existsSync as existsSync3, readdirSync as readdirSync2 } from "fs";
@@ -151,7 +153,7 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
   let i18nLocales;
   if (!useDefaults) {
     const enableI18n = await input({
-      message: "  Add languages beyond English and Spanish? (y/N):",
+      message: "  Add another documentation language? (y/N):",
       default: "N"
     });
     if (enableI18n.toLowerCase() === "y") {

package/dist/migrate/index.js

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-YWNWLSZ2.js";
-import "../chunk-JNDRCCJV.js";
-import "../chunk-BW7J7DJV.js";
-import "../chunk-PJW4JJIT.js";
+} from "../chunk-DGK6XREP.js";
+import "../chunk-2N74PW2Y.js";
+import "../chunk-ORUAMPNF.js";
+import "../chunk-TMXBINSI.js";
+import "../chunk-IJXZ4YRL.js";
+import "../chunk-RLGB6QF3.js";
 export {
   migrateDocs
 };