@thallylabs/mcp 0.7.0 → 0.7.2

package/dist/tools.js

@@ -10,7 +10,17 @@ import { promisify } from "util";
 import tar from "tar";
 var pipelineAsync = promisify(pipeline);
 var TARBALL_URL = "https://codeload.github.com/thallylabs/thally/tar.gz/main";
-var EXCLUDE_PATHS = ["/cli/", "/packages/", "/node_modules/", "/.git/"];
+var EXCLUDE_PATHS = [
+  "/cli/",
+  "/packages/",
+  "/node_modules/",
+  "/.git/",
+  "/thally-agent.yml",
+  "/thally-track.yml",
+  "/CODEOWNERS",
+  "/CLAUDE.md",
+  "/notes/"
+];
 var STARTER_PAGES = {
   "introduction.mdx": `---
 title: Introduction
@@ -517,867 +527,15 @@ async function handleUpdatePage(input) {
 
 // src/tools/migrate-docs.ts
 import { z as z6 } from "zod";
-
-// src/lib/migrate/index.ts
-import { mkdirSync as mkdirSync3, copyFileSync, writeFileSync as writeFileSync5, existsSync as existsSync6, mkdtempSync, rmSync } from "fs";
-import { join as join7, dirname as dirname2, resolve as resolve2 } from "path";
-import { tmpdir } from "os";
-import { execSync as execSync3 } from "child_process";
-import pLimit from "p-limit";
-
-// src/lib/migrate/github.ts
-import { execSync as execSync2 } from "child_process";
-import { readdirSync as readdirSync2, statSync } from "fs";
-import { join as join5, relative, extname, basename } from "path";
-var OPENAPI_FILENAMES = [
-  "openapi.json",
-  "openapi.yaml",
-  "openapi.yml",
-  "swagger.json",
-  "swagger.yaml",
-  "swagger.yml"
-];
-function detectOpenApiSpec(cloneDir) {
-  return findOpenApiSpec(cloneDir, 0);
-}
-function findOpenApiSpec(dir, depth) {
-  if (depth > 3) return null;
-  let entries;
-  try {
-    entries = readdirSync2(dir);
-  } catch {
-    return null;
-  }
-  for (const filename of OPENAPI_FILENAMES) {
-    if (entries.includes(filename)) {
-      return { absPath: join5(dir, filename), filename };
-    }
-  }
-  for (const entry of entries) {
-    if (entry.startsWith(".") || entry === "node_modules") continue;
-    const fullPath = join5(dir, entry);
-    try {
-      if (statSync(fullPath).isDirectory()) {
-        const found = findOpenApiSpec(fullPath, depth + 1);
-        if (found) return found;
-      }
-    } catch {
-    }
-  }
-  return null;
-}
-function parseGitHubUrl(rawUrl) {
-  let url;
-  try {
-    url = new URL(rawUrl);
-  } catch {
-    throw new Error(`Invalid URL: ${rawUrl}`);
-  }
-  if (url.hostname !== "github.com") {
-    throw new Error(`URL must be a github.com URL, got: ${url.hostname}`);
-  }
-  const parts = url.pathname.replace(/^\//, "").split("/");
-  if (parts.length < 2 || !parts[0] || !parts[1]) {
-    throw new Error(`GitHub URL must include owner and repo: ${rawUrl}`);
-  }
-  const owner = parts[0];
-  const repo = parts[1];
-  let branch = "HEAD";
-  let docsDir = "";
-  if (parts.length >= 4 && parts[2] === "tree") {
-    branch = parts[3];
-    if (parts.length > 4) {
-      docsDir = parts.slice(4).join("/");
-    }
-  }
-  const cloneUrl = `https://github.com/${owner}/${repo}.git`;
-  return { owner, repo, branch, docsDir, cloneUrl };
-}
-async function cloneRepo(source, targetDir) {
-  const parts = ["git", "clone", "--depth", "1"];
-  if (source.branch !== "HEAD") {
-    parts.push("--branch", source.branch);
-  }
-  parts.push(source.cloneUrl, targetDir);
-  const cmd = parts.join(" ");
-  try {
-    execSync2(cmd, { stdio: "pipe" });
-  } catch (err) {
-    const stderr = err.stderr?.toString().trim() ?? "";
-    const msg = stderr || (err instanceof Error ? err.message : String(err));
-    throw new Error(`Failed to clone ${source.cloneUrl}: ${msg}`);
-  }
-}
-var MD_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".mdx"]);
-var ALL_DOC_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".mdx", ".rst", ".txt"]);
-function hasMdFiles(dir) {
-  let entries;
-  try {
-    entries = readdirSync2(dir);
-  } catch {
-    return false;
-  }
-  for (const entry of entries) {
-    const fullPath = join5(dir, entry);
-    try {
-      const stat = statSync(fullPath);
-      if (stat.isDirectory()) {
-        if (hasMdFiles(fullPath)) return true;
-      } else if (MD_EXTENSIONS.has(extname(entry).toLowerCase())) {
-        return true;
-      }
-    } catch {
-    }
-  }
-  return false;
-}
-function detectDocsDir(cloneDir) {
-  const candidates = [
-    "docs",
-    "documentation",
-    "content",
-    "pages",
-    "src/content",
-    "src/pages",
-    "guide",
-    "guides",
-    ""
-  ];
-  for (const candidate of candidates) {
-    const fullPath = candidate ? join5(cloneDir, candidate) : cloneDir;
-    try {
-      const stat = statSync(fullPath);
-      if (stat.isDirectory() && hasMdFiles(fullPath)) {
-        return candidate;
-      }
-    } catch {
-    }
-  }
-  return "";
-}
-function slugifySegment(seg) {
-  return seg.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-function derivePageId(relPath) {
-  const normalized = relPath.replace(/\\/g, "/");
-  const parts = normalized.split("/");
-  const filename = parts[parts.length - 1];
-  const dirs = parts.slice(0, -1);
-  const base = basename(filename, extname(filename));
-  if (dirs.length === 0 && base.toLowerCase() === "readme") {
-    return "introduction";
-  }
-  if (base.toLowerCase() === "index") {
-    if (dirs.length === 0) return "introduction";
-    return dirs.map(slugifySegment).join("/");
-  }
-  return [...dirs, base].map(slugifySegment).join("/");
-}
-function scanDir(dir, baseDir, primaryOnly, results) {
-  let entries;
-  try {
-    entries = readdirSync2(dir);
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    if (entry.startsWith("_") || entry.startsWith(".") || entry === "node_modules") continue;
-    const fullPath = join5(dir, entry);
-    let stat;
-    try {
-      stat = statSync(fullPath);
-    } catch {
-      continue;
-    }
-    if (stat.isDirectory()) {
-      scanDir(fullPath, baseDir, primaryOnly, results);
-    } else {
-      const ext = extname(entry).toLowerCase();
-      const validExt = primaryOnly ? MD_EXTENSIONS.has(ext) : ALL_DOC_EXTENSIONS.has(ext);
-      if (!validExt) continue;
-      const relPath = relative(baseDir, fullPath);
-      const pageId = derivePageId(relPath);
-      results.push({ absPath: fullPath, relPath, pageId, ext });
-    }
-  }
-}
-function findDocFiles(cloneDir, docsDir) {
-  const baseDir = docsDir ? join5(cloneDir, docsDir) : cloneDir;
-  const primaryResults = [];
-  scanDir(baseDir, baseDir, true, primaryResults);
-  if (primaryResults.length > 0) return primaryResults;
-  const allResults = [];
-  scanDir(baseDir, baseDir, false, allResults);
-  return allResults;
-}
-
-// src/lib/migrate/importer.ts
-import { readFileSync as readFileSync4 } from "fs";
-import { basename as basename2, extname as extname2 } from "path";
-import matter2 from "gray-matter";
-import Anthropic from "@anthropic-ai/sdk";
-function titleFromFilename(relPath) {
-  const filename = relPath.replace(/\\/g, "/").split("/").pop() ?? relPath;
-  const base = basename2(filename, extname2(filename));
-  return base.split(/[-_]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-}
-function extractFirstParagraph(content) {
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    if (trimmed.startsWith("#")) continue;
-    if (trimmed.startsWith("```") || trimmed.startsWith(":::") || trimmed.startsWith("<")) continue;
-    if (trimmed.startsWith("import ") || trimmed.startsWith("export ")) continue;
-    return trimmed.slice(0, 200);
-  }
-  return "";
-}
-function normalizeComponents(body) {
-  let result = body;
-  const importedComponents = /* @__PURE__ */ new Set();
-  result = result.replace(
-    /^import\s+(\w+|\{[^}]+\})\s+from\s+['"][^'"]+['"]\s*;?\s*$/gm,
-    (_, imported) => {
-      const name = imported.trim();
-      if (/^[A-Z]\w*$/.test(name)) importedComponents.add(name);
-      return "";
-    }
-  );
-  for (const name of importedComponents) {
-    result = result.replace(
-      new RegExp(`<${name}(?:\\s[^>]*)?\\/>`, "gm"),
-      `{/* <${name} /> \u2014 imported snippet component */}`
-    );
-    result = result.replace(
-      new RegExp(`<${name}(?:\\s[^>]*)?>([\\s\\S]*?)<\\/${name}>`, "g"),
-      `{/* <${name}> \u2014 imported snippet component */}`
-    );
-  }
-  result = result.replace(/<!--([\s\S]*?)-->/g, (_, inner) => `{/*${inner}*/}`);
-  result = result.replace(/<Tip>([\s\S]*?)<\/Tip>/g, (_, c) => `<Note>${c}</Note>`);
-  result = result.replace(/<Check>([\s\S]*?)<\/Check>/g, (_, c) => `<Note>${c}</Note>`);
-  result = result.replace(/<Danger>([\s\S]*?)<\/Danger>/g, (_, c) => `<Error>${c}</Error>`);
-  result = result.replace(/<Callout(?:\s[^>]*)?>([\s\S]*?)<\/Callout>/g, (_, c) => `<Note>${c}</Note>`);
-  result = result.replace(/:::(\w+)(?:\s+[^\n]*)?\n([\s\S]*?):::/g, (_, type, content) => {
-    const tag = mapAdmonitionToThallyTag(type.toLowerCase());
-    return `<${tag}>
-${content.trim()}
-</${tag}>`;
-  });
-  result = result.replace(
-    /\{%\s*hint\s+style="(\w+)"\s*%\}([\s\S]*?)\{%\s*endhint\s*%\}/g,
-    (_, style, content) => {
-      const tag = mapGitBookStyleToThallyTag(style.toLowerCase());
-      return `<${tag}>
-${content.trim()}
-</${tag}>`;
-    }
-  );
-  result = result.replace(/<AccordionGroup[^>]*>\n?([\s\S]*?)\n?<\/AccordionGroup>/g, (_, inner) => inner.trim());
-  result = result.replace(/<Expandable(\s[^>]*)?>/g, (_, attrs = "") => {
-    const title = attrs.match(/title="([^"]*)"/)?.[1] ?? "Details";
-    return `<Accordion title="${title}">`;
-  });
-  result = result.replace(/<\/Expandable>/g, "</Accordion>");
-  result = result.replace(/<Latex>([\s\S]*?)<\/Latex>/g, (_, inner) => `\`${inner.trim()}\``);
-  result = result.replace(/<(?:ResponseField|ParamField)([^>]*)>/g, (_, attrs) => {
-    const name = attrs.match(/name="([^"]*)"/)?.[1] ?? "";
-    const type = attrs.match(/type="([^"]*)"/)?.[1] ?? "";
-    const required = /\brequired\b/.test(attrs);
-    const def = attrs.match(/default="([^"]*)"/)?.[1];
-    const deprecated = /\bdeprecated\b/.test(attrs);
-    const meta = [
-      type && `\`${type}\``,
-      required && "*(required)*",
-      deprecated && "*(deprecated)*",
-      def !== void 0 && `*(default: \`${def}\`)*`
-    ].filter(Boolean).join(" ");
-    return `
-**\`${name}\`** ${meta}
-
-`;
-  });
-  result = result.replace(/<\/(?:ResponseField|ParamField)>/g, "\n");
-  result = result.replace(/<RequestExample[^>]*>/g, "<CodeGroup>");
-  result = result.replace(/<\/RequestExample>/g, "</CodeGroup>");
-  result = result.replace(/<ResponseExample[^>]*>/g, "<CodeGroup>");
-  result = result.replace(/<\/ResponseExample>/g, "</CodeGroup>");
-  result = result.replace(/<Panel[^>]*>([\s\S]*?)<\/Panel>/g, (_, inner) => inner.trim());
-  result = result.replace(/<Badge[^>]*>([\s\S]*?)<\/Badge>/g, (_, inner) => `**${inner.trim()}**`);
-  result = result.replace(/<Tile(\s[^>]*)?>/g, (_, attrs = "") => `<Card${attrs}>`);
-  result = result.replace(/<\/Tile>/g, "</Card>");
-  result = result.replace(/<View(\s[^>]*)?>/g, (_, attrs = "") => {
-    const title = attrs.match(/title="([^"]*)"/)?.[1] ?? "View";
-    return `<Tab title="${title}">`;
-  });
-  result = result.replace(/<\/View>/g, "</Tab>");
-  result = result.replace(/<Update(\s[^>]*)?>/g, (_, attrs = "") => {
-    const label = attrs.match(/label="([^"]*)"/)?.[1] ?? "";
-    const desc = attrs.match(/description="([^"]*)"/)?.[1] ?? "";
-    return `## ${label}${desc ? `
-
-*${desc}*` : ""}
-
-`;
-  });
-  result = result.replace(/<\/Update>/g, "\n");
-  result = result.replace(/<Prompt[^>]*>([\s\S]*?)<\/Prompt>/g, (_, inner) => {
-    return `\`\`\`text
-${inner.trim()}
-\`\`\``;
-  });
-  result = result.replace(/<Tree[^>]*>/g, "```\n");
-  result = result.replace(/<\/Tree>/g, "\n```");
-  result = result.replace(/<Tree\.Folder[^>]*name="([^"]*)"[^>]*>/g, (_, name) => `\u{1F4C1} ${name}/
-`);
-  result = result.replace(/<\/Tree\.Folder>/g, "");
-  result = result.replace(new RegExp('<Tree\\.File[^>]*name="([^"]*)"[^>]*/>', "g"), (_, name) => `  ${name}
-`);
-  result = result.replace(/<Color[^>]*>/g, "| Name | Value |\n|---|---|\n");
-  result = result.replace(/<\/Color>/g, "");
-  result = result.replace(/<Color\.Row[^>]*title="([^"]*)"[^>]*>/g, (_, title) => `**${title}**
-`);
-  result = result.replace(/<\/Color\.Row>/g, "");
-  result = result.replace(
-    /<Color\.Item[^>]*name="([^"]*)"[^>]*value="([^"]*)"[^>]*\/>/g,
-    (_, name, value) => `| ${name} | \`${value}\` |
-`
-  );
-  result = result.replace(/<Banner[^>]*>([\s\S]*?)<\/Banner>/g, "");
-  result = result.replace(/<Banner[^>]*\/>/g, "");
-  return result;
-}
-function mapAdmonitionToThallyTag(type) {
-  if (type === "warning" || type === "caution") return "Warning";
-  if (type === "danger") return "Error";
-  if (type === "info") return "Info";
-  return "Note";
-}
-function mapGitBookStyleToThallyTag(style) {
-  if (style === "warning") return "Warning";
-  if (style === "danger") return "Error";
-  if (style === "success") return "Note";
-  return "Info";
-}
-var RST_SYSTEM_PROMPT = `You are a documentation converter. Convert the given file content to clean MDX.
-Respond with ONLY valid JSON \u2014 no prose, no markdown fences:
-{
-  "frontmatter": { "title": "string", "description": "string", "keywords": ["..."] },
-  "body": "string \u2014 full MDX body"
-}
-Rules: preserve code blocks with language hints; convert tables to Markdown; convert callout
-boxes to <Note> or <Warning>; preserve heading hierarchy; do not include page title as a heading.`;
-function parseClaudeResponse(text) {
-  try {
-    return JSON.parse(text);
-  } catch {
-    const stripped = text.replace(/^```(?:json)?\s*/m, "").replace(/\s*```\s*$/m, "").trim();
-    return JSON.parse(stripped);
-  }
-}
-async function importFile(file, apiKey) {
-  const ext = file.ext.toLowerCase();
-  if (ext === ".md" || ext === ".mdx") {
-    const raw = readFileSync4(file.absPath, "utf8");
-    const parsed = matter2(raw);
-    const fmTitle = parsed.data.title ?? "";
-    const fmDesc = parsed.data.description ?? "";
-    const fmKeywords = parsed.data.keywords;
-    const title = fmTitle || titleFromFilename(file.relPath);
-    const description = fmDesc || extractFirstParagraph(parsed.content);
-    const keywords = Array.isArray(fmKeywords) ? fmKeywords : [];
-    const openapi = parsed.data.openapi;
-    const body = normalizeComponents(parsed.content);
-    if (openapi && !body.trim()) return null;
-    return { pageId: file.pageId, frontmatter: { title, description, keywords }, body };
-  }
-  if (!apiKey) {
-    throw new Error(`Skipping non-Markdown file (no API key): ${file.relPath}`);
-  }
-  const content = readFileSync4(file.absPath, "utf8");
-  const client = new Anthropic({ apiKey });
-  const message = await client.messages.create({
-    model: "claude-sonnet-4-6",
-    max_tokens: 4096,
-    system: RST_SYSTEM_PROMPT,
-    messages: [
-      {
-        role: "user",
-        content: `Convert this documentation file to MDX.
-
-File: ${file.relPath}
-
-Content:
-${content.slice(0, 8e4)}`
-      }
-    ]
-  });
-  const responseText = message.content.filter((block) => block.type === "text").map((block) => block.text).join("");
-  const claudeResult = parseClaudeResponse(responseText);
-  return {
-    pageId: file.pageId,
-    frontmatter: claudeResult.frontmatter,
-    body: claudeResult.body
-  };
-}
-
-// src/lib/migrate/nav-builder.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
-import { join as join6 } from "path";
-function titleCase(str) {
-  return str.split("-").map((word) => {
-    if (word.toLowerCase() === "api") return "API";
-    if (word.toLowerCase() === "sdk") return "SDK";
-    if (word.toLowerCase() === "cli") return "CLI";
-    if (word.toLowerCase() === "ui") return "UI";
-    if (word.toLowerCase() === "faq") return "FAQ";
-    return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
-  }).join(" ");
-}
-function buildNavStructure(pages) {
-  const seen = /* @__PURE__ */ new Set();
-  const ordered = [];
-  for (const p of pages) {
-    if (!seen.has(p.pageId)) {
-      seen.add(p.pageId);
-      ordered.push(p.pageId);
-    }
-  }
-  const depth1Segments = /* @__PURE__ */ new Set();
-  for (const id of ordered) {
-    const parts = id.split("/");
-    if (parts.length > 1) {
-      depth1Segments.add(parts[0]);
-    }
-  }
-  const rootOnlyPages = ordered.filter((id) => !id.includes("/"));
-  const useSingleTab = depth1Segments.size === 0 || depth1Segments.size === 1 && rootOnlyPages.length === 0;
-  let tabs;
-  if (useSingleTab) {
-    const groups = buildGroups(ordered, null);
-    tabs = [{ tab: "Overview", groups }];
-  } else {
-    tabs = [];
-    if (rootOnlyPages.length > 0) {
-      const groups = buildGroups(rootOnlyPages, null);
-      tabs.push({ tab: "Overview", groups });
-    }
-    for (const seg of depth1Segments) {
-      const tabPages = ordered.filter((id) => id.startsWith(seg + "/") || id === seg);
-      const groups = buildGroups(tabPages, seg);
-      tabs.push({ tab: titleCase(seg), groups });
-    }
-  }
-  tabs.push({ tab: "Changelog", href: "/changelog" });
-  return { tabs };
-}
-function buildGroups(pageIds, tabSegment) {
-  const groupMap = /* @__PURE__ */ new Map();
-  for (const id of pageIds) {
-    let groupName;
-    if (tabSegment === null) {
-      groupName = "Overview";
-    } else {
-      const rel = id.startsWith(tabSegment + "/") ? id.slice(tabSegment.length + 1) : id;
-      const relParts = rel.split("/");
-      groupName = relParts.length === 1 ? titleCase(tabSegment) : titleCase(relParts[0]);
-    }
-    if (!groupMap.has(groupName)) groupMap.set(groupName, []);
-    groupMap.get(groupName).push(id);
-  }
-  const groups = [];
-  for (const [groupName, groupPages] of groupMap) {
-    const sorted = [...groupPages];
-    const introIdx = sorted.indexOf("introduction");
-    if (introIdx > 0) {
-      sorted.splice(introIdx, 1);
-      sorted.unshift("introduction");
-    }
-    groups.push({ group: groupName, pages: sorted });
-  }
-  return groups;
-}
-function detectPlatform(cloneDir) {
-  if (existsSync5(join6(cloneDir, "mint.json"))) return "mintlify";
-  if (existsSync5(join6(cloneDir, "docs.json"))) {
-    try {
-      const parsed = JSON.parse(readFileSync5(join6(cloneDir, "docs.json"), "utf8"));
-      if (Array.isArray(parsed.tabs)) return "thally";
-      const schema = parsed.$schema;
-      if (schema?.includes("mintlify") || "navigation" in parsed) return "mintlify";
-    } catch {
-    }
-  }
-  if (existsSync5(join6(cloneDir, "docusaurus.config.js")) || existsSync5(join6(cloneDir, "docusaurus.config.ts")) || existsSync5(join6(cloneDir, "docusaurus.config.mjs"))) return "docusaurus";
-  if (existsSync5(join6(cloneDir, "SUMMARY.md"))) return "gitbook";
-  if (existsSync5(join6(cloneDir, ".vitepress"))) return "vitepress";
-  if (existsSync5(join6(cloneDir, "astro.config.mjs")) || existsSync5(join6(cloneDir, "astro.config.ts"))) return "starlight";
-  if (existsSync5(join6(cloneDir, "_meta.json")) || existsSync5(join6(cloneDir, "pages", "_meta.json"))) return "nextra";
-  return "unknown";
-}
-function slugify2(s) {
-  return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-function normalizePageRef(ref, docsDir) {
-  let r = ref;
-  if (docsDir && r.startsWith(docsDir + "/")) r = r.slice(docsDir.length + 1);
-  r = r.replace(/\.(mdx?|rst|txt)$/, "");
-  const parts = r.split("/");
-  const last = parts[parts.length - 1].toLowerCase();
-  if (last === "index" || last === "readme") {
-    return parts.length === 1 ? "introduction" : parts.slice(0, -1).map(slugify2).join("/");
-  }
-  return parts.map(slugify2).join("/");
-}
-function convertMintTabs(tabs, docsDir) {
-  if (tabs.length === 0) return null;
-  function convertPageRef(page) {
-    if (typeof page === "string") return normalizePageRef(page, docsDir);
-    if (page !== null && typeof page === "object" && "group" in page && "pages" in page) {
-      const p = page;
-      return {
-        group: String(p.group),
-        pages: (p.pages ?? []).map(convertPageRef)
-      };
-    }
-    return String(page);
-  }
-  const resultTabs = tabs.map((item) => {
-    if (item.href) return { tab: String(item.tab), href: String(item.href) };
-    const groups = (item.groups ?? []).map((g) => ({
-      group: String(g.group),
-      pages: (g.pages ?? []).map(convertPageRef)
-    }));
-    return { tab: String(item.tab), groups };
-  });
-  if (!resultTabs.some((t) => t.tab === "Changelog")) {
-    resultTabs.push({ tab: "Changelog", href: "/changelog" });
-  }
-  return { tabs: resultTabs };
-}
-function parseMintConfig(config, docsDir) {
-  const nav = config.navigation;
-  if (nav && typeof nav === "object" && !Array.isArray(nav)) {
-    const v3Tabs = nav.tabs;
-    if (Array.isArray(v3Tabs) && v3Tabs.length > 0) return convertMintTabs(v3Tabs, docsDir);
-  }
-  if (!Array.isArray(nav) || nav.length === 0) return null;
-  if ("tab" in nav[0]) return convertMintTabs(nav, docsDir);
-  function convertPageRef(page) {
-    if (typeof page === "string") return normalizePageRef(page, docsDir);
-    if (page !== null && typeof page === "object" && "group" in page && "pages" in page) {
-      const p = page;
-      return { group: String(p.group), pages: (p.pages ?? []).map(convertPageRef) };
-    }
-    return String(page);
-  }
-  const groups = nav.map((item) => ({
-    group: String(item.group ?? ""),
-    pages: (item.pages ?? []).map(convertPageRef)
-  }));
-  return { tabs: [{ tab: "Docs", groups }, { tab: "Changelog", href: "/changelog" }] };
-}
-function parseGitBookSummary(cloneDir, docsDir) {
-  const candidates = [join6(cloneDir, "SUMMARY.md")];
-  if (docsDir) candidates.push(join6(cloneDir, docsDir, "SUMMARY.md"));
-  let raw = "";
-  for (const p of candidates) {
-    if (existsSync5(p)) {
-      raw = readFileSync5(p, "utf8");
-      break;
-    }
-  }
-  if (!raw) return null;
-  const groups = [];
-  let currentGroupName = "Overview";
-  let currentPages = [];
-  for (const line of raw.split("\n")) {
-    const groupMatch = line.match(/^##\s+(.+)/);
-    if (groupMatch) {
-      if (currentPages.length > 0) groups.push({ group: currentGroupName, pages: currentPages });
-      currentGroupName = groupMatch[1].trim();
-      currentPages = [];
-      continue;
-    }
-    const pageMatch = line.match(/^\*\s+\[.+?\]\((.+?)\)/);
-    if (pageMatch) {
-      const ref = pageMatch[1].trim();
-      if (ref.startsWith("http")) continue;
-      currentPages.push(normalizePageRef(ref, docsDir));
-    }
-  }
-  if (currentPages.length > 0) groups.push({ group: currentGroupName, pages: currentPages });
-  if (groups.length === 0) return null;
-  return { tabs: [{ tab: "Docs", groups }, { tab: "Changelog", href: "/changelog" }] };
-}
-function parseNextraMeta(cloneDir, docsDir) {
-  const baseDir = docsDir ? join6(cloneDir, docsDir) : cloneDir;
-  const metaPath = join6(baseDir, "_meta.json");
-  if (!existsSync5(metaPath)) return null;
-  try {
-    const meta = JSON.parse(readFileSync5(metaPath, "utf8"));
-    const pages = [];
-    for (const [key, value] of Object.entries(meta)) {
-      if (typeof value === "object" && value !== null) {
-        const v = value;
-        if (v.type === "separator" || v.type === "menu") continue;
-      }
-      pages.push(key === "index" ? "introduction" : slugify2(key));
-    }
-    if (pages.length === 0) return null;
-    return {
-      tabs: [
-        { tab: "Docs", groups: [{ group: "Overview", pages }] },
-        { tab: "Changelog", href: "/changelog" }
-      ]
-    };
-  } catch {
-    return null;
-  }
-}
-var PLATFORM_LABELS = {
-  mintlify: "Mintlify",
-  docusaurus: "Docusaurus",
-  gitbook: "GitBook",
-  nextra: "Nextra",
-  vitepress: "VitePress",
-  starlight: "Starlight (Astro)",
-  thally: "Thally",
-  unknown: "unknown"
-};
-function detectNavFromConfig(cloneDir, docsDir, platform) {
-  const detected = platform ?? detectPlatform(cloneDir);
-  const label = PLATFORM_LABELS[detected];
-  switch (detected) {
-    case "thally": {
-      try {
-        const parsed = JSON.parse(
-          readFileSync5(join6(cloneDir, "docs.json"), "utf8")
-        );
-        console.log(`  \u{1F4CB} Detected ${label} \u2014 using docs.json navigation as-is`);
-        return parsed;
-      } catch {
-        return null;
-      }
-    }
-    case "mintlify": {
-      for (const file of ["docs.json", "mint.json"]) {
-        const p = join6(cloneDir, file);
-        if (!existsSync5(p)) continue;
-        try {
-          const config = JSON.parse(readFileSync5(p, "utf8"));
-          const nav = parseMintConfig(config, docsDir);
-          if (nav) {
-            console.log(`  \u{1F4CB} Detected ${label} (${file}) \u2014 converting navigation`);
-            return nav;
-          }
-        } catch {
-        }
-      }
-      return null;
-    }
-    case "gitbook": {
-      const nav = parseGitBookSummary(cloneDir, docsDir);
-      if (nav) console.log(`  \u{1F4CB} Detected ${label} (SUMMARY.md) \u2014 converting navigation`);
-      return nav;
-    }
-    case "nextra": {
-      const nav = parseNextraMeta(cloneDir, docsDir);
-      if (nav) console.log(`  \u{1F4CB} Detected ${label} (_meta.json) \u2014 converting navigation`);
-      return nav;
-    }
-    case "docusaurus":
-    case "vitepress":
-    case "starlight":
-      console.log(`  \u{1F4CB} Detected ${label} \u2014 nav config is JavaScript, using directory structure`);
-      return null;
-    default:
-      return null;
-  }
-}
-
-// src/lib/migrate/index.ts
-function mergeDocsJson(existing, incoming) {
-  const existingTabNames = new Set(existing.tabs.map((t) => t.tab));
-  const merged = { tabs: [...existing.tabs.filter((t) => t.tab !== "Changelog")] };
-  if (existing.ai || incoming.ai) {
-    merged.ai = { ...incoming.ai, ...existing.ai };
-  }
-  for (const tab of incoming.tabs) {
-    if (tab.tab === "Changelog") continue;
-    if (existingTabNames.has(tab.tab)) {
-      const existingTab = merged.tabs.find((t) => t.tab === tab.tab);
-      if (existingTab.groups && tab.groups) {
-        const existingGroupNames = new Set(existingTab.groups.map((g) => g.group));
-        for (const group of tab.groups) {
-          if (existingGroupNames.has(group.group)) {
-            const eg = existingTab.groups.find((g) => g.group === group.group);
-            const existingPageSet = new Set(eg.pages.map((p) => typeof p === "string" ? p : p.group));
-            for (const page of group.pages) {
-              const key = typeof page === "string" ? page : page.group;
-              if (!existingPageSet.has(key)) eg.pages.push(page);
-            }
-          } else {
-            existingTab.groups.push(group);
-          }
-        }
-      } else if (tab.groups) {
-        existingTab.groups = tab.groups;
-      }
-    } else {
-      merged.tabs.push(tab);
-    }
-  }
-  merged.tabs.push({ tab: "Changelog", href: "/changelog" });
-  return merged;
-}
-function injectApiTab(config, specFilename) {
-  const apiTab = { tab: "API Reference", api: { source: `/${specFilename}` } };
-  const tabs = config.tabs.filter((t) => {
-    if (t.tab.toLowerCase().includes("api")) return false;
-    return true;
-  });
-  const changelogIdx = tabs.findIndex((t) => t.tab === "Changelog");
-  if (changelogIdx >= 0) {
-    tabs.splice(changelogIdx, 0, apiTab);
-  } else {
-    tabs.push(apiTab);
-  }
-  return { ...config, tabs };
-}
-function installDeps2(targetDir) {
-  execSync3("npm install", { cwd: targetDir, stdio: "inherit" });
-}
-function initGit2(targetDir) {
-  try {
-    execSync3("git init", { cwd: targetDir, stdio: "inherit" });
-    execSync3("git add -A", { cwd: targetDir, stdio: "inherit" });
-    execSync3('git commit -m "Initial commit from create-thally-docs"', { cwd: targetDir, stdio: "inherit" });
-  } catch {
-  }
-}
-async function migrateDocs(opts) {
-  const { sourceUrl, projectDir: rawProjectDir, into, apiKey, projectName } = opts;
-  const projectDir = resolve2(rawProjectDir);
-  const source = parseGitHubUrl(sourceUrl);
-  if (opts.branch) source.branch = opts.branch;
-  if (!into) {
-    console.log(`  \u{1F3D7}  Scaffolding new project at ${projectDir}...`);
-    await scaffold({
-      projectDir,
-      projectName: projectName ?? "My Docs",
-      description: `Documentation migrated from ${source.owner}/${source.repo}`,
-      brandPreset: "primary",
-      repoUrl: `https://github.com/${source.owner}/${source.repo}`,
-      doInstall: false
-    });
-  } else {
-    if (!existsSync6(projectDir)) {
-      throw new Error(`Project directory "${projectDir}" does not exist.`);
-    }
-  }
-  const tmpBase = mkdtempSync(join7(tmpdir(), "thally-migrate-"));
-  const cloneDir = join7(tmpBase, "repo");
-  console.log(`  \u{1F4E6} Cloning ${source.owner}/${source.repo}...`);
-  try {
-    await cloneRepo(source, cloneDir);
-    const docsDir = opts.docsDir ?? (source.docsDir || detectDocsDir(cloneDir));
-    const docFiles = findDocFiles(cloneDir, docsDir);
-    const docsDirLabel = docsDir ? `${docsDir}/` : "repo root";
-    console.log(`  \u{1F4C4} Found ${docFiles.length} files in ${docsDirLabel}`);
-    if (docFiles.length === 0) {
-      console.warn("  \u26A0  No doc files found. Check the URL and try again.");
-      return { pagesWritten: 0, projectDir };
-    }
-    const platform = detectPlatform(cloneDir);
-    const detectedNav = detectNavFromConfig(cloneDir, docsDir, platform);
-    const openApiSpec = detectOpenApiSpec(cloneDir);
-    if (openApiSpec) {
-      console.log(`  \u{1F50C} Found OpenAPI spec: ${openApiSpec.filename}`);
-    }
-    const limit = pLimit(5);
-    let doneCount = 0;
-    const imported = (await Promise.all(
-      docFiles.map(
-        (file) => limit(async () => {
-          try {
-            const result = await importFile(file, apiKey);
-            doneCount++;
-            if (result) {
-              console.log(`    [${doneCount}/${docFiles.length}] ${result.pageId}`);
-            } else {
-              console.log(`    [${doneCount}/${docFiles.length}] ${file.pageId} (openapi \u2014 wired via spec)`);
-            }
-            return result;
-          } catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (msg.includes("no API key")) {
-              console.warn(`    \u26A0  ${msg}`);
-            } else {
-              console.warn(`    \u26A0  Skipping ${file.relPath}: ${msg}`);
-            }
-            doneCount++;
-            return null;
-          }
-        })
-      )
-    )).filter(Boolean);
-    const pageIdSeen = /* @__PURE__ */ new Set();
-    const deduped = imported.filter((p) => {
-      if (pageIdSeen.has(p.pageId)) return false;
-      pageIdSeen.add(p.pageId);
-      return true;
-    });
-    const contentDir = join7(projectDir, "src", "content");
-    let pagesWritten = 0;
-    for (const page of deduped) {
-      const filePath = join7(contentDir, `${page.pageId}.mdx`);
-      mkdirSync3(dirname2(filePath), { recursive: true });
-      const mdx = [
-        "---",
-        `title: "${page.frontmatter.title.replace(/"/g, '\\"')}"`,
-        `description: "${page.frontmatter.description.replace(/"/g, '\\"')}"`,
-        page.frontmatter.keywords.length > 0 ? `keywords: [${page.frontmatter.keywords.map((k) => `"${k.replace(/"/g, '\\"')}"`).join(", ")}]` : null,
-        "---",
-        "",
-        page.body
-      ].filter((line) => line !== null).join("\n");
-      writeFileSync5(filePath, mdx, "utf8");
-      pagesWritten++;
-    }
-    let finalNav = detectedNav ?? buildNavStructure(deduped);
-    if (openApiSpec) {
-      const publicDir = join7(projectDir, "public");
-      mkdirSync3(publicDir, { recursive: true });
-      copyFileSync(openApiSpec.absPath, join7(publicDir, openApiSpec.filename));
-      console.log(`  \u{1F4CB} Copied ${openApiSpec.filename} \u2192 public/${openApiSpec.filename}`);
-      finalNav = injectApiTab(finalNav, openApiSpec.filename);
-    }
-    if (into && existsSync6(join7(projectDir, "docs.json"))) {
-      const existing = readDocsJson(projectDir);
-      const merged = mergeDocsJson(existing, finalNav);
-      writeDocsJson(projectDir, merged);
-    } else {
-      writeDocsJson(projectDir, finalNav);
-    }
-    if (!into) {
-      installDeps2(projectDir);
-      initGit2(projectDir);
-    }
-    return { pagesWritten, projectDir };
-  } finally {
-    rmSync(tmpBase, { recursive: true, force: true });
-  }
-}
-
-// src/tools/migrate-docs.ts
+import { migrateDocs } from "create-thally-docs/migrate";
 var migrateDocsSchema = z6.object({
-  sourceUrl: z6.string().describe("GitHub URL of the docs repo to migrate"),
+  sourceUrl: z6.string().describe("GitHub repository URL or public documentation URL to migrate"),
   projectDir: z6.string().describe("Path for new project or existing project dir"),
   into: z6.boolean().optional().default(false).describe("Migrate into existing project instead of scaffolding"),
   branch: z6.string().optional().describe("Git branch (default: auto-detect)"),
   docsDir: z6.string().optional().describe("Docs subdirectory in repo (default: auto-detect)"),
-  apiKey: z6.string().optional().describe("Anthropic API key for non-Markdown file conversion")
+  apiKey: z6.string().optional().describe("Anthropic API key for non-Markdown file conversion"),
+  maxPages: z6.number().int().min(1).max(1e3).optional().describe("Maximum public URL pages to import")
 });
 async function handleMigrateDocs(input) {
   const apiKey = input.apiKey ?? process.env.ANTHROPIC_API_KEY;
@@ -1388,6 +546,7 @@ async function handleMigrateDocs(input) {
     apiKey,
     branch: input.branch,
     docsDir: input.docsDir,
+    maxPages: input.maxPages,
     yes: true
   });
   return `Migration complete! ${result.pagesWritten} pages written to ${result.projectDir}/src/content/`;
@@ -1395,9 +554,9 @@ async function handleMigrateDocs(input) {
 
 // src/tools/search-docs.ts
 import { z as z7 } from "zod";
-import { readdirSync as readdirSync3, statSync as statSync2, readFileSync as readFileSync7, existsSync as existsSync7 } from "fs";
-import { join as join8, relative as relative2, extname as extname3 } from "path";
-import matter3 from "gray-matter";
+import { readdirSync as readdirSync2, statSync, readFileSync as readFileSync4, existsSync as existsSync4 } from "fs";
+import { join as join5, relative, extname } from "path";
+import matter2 from "gray-matter";
 var searchDocsSchema = z7.object({
   projectDir: z7.string().describe("Path to the Thally project root"),
   query: z7.string().describe("Search query"),
@@ -1406,17 +565,17 @@ var searchDocsSchema = z7.object({
 function scanMdxFiles(dir, results) {
   let entries;
   try {
-    entries = readdirSync3(dir);
+    entries = readdirSync2(dir);
   } catch {
     return;
   }
   for (const entry of entries) {
-    const fullPath = join8(dir, entry);
+    const fullPath = join5(dir, entry);
     try {
-      const stat = statSync2(fullPath);
+      const stat = statSync(fullPath);
       if (stat.isDirectory()) {
         scanMdxFiles(fullPath, results);
-      } else if (extname3(entry).toLowerCase() === ".mdx") {
+      } else if (extname(entry).toLowerCase() === ".mdx") {
         results.push(fullPath);
       }
     } catch {
@@ -1429,15 +588,15 @@ function scoreFiles(files, contentDir, query) {
   for (const filePath of files) {
     let raw;
     try {
-      raw = readFileSync7(filePath, "utf8");
+      raw = readFileSync4(filePath, "utf8");
     } catch {
       continue;
     }
-    const { data, content } = matter3(raw);
+    const { data, content } = matter2(raw);
     const title = data.title ?? "";
     const description = data.description ?? "";
     const keywords = data.keywords ?? [];
-    const pageId = relative2(contentDir, filePath).replace(/\.mdx$/, "").replace(/\\/g, "/");
+    const pageId = relative(contentDir, filePath).replace(/\.mdx$/, "").replace(/\\/g, "/");
     let score = 0;
     for (const term of terms) {
       if (title.toLowerCase().includes(term)) score += 3;
@@ -1454,8 +613,8 @@ function scoreFiles(files, contentDir, query) {
 }
 async function handleSearchDocs(input) {
   const { projectDir, query, limit = 5 } = input;
-  const contentDir = join8(projectDir, "src", "content");
-  if (!existsSync7(contentDir)) {
+  const contentDir = join5(projectDir, "src", "content");
+  if (!existsSync4(contentDir)) {
     throw new Error(`Content directory not found: ${contentDir}`);
   }
   const files = [];
@@ -1550,23 +709,23 @@ async function handleAgentReadiness(input) {
 
 // src/tools/read-page.ts
 import { z as z10 } from "zod";
-import { existsSync as existsSync8, readFileSync as readFileSync8 } from "fs";
-import { join as join9 } from "path";
-import matter4 from "gray-matter";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { join as join6 } from "path";
+import matter3 from "gray-matter";
 var readPageSchema = z10.object({
   projectDir: z10.string().describe("Path to the Thally project root"),
   pageId: z10.string().describe('Page ID, e.g. "guides/authentication"')
 });
 async function handleReadPage(input) {
   const { projectDir, pageId } = input;
-  const contentDir = join9(projectDir, "src", "content");
+  const contentDir = join6(projectDir, "src", "content");
   const candidates = [
-    join9(contentDir, `${pageId}.mdx`),
-    join9(contentDir, `${pageId}/index.mdx`)
+    join6(contentDir, `${pageId}.mdx`),
+    join6(contentDir, `${pageId}/index.mdx`)
   ];
   let filePath = null;
   for (const c of candidates) {
-    if (existsSync8(c)) {
+    if (existsSync5(c)) {
       filePath = c;
       break;
     }
@@ -1574,8 +733,8 @@ async function handleReadPage(input) {
   if (!filePath) {
     throw new Error(`Page not found: "${pageId}". No file at src/content/${pageId}.mdx`);
   }
-  const raw = readFileSync8(filePath, "utf8");
-  const { data, content } = matter4(raw);
+  const raw = readFileSync5(filePath, "utf8");
+  const { data, content } = matter3(raw);
   const title = data.title ?? pageId;
   const description = data.description ?? "";
   const lines = [`# ${title}`, `*${pageId}*`, ""];
@@ -1589,9 +748,9 @@ async function handleReadPage(input) {
 
 // src/tools/get-context.ts
 import { z as z11 } from "zod";
-import { existsSync as existsSync9, readFileSync as readFileSync9 } from "fs";
-import { join as join10 } from "path";
-import matter5 from "gray-matter";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
+import { join as join7 } from "path";
+import matter4 from "gray-matter";
 var getContextSchema = z11.object({
   projectDir: z11.string().describe("Path to the Thally project root"),
   topic: z11.string().describe("Topic or question to find relevant docs for"),
@@ -1599,8 +758,8 @@ var getContextSchema = z11.object({
 });
 async function handleGetContext(input) {
   const { projectDir, topic, maxTokens = 4e3 } = input;
-  const contentDir = join10(projectDir, "src", "content");
-  if (!existsSync9(contentDir)) {
+  const contentDir = join7(projectDir, "src", "content");
+  if (!existsSync6(contentDir)) {
     throw new Error(`Content directory not found: ${contentDir}`);
   }
   const files = [];
@@ -1614,14 +773,14 @@ async function handleGetContext(input) {
   const sections = [];
   for (const result of scored) {
     const candidates = [
-      join10(contentDir, `${result.pageId}.mdx`),
-      join10(contentDir, `${result.pageId}/index.mdx`)
+      join7(contentDir, `${result.pageId}.mdx`),
+      join7(contentDir, `${result.pageId}/index.mdx`)
     ];
     let content = "";
     for (const c of candidates) {
-      if (existsSync9(c)) {
-        const raw = readFileSync9(c, "utf8");
-        const { content: body } = matter5(raw);
+      if (existsSync6(c)) {
+        const raw = readFileSync6(c, "utf8");
+        const { content: body } = matter4(raw);
         content = body.trim();
         break;
       }
@@ -1645,9 +804,9 @@ async function handleGetContext(input) {
 
 // src/tools/lint-project.ts
 import { z as z12 } from "zod";
-import { existsSync as existsSync10, readFileSync as readFileSync10 } from "fs";
-import { join as join11 } from "path";
-import matter6 from "gray-matter";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
+import { join as join8 } from "path";
+import matter5 from "gray-matter";
 var lintProjectSchema = z12.object({
   projectDir: z12.string().describe("Path to the Thally project root"),
   fix: z12.boolean().optional().default(false).describe("Auto-fix issues where possible (adds orphan pages to nav)")
@@ -1678,9 +837,9 @@ function addOrphanToNav(projectDir, pageId) {
 }
 async function handleLintProject(input) {
   const { projectDir, fix = false } = input;
-  const contentDir = join11(projectDir, "src", "content");
+  const contentDir = join8(projectDir, "src", "content");
   const issues = [];
-  if (!existsSync10(join11(projectDir, "docs.json"))) {
+  if (!existsSync7(join8(projectDir, "docs.json"))) {
     throw new Error(`Not a Thally project: docs.json not found in ${projectDir}`);
   }
   const config = readDocsJson(projectDir);
@@ -1699,10 +858,10 @@ async function handleLintProject(input) {
   }
   for (const pageId of navPageIds) {
     const candidates = [
-      join11(contentDir, `${pageId}.mdx`),
-      join11(contentDir, `${pageId}/index.mdx`)
+      join8(contentDir, `${pageId}.mdx`),
+      join8(contentDir, `${pageId}/index.mdx`)
     ];
-    if (!candidates.some((c) => existsSync10(c))) {
+    if (!candidates.some((c) => existsSync7(c))) {
       issues.push({
         severity: "error",
         message: `"${pageId}" is in docs.json but has no MDX file`,
@@ -1711,7 +870,7 @@ async function handleLintProject(input) {
     }
   }
   const allFiles = [];
-  if (existsSync10(contentDir)) {
+  if (existsSync7(contentDir)) {
     scanMdxFiles(contentDir, allFiles);
   }
   const fixedOrphans = [];
@@ -1729,8 +888,8 @@ async function handleLintProject(input) {
     let data = {};
     let content = "";
     try {
-      const raw = readFileSync10(filePath, "utf8");
-      const parsed = matter6(raw);
+      const raw = readFileSync7(filePath, "utf8");
+      const parsed = matter5(raw);
       data = parsed.data;
       content = parsed.content;
     } catch {
@@ -1786,11 +945,11 @@ async function handleLintProject(input) {
 
 // src/tools/translate-docs.ts
 import { z as z13 } from "zod";
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync7, existsSync as existsSync11, mkdirSync as mkdirSync4 } from "fs";
-import { join as join12, dirname as dirname3 } from "path";
-import matter7 from "gray-matter";
-import Anthropic2 from "@anthropic-ai/sdk";
-import pLimit2 from "p-limit";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync8, mkdirSync as mkdirSync3 } from "fs";
+import { join as join9, dirname as dirname2 } from "path";
+import matter6 from "gray-matter";
+import Anthropic from "@anthropic-ai/sdk";
+import pLimit from "p-limit";
 var translateDocsSchema = z13.object({
   projectDir: z13.string().describe("Path to the Thally project directory"),
   locale: z13.string().describe('Target locale code, e.g. "es", "fr"'),
@@ -1800,8 +959,8 @@ var translateDocsSchema = z13.object({
   model: z13.string().optional().default("claude-sonnet-4-6").describe("Claude model to use for translation")
 });
 function readDocsJson2(projectDir) {
-  const docsPath = join12(projectDir, "docs.json");
-  const raw = readFileSync11(docsPath, "utf8");
+  const docsPath = join9(projectDir, "docs.json");
+  const raw = readFileSync8(docsPath, "utf8");
   return JSON.parse(raw);
 }
 function collectPageIds(pages) {
@@ -1843,12 +1002,12 @@ function getAllPageIds(config) {
   return { ids, hrefOnlyPages };
 }
 function findSourceFile(projectDir, pageId) {
-  const contentRoot = join12(projectDir, "src", "content");
+  const contentRoot = join9(projectDir, "src", "content");
   const candidates = [
-    join12(contentRoot, `${pageId}.mdx`),
-    join12(contentRoot, `${pageId}/index.mdx`)
+    join9(contentRoot, `${pageId}.mdx`),
+    join9(contentRoot, `${pageId}/index.mdx`)
   ];
-  return candidates.find((p) => existsSync11(p)) ?? null;
+  return candidates.find((p) => existsSync8(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.
 
@@ -1900,7 +1059,7 @@ async function handleTranslateDocs(input) {
   }
   const { ids: allPageIds, hrefOnlyPages } = getAllPageIds(config);
   const targetPageIds = pages ?? allPageIds;
-  const contentRoot = join12(projectDir, "src", "content");
+  const contentRoot = join9(projectDir, "src", "content");
   const toTranslate = [];
   const skipped = [];
   for (const pageId of targetPageIds) {
@@ -1910,8 +1069,8 @@ async function handleTranslateDocs(input) {
       continue;
     }
     const relativeFromContent = sourceFile.slice(contentRoot.length + 1);
-    const targetFile = join12(contentRoot, locale, relativeFromContent);
-    if (existsSync11(targetFile) && !force) {
+    const targetFile = join9(contentRoot, locale, relativeFromContent);
+    if (existsSync8(targetFile) && !force) {
       skipped.push(`${pageId} (already translated)`);
       continue;
     }
@@ -1920,21 +1079,21 @@ async function handleTranslateDocs(input) {
   if (toTranslate.length === 0) {
     return `Nothing to translate. ${skipped.length} page(s) skipped.`;
   }
-  const client = new Anthropic2({ apiKey });
-  const limit = pLimit2(3);
+  const client = new Anthropic({ apiKey });
+  const limit = pLimit(3);
   const results = [];
   await Promise.all(
     toTranslate.map(
       ({ pageId, sourceFile, targetFile }) => limit(async () => {
         try {
-          const sourceContent = readFileSync11(sourceFile, "utf8");
-          const parsed = matter7(sourceContent);
+          const sourceContent = readFileSync8(sourceFile, "utf8");
+          const parsed = matter6(sourceContent);
           if (!parsed.data.title) {
             console.warn(`[translate] ${pageId}: missing title in frontmatter`);
           }
           const translated = await translatePage(sourceContent, targetLocale.label, locale, model, client);
-          mkdirSync4(dirname3(targetFile), { recursive: true });
-          writeFileSync7(targetFile, translated + "\n", "utf8");
+          mkdirSync3(dirname2(targetFile), { recursive: true });
+          writeFileSync6(targetFile, translated + "\n", "utf8");
           results.push({ pageId, success: true });
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);