@curenorway/kode-mcp 1.4.0 → 1.5.0

package/dist/index.js

@@ -70,6 +70,26 @@ var KodeApiClient = class {
   async listPages(siteId) {
     return this.request(`/api/cdn/sites/${siteId}/pages`);
   }
+  async getPage(pageId) {
+    return this.request(`/api/cdn/pages/${pageId}`);
+  }
+  async createPage(siteId, data) {
+    return this.request(`/api/cdn/sites/${siteId}/pages`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updatePage(pageId, data) {
+    return this.request(`/api/cdn/pages/${pageId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async deletePage(pageId) {
+    return this.request(`/api/cdn/pages/${pageId}`, {
+      method: "DELETE"
+    });
+  }
   async assignScriptToPage(pageId, scriptId, loadOrderOverride) {
     await this.request(`/api/cdn/pages/${pageId}/scripts`, {
       method: "POST",
@@ -81,6 +101,9 @@ var KodeApiClient = class {
       method: "DELETE"
     });
   }
+  async getPageScripts(pageId) {
+    return this.request(`/api/cdn/pages/${pageId}/scripts`);
+  }
   // Deployment operations
   async deploy(siteId, options = {}) {
     return this.request("/api/cdn/deploy", {
@@ -205,6 +228,9 @@ function getConfig() {
 function hasConfig() {
   return getConfig() !== void 0;
 }
+function getProjectRoot() {
+  return findProjectRoot();
+}
 function getScriptsDir() {
   const projectRoot = findProjectRoot();
   const projectConfig = loadProjectConfig();
@@ -492,13 +518,109 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "kode_list_pages",
-        description: "List all page definitions for the site. Pages define URL patterns for page-specific scripts.",
+        description: "List all CDN page definitions for the site. Pages define URL patterns for page-specific scripts.",
         inputSchema: {
           type: "object",
           properties: {},
           required: []
         }
       },
+      {
+        name: "kode_create_page",
+        description: "Create a new CDN page with URL patterns. Pages are used to load page-specific scripts on matching URLs.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: 'Page name (e.g., "About Page", "Contact")'
+            },
+            urlPatterns: {
+              type: "array",
+              items: { type: "string" },
+              description: 'URL patterns that match this page (e.g., ["/about", "/about/*"])'
+            },
+            patternType: {
+              type: "string",
+              enum: ["exact", "prefix", "wildcard", "regex"],
+              description: "How to match URL patterns. Default: prefix"
+            },
+            priority: {
+              type: "number",
+              description: "Priority for matching (higher = checked first). Default: 0"
+            },
+            parentSlug: {
+              type: "string",
+              description: "Optional parent page slug for nesting"
+            }
+          },
+          required: ["name", "urlPatterns"]
+        }
+      },
+      {
+        name: "kode_update_page",
+        description: "Update an existing CDN page. Can modify name, URL patterns, pattern type, priority, or parent.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageSlug: {
+              type: "string",
+              description: "Page slug or name to update"
+            },
+            name: {
+              type: "string",
+              description: "New page name"
+            },
+            urlPatterns: {
+              type: "array",
+              items: { type: "string" },
+              description: "New URL patterns"
+            },
+            patternType: {
+              type: "string",
+              enum: ["exact", "prefix", "wildcard", "regex"],
+              description: "New pattern matching type"
+            },
+            priority: {
+              type: "number",
+              description: "New priority"
+            },
+            parentSlug: {
+              type: "string",
+              description: "New parent page slug, or null to make root-level"
+            }
+          },
+          required: ["pageSlug"]
+        }
+      },
+      {
+        name: "kode_delete_page",
+        description: "Delete a CDN page. Also removes all script assignments for that page.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageSlug: {
+              type: "string",
+              description: "Page slug or name to delete"
+            }
+          },
+          required: ["pageSlug"]
+        }
+      },
+      {
+        name: "kode_get_page_scripts",
+        description: "List all scripts assigned to a specific page.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageSlug: {
+              type: "string",
+              description: "Page slug or name to get scripts for"
+            }
+          },
+          required: ["pageSlug"]
+        }
+      },
       {
         name: "kode_assign_script_to_page",
         description: "Assign a page-specific script to a page. Required for page-specific scripts to load on their target pages.",
@@ -696,6 +818,20 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           properties: {},
           required: []
         }
+      },
+      {
+        name: "kode_sync_documentation",
+        description: "Sync script documentation. Pulls latest script metadata from the API and updates .cure-kode/KODE.md with current scripts and pages. Also ensures CLAUDE.md has a reference to KODE.md.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            updateClaudeMd: {
+              type: "boolean",
+              description: "Update KODE.md and ensure CLAUDE.md has reference. Default: true"
+            }
+          },
+          required: []
+        }
       }
     ]
   };
@@ -1248,25 +1384,216 @@ Webflow Components:
         const pages = await client.listPages(siteId);
         if (pages.length === 0) {
           return {
-            content: [{ type: "text", text: 'No pages defined. All scripts with scope "global" will load on all pages.' }]
+            content: [{ type: "text", text: 'No pages defined. All scripts with scope "global" will load on all pages.\n\nUse kode_create_page to add page definitions for page-specific scripts.' }]
           };
         }
-        const formatted = pages.map((p) => ({
-          name: p.name,
-          slug: p.slug,
-          patterns: p.url_patterns,
-          patternType: p.pattern_type,
-          priority: p.priority
-        }));
+        const rootPages = pages.filter((p) => !p.parent_id);
+        const childPages = pages.filter((p) => p.parent_id);
+        const formatPage = (p, indent = 0) => {
+          const prefix = "  ".repeat(indent);
+          let text2 = `${prefix}${p.name} (${p.slug})
+`;
+          text2 += `${prefix}  Patterns: ${p.url_patterns.join(", ")} [${p.pattern_type}]
+`;
+          text2 += `${prefix}  Priority: ${p.priority}
+`;
+          const children = childPages.filter((c) => c.parent_id === p.id);
+          for (const child of children) {
+            text2 += formatPage(child, indent + 1);
+          }
+          return text2;
+        };
+        let text = `CDN Pages (${pages.length}):
+
+`;
+        for (const page of rootPages) {
+          text += formatPage(page);
+          text += "\n";
+        }
         return {
-          content: [
-            {
-              type: "text",
-              text: JSON.stringify(formatted, null, 2)
-            }
-          ]
+          content: [{ type: "text", text }]
         };
       }
+      case "kode_create_page": {
+        const { name: name2, urlPatterns, patternType, priority, parentSlug } = args;
+        let parentId;
+        if (parentSlug) {
+          const pages = await client.listPages(siteId);
+          const parentPage = pages.find((p) => p.slug === parentSlug || p.name === parentSlug);
+          if (!parentPage) {
+            return {
+              content: [{ type: "text", text: `Parent page "${parentSlug}" not found` }],
+              isError: true
+            };
+          }
+          parentId = parentPage.id;
+        }
+        try {
+          const page = await client.createPage(siteId, {
+            name: name2,
+            urlPatterns,
+            patternType: patternType || "prefix",
+            priority: priority || 0,
+            parentId
+          });
+          let text = `Page created: ${page.name} (${page.slug})
+
+`;
+          text += `URL Patterns: ${page.url_patterns.join(", ")}
+`;
+          text += `Pattern Type: ${page.pattern_type}
+`;
+          text += `Priority: ${page.priority}
+`;
+          if (parentId) {
+            text += `Parent: ${parentSlug}
+`;
+          }
+          text += "\nUse kode_assign_script_to_page to add scripts to this page.";
+          return {
+            content: [{ type: "text", text }]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to create page: ${message}` }],
+            isError: true
+          };
+        }
+      }
+      case "kode_update_page": {
+        const { pageSlug, name: name2, urlPatterns, patternType, priority, parentSlug } = args;
+        const pages = await client.listPages(siteId);
+        const page = pages.find((p) => p.slug === pageSlug || p.name === pageSlug || p.id === pageSlug);
+        if (!page) {
+          return {
+            content: [{ type: "text", text: `Page "${pageSlug}" not found` }],
+            isError: true
+          };
+        }
+        const updates = {};
+        if (name2 !== void 0) updates.name = name2;
+        if (urlPatterns !== void 0) updates.urlPatterns = urlPatterns;
+        if (patternType !== void 0) updates.patternType = patternType;
+        if (priority !== void 0) updates.priority = priority;
+        if (parentSlug === null) {
+          updates.parentId = null;
+        } else if (parentSlug !== void 0) {
+          const parentPage = pages.find((p) => p.slug === parentSlug || p.name === parentSlug);
+          if (!parentPage) {
+            return {
+              content: [{ type: "text", text: `Parent page "${parentSlug}" not found` }],
+              isError: true
+            };
+          }
+          updates.parentId = parentPage.id;
+        }
+        if (Object.keys(updates).length === 0) {
+          return {
+            content: [{ type: "text", text: "No updates specified. Provide at least one field to update." }],
+            isError: true
+          };
+        }
+        try {
+          const updated = await client.updatePage(page.id, updates);
+          let text = `Page updated: ${updated.name} (${updated.slug})
+
+`;
+          text += `URL Patterns: ${updated.url_patterns.join(", ")}
+`;
+          text += `Pattern Type: ${updated.pattern_type}
+`;
+          text += `Priority: ${updated.priority}
+`;
+          text += "\nRun kode_deploy to make changes live.";
+          return {
+            content: [{ type: "text", text }]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to update page: ${message}` }],
+            isError: true
+          };
+        }
+      }
+      case "kode_delete_page": {
+        const { pageSlug } = args;
+        const pages = await client.listPages(siteId);
+        const page = pages.find((p) => p.slug === pageSlug || p.name === pageSlug || p.id === pageSlug);
+        if (!page) {
+          return {
+            content: [{ type: "text", text: `Page "${pageSlug}" not found` }],
+            isError: true
+          };
+        }
+        try {
+          await client.deletePage(page.id);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Page deleted: ${page.name} (${page.slug})
+
+All script assignments for this page have been removed.
+Run kode_deploy to make changes live.`
+              }
+            ]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to delete page: ${message}` }],
+            isError: true
+          };
+        }
+      }
+      case "kode_get_page_scripts": {
+        const { pageSlug } = args;
+        const pages = await client.listPages(siteId);
+        const page = pages.find((p) => p.slug === pageSlug || p.name === pageSlug || p.id === pageSlug);
+        if (!page) {
+          return {
+            content: [{ type: "text", text: `Page "${pageSlug}" not found` }],
+            isError: true
+          };
+        }
+        try {
+          const assignments = await client.getPageScripts(page.id);
+          if (assignments.length === 0) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: `No scripts assigned to page "${page.name}".
+
+Use kode_assign_script_to_page to add scripts.`
+                }
+              ]
+            };
+          }
+          let text = `Scripts on "${page.name}" (${page.url_patterns.join(", ")}):
+
+`;
+          for (const assignment of assignments) {
+            const script = assignment.script;
+            const type = script.type === "javascript" ? "JS" : "CSS";
+            const loadOrder = assignment.load_order_override !== null ? ` [order: ${assignment.load_order_override}]` : "";
+            const enabled = assignment.is_enabled ? "" : " (disabled)";
+            text += `  [${type}] ${script.name} (${script.slug})${loadOrder}${enabled}
+`;
+          }
+          return {
+            content: [{ type: "text", text }]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to get page scripts: ${message}` }],
+            isError: true
+          };
+        }
+      }
       case "kode_assign_script_to_page": {
         const { scriptSlug, pageSlug, loadOrderOverride } = args;
         const scripts = await client.listScripts(siteId);
@@ -2184,6 +2511,171 @@ Use kode_list_pages_context to see cached pages, or kode_refresh_page to cache a
           content: [{ type: "text", text }]
         };
       }
+      case "kode_sync_documentation": {
+        const { updateClaudeMd = true } = args;
+        const config = getConfig();
+        if (!config) {
+          return {
+            content: [{ type: "text", text: 'Cure Kode not configured. Run "kode init" first.' }],
+            isError: true
+          };
+        }
+        const projectRoot = getProjectRoot();
+        if (!projectRoot) {
+          return {
+            content: [{ type: "text", text: "Not in a Cure Kode project." }],
+            isError: true
+          };
+        }
+        try {
+          const scripts = await client.listScripts(siteId);
+          const pages = await client.listPages(siteId);
+          let text = `Documentation synced:
+
+`;
+          text += `Scripts: ${scripts.length}
+`;
+          text += `Pages: ${pages.length}
+
+`;
+          if (scripts.length > 0) {
+            text += `## Scripts
+
+`;
+            for (const s of scripts) {
+              const type = s.type === "javascript" ? "JS" : "CSS";
+              const scope = s.scope === "global" ? "Global" : "Page";
+              const purpose = s.metadata?.purpose || s.description || "(no description)";
+              text += `- **${s.slug}** [${type}, ${scope}]: ${purpose}
+`;
+            }
+            text += "\n";
+          }
+          if (pages.length > 0) {
+            text += `## Pages
+
+`;
+            for (const p of pages) {
+              text += `- **${p.name}** (${p.slug}): ${p.url_patterns.join(", ")}
+`;
+            }
+            text += "\n";
+          }
+          if (updateClaudeMd) {
+            const kodeMdPath = path2.join(projectRoot, ".cure-kode", "KODE.md");
+            const claudeMdPath = path2.join(projectRoot, "CLAUDE.md");
+            const siteName = config.siteName || "Site";
+            const siteSlug = config.siteSlug || "site";
+            let kodeMd = `# Cure Kode: ${siteName}
+
+`;
+            kodeMd += `This project uses **Cure Kode** CDN for JavaScript/CSS delivery to Webflow.
+
+`;
+            kodeMd += `> **This file is auto-generated.** Do not edit manually.
+
+---
+
+`;
+            kodeMd += `## CDN URL
+
+\`\`\`html
+<script defer src="https://app.cure.no/api/cdn/${siteSlug}/init.js"></script>
+\`\`\`
+
+---
+
+`;
+            kodeMd += `## Scripts
+
+`;
+            if (scripts.length > 0) {
+              kodeMd += `| Script | Type | Scope | Auto | Purpose |
+`;
+              kodeMd += `|--------|------|-------|------|--------|
+`;
+              for (const s of scripts) {
+                const type = s.type === "javascript" ? "JS" : "CSS";
+                const scope = s.scope === "global" ? "Global" : "Page";
+                const auto = s.auto_load ? "\u26A1" : "\u25CB";
+                let purpose = s.metadata?.purpose || s.description || "\u2014";
+                if (purpose.length > 50) purpose = purpose.slice(0, 47) + "...";
+                kodeMd += `| \`${s.slug}\` | ${type} | ${scope} | ${auto} | ${purpose} |
+`;
+              }
+              kodeMd += `
+> \u26A1 = auto-loads, \u25CB = manual via \`CK.loadScript()\`
+
+`;
+            } else {
+              kodeMd += `No scripts yet. Create one with \`kode push\`.
+
+`;
+            }
+            if (pages.length > 0) {
+              kodeMd += `---
+
+## Pages
+
+`;
+              for (const p of pages) {
+                kodeMd += `- **${p.name}** (\`${p.slug}\`) \u2192 \`${p.url_patterns.join("`, `")}\`
+`;
+              }
+              kodeMd += "\n";
+            }
+            kodeMd += `---
+
+## Workflow
+
+`;
+            kodeMd += `**Before changes:** \`kode pull\`
+`;
+            kodeMd += `**After changes:** \`kode push\` then \`kode deploy\`
+`;
+            kodeMd += `**Check for updates:** \`kode doctor\`
+`;
+            fs2.writeFileSync(kodeMdPath, kodeMd);
+            text += `Updated .cure-kode/KODE.md with current scripts and pages.
+`;
+            const kodeReference = `## Cure Kode
+
+This project uses **Cure Kode** for JS/CSS delivery. **Before modifying scripts:**
+
+1. Run \`kode pull\` to get latest from server
+2. Make your changes in \`.cure-kode-scripts/\`
+3. Run \`kode push\` to upload, then \`kode deploy\` to publish
+
+Full documentation: [.cure-kode/KODE.md](.cure-kode/KODE.md)
+
+---
+
+`;
+            if (fs2.existsSync(claudeMdPath)) {
+              const claudeContent = fs2.readFileSync(claudeMdPath, "utf-8");
+              const hasReference = claudeContent.includes("KODE.md") || claudeContent.includes(".cure-kode/KODE.md");
+              if (!hasReference) {
+                fs2.writeFileSync(claudeMdPath, kodeReference + claudeContent);
+                text += `Added Kode reference to CLAUDE.md.
+`;
+              }
+            } else {
+              fs2.writeFileSync(claudeMdPath, kodeReference);
+              text += `Created CLAUDE.md with Kode reference.
+`;
+            }
+          }
+          return {
+            content: [{ type: "text", text }]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to sync documentation: ${message}` }],
+            isError: true
+          };
+        }
+      }
       default:
         return {
           content: [{ type: "text", text: `Unknown tool: ${name}` }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curenorway/kode-mcp",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "MCP server for Cure Kode CDN - enables AI agents to manage, deploy, and analyze Webflow scripts",
   "type": "module",
   "bin": {