create-thally-docs 0.10.80 → 0.10.82

package/README.md

@@ -10,10 +10,14 @@ agent discovery files.
 ```bash
 npx create-thally-docs my-docs
 cd my-docs
-npm install
 npm run dev
 ```
 
+Sites created from a starter that includes the `thally` CLI
+(`@thallylabs/cli`) as a dev dependency can run `npx thally dev` instead, which
+also prints the local `llms.txt` and MCP endpoints once the server is ready.
+The completion message prints the right command for the project you created.
+
 The dev server starts at [http://localhost:3040](http://localhost:3040) and
 automatically uses the next available port when needed. A freshly scaffolded
 site is agent-ready out of the box and scores 100/A on the built-in
@@ -25,9 +29,14 @@ Run non-interactively with smart defaults:
 npx create-thally-docs my-docs --yes
 ```
 
-Dependency installation is deliberately opt-in so the scaffold finishes in
-seconds. Pass `--install` to run it immediately, or `--no-install` to skip the
-interactive question explicitly.
+Dependencies are installed by default, so the preview command works right
+away. Pass `--no-install` to skip installation (for example in CI or when you
+use another package manager). The interactive setup asks only for the project
+directory, name, an optional GitHub repository, Thally Track, installation,
+and extra languages; the description and brand palette are one-line edits in
+`src/data/site.ts`. The generated `.env.local` never pins a `localhost` site
+URL, so a build from this checkout cannot bake local links into `llms.txt` or
+the sitemap.
 
 ## Terminal output
 
@@ -43,7 +52,7 @@ Scaffolding and migration keep subprocess logs quiet in interactive terminals.
 Add `--verbose` to see installation and build logs as they happen:
 
 ```bash
-npx create-thally-docs my-docs --yes --install --verbose
+npx create-thally-docs my-docs --yes --verbose
 npx create-thally-docs migrate https://github.com/your-org/your-docs --platform auto --verbose
 ```
 
@@ -57,7 +66,7 @@ runs retain subprocess output for scripts and CI. These options also work with
 
 - **MDX content** in `src/content/`, navigation in `docs.json`
 - **Agent endpoints** — `/llms.txt`, `/ai.txt`, `/api/docs-index`, `/api/agent-readiness`
-- **Hybrid search**, **retrieval-grounded AI chat**, and an **admin analytics** dashboard
+- **Hybrid search**, an **admin analytics** dashboard, and **retrieval-grounded AI chat** when the site is linked to Thally Cloud
 - **Starter content** with keywords and structured pages, ready to edit
 
 ## Other commands
@@ -66,15 +75,16 @@ runs retain subprocess output for scripts and CI. These options also work with
 | --- | --- |
 | `create-thally-docs <dir>` | Scaffold a new project |
 | `create-thally-docs migrate <github-or-docs-url> [dir]` | Import a docs repository or public docs site through the shared migration engine |
-| `create-thally-docs check [dir] [--fix]` | Lint content for orphan pages and missing frontmatter |
+| `create-thally-docs check [dir] [--fix] [--ci] [--drift] [--external]` | Lint content for broken links, orphan pages, and missing frontmatter; `--external` also checks links to public hosts (bounded, warnings only) |
 | `create-thally-docs translate --locale <code>` | Translate content into another locale |
 
-Interactive migrations ask whether the source is Mintlify, Docusaurus, or
+Interactive migrations ask whether the source is Mintlify, Docusaurus, Fern, or
 another auto-detected platform. When automatic detection receives a live
 website URL, the CLI recommends its source GitHub repository and requires
 confirmation before continuing with the less precise website crawl. For
 scripts and CI, pass
-`--platform mintlify`, `--platform docusaurus`, or `--platform auto`; `--yes`
+`--platform mintlify`, `--platform docusaurus`, `--platform fern`, 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. Running `migrate` without

package/dist/{chunk-DIX4EUI4.js → chunk-2UHO52SA.js}

@@ -245,6 +245,131 @@ function manualApiProblems(file, data, hasOpenApiReference, mdx, docsApi) {
 import { projectNavigationContract } from "@thallylabs/core/navigation";
 import { slugify } from "@thallylabs/core/slugify";
 import { validateIntegrations } from "@thallylabs/migrate";
+
+// src/external-links.ts
+import { lookup } from "dns/promises";
+import { request as httpRequest } from "http";
+import { request as httpsRequest } from "https";
+import { isIP } from "net";
+import pLimit from "p-limit";
+var DEFAULT_CONCURRENCY = 8;
+var DEFAULT_TIMEOUT_MS = 8e3;
+var DEFAULT_MAX_URLS = 300;
+var USER_AGENT = "Thally-Check/1.0 (+https://thally.io)";
+function isPublicAddress(address, family) {
+  if (family === 4) {
+    const parts = address.split(".").map(Number);
+    if (parts.length !== 4 || parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)) return false;
+    const [a, b] = parts;
+    return !(a === 0 || a === 10 || a === 127 || a >= 224 || a === 100 && b >= 64 && b <= 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && (b === 0 || b === 168) || a === 198 && (b === 18 || b === 19) || a === 203 && b === 0 || a === 198 && b === 51);
+  }
+  return family === 6 && /^[23][0-9a-f]{0,3}:/i.test(address) && !/^2001:db8:/i.test(address);
+}
+function isLocalHostname(hostname) {
+  const host = hostname.toLowerCase().replace(/\.$/, "");
+  return !host.includes(".") || host === "localhost" || /\.(?:localhost|local|internal|lan|home|corp|intranet|test|invalid|example)$/.test(host);
+}
+function checkableUrl(value) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    return null;
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") return null;
+  if (url.username || url.password) return null;
+  const hostname = url.hostname.replace(/^\[|\]$/g, "");
+  if (isIP(hostname) || isLocalHostname(hostname)) return null;
+  url.hash = "";
+  return url;
+}
+async function defaultResolve(hostname) {
+  return lookup(hostname, { all: true, verbatim: true });
+}
+var defaultRequest = (url, method, pinned, timeoutMs) => new Promise((resolve, reject) => {
+  const send = url.protocol === "https:" ? httpsRequest : httpRequest;
+  const req = send(url, {
+    method,
+    headers: { "User-Agent": USER_AGENT, Accept: "*/*" },
+    signal: AbortSignal.timeout(timeoutMs),
+    // Node's dual-stack connector asks lookup for `all: true`; answer with
+    // the validated address only so the connection cannot be redirected.
+    lookup: (_hostname, options, callback) => {
+      if (typeof options === "object" && options.all) callback(null, [pinned]);
+      else callback(null, pinned.address, pinned.family);
+    }
+  }, (response) => {
+    response.destroy();
+    resolve(response.statusCode ?? 0);
+  });
+  req.on("error", reject);
+  req.end();
+});
+async function checkOne(url, resolveHost, send, timeoutMs) {
+  let addresses;
+  try {
+    addresses = await resolveHost(url.hostname);
+  } catch {
+    return { kind: "broken", message: `host "${url.hostname}" did not resolve` };
+  }
+  if (addresses.length === 0) return { kind: "broken", message: `host "${url.hostname}" did not resolve` };
+  if (addresses.some((candidate) => !isPublicAddress(candidate.address, candidate.family))) {
+    return { kind: "skipped" };
+  }
+  const pinned = addresses[0];
+  try {
+    let status = await send(url, "HEAD", pinned, timeoutMs);
+    if (status === 405 || status === 501) status = await send(url, "GET", pinned, timeoutMs);
+    if (status >= 200 && status < 400) return { kind: "ok" };
+    if (status === 401 || status === 403 || status === 429 || status === 999) return { kind: "skipped" };
+    return { kind: "broken", message: `returned HTTP ${status}` };
+  } catch (error) {
+    const reason = error instanceof Error && error.name === "TimeoutError" ? `timed out after ${timeoutMs}ms` : "could not be reached";
+    return { kind: "broken", message: reason };
+  }
+}
+async function checkExternalLinks(references, options = {}) {
+  const concurrency = Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY);
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const maxUrls = Math.max(0, options.maxUrls ?? DEFAULT_MAX_URLS);
+  const resolveHost = options.resolve ?? defaultResolve;
+  const send = options.request ?? defaultRequest;
+  const occurrences = /* @__PURE__ */ new Map();
+  for (const reference of references) {
+    const url = checkableUrl(reference.url);
+    if (!url) continue;
+    const key = url.toString();
+    const entry = occurrences.get(key) ?? { url, references: [] };
+    entry.references.push(reference);
+    occurrences.set(key, entry);
+  }
+  const entries = [...occurrences.values()];
+  const checked = entries.slice(0, maxUrls);
+  const limit = pLimit(concurrency);
+  const outcomes = await Promise.all(checked.map((entry) => limit(() => checkOne(entry.url, resolveHost, send, timeoutMs))));
+  const issues = [];
+  checked.forEach((entry, index) => {
+    const outcome = outcomes[index];
+    if (outcome.kind !== "broken") return;
+    for (const reference of entry.references) {
+      issues.push({
+        severity: "warning",
+        message: `External link "${reference.url}" ${outcome.message}`,
+        file: reference.file,
+        line: reference.line
+      });
+    }
+  });
+  if (entries.length > checked.length) {
+    issues.push({
+      severity: "warning",
+      message: `Checked the first ${checked.length} of ${entries.length} unique external links; the rest were not checked.`
+    });
+  }
+  return issues;
+}
+
+// src/check.ts
 function gitLocal(projectDir, args) {
   try {
     const out = execFileSync("git", args, { cwd: projectDir, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
@@ -699,10 +824,14 @@ async function runCheck(projectDir, options) {
       anchorsByPath.set(localized, anchors);
     }
   }
+  const externalLinks = [];
   for (const { file, anchors, links, offset } of linksByFile) {
     for (const { target, line: contentLine } of links) {
       const line = contentLine + offset;
-      if (/^(https?:|mailto:|tel:)/i.test(target)) continue;
+      if (/^(https?:|mailto:|tel:)/i.test(target)) {
+        if (/^https?:/i.test(target)) externalLinks.push({ url: target, file, line });
+        continue;
+      }
       if (target.startsWith("#")) {
         const anchor2 = target.slice(1);
         if (anchor2 && !anchors.has(decodedFragment(anchor2))) {
@@ -747,6 +876,9 @@ async function runCheck(projectDir, options) {
   }
   checkPublicSpecs(projectDir, config.tabs, issues);
   checkUnpublishedOperationPages(projectDir, config.tabs, operationPages, issues);
+  if (options.external && externalLinks.length > 0) {
+    issues.push(...await checkExternalLinks(externalLinks, options.externalLinkOptions));
+  }
   const errors = issues.filter((i) => i.severity === "error");
   options.onIssues?.(issues);
   const warnings = issues.filter((i) => i.severity === "warning");

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-KGKSB3PU.js → chunk-BFPU5AAU.js}

@@ -2,25 +2,26 @@
 import {
   personalizeStarter,
   updateEnvExample
-} from "./chunk-4VKRBJV2.js";
+} from "./chunk-UG3OXVLE.js";
 import {
   resetTrackingConfig,
   writeTrackingConfig
 } from "./chunk-J7255UQA.js";
 import {
   downloadStarter
-} from "./chunk-WWIATVAD.js";
+} from "./chunk-MXM4SK6B.js";
 import {
   terminal
 } from "./chunk-L2YCVQBR.js";
 
 // src/scaffold.ts
-import { existsSync, mkdirSync, readdirSync } from "fs";
+import { existsSync as existsSync2, mkdirSync, readdirSync } from "fs";
 import { resolve as resolve2 } from "path";
 
 // src/utils.ts
 import { execFileSync, execSync, spawn } from "child_process";
-import { resolve } from "path";
+import { existsSync, readFileSync } from "fs";
+import { join, resolve } from "path";
 function slugify(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
 }
@@ -139,8 +140,21 @@ function quoteDirectory(directory) {
   const absolute = resolve(directory);
   return process.platform === "win32" ? `"${absolute.replace(/"/g, '""')}"` : `'${absolute.replace(/'/g, "'\\''")}'`;
 }
+function declaresThallyCli(directory) {
+  try {
+    const manifest = JSON.parse(readFileSync(join(directory, "package.json"), "utf8"));
+    return Boolean(manifest.devDependencies?.["@thallylabs/cli"] ?? manifest.dependencies?.["@thallylabs/cli"]);
+  } catch {
+    return false;
+  }
+}
+function devCommand(directory, needsInstall = false) {
+  const binary = join(directory, "node_modules", ".bin", "thally");
+  const hasLocalCli = needsInstall ? declaresThallyCli(directory) : existsSync(binary) || existsSync(`${binary}.cmd`);
+  return hasLocalCli ? "npx thally dev" : "npm run dev";
+}
 function previewCommand(directory, needsInstall = false) {
-  return `cd ${quoteDirectory(directory)} && ${needsInstall ? "npm install && " : ""}npm run dev`;
+  return `cd ${quoteDirectory(directory)} && ${needsInstall ? "npm install && " : ""}${devCommand(directory, needsInstall)}`;
 }
 function logo(version) {
   terminal.intro("init", version, "Build and publish docs for people and AI tools.");
@@ -166,13 +180,14 @@ async function scaffold(options) {
     brandPreset,
     repoUrl,
     doInstall,
+    continueOnInstallFailure = false,
     enableAiChat = true,
     i18nLocales,
     trackRepos,
     colors
   } = options;
   const targetDir = resolve2(projectDir);
-  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+  if (existsSync2(targetDir) && readdirSync(targetDir).length > 0) {
     throw new Error(`Directory "${targetDir}" already exists and is not empty.`);
   }
   mkdirSync(targetDir, { recursive: true });
@@ -203,11 +218,19 @@ async function scaffold(options) {
     terminal.info("To finish wiring it: `thally track setup` (pick a trigger) + `thally agent init`,");
     terminal.info("then add your ANTHROPIC_API_KEY. See /guides/thally-track.");
   }
+  let dependenciesInstalled = false;
   if (doInstall) {
-    await installDeps(targetDir);
+    try {
+      await installDeps(targetDir);
+      dependenciesInstalled = true;
+    } catch (error) {
+      const exitCode = error.exitCode;
+      if (!continueOnInstallFailure || exitCode === 130 || exitCode === 143) throw error;
+      terminal.warn('Dependency installation failed. The project was created; run "npm install" in it to finish.');
+    }
   }
   await initGit(targetDir);
-  return { projectDir: targetDir };
+  return { projectDir: targetDir, dependenciesInstalled };
 }
 
 export {

package/dist/{chunk-VGE5L66Z.js → chunk-KNW5K72A.js}

@@ -8,10 +8,10 @@ import {
   installDeps,
   runProjectCommand,
   scaffold
-} from "./chunk-KGKSB3PU.js";
+} from "./chunk-BFPU5AAU.js";
 import {
   pruneMissingSiteLinks
-} from "./chunk-4VKRBJV2.js";
+} from "./chunk-UG3OXVLE.js";
 import {
   terminal
 } from "./chunk-L2YCVQBR.js";

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-4VKRBJV2.js → chunk-UG3OXVLE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/customize.ts
-import { cpSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
 function readJsonObject(filePath, label) {
   let value;
@@ -203,11 +203,16 @@ function updateCloudflareRuntimeName(targetDir, packageName) {
   );
   writeFileSync(configPath, updated, "utf8");
 }
+var SITE_URL_ASSIGNMENT = /^([ \t]*)((?:THALLY|DOX|NEXT_PUBLIC)_SITE_URL[ \t]*=[ \t]*["']?(?:https?:\/\/)?(?:localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)(?:[:/][^\r\n]*)?)$/gm;
+function disableLoopbackSiteUrl(source) {
+  return source.replace(SITE_URL_ASSIGNMENT, "$1# $2");
+}
 function updateEnvExample(targetDir) {
   const envFile = join(targetDir, ".env.example");
   if (!existsSync(envFile)) return;
   const envLocal = join(targetDir, ".env.local");
-  if (!existsSync(envLocal)) cpSync(envFile, envLocal);
+  if (existsSync(envLocal)) return;
+  writeFileSync(envLocal, disableLoopbackSiteUrl(readFileSync(envFile, "utf8")), "utf8");
 }
 function personalizeStarter(targetDir, options) {
   updateStarterDocsConfig(
@@ -234,6 +239,7 @@ export {
   pruneMissingSiteLinks,
   updatePackageIdentity,
   updateCloudflareRuntimeName,
+  disableLoopbackSiteUrl,
   updateEnvExample,
   personalizeStarter
 };

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/customize.d.ts

@@ -46,9 +46,18 @@ declare function pruneMissingSiteLinks(targetDir: string, pageIds: ReadonlySet<s
 declare function updatePackageIdentity(targetDir: string, packageName: string): void;
 /** Update the provider-portable Worker name without recreating its config. */
 declare function updateCloudflareRuntimeName(targetDir: string, packageName: string): void;
+/**
+ * Comment out loopback site-URL assignments in a local environment file.
+ *
+ * The runtime already defaults to the local URL in development. An explicit
+ * `localhost` value is harmful instead: Next.js loads `.env.local` during
+ * production builds too, so a build or deploy from this checkout would bake
+ * dead `localhost` links into llms.txt, sitemap.xml, and JSON-LD.
+ */
+declare function disableLoopbackSiteUrl(source: string): string;
 /** Copy the canonical environment guide to the ignored local filename. */
 declare function updateEnvExample(targetDir: string): void;
 /** Apply the complete, intentionally narrow owner-personalization contract. */
 declare function personalizeStarter(targetDir: string, options: StarterPersonalizationOptions): void;
 
-export { type StarterLocale, type StarterPersonalizationOptions, personalizeStarter, pruneMissingSiteLinks, updateCloudflareRuntimeName, updateEnvExample, updatePackageIdentity, updateSiteConfig, updateStarterDocsConfig };
+export { type StarterLocale, type StarterPersonalizationOptions, disableLoopbackSiteUrl, personalizeStarter, pruneMissingSiteLinks, updateCloudflareRuntimeName, updateEnvExample, updatePackageIdentity, updateSiteConfig, updateStarterDocsConfig };

package/dist/customize.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  disableLoopbackSiteUrl,
   personalizeStarter,
   pruneMissingSiteLinks,
   updateCloudflareRuntimeName,
@@ -7,8 +8,9 @@ import {
   updatePackageIdentity,
   updateSiteConfig,
   updateStarterDocsConfig
-} from "./chunk-4VKRBJV2.js";
+} from "./chunk-UG3OXVLE.js";
 export {
+  disableLoopbackSiteUrl,
   personalizeStarter,
   pruneMissingSiteLinks,
   updateCloudflareRuntimeName,

package/dist/index.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "./chunk-VGE5L66Z.js";
+} from "./chunk-KNW5K72A.js";
 import {
   parseFrontmatter,
   runCheck
-} from "./chunk-DIX4EUI4.js";
+} from "./chunk-2UHO52SA.js";
 import "./chunk-KDLP27DS.js";
 import {
   logo,
@@ -13,12 +13,12 @@ import {
   scaffold,
   slugify,
   success
-} from "./chunk-KGKSB3PU.js";
-import "./chunk-4VKRBJV2.js";
+} from "./chunk-BFPU5AAU.js";
+import "./chunk-UG3OXVLE.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,
@@ -191,19 +191,8 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
     message: "  Project name:",
     default: defaultName
   });
-  const defaultDesc = `Documentation for ${projectName}.`;
-  const description = useDefaults ? defaultDesc : await input2({
-    message: "  Description:",
-    default: defaultDesc
-  });
-  const brandPreset = useDefaults ? "primary" : await select3({
-    message: "  Brand preset:",
-    choices: [
-      { name: "primary", value: "primary" },
-      { name: "secondary", value: "secondary" }
-    ],
-    default: "primary"
-  });
+  const description = `Documentation for ${projectName}.`;
+  const brandPreset = "primary";
   const repoUrl = useDefaults ? "" : await input2({
     message: "  GitHub repo URL (optional):",
     default: ""
@@ -224,13 +213,12 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
       else console.log("  \u26A0 No valid owner/repo entries \u2014 skipping Track (add it later with `thally track add`).");
     }
   }
-  let doInstall = installPreference ?? false;
+  let doInstall = installPreference ?? true;
   if (!useDefaults && installPreference === void 0) {
-    const shouldInstall = await input2({
-      message: "  Install dependencies now? (y/N):",
-      default: "N"
+    doInstall = await confirm3({
+      message: "  Install dependencies now?",
+      default: true
     });
-    doInstall = shouldInstall.trim().toLowerCase().startsWith("y");
   }
   let i18nLocales;
   if (!useDefaults) {
@@ -735,8 +723,8 @@ Commands:
 
 Scaffold options:
   -y, --yes       Accept defaults and skip interactive prompts
-  --install       Install project dependencies after scaffolding
-  --no-install    Skip dependency installation without prompting
+  --install       Install project dependencies (the default)
+  --no-install    Skip dependency installation
   --verbose       Show detailed installation and Git output
   -h, --help      Show this help
   -v, -V, --version  Show the installed version
@@ -769,7 +757,7 @@ Usage:
 Options:
   --fix       Add orphan pages to navigation when possible
   --ci        Use CI-oriented validation behavior
-  --external  Check external links
+  --external  Also check external links (public hosts only; warnings, never errors)
   --drift     Check documentation provenance and freshness
   -h, --help  Show this help
 `,
@@ -930,10 +918,12 @@ async function runScaffoldCommand() {
     brandPreset: answers.brandPreset,
     repoUrl: answers.repoUrl,
     doInstall: answers.doInstall,
+    continueOnInstallFailure: true,
     i18nLocales: answers.i18nLocales,
     trackRepos: answers.trackRepos
   });
-  success(result.projectDir, answers.projectName, answers.doInstall);
+  success(result.projectDir, answers.projectName, result.dependenciesInstalled);
+  if (answers.doInstall && !result.dependenciesInstalled) process.exitCode = 1;
 }
 async function runCheckCommand() {
   const projectDir = resolve2(positional[1] ?? ".");

package/dist/migrate/index.d.ts

@@ -5,6 +5,7 @@ import { MigrationPlatform, MigrationFetcher, SourceRefMapping, MigrationBundle,
  * serve, including locale fallback and literal redirect chains. Validation is
  * read-only unless the caller explicitly enables orphan-navigation fixes.
  */
+
 interface LintIssue {
     severity: 'error' | 'warning';
     message: string;

package/dist/migrate/index.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   migrateDocs
-} from "../chunk-VGE5L66Z.js";
+} from "../chunk-KNW5K72A.js";
 import "../chunk-KDLP27DS.js";
-import "../chunk-KGKSB3PU.js";
-import "../chunk-4VKRBJV2.js";
+import "../chunk-BFPU5AAU.js";
+import "../chunk-UG3OXVLE.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/migration-worker.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCheck
-} from "./chunk-DIX4EUI4.js";
+} from "./chunk-2UHO52SA.js";
 import "./chunk-KDLP27DS.js";
 import "./chunk-J7255UQA.js";
 

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.d.ts

@@ -39,6 +39,12 @@ interface ScaffoldOptions {
     brandPreset: string;
     repoUrl: string;
     doInstall: boolean;
+    /**
+     * Report a failed install and still finish the project (Git setup included)
+     * instead of throwing. Interactive creation opts in; library callers keep
+     * the historical fail-fast contract.
+     */
+    continueOnInstallFailure?: boolean;
     enableAiChat?: boolean;
     i18nLocales?: Array<{
         code: string;
@@ -58,6 +64,8 @@ interface ScaffoldOptions {
 }
 interface ScaffoldResult {
     projectDir: string;
+    /** False when installation was skipped or failed; the project is still usable. */
+    dependenciesInstalled: boolean;
 }
 /** Download, personalize, and optionally install a new documentation project. */
 declare function scaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;

package/dist/scaffold.js

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
 import {
   scaffold
-} from "./chunk-KGKSB3PU.js";
-import "./chunk-4VKRBJV2.js";
+} from "./chunk-BFPU5AAU.js";
+import "./chunk-UG3OXVLE.js";
 import "./chunk-J7255UQA.js";
 import {
   STARTER_ARCHIVE_ROOT,
   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.80",
+  "version": "0.10.82",
   "description": "Scaffold an open-source Thally docs site for people, search engines, and AI tools.",
   "type": "module",
   "engines": {
@@ -49,8 +49,8 @@
     "@anthropic-ai/sdk": "^0.36.0",
     "@clack/prompts": "^0.11.0",
     "@inquirer/prompts": "^7.0.0",
-    "@thallylabs/core": "0.2.11",
-    "@thallylabs/migrate": "0.2.25",
+    "@thallylabs/core": "0.2.12",
+    "@thallylabs/migrate": "0.2.26",
     "p-limit": "^6.1.0",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",