create-thally-docs 0.7.1 → 0.7.3

package/dist/index.js

@@ -2,7 +2,7 @@
 import {
   migrateDocs,
   parseGitHubUrl
-} from "./chunk-YAG5BZEM.js";
+} from "./chunk-PGTE4X3G.js";
 import {
   logo,
   readDocsJson,
@@ -10,7 +10,7 @@ import {
   slugify,
   success,
   writeDocsJson
-} from "./chunk-6HO6ECUE.js";
+} from "./chunk-WMVWYKAB.js";
 
 // src/index.ts
 import { existsSync as existsSync3, readdirSync as readdirSync2 } from "fs";
@@ -20,7 +20,7 @@ import { resolve as resolve2 } from "path";
 import { input, select } from "@inquirer/prompts";
 import { basename } from "path";
 import { resolve } from "path";
-async function gatherAnswers(dirArg, useDefaults) {
+async function gatherAnswers(dirArg, useDefaults, installPreference) {
   let projectDir;
   if (dirArg) {
     projectDir = resolve(dirArg);
@@ -71,13 +71,13 @@ async function gatherAnswers(dirArg, useDefaults) {
       else console.log("  \u26A0 No valid owner/repo entries \u2014 skipping Track (add it later with `thally track add`).");
     }
   }
-  let doInstall = true;
-  if (!useDefaults) {
+  let doInstall = installPreference ?? false;
+  if (!useDefaults && installPreference === void 0) {
     const shouldInstall = await input({
-      message: "  Install dependencies? (Y/n):",
-      default: "Y"
+      message: "  Install dependencies now? (y/N):",
+      default: "N"
     });
-    doInstall = shouldInstall.toLowerCase() !== "n";
+    doInstall = shouldInstall.trim().toLowerCase().startsWith("y");
   }
   let i18nLocales;
   if (!useDefaults) {
@@ -240,8 +240,17 @@ function extractLinks(content) {
   }
   return links;
 }
-function pageIdToPath(pageId) {
-  return pageId === "introduction" ? "/" : `/${pageId}`;
+function localizedPage(pageId, secondaryLocales) {
+  const [first, ...rest] = pageId.split("/");
+  if (secondaryLocales.has(first) && rest.length > 0) {
+    return { navPageId: rest.join("/"), locale: first };
+  }
+  return { navPageId: pageId };
+}
+function pageIdToPath(pageId, secondaryLocales) {
+  const { navPageId, locale } = localizedPage(pageId, secondaryLocales);
+  const basePath = navPageId === "introduction" ? "/" : `/${navPageId}`;
+  return locale ? `/${locale}${basePath === "/" ? "" : basePath}` : basePath;
 }
 function validateOpenApi(projectDir, source, issues) {
   const specPath = join(projectDir, source);
@@ -292,6 +301,13 @@ async function runCheck(projectDir, options) {
   const contentDir = join(projectDir, "src", "content");
   const issues = [];
   const config = readDocsJson(projectDir);
+  const secondaryLocales = new Set(
+    (config.i18n?.locales ?? []).map((locale) => locale.code).filter((code) => code !== config.i18n?.defaultLocale)
+  );
+  const generatedApiPaths = /* @__PURE__ */ new Set([
+    "/api",
+    ...Array.from(secondaryLocales, (locale) => `/${locale}/api`)
+  ]);
   const navPageIds = /* @__PURE__ */ new Set();
   const duplicates = /* @__PURE__ */ new Set();
   for (const tab of config.tabs) {
@@ -324,7 +340,8 @@ async function runCheck(projectDir, options) {
   for (const filePath of allFiles) {
     const rel = filePath.slice(contentDir.length + 1).replace(/\.mdx$/, "").replace(/\\/g, "/");
     const pageId = rel.endsWith("/index") ? rel.slice(0, -6) : rel;
-    if (!navPageIds.has(pageId)) {
+    const { navPageId } = localizedPage(pageId, secondaryLocales);
+    if (!navPageIds.has(navPageId)) {
       if (fix) {
         addOrphanToNav(projectDir, pageId);
         fixedOrphans.push(pageId);
@@ -350,7 +367,7 @@ async function runCheck(projectDir, options) {
     if (!data.description) issues.push({ severity: "warning", message: `Missing "description" in frontmatter`, file: rel2 });
     if (content.trim().length < 50) issues.push({ severity: "warning", message: `Very short body (${content.trim().length} chars) \u2014 page may be empty`, file: rel2 });
     if (options.drift) checkDrift(projectDir, rel2, data, issues);
-    const path = pageIdToPath(pageId);
+    const path = pageIdToPath(pageId, secondaryLocales);
     const anchors = extractHeadingAnchors(content);
     validPaths.add(path);
     anchorsByPath.set(path, anchors);
@@ -371,7 +388,10 @@ async function runCheck(projectDir, options) {
       const [beforeHash, anchor] = target.split("#");
       let path = beforeHash.split("?")[0];
       if (path.length > 1) path = path.replace(/\/$/, "");
-      if (path.startsWith("/api") || path.startsWith("/_next") || /\.[a-z0-9]+$/i.test(path)) continue;
+      const isGeneratedApiPath = Array.from(generatedApiPaths).some(
+        (prefix) => path === prefix || path.startsWith(`${prefix}/`)
+      );
+      if (isGeneratedApiPath || path.startsWith("/_next") || /\.[a-z0-9]+$/i.test(path)) continue;
       if (!validPaths.has(path)) {
         issues.push({ severity: "error", message: `Broken link: "${target}" \u2014 no page at "${path}"`, file, line });
       } else if (anchor && !anchorsByPath.get(path)?.has(anchor)) {
@@ -662,10 +682,19 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
 // src/index.ts
 var args = process.argv.slice(2);
 var flags = args.filter((a) => a.startsWith("-"));
+var valueFlags = /* @__PURE__ */ new Set([
+  "--api-key",
+  "--branch",
+  "--docs-dir",
+  "--into",
+  "--locale",
+  "--model",
+  "--pages"
+]);
 var positional = [];
 for (let i = 0; i < args.length; i++) {
   if (args[i].startsWith("-")) {
-    if (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+    if (valueFlags.has(args[i]) && i + 1 < args.length && !args[i + 1].startsWith("-")) {
       i++;
     }
   } else {
@@ -734,6 +763,7 @@ async function runMigrateCommand() {
 }
 async function runScaffoldCommand() {
   const useDefaults = flags.includes("--yes") || flags.includes("-y");
+  const installPreference = flags.includes("--install") ? true : flags.includes("--no-install") ? false : void 0;
   const dirArg = positional[0];
   if (dirArg) {
     const resolved = resolve2(dirArg);
@@ -743,7 +773,7 @@ async function runScaffoldCommand() {
       process.exit(1);
     }
   }
-  const answers = await gatherAnswers(dirArg, useDefaults);
+  const answers = await gatherAnswers(dirArg, useDefaults, installPreference);
   const result = await scaffold({
     projectDir: answers.projectDir,
     projectName: answers.projectName,
@@ -754,7 +784,7 @@ async function runScaffoldCommand() {
     i18nLocales: answers.i18nLocales,
     trackRepos: answers.trackRepos
   });
-  success(result.projectDir, answers.projectName);
+  success(result.projectDir, answers.projectName, answers.doInstall);
 }
 async function runCheckCommand() {
   const projectDir = resolve2(positional[1] ?? ".");

package/dist/migrate/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-YAG5BZEM.js";
-import "../chunk-6HO6ECUE.js";
+} from "../chunk-PGTE4X3G.js";
+import "../chunk-WMVWYKAB.js";
 export {
   migrateDocs
 };

package/dist/scaffold.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-6HO6ECUE.js";
+} from "./chunk-WMVWYKAB.js";
 export {
   scaffold
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Scaffold a new Thally documentation project",
   "type": "module",
   "engines": {

package/dist/chunk-6HO6ECUE.js

@@ -1,454 +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 TARBALL_URL = "https://codeload.github.com/thallylabs/thally/tar.gz/main";
-var EXCLUDE_PATHS = [
-  "/cli/",
-  "/packages/",
-  "/node_modules/",
-  "/.git/",
-  "/thally-agent.yml",
-  "/thally-track.yml",
-  "/CODEOWNERS",
-  "/CLAUDE.md",
-  "/notes/"
-];
-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";
-import { execSync } from "child_process";
-var STARTER_PAGES = {
-  "introduction.mdx": `---
-title: Introduction
-description: Welcome to {NAME} \u2014 learn what it does, how the docs are organized, and where to start.
-keywords:
-  - {NAME}
-  - documentation
-  - overview
-  - getting started
----
-
-## Welcome
-
-Welcome to the **{NAME}** documentation. This is your home base for guides, API
-references, and everything you need to build with {NAME}. The site is powered by
-[Thally](https://github.com/thallylabs/thally), an agent-native docs platform \u2014 every page
-is served to humans as polished HTML and to AI agents as structured JSON, JSON-LD,
-and Markdown from the same URL, so assistants can read your docs accurately.
-
-## What you'll find here
-
-- **Guides** \u2014 step-by-step walkthroughs of common tasks and workflows.
-- **API reference** \u2014 generated from your OpenAPI spec, with a live "Try It" console.
-- **Quickstart** \u2014 install {NAME} and make your first call in a few minutes.
-
-## Next steps
-
-Start with the [Quickstart](/quickstart) to get {NAME} running, then make this site
-your own by editing \`src/content/introduction.mdx\` and updating the navigation in
-\`docs.json\`. Every change you save is instantly reflected for both readers and agents.
-`,
-  "quickstart.mdx": `---
-title: Quickstart
-description: Install {NAME}, configure your API key, and make your first call in under five minutes.
-keywords:
-  - {NAME}
-  - quickstart
-  - installation
-  - getting started
----
-
-## Installation
-
-Install {NAME} with your package manager of choice. We recommend pinning the
-version in your project so builds stay reproducible across machines and CI:
-
-\`\`\`bash
-npm install {SLUG}
-\`\`\`
-
-## Basic usage
-
-Import the client and initialize it with your API key. Keep the key in an
-environment variable rather than committing it to source control, so it never
-leaks into your repository or build logs:
-
-\`\`\`ts
-import { create } from '{SLUG}'
-
-const client = create({ apiKey: process.env.API_KEY })
-\`\`\`
-
-## What's next
-
-That's the basics \u2014 you're ready to build. Explore the guides for common workflows,
-open the API reference to try endpoints against a live "Try It" console, or edit this
-page at \`src/content/quickstart.mdx\` to document your own onboarding flow.
-`,
-  "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.
-`
-};
-function buildStarterDocsJson({
-  enableAiChat,
-  repoUrl,
-  i18nLocales
-}) {
-  const config = {};
-  config.theme = "sharp";
-  config.fonts = {
-    body: { family: "Plus Jakarta Sans", weight: ["400", "500", "600", "700"] },
-    heading: { family: "Outfit", weight: ["600", "700"] }
-  };
-  if (enableAiChat) {
-    config.ai = { chat: true };
-  }
-  if (repoUrl) {
-    config.navbar = {
-      links: [{ label: "GitHub", href: repoUrl, type: "github" }],
-      primary: { label: "Get started", href: "/quickstart" }
-    };
-  }
-  if (i18nLocales && i18nLocales.length > 0) {
-    config.i18n = {
-      defaultLocale: "en",
-      locales: [{ code: "en", label: "English" }, ...i18nLocales]
-    };
-  }
-  config.tabs = [
-    {
-      tab: "Overview",
-      groups: [{ group: "Getting Started", pages: ["introduction", "quickstart"] }]
-    },
-    { tab: "API Reference", api: { source: "openapi.yaml" } },
-    { tab: "Changelog", href: "/changelog" }
-  ];
-  return JSON.stringify(config, null, 2) + "\n";
-}
-function writeStarterContent(targetDir, projectName, slug, 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);
-      execSync(`rm -rf "${fullPath}"`);
-    }
-  } else {
-    mkdirSync(contentDir, { recursive: true });
-  }
-  for (const [filename, template] of Object.entries(STARTER_PAGES)) {
-    const content = template.replace(/\{NAME\}/g, projectName).replace(/\{SLUG\}/g, slug);
-    writeFileSync2(join2(contentDir, filename), content, "utf8");
-  }
-  writeFileSync2(
-    join2(targetDir, "docs.json"),
-    buildStarterDocsJson({ enableAiChat, repoUrl: repoUrl || void 0, i18nLocales }),
-    "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` : ""}' }`
-  );
-  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"));
-  pkg.name = slug;
-  delete pkg.workspaces;
-  if (pkg.scripts) {
-    if (pkg.scripts["prebuild"]) pkg.scripts["prebuild"] = "npm run embeddings:build";
-    delete pkg.scripts["pretest"];
-    delete pkg.scripts["packages:build"];
-  }
-  writeFileSync2(pkgPath, `${JSON.stringify(pkg, null, 2)}
-`, "utf8");
-  const lockPath = join2(targetDir, "package-lock.json");
-  if (existsSync(lockPath)) rmSync(lockPath);
-}
-
-// src/utils.ts
-import { execSync as execSync2 } from "child_process";
-import { basename } from "path";
-function slugify(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-function run(cmd, cwd) {
-  execSync2(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", 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("  \u2551             Beautiful docs, zero lock-in.              \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) {
-  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)}`);
-  console.log("    npm run dev");
-  console.log("");
-  console.log(`  Then open http://localhost:3040 to see 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, slug, enableAiChat, repoUrl, i18nLocales);
-  updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl);
-  patchApiReferenceGuard(targetDir);
-  patchTopBarNavigation(targetDir);
-  patchOpenApiFetch(targetDir);
-  patchPackageJson(targetDir, slug);
-  updateEnvExample(targetDir);
-  if (doInstall) {
-    installDeps(targetDir);
-  }
-  initGit(targetDir);
-  return { projectDir: targetDir };
-}
-
-export {
-  slugify,
-  initGit,
-  installDeps,
-  logo,
-  success,
-  readDocsJson,
-  writeDocsJson,
-  scaffold
-};