@thallylabs/mcp 0.8.0 → 0.9.0

package/dist/tools.js

@@ -2,258 +2,18 @@
 import { z } from "zod";
 
 // src/lib/scaffold.ts
-import { existsSync, mkdirSync, readdirSync, writeFileSync, readFileSync, cpSync } from "fs";
-import { resolve, join } from "path";
-import { execSync } from "child_process";
-import { Readable, pipeline } from "stream";
-import { promisify } from "util";
-import tar from "tar";
-var pipelineAsync = promisify(pipeline);
-var MCP_TEMPLATE_REPOSITORY = "thallylabs/docs";
-var TARBALL_URL = `https://codeload.github.com/${MCP_TEMPLATE_REPOSITORY}/tar.gz/main`;
-var MCP_EXCLUDE_PATHS = [
-  "/cli/",
-  "/packages/",
-  "/node_modules/",
-  "/.git/",
-  "/thally-track.yml",
-  "/CODEOWNERS",
-  "/CLAUDE.md",
-  "/notes/"
-];
-function shouldIncludeMcpTemplatePath(path) {
-  return !MCP_EXCLUDE_PATHS.some((excluded) => path.includes(excluded));
-}
-var STARTER_PAGES = {
-  "introduction.mdx": `---
-title: Introduction
-description: Welcome to {NAME} documentation.
----
-
-## Welcome
-
-This is the home page of your **{NAME}** documentation site, powered by [Thally](https://github.com/thallylabs/thally).
-
-Get started by editing this file at \`src/content/introduction.mdx\`.
-`,
-  "quickstart.mdx": `---
-title: Quickstart
-description: Get up and running with {NAME} in under 5 minutes.
----
-
-## Installation
-
-\`\`\`bash
-npm install {SLUG}
-\`\`\`
-
-## Basic usage
-
-\`\`\`ts
-import { create } from '{SLUG}'
-
-const client = create({ apiKey: 'your-api-key' })
-\`\`\`
-
-That's it \u2014 you're ready to go!
-`
-};
-function buildStarterDocsJson({
-  enableAiChat,
-  repoUrl,
-  i18nLocales
-}) {
-  const config = {};
-  if (enableAiChat) {
-    config.ai = { chat: true };
-  }
-  if (repoUrl) {
-    config.navbar = {
-      links: [{ label: "GitHub", href: repoUrl, type: "github" }],
-      primary: { label: "Get started", href: "/quickstart" }
-    };
-  }
-  if (i18nLocales && i18nLocales.length > 0) {
-    config.i18n = {
-      defaultLocale: "en",
-      locales: [{ code: "en", label: "English" }, ...i18nLocales]
-    };
-  }
-  config.tabs = [
-    {
-      tab: "Overview",
-      groups: [{ group: "Getting Started", pages: ["introduction", "quickstart"] }]
-    },
-    { tab: "API Reference", api: { source: "openapi.yaml" } },
-    { tab: "Changelog", href: "/changelog" }
-  ];
-  return JSON.stringify(config, null, 2) + "\n";
-}
-function slugify(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-function run(cmd, cwd) {
-  execSync(cmd, { cwd, stdio: "inherit" });
-}
-async function downloadTemplate(targetDir) {
-  const response = await fetch(TARBALL_URL);
-  if (!response.ok) {
-    throw new Error(`Failed to download template: ${response.status} ${response.statusText}`);
-  }
-  if (!response.body) {
-    throw new Error("Response body is empty");
-  }
-  const nodeStream = Readable.fromWeb(response.body);
-  await pipelineAsync(
-    nodeStream,
-    tar.extract({
-      cwd: targetDir,
-      strip: 1,
-      filter: shouldIncludeMcpTemplatePath
-    })
-  );
-}
-function writeStarterContent(targetDir, projectName, slug, enableAiChat = true, repoUrl = "", i18nLocales) {
-  const contentDir = join(targetDir, "src", "content");
-  if (existsSync(contentDir)) {
-    const entries = readdirSync(contentDir);
-    for (const entry of entries) {
-      execSync(`rm -rf "${join(contentDir, entry)}"`);
-    }
-  } else {
-    mkdirSync(contentDir, { recursive: true });
-  }
-  for (const [filename, template] of Object.entries(STARTER_PAGES)) {
-    const content = template.replace(/\{NAME\}/g, projectName).replace(/\{SLUG\}/g, slug);
-    writeFileSync(join(contentDir, filename), content, "utf8");
-  }
-  writeFileSync(
-    join(targetDir, "docs.json"),
-    buildStarterDocsJson({ enableAiChat, repoUrl: repoUrl || void 0, i18nLocales }),
-    "utf8"
-  );
-}
-function updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl) {
-  const siteFile = join(targetDir, "src", "data", "site.ts");
-  if (!existsSync(siteFile)) return;
-  let source = readFileSync(siteFile, "utf8");
-  source = source.replace(/name:\s*'[^']*'/, `name: '${projectName.replace(/'/g, "\\'")}'`);
-  source = source.replace(
-    /description:\s*\n\s*'[^']*'/,
-    `description:
-    '${description.replace(/'/g, "\\'")}'`
-  );
-  source = source.replace(
-    /const brandPreset:\s*BrandPresetKey\s*=\s*'[^']*'/,
-    `const brandPreset: BrandPresetKey = '${brandPreset}'`
-  );
-  if (repoUrl) {
-    source = source.replace(/repoUrl:\s*'[^']*'/, `repoUrl: '${repoUrl}'`);
-    source = source.replace(
-      /\{\s*label:\s*'GitHub',\s*href:\s*'[^']*'\s*\}/,
-      `{ label: 'GitHub', href: '${repoUrl}' }`
-    );
-    source = source.replace(
-      /\{\s*label:\s*'Support',\s*href:\s*'[^']*'\s*\}/,
-      `{ label: 'Support', href: '${repoUrl}/issues/new' }`
-    );
-  }
-  writeFileSync(siteFile, source, "utf8");
-}
-function patchTopBarNavigation(targetDir) {
-  const filePath = join(targetDir, "src", "components", "layout", "top-bar.tsx");
-  if (!existsSync(filePath)) return;
-  const source = readFileSync(filePath, "utf8");
-  if (!source.includes("target={isExternal ? '_blank' : undefined}")) return;
-  const patched = source.replace(
-    /if \(collection\.href\) \{\n              const isExternal[^\n]+\n              return \(\n                <a[\s\S]*?<\/a>\n              \)\n            \}/,
-    `if (collection.href) {
-              const isExternal = /^https?:\\/\\//.test(collection.href)
-              if (isExternal) {
-                return (
-                  <a
-                    key={collection.id}
-                    href={collection.href}
-                    target="_blank"
-                    rel="noreferrer"
-                    className={baseClasses}
-                  >
-                    {collection.label}
-                  </a>
-                )
-              }
-              return (
-                <Link
-                  key={collection.id}
-                  href={collection.href}
-                  className={baseClasses}
-                >
-                  {collection.label}
-                </Link>
-              )
-            }`
-  );
-  writeFileSync(filePath, patched, "utf8");
-}
-function patchApiReferenceGuard(targetDir) {
-  const filePath = join(targetDir, "src", "data", "api-reference.ts");
-  if (!existsSync(filePath)) return;
-  let source = readFileSync(filePath, "utf8");
-  source = source.replace(
-    /export async function buildApiNavigation\([^)]*\)[^{]*\{\n/,
-    (match) => `${match}  if (apiReferenceConfig.specs.length === 0) return []
-`
-  );
-  writeFileSync(filePath, source, "utf8");
-}
-function patchOpenApiFetch(targetDir) {
-  const filePath = join(targetDir, "src", "lib", "openapi", "fetch.ts");
-  if (!existsSync(filePath)) return;
-  let source = readFileSync(filePath, "utf8");
-  source = source.replace(
-    /const absolutePath = path\.isAbsolute\(filePath\) \? filePath : path\.resolve\(process\.cwd\(\), filePath\)/,
-    `const absolutePath = filePath.startsWith('/')
-    ? path.resolve(process.cwd(), 'public', filePath.slice(1))
-    : path.resolve(process.cwd(), filePath)`
-  );
-  writeFileSync(filePath, source, "utf8");
-}
-function updateEnvExample(targetDir) {
-  const envFile = join(targetDir, ".env.example");
-  if (existsSync(envFile)) {
-    const envLocal = join(targetDir, ".env.local");
-    if (!existsSync(envLocal)) cpSync(envFile, envLocal);
-  }
-}
-function installDeps(targetDir) {
-  run("npm install", targetDir);
-}
-function initGit(targetDir) {
-  try {
-    run("git init", targetDir);
-    run("git add -A", targetDir);
-    run('git commit -m "Initial commit from create-thally-docs"', targetDir);
-  } catch {
-  }
-}
+import {
+  EXCLUDE_PATHS,
+  STABLE_SCAFFOLD_RELEASE,
+  TEMPLATE_REPOSITORY,
+  scaffold as scaffoldProject,
+  shouldInclude
+} from "create-thally-docs/scaffold";
+import { buildStarterDocsJson } from "create-thally-docs/starter";
+var MCP_TEMPLATE_COMMIT_SHA = STABLE_SCAFFOLD_RELEASE.source.commitSha;
+var MCP_SCAFFOLD_RELEASE_ID = STABLE_SCAFFOLD_RELEASE.id;
 async function scaffold(options) {
-  const { projectDir, projectName, description, brandPreset, repoUrl, doInstall, enableAiChat = true, i18nLocales } = options;
-  const targetDir = resolve(projectDir);
-  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
-    throw new Error(`Directory "${targetDir}" already exists and is not empty.`);
-  }
-  mkdirSync(targetDir, { recursive: true });
-  const slug = slugify(projectName);
-  await downloadTemplate(targetDir);
-  writeStarterContent(targetDir, projectName, slug, enableAiChat, repoUrl, i18nLocales);
-  updateSiteConfig(targetDir, projectName, description, brandPreset, repoUrl);
-  patchApiReferenceGuard(targetDir);
-  patchTopBarNavigation(targetDir);
-  patchOpenApiFetch(targetDir);
-  updateEnvExample(targetDir);
-  if (doInstall) installDeps(targetDir);
-  initGit(targetDir);
-  return { projectDir: targetDir };
+  return scaffoldProject(options);
 }
 
 // src/tools/create-project.ts
@@ -265,7 +25,7 @@ var createProjectSchema = z.object({
   repoUrl: z.string().optional().describe("GitHub repository URL (optional)"),
   install: z.boolean().optional().default(true).describe("Whether to run npm install after scaffolding"),
   enableAiChat: z.boolean().optional().default(true).describe("Enable AI chat in docs.json (default true)"),
-  i18nLocales: z.array(z.object({ code: z.string(), label: z.string() })).optional().describe('Secondary locales to enable (e.g. [{code:"es",label:"Espa\xF1ol"}])')
+  i18nLocales: z.array(z.object({ code: z.string(), label: z.string() })).optional().describe('Additional locales beyond the included English and Spanish defaults (e.g. [{code:"fr",label:"Fran\xE7ais"}])')
 });
 async function handleCreateProject(input) {
   const { projectDir, brandPreset = "primary", install = true } = input;
@@ -304,20 +64,20 @@ async function handleCreateProject(input) {
 
 // src/tools/add-page.ts
 import { z as z2 } from "zod";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
-import { join as join3, dirname } from "path";
+import { existsSync, mkdirSync, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2, dirname } from "path";
 
 // src/lib/docs-json.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { readFileSync, writeFileSync } from "fs";
+import { join } from "path";
 function readDocsJson(projectDir) {
-  const docsPath = join2(projectDir, "docs.json");
-  const raw = readFileSync2(docsPath, "utf8");
+  const docsPath = join(projectDir, "docs.json");
+  const raw = readFileSync(docsPath, "utf8");
   return JSON.parse(raw);
 }
 function writeDocsJson(projectDir, config) {
-  const docsPath = join2(projectDir, "docs.json");
-  writeFileSync2(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+  const docsPath = join(projectDir, "docs.json");
+  writeFileSync(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
 }
 
 // src/lib/page-echo.ts
@@ -369,11 +129,11 @@ async function handleAddPage(input) {
       `Invalid pageId "${pageId}". Use only alphanumeric characters, hyphens, and slashes. Do not include .mdx extension.`
     );
   }
-  const mdxPath = join3(projectDir, "src", "content", `${pageId}.mdx`);
-  if (existsSync2(mdxPath)) {
+  const mdxPath = join2(projectDir, "src", "content", `${pageId}.mdx`);
+  if (existsSync(mdxPath)) {
     throw new Error(`Page already exists at: ${mdxPath}`);
   }
-  mkdirSync2(dirname(mdxPath), { recursive: true });
+  mkdirSync(dirname(mdxPath), { recursive: true });
   const frontmatterLines = [`title: ${title}`];
   if (description) {
     frontmatterLines.push(`description: ${description}`);
@@ -387,7 +147,7 @@ ${frontmatterLines.join("\n")}
 
 ${bodyContent}
 `;
-  writeFileSync3(mdxPath, mdxContent, "utf8");
+  writeFileSync2(mdxPath, mdxContent, "utf8");
   const config = readDocsJson(projectDir);
   let targetTab = config.tabs[0];
   if (input.tab) {
@@ -500,9 +260,25 @@ async function handleListPages(input) {
 
 // src/tools/update-page.ts
 import { z as z5 } from "zod";
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync4 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "fs";
+import { join as join3 } from "path";
+
+// src/lib/frontmatter.ts
 import matter from "gray-matter";
+var FRONTMATTER_OPTIONS = {
+  engines: {
+    javascript: () => ({}),
+    js: () => ({})
+  }
+};
+function parseFrontmatter(raw) {
+  return matter(raw, FRONTMATTER_OPTIONS);
+}
+function stringifyFrontmatter(body, data) {
+  return matter.stringify(body, data);
+}
+
+// src/tools/update-page.ts
 var updatePageSchema = z5.object({
   projectDir: z5.string().describe("Path to the Thally project root"),
   pageId: z5.string().describe('Page identifier (e.g. "guides/auth"). No .mdx extension.'),
@@ -513,11 +289,11 @@ var updatePageSchema = z5.object({
 });
 function findPageFile(projectDir, pageId) {
   const candidates = [
-    join4(projectDir, "src", "content", `${pageId}.mdx`),
-    join4(projectDir, "src", "content", `${pageId}/index.mdx`)
+    join3(projectDir, "src", "content", `${pageId}.mdx`),
+    join3(projectDir, "src", "content", `${pageId}/index.mdx`)
   ];
   for (const candidate of candidates) {
-    if (existsSync3(candidate)) return candidate;
+    if (existsSync2(candidate)) return candidate;
   }
   return null;
 }
@@ -531,8 +307,8 @@ async function handleUpdatePage(input) {
   src/content/${pageId}/index.mdx`
     );
   }
-  const raw = readFileSync3(filePath, "utf8");
-  const parsed = matter(raw);
+  const raw = readFileSync2(filePath, "utf8");
+  const parsed = parseFrontmatter(raw);
   const newFm = { ...parsed.data };
   if (input.title !== void 0) newFm["title"] = input.title;
   if (input.description !== void 0) newFm["description"] = input.description;
@@ -540,8 +316,8 @@ async function handleUpdatePage(input) {
     Object.assign(newFm, input.mergeFrontmatter);
   }
   const newBody = input.content !== void 0 ? stripEchoedPageHeader(input.content, pageId) : parsed.content;
-  const newContent = matter.stringify(newBody.trim(), newFm);
-  writeFileSync4(filePath, newContent, "utf8");
+  const newContent = stringifyFrontmatter(newBody.trim(), newFm);
+  writeFileSync3(filePath, newContent, "utf8");
   return [
     `\u2705 Page updated: ${filePath}`,
     `   pageId: ${pageId}`,
@@ -554,22 +330,30 @@ async function handleUpdatePage(input) {
 // src/tools/migrate-docs.ts
 import { z as z6 } from "zod";
 import { migrateDocs } from "create-thally-docs/migrate";
-var migrateDocsSchema = z6.object({
+var migrationSourceShape = {
   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"),
   maxPages: z6.number().int().min(1).max(1e3).optional().describe("Maximum public URL pages to import"),
   platform: z6.enum(["mintlify", "docusaurus"]).optional().describe("Source platform (default: auto-detect)")
+};
+var migrateDocsSchema = z6.object({
+  ...migrationSourceShape,
+  projectDir: z6.string().describe("Path for the new canonical Thally project; the directory must be absent or empty")
 });
-async function handleMigrateDocs(input) {
+var importDocsSchema = z6.object({
+  ...migrationSourceShape,
+  projectDir: z6.string().describe("Path to an existing Thally project whose runtime should be preserved")
+});
+async function runMigration(input, isInPlaceImport) {
   const apiKey = input.apiKey ?? process.env.ANTHROPIC_API_KEY;
-  const result = await migrateDocs({
+  return migrateDocs({
     sourceUrl: input.sourceUrl,
     projectDir: input.projectDir,
-    into: input.into ?? false,
+    // Keep this decision inside the adapter so stale or adversarial callers
+    // cannot turn a template-first migration into an in-place mutation.
+    into: isInPlaceImport,
     apiKey,
     branch: input.branch,
     docsDir: input.docsDir,
@@ -577,14 +361,20 @@ async function handleMigrateDocs(input) {
     platform: input.platform,
     yes: true
   });
-  return `Migration complete! ${result.pagesWritten} pages written to ${result.projectDir}/src/content/`;
+}
+async function handleMigrateDocs(input) {
+  const result = await runMigration(input, false);
+  return `Migration complete! Created a fresh Thally template at ${result.projectDir} and imported ${result.pagesWritten} pages.`;
+}
+async function handleImportDocs(input) {
+  const result = await runMigration(input, true);
+  return `Import complete! Imported ${result.pagesWritten} pages into the existing Thally project at ${result.projectDir}.`;
 }
 
 // src/tools/search-docs.ts
 import { z as z7 } from "zod";
-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";
+import { readdirSync, statSync, readFileSync as readFileSync3, existsSync as existsSync3 } from "fs";
+import { join as join4, relative, extname } from "path";
 var searchDocsSchema = z7.object({
   projectDir: z7.string().describe("Path to the Thally project root"),
   query: z7.string().describe("Search query"),
@@ -593,12 +383,12 @@ var searchDocsSchema = z7.object({
 function scanMdxFiles(dir, results) {
   let entries;
   try {
-    entries = readdirSync2(dir);
+    entries = readdirSync(dir);
   } catch {
     return;
   }
   for (const entry of entries) {
-    const fullPath = join5(dir, entry);
+    const fullPath = join4(dir, entry);
     try {
       const stat = statSync(fullPath);
       if (stat.isDirectory()) {
@@ -616,11 +406,11 @@ function scoreFiles(files, contentDir, query) {
   for (const filePath of files) {
     let raw;
     try {
-      raw = readFileSync4(filePath, "utf8");
+      raw = readFileSync3(filePath, "utf8");
     } catch {
       continue;
     }
-    const { data, content } = matter2(raw);
+    const { data, content } = parseFrontmatter(raw);
     const title = data.title ?? "";
     const description = data.description ?? "";
     const keywords = data.keywords ?? [];
@@ -641,8 +431,8 @@ function scoreFiles(files, contentDir, query) {
 }
 async function handleSearchDocs(input) {
   const { projectDir, query, limit = 5 } = input;
-  const contentDir = join5(projectDir, "src", "content");
-  if (!existsSync4(contentDir)) {
+  const contentDir = join4(projectDir, "src", "content");
+  if (!existsSync3(contentDir)) {
     throw new Error(`Content directory not found: ${contentDir}`);
   }
   const files = [];
@@ -737,23 +527,22 @@ async function handleAgentReadiness(input) {
 
 // src/tools/read-page.ts
 import { z as z10 } from "zod";
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
-import { join as join6 } from "path";
-import matter3 from "gray-matter";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import { join as join5 } from "path";
 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 = join6(projectDir, "src", "content");
+  const contentDir = join5(projectDir, "src", "content");
   const candidates = [
-    join6(contentDir, `${pageId}.mdx`),
-    join6(contentDir, `${pageId}/index.mdx`)
+    join5(contentDir, `${pageId}.mdx`),
+    join5(contentDir, `${pageId}/index.mdx`)
   ];
   let filePath = null;
   for (const c of candidates) {
-    if (existsSync5(c)) {
+    if (existsSync4(c)) {
       filePath = c;
       break;
     }
@@ -761,8 +550,8 @@ async function handleReadPage(input) {
   if (!filePath) {
     throw new Error(`Page not found: "${pageId}". No file at src/content/${pageId}.mdx`);
   }
-  const raw = readFileSync5(filePath, "utf8");
-  const { data, content } = matter3(raw);
+  const raw = readFileSync4(filePath, "utf8");
+  const { data, content } = parseFrontmatter(raw);
   const title = data.title ?? pageId;
   const description = data.description ?? "";
   const lines = [`id: ${pageId}`, `title: ${title}`];
@@ -773,9 +562,8 @@ async function handleReadPage(input) {
 
 // src/tools/get-context.ts
 import { z as z11 } from "zod";
-import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
-import { join as join7 } from "path";
-import matter4 from "gray-matter";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { join as join6 } from "path";
 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"),
@@ -783,8 +571,8 @@ var getContextSchema = z11.object({
 });
 async function handleGetContext(input) {
   const { projectDir, topic, maxTokens = 4e3 } = input;
-  const contentDir = join7(projectDir, "src", "content");
-  if (!existsSync6(contentDir)) {
+  const contentDir = join6(projectDir, "src", "content");
+  if (!existsSync5(contentDir)) {
     throw new Error(`Content directory not found: ${contentDir}`);
   }
   const files = [];
@@ -798,14 +586,14 @@ async function handleGetContext(input) {
   const sections = [];
   for (const result of scored) {
     const candidates = [
-      join7(contentDir, `${result.pageId}.mdx`),
-      join7(contentDir, `${result.pageId}/index.mdx`)
+      join6(contentDir, `${result.pageId}.mdx`),
+      join6(contentDir, `${result.pageId}/index.mdx`)
     ];
     let content = "";
     for (const c of candidates) {
-      if (existsSync6(c)) {
-        const raw = readFileSync6(c, "utf8");
-        const { content: body } = matter4(raw);
+      if (existsSync5(c)) {
+        const raw = readFileSync5(c, "utf8");
+        const { content: body } = parseFrontmatter(raw);
         content = body.trim();
         break;
       }
@@ -829,9 +617,8 @@ async function handleGetContext(input) {
 
 // src/tools/lint-project.ts
 import { z as z12 } from "zod";
-import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
-import { join as join8 } from "path";
-import matter5 from "gray-matter";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
+import { join as join7 } from "path";
 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)")
@@ -862,9 +649,9 @@ function addOrphanToNav(projectDir, pageId) {
 }
 async function handleLintProject(input) {
   const { projectDir, fix = false } = input;
-  const contentDir = join8(projectDir, "src", "content");
+  const contentDir = join7(projectDir, "src", "content");
   const issues = [];
-  if (!existsSync7(join8(projectDir, "docs.json"))) {
+  if (!existsSync6(join7(projectDir, "docs.json"))) {
     throw new Error(`Not a Thally project: docs.json not found in ${projectDir}`);
   }
   const config = readDocsJson(projectDir);
@@ -883,10 +670,10 @@ async function handleLintProject(input) {
   }
   for (const pageId of navPageIds) {
     const candidates = [
-      join8(contentDir, `${pageId}.mdx`),
-      join8(contentDir, `${pageId}/index.mdx`)
+      join7(contentDir, `${pageId}.mdx`),
+      join7(contentDir, `${pageId}/index.mdx`)
     ];
-    if (!candidates.some((c) => existsSync7(c))) {
+    if (!candidates.some((c) => existsSync6(c))) {
       issues.push({
         severity: "error",
         message: `"${pageId}" is in docs.json but has no MDX file`,
@@ -895,7 +682,7 @@ async function handleLintProject(input) {
     }
   }
   const allFiles = [];
-  if (existsSync7(contentDir)) {
+  if (existsSync6(contentDir)) {
     scanMdxFiles(contentDir, allFiles);
   }
   const fixedOrphans = [];
@@ -913,8 +700,8 @@ async function handleLintProject(input) {
     let data = {};
     let content = "";
     try {
-      const raw = readFileSync7(filePath, "utf8");
-      const parsed = matter5(raw);
+      const raw = readFileSync6(filePath, "utf8");
+      const parsed = parseFrontmatter(raw);
       data = parsed.data;
       content = parsed.content;
     } catch {
@@ -970,9 +757,8 @@ async function handleLintProject(input) {
 
 // src/tools/translate-docs.ts
 import { z as z13 } from "zod";
-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 { readFileSync as readFileSync7, writeFileSync as writeFileSync5, existsSync as existsSync7, mkdirSync as mkdirSync2 } from "fs";
+import { join as join8, dirname as dirname2 } from "path";
 import Anthropic from "@anthropic-ai/sdk";
 import pLimit from "p-limit";
 var translateDocsSchema = z13.object({
@@ -984,8 +770,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 = join9(projectDir, "docs.json");
-  const raw = readFileSync8(docsPath, "utf8");
+  const docsPath = join8(projectDir, "docs.json");
+  const raw = readFileSync7(docsPath, "utf8");
   return JSON.parse(raw);
 }
 function collectPageIds(pages) {
@@ -1027,12 +813,12 @@ function getAllPageIds(config) {
   return { ids, hrefOnlyPages };
 }
 function findSourceFile(projectDir, pageId) {
-  const contentRoot = join9(projectDir, "src", "content");
+  const contentRoot = join8(projectDir, "src", "content");
   const candidates = [
-    join9(contentRoot, `${pageId}.mdx`),
-    join9(contentRoot, `${pageId}/index.mdx`)
+    join8(contentRoot, `${pageId}.mdx`),
+    join8(contentRoot, `${pageId}/index.mdx`)
   ];
-  return candidates.find((p) => existsSync8(p)) ?? null;
+  return candidates.find((p) => existsSync7(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.
 
@@ -1084,7 +870,7 @@ async function handleTranslateDocs(input) {
   }
   const { ids: allPageIds, hrefOnlyPages } = getAllPageIds(config);
   const targetPageIds = pages ?? allPageIds;
-  const contentRoot = join9(projectDir, "src", "content");
+  const contentRoot = join8(projectDir, "src", "content");
   const toTranslate = [];
   const skipped = [];
   for (const pageId of targetPageIds) {
@@ -1094,8 +880,8 @@ async function handleTranslateDocs(input) {
       continue;
     }
     const relativeFromContent = sourceFile.slice(contentRoot.length + 1);
-    const targetFile = join9(contentRoot, locale, relativeFromContent);
-    if (existsSync8(targetFile) && !force) {
+    const targetFile = join8(contentRoot, locale, relativeFromContent);
+    if (existsSync7(targetFile) && !force) {
       skipped.push(`${pageId} (already translated)`);
       continue;
     }
@@ -1111,14 +897,14 @@ async function handleTranslateDocs(input) {
     toTranslate.map(
       ({ pageId, sourceFile, targetFile }) => limit(async () => {
         try {
-          const sourceContent = readFileSync8(sourceFile, "utf8");
-          const parsed = matter6(sourceContent);
+          const sourceContent = readFileSync7(sourceFile, "utf8");
+          const parsed = parseFrontmatter(sourceContent);
           if (!parsed.data.title) {
             console.warn(`[translate] ${pageId}: missing title in frontmatter`);
           }
           const translated = await translatePage(sourceContent, targetLocale.label, locale, model, client);
-          mkdirSync3(dirname2(targetFile), { recursive: true });
-          writeFileSync6(targetFile, translated + "\n", "utf8");
+          mkdirSync2(dirname2(targetFile), { recursive: true });
+          writeFileSync5(targetFile, translated + "\n", "utf8");
           results.push({ pageId, success: true });
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
@@ -1467,11 +1253,18 @@ var tools = [
   }),
   defineTool({
     name: "migrate_docs",
-    description: "Crawl a docs site and migrate it into a Thally project",
+    description: "Create a fresh canonical Thally template, then migrate a GitHub repository or public docs site into it; the target must be new or empty",
     scope: "project",
     schema: migrateDocsSchema,
     handler: handleMigrateDocs
   }),
+  defineTool({
+    name: "import_docs",
+    description: "Import content into an existing Thally project without scaffolding; use only when an in-place import is explicitly requested",
+    scope: "project",
+    schema: importDocsSchema,
+    handler: handleImportDocs
+  }),
   defineTool({
     name: "search_docs",
     description: "Search documentation pages by keyword \u2014 returns ranked list of matching pages",