create-thally-docs 0.8.1 → 0.9.0

package/dist/chunk-JNDRCCJV.js

@@ -0,0 +1,232 @@
+#!/usr/bin/env node
+import {
+  patchApiReferenceGuard,
+  patchGitignore,
+  patchOpenApiFetch,
+  patchPackageJson,
+  patchTopBarNavigation,
+  updateEnvExample,
+  updateSiteConfig,
+  writeCloudflareRuntimeConfig,
+  writeStarterAgentGuide,
+  writeStarterContent,
+  writeStarterReadme
+} from "./chunk-BW7J7DJV.js";
+import {
+  STABLE_SCAFFOLD_RELEASE
+} from "./chunk-PJW4JJIT.js";
+
+// src/scaffold.ts
+import { existsSync, mkdirSync, readdirSync } from "fs";
+import { resolve } from "path";
+
+// src/download.ts
+import { Readable, pipeline } from "stream";
+import { promisify } from "util";
+import { extract } from "tar";
+var pipelineAsync = promisify(pipeline);
+var TEMPLATE_REPOSITORY = STABLE_SCAFFOLD_RELEASE.source.repository;
+var TEMPLATE_COMMIT_SHA = STABLE_SCAFFOLD_RELEASE.source.commitSha;
+var TARBALL_URL = STABLE_SCAFFOLD_RELEASE.source.archiveUrl;
+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,
+    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/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 (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+    throw new Error(`Directory "${targetDir}" already exists and is not empty.`);
+  }
+  mkdirSync(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,
+  TEMPLATE_REPOSITORY,
+  TEMPLATE_COMMIT_SHA,
+  EXCLUDE_PATHS,
+  shouldInclude,
+  readDocsJson,
+  writeDocsJson,
+  scaffold
+};

package/dist/chunk-PJW4JJIT.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+// src/release.ts
+var STABLE_SCAFFOLD_RELEASE = {
+  schemaVersion: 1,
+  id: "2026-08-04.b0094de4.e36d2bcf",
+  source: {
+    repository: "thallylabs/docs",
+    commitSha: "b0094de4fea84567eb12c39c6783fdae6820bb98",
+    treeSha: "ffd0a6fda07341ddd1ba164cb40acef796f89e2d",
+    archiveUrl: "https://codeload.github.com/thallylabs/docs/tar.gz/b0094de4fea84567eb12c39c6783fdae6820bb98"
+  },
+  runtime: {
+    repository: "thallylabs/thally",
+    commitSha: "e36d2bcff38f7638a77369e12773a7cab4d5d9ce",
+    treeSha: "1c8b0358d78d8caa14ed039bff6ab47c98b685d8",
+    contentSource: "assets",
+    identityContractVersion: 1
+  },
+  starterVersion: 1
+};
+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.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,
+  isStableScaffoldRelease
+};

package/dist/{chunk-SDZZYPSN.js → chunk-YWNWLSZ2.js}

@@ -3,7 +3,7 @@ import {
   initGit,
   installDeps,
   scaffold
-} from "./chunk-RS6U2GSX.js";
+} from "./chunk-JNDRCCJV.js";
 
 // src/migrate/index.ts
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "fs";

package/dist/customize.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Lowest `@thallylabs/cli` release a scaffold may declare.
+ *
+ * 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.
+ */
+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 {
+    projectName: string;
+    enableAiChat?: boolean;
+    repoUrl?: string;
+    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.
+ *
+ * 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.
+ */
+declare function writeCloudflareRuntimeConfig(targetDir: string, slug: string): void;
+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;
+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;
+
+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 };

package/dist/customize.js

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "./chunk-SDZZYPSN.js";
+} from "./chunk-YWNWLSZ2.js";
 import {
   logo,
   readDocsJson,
@@ -9,7 +9,9 @@ import {
   slugify,
   success,
   writeDocsJson
-} from "./chunk-RS6U2GSX.js";
+} from "./chunk-JNDRCCJV.js";
+import "./chunk-BW7J7DJV.js";
+import "./chunk-PJW4JJIT.js";
 
 // src/index.ts
 import { existsSync as existsSync3, readdirSync as readdirSync2 } from "fs";
@@ -149,13 +151,13 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
   let i18nLocales;
   if (!useDefaults) {
     const enableI18n = await input({
-      message: "  Enable multi-language support? (y/N):",
+      message: "  Add languages beyond English and Spanish? (y/N):",
       default: "N"
     });
     if (enableI18n.toLowerCase() === "y") {
       const localesInput = await input({
-        message: "  Which locales? (comma-separated codes, e.g. es,fr,de):",
-        default: "es"
+        message: "  Which additional locales? (comma-separated codes, e.g. fr,de,ja):",
+        default: "fr"
       });
       const LOCALE_LABELS = {
         en: "English",

package/dist/migrate/index.d.ts

@@ -0,0 +1,35 @@
+import { MigrationPlatform, MigrationFetcher, MigrationBundle, MigrationWarning } from '@thallylabs/migrate';
+
+/**
+ * CLI materializer for the shared Thally migration engine. Discovery completes
+ * before scaffolding or writing, and every generated path is proven to remain
+ * inside the selected project directory.
+ */
+
+interface MigrateOptions {
+    sourceUrl: string;
+    projectDir: string;
+    into: boolean;
+    /** Retained for CLI compatibility; Markdown/MDX imports do not require a key. */
+    apiKey?: string;
+    branch?: string;
+    docsDir?: string;
+    projectName?: string;
+    yes: boolean;
+    maxPages?: number;
+    /** Explicit source platform selected by an interactive or automated caller. */
+    platform?: MigrationPlatform;
+    /** Optional host fetch boundary; used by Thally Cloud adapters and tests. */
+    fetcher?: MigrationFetcher;
+}
+interface MigrateResult {
+    pagesWritten: number;
+    assetsWritten: number;
+    projectDir: string;
+    platform: MigrationBundle['platform'];
+    warnings: Array<MigrationWarning>;
+}
+/** Import a GitHub docs repository or public docs URL into a Thally project. */
+declare function migrateDocs(options: MigrateOptions): Promise<MigrateResult>;
+
+export { type MigrateOptions, type MigrateResult, migrateDocs };

package/dist/migrate/index.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-SDZZYPSN.js";
-import "../chunk-RS6U2GSX.js";
+} from "../chunk-YWNWLSZ2.js";
+import "../chunk-JNDRCCJV.js";
+import "../chunk-BW7J7DJV.js";
+import "../chunk-PJW4JJIT.js";
 export {
   migrateDocs
 };

package/dist/release.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Immutable source and runtime identity for every newly scaffolded Thally site.
+ *
+ * A release is promoted only after the source snapshot and its compiled runtime
+ * have passed the scaffold, build, and identity-safety gates. Consumers must
+ * use the whole record: independently resolving "latest template" and "latest
+ * runtime" recreates the drift this contract exists to prevent.
+ */
+interface ScaffoldSourceRelease {
+    repository: string;
+    commitSha: string;
+    treeSha: string;
+    archiveUrl: string;
+}
+interface ScaffoldRuntimeRelease {
+    repository: string;
+    commitSha: string;
+    treeSha: string;
+    contentSource: 'assets';
+    identityContractVersion: number;
+}
+interface ScaffoldRelease {
+    schemaVersion: 1;
+    id: string;
+    source: ScaffoldSourceRelease;
+    runtime: ScaffoldRuntimeRelease;
+    starterVersion: number;
+}
+/**
+ * Current stable scaffold release.
+ *
+ * The source commit is the refreshed public docs template and the runtime
+ * commit is the matching engine change. `create-thally-docs`, the CLI, MCP,
+ * and Thally Cloud all import this exact record rather than following a moving
+ * branch independently.
+ */
+declare const STABLE_SCAFFOLD_RELEASE: {
+    readonly schemaVersion: 1;
+    readonly id: "2026-08-04.b0094de4.e36d2bcf";
+    readonly source: {
+        readonly repository: "thallylabs/docs";
+        readonly commitSha: "b0094de4fea84567eb12c39c6783fdae6820bb98";
+        readonly treeSha: "ffd0a6fda07341ddd1ba164cb40acef796f89e2d";
+        readonly archiveUrl: "https://codeload.github.com/thallylabs/docs/tar.gz/b0094de4fea84567eb12c39c6783fdae6820bb98";
+    };
+    readonly runtime: {
+        readonly repository: "thallylabs/thally";
+        readonly commitSha: "e36d2bcff38f7638a77369e12773a7cab4d5d9ce";
+        readonly treeSha: "1c8b0358d78d8caa14ed039bff6ab47c98b685d8";
+        readonly contentSource: "assets";
+        readonly identityContractVersion: 1;
+    };
+    readonly starterVersion: 1;
+};
+/** True only when an unknown record is the currently supported release. */
+declare function isStableScaffoldRelease(value: unknown): value is ScaffoldRelease;
+
+export { STABLE_SCAFFOLD_RELEASE, type ScaffoldRelease, type ScaffoldRuntimeRelease, type ScaffoldSourceRelease, isStableScaffoldRelease };

package/dist/release.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  STABLE_SCAFFOLD_RELEASE,
+  isStableScaffoldRelease
+} from "./chunk-PJW4JJIT.js";
+export {
+  STABLE_SCAFFOLD_RELEASE,
+  isStableScaffoldRelease
+};

package/dist/scaffold.d.ts

@@ -0,0 +1,38 @@
+export { STABLE_SCAFFOLD_RELEASE } from './release.js';
+
+/**
+ * The live Thally documentation site is also the canonical standalone site
+ * source. Keeping one source means a runtime or UI improvement shipped to the
+ * docs is available to every subsequent scaffold without maintaining a second
+ * template repository.
+ */
+declare const TEMPLATE_REPOSITORY: "thallylabs/docs";
+declare const TEMPLATE_COMMIT_SHA: "b0094de4fea84567eb12c39c6783fdae6820bb98";
+declare const EXCLUDE_PATHS: string[];
+/** True if a tarball entry should land in the scaffold (see EXCLUDE_PATHS). */
+declare function shouldInclude(path: string): boolean;
+
+interface ScaffoldOptions {
+    projectDir: string;
+    projectName: string;
+    description: string;
+    brandPreset: string;
+    repoUrl: string;
+    doInstall: boolean;
+    enableAiChat?: boolean;
+    i18nLocales?: Array<{
+        code: string;
+        label: string;
+    }>;
+    /** Repos to pre-register for Thally Track (opt-in). Empty/undefined = Track off. */
+    trackRepos?: Array<{
+        owner: string;
+        repo: string;
+    }>;
+}
+interface ScaffoldResult {
+    projectDir: string;
+}
+declare function scaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
+
+export { EXCLUDE_PATHS, type ScaffoldOptions, type ScaffoldResult, TEMPLATE_COMMIT_SHA, TEMPLATE_REPOSITORY, scaffold, shouldInclude };

package/dist/scaffold.js

@@ -1,7 +1,20 @@
 #!/usr/bin/env node
 import {
-  scaffold
-} from "./chunk-RS6U2GSX.js";
+  EXCLUDE_PATHS,
+  TEMPLATE_COMMIT_SHA,
+  TEMPLATE_REPOSITORY,
+  scaffold,
+  shouldInclude
+} from "./chunk-JNDRCCJV.js";
+import "./chunk-BW7J7DJV.js";
+import {
+  STABLE_SCAFFOLD_RELEASE
+} from "./chunk-PJW4JJIT.js";
 export {
-  scaffold
+  EXCLUDE_PATHS,
+  STABLE_SCAFFOLD_RELEASE,
+  TEMPLATE_COMMIT_SHA,
+  TEMPLATE_REPOSITORY,
+  scaffold,
+  shouldInclude
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Scaffold the first documentation surface in a Thally product-knowledge pipeline.",
   "type": "module",
   "engines": {
@@ -12,6 +12,14 @@
   "exports": {
     ".": "./dist/index.js",
     "./scaffold": "./dist/scaffold.js",
+    "./starter": {
+      "types": "./dist/customize.d.ts",
+      "import": "./dist/customize.js"
+    },
+    "./release": {
+      "types": "./dist/release.d.ts",
+      "import": "./dist/release.js"
+    },
     "./migrate": "./dist/migrate/index.js",
     "./package.json": "./package.json"
   },
@@ -31,12 +39,11 @@
     "@thallylabs/migrate": "0.2.0",
     "gray-matter": "^4.0.3",
     "p-limit": "^6.1.0",
-    "tar": "^6.2.0",
+    "tar": "^7.5.22",
     "yaml": "^2.6.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@types/tar": "^6.1.13",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   },