create-thally-docs 0.10.79 → 0.10.81

package/dist/{chunk-BP2REWTO.js → chunk-46CFQVEL.js}

@@ -3,19 +3,19 @@
 // src/stable-scaffold-release.json
 var stable_scaffold_release_default = {
   schemaVersion: 1,
-  id: "2026-10-03.c42253fd.46afd8f2",
+  id: "2026-10-06.bc9ad197.e8e90bb6",
   source: {
     repository: "thallylabs/starter",
-    commitSha: "c42253fd7fa988e8031caa508a500f66113b6d45",
-    treeSha: "ae6491d255d3fc7e4fca83b383a9786d550d56b9",
-    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/c42253fd7fa988e8031caa508a500f66113b6d45",
+    commitSha: "bc9ad1979c58c4f4e75eb7a37d042ba4639a6025",
+    treeSha: "82f93eeb50bad3d14c2a31d658bf88b977cd41e8",
+    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/bc9ad1979c58c4f4e75eb7a37d042ba4639a6025",
     manifestPath: "starter-release.json",
-    manifestSha256: "4d84582a32cc6c58b48f3c29e4ecb1231347d7ee8599afe294d8880dc97c4f32"
+    manifestSha256: "b47a511f01e572e19c04353bb678de3fadaf69020224029156350967e07761b3"
   },
   runtime: {
     repository: "thallylabs/thally",
-    commitSha: "46afd8f23a2768b4cf745d58eb64079207bcd2a4",
-    treeSha: "4c3ccf148bff52cb523af663743ffaa98c634ab4",
+    commitSha: "e8e90bb6f50197bac47c061f553fa2365af7e1e9",
+    treeSha: "17ce7a8447626af290868fa9e2c644909493d98b",
     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-10-03.c42253fd.46afd8f2",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "c42253fd7fa988e8031caa508a500f66113b6d45",
+      treeSha: "ae6491d255d3fc7e4fca83b383a9786d550d56b9",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/c42253fd7fa988e8031caa508a500f66113b6d45",
+      manifestPath: "starter-release.json",
+      manifestSha256: "4d84582a32cc6c58b48f3c29e4ecb1231347d7ee8599afe294d8880dc97c4f32"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "46afd8f23a2768b4cf745d58eb64079207bcd2a4",
+      treeSha: "4c3ccf148bff52cb523af663743ffaa98c634ab4",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 2
+  },
   {
     schemaVersion: 1,
     id: "2026-10-02.644cbada.498675f5",

package/dist/{chunk-WWIATVAD.js → chunk-MXM4SK6B.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   readStarterReleaseManifest
-} from "./chunk-RI56XMBI.js";
+} from "./chunk-Z4NA6RK6.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-BP2REWTO.js";
+} from "./chunk-46CFQVEL.js";
 import {
   terminal
 } from "./chunk-L2YCVQBR.js";

package/dist/{chunk-IZQHRVPV.js → chunk-UNWYNBIO.js}

@@ -8,7 +8,7 @@ import {
   installDeps,
   runProjectCommand,
   scaffold
-} from "./chunk-KGKSB3PU.js";
+} from "./chunk-UUBN6SCK.js";
 import {
   pruneMissingSiteLinks
 } from "./chunk-4VKRBJV2.js";
@@ -23,9 +23,11 @@ import { setImmediate } from "timers/promises";
 import { basename, dirname, isAbsolute, join as join2, relative, resolve, sep } from "path";
 import {
   cloneGitHubRepository,
+  importSourceRef,
   hydrateRemoteApiSpecs,
   migrateUrl,
-  parseGitHubRepositoryUrl
+  parseGitHubRepositoryUrl,
+  sourceRefOversizeReason
 } from "@thallylabs/migrate";
 
 // src/migration-work.ts
@@ -163,9 +165,29 @@ function resetFreshMigrationContent(projectDir) {
     rmSync(projectPath(projectDir, sampleSpec), { force: true });
   }
 }
+async function fetchSourceRefs(mappings, warnings) {
+  const imports = [];
+  for (const mapping of mappings) {
+    const root = mkdtempSync(join2(tmpdir(), "thally-source-ref-"));
+    try {
+      const source = parseGitHubRepositoryUrl(`https://github.com/${mapping.repo}`);
+      const tooLarge = await sourceRefOversizeReason(mapping.repo);
+      if (tooLarge) throw new Error(tooLarge);
+      const cloneDir = join2(root, "repository");
+      await cloneGitHubRepository(source, cloneDir, warnings, { skipSubmodules: true });
+      imports.push(importSourceRef(mapping, cloneDir));
+    } catch (error) {
+      warnings.push({ code: "fetch-failed", message: `sourceRef ${mapping.repo} was not imported: ${error instanceof Error ? error.message : String(error)}` });
+    } finally {
+      rmSync(root, { recursive: true, force: true });
+    }
+  }
+  return imports;
+}
 async function discoverMigration(options) {
   const url = new URL(options.sourceUrl);
   if (url.hostname.toLowerCase() !== "github.com") {
+    if (options.sourceRefs?.length) terminal.warn("--source-ref applies only to GitHub repository sources and was ignored.");
     return terminal.step("Discovering public documentation", () => {
       const discovery = {
         sourceUrl: options.sourceUrl,
@@ -182,7 +204,9 @@ async function discoverMigration(options) {
   try {
     const cloneWarnings = [];
     await terminal.step(`Cloning ${source.owner}/${source.repo}`, () => cloneGitHubRepository(source, cloneDir, cloneWarnings), "Source repository cloned");
+    const sourceRefs = options.sourceRefs?.length ? await terminal.step("Importing sourceRef repositories", () => fetchSourceRefs(options.sourceRefs ?? [], cloneWarnings), "sourceRef repositories imported") : [];
     const bundle = await terminal.step("Converting repository documentation", () => convertRepository({
+      sourceRefs,
       repositoryDir: cloneDir,
       sourceUrl: options.sourceUrl,
       docsDir: options.docsDir ?? (source.docsDir || void 0),
@@ -293,6 +317,7 @@ async function migrateDocs(options) {
     pages: bundle.pages.length,
     assets: bundle.assets.length,
     components: bundle.componentFiles?.length ?? 0,
+    sourceRefs: bundle.sourceRefs ?? [],
     quarantined: quarantinedPages,
     quarantinedAssets: (bundle.quarantinedFiles?.length ?? 0) - quarantinedPages,
     droppedGatedPages: bundle.droppedGatedPages ?? 0,

package/dist/{chunk-KGKSB3PU.js → chunk-UUBN6SCK.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-J7255UQA.js";
 import {
   downloadStarter
-} from "./chunk-WWIATVAD.js";
+} from "./chunk-MXM4SK6B.js";
 import {
   terminal
 } from "./chunk-L2YCVQBR.js";

package/dist/{chunk-RI56XMBI.js → chunk-Z4NA6RK6.js}

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

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "./chunk-IZQHRVPV.js";
+} from "./chunk-UNWYNBIO.js";
 import {
   parseFrontmatter,
   runCheck
@@ -13,12 +13,12 @@ import {
   scaffold,
   slugify,
   success
-} from "./chunk-KGKSB3PU.js";
+} from "./chunk-UUBN6SCK.js";
 import "./chunk-4VKRBJV2.js";
 import "./chunk-J7255UQA.js";
-import "./chunk-WWIATVAD.js";
-import "./chunk-RI56XMBI.js";
-import "./chunk-BP2REWTO.js";
+import "./chunk-MXM4SK6B.js";
+import "./chunk-Z4NA6RK6.js";
+import "./chunk-46CFQVEL.js";
 import {
   acquireTerminalAccent,
   formatHelp,
@@ -268,7 +268,7 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
 }
 
 // src/index.ts
-import { parseGitHubRepositoryUrl as parseGitHubRepositoryUrl2 } from "@thallylabs/migrate";
+import { parseGitHubRepositoryUrl as parseGitHubRepositoryUrl2, parseSourceRefFlags } from "@thallylabs/migrate";
 
 // src/translate.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
@@ -690,7 +690,8 @@ var valueFlags = /* @__PURE__ */ new Set([
   "--max-pages",
   "--model",
   "--pages",
-  "--platform"
+  "--platform",
+  "--source-ref"
 ]);
 var commandFlags = {
   scaffold: /* @__PURE__ */ new Set(["--help", "-h", "--yes", "-y", "--install", "--no-install", "--verbose"]),
@@ -704,6 +705,7 @@ var commandFlags = {
     "--max-pages",
     "--platform",
     "--skip-validation",
+    "--source-ref",
     "--verbose",
     "--yes",
     "-y"
@@ -752,6 +754,8 @@ Options:
   --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, fern, or auto
+  --source-ref <owner/repo>=<path>
+                       Import a Mintlify sourceRef repository under <path> (repeatable)
   --skip-validation   Import only; explicitly skip content and build verification
   --verbose           Show detailed installation, build, and Git output
   --api-key <key>      Anthropic API key for non-Markdown conversion
@@ -867,6 +871,20 @@ async function runMigrateCommand() {
   if (branch) terminal.detail("Branch", branch);
   if (docsDir) terminal.detail("Docs dir", docsDir);
   terminal.detail("Platform", platform ?? "auto-detect");
+  let sourceRefs;
+  try {
+    const sourceRefValues = args.flatMap((arg, index) => {
+      if (arg !== "--source-ref") return [];
+      const value = args[index + 1];
+      if (value === void 0 || value.startsWith("-")) throw new Error("--source-ref needs a value such as owner/repo=client-sdks/typescript.");
+      return [value];
+    });
+    sourceRefs = parseSourceRefFlags(sourceRefValues);
+  } catch (err) {
+    console.error(`
+  \u274C ${err instanceof Error ? err.message : err}`);
+    process.exit(1);
+  }
   const result = await migrateDocs({
     sourceUrl,
     projectDir,
@@ -877,7 +895,8 @@ async function runMigrateCommand() {
     maxPages,
     platform,
     yes,
-    skipValidation: flags.includes("--skip-validation")
+    skipValidation: flags.includes("--skip-validation"),
+    sourceRefs
   });
   terminal.section("Migration summary", [
     `${result.pagesWritten} pages \xB7 ${result.assetsWritten} assets \xB7 ${result.platform}`,

package/dist/migrate/index.d.ts

@@ -1,4 +1,4 @@
-import { MigrationPlatform, MigrationFetcher, MigrationBundle, MigrationWarning } from '@thallylabs/migrate';
+import { MigrationPlatform, MigrationFetcher, SourceRefMapping, MigrationBundle, MigrationWarning } from '@thallylabs/migrate';
 
 /**
  * Validate authored navigation and links against the routes the runtime can
@@ -42,6 +42,8 @@ interface MigrateOptions {
     fetcher?: MigrationFetcher;
     /** Explicitly opt out of content/build gates; the report remains unverified. */
     skipValidation?: boolean;
+    /** Mintlify `sourceRef` repositories to import, from `--source-ref owner/repo=<path>`. */
+    sourceRefs?: Array<SourceRefMapping>;
 }
 interface MigrateResult {
     pagesWritten: number;

package/dist/migrate/index.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-IZQHRVPV.js";
+} from "../chunk-UNWYNBIO.js";
 import "../chunk-KDLP27DS.js";
-import "../chunk-KGKSB3PU.js";
+import "../chunk-UUBN6SCK.js";
 import "../chunk-4VKRBJV2.js";
 import "../chunk-J7255UQA.js";
-import "../chunk-WWIATVAD.js";
-import "../chunk-RI56XMBI.js";
-import "../chunk-BP2REWTO.js";
+import "../chunk-MXM4SK6B.js";
+import "../chunk-Z4NA6RK6.js";
+import "../chunk-46CFQVEL.js";
 import "../chunk-L2YCVQBR.js";
 export {
   migrateDocs

package/dist/release.js

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

package/dist/scaffold.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-KGKSB3PU.js";
+} from "./chunk-UUBN6SCK.js";
 import "./chunk-4VKRBJV2.js";
 import "./chunk-J7255UQA.js";
 import {
@@ -9,11 +9,11 @@ import {
   STARTER_COMMIT_SHA,
   STARTER_REPOSITORY,
   validateStarterArchiveEntry
-} from "./chunk-WWIATVAD.js";
-import "./chunk-RI56XMBI.js";
+} from "./chunk-MXM4SK6B.js";
+import "./chunk-Z4NA6RK6.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-BP2REWTO.js";
+} from "./chunk-46CFQVEL.js";
 import "./chunk-L2YCVQBR.js";
 export {
   STABLE_SCAFFOLD_RELEASE,

package/dist/starter-sync.js

@@ -8,8 +8,8 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-RI56XMBI.js";
-import "./chunk-BP2REWTO.js";
+} from "./chunk-Z4NA6RK6.js";
+import "./chunk-46CFQVEL.js";
 export {
   applyStarterRuntimeSyncPlan,
   classifyStarterPath,

package/dist/starter-update.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   downloadStarter
-} from "./chunk-WWIATVAD.js";
+} from "./chunk-MXM4SK6B.js";
 import {
   applyStarterRuntimeSyncPlan,
   mergeStarterOwnershipContracts,
@@ -9,11 +9,11 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-RI56XMBI.js";
+} from "./chunk-Z4NA6RK6.js";
 import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES
-} from "./chunk-BP2REWTO.js";
+} from "./chunk-46CFQVEL.js";
 import "./chunk-L2YCVQBR.js";
 
 // src/starter-update.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.79",
+  "version": "0.10.81",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -50,7 +50,7 @@
     "@clack/prompts": "^0.11.0",
     "@inquirer/prompts": "^7.0.0",
     "@thallylabs/core": "0.2.11",
-    "@thallylabs/migrate": "0.2.24",
+    "@thallylabs/migrate": "0.2.25",
     "p-limit": "^6.1.0",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",