@thallylabs/mcp 0.7.4 → 0.8.0

package/dist/index.js

@@ -18,18 +18,21 @@ import { Readable, pipeline } from "stream";
 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 = [
+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-agent.yml",
   "/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
@@ -115,12 +118,7 @@ async function downloadTemplate(targetDir) {
     tar.extract({
       cwd: targetDir,
       strip: 1,
-      filter: (path) => {
-        for (const excluded of EXCLUDE_PATHS) {
-          if (path.includes(excluded)) return false;
-        }
-        return true;
-      }
+      filter: shouldIncludeMcpTemplatePath
     })
   );
 }
@@ -331,6 +329,34 @@ function writeDocsJson(projectDir, config) {
   writeFileSync2(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
 }
 
+// src/lib/page-echo.ts
+var BODY_DELIMITER = "--- MDX body ---";
+function readPageBodyDelimiter() {
+  return BODY_DELIMITER;
+}
+function stripEchoedPageHeader(content, pageId) {
+  const lines = content.split("\n");
+  const delimiterIndex = lines.findIndex((line) => line.trim() === BODY_DELIMITER);
+  if (delimiterIndex !== -1 && delimiterIndex <= 6) {
+    return lines.slice(delimiterIndex + 1).join("\n").replace(/^\n+/, "");
+  }
+  const first = lines[0]?.trim() ?? "";
+  const second = lines[1]?.trim() ?? "";
+  if (first.startsWith("# ") && second === `*${pageId}*`) {
+    let index = 2;
+    while (index < lines.length && lines[index].trim() === "") index += 1;
+    if (lines[index]?.trim().startsWith("> ")) {
+      index += 1;
+      while (index < lines.length && lines[index].trim() === "") index += 1;
+    }
+    if (lines[index]?.trim() === "---") {
+      index += 1;
+    }
+    return lines.slice(index).join("\n").replace(/^\n+/, "");
+  }
+  return content;
+}
+
 // src/tools/add-page.ts
 var addPageSchema = z2.object({
   projectDir: z2.string().describe("Path to the Thally project root"),
@@ -361,7 +387,7 @@ async function handleAddPage(input) {
   if (description) {
     frontmatterLines.push(`description: ${description}`);
   }
-  const bodyContent = content ?? `## ${title}
+  const bodyContent = content ? stripEchoedPageHeader(content, pageId) : `## ${title}
 
 Add your content here.`;
   const mdxContent = `---
@@ -522,7 +548,7 @@ async function handleUpdatePage(input) {
   if (input.mergeFrontmatter) {
     Object.assign(newFm, input.mergeFrontmatter);
   }
-  const newBody = input.content !== void 0 ? input.content : parsed.content;
+  const newBody = input.content !== void 0 ? stripEchoedPageHeader(input.content, pageId) : parsed.content;
   const newContent = matter.stringify(newBody.trim(), newFm);
   writeFileSync4(filePath, newContent, "utf8");
   return [
@@ -544,7 +570,8 @@ var migrateDocsSchema = z6.object({
   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")
+  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)")
 });
 async function handleMigrateDocs(input) {
   const apiKey = input.apiKey ?? process.env.ANTHROPIC_API_KEY;
@@ -556,6 +583,7 @@ async function handleMigrateDocs(input) {
     branch: input.branch,
     docsDir: input.docsDir,
     maxPages: input.maxPages,
+    platform: input.platform,
     yes: true
   });
   return `Migration complete! ${result.pagesWritten} pages written to ${result.projectDir}/src/content/`;
@@ -746,12 +774,9 @@ async function handleReadPage(input) {
   const { data, content } = matter3(raw);
   const title = data.title ?? pageId;
   const description = data.description ?? "";
-  const lines = [`# ${title}`, `*${pageId}*`, ""];
-  if (description) {
-    lines.push(`> ${description}`);
-    lines.push("");
-  }
-  lines.push("---", "", content.trim());
+  const lines = [`id: ${pageId}`, `title: ${title}`];
+  if (description) lines.push(`description: ${description}`);
+  lines.push("", readPageBodyDelimiter(), "", content.trim());
   return lines.join("\n");
 }
 

package/dist/tools.js

@@ -9,18 +9,21 @@ import { Readable, pipeline } from "stream";
 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 = [
+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-agent.yml",
   "/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
@@ -106,12 +109,7 @@ async function downloadTemplate(targetDir) {
     tar.extract({
       cwd: targetDir,
       strip: 1,
-      filter: (path) => {
-        for (const excluded of EXCLUDE_PATHS) {
-          if (path.includes(excluded)) return false;
-        }
-        return true;
-      }
+      filter: shouldIncludeMcpTemplatePath
     })
   );
 }
@@ -322,6 +320,34 @@ function writeDocsJson(projectDir, config) {
   writeFileSync2(docsPath, JSON.stringify(config, null, 2) + "\n", "utf8");
 }
 
+// src/lib/page-echo.ts
+var BODY_DELIMITER = "--- MDX body ---";
+function readPageBodyDelimiter() {
+  return BODY_DELIMITER;
+}
+function stripEchoedPageHeader(content, pageId) {
+  const lines = content.split("\n");
+  const delimiterIndex = lines.findIndex((line) => line.trim() === BODY_DELIMITER);
+  if (delimiterIndex !== -1 && delimiterIndex <= 6) {
+    return lines.slice(delimiterIndex + 1).join("\n").replace(/^\n+/, "");
+  }
+  const first = lines[0]?.trim() ?? "";
+  const second = lines[1]?.trim() ?? "";
+  if (first.startsWith("# ") && second === `*${pageId}*`) {
+    let index = 2;
+    while (index < lines.length && lines[index].trim() === "") index += 1;
+    if (lines[index]?.trim().startsWith("> ")) {
+      index += 1;
+      while (index < lines.length && lines[index].trim() === "") index += 1;
+    }
+    if (lines[index]?.trim() === "---") {
+      index += 1;
+    }
+    return lines.slice(index).join("\n").replace(/^\n+/, "");
+  }
+  return content;
+}
+
 // src/tools/add-page.ts
 var addPageSchema = z2.object({
   projectDir: z2.string().describe("Path to the Thally project root"),
@@ -352,7 +378,7 @@ async function handleAddPage(input) {
   if (description) {
     frontmatterLines.push(`description: ${description}`);
   }
-  const bodyContent = content ?? `## ${title}
+  const bodyContent = content ? stripEchoedPageHeader(content, pageId) : `## ${title}
 
 Add your content here.`;
   const mdxContent = `---
@@ -513,7 +539,7 @@ async function handleUpdatePage(input) {
   if (input.mergeFrontmatter) {
     Object.assign(newFm, input.mergeFrontmatter);
   }
-  const newBody = input.content !== void 0 ? input.content : parsed.content;
+  const newBody = input.content !== void 0 ? stripEchoedPageHeader(input.content, pageId) : parsed.content;
   const newContent = matter.stringify(newBody.trim(), newFm);
   writeFileSync4(filePath, newContent, "utf8");
   return [
@@ -535,7 +561,8 @@ var migrateDocsSchema = z6.object({
   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")
+  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)")
 });
 async function handleMigrateDocs(input) {
   const apiKey = input.apiKey ?? process.env.ANTHROPIC_API_KEY;
@@ -547,6 +574,7 @@ async function handleMigrateDocs(input) {
     branch: input.branch,
     docsDir: input.docsDir,
     maxPages: input.maxPages,
+    platform: input.platform,
     yes: true
   });
   return `Migration complete! ${result.pagesWritten} pages written to ${result.projectDir}/src/content/`;
@@ -737,12 +765,9 @@ async function handleReadPage(input) {
   const { data, content } = matter3(raw);
   const title = data.title ?? pageId;
   const description = data.description ?? "";
-  const lines = [`# ${title}`, `*${pageId}*`, ""];
-  if (description) {
-    lines.push(`> ${description}`);
-    lines.push("");
-  }
-  lines.push("---", "", content.trim());
+  const lines = [`id: ${pageId}`, `title: ${title}`];
+  if (description) lines.push(`description: ${description}`);
+  lines.push("", readPageBodyDelimiter(), "", content.trim());
   return lines.join("\n");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thallylabs/mcp",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "description": "MCP server for scaffolding and managing Thally documentation projects",
   "type": "module",
   "engines": {
@@ -34,7 +34,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.36.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
-    "create-thally-docs": "0.7.8",
+    "create-thally-docs": "0.8.0",
     "gray-matter": "^4.0.3",
     "p-limit": "^6.1.0",
     "tar": "^6.2.0",