create-thally-docs 0.8.0 → 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-PZBQS5ZR.js → chunk-YWNWLSZ2.js}

@@ -3,7 +3,7 @@ import {
   initGit,
   installDeps,
   scaffold
-} from "./chunk-5GIGIHI5.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-PZBQS5ZR.js";
+} from "./chunk-YWNWLSZ2.js";
 import {
   logo,
   readDocsJson,
@@ -9,15 +9,20 @@ import {
   slugify,
   success,
   writeDocsJson
-} from "./chunk-5GIGIHI5.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";
 import { resolve as resolve2 } from "path";
 
 // src/prompts.ts
-import { input, select } from "@inquirer/prompts";
+import { confirm, input, select } from "@inquirer/prompts";
 import { basename, resolve } from "path";
+import {
+  parseGitHubRepositoryUrl
+} from "@thallylabs/migrate";
 function parseMigrationPlatform(value) {
   if (!value || value === "auto") return void 0;
   if (value === "mintlify" || value === "docusaurus") return value;
@@ -36,6 +41,54 @@ async function gatherMigrationPlatform(value, useDefaults) {
     default: "mintlify"
   });
 }
+var LIVE_URL_MIGRATION_WARNING = "Live website migration reconstructs documentation from public output and may need manual alignment. A source GitHub repository produces a more accurate migration. Use the Thally MCP afterward if the generated project needs refinement.";
+function validateGitHubRepositorySource(value) {
+  try {
+    parseGitHubRepositoryUrl(value);
+    return true;
+  } catch (error) {
+    return error instanceof Error ? error.message : "Enter a valid public GitHub repository URL.";
+  }
+}
+async function resolveAutoDetectedMigrationSource(sourceUrl, shouldPrompt) {
+  const source = new URL(sourceUrl);
+  if (source.hostname.toLowerCase() === "github.com") return sourceUrl;
+  console.warn(`
+  \u26A0 ${LIVE_URL_MIGRATION_WARNING}`);
+  if (!shouldPrompt) return sourceUrl;
+  const sourcePreference = await select({
+    message: "  Which source should Thally migrate?",
+    choices: [
+      {
+        name: "Source GitHub repository (recommended)",
+        value: "github"
+      },
+      {
+        name: "Continue with the live website URL",
+        value: "website"
+      }
+    ],
+    default: "github"
+  });
+  if (sourcePreference === "github") {
+    const repositoryUrl = await input({
+      message: "  GitHub repository URL:",
+      validate: validateGitHubRepositorySource
+    });
+    parseGitHubRepositoryUrl(repositoryUrl);
+    return repositoryUrl;
+  }
+  const hasAcceptedAlignment = await confirm({
+    message: "  Continue knowing the migration may need manual alignment, using the Thally MCP afterward if needed?",
+    default: false
+  });
+  if (!hasAcceptedAlignment) {
+    throw new Error(
+      "Migration cancelled. Re-run with the source GitHub repository for the most accurate result."
+    );
+  }
+  return sourceUrl;
+}
 async function gatherAnswers(dirArg, useDefaults, installPreference) {
   let projectDir;
   if (dirArg) {
@@ -98,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",
@@ -131,13 +184,26 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
 }
 
 // src/index.ts
-import { parseGitHubRepositoryUrl } from "@thallylabs/migrate";
+import { parseGitHubRepositoryUrl as parseGitHubRepositoryUrl2 } from "@thallylabs/migrate";
 
 // src/check.ts
 import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import { join, extname, relative } from "path";
 import { execFileSync } from "child_process";
+
+// src/frontmatter.ts
 import matter from "gray-matter";
+var FRONTMATTER_OPTIONS = {
+  engines: {
+    javascript: () => ({}),
+    js: () => ({})
+  }
+};
+function parseFrontmatter(raw) {
+  return matter(raw, FRONTMATTER_OPTIONS);
+}
+
+// src/check.ts
 import { parse as parseYaml } from "yaml";
 function gitLocal(projectDir, args2) {
   try {
@@ -373,7 +439,7 @@ async function runCheck(projectDir, options) {
     let lineOffset = 0;
     try {
       const raw = readFileSync(filePath, "utf8");
-      const parsed = matter(raw);
+      const parsed = parseFrontmatter(raw);
       data = parsed.data;
       content = parsed.content;
       lineOffset = raw.slice(0, raw.indexOf(content)).split("\n").length - 1;
@@ -474,7 +540,6 @@ thally check: ${errors.length} error(s), ${warnings.length} warning(s)`);
 import { readFileSync as readFileSync2, writeFileSync, existsSync as existsSync2, mkdirSync } from "fs";
 import { join as join2, dirname } from "path";
 import { input as input2 } from "@inquirer/prompts";
-import matter2 from "gray-matter";
 import Anthropic from "@anthropic-ai/sdk";
 import pLimit from "p-limit";
 function readDocsJson2(projectDir) {
@@ -654,11 +719,11 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
   }
   console.log("");
   if (!yes) {
-    const confirm = await input2({
+    const confirm2 = await input2({
       message: "  Proceed? (Y/n):",
       default: "Y"
     });
-    if (confirm.toLowerCase() === "n") {
+    if (confirm2.toLowerCase() === "n") {
       console.log("\n  Aborted.");
       return;
     }
@@ -672,7 +737,7 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
       ({ pageId, sourceFile, targetFile }) => limit(async () => {
         try {
           const sourceContent = readFileSync2(sourceFile, "utf8");
-          const parsed = matter2(sourceContent);
+          const parsed = parseFrontmatter(sourceContent);
           if (!parsed.data.title) {
             console.warn(`  \u26A0  ${pageId}: missing title in frontmatter \u2014 translating anyway`);
           }
@@ -732,7 +797,7 @@ function getFlagValue(flag) {
   return void 0;
 }
 async function runMigrateCommand() {
-  const sourceUrl = positional[1];
+  let sourceUrl = positional[1];
   if (!sourceUrl) {
     console.error("\n  \u274C Source URL is required.");
     console.error("     Usage: create-thally-docs migrate <github-or-docs-url> [output-dir] [options]");
@@ -743,12 +808,22 @@ async function runMigrateCommand() {
   try {
     source = new URL(sourceUrl);
     if (!["http:", "https:"].includes(source.protocol)) throw new Error("Only HTTP and HTTPS sources are supported.");
-    if (source.hostname.toLowerCase() === "github.com") parseGitHubRepositoryUrl(sourceUrl);
+    if (source.hostname.toLowerCase() === "github.com") parseGitHubRepositoryUrl2(sourceUrl);
   } catch (err) {
     console.error(`
   \u274C ${err instanceof Error ? err.message : err}`);
     process.exit(1);
   }
+  const branch = getFlagValue("--branch");
+  const docsDir = getFlagValue("--docs-dir");
+  const yes = flags.includes("--yes") || flags.includes("-y");
+  const platformFlag = getFlagValue("--platform");
+  const platform = await gatherMigrationPlatform(platformFlag, yes);
+  if (platform === void 0) {
+    const shouldPromptForSource = platformFlag === void 0 && !yes;
+    sourceUrl = await resolveAutoDetectedMigrationSource(sourceUrl, shouldPromptForSource);
+    source = new URL(sourceUrl);
+  }
   const apiKey = getFlagValue("--api-key") ?? process.env.ANTHROPIC_API_KEY;
   const intoDir = getFlagValue("--into");
   const isInto = Boolean(intoDir);
@@ -758,13 +833,9 @@ async function runMigrateCommand() {
   } else if (positional[2]) {
     projectDir = resolve2(positional[2]);
   } else {
-    const sourceName = source.hostname.toLowerCase() === "github.com" ? parseGitHubRepositoryUrl(sourceUrl).repo : source.pathname.split("/").filter(Boolean).at(-1) ?? source.hostname.split(".")[0];
+    const sourceName = source.hostname.toLowerCase() === "github.com" ? parseGitHubRepositoryUrl2(sourceUrl).repo : source.pathname.split("/").filter(Boolean).at(-1) ?? source.hostname.split(".")[0];
     projectDir = resolve2(`${slugify(sourceName)}-docs`);
   }
-  const branch = getFlagValue("--branch");
-  const docsDir = getFlagValue("--docs-dir");
-  const yes = flags.includes("--yes") || flags.includes("-y");
-  const platform = await gatherMigrationPlatform(getFlagValue("--platform"), yes);
   const maxPagesValue = getFlagValue("--max-pages");
   const maxPages = maxPagesValue ? Number(maxPagesValue) : void 0;
   if (maxPages !== void 0 && (!Number.isInteger(maxPages) || maxPages < 1 || maxPages > 1e3)) {

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-PZBQS5ZR.js";
-import "../chunk-5GIGIHI5.js";
+} from "../chunk-YWNWLSZ2.js";
+import "../chunk-JNDRCCJV.js";
+import "../chunk-BW7J7DJV.js";
+import "../chunk-PJW4JJIT.js";
 export {
   migrateDocs
 };