create-thally-docs 0.10.118 → 0.10.120

package/dist/{chunk-FMVUFWZP.js → chunk-TBDAJL37.js}

@@ -3,27 +3,47 @@
 // src/stable-scaffold-release.json
 var stable_scaffold_release_default = {
   schemaVersion: 1,
-  id: "2026-10-19.3eb7a615.8f80ea57",
+  id: "2026-10-21.ea814b66.41b32272",
   source: {
     repository: "thallylabs/starter",
-    commitSha: "3eb7a615dbd2025d59fa71ebd02d88c6a55ede1b",
-    treeSha: "3acac4a0666cba2ac95aadccdf6aaf3bf701ed76",
-    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/3eb7a615dbd2025d59fa71ebd02d88c6a55ede1b",
+    commitSha: "ea814b668a68a6b2306c65a0be6910c41a492de4",
+    treeSha: "6af04e01e197fecb72f14165ae8bcce11d350e64",
+    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/ea814b668a68a6b2306c65a0be6910c41a492de4",
     manifestPath: "starter-release.json",
-    manifestSha256: "ffe5a8562cda5bbe2a1a73f92b5c4db57e6dd1ec6cd66686db867ea06a87a19c"
+    manifestSha256: "9f275cdc7989cc3f7b3344bf3e3456b882acac8798734ab0edac98258dd09fe8"
   },
   runtime: {
     repository: "thallylabs/thally",
-    commitSha: "8f80ea5712a97574ad3f86975301754c3a223912",
-    treeSha: "e52a9c74d8a362e345c96e4097ce0631ede24157",
+    commitSha: "41b322722411cd11edb26a08a57063a1920a03f6",
+    treeSha: "17742f8dbebdebea844d64deb1de5e5a63d1eda4",
     contentSource: "assets",
     identityContractVersion: 1
   },
-  starterVersion: 2
+  starterVersion: 3
 };
 
 // src/previous-scaffold-releases.json
 var previous_scaffold_releases_default = [
+  {
+    schemaVersion: 1,
+    id: "2026-10-19.3eb7a615.8f80ea57",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "3eb7a615dbd2025d59fa71ebd02d88c6a55ede1b",
+      treeSha: "3acac4a0666cba2ac95aadccdf6aaf3bf701ed76",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/3eb7a615dbd2025d59fa71ebd02d88c6a55ede1b",
+      manifestPath: "starter-release.json",
+      manifestSha256: "ffe5a8562cda5bbe2a1a73f92b5c4db57e6dd1ec6cd66686db867ea06a87a19c"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "8f80ea5712a97574ad3f86975301754c3a223912",
+      treeSha: "e52a9c74d8a362e345c96e4097ce0631ede24157",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 2
+  },
   {
     schemaVersion: 1,
     id: "2026-10-19.08f775a3.6184037a",

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "./chunk-XDSBT5EE.js";
+} from "./chunk-SJXNTYCO.js";
 import {
   parseFrontmatter,
   runCheck
@@ -13,22 +13,23 @@ import {
   scaffold,
   slugify,
   success
-} from "./chunk-SVB25WSN.js";
+} from "./chunk-4KM7FPVG.js";
 import "./chunk-UG3OXVLE.js";
 import "./chunk-J7255UQA.js";
-import "./chunk-JKC4FXSW.js";
+import "./chunk-5GOGY7E3.js";
+import "./chunk-IRNJBXNU.js";
 import {
   acquireTerminalAccent,
   formatHelp,
   terminal
 } from "./chunk-L2YCVQBR.js";
-import "./chunk-QPHUUFSH.js";
-import "./chunk-FMVUFWZP.js";
+import "./chunk-JG4B5PJN.js";
+import "./chunk-TBDAJL37.js";
 
 // src/index.ts
 import { existsSync as existsSync2, readdirSync } from "fs";
 import { createRequire } from "module";
-import { resolve as resolve2 } from "path";
+import { basename as basename2, resolve as resolve2 } from "path";
 
 // src/interactive-prompts.ts
 import * as clack from "@clack/prompts";
@@ -676,13 +677,15 @@ var valueFlags = /* @__PURE__ */ new Set([
   "--into",
   "--locale",
   "--max-pages",
+  "--openapi",
   "--model",
   "--pages",
+  "--package-manager",
   "--platform",
   "--source-ref"
 ]);
 var commandFlags = {
-  scaffold: /* @__PURE__ */ new Set(["--help", "-h", "--yes", "-y", "--install", "--no-install", "--verbose"]),
+  scaffold: /* @__PURE__ */ new Set(["--package-manager", "--help", "-h", "--yes", "-y", "--install", "--no-install", "--verbose"]),
   migrate: /* @__PURE__ */ new Set([
     "--help",
     "-h",
@@ -691,6 +694,7 @@ var commandFlags = {
     "--docs-dir",
     "--into",
     "--max-pages",
+    "--openapi",
     "--platform",
     "--skip-validation",
     "--source-ref",
@@ -725,6 +729,7 @@ Scaffold options:
   -y, --yes       Accept defaults and skip interactive prompts
   --install       Install project dependencies (the default)
   --no-install    Skip dependency installation
+  --package-manager <npm|pnpm|yarn>  Select the dependency installer
   --verbose       Show detailed installation and Git output
   -h, --help      Show this help
   -v, -V, --version  Show the installed version
@@ -734,12 +739,13 @@ Run create-thally-docs <command> --help for command-specific options.
 var commandHelp = {
   migrate: `
 Usage:
-  create-thally-docs migrate <github-or-docs-url> [output-dir] [options]
+  create-thally-docs migrate <github-or-docs-url-or-directory> [output-dir] [options]
 
 Options:
   --into <dir>         Migrate into an existing Thally project
   --branch <name>      Override the detected Git branch
   --docs-dir <path>    Override the detected documentation directory
+  --openapi <https-url>  Import an explicit OpenAPI spec for a docs website
   --max-pages <count>  Limit a public URL crawl to 1-10000 pages (default: 1000)
   --platform <name>    Use mintlify, docusaurus, fern, or auto
   --source-ref <owner/repo>=<path>
@@ -810,16 +816,21 @@ function validateFlags(command) {
 async function runMigrateCommand() {
   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]");
+    console.error("\n  \u274C A source URL or local directory is required.");
+    console.error("     Usage: create-thally-docs migrate <github-or-docs-url-or-directory> [output-dir] [options]");
     console.error("     Example: create-thally-docs migrate https://docs.example.com my-docs");
     process.exit(1);
   }
   let source;
+  const sourceDirectory = !/^[a-z][a-z0-9+.-]*:/i.test(sourceUrl) || /^[a-z]:[\\/]/i.test(sourceUrl) ? resolve2(sourceUrl) : void 0;
   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") parseGitHubRepositoryUrl2(sourceUrl);
+    if (sourceDirectory) {
+      if (!existsSync2(sourceDirectory)) throw new Error(`Local source directory does not exist: ${sourceDirectory}`);
+    } else {
+      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") parseGitHubRepositoryUrl2(sourceUrl);
+    }
   } catch (err) {
     console.error(`
   \u274C ${err instanceof Error ? err.message : err}`);
@@ -831,7 +842,7 @@ async function runMigrateCommand() {
   terminal.intro("migrate", packageMetadata.version, "Bring your docs to Thally. Built for people and AI tools.");
   const platformFlag = getFlagValue("--platform");
   const platform = await gatherMigrationPlatform(platformFlag, yes);
-  if (platform === void 0) {
+  if (platform === void 0 && !sourceDirectory) {
     const shouldPromptForSource = platformFlag === void 0 && !yes && Boolean(process.stdin.isTTY);
     sourceUrl = await resolveAutoDetectedMigrationSource(sourceUrl, shouldPromptForSource);
     source = new URL(sourceUrl);
@@ -845,7 +856,7 @@ async function runMigrateCommand() {
   } else if (positional[2]) {
     projectDir = resolve2(positional[2]);
   } else {
-    const sourceName = source.hostname.toLowerCase() === "github.com" ? parseGitHubRepositoryUrl2(sourceUrl).repo : source.pathname.split("/").filter(Boolean).at(-1) ?? source.hostname.split(".")[0];
+    const sourceName = sourceDirectory ? basename2(sourceDirectory) : 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 maxPagesValue = getFlagValue("--max-pages");
@@ -854,7 +865,7 @@ async function runMigrateCommand() {
     console.error("\n  \u274C --max-pages must be an integer between 1 and 10000.");
     process.exit(1);
   }
-  terminal.detail("Source", `${source.origin}${source.pathname}`);
+  terminal.detail("Source", sourceDirectory ?? `${source.origin}${source.pathname}`);
   terminal.detail("Output", projectDir);
   if (branch) terminal.detail("Branch", branch);
   if (docsDir) terminal.detail("Docs dir", docsDir);
@@ -875,12 +886,14 @@ async function runMigrateCommand() {
   }
   const result = await migrateDocs({
     sourceUrl,
+    sourceDirectory,
     projectDir,
     into: isInto,
     apiKey,
     branch,
     docsDir,
     maxPages,
+    openapiUrl: getFlagValue("--openapi"),
     platform,
     yes,
     skipValidation: flags.includes("--skip-validation"),
@@ -901,6 +914,8 @@ async function runMigrateCommand() {
 async function runScaffoldCommand() {
   const useDefaults = flags.includes("--yes") || flags.includes("-y") || !process.stdin.isTTY;
   const installPreference = flags.includes("--install") ? true : flags.includes("--no-install") ? false : void 0;
+  const packageManager = getFlagValue("--package-manager");
+  if (packageManager !== void 0 && !["npm", "pnpm", "yarn"].includes(packageManager)) throw new Error("--package-manager must be npm, pnpm, or yarn.");
   const dirArg = positional[0];
   if (dirArg) {
     const resolved = resolve2(dirArg);
@@ -918,11 +933,12 @@ async function runScaffoldCommand() {
     brandPreset: answers.brandPreset,
     repoUrl: answers.repoUrl,
     doInstall: answers.doInstall,
+    packageManager,
     continueOnInstallFailure: true,
     i18nLocales: answers.i18nLocales,
     trackRepos: answers.trackRepos
   });
-  success(result.projectDir, answers.projectName, result.dependenciesInstalled);
+  success(result.projectDir, answers.projectName, result.dependenciesInstalled, packageManager);
   if (answers.doInstall && !result.dependenciesInstalled) process.exitCode = 1;
 }
 async function runCheckCommand() {

package/dist/migrate/index.d.ts

@@ -28,6 +28,8 @@ interface MigrationValidation {
 
 interface MigrateOptions {
     sourceUrl: string;
+    /** Explicit trusted local CLI capability; never inferred by remote adapters. */
+    sourceDirectory?: string;
     projectDir: string;
     into: boolean;
     /** Retained for CLI compatibility; Markdown/MDX imports do not require a key. */
@@ -37,6 +39,8 @@ interface MigrateOptions {
     projectName?: string;
     yes: boolean;
     maxPages?: number;
+    /** Explicit HTTPS specification for a URL-only documentation source. */
+    openapiUrl?: string;
     /** Explicit source platform selected by an interactive or automated caller. */
     platform?: MigrationPlatform;
     /** Optional host fetch boundary; used by Thally Cloud adapters and tests. */
@@ -57,7 +61,7 @@ interface MigrateResult {
     validation: MigrationValidation;
     reportPath: string;
 }
-/** Import a GitHub docs repository or public docs URL into a Thally project. */
+/** Import a repository, public docs URL, or explicitly trusted local checkout. */
 declare function migrateDocs(options: MigrateOptions): Promise<MigrateResult>;
 
 export { type MigrateOptions, type MigrateResult, migrateDocs };

package/dist/migrate/index.js

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-XDSBT5EE.js";
+} from "../chunk-SJXNTYCO.js";
 import "../chunk-KDLP27DS.js";
-import "../chunk-SVB25WSN.js";
+import "../chunk-4KM7FPVG.js";
 import "../chunk-UG3OXVLE.js";
 import "../chunk-J7255UQA.js";
-import "../chunk-JKC4FXSW.js";
+import "../chunk-5GOGY7E3.js";
+import "../chunk-IRNJBXNU.js";
 import "../chunk-L2YCVQBR.js";
-import "../chunk-QPHUUFSH.js";
-import "../chunk-FMVUFWZP.js";
+import "../chunk-JG4B5PJN.js";
+import "../chunk-TBDAJL37.js";
 export {
   migrateDocs
 };

package/dist/release.js

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

package/dist/scaffold.d.ts

@@ -1,5 +1,7 @@
 export { STABLE_SCAFFOLD_RELEASE } from './release.js';
 
+type PackageManager = 'npm' | 'pnpm' | 'yarn';
+
 /**
  * Immutable starter archive download and extraction.
  *
@@ -39,6 +41,8 @@ interface ScaffoldOptions {
     brandPreset: string;
     repoUrl: string;
     doInstall: boolean;
+    /** Explicitly select npm, pnpm, or Yarn; otherwise infer the invoking manager. */
+    packageManager?: PackageManager;
     /**
      * Report a failed install and still finish the project (Git setup included)
      * instead of throwing. Interactive creation opts in; library callers keep

package/dist/scaffold.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-SVB25WSN.js";
+} from "./chunk-4KM7FPVG.js";
 import "./chunk-UG3OXVLE.js";
 import "./chunk-J7255UQA.js";
 import {
@@ -9,12 +9,12 @@ import {
   STARTER_COMMIT_SHA,
   STARTER_REPOSITORY,
   validateStarterArchiveEntry
-} from "./chunk-JKC4FXSW.js";
+} from "./chunk-IRNJBXNU.js";
 import "./chunk-L2YCVQBR.js";
-import "./chunk-QPHUUFSH.js";
+import "./chunk-JG4B5PJN.js";
 import {
   STABLE_SCAFFOLD_RELEASE
-} from "./chunk-FMVUFWZP.js";
+} from "./chunk-TBDAJL37.js";
 export {
   STABLE_SCAFFOLD_RELEASE,
   STARTER_ARCHIVE_ROOT,

package/dist/starter-sync.js

@@ -9,8 +9,8 @@ import {
   planStarterRuntimeSync,
   readStarterReleaseManifest,
   starterManifestSha256
-} from "./chunk-QPHUUFSH.js";
-import "./chunk-FMVUFWZP.js";
+} from "./chunk-JG4B5PJN.js";
+import "./chunk-TBDAJL37.js";
 export {
   applyStarterRuntimeSyncPlan,
   captureTargetPrecondition,

package/dist/starter-update.js

@@ -6,11 +6,11 @@ import {
   resolveStarterUpdateBase,
   starterReleaseProviderError,
   updateStarterProject
-} from "./chunk-7UPLZRN4.js";
-import "./chunk-JKC4FXSW.js";
+} from "./chunk-5GOGY7E3.js";
+import "./chunk-IRNJBXNU.js";
 import "./chunk-L2YCVQBR.js";
-import "./chunk-QPHUUFSH.js";
-import "./chunk-FMVUFWZP.js";
+import "./chunk-JG4B5PJN.js";
+import "./chunk-TBDAJL37.js";
 export {
   fetchStarterReleaseHint,
   resolveManualReviewMutations,

package/dist/starter-upgrade-canary.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   updateStarterProject
-} from "./chunk-7UPLZRN4.js";
+} from "./chunk-5GOGY7E3.js";
 import {
   downloadStarter
-} from "./chunk-JKC4FXSW.js";
+} from "./chunk-IRNJBXNU.js";
 import "./chunk-L2YCVQBR.js";
 import {
   classifyStarterPath,
   mergeStarterOwnershipContracts,
   readStarterReleaseManifest
-} from "./chunk-QPHUUFSH.js";
+} from "./chunk-JG4B5PJN.js";
 import {
   STABLE_SCAFFOLD_RELEASE,
   SUPPORTED_SCAFFOLD_RELEASES
-} from "./chunk-FMVUFWZP.js";
+} from "./chunk-TBDAJL37.js";
 
 // src/starter-upgrade-canary.ts
 import { createHash } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-thally-docs",
-  "version": "0.10.118",
+  "version": "0.10.120",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -54,18 +54,20 @@
     "@clack/prompts": "^0.11.0",
     "@inquirer/prompts": "^7.0.0",
     "@thallylabs/core": "0.2.17",
-    "@thallylabs/migrate": "0.2.42",
+    "@thallylabs/migrate": "0.2.43",
     "p-limit": "^6.1.0",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",
     "tar": "^7.5.22",
     "unified": "^11.0.5",
-    "yaml": "^2.6.0"
+    "yaml": "^2.6.0",
+    "semver": "^7.8.5"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "@types/semver": "^7.8.0"
   },
   "license": "MIT",
   "keywords": [