@thallylabs/mcp 0.8.0 → 0.9.0

package/README.md

@@ -1,9 +1,11 @@
 # @thallylabs/mcp
 
 A [Model Context Protocol](https://modelcontextprotocol.io) server that lets AI
-tools — Claude Code, Claude Desktop, Cursor, Windsurf — create, read, update,
-search, and migrate [Thally](https://github.com/thallylabs/thally) documentation projects
-through natural language.
+tools — Claude Code, Claude Desktop, Cursor, Windsurf — manage
+[Thally](https://github.com/thallylabs/thally) knowledge surfaces through
+natural language. Tools can create, read, update, search, and migrate
+documentation, then trace a product-repository change into reviewable docs
+work.
 
 ## Setup
 
@@ -28,17 +30,22 @@ Or in a `mcp.json` / client config:
 
 ## Tools
 
-13 tools, including:
+15 tools, including:
 
 - **Authoring** — `create_project`, `add_page`, `update_page`, `read_page`, `list_pages`, `add_tab`
 - **Context & search** — `get_context`, `search_docs`, `semantic_search` (against a deployed site)
 - **Quality** — `lint_project`, `agent_readiness` (the Agent Readiness Score of a deployed site)
-- **Migration** — `migrate_docs`, `translate_docs`
+- **Migration** — `migrate_docs`, `import_docs`, `translate_docs`
+- **Product changes** — `sync_from_repo`
 
 `search_docs`, `read_page`, and `get_context` work against a local project on
 disk; `semantic_search` and `agent_readiness` run against any **deployed** Thally
 site over HTTP.
 
+`migrate_docs` always scaffolds a fresh canonical Thally template before it
+imports content. To preserve an existing Thally runtime and import content in
+place, the caller must explicitly choose `import_docs`.
+
 ## License
 
 MIT

package/dist/create-project.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+
+declare const createProjectSchema: z.ZodObject<{
+    projectDir: z.ZodString;
+    projectName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    brandPreset: z.ZodDefault<z.ZodOptional<z.ZodEnum<["primary", "secondary"]>>>;
+    repoUrl: z.ZodOptional<z.ZodString>;
+    install: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    enableAiChat: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    i18nLocales: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        label: string;
+    }, {
+        code: string;
+        label: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    projectDir: string;
+    brandPreset: "primary" | "secondary";
+    install: boolean;
+    enableAiChat: boolean;
+    projectName?: string | undefined;
+    description?: string | undefined;
+    repoUrl?: string | undefined;
+    i18nLocales?: {
+        code: string;
+        label: string;
+    }[] | undefined;
+}, {
+    projectDir: string;
+    projectName?: string | undefined;
+    description?: string | undefined;
+    brandPreset?: "primary" | "secondary" | undefined;
+    repoUrl?: string | undefined;
+    install?: boolean | undefined;
+    enableAiChat?: boolean | undefined;
+    i18nLocales?: {
+        code: string;
+        label: string;
+    }[] | undefined;
+}>;
+type CreateProjectInput = z.infer<typeof createProjectSchema>;
+declare function handleCreateProject(input: CreateProjectInput): Promise<string>;
+
+export { type CreateProjectInput, createProjectSchema, handleCreateProject };

package/dist/create-project.js

@@ -0,0 +1,67 @@
+// src/tools/create-project.ts
+import { z } from "zod";
+
+// src/lib/scaffold.ts
+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) {
+  return scaffoldProject(options);
+}
+
+// src/tools/create-project.ts
+var createProjectSchema = z.object({
+  projectDir: z.string().describe("Path where the new Thally project should be created"),
+  projectName: z.string().optional().describe("Display name of the project (defaults to directory name)"),
+  description: z.string().optional().describe("Short description of the project"),
+  brandPreset: z.enum(["primary", "secondary"]).optional().default("primary").describe("Brand color preset"),
+  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('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;
+  const dirBase = projectDir.split("/").filter(Boolean).pop() ?? "my-docs";
+  const projectName = input.projectName ?? dirBase.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+  const description = input.description ?? `Documentation for ${projectName}.`;
+  const repoUrl = input.repoUrl ?? "";
+  const result = await scaffold({
+    projectDir,
+    projectName,
+    description,
+    brandPreset,
+    repoUrl,
+    doInstall: install,
+    enableAiChat: input.enableAiChat ?? true,
+    i18nLocales: input.i18nLocales
+  });
+  const dirName = result.projectDir.split("/").pop() ?? projectDir;
+  return [
+    `\u2705 Thally project "${projectName}" created at: ${result.projectDir}`,
+    "",
+    "Next steps:",
+    `  cd ${dirName}`,
+    "  npm run dev",
+    "",
+    "Then open http://localhost:3040 to see your docs.",
+    "",
+    "Key files to edit:",
+    "  \u2022 src/data/site.ts   \u2014 name, links, branding",
+    "  \u2022 docs.json          \u2014 navigation, AI chat config",
+    "  \u2022 src/content/*.mdx  \u2014 your documentation",
+    "",
+    ...input.enableAiChat !== false ? ["\u{1F916} AI chat is enabled. Set ANTHROPIC_API_KEY in .env.local."] : []
+  ].join("\n");
+}
+export {
+  createProjectSchema,
+  handleCreateProject
+};