@thallylabs/mcp 0.10.24 → 0.10.27

package/dist/index.js

@@ -243,19 +243,25 @@ function formatGroup(group, indent) {
   }
   return lines;
 }
+function formatPages(pages, indent) {
+  return pages.flatMap((page) => {
+    if (typeof page !== "string") return formatGroup(page, indent);
+    const href = page === "introduction" ? "/" : `/${page}`;
+    return [`${indent}- ${page.padEnd(30)} \u2192 ${href}`];
+  });
+}
 async function handleListPages(input) {
   const config = readDocsJson(input.projectDir);
   const lines = [];
   for (const tab of config.tabs) {
     lines.push(`Tab: ${tab.tab}`);
-    if (tab.href) {
+    const navigationPages = [...tab.pages ?? [], ...tab.groups ?? []];
+    if (tab.href && navigationPages.length === 0) {
       lines.push(`  \u2192 External: ${tab.href}`);
-    } else if (tab.api) {
+    } else if (tab.api && navigationPages.length === 0) {
       lines.push(`  \u2192 API Reference: ${tab.api.source}`);
-    } else if (tab.groups && tab.groups.length > 0) {
-      for (const group of tab.groups) {
-        lines.push(...formatGroup(group, "  "));
-      }
+    } else if (navigationPages.length > 0) {
+      lines.push(...formatPages(navigationPages, "  "));
     } else {
       lines.push("  (no pages)");
     }
@@ -884,8 +890,16 @@ function collectNavPageIds(groups, seen, duplicates) {
 }
 function addOrphanToNav(projectDir, pageId) {
   const config = readDocsJson(projectDir);
-  const tab = config.tabs.find((t) => !t.href && !t.api && t.groups && t.groups.length > 0);
-  if (!tab || !tab.groups) return;
+  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)) {
@@ -904,12 +918,14 @@ async function handleLintProject(input) {
   const navPageIds = /* @__PURE__ */ new Set();
   const duplicates = /* @__PURE__ */ new Set();
   for (const tab of config.tabs) {
-    if (tab.href || tab.api) continue;
-    if (!tab.groups || tab.groups.length === 0) {
+    const hasNavigationNodes = Boolean(tab.pages?.length || tab.groups?.length);
+    if ((tab.href || tab.api) && !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.groups.map((g) => g), navPageIds, duplicates);
+    collectNavPageIds(tab.pages ?? [], navPageIds, duplicates);
+    collectNavPageIds(tab.groups ?? [], navPageIds, duplicates);
   }
   for (const dup of duplicates) {
     issues.push({ severity: "error", message: `[duplicate] "${dup}" appears more than once in docs.json` });
@@ -1003,7 +1019,7 @@ async function handleLintProject(input) {
 
 // src/tools/translate-docs.ts
 import { z as z14 } from "zod";
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync8, mkdirSync as mkdirSync2 } from "fs";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync5, existsSync as existsSync8, mkdirSync as mkdirSync2 } from "fs";
 import { join as join9, dirname as dirname2 } from "path";
 import Anthropic from "@anthropic-ai/sdk";
 import pLimit from "p-limit";
@@ -1036,8 +1052,8 @@ function getAllPageIds(config) {
   const seen = /* @__PURE__ */ new Set();
   const hrefOnlyPages = [];
   for (const tab of config.tabs) {
-    if (tab.api && !tab.groups) continue;
-    if (!tab.groups && tab.href) {
+    if (tab.api && !tab.pages && !tab.groups) continue;
+    if (!tab.pages && !tab.groups && tab.href) {
       const pageId = tab.href.replace(/^\//, "");
       if (pageId && !seen.has(pageId)) {
         seen.add(pageId);
@@ -1046,13 +1062,10 @@ function getAllPageIds(config) {
       }
       continue;
     }
-    if (!tab.groups) continue;
-    for (const group of tab.groups) {
-      for (const id of collectPageIds(group.pages)) {
-        if (!seen.has(id)) {
-          seen.add(id);
-          ids.push(id);
-        }
+    for (const id of collectPageIds([...tab.pages ?? [], ...tab.groups ?? []])) {
+      if (!seen.has(id)) {
+        seen.add(id);
+        ids.push(id);
       }
     }
   }
@@ -1150,7 +1163,7 @@ async function handleTranslateDocs(input) {
           }
           const translated = await translatePage(sourceContent, targetLocale.label, locale, model, client);
           mkdirSync2(dirname2(targetFile), { recursive: true });
-          writeFileSync6(targetFile, translated + "\n", "utf8");
+          writeFileSync5(targetFile, translated + "\n", "utf8");
           results.push({ pageId, success: true });
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
@@ -1573,7 +1586,7 @@ async function handleReadApiSpec(input) {
 }
 
 // src/tools/update-api-spec.ts
-import { writeFileSync as writeFileSync7 } from "fs";
+import { writeFileSync as writeFileSync6 } from "fs";
 import { extname as extname2 } from "path";
 import { z as z17 } from "zod";
 import { parse as parseYaml } from "yaml";
@@ -1599,7 +1612,7 @@ async function handleUpdateApiSpec(input) {
   }
   const content = input.content.endsWith("\n") ? input.content : `${input.content}
 `;
-  writeFileSync7(source.path, content, "utf8");
+  writeFileSync6(source.path, content, "utf8");
   return `\u2705 API source updated: ${source.source}`;
 }
 

package/dist/tools.js

@@ -234,19 +234,25 @@ function formatGroup(group, indent) {
   }
   return lines;
 }
+function formatPages(pages, indent) {
+  return pages.flatMap((page) => {
+    if (typeof page !== "string") return formatGroup(page, indent);
+    const href = page === "introduction" ? "/" : `/${page}`;
+    return [`${indent}- ${page.padEnd(30)} \u2192 ${href}`];
+  });
+}
 async function handleListPages(input) {
   const config = readDocsJson(input.projectDir);
   const lines = [];
   for (const tab of config.tabs) {
     lines.push(`Tab: ${tab.tab}`);
-    if (tab.href) {
+    const navigationPages = [...tab.pages ?? [], ...tab.groups ?? []];
+    if (tab.href && navigationPages.length === 0) {
       lines.push(`  \u2192 External: ${tab.href}`);
-    } else if (tab.api) {
+    } else if (tab.api && navigationPages.length === 0) {
       lines.push(`  \u2192 API Reference: ${tab.api.source}`);
-    } else if (tab.groups && tab.groups.length > 0) {
-      for (const group of tab.groups) {
-        lines.push(...formatGroup(group, "  "));
-      }
+    } else if (navigationPages.length > 0) {
+      lines.push(...formatPages(navigationPages, "  "));
     } else {
       lines.push("  (no pages)");
     }
@@ -875,8 +881,16 @@ function collectNavPageIds(groups, seen, duplicates) {
 }
 function addOrphanToNav(projectDir, pageId) {
   const config = readDocsJson(projectDir);
-  const tab = config.tabs.find((t) => !t.href && !t.api && t.groups && t.groups.length > 0);
-  if (!tab || !tab.groups) return;
+  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)) {
@@ -895,12 +909,14 @@ async function handleLintProject(input) {
   const navPageIds = /* @__PURE__ */ new Set();
   const duplicates = /* @__PURE__ */ new Set();
   for (const tab of config.tabs) {
-    if (tab.href || tab.api) continue;
-    if (!tab.groups || tab.groups.length === 0) {
+    const hasNavigationNodes = Boolean(tab.pages?.length || tab.groups?.length);
+    if ((tab.href || tab.api) && !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.groups.map((g) => g), navPageIds, duplicates);
+    collectNavPageIds(tab.pages ?? [], navPageIds, duplicates);
+    collectNavPageIds(tab.groups ?? [], navPageIds, duplicates);
   }
   for (const dup of duplicates) {
     issues.push({ severity: "error", message: `[duplicate] "${dup}" appears more than once in docs.json` });
@@ -994,7 +1010,7 @@ async function handleLintProject(input) {
 
 // src/tools/translate-docs.ts
 import { z as z14 } from "zod";
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync8, mkdirSync as mkdirSync2 } from "fs";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync5, existsSync as existsSync8, mkdirSync as mkdirSync2 } from "fs";
 import { join as join9, dirname as dirname2 } from "path";
 import Anthropic from "@anthropic-ai/sdk";
 import pLimit from "p-limit";
@@ -1027,8 +1043,8 @@ function getAllPageIds(config) {
   const seen = /* @__PURE__ */ new Set();
   const hrefOnlyPages = [];
   for (const tab of config.tabs) {
-    if (tab.api && !tab.groups) continue;
-    if (!tab.groups && tab.href) {
+    if (tab.api && !tab.pages && !tab.groups) continue;
+    if (!tab.pages && !tab.groups && tab.href) {
       const pageId = tab.href.replace(/^\//, "");
       if (pageId && !seen.has(pageId)) {
         seen.add(pageId);
@@ -1037,13 +1053,10 @@ function getAllPageIds(config) {
       }
       continue;
     }
-    if (!tab.groups) continue;
-    for (const group of tab.groups) {
-      for (const id of collectPageIds(group.pages)) {
-        if (!seen.has(id)) {
-          seen.add(id);
-          ids.push(id);
-        }
+    for (const id of collectPageIds([...tab.pages ?? [], ...tab.groups ?? []])) {
+      if (!seen.has(id)) {
+        seen.add(id);
+        ids.push(id);
       }
     }
   }
@@ -1141,7 +1154,7 @@ async function handleTranslateDocs(input) {
           }
           const translated = await translatePage(sourceContent, targetLocale.label, locale, model, client);
           mkdirSync2(dirname2(targetFile), { recursive: true });
-          writeFileSync6(targetFile, translated + "\n", "utf8");
+          writeFileSync5(targetFile, translated + "\n", "utf8");
           results.push({ pageId, success: true });
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
@@ -1564,7 +1577,7 @@ async function handleReadApiSpec(input) {
 }
 
 // src/tools/update-api-spec.ts
-import { writeFileSync as writeFileSync7 } from "fs";
+import { writeFileSync as writeFileSync6 } from "fs";
 import { extname as extname2 } from "path";
 import { z as z17 } from "zod";
 import { parse as parseYaml } from "yaml";
@@ -1590,7 +1603,7 @@ async function handleUpdateApiSpec(input) {
   }
   const content = input.content.endsWith("\n") ? input.content : `${input.content}
 `;
-  writeFileSync7(source.path, content, "utf8");
+  writeFileSync6(source.path, content, "utf8");
   return `\u2705 API source updated: ${source.source}`;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thallylabs/mcp",
-  "version": "0.10.24",
+  "version": "0.10.27",
   "description": "MCP server for managing Thally knowledge surfaces and tracing product changes into documentation work.",
   "type": "module",
   "engines": {
@@ -38,7 +38,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.36.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
-    "create-thally-docs": "0.10.22",
+    "create-thally-docs": "0.10.25",
     "gray-matter": "^4.0.3",
     "p-limit": "^6.1.0",
     "yaml": "^2.8.2",