create-thally-docs 0.10.51 → 0.10.53

package/README.md

@@ -53,7 +53,10 @@ scripts and CI, pass
 `--platform mintlify`, `--platform docusaurus`, or `--platform auto`; `--yes`
 keeps backward-compatible auto-detection when no platform flag is supplied.
 Explicit `--platform auto` and `--yes` runs print the live-site limitation
-without introducing an interactive prompt.
+without introducing an interactive prompt. Running `migrate` without
+`--platform` or `--yes` from a non-interactive shell (a script, a CI job, a
+piped command) also skips the platform prompt — it can't be answered there —
+and auto-detects instead, with a warning naming the flag that silences it.
 
 Mintlify repository migrations preserve the source information architecture
 instead of rebuilding navigation from folders: nested project roots, `$ref`

package/dist/{chunk-WSP42NTD.js → chunk-5DNAAGM6.js}

@@ -5,7 +5,7 @@ import {
   readDocsJson,
   scaffold,
   writeDocsJson
-} from "./chunk-4JIBGZHO.js";
+} from "./chunk-YFOGBPFV.js";
 
 // src/migrate/index.ts
 import { existsSync as existsSync3, mkdirSync, mkdtempSync, readFileSync as readFileSync3, rmSync, writeFileSync } from "fs";
@@ -55,6 +55,7 @@ function parseFrontmatter(raw) {
 // src/check.ts
 import { parse as parseYaml2 } from "yaml";
 import { projectNavigationContract } from "@thallylabs/core/navigation";
+import { slugify } from "@thallylabs/core/slugify";
 function gitLocal(projectDir, args) {
   try {
     const out = execFileSync("git", args, { cwd: projectDir, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
@@ -142,14 +143,16 @@ function addOrphanToNav(projectDir, pageId) {
     writeDocsJson(projectDir, config);
   }
 }
-function slugify(text) {
-  return text.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-");
-}
+var EXPLICIT_ID_ATTRIBUTE = /\bid=(?:"([^"]*)"|'([^']*)'|\{["']([^"'}]*)["']\})/g;
 function extractHeadingAnchors(content) {
   const anchors = /* @__PURE__ */ new Set();
   for (const line of content.split("\n")) {
-    const m = /^#{1,6}\s+(.+?)\s*#*\s*$/.exec(line);
-    if (m) anchors.add(slugify(m[1]));
+    const heading = /^ {0,3}#{1,6}\s+(.+?)\s*#*\s*$/.exec(line);
+    if (heading) anchors.add(slugify(heading[1]));
+    for (const idMatch of line.matchAll(EXPLICIT_ID_ATTRIBUTE)) {
+      const id = idMatch[1] ?? idMatch[2] ?? idMatch[3];
+      if (id) anchors.add(id);
+    }
   }
   return anchors;
 }
@@ -173,6 +176,26 @@ function extractLinks(content) {
   }
   return links;
 }
+function extractImageRefs(content) {
+  const refs = [];
+  const lines = content.split("\n");
+  let inFence = false;
+  for (let i = 0; i < lines.length; i++) {
+    if (/^\s*(```|~~~)/.test(lines[i])) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence) continue;
+    const line = lines[i].replace(/`[^`]*`/g, "");
+    for (const m of line.matchAll(/!\[[^\]]*\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g)) {
+      refs.push({ target: m[1], line: i + 1 });
+    }
+    for (const m of line.matchAll(/\bsrc=["']([^"']+)["']/g)) {
+      refs.push({ target: m[1], line: i + 1 });
+    }
+  }
+  return refs;
+}
 function localizedPage(pageId, secondaryLocales) {
   const [first, ...rest] = pageId.split("/");
   if (secondaryLocales.has(first) && rest.length > 0) {
@@ -322,7 +345,7 @@ async function runCheck(projectDir, options) {
     validPaths.add(`/${pageId}`);
     anchorsByPath.set(path, anchors);
     anchorsByPath.set(`/${pageId}`, anchors);
-    linksByFile.push({ file: rel2, path, anchors, links: extractLinks(content), offset: lineOffset });
+    linksByFile.push({ file: rel2, path, anchors, links: extractLinks(content), images: extractImageRefs(content), offset: lineOffset });
   }
   for (const [path, anchors] of [...anchorsByPath]) {
     if (secondaryLocales.has(path.split("/")[1])) continue;
@@ -358,6 +381,24 @@ async function runCheck(projectDir, options) {
       }
     }
   }
+  const publicDir = join(projectDir, "public");
+  for (const { file, images, offset } of linksByFile) {
+    for (const { target, line: contentLine } of images) {
+      const line = contentLine + offset;
+      if (/^(https?:|data:|\{)/i.test(target)) continue;
+      if (!target.startsWith("/")) continue;
+      const pathOnly = target.split(/[?#]/, 1)[0];
+      let decoded;
+      try {
+        decoded = decodeURIComponent(pathOnly);
+      } catch {
+        continue;
+      }
+      if (!existsSync(join(publicDir, decoded))) {
+        issues.push({ severity: "warning", message: `Image not found: "${target}" has no file under public/`, file, line });
+      }
+    }
+  }
   for (const tab of config.tabs) {
     if (tab.api?.source) validateOpenApi(projectDir, tab.api.source, issues);
   }
@@ -490,13 +531,15 @@ async function discoverMigration(options) {
   const cloneDir = join3(temporaryRoot, "repository");
   console.log(`  \u{1F4E6} Cloning ${source.owner}/${source.repo}...`);
   try {
-    await cloneGitHubRepository(source, cloneDir);
-    return migrateRepository({
+    const cloneWarnings = [];
+    await cloneGitHubRepository(source, cloneDir, cloneWarnings);
+    const bundle = migrateRepository({
       repositoryDir: cloneDir,
       sourceUrl: options.sourceUrl,
       docsDir: options.docsDir ?? (source.docsDir || void 0),
       platform: options.platform
     });
+    return cloneWarnings.length > 0 ? { ...bundle, warnings: [...cloneWarnings, ...bundle.warnings] } : bundle;
   } finally {
     rmSync(temporaryRoot, { recursive: true, force: true });
   }
@@ -515,7 +558,8 @@ async function migrateDocs(options) {
       // Source provenance is not the destination repository. Migrated pages
       // live at new paths, so source URLs cannot power edit/issue actions.
       repoUrl: "",
-      doInstall: false
+      doInstall: false,
+      colors: bundle.site?.colors
     });
     resetFreshMigrationContent(projectDir);
   } else if (!existsSync3(projectDir)) {

package/dist/{chunk-6UCPRAXI.js → chunk-5TY2RFVK.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   readStarterReleaseManifest
-} from "./chunk-QUURQ4RM.js";
+} from "./chunk-GI5TSGSK.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-XJM3764C.js";
+} from "./chunk-EHH4OP7W.js";
 
 // src/download.ts
 import { Readable, Transform, pipeline } from "stream";

package/dist/{chunk-XJM3764C.js → chunk-EHH4OP7W.js}

@@ -3,19 +3,19 @@
 // src/stable-scaffold-release.json
 var stable_scaffold_release_default = {
   schemaVersion: 1,
-  id: "2026-09-23.a75486bf.3d39d80a",
+  id: "2026-09-23.03d99cfb.f870a2e2",
   source: {
     repository: "thallylabs/starter",
-    commitSha: "a75486bf74c818c914b412452550a9d137b8628c",
-    treeSha: "8e6c393aee612e5a0c6f17767b20c776a7822616",
-    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/a75486bf74c818c914b412452550a9d137b8628c",
+    commitSha: "03d99cfbcd7cf62b3a8381b29634c792f4c8fddd",
+    treeSha: "e62a4a2d15e47dadde92fed14ef06a26409b0299",
+    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/03d99cfbcd7cf62b3a8381b29634c792f4c8fddd",
     manifestPath: "starter-release.json",
-    manifestSha256: "cb52448056aceb6c6a120ffe7ead78d383768ff6f237fb13cfa6ad5dc6cefb59"
+    manifestSha256: "d81925ddd3a9887456f34b3c899060537e971abee21c9c9e7634300a402ea546"
   },
   runtime: {
     repository: "thallylabs/thally",
-    commitSha: "3d39d80a283c4c53ecdd7b568fd2c85d6e724f33",
-    treeSha: "ffd055816b6dd5cea0b8788fe88528395b3711e7",
+    commitSha: "f870a2e27da6d099f996faf2d55e819c737e34c6",
+    treeSha: "98e690c700a05bdc72d0ebdb5e0150fd46fd0ec3",
     contentSource: "assets",
     identityContractVersion: 1
   },
@@ -24,6 +24,26 @@ var stable_scaffold_release_default = {
 
 // src/previous-scaffold-releases.json
 var previous_scaffold_releases_default = [
+  {
+    schemaVersion: 1,
+    id: "2026-09-23.a75486bf.3d39d80a",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "a75486bf74c818c914b412452550a9d137b8628c",
+      treeSha: "8e6c393aee612e5a0c6f17767b20c776a7822616",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/a75486bf74c818c914b412452550a9d137b8628c",
+      manifestPath: "starter-release.json",
+      manifestSha256: "cb52448056aceb6c6a120ffe7ead78d383768ff6f237fb13cfa6ad5dc6cefb59"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "3d39d80a283c4c53ecdd7b568fd2c85d6e724f33",
+      treeSha: "ffd055816b6dd5cea0b8788fe88528395b3711e7",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 2
+  },
   {
     schemaVersion: 1,
     id: "2026-09-23.bb53c15c.08c76ddb",

package/dist/{chunk-QUURQ4RM.js → chunk-GI5TSGSK.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-XJM3764C.js";
+} from "./chunk-EHH4OP7W.js";
 
 // src/starter-sync.ts
 import { createHash } from "crypto";

package/dist/{chunk-ORUAMPNF.js → chunk-XYRM4GAT.js}

@@ -66,7 +66,39 @@ function replaceRequired(source, pattern, replacement, field) {
   }
   return source.replace(pattern, replacement);
 }
-function updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl) {
+var HEX_COLOR_PATTERN = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+function contrastForeground(hex) {
+  const digits = hex.slice(1);
+  const value = digits.length <= 4 ? digits.slice(0, 3).split("").map((c) => c + c).join("") : digits.slice(0, 6);
+  const channel = (index) => {
+    const c = Number.parseInt(value.slice(index, index + 2), 16) / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+  };
+  const luminance = 0.2126 * channel(0) + 0.7152 * channel(2) + 0.0722 * channel(4);
+  const contrastWithWhite = 1.05 / (luminance + 0.05);
+  const contrastWithBlack = (luminance + 0.05) / 0.05;
+  return contrastWithWhite >= contrastWithBlack ? "#ffffff" : "#000000";
+}
+function replaceHexKey(block, key, hex) {
+  const pattern = new RegExp(`(${key}:[ \\t]*)'#[0-9a-fA-F]{3,8}'`);
+  return pattern.test(block) ? block.replace(pattern, `$1'${hex}'`) : block;
+}
+function replacePresetAccent(source, preset, mode, hex) {
+  const presetPattern = new RegExp(`  ${preset}: \\{[\\s\\S]*?\\n  \\},`);
+  const presetBlock = source.match(presetPattern)?.[0];
+  if (!presetBlock) return source;
+  const modePattern = new RegExp(`    ${mode}: \\{[\\s\\S]*?\\n    \\},`);
+  const modeBlock = presetBlock.match(modePattern)?.[0];
+  if (!modeBlock) return source;
+  let updatedModeBlock = modeBlock;
+  updatedModeBlock = replaceHexKey(updatedModeBlock, "accent", hex);
+  updatedModeBlock = replaceHexKey(updatedModeBlock, "ring", hex);
+  updatedModeBlock = replaceHexKey(updatedModeBlock, "sidebarActiveText", hex);
+  updatedModeBlock = replaceHexKey(updatedModeBlock, "accentForeground", contrastForeground(hex));
+  if (updatedModeBlock === modeBlock) return source;
+  return source.replace(presetBlock, presetBlock.replace(modeBlock, updatedModeBlock));
+}
+function updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl, colors) {
   if (!projectName.trim() || /[\0\r\n]/.test(projectName)) {
     throw new Error("The documentation project name is invalid.");
   }
@@ -120,6 +152,14 @@ function updateSiteConfig(targetDir, projectName, description, brandPreset, repo
       ""
     );
   }
+  const lightAccent = colors?.dark ?? colors?.primary;
+  const darkAccent = colors?.light ?? colors?.primary;
+  if (lightAccent && HEX_COLOR_PATTERN.test(lightAccent)) {
+    source = replacePresetAccent(source, brandPreset, "light", lightAccent);
+  }
+  if (darkAccent && HEX_COLOR_PATTERN.test(darkAccent)) {
+    source = replacePresetAccent(source, brandPreset, "dark", darkAccent);
+  }
   writeFileSync(siteFile, source, "utf8");
 }
 function updatePackageIdentity(targetDir, packageName) {
@@ -171,7 +211,8 @@ function personalizeStarter(targetDir, options) {
     options.projectName,
     options.description,
     options.brandPreset,
-    options.repoUrl
+    options.repoUrl,
+    options.colors
   );
   updatePackageIdentity(targetDir, options.packageName);
   updateCloudflareRuntimeName(targetDir, options.packageName);

package/dist/{chunk-4JIBGZHO.js → chunk-YFOGBPFV.js}

@@ -2,10 +2,10 @@
 import {
   personalizeStarter,
   updateEnvExample
-} from "./chunk-ORUAMPNF.js";
+} from "./chunk-XYRM4GAT.js";
 import {
   downloadStarter
-} from "./chunk-6UCPRAXI.js";
+} from "./chunk-5TY2RFVK.js";
 
 // src/scaffold.ts
 import { existsSync, mkdirSync, readdirSync } from "fs";
@@ -114,7 +114,8 @@ async function scaffold(options) {
     doInstall,
     enableAiChat = true,
     i18nLocales,
-    trackRepos
+    trackRepos,
+    colors
   } = options;
   const targetDir = resolve(projectDir);
   if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
@@ -130,7 +131,8 @@ async function scaffold(options) {
     brandPreset,
     repoUrl,
     enableAiChat,
-    i18nLocales
+    i18nLocales,
+    colors
   });
   resetTrackingConfig(targetDir);
   if (trackRepos?.length) {

package/dist/customize.d.ts

@@ -17,6 +17,12 @@ interface StarterPersonalizationOptions {
     repoUrl: string;
     enableAiChat: boolean;
     i18nLocales?: Array<StarterLocale>;
+    /** Source theme accent color(s) to apply over the chosen brand preset. */
+    colors?: {
+        primary?: string;
+        light?: string;
+        dark?: string;
+    };
 }
 /**
  * Personalize only the owner-controlled settings in `docs.json`.
@@ -26,7 +32,11 @@ interface StarterPersonalizationOptions {
  */
 declare function updateStarterDocsConfig(targetDir: string, enableAiChat: boolean, repoUrl: string, i18nLocales?: Array<StarterLocale>): void;
 /** Personalize the documented identity and repository fields in `site.ts`. */
-declare function updateSiteConfig(targetDir: string, projectName: string, description: string, brandPreset: string, repoUrl: string): void;
+declare function updateSiteConfig(targetDir: string, projectName: string, description: string, brandPreset: string, repoUrl: string, colors?: {
+    primary?: string;
+    light?: string;
+    dark?: string;
+}): void;
 /** Rename only the root package identity; dependency pins belong to starter. */
 declare function updatePackageIdentity(targetDir: string, packageName: string): void;
 /** Update the provider-portable Worker name without recreating its config. */

package/dist/customize.js

@@ -6,7 +6,7 @@ import {
   updatePackageIdentity,
   updateSiteConfig,
   updateStarterDocsConfig
-} from "./chunk-ORUAMPNF.js";
+} from "./chunk-XYRM4GAT.js";
 export {
   personalizeStarter,
   updateCloudflareRuntimeName,

package/dist/index.js

@@ -3,17 +3,17 @@ import {
   migrateDocs,
   parseFrontmatter,
   runCheck
-} from "./chunk-WSP42NTD.js";
+} from "./chunk-5DNAAGM6.js";
 import {
   logo,
   scaffold,
   slugify,
   success
-} from "./chunk-4JIBGZHO.js";
-import "./chunk-ORUAMPNF.js";
-import "./chunk-6UCPRAXI.js";
-import "./chunk-QUURQ4RM.js";
-import "./chunk-XJM3764C.js";
+} from "./chunk-YFOGBPFV.js";
+import "./chunk-XYRM4GAT.js";
+import "./chunk-5TY2RFVK.js";
+import "./chunk-GI5TSGSK.js";
+import "./chunk-EHH4OP7W.js";
 
 // src/index.ts
 import { existsSync as existsSync2, readdirSync } from "fs";
@@ -28,17 +28,27 @@ import {
 } from "@thallylabs/migrate";
 function parseMigrationPlatform(value) {
   if (!value || value === "auto") return void 0;
-  if (value === "mintlify" || value === "docusaurus") return value;
-  throw new Error("--platform must be mintlify, docusaurus, or auto.");
+  if (value === "mintlify" || value === "docusaurus" || value === "fern") return value;
+  throw new Error("--platform must be mintlify, docusaurus, fern, or auto.");
+}
+function isInteractiveStdin() {
+  return Boolean(process.stdin.isTTY);
 }
 async function gatherMigrationPlatform(value, useDefaults) {
   const configured = parseMigrationPlatform(value);
   if (configured || value === "auto" || useDefaults) return configured;
+  if (!isInteractiveStdin()) {
+    console.warn(
+      "\n  \u26A0 No platform was specified and this shell is not interactive; auto-detecting the source platform instead. Pass --platform mintlify|docusaurus|fern (or -y) to skip detection and avoid this warning."
+    );
+    return void 0;
+  }
   return select({
     message: "  Which platform currently hosts these docs?",
     choices: [
       { name: "Mintlify", value: "mintlify" },
       { name: "Docusaurus", value: "docusaurus" },
+      { name: "Fern", value: "fern" },
       { name: "Other / detect automatically", value: void 0 }
     ],
     default: "mintlify"
@@ -498,7 +508,7 @@ Options:
   --branch <name>      Override the detected Git branch
   --docs-dir <path>    Override the detected documentation directory
   --max-pages <count>  Limit a public URL crawl to 1-1000 pages
-  --platform <name>    Use mintlify, docusaurus, or auto
+  --platform <name>    Use mintlify, docusaurus, fern, or auto
   --skip-validation   Import only; explicitly skip content and build verification
   --api-key <key>      Anthropic API key for non-Markdown conversion
   -y, --yes            Skip interactive prompts

package/dist/migrate/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-WSP42NTD.js";
-import "../chunk-4JIBGZHO.js";
-import "../chunk-ORUAMPNF.js";
-import "../chunk-6UCPRAXI.js";
-import "../chunk-QUURQ4RM.js";
-import "../chunk-XJM3764C.js";
+} from "../chunk-5DNAAGM6.js";
+import "../chunk-YFOGBPFV.js";
+import "../chunk-XYRM4GAT.js";
+import "../chunk-5TY2RFVK.js";
+import "../chunk-GI5TSGSK.js";
+import "../chunk-EHH4OP7W.js";
 export {
   migrateDocs
 };

package/dist/release.js

@@ -3,7 +3,7 @@ import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES,
   isStableScaffoldRelease
-} from "./chunk-XJM3764C.js";
+} from "./chunk-EHH4OP7W.js";
 export {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES,

package/dist/scaffold.d.ts

@@ -44,6 +44,12 @@ interface ScaffoldOptions {
         owner: string;
         repo: string;
     }>;
+    /** Source theme accent color(s) to apply over the chosen brand preset. */
+    colors?: {
+        primary?: string;
+        light?: string;
+        dark?: string;
+    };
 }
 interface ScaffoldResult {
     projectDir: string;

package/dist/scaffold.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-4JIBGZHO.js";
-import "./chunk-ORUAMPNF.js";
+} from "./chunk-YFOGBPFV.js";
+import "./chunk-XYRM4GAT.js";
 import {
   STARTER_ARCHIVE_ROOT,
   STARTER_COMMIT_SHA,
   STARTER_REPOSITORY,
   validateStarterArchiveEntry
-} from "./chunk-6UCPRAXI.js";
-import "./chunk-QUURQ4RM.js";
+} from "./chunk-5TY2RFVK.js";
+import "./chunk-GI5TSGSK.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-XJM3764C.js";
+} from "./chunk-EHH4OP7W.js";
 export {
   STABLE_SCAFFOLD_RELEASE,
   STARTER_ARCHIVE_ROOT,

package/dist/starter-sync.js

@@ -8,8 +8,8 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-QUURQ4RM.js";
-import "./chunk-XJM3764C.js";
+} from "./chunk-GI5TSGSK.js";
+import "./chunk-EHH4OP7W.js";
 export {
   applyStarterRuntimeSyncPlan,
   classifyStarterPath,

package/dist/starter-update.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   downloadStarter
-} from "./chunk-6UCPRAXI.js";
+} from "./chunk-5TY2RFVK.js";
 import {
   applyStarterRuntimeSyncPlan,
   mergeStarterOwnershipContracts,
@@ -9,11 +9,11 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-QUURQ4RM.js";
+} from "./chunk-GI5TSGSK.js";
 import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES
-} from "./chunk-XJM3764C.js";
+} from "./chunk-EHH4OP7W.js";
 
 // src/starter-update.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.51",
+  "version": "0.10.53",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -45,7 +45,7 @@
     "@anthropic-ai/sdk": "^0.36.0",
     "@inquirer/prompts": "^7.0.0",
     "@thallylabs/core": "0.2.8",
-    "@thallylabs/migrate": "0.2.6",
+    "@thallylabs/migrate": "0.2.7",
     "p-limit": "^6.1.0",
     "tar": "^7.5.22",
     "yaml": "^2.6.0"