multisite-cms-mcp 1.0.20 → 1.0.22

package/dist/tools/get-conversion-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AA2tB1H;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}
+{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AA4tB1H;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}

package/dist/tools/get-conversion-guide.js

@@ -193,34 +193,35 @@ The editor automatically detects when you're viewing a CMS path (like /blog or /
 
 ## Custom Collection Templates
 
-For custom collections (beyond the built-in blog, team, downloads, authors):
+For custom collections (beyond the built-in blog, team, downloads, authors), use the **flat format**:
 
 \`\`\`json
 {
   "cmsTemplates": {
-    "collectionTemplates": {
-      "video": {
-        "indexPath": "/videos",
-        "detailPath": "/video",
-        "indexTemplate": "templates/videos_index.html",
-        "detailTemplate": "templates/video_detail.html"
-      },
-      "product": {
-        "indexPath": "/shop",
-        "detailPath": "/product",
-        "indexTemplate": "templates/shop.html",
-        "detailTemplate": "templates/product_detail.html"
-      }
-    }
+    // Custom collection: video
+    "videoIndex": "pages/videos.html",
+    "videoIndexPath": "/videos",
+    "videoDetail": "templates/video-detail.html",
+    "videoDetailPath": "/videos",
+    
+    // Custom collection: product  
+    "productIndex": "pages/shop.html",
+    "productIndexPath": "/shop",
+    "productDetail": "templates/product-detail.html",
+    "productDetailPath": "/product"
   }
 }
 \`\`\`
 
-**Path Configuration:**
-- \`indexPath\` - URL for the collection list page (e.g., /videos)
-- \`detailPath\` - Base URL for individual item pages (e.g., /video → /video/item-slug)
+**Path Configuration (flat format):**
+- \`{slug}Index\` - Template file for the index/listing page
+- \`{slug}IndexPath\` - URL for the collection list page (e.g., /videos)
+- \`{slug}Detail\` - Template file for the detail page
+- \`{slug}DetailPath\` - Base URL for individual item pages (e.g., /videos → /videos/item-slug)
+
+**IMPORTANT:** The collection's internal slug is for database only. URL paths come EXCLUSIVELY from the manifest.
 
-This allows different paths for list vs detail pages (e.g., /videos for list, /video/my-video for detail).`,
+This allows same or different paths for list vs detail pages (e.g., /videos for both, or /shop for list and /product for detail).`,
     templates: `# Template Creation Guide
 
 ## Template Types

package/dist/tools/get-example.js

@@ -441,30 +441,30 @@ Every custom collection item automatically has:
 - \`{{url}}\` - Full URL to detail page
 - \`{{publishedAt}}\` - Publish date (REQUIRED)
 
-## In manifest.json
+## In manifest.json (Flat Format)
 
 \`\`\`json
 {
   "cmsTemplates": {
-    "collectionTemplates": {
-      "products": {
-        "indexPath": "/shop",
-        "detailPath": "/product",
-        "indexTemplate": "templates/products_index.html",
-        "detailTemplate": "templates/product_detail.html"
-      }
-    }
+    "productIndex": "pages/shop.html",
+    "productIndexPath": "/shop",
+    "productDetail": "templates/product-detail.html",
+    "productDetailPath": "/product"
   }
 }
 \`\`\`
 
-**Path Configuration:**
-- \`indexPath\` - URL for the list page (e.g., /shop → lists all products)
-- \`detailPath\` - Base URL for detail pages (e.g., /product → /product/my-product-slug)
+**Path Configuration (flat format):**
+- \`{slug}Index\` - Template file for the list page
+- \`{slug}IndexPath\` - URL for the list page (e.g., /shop → lists all products)
+- \`{slug}Detail\` - Template file for the detail page
+- \`{slug}DetailPath\` - Base URL for detail pages (e.g., /product → /product/my-product-slug)
 
 This serves:
-- Collection index at \`/shop\` (lists all products)
-- Detail pages at \`/product/product-slug\` (individual product)`,
+- Collection index at \`/shop\` (lists all products using productIndex template)
+- Detail pages at \`/product/product-slug\` (individual product using productDetail template)
+
+**IMPORTANT:** The manifest's paths are the SINGLE SOURCE OF TRUTH. Collection slug is for database only.`,
     form_handling: `# Form Handling
 
 Forms are automatically captured by the CMS:

package/dist/tools/get-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAuZjD"}
+{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CA4ajD"}

package/dist/tools/get-schema.js

@@ -325,39 +325,60 @@ For HTML content that should NOT be escaped:
 
 ## CMS Template Configuration
 
-Templates can be configured two ways:
+Templates are configured in manifest.json using a **flat format** that is the SINGLE SOURCE OF TRUTH for URL paths.
 
-### 1. In manifest.json
+### manifest.json Format
 \`\`\`json
 {
   "cmsTemplates": {
-    "blogIndex": "templates/blog_index.html",
+    // Built-in: Blog
+    "blogIndex": "pages/blog.html",
     "blogIndexPath": "/blog",
-    "blogPost": "templates/blog_post.html",
+    "blogPost": "templates/blog-post.html",
     "blogPostPath": "/blog",
-    "team": "templates/team.html",
+    
+    // Built-in: Team, Downloads, Authors
+    "team": "pages/team.html",
     "teamPath": "/team",
-    "downloads": "templates/downloads.html",
-    "downloadsPath": "/resources"
+    "downloads": "pages/downloads.html",
+    "downloadsPath": "/resources",
+    "authorsIndex": "pages/authors.html",
+    "authorsIndexPath": "/authors",
+    
+    // Custom Collections: Use {slug}Index, {slug}Detail, {slug}IndexPath, {slug}DetailPath
+    "videoIndex": "pages/videos.html",
+    "videoIndexPath": "/videos",
+    "videoDetail": "templates/video-detail.html",
+    "videoDetailPath": "/videos",
+    
+    "serviceIndex": "pages/services.html",
+    "serviceIndexPath": "/services",
+    "serviceDetail": "templates/service-detail.html",
+    "serviceDetailPath": "/service"
   }
 }
 \`\`\`
 
-### 2. Via Settings UI (after upload)
-Go to **Dashboard → Settings → CMS Templates** to:
-- Select which uploaded page serves as each template type
-- Configure custom URL paths for each CMS section
-- Changes take effect immediately
-
-**Template Types:**
-- **Blog Index** - Lists all blog posts (e.g., /blog)
-- **Blog Post** - Single blog post detail page (e.g., /blog/my-post)
-- **Team** - Team members page (e.g., /team)
-- **Downloads** - Downloadable files listing (e.g., /resources)
-- **Authors Index** - Lists all authors
-- **Author Detail** - Single author profile page
-
-**Note:** The editor shows a warning banner when viewing CMS paths (like /blog) that don't have templates configured.
+### Custom Collection URL Routing
+
+**IMPORTANT:** The collection's internal slug (set in CMS) is for database only, NOT for URLs.
+URL paths come EXCLUSIVELY from the manifest's \`{slug}IndexPath\` and \`{slug}DetailPath\`.
+
+**Example:** Collection with slug \`video\` but paths \`/videos\` and \`/videos/:itemSlug\`:
+- \`videoIndexPath: "/videos"\` → Index page at \`/videos\`
+- \`videoDetailPath: "/videos"\` → Detail pages at \`/videos/my-video\`
+
+**Different paths for index and detail:**
+- \`serviceIndexPath: "/services"\` → Index at \`/services\`
+- \`serviceDetailPath: "/service"\` → Detail at \`/service/my-service\`
+
+### Template Types
+- **{slug}Index** - Template file for the index/listing page
+- **{slug}IndexPath** - URL path for the index page
+- **{slug}Detail** - Template file for the detail page
+- **{slug}DetailPath** - URL path base for detail pages (item slug appended)
+
+**Note:** The CMS settings UI can also configure these, but manifest.json takes precedence for AI conversions.
 
 ---
 

package/dist/tools/validate-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-manifest.d.ts","sourceRoot":"","sources":["../../src/tools/validate-manifest.ts"],"names":[],"mappings":"AA8BA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsI5E"}
+{"version":3,"file":"validate-manifest.d.ts","sourceRoot":"","sources":["../../src/tools/validate-manifest.ts"],"names":[],"mappings":"AAyCA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4N5E"}

package/dist/tools/validate-manifest.js

@@ -8,7 +8,8 @@ const pageSchema = zod_1.z.object({
     title: zod_1.z.string(),
     editable: zod_1.z.boolean().optional(),
 });
-const cmsTemplatesSchema = zod_1.z.object({
+// Built-in collection templates
+const builtInTemplatesSchema = zod_1.z.object({
     blogIndex: zod_1.z.string().optional(),
     blogIndexPath: zod_1.z.string().startsWith('/').optional(),
     blogPost: zod_1.z.string().optional(),
@@ -20,8 +21,17 @@ const cmsTemplatesSchema = zod_1.z.object({
     authorsIndex: zod_1.z.string().optional(),
     authorDetail: zod_1.z.string().optional(),
     authorsIndexPath: zod_1.z.string().startsWith('/').optional(),
+    // Legacy format - deprecated
     collectionPaths: zod_1.z.record(zod_1.z.string().startsWith('/')).optional(),
-}).optional();
+    collectionTemplates: zod_1.z.record(zod_1.z.object({
+        path: zod_1.z.string().startsWith('/').optional(),
+        indexTemplate: zod_1.z.string().optional(),
+        detailTemplate: zod_1.z.string().optional(),
+    })).optional(),
+});
+// Custom collection templates use flat format: {slug}Index, {slug}Detail, {slug}IndexPath, {slug}DetailPath
+// This schema allows any additional string keys for custom collections
+const cmsTemplatesSchema = builtInTemplatesSchema.catchall(zod_1.z.string()).optional();
 const manifestSchema = zod_1.z.object({
     pages: zod_1.z.array(pageSchema),
     cmsTemplates: cmsTemplatesSchema,
@@ -85,6 +95,7 @@ The manifest.json file is not valid JSON. Check for:
     }
     // Check cmsTemplates
     const templates = m.cmsTemplates;
+    const customCollections = new Set();
     if (templates) {
         // Check template file paths
         const templateFields = ['blogIndex', 'blogPost', 'team', 'downloads', 'authorsIndex', 'authorDetail'];
@@ -120,9 +131,85 @@ The manifest.json file is not valid JSON. Check for:
         if (templates.authorDetail && !templates.authorsIndex) {
             warnings.push('- authorDetail template defined but no authorsIndex - authors need both templates');
         }
+        // Detect and validate custom collection templates (flat format)
+        // Pattern: {slug}Index, {slug}Detail, {slug}IndexPath, {slug}DetailPath
+        const allKeys = Object.keys(templates);
+        for (const key of allKeys) {
+            // Skip built-in keys
+            if (['blogIndex', 'blogIndexPath', 'blogPost', 'blogPostPath', 'team', 'teamPath',
+                'downloads', 'downloadsPath', 'authorsIndex', 'authorDetail', 'authorsIndexPath',
+                'collectionPaths', 'collectionTemplates'].includes(key)) {
+                continue;
+            }
+            // Extract collection slug from key pattern
+            let slug = null;
+            if (key.endsWith('Index') && !key.endsWith('IndexPath')) {
+                slug = key.slice(0, -5); // Remove 'Index'
+            }
+            else if (key.endsWith('Detail') && !key.endsWith('DetailPath')) {
+                slug = key.slice(0, -6); // Remove 'Detail'
+            }
+            else if (key.endsWith('IndexPath')) {
+                slug = key.slice(0, -9); // Remove 'IndexPath'
+            }
+            else if (key.endsWith('DetailPath')) {
+                slug = key.slice(0, -10); // Remove 'DetailPath'
+            }
+            if (slug && slug.length > 0) {
+                customCollections.add(slug);
+            }
+        }
+        // Validate each custom collection
+        for (const slug of customCollections) {
+            const indexTemplate = templates[`${slug}Index`];
+            const detailTemplate = templates[`${slug}Detail`];
+            const indexPath = templates[`${slug}IndexPath`];
+            const detailPath = templates[`${slug}DetailPath`];
+            // Check template file paths
+            if (typeof indexTemplate === 'string') {
+                if (!indexTemplate.endsWith('.html')) {
+                    warnings.push(`- cmsTemplates.${slug}Index: should end with .html (got: ${indexTemplate})`);
+                }
+            }
+            if (typeof detailTemplate === 'string') {
+                if (!detailTemplate.endsWith('.html')) {
+                    warnings.push(`- cmsTemplates.${slug}Detail: should end with .html (got: ${detailTemplate})`);
+                }
+            }
+            // Check path format
+            if (typeof indexPath === 'string' && !indexPath.startsWith('/')) {
+                errors.push(`- cmsTemplates.${slug}IndexPath: must start with "/" (got: ${indexPath})`);
+            }
+            if (typeof detailPath === 'string' && !detailPath.startsWith('/')) {
+                errors.push(`- cmsTemplates.${slug}DetailPath: must start with "/" (got: ${detailPath})`);
+            }
+            // Check consistency - if you have one, you should have the others
+            if (indexTemplate && !indexPath) {
+                warnings.push(`- Custom collection "${slug}": has ${slug}Index but no ${slug}IndexPath`);
+            }
+            if (detailTemplate && !detailPath) {
+                warnings.push(`- Custom collection "${slug}": has ${slug}Detail but no ${slug}DetailPath`);
+            }
+            if (indexPath && !indexTemplate) {
+                warnings.push(`- Custom collection "${slug}": has ${slug}IndexPath but no ${slug}Index template`);
+            }
+            if (detailPath && !detailTemplate) {
+                warnings.push(`- Custom collection "${slug}": has ${slug}DetailPath but no ${slug}Detail template`);
+            }
+            // Note: indexPath and detailPath can be the same (e.g., both "/videos")
+            // The system distinguishes by whether a slug segment exists after the path
+        }
+        // Warn about deprecated collectionTemplates format
+        if (templates.collectionTemplates) {
+            warnings.push('- cmsTemplates.collectionTemplates: This nested format is deprecated. Use flat format instead: {slug}Index, {slug}Detail, {slug}IndexPath, {slug}DetailPath');
+        }
     }
     // Build result
     let output = '';
+    // Build custom collections summary
+    const customCollectionsSummary = customCollections.size > 0
+        ? `\n- Custom collections: ${Array.from(customCollections).join(', ')} (using flat format: {slug}Index, {slug}Detail, {slug}IndexPath, {slug}DetailPath)`
+        : '';
     if (errors.length === 0 && warnings.length === 0) {
         output = `✅ MANIFEST VALID
 
@@ -130,7 +217,7 @@ The manifest.json structure is correct.
 
 Summary:
 - ${m.pages?.length || 0} static page(s) defined
-- CMS templates: ${templates ? 'configured in manifest' : 'not configured (can be set via Settings → CMS Templates after upload)'}
+- CMS templates: ${templates ? 'configured in manifest' : 'not configured (can be set via Settings → CMS Templates after upload)'}${customCollectionsSummary}
 - Head HTML: ${m.defaultHeadHtml ? 'configured' : 'not configured'}`;
     }
     else if (errors.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.0.20",
+  "version": "1.0.22",
   "description": "MCP server for AI-assisted website conversion to CMS format. Provides validation, examples, and schema tools.",
   "main": "dist/index.js",
   "bin": {