create-thally-docs 0.8.1 → 0.10.0

package/dist/chunk-RS6U2GSX.js

@@ -1,846 +0,0 @@
-#!/usr/bin/env node
-
-// src/scaffold.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync as readdirSync2 } from "fs";
-import { resolve } from "path";
-
-// src/download.ts
-import { Readable, pipeline } from "stream";
-import { promisify } from "util";
-import tar from "tar";
-var pipelineAsync = promisify(pipeline);
-var TEMPLATE_REPOSITORY = "thallylabs/docs";
-var TARBALL_URL = `https://codeload.github.com/${TEMPLATE_REPOSITORY}/tar.gz/main`;
-var EXCLUDE_PATHS = [
-  // Match both the directory entry itself and every nested file. Tar invokes
-  // the filter for `.../node_modules` before descendants, without a trailing `/`.
-  "/node_modules",
-  // The canonical docs repository may temporarily retain package sources while
-  // runtime work is being upstreamed. A scaffold consumes the published
-  // packages declared in package.json; it must never inherit those sources.
-  "/packages",
-  "/.git/",
-  "/.next/",
-  "/.data/",
-  "/.thally/",
-  // The first-party docs deployment pins its own canonical origin.
-  "/.env.production",
-  "/thally-track.yml",
-  "/CODEOWNERS",
-  "/CLAUDE.md",
-  "/notes/",
-  "/public/images/",
-  "/src/public/",
-  "/snippets/",
-  "/.github/ISSUE_TEMPLATE/",
-  "/.github/PULL_REQUEST_TEMPLATE.md",
-  "/README.md"
-];
-function shouldInclude(path) {
-  for (const excluded of EXCLUDE_PATHS) {
-    if (path.includes(excluded)) {
-      return false;
-    }
-  }
-  return true;
-}
-async function downloadTemplate(targetDir, siteName) {
-  console.log("");
-  console.log(`  \u23F3 Creating ${siteName?.trim() || "your docs site"}...`);
-  const response = await fetch(TARBALL_URL);
-  if (!response.ok) {
-    throw new Error(`Failed to download template: ${response.status} ${response.statusText}`);
-  }
-  if (!response.body) {
-    throw new Error("Response body is empty");
-  }
-  const nodeStream = Readable.fromWeb(response.body);
-  await pipelineAsync(
-    nodeStream,
-    tar.extract({ cwd: targetDir, strip: 1, filter: shouldInclude })
-  );
-}
-
-// src/docs-json.ts
-import { readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-function readDocsJson(projectDir) {
-  const docsPath = join(projectDir, "docs.json");
-  const raw = readFileSync(docsPath, "utf8");
-  return JSON.parse(raw);
-}
-function writeDocsJson(projectDir, config) {
-  const docsPath = join(projectDir, "docs.json");
-  writeFileSync(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
-}
-function resetTrackingConfig(projectDir) {
-  const config = readDocsJson(projectDir);
-  if (config.tracking) {
-    delete config.tracking;
-    writeDocsJson(projectDir, config);
-  }
-}
-function writeTrackingConfig(projectDir, repos) {
-  if (repos.length === 0) return;
-  const config = readDocsJson(projectDir);
-  config.tracking = { repos: repos.map((r) => ({ owner: r.owner, repo: r.repo, branch: "main" })) };
-  writeDocsJson(projectDir, config);
-}
-
-// src/customize.ts
-import { existsSync, mkdirSync, writeFileSync as writeFileSync2, readFileSync as readFileSync2, readdirSync, cpSync, rmSync } from "fs";
-import { join as join2 } from "path";
-var STARTER_PAGES = {
-  "introduction.mdx": `---
-title: Introduction
-description: Welcome to {NAME}.
-mode: home
-keywords:
-  - {NAME}
-  - documentation
-  - overview
-  - getting started
----
-
-<Hero
-  title="Welcome to {NAME}"
-  subtitle="Use this starter to introduce your product, guide readers to their first successful outcome, and publish a clear API reference."
-  primaryLabel="Start the quickstart"
-  primaryHref="/quickstart"
-  secondaryLabel="See components"
-  secondaryHref="/components"
-/>
-
-<CardGroup cols={3}>
-  <Card title="Quickstart" icon="party-horn" href="/quickstart">
-    Show readers the fastest path to a useful first result.
-  </Card>
-  <Card title="Components" icon="grid-round" href="/components">
-    Structure guides with steps, tabs, cards, callouts, accordions, and more.
-  </Card>
-  <Card title="API reference" icon="code-simple" href="/api">
-    Replace \`openapi.yaml\` with your specification to publish interactive endpoints.
-  </Card>
-  <Card title="Customize" icon="wrench" href="/customization">
-    Make the navigation, brand, typography, and links your own.
-  </Card>
-  <Card title="Multi-language" icon="message" href="/es">
-    Switch to the included Spanish example from the language menu.
-  </Card>
-  <Card title="Agent-ready docs" icon="link-simple" href="/llms.txt">
-    Give coding agents a clean, structured version of your documentation.
-  </Card>
-</CardGroup>
-
-<Note type="info" title="Make it yours">
-  Start by editing \`src/content/introduction.mdx\`. Then update \`docs.json\` to
-  organize navigation and \`src/data/site.ts\` to set your product name and links.
-</Note>
-`,
-  "quickstart.mdx": `---
-title: Quickstart
-description: Give readers the fastest path to a successful first result with {NAME}.
-keywords:
-  - {NAME}
-  - quickstart
-  - installation
-  - getting started
----
-
-Describe the prerequisites and the shortest useful workflow. A good quickstart
-takes someone from zero to a visible result without explaining every option.
-
-## Prerequisites
-
-- Requirement one, such as an account, API key, or supported runtime
-- Requirement two, such as a compatible device, browser, or operating system
-
-<Steps>
-  <Step title="Install">
-    Explain how to install {NAME} or create an account.
-
-    \`\`\`bash
-    npm install your-package
-    \`\`\`
-  </Step>
-  <Step title="Configure">
-    Show only the configuration required for the first successful run.
-
-    \`\`\`bash
-    your-cli init
-    \`\`\`
-  </Step>
-  <Step title="Run it">
-    Give readers a command or action with an observable result.
-
-    \`\`\`bash
-    your-cli start
-    \`\`\`
-  </Step>
-</Steps>
-
-<Tip>
-  Tell readers where to get help, then link to the next guide they should read.
-</Tip>
-`,
-  "components.mdx": `---
-title: Components
-description: A compact tour of the rich MDX components available in {NAME}.
-keywords:
-  - {NAME}
-  - components
-  - MDX
----
-
-Use components to keep complex instructions clear without turning every page
-into a wall of text.
-
-## Show equivalent paths
-
-<Tabs>
-  <Tab title="npm">
-    \`\`\`bash
-    npm install your-package
-    \`\`\`
-  </Tab>
-  <Tab title="pnpm">
-    \`\`\`bash
-    pnpm add your-package
-    \`\`\`
-  </Tab>
-  <Tab title="yarn">
-    \`\`\`bash
-    yarn add your-package
-    \`\`\`
-  </Tab>
-</Tabs>
-
-## Reveal detail when it matters
-
-<Accordion title="Where should advanced configuration live?">
-  Keep the default path visible and move optional detail into an accordion. This
-  lets new readers move quickly without hiding information from experts.
-</Accordion>
-
-## Communicate status
-
-<Badge variant="success">Stable</Badge>{" "}
-<Badge variant="warning">Beta</Badge>{" "}
-<Badge variant="info">New</Badge>
-
-<Tip>
-  Browse the complete component library at [docs.thally.io](https://docs.thally.io/components/card).
-</Tip>
-`,
-  "customization.mdx": `---
-title: Customization
-description: Make {NAME} feel unmistakably like your product.
-keywords:
-  - {NAME}
-  - branding
-  - navigation
----
-
-Your documentation should feel like part of the product\u2014not a separate website.
-
-<CardGroup cols={2}>
-  <Card title="Brand and theme" icon="party-horn" href="https://docs.thally.io/guides/branding-and-theming">
-    Configure colors, logos, favicons, typography, and light or dark presentation.
-  </Card>
-  <Card title="Navigation" icon="book-open" href="https://docs.thally.io/guides/configuring-navigation">
-    Organize tabs, icon-labelled groups, pages, and external destinations in \`docs.json\`.
-  </Card>
-  <Card title="Domains" icon="link-simple" href="https://app.thally.io">
-    Connect a custom domain from your site settings in Thally Cloud.
-  </Card>
-  <Card title="Analytics and feedback" icon="message" href="https://app.thally.io">
-    Learn what readers need and collect feedback without third-party widgets.
-  </Card>
-</CardGroup>
-
-<Note type="info" title="Start with docs.json">
-  Navigation and portable presentation settings live in \`docs.json\`. Site
-  identity and fallback brand values live in \`src/data/site.ts\`.
-</Note>
-`,
-  "changelog.mdx": `---
-title: Changelog
-description: Notable changes, releases, and improvements to {NAME}.
-keywords:
-  - {NAME}
-  - changelog
-  - releases
-  - updates
----
-
-## v0.1.0
-
-The first release of your **{NAME}** documentation.
-
-- Initial docs site scaffolded with [Thally](https://github.com/thallylabs/thally)
-- Agent-ready endpoints live: \`/llms.txt\`, \`/ai.txt\`, \`/api/docs-index\`, and \`/api/agent-readiness\`
-- Starter guides in the Overview tab and an interactive API reference
-
-Edit this page at \`src/content/changelog.mdx\` to announce your own releases as you ship.
-`
-};
-var STARTER_SPANISH_PAGES = {
-  "introduction.mdx": `---
-title: Introducci\xF3n
-description: Te damos la bienvenida a {NAME}.
-mode: home
----
-
-<Hero
-  title="Te damos la bienvenida a {NAME}"
-  subtitle="Usa este sitio inicial para presentar tu producto, guiar a tus lectores hasta su primer resultado y publicar una referencia de API clara."
-  primaryLabel="Abrir inicio r\xE1pido"
-  primaryHref="/es/quickstart"
-  secondaryLabel="Ver componentes"
-  secondaryHref="/es/components"
-/>
-
-<CardGroup cols={3}>
-  <Card title="Inicio r\xE1pido" icon="party-horn" href="/es/quickstart">
-    Ayuda a tus lectores a lograr su primer resultado en minutos.
-  </Card>
-  <Card title="Componentes" icon="grid-round" href="/es/components">
-    Usa pesta\xF1as, pasos, tarjetas, avisos y acordeones.
-  </Card>
-  <Card title="Referencia de API" icon="code-simple" href="/es/api">
-    Convierte \`openapi.yaml\` en documentaci\xF3n interactiva.
-  </Card>
-  <Card title="Personalizaci\xF3n" icon="wrench" href="/es/customization">
-    Adapta la navegaci\xF3n, marca, tipograf\xEDa y enlaces.
-  </Card>
-  <Card title="Varios idiomas" icon="message" href="/">
-    Cambia entre ingl\xE9s y espa\xF1ol desde el selector de idioma.
-  </Card>
-  <Card title="Preparado para IA" icon="link-simple" href="/llms.txt">
-    Publica contenido legible por agentes desde el primer d\xEDa.
-  </Card>
-</CardGroup>
-`,
-  "quickstart.mdx": `---
-title: Inicio r\xE1pido
-description: Gu\xEDa a tus lectores hasta su primer resultado con {NAME}.
----
-
-Un buen inicio r\xE1pido lleva al lector de cero a un resultado visible sin explicar
-todas las opciones.
-
-<Steps>
-  <Step title="Instala">
-    Explica c\xF3mo instalar {NAME} o crear una cuenta.
-
-    \`\`\`bash
-    npm install your-package
-    \`\`\`
-  </Step>
-  <Step title="Configura">
-    Muestra \xFAnicamente la configuraci\xF3n necesaria para comenzar.
-  </Step>
-  <Step title="Ejecuta">
-    Termina con una acci\xF3n y un resultado que el lector pueda comprobar.
-  </Step>
-</Steps>
-
-<Tip>Enlaza la siguiente gu\xEDa que deber\xEDa leer una vez completado este flujo.</Tip>
-`,
-  "components.mdx": `---
-title: Componentes
-description: Una muestra de los componentes MDX disponibles en {NAME}.
----
-
-<Tabs>
-  <Tab title="npm">\`npm install your-package\`</Tab>
-  <Tab title="pnpm">\`pnpm add your-package\`</Tab>
-  <Tab title="yarn">\`yarn add your-package\`</Tab>
-</Tabs>
-
-<Accordion title="\xBFD\xF3nde debe ir la configuraci\xF3n avanzada?">
-  Mant\xE9n visible el camino principal y coloca los detalles opcionales aqu\xED.
-</Accordion>
-
-<Badge variant="success">Estable</Badge>{" "}
-<Badge variant="warning">Beta</Badge>{" "}
-<Badge variant="info">Nuevo</Badge>
-`,
-  "customization.mdx": `---
-title: Personalizaci\xF3n
-description: Haz que {NAME} se sienta como una parte natural de tu producto.
----
-
-<CardGroup cols={2}>
-  <Card title="Marca y tema" icon="party-horn">Configura colores, logotipos, tipograf\xEDa y apariencia.</Card>
-  <Card title="Navegaci\xF3n" icon="book-open">Organiza pesta\xF1as, grupos con iconos y p\xE1ginas en \`docs.json\`.</Card>
-  <Card title="Dominios" icon="link-simple">Conecta un dominio personalizado desde Thally Cloud.</Card>
-  <Card title="Anal\xEDtica y feedback" icon="message">Comprende qu\xE9 necesitan tus lectores.</Card>
-</CardGroup>
-`,
-  "changelog.mdx": `---
-title: Novedades
-description: Cambios, versiones y mejoras destacadas de {NAME}.
----
-
-## v0.1.0
-
-La primera versi\xF3n de la documentaci\xF3n de **{NAME}**.
-
-- Sitio creado con [Thally](https://github.com/thallylabs/thally)
-- Referencia de API y contenido preparado para agentes
-- Ejemplo biling\xFCe en ingl\xE9s y espa\xF1ol
-`
-};
-function buildStarterDocsJson({
-  enableAiChat,
-  repoUrl,
-  i18nLocales
-}) {
-  const config = {};
-  config.theme = "default";
-  if (enableAiChat) {
-    config.ai = { chat: true };
-  }
-  if (repoUrl) {
-    config.navbar = {
-      links: [{ label: "GitHub", href: repoUrl, type: "github" }],
-      primary: { label: "Get started", href: "/quickstart" }
-    };
-  }
-  const locales = [
-    { code: "en", label: "English" },
-    { code: "es", label: "Espa\xF1ol" },
-    ...(i18nLocales ?? []).filter(({ code }) => code !== "en" && code !== "es")
-  ];
-  config.i18n = { defaultLocale: "en", locales };
-  config.tabs = [
-    {
-      tab: "Overview",
-      groups: [
-        { group: "Getting Started", icon: "book-open", pages: ["introduction", "quickstart"] },
-        { group: "Explore", icon: "grid-round", pages: ["components"] },
-        { group: "Project", icon: "wrench", pages: ["customization"] }
-      ]
-    },
-    { tab: "API Reference", api: { source: "openapi.yaml" } },
-    { tab: "Changelog", href: "/changelog" }
-  ];
-  return JSON.stringify(config, null, 2) + "\n";
-}
-function writeStarterContent(targetDir, projectName, enableAiChat = true, repoUrl = "", i18nLocales) {
-  const contentDir = join2(targetDir, "src", "content");
-  if (existsSync(contentDir)) {
-    const entries = readdirSync(contentDir);
-    for (const entry of entries) {
-      const fullPath = join2(contentDir, entry);
-      rmSync(fullPath, { recursive: true, force: true });
-    }
-  } else {
-    mkdirSync(contentDir, { recursive: true });
-  }
-  for (const [filename, template] of Object.entries(STARTER_PAGES)) {
-    const content = template.replace(/\{NAME\}/g, projectName);
-    writeFileSync2(join2(contentDir, filename), content, "utf8");
-  }
-  const spanishDir = join2(contentDir, "es");
-  mkdirSync(spanishDir, { recursive: true });
-  for (const [filename, template] of Object.entries(STARTER_SPANISH_PAGES)) {
-    const content = template.replace(/\{NAME\}/g, projectName);
-    writeFileSync2(join2(spanishDir, filename), content, "utf8");
-  }
-  writeFileSync2(
-    join2(targetDir, "docs.json"),
-    buildStarterDocsJson({ enableAiChat, repoUrl: repoUrl || void 0, i18nLocales }),
-    "utf8"
-  );
-}
-function writeStarterAgentGuide(targetDir, projectName) {
-  const guide = `# ${projectName} documentation instructions
-
-## About this project
-
-- This is a documentation site built with [Thally](https://github.com/thallylabs/thally).
-- Pages are MDX files with YAML frontmatter in \`src/content/\`.
-- Navigation and product features are configured in \`docs.json\`.
-- Site identity and fallback brand values live in \`src/data/site.ts\`.
-- Use \`/llms.txt\`, \`/llms-full.txt\`, and \`/skill.md\` on the deployed site for agent-readable context.
-
-## Terminology
-
-<!-- Add product-specific terms and preferred usage. -->
-
-## Writing style
-
-- Use active voice and address the reader as \u201Cyou.\u201D
-- Keep sentences concise and headings in sentence case.
-- Bold interface labels and format commands, files, and code with backticks.
-- Lead with the outcome, then explain prerequisites and steps.
-
-## Content boundaries
-
-<!-- Define what belongs in public docs and what must remain internal. -->
-`;
-  writeFileSync2(join2(targetDir, "AGENTS.md"), guide, "utf8");
-}
-function writeStarterReadme(targetDir, projectName) {
-  const readme = `# ${projectName}
-
-Documentation powered by [Thally](https://github.com/thallylabs/thally).
-
-## Local development
-
-\`\`\`bash
-npm install
-npm run dev
-\`\`\`
-
-The server starts at [http://localhost:3040](http://localhost:3040), or the next
-available port when 3040 is already in use.
-
-## Write your docs
-
-- Add MDX pages in \`src/content/\`.
-- Organize navigation and product features in \`docs.json\`.
-- Update the site name, links, and brand defaults in \`src/data/site.ts\`.
-- Copy \`.env.example\` to \`.env.local\` for local secrets.
-
-The starter includes a home hero, icon-grouped navigation, English and Spanish
-examples, a guided quickstart, component showcase, changelog, OpenAPI reference,
-and \`AGENTS.md\` writing instructions for coding agents.
-
-## Publishing changes
-
-Push changes to the default branch to trigger your connected deployment. If the
-site is not connected yet, add the repository in
-[Thally Cloud](https://app.thally.io) or deploy it to any Next.js host.
-
-Run \`npx create-thally-docs check --ci .\` before publishing. Deploy the site
-anywhere Next.js is supported, or connect the repository to
-[Thally Cloud](https://app.thally.io) for managed hosting and services.
-`;
-  writeFileSync2(join2(targetDir, "README.md"), readme, "utf8");
-}
-function writeCloudflareRuntimeConfig(targetDir, slug) {
-  writeFileSync2(
-    join2(targetDir, "open-next.config.ts"),
-    `/** OpenNext adapter configuration for the Cloudflare Workers runtime. */
-import { defineCloudflareConfig } from '@opennextjs/cloudflare/config'
-
-export default defineCloudflareConfig()
-`,
-    "utf8"
-  );
-  writeFileSync2(
-    join2(targetDir, "wrangler.jsonc"),
-    `${JSON.stringify(
-      {
-        $schema: "node_modules/wrangler/config-schema.json",
-        name: slug,
-        main: ".open-next/worker.js",
-        compatibility_date: "2026-07-15",
-        compatibility_flags: ["nodejs_compat", "global_fetch_strictly_public"],
-        observability: {
-          enabled: true,
-          logs: { head_sampling_rate: 1 },
-          traces: { enabled: true, head_sampling_rate: 0.01 }
-        },
-        assets: {
-          directory: ".open-next/assets",
-          binding: "ASSETS"
-        }
-      },
-      null,
-      2
-    )}
-`,
-    "utf8"
-  );
-}
-function updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl) {
-  const siteFile = join2(targetDir, "src", "data", "site.ts");
-  if (!existsSync(siteFile)) {
-    console.log("  \u26A0\uFE0F  Could not find src/data/site.ts \u2014 skipping config update.");
-    return;
-  }
-  let source = readFileSync2(siteFile, "utf8");
-  source = source.replace(
-    /name:\s*'[^']*'/,
-    `name: '${projectName.replace(/'/g, "\\'")}'`
-  );
-  source = source.replace(
-    /description:\s*\n\s*'[^']*'/,
-    `description:
-    '${description.replace(/'/g, "\\'")}'`
-  );
-  source = source.replace(
-    /const brandPreset:\s*BrandPresetKey\s*=\s*'[^']*'/,
-    `const brandPreset: BrandPresetKey = '${brandPreset}'`
-  );
-  source = source.replace(/repoUrl:\s*'[^']*'/, `repoUrl: '${repoUrl}'`);
-  source = source.replace(
-    /\{\s*label:\s*'GitHub',\s*href:\s*'[^']*'\s*\}/,
-    `{ label: 'GitHub', href: '${repoUrl}' }`
-  );
-  source = source.replace(
-    /\{\s*label:\s*'Support',\s*href:\s*'[^']*'\s*\}/,
-    `{ label: 'Support', href: '${repoUrl ? `${repoUrl}/issues/new` : ""}' }`
-  );
-  if (!repoUrl) {
-    source = source.replace(
-      /\n\s*\{\s*label:\s*'(?:GitHub|Support)',\s*href:\s*''\s*\},?/g,
-      ""
-    );
-  }
-  writeFileSync2(siteFile, source, "utf8");
-}
-function patchApiReferenceGuard(targetDir) {
-  const filePath = join2(targetDir, "src", "data", "api-reference.ts");
-  if (!existsSync(filePath)) return;
-  let source = readFileSync2(filePath, "utf8");
-  source = source.replace(
-    /export async function buildApiNavigation\([^)]*\)[^{]*\{\n/,
-    (match) => `${match}  if (apiReferenceConfig.specs.length === 0) return []
-`
-  );
-  writeFileSync2(filePath, source, "utf8");
-}
-function patchTopBarNavigation(targetDir) {
-  const filePath = join2(targetDir, "src", "components", "layout", "top-bar.tsx");
-  if (!existsSync(filePath)) return;
-  const source = readFileSync2(filePath, "utf8");
-  if (!source.includes("target={isExternal ? '_blank' : undefined}")) return;
-  const patched = source.replace(
-    /if \(collection\.href\) \{\n              const isExternal[^\n]+\n              return \(\n                <a[\s\S]*?<\/a>\n              \)\n            \}/,
-    `if (collection.href) {
-              const isExternal = /^https?:\\/\\//.test(collection.href)
-              if (isExternal) {
-                return (
-                  <a
-                    key={collection.id}
-                    href={collection.href}
-                    target="_blank"
-                    rel="noreferrer"
-                    className={baseClasses}
-                  >
-                    {collection.label}
-                  </a>
-                )
-              }
-              return (
-                <Link
-                  key={collection.id}
-                  href={collection.href}
-                  className={baseClasses}
-                >
-                  {collection.label}
-                </Link>
-              )
-            }`
-  );
-  writeFileSync2(filePath, patched, "utf8");
-}
-function patchOpenApiFetch(targetDir) {
-  const filePath = join2(targetDir, "src", "lib", "openapi", "fetch.ts");
-  if (!existsSync(filePath)) return;
-  let source = readFileSync2(filePath, "utf8");
-  source = source.replace(
-    /const absolutePath = path\.isAbsolute\(filePath\) \? filePath : path\.resolve\(process\.cwd\(\), filePath\)/,
-    `const absolutePath = filePath.startsWith('/')
-    ? path.resolve(process.cwd(), 'public', filePath.slice(1))
-    : path.resolve(process.cwd(), filePath)`
-  );
-  writeFileSync2(filePath, source, "utf8");
-}
-function updateEnvExample(targetDir) {
-  const envFile = join2(targetDir, ".env.example");
-  if (existsSync(envFile)) {
-    const envLocal = join2(targetDir, ".env.local");
-    if (!existsSync(envLocal)) {
-      cpSync(envFile, envLocal);
-    }
-  }
-}
-function patchPackageJson(targetDir, slug) {
-  const pkgPath = join2(targetDir, "package.json");
-  if (!existsSync(pkgPath)) return;
-  const pkg = JSON.parse(readFileSync2(pkgPath, "utf8"));
-  const hadWorkspaces = Array.isArray(pkg.workspaces) && pkg.workspaces.length > 0;
-  const hasRuntimeSourceCompiler = existsSync(
-    join2(targetDir, "scripts", "build-runtime-sources.mts")
-  );
-  pkg.name = slug;
-  delete pkg.workspaces;
-  if (pkg.scripts) {
-    if (hasRuntimeSourceCompiler) {
-      pkg.scripts["runtime-sources:build"] ??= "tsx scripts/build-runtime-sources.mts";
-      pkg.scripts["predev"] = "npm run runtime-sources:build";
-      pkg.scripts["postinstall"] = "npm run runtime-sources:build";
-      pkg.scripts["prebuild"] = "npm run runtime-sources:build && npm run embeddings:build";
-    } else {
-      pkg.scripts["prebuild"] = "npm run embeddings:build";
-    }
-    delete pkg.scripts["pretest"];
-    delete pkg.scripts["packages:build"];
-    pkg.scripts["build:cloudflare"] = "opennextjs-cloudflare build";
-    pkg.scripts["preview:cloudflare"] = "npm run build:cloudflare && opennextjs-cloudflare preview";
-    pkg.scripts["deploy:cloudflare"] = "npm run build:cloudflare && opennextjs-cloudflare deploy";
-    pkg.scripts["upload:cloudflare"] = "npm run build:cloudflare && opennextjs-cloudflare upload";
-  }
-  pkg.devDependencies ??= {};
-  pkg.devDependencies["@thallylabs/cli"] = "0.5.2";
-  pkg.devDependencies["@opennextjs/cloudflare"] ??= "1.15.0";
-  pkg.devDependencies.vite ??= "7.2.6";
-  pkg.devDependencies.wrangler ??= "4.111.0";
-  if (pkg.dependencies?.["@thallylabs/mcp"] === "*") {
-    pkg.dependencies["@thallylabs/mcp"] = "0.7.1";
-  }
-  writeFileSync2(pkgPath, `${JSON.stringify(pkg, null, 2)}
-`, "utf8");
-  const lockPath = join2(targetDir, "package-lock.json");
-  if (!existsSync(lockPath)) return;
-  const lock = JSON.parse(readFileSync2(lockPath, "utf8"));
-  const hasWorkspaceEntries = Object.keys(lock.packages ?? {}).some(
-    (key) => key === "packages" || key.startsWith("packages/")
-  );
-  if (hadWorkspaces || hasWorkspaceEntries) {
-    rmSync(lockPath);
-    return;
-  }
-  lock.name = slug;
-  if (lock.packages?.[""]) lock.packages[""].name = slug;
-  writeFileSync2(lockPath, `${JSON.stringify(lock, null, 2)}
-`, "utf8");
-}
-function patchGitignore(targetDir) {
-  const gitignorePath = join2(targetDir, ".gitignore");
-  const existing = existsSync(gitignorePath) ? readFileSync2(gitignorePath, "utf8") : "";
-  const lines = existing.split(/\r?\n/);
-  if (lines.includes("node_modules/")) return;
-  const separator = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
-  writeFileSync2(gitignorePath, `${existing}${separator}node_modules/
-`, "utf8");
-}
-
-// src/utils.ts
-import { execSync } from "child_process";
-import { basename } from "path";
-function slugify(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-function run(cmd, cwd) {
-  execSync(cmd, { cwd, stdio: "inherit" });
-}
-function initGit(targetDir) {
-  try {
-    run("git init", targetDir);
-    run("git add -A", targetDir);
-    run('git commit -m "Initial commit from create-thally-docs"', targetDir);
-  } catch {
-    console.log("  \u26A0\uFE0F  Could not initialize git (you can do this manually).");
-  }
-}
-function installDeps(targetDir) {
-  console.log("");
-  console.log("  \u{1F4E6} Installing dependencies...");
-  console.log("");
-  run("npm install --prefer-offline --no-audit --no-fund --progress=false", targetDir);
-}
-function logo() {
-  console.log("");
-  console.log("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
-  console.log("  \u2551                                                        \u2551");
-  console.log("  \u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557     \u2588\u2588\u2557   \u2588\u2588\u2557   \u2551");
-  console.log("  \u2551   \u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551     \u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D   \u2551");
-  console.log("  \u2551      \u2588\u2588\u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551      \u255A\u2588\u2588\u2588\u2588\u2554\u255D    \u2551");
-  console.log("  \u2551      \u2588\u2588\u2551   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551       \u255A\u2588\u2588\u2554\u255D     \u2551");
-  console.log("  \u2551      \u2588\u2588\u2551   \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2551      \u2551");
-  console.log("  \u2551      \u255A\u2550\u255D   \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D   \u255A\u2550\u255D      \u2551");
-  console.log("  \u2551                                                        \u2551");
-  console.log("  \u2551Give your product and docs first-class agent visibility.\u2551");
-  console.log("  \u2551                                                        \u2551");
-  console.log("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D");
-  console.log("");
-}
-function success(projectDir, projectName, dependenciesInstalled) {
-  console.log("");
-  console.log("  \u2705 Your Thally project is ready!");
-  console.log("");
-  console.log(`  \u{1F4C2} ${projectDir}`);
-  console.log("");
-  console.log("  Next steps:");
-  console.log("");
-  console.log(`    cd ${basename(projectDir)}`);
-  if (!dependenciesInstalled) {
-    console.log("    npm install");
-  }
-  console.log("    npm run dev");
-  console.log("");
-  console.log(`  Your terminal will print the local URL for your ${projectName} docs.`);
-  console.log("");
-  console.log("  \u{1F4DD} Key files to edit:");
-  console.log("    \u2022 src/data/site.ts        \u2014 name, links, branding");
-  console.log("    \u2022 docs.json               \u2014 navigation structure");
-  console.log("    \u2022 src/content/*.mdx        \u2014 your documentation");
-  console.log("    \u2022 openapi.yaml            \u2014 API spec (optional)");
-  console.log("");
-  console.log("  Happy documenting! \u{1F680}");
-  console.log("");
-}
-
-// src/scaffold.ts
-async function scaffold(options) {
-  const {
-    projectDir,
-    projectName,
-    description,
-    brandPreset,
-    repoUrl,
-    doInstall,
-    enableAiChat = true,
-    i18nLocales,
-    trackRepos
-  } = options;
-  const targetDir = resolve(projectDir);
-  if (existsSync2(targetDir) && readdirSync2(targetDir).length > 0) {
-    throw new Error(`Directory "${targetDir}" already exists and is not empty.`);
-  }
-  mkdirSync2(targetDir, { recursive: true });
-  const slug = slugify(projectName);
-  await downloadTemplate(targetDir, projectName);
-  resetTrackingConfig(targetDir);
-  if (trackRepos?.length) {
-    writeTrackingConfig(targetDir, trackRepos);
-    const list = trackRepos.map((r) => `${r.owner}/${r.repo}`).join(", ");
-    console.log(`  \u2713 Thally Track enabled \u2014 watching ${list} (branch main, all files; refine in docs.json).`);
-    console.log("    To finish wiring it: `thally track setup` (pick a trigger) + `thally agent init`,");
-    console.log("    then add your ANTHROPIC_API_KEY. See /guides/thally-track.");
-  }
-  writeStarterContent(targetDir, projectName, enableAiChat, repoUrl, i18nLocales);
-  writeStarterReadme(targetDir, projectName);
-  writeStarterAgentGuide(targetDir, projectName);
-  updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl);
-  patchApiReferenceGuard(targetDir);
-  patchTopBarNavigation(targetDir);
-  patchOpenApiFetch(targetDir);
-  patchPackageJson(targetDir, slug);
-  writeCloudflareRuntimeConfig(targetDir, slug);
-  patchGitignore(targetDir);
-  updateEnvExample(targetDir);
-  if (doInstall) {
-    installDeps(targetDir);
-  }
-  initGit(targetDir);
-  return { projectDir: targetDir };
-}
-
-export {
-  slugify,
-  initGit,
-  installDeps,
-  logo,
-  success,
-  readDocsJson,
-  writeDocsJson,
-  scaffold
-};