create-thally-docs 0.10.30 → 0.10.32

package/dist/{chunk-SSKXNB6D.js → chunk-ZFCZE7M7.js}

@@ -3,19 +3,19 @@
 // src/stable-scaffold-release.json
 var stable_scaffold_release_default = {
   schemaVersion: 1,
-  id: "2026-09-06.95ad2d40.928cbdb0",
+  id: "2026-09-07.e15b143d.9b3be068",
   source: {
     repository: "thallylabs/starter",
-    commitSha: "95ad2d4079675f94cd8cc398b3dbd7bfa171c839",
-    treeSha: "fade1339ec1776b9f54707648f548ac223f76c0d",
-    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/95ad2d4079675f94cd8cc398b3dbd7bfa171c839",
+    commitSha: "e15b143d39935f3d6e5fe6127bffc2c3a7591318",
+    treeSha: "fff5cb413f83c8da17d2e4ec3df933d29a5613de",
+    archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/e15b143d39935f3d6e5fe6127bffc2c3a7591318",
     manifestPath: "starter-release.json",
-    manifestSha256: "ddb2d5b8b96f8d772b1a69ca283cda02fb515b26da3675a62d869f83aee8458b"
+    manifestSha256: "07fb1d733700c547874b88eaefcbfc4decef6acd204c765deb81ae3462ee66ba"
   },
   runtime: {
     repository: "thallylabs/thally",
-    commitSha: "928cbdb04d247e8422eff5ca117ae6ad9bfdf2c1",
-    treeSha: "090e1e5186e49e3686cc7434efb8835fbb31be8f",
+    commitSha: "9b3be06826c9bc3a8b6402b25e597b3b7cc80cfe",
+    treeSha: "1a87aa11c382e3d8d88785b85af37e1b823dad86",
     contentSource: "assets",
     identityContractVersion: 1
   },
@@ -24,6 +24,46 @@ var stable_scaffold_release_default = {
 
 // src/previous-scaffold-releases.json
 var previous_scaffold_releases_default = [
+  {
+    schemaVersion: 1,
+    id: "2026-09-07.06a4aca7.ad30d29f",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "06a4aca7978ef3e0fc80389095db35f2ff37c96b",
+      treeSha: "13f3a315752259e58dac314233a4519dc2e0ec42",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/06a4aca7978ef3e0fc80389095db35f2ff37c96b",
+      manifestPath: "starter-release.json",
+      manifestSha256: "3a7cfa791c92ec24c6b0b755e2f1fe988e9fb408015ccc69f78681102e8bf65d"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "ad30d29f79221092c873c611953097161fed0f60",
+      treeSha: "1a217f1304557264ed231774f5bb9d81dc639ed0",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 2
+  },
+  {
+    schemaVersion: 1,
+    id: "2026-09-06.95ad2d40.928cbdb0",
+    source: {
+      repository: "thallylabs/starter",
+      commitSha: "95ad2d4079675f94cd8cc398b3dbd7bfa171c839",
+      treeSha: "fade1339ec1776b9f54707648f548ac223f76c0d",
+      archiveUrl: "https://codeload.github.com/thallylabs/starter/tar.gz/95ad2d4079675f94cd8cc398b3dbd7bfa171c839",
+      manifestPath: "starter-release.json",
+      manifestSha256: "ddb2d5b8b96f8d772b1a69ca283cda02fb515b26da3675a62d869f83aee8458b"
+    },
+    runtime: {
+      repository: "thallylabs/thally",
+      commitSha: "928cbdb04d247e8422eff5ca117ae6ad9bfdf2c1",
+      treeSha: "090e1e5186e49e3686cc7434efb8835fbb31be8f",
+      contentSource: "assets",
+      identityContractVersion: 1
+    },
+    starterVersion: 2
+  },
   {
     schemaVersion: 1,
     id: "2026-09-06.323199bb.6c240f71",

package/dist/index.js

@@ -1,24 +1,25 @@
 #!/usr/bin/env node
 import {
-  migrateDocs
-} from "./chunk-UYGDCVX3.js";
+  migrateDocs,
+  parseFrontmatter,
+  runCheck
+} from "./chunk-E5URHAYU.js";
 import {
   logo,
-  readDocsJson,
   scaffold,
   slugify,
-  success,
-  writeDocsJson
-} from "./chunk-4RPHM4NA.js";
+  success
+} from "./chunk-74SGZLEY.js";
 import "./chunk-ORUAMPNF.js";
-import "./chunk-XAUCGJ6B.js";
-import "./chunk-PMAJ4BVM.js";
-import "./chunk-SSKXNB6D.js";
+import "./chunk-FLSOVTVO.js";
+import "./chunk-HYGEXPZG.js";
+import "./chunk-ZFCZE7M7.js";
 
 // src/index.ts
-import { existsSync as existsSync3, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync2, readdirSync } from "fs";
 import { createRequire } from "module";
 import { resolve as resolve2 } from "path";
+import { confirm as confirm2 } from "@inquirer/prompts";
 
 // src/prompts.ts
 import { confirm, input, select } from "@inquirer/prompts";
@@ -199,393 +200,15 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
 // src/index.ts
 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 { parse as parseYaml } from "yaml";
-function parseFrontmatter(raw) {
-  const source = raw.charCodeAt(0) === 65279 ? raw.slice(1) : raw;
-  const opening = /^---([^\r\n]*)\r?\n/.exec(source);
-  if (!opening || opening[1].startsWith("-")) return { content: source, data: {} };
-  const language = opening[1].trim().toLowerCase();
-  const remainder = source.slice(opening[0].length);
-  const closing = /^---[ \t]*\r?$/m.exec(remainder);
-  const matter = closing ? remainder.slice(0, closing.index) : remainder;
-  let content = closing ? remainder.slice(closing.index + closing[0].length) : "";
-  if (content.startsWith("\r\n")) content = content.slice(2);
-  else if (content.startsWith("\n")) content = content.slice(1);
-  if (matter.trim() === "" || !["", "yaml", "yml"].includes(language)) {
-    return { content, data: {} };
-  }
-  const parsed = parseYaml(matter);
-  return {
-    content,
-    data: parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {}
-  };
-}
-
-// src/check.ts
-import { parse as parseYaml2 } from "yaml";
-function gitLocal(projectDir, args2) {
-  try {
-    const out = execFileSync("git", args2, { cwd: projectDir, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
-    return { ok: true, out: out.trim() };
-  } catch {
-    return { ok: false, out: "" };
-  }
-}
-function checkDrift(projectDir, file, data, issues) {
-  const sources = data.sources;
-  const verifiedCommit = data.verifiedCommit;
-  if (!Array.isArray(sources) || sources.length === 0 || typeof verifiedCommit !== "string" || !verifiedCommit.trim()) {
-    return;
-  }
-  const commit = verifiedCommit.trim();
-  if (!gitLocal(projectDir, ["cat-file", "-e", `${commit}^{commit}`]).ok) {
-    issues.push({
-      severity: "warning",
-      message: `Cannot verify freshness: verifiedCommit "${commit.slice(0, 8)}" is not in git history \u2014 run with a full clone (fetch-depth: 0).`,
-      file
-    });
-    return;
-  }
-  for (const src of sources) {
-    if (typeof src !== "string" || !src.trim()) continue;
-    const colon = src.indexOf(":");
-    let filePath = src;
-    if (colon > 0) {
-      const alias = src.slice(0, colon);
-      if (alias !== "." && alias !== "self") {
-        issues.push({
-          severity: "warning",
-          message: `Cross-repo source "${src}" \u2014 drift check skipped (needs the referenced repo; see multi-repo setup).`,
-          file
-        });
-        continue;
-      }
-      filePath = src.slice(colon + 1);
-    }
-    filePath = filePath.replace(/^\.\//, "").replace(/#.*$/, "");
-    const changed = gitLocal(projectDir, ["log", "--format=%H", `${commit}..HEAD`, "--", filePath]).out;
-    if (changed) {
-      const n = changed.split("\n").filter(Boolean).length;
-      issues.push({
-        severity: "warning",
-        message: `Drift: source "${src}" changed in ${n} commit(s) since it was verified \u2014 this page may be stale.`,
-        file
-      });
-    }
-  }
-}
-function collectNavPageIds(groups, seen, duplicates) {
-  for (const page of groups) {
-    if (typeof page === "string") {
-      if (seen.has(page)) duplicates.add(page);
-      else seen.add(page);
-    } else if (page.pages) {
-      collectNavPageIds(page.pages, seen, duplicates);
-    }
-  }
-}
-function scanMdx(dir, results) {
-  let entries;
-  try {
-    entries = readdirSync(dir);
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    const fullPath = join(dir, entry);
-    try {
-      const stat = statSync(fullPath);
-      if (stat.isDirectory()) scanMdx(fullPath, results);
-      else if (extname(entry).toLowerCase() === ".mdx") results.push(fullPath);
-    } catch {
-    }
-  }
-}
-function addOrphanToNav(projectDir, pageId) {
-  const config = readDocsJson(projectDir);
-  const tab = config.tabs.find((candidate) => !candidate.href && !candidate.api && (candidate.pages?.length || candidate.groups?.length));
-  if (!tab) return;
-  if (tab.pages) {
-    if (!tab.pages.includes(pageId)) {
-      tab.pages.push(pageId);
-      writeDocsJson(projectDir, config);
-    }
-    return;
-  }
-  if (!tab.groups) return;
-  const lastGroup = tab.groups[tab.groups.length - 1];
-  const existing = lastGroup.pages.filter((p) => typeof p === "string");
-  if (!existing.includes(pageId)) {
-    lastGroup.pages.push(pageId);
-    writeDocsJson(projectDir, config);
-  }
-}
-function slugify2(text) {
-  return text.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/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(slugify2(m[1]));
-  }
-  return anchors;
-}
-function extractLinks(content) {
-  const links = [];
-  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)) {
-      links.push({ target: m[1], line: i + 1 });
-    }
-    for (const m of line.matchAll(/href=["']([^"']+)["']/g)) {
-      links.push({ target: m[1], line: i + 1 });
-    }
-  }
-  return links;
-}
-function localizedPage(pageId, secondaryLocales) {
-  const [first, ...rest] = pageId.split("/");
-  if (secondaryLocales.has(first) && rest.length > 0) {
-    return { navPageId: rest.join("/"), locale: first };
-  }
-  return { navPageId: pageId };
-}
-function pageIdToPath(pageId, secondaryLocales) {
-  const { navPageId, locale } = localizedPage(pageId, secondaryLocales);
-  const basePath = navPageId === "introduction" ? "/" : `/${navPageId}`;
-  return locale ? `/${locale}${basePath === "/" ? "" : basePath}` : basePath;
-}
-function validateOpenApi(projectDir, source, issues) {
-  const specPath = source.startsWith("/") ? join(projectDir, "public", source.slice(1)) : join(projectDir, source);
-  if (!existsSync(specPath)) {
-    issues.push({ severity: "error", message: `API reference points at "${source}" but the file does not exist`, file: source });
-    return;
-  }
-  let spec;
-  try {
-    const raw = readFileSync(specPath, "utf8");
-    spec = source.endsWith(".json") ? JSON.parse(raw) : parseYaml2(raw);
-  } catch (err) {
-    issues.push({ severity: "error", message: `OpenAPI spec is not valid ${source.endsWith(".json") ? "JSON" : "YAML"}: ${err.message}`, file: source });
-    return;
-  }
-  const s = spec;
-  if (typeof s?.openapi !== "string" && typeof s?.swagger !== "string") {
-    issues.push({ severity: "error", message: 'OpenAPI spec is missing the "openapi" (or "swagger") version field', file: source });
-  }
-  if (typeof s?.info !== "object" || s.info === null) {
-    issues.push({ severity: "error", message: 'OpenAPI spec is missing the "info" object', file: source });
-  }
-  const paths = s?.paths;
-  if (typeof paths !== "object" || paths === null) {
-    issues.push({ severity: "error", message: 'OpenAPI spec is missing the "paths" object', file: source });
-  } else {
-    const methods = /* @__PURE__ */ new Set(["get", "post", "put", "patch", "delete", "options", "head", "trace"]);
-    for (const [p, ops] of Object.entries(paths)) {
-      if (typeof ops !== "object" || ops === null) {
-        issues.push({ severity: "error", message: `OpenAPI path "${p}" is not an object`, file: source });
-        continue;
-      }
-      const hasOp = Object.keys(ops).some((k) => methods.has(k.toLowerCase()));
-      if (!hasOp) {
-        issues.push({ severity: "warning", message: `OpenAPI path "${p}" has no operations`, file: source });
-      }
-    }
-  }
-}
-async function runCheck(projectDir, options) {
-  const { fix, ci } = options;
-  if (!existsSync(join(projectDir, "docs.json"))) {
-    console.error(`
-  \u274C Not a Thally project: docs.json not found in ${projectDir}
-`);
-    return 1;
-  }
-  const contentDir = join(projectDir, "src", "content");
-  const issues = [];
-  const config = readDocsJson(projectDir);
-  const secondaryLocales = new Set(
-    (config.i18n?.locales ?? []).map((locale) => locale.code).filter((code) => code !== config.i18n?.defaultLocale)
-  );
-  const generatedApiPaths = /* @__PURE__ */ new Set([
-    "/api",
-    ...Array.from(secondaryLocales, (locale) => `/${locale}/api`)
-  ]);
-  const redirectDestinations = new Map(
-    (config.redirects ?? []).map((redirect) => [
-      redirect.source.replace(/\/$/, "") || "/",
-      redirect.destination.replace(/\/$/, "") || "/"
-    ])
-  );
-  const navPageIds = /* @__PURE__ */ new Set();
-  const duplicates = /* @__PURE__ */ new Set();
-  for (const tab of config.tabs) {
-    const hasNavigationNodes = Boolean(tab.pages?.length || tab.groups?.length);
-    if (tab.href && !hasNavigationNodes) {
-      if (tab.href.startsWith("/")) navPageIds.add(tab.href.slice(1) || "introduction");
-      continue;
-    }
-    if (tab.api && tab.api.navigation !== false && !hasNavigationNodes) continue;
-    if (!hasNavigationNodes) {
-      issues.push({ severity: "error", message: `Tab "${tab.tab}" has no groups and no href \u2014 it will render empty` });
-      continue;
-    }
-    collectNavPageIds(tab.pages ?? [], navPageIds, duplicates);
-    collectNavPageIds(tab.groups ?? [], navPageIds, duplicates);
-  }
-  for (const dup of duplicates) {
-    issues.push({ severity: "warning", message: `[duplicate] "${dup}" appears more than once in docs.json` });
-  }
-  for (const pageId of navPageIds) {
-    const candidates = [join(contentDir, `${pageId}.mdx`), join(contentDir, `${pageId}/index.mdx`)];
-    if (!candidates.some((c) => existsSync(c))) {
-      issues.push({ severity: "error", message: `"${pageId}" is in docs.json but has no MDX file`, file: `src/content/${pageId}.mdx` });
-    }
-  }
-  const allFiles = [];
-  if (existsSync(contentDir)) scanMdx(contentDir, allFiles);
-  const fixedOrphans = [];
-  const validPaths = /* @__PURE__ */ new Set(["/"]);
-  const anchorsByPath = /* @__PURE__ */ new Map();
-  const linksByFile = [];
-  for (const filePath of allFiles) {
-    const rel = filePath.slice(contentDir.length + 1).replace(/\.mdx$/, "").replace(/\\/g, "/");
-    const pageId = rel.endsWith("/index") ? rel.slice(0, -6) : rel;
-    const { navPageId } = localizedPage(pageId, secondaryLocales);
-    if (!navPageIds.has(navPageId)) {
-      if (fix) {
-        addOrphanToNav(projectDir, pageId);
-        fixedOrphans.push(pageId);
-      } else {
-        issues.push({ severity: "warning", message: `"${pageId}" is not in docs.json nav (orphan)`, file: relative(projectDir, filePath) });
-      }
-    }
-    let data = {};
-    let content = "";
-    let lineOffset = 0;
-    try {
-      const raw = readFileSync(filePath, "utf8");
-      const parsed = parseFrontmatter(raw);
-      data = parsed.data;
-      content = parsed.content;
-      lineOffset = raw.slice(0, raw.indexOf(content)).split("\n").length - 1;
-    } catch {
-      issues.push({ severity: "error", message: `Could not parse frontmatter`, file: relative(projectDir, filePath) });
-      continue;
-    }
-    const rel2 = relative(projectDir, filePath);
-    if (!data.title) issues.push({ severity: "warning", message: `Missing "title" in frontmatter`, file: rel2 });
-    if (!data.description) issues.push({ severity: "warning", message: `Missing "description" in frontmatter`, file: rel2 });
-    if (typeof data.openapi !== "string" && content.trim().length < 50) {
-      issues.push({ severity: "warning", message: `Very short body (${content.trim().length} chars) \u2014 page may be empty`, file: rel2 });
-    }
-    if (options.drift) checkDrift(projectDir, rel2, data, issues);
-    const path = pageIdToPath(pageId, secondaryLocales);
-    const anchors = extractHeadingAnchors(content);
-    validPaths.add(path);
-    anchorsByPath.set(path, anchors);
-    linksByFile.push({ file: rel2, path, anchors, links: extractLinks(content), offset: lineOffset });
-  }
-  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 (target.startsWith("#")) {
-        const anchor2 = target.slice(1);
-        if (anchor2 && !anchors.has(anchor2)) {
-          issues.push({ severity: "warning", message: `Broken anchor: "${target}" not found on this page`, file, line });
-        }
-        continue;
-      }
-      if (!target.startsWith("/")) continue;
-      const [beforeHash, anchor] = target.split("#");
-      let path = beforeHash.split("?")[0];
-      if (path.length > 1) path = path.replace(/\/$/, "");
-      const isGeneratedApiPath = Array.from(generatedApiPaths).some(
-        (prefix) => path === prefix || path.startsWith(`${prefix}/`)
-      );
-      if (isGeneratedApiPath || path.startsWith("/_next") || /\.[a-z0-9]+$/i.test(path)) continue;
-      const redirectedPath = redirectDestinations.get(path);
-      if (!validPaths.has(path) && !(redirectedPath && validPaths.has(redirectedPath))) {
-        issues.push({ severity: "error", message: `Broken link: "${target}" \u2014 no page at "${path}"`, file, line });
-      } else if (anchor && !anchorsByPath.get(path)?.has(anchor)) {
-        issues.push({ severity: "warning", message: `Broken anchor: "${target}" \u2014 no heading "#${anchor}" on that page`, file, line });
-      }
-    }
-  }
-  for (const tab of config.tabs) {
-    if (tab.api?.source) validateOpenApi(projectDir, tab.api.source, issues);
-  }
-  const errors = issues.filter((i) => i.severity === "error");
-  const warnings = issues.filter((i) => i.severity === "warning");
-  if (ci) {
-    for (const issue of issues) {
-      const loc = issue.file ? `file=${issue.file}${issue.line ? `,line=${issue.line}` : ""}` : "";
-      console.log(`::${issue.severity} ${loc}::${issue.message}`);
-    }
-    console.log(`
-thally check: ${errors.length} error(s), ${warnings.length} warning(s)`);
-    return errors.length > 0 ? 1 : 0;
-  }
-  console.log(`
-  Linting ${projectDir}...
-`);
-  if (errors.length === 0 && warnings.length === 0 && fixedOrphans.length === 0) {
-    console.log("  \u2705 No issues found.\n");
-    return 0;
-  }
-  console.log(`  \u274C ${errors.length} error${errors.length !== 1 ? "s" : ""}, \u26A0\uFE0F  ${warnings.length} warning${warnings.length !== 1 ? "s" : ""}
-`);
-  if (errors.length > 0) {
-    console.log("  ERRORS:");
-    for (const issue of errors) {
-      console.log(`    ${issue.message}`);
-      if (issue.file) console.log(`    \u2192 ${issue.file}${issue.line ? `:${issue.line}` : ""}`);
-    }
-    console.log("");
-  }
-  if (warnings.length > 0) {
-    console.log("  WARNINGS:");
-    for (const issue of warnings) {
-      console.log(`    ${issue.message}`);
-      if (issue.file) console.log(`    \u2192 ${issue.file}${issue.line ? `:${issue.line}` : ""}`);
-    }
-    console.log("");
-  }
-  if (fixedOrphans.length > 0) {
-    console.log(`  \u2705 Auto-fixed ${fixedOrphans.length} orphan page${fixedOrphans.length > 1 ? "s" : ""} (added to nav):`);
-    for (const p of fixedOrphans) console.log(`    + ${p}`);
-    console.log("");
-  }
-  if (!fix && warnings.some((w) => w.message.includes("orphan"))) {
-    console.log("  Tip: run with --fix to auto-add orphan pages to navigation.\n");
-  }
-  return errors.length > 0 ? 1 : 0;
-}
-
 // src/translate.ts
-import { readFileSync as readFileSync2, writeFileSync, existsSync as existsSync2, mkdirSync } from "fs";
-import { join as join2, dirname } from "path";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
 import { input as input2 } from "@inquirer/prompts";
 import Anthropic from "@anthropic-ai/sdk";
 import pLimit from "p-limit";
-function readDocsJson2(projectDir) {
-  const docsPath = join2(projectDir, "docs.json");
-  const raw = readFileSync2(docsPath, "utf8");
+function readDocsJson(projectDir) {
+  const docsPath = join(projectDir, "docs.json");
+  const raw = readFileSync(docsPath, "utf8");
   return JSON.parse(raw);
 }
 function collectPageIds(pages) {
@@ -628,12 +251,12 @@ function getAllPageIds(config) {
   return { ids, skippedApiTabs, hrefOnlyPages };
 }
 function findSourceFile(projectDir, pageId) {
-  const contentRoot = join2(projectDir, "src", "content");
+  const contentRoot = join(projectDir, "src", "content");
   const candidates = [
-    join2(contentRoot, `${pageId}.mdx`),
-    join2(contentRoot, `${pageId}/index.mdx`)
+    join(contentRoot, `${pageId}.mdx`),
+    join(contentRoot, `${pageId}/index.mdx`)
   ];
-  return candidates.find((p) => existsSync2(p)) ?? null;
+  return candidates.find((p) => existsSync(p)) ?? null;
 }
 var TRANSLATION_SYSTEM_PROMPT = `You are a professional documentation translator. You will receive an MDX documentation file and translate it into the target language.
 
@@ -689,7 +312,7 @@ ${sourceContent}`
   return text.trim();
 }
 async function runTranslateCommand(locale, pages, force, apiKey, model, yes, projectDir) {
-  const config = readDocsJson2(projectDir);
+  const config = readDocsJson(projectDir);
   if (!config.i18n) {
     console.error("\n  \u274C No i18n config found in docs.json.");
     console.error('     Add an "i18n" block to docs.json first:');
@@ -730,7 +353,7 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
     console.log("");
   }
   const targetPageIds = pages ?? allPageIds;
-  const contentRoot = join2(projectDir, "src", "content");
+  const contentRoot = join(projectDir, "src", "content");
   const toTranslate = [];
   for (const pageId of targetPageIds) {
     const sourceFile = findSourceFile(projectDir, pageId);
@@ -739,8 +362,8 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
       continue;
     }
     const relativeFromContent = sourceFile.slice(contentRoot.length + 1);
-    const targetFile = join2(contentRoot, locale, relativeFromContent);
-    if (existsSync2(targetFile) && !force) {
+    const targetFile = join(contentRoot, locale, relativeFromContent);
+    if (existsSync(targetFile) && !force) {
       console.log(`  \u23ED  ${pageId} (already translated, use --force to overwrite)`);
       continue;
     }
@@ -757,11 +380,11 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
   }
   console.log("");
   if (!yes) {
-    const confirm2 = await input2({
+    const confirm3 = await input2({
       message: "  Proceed? (Y/n):",
       default: "Y"
     });
-    if (confirm2.toLowerCase() === "n") {
+    if (confirm3.toLowerCase() === "n") {
       console.log("\n  Aborted.");
       return;
     }
@@ -774,7 +397,7 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
     toTranslate.map(
       ({ pageId, sourceFile, targetFile }) => limit(async () => {
         try {
-          const sourceContent = readFileSync2(sourceFile, "utf8");
+          const sourceContent = readFileSync(sourceFile, "utf8");
           const parsed = parseFrontmatter(sourceContent);
           if (!parsed.data.title) {
             console.warn(`  \u26A0  ${pageId}: missing title in frontmatter \u2014 translating anyway`);
@@ -830,6 +453,8 @@ var commandFlags = {
     "--into",
     "--max-pages",
     "--platform",
+    "--skip-validation",
+    "--trust-source",
     "--yes",
     "-y"
   ]),
@@ -876,6 +501,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, or auto
+  --skip-validation   Import only; explicitly skip content and build verification
+  --trust-source      Allow installation and build execution of trusted source code
   --api-key <key>      Anthropic API key for non-Markdown conversion
   -y, --yes            Skip interactive prompts
   -h, --help           Show this help
@@ -992,7 +619,14 @@ async function runMigrateCommand() {
   if (docsDir) console.log(`  Docs dir: ${docsDir}`);
   console.log(`  Platform: ${platform ?? "auto-detect"}`);
   console.log("");
-  await migrateDocs({
+  let trustSource = flags.includes("--trust-source");
+  if (!trustSource && !yes && !flags.includes("--skip-validation") && process.stdin.isTTY && process.stdout.isTTY) {
+    trustSource = await confirm2({
+      message: "Installation and build validation execute imported code on this machine. Do you trust this source and authorize execution?",
+      default: false
+    });
+  }
+  const result = await migrateDocs({
     sourceUrl,
     projectDir,
     into: isInto,
@@ -1001,8 +635,11 @@ async function runMigrateCommand() {
     docsDir,
     maxPages,
     platform,
-    yes
+    yes,
+    skipValidation: flags.includes("--skip-validation"),
+    trustSource
   });
+  if (result.validation.content === "failed" || result.validation.build === "failed") process.exitCode = 1;
 }
 async function runScaffoldCommand() {
   const useDefaults = flags.includes("--yes") || flags.includes("-y");
@@ -1010,7 +647,7 @@ async function runScaffoldCommand() {
   const dirArg = positional[0];
   if (dirArg) {
     const resolved = resolve2(dirArg);
-    if (existsSync3(resolved) && readdirSync2(resolved).length > 0) {
+    if (existsSync2(resolved) && readdirSync(resolved).length > 0) {
       console.error(`
   \u274C Directory "${resolved}" already exists and is not empty.`);
       process.exit(1);

package/dist/migrate/index.d.ts

@@ -1,5 +1,24 @@
 import { MigrationPlatform, MigrationFetcher, MigrationBundle, MigrationWarning } from '@thallylabs/migrate';
 
+/**
+ * Validate authored navigation and links against the routes the runtime can
+ * 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;
+    file?: string;
+    line?: number;
+}
+
+interface MigrationValidation {
+    content: 'passed' | 'failed' | 'skipped';
+    build: 'passed' | 'failed' | 'skipped';
+    messages: Array<string>;
+    diagnostics: Array<LintIssue>;
+}
+
 /**
  * CLI materializer for the shared Thally migration engine. Discovery completes
  * before scaffolding or writing, and every generated path is proven to remain
@@ -21,6 +40,10 @@ interface MigrateOptions {
     platform?: MigrationPlatform;
     /** Optional host fetch boundary; used by Thally Cloud adapters and tests. */
     fetcher?: MigrationFetcher;
+    /** Explicitly opt out of content/build gates; the report remains unverified. */
+    skipValidation?: boolean;
+    /** Explicitly allow local installation/build execution of reviewed source. Never implied by yes. */
+    trustSource?: boolean;
 }
 interface MigrateResult {
     pagesWritten: number;
@@ -28,6 +51,8 @@ interface MigrateResult {
     projectDir: string;
     platform: MigrationBundle['platform'];
     warnings: Array<MigrationWarning>;
+    validation: MigrationValidation;
+    reportPath: string;
 }
 /** Import a GitHub docs repository or public docs URL into a Thally project. */
 declare function migrateDocs(options: MigrateOptions): Promise<MigrateResult>;