multisite-cms-mcp 1.0.21 → 1.0.23

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;AA4tB1H;;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;AA80B1H;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}

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

@@ -230,6 +230,43 @@ This allows same or different paths for list vs detail pages (e.g., /videos for
 2. **Detail Templates** - Single item pages (blog_post.html)
 3. **Static Pages** - Fixed content with data-edit-key
 
+## Static UI vs Dynamic Content
+
+When converting templates, distinguish between:
+
+### 1. Static UI Elements (Keep as-is)
+Logos, icons, decorative backgrounds - these stay as \`/public/\` paths:
+\`\`\`html
+<!-- KEEP these static -->
+<img src="/public/images/logo.png" alt="Company Logo">
+<img src="/public/images/icons/arrow.svg" alt="">
+\`\`\`
+
+### 2. Dynamic Content (Replace with CMS tokens)
+Blog posts, team members, products - replace example content with \`{{#each}}\` loops:
+
+\`\`\`html
+<!-- WRONG: Hardcoded example content -->
+<article class="video-card">
+  <img src="/images/example-video.jpg" alt="Example Video">
+  <h2>My Example Video Title</h2>
+  <p>This is a sample description...</p>
+</article>
+
+<!-- CORRECT: CMS tokens with loop -->
+{{#each video sort="publishedAt" order="desc"}}
+<article class="video-card">
+  {{#if videothumbnail}}
+    <img src="{{videothumbnail}}" alt="{{name}}">
+  {{/if}}
+  <h2><a href="{{url}}">{{name}}</a></h2>
+  <p>{{shortdescription}}</p>
+</article>
+{{/each}}
+\`\`\`
+
+**Rule of thumb:** If it's site branding/design → keep static. If it's content that changes per item → use CMS tokens.
+
 ## Index Template Pattern (Blog List)
 
 \`\`\`html
@@ -616,11 +653,11 @@ document.querySelectorAll('form[data-form-name]').forEach(form => {
 **Tenant context is automatic** - the system handles associating forms with the correct site.`,
     assets: `# Asset Path Rules
 
-## The Rule
+## Static Assets (CSS, JS, Fonts, Site Images)
 
-**ALL asset paths must use /public/ prefix**
+**ALL static asset paths must use /public/ prefix**
 
-## HTML Examples
+### HTML Examples
 
 \`\`\`html
 <!-- CSS -->
@@ -629,14 +666,14 @@ document.querySelectorAll('form[data-form-name]').forEach(form => {
 <!-- JavaScript -->  
 <script src="/public/js/main.js"></script>
 
-<!-- Images -->
+<!-- Static Images (logos, icons, decorative) -->
 <img src="/public/images/logo.png" alt="Logo">
 
 <!-- Favicon -->
 <link rel="icon" href="/public/images/favicon.ico">
 \`\`\`
 
-## CSS Examples
+### CSS Examples
 
 \`\`\`css
 /* Correct */
@@ -648,7 +685,7 @@ background-image: url('../images/hero.jpg');
 background-image: url('images/hero.jpg');
 \`\`\`
 
-## Conversion Table
+### Conversion Table
 
 | Original | Converted |
 |----------|-----------|
@@ -657,6 +694,79 @@ background-image: url('images/hero.jpg');
 | ./images/logo.png | /public/images/logo.png |
 | /images/logo.png | /public/images/logo.png |
 
+---
+
+## CMS Content Images (CRITICAL)
+
+**CMS-managed images are different from static assets. They are uploaded by users through the CMS dashboard and served from a CDN.**
+
+### Two Types of Images
+
+1. **Static assets** (\`/public/images/\`) - Site logos, icons, decorative elements bundled in the package
+2. **CMS images** (\`{{fieldName}}\`) - User-uploaded content images managed through the dashboard
+
+### CMS Image Handling
+
+**ALWAYS use CMS tokens for content images - NEVER hardcode URLs**
+
+\`\`\`html
+<!-- CORRECT: CMS token for dynamic content -->
+{{#if mainImage}}
+  <img src="{{mainImage}}" alt="{{name}}">
+{{/if}}
+
+<!-- WRONG: Hardcoded example content -->
+<img src="/images/example-post.jpg" alt="Example Post">
+\`\`\`
+
+### CMS Image URL Format
+
+When users upload images through the CMS dashboard, they are stored and served from:
+\`\`\`
+https://api.fastmode.ai/media/{tenantId}/{filename}
+\`\`\`
+
+**Templates should NEVER reference this URL directly** - the CMS automatically provides the correct URL through the token.
+
+### Image Field Examples
+
+\`\`\`html
+<!-- Blog post images -->
+<img src="{{mainImage}}" alt="{{name}}">
+<img src="{{thumbnailImage}}" alt="{{name}}">
+
+<!-- Team member photos -->
+<img src="{{photo}}" alt="{{name}}">
+
+<!-- Author photos -->
+<img src="{{picture}}" alt="{{name}}">
+
+<!-- Custom collection images (field slug becomes token) -->
+<img src="{{videothumbnail}}" alt="{{name}}">
+<img src="{{ogimage}}" alt="{{name}}">
+<img src="{{productImage}}" alt="{{name}}">
+\`\`\`
+
+### Common Mistake: Mixing Static and CMS Images
+
+\`\`\`html
+<!-- WRONG: Don't mix hardcoded images with CMS content -->
+{{#each video}}
+  <img src="/images/video-placeholder.jpg" alt="Video">  <!-- BAD -->
+  <h2>{{name}}</h2>
+{{/each}}
+
+<!-- CORRECT: All content comes from CMS -->
+{{#each video}}
+  {{#if videothumbnail}}
+    <img src="{{videothumbnail}}" alt="{{name}}">
+  {{/if}}
+  <h2>{{name}}</h2>
+{{/each}}
+\`\`\`
+
+---
+
 ## External Assets
 
 Keep external URLs unchanged:
@@ -694,6 +804,10 @@ Keep external URLs unchanged:
 - [ ] Rich text uses {{{triple braces}}}
 - [ ] Parent refs (../) only inside loops
 - [ ] Correct field names used
+- [ ] **Static UI images** (logos, icons) use \`/public/\` paths
+- [ ] **Content images** (blog photos, team headshots) use CMS tokens
+- [ ] **No hardcoded example content** - dynamic items use \`{{#each}}\` loops
+- [ ] Index pages iterate over collections, not static example cards
 
 ## ✓ Field Names
 

package/dist/tools/get-example.d.ts

@@ -1,4 +1,4 @@
-type ExampleType = 'manifest_basic' | 'manifest_custom_paths' | 'manifest_minimal_with_ui' | 'blog_index_template' | 'blog_post_template' | 'team_template' | 'downloads_template' | 'authors_template' | 'author_detail_template' | 'custom_collection_template' | 'form_handling' | 'asset_paths' | 'data_edit_keys' | 'each_loop' | 'conditional_if' | 'nested_fields' | 'featured_posts' | 'parent_context' | 'equality_comparison';
+type ExampleType = 'manifest_basic' | 'manifest_custom_paths' | 'manifest_minimal_with_ui' | 'blog_index_template' | 'blog_post_template' | 'team_template' | 'downloads_template' | 'authors_template' | 'author_detail_template' | 'custom_collection_template' | 'form_handling' | 'asset_paths' | 'image_handling' | 'data_edit_keys' | 'each_loop' | 'conditional_if' | 'nested_fields' | 'featured_posts' | 'parent_context' | 'equality_comparison';
 /**
  * Returns example code for a specific pattern
  */

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

@@ -1 +1 @@
-{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,wBAAwB,GACxB,4BAA4B,GAC5B,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,CAAC;AA04B1B;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}
+{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,wBAAwB,GACxB,4BAA4B,GAC5B,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,CAAC;AA+gC1B;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}

package/dist/tools/get-example.js

@@ -554,6 +554,138 @@ background-image: url('images/hero-bg.jpg');
 - \`href="css/style.css"\` → \`href="/public/css/style.css"\`
 - \`src="../images/logo.png"\` → \`src="/public/images/logo.png"\`
 - \`url('../fonts/custom.woff')\` → \`url('/public/fonts/custom.woff')\``,
+    image_handling: `# Image Handling in Templates
+
+## Two Types of Images
+
+### 1. Static/UI Images (Keep as /public/ paths)
+Logos, icons, decorative backgrounds, UI elements - these are bundled with the site:
+\`\`\`html
+<!-- KEEP these as static paths -->
+<img src="/public/images/logo.png" alt="Company Logo">
+<img src="/public/images/icons/arrow.svg" alt="">
+<link rel="icon" href="/public/images/favicon.ico">
+<div style="background-image: url('/public/images/hero-pattern.svg')">
+\`\`\`
+
+### 2. Content Images (Use CMS Tokens)
+Blog photos, team headshots, product images - these are managed through the CMS:
+\`\`\`html
+<!-- USE CMS tokens for content -->
+<img src="{{mainImage}}" alt="{{name}}">
+<img src="{{thumbnailImage}}" alt="{{name}}">
+<img src="{{photo}}" alt="{{name}}">
+\`\`\`
+
+---
+
+## How to Decide: Static vs CMS Token
+
+| Image Type | Use | Example |
+|------------|-----|---------|
+| Company logo | \`/public/images/logo.png\` | Header/footer logo |
+| UI icons | \`/public/images/icons/...\` | Arrows, social icons |
+| Decorative backgrounds | \`/public/images/...\` | Hero patterns, textures |
+| Favicon | \`/public/images/favicon.ico\` | Browser tab icon |
+| Blog post images | \`{{mainImage}}\` | Article hero image |
+| Team member photos | \`{{photo}}\` | Staff headshots |
+| Product images | \`{{productImage}}\` | E-commerce photos |
+| User-uploaded content | \`{{fieldName}}\` | Any CMS-managed media |
+
+**Rule of thumb:** If the image is part of the site's design/branding → static. If it's content that changes per item → CMS token.
+
+---
+
+## Content Images: Avoid Hardcoded Examples
+
+When converting a static site with example blog posts or team members, replace the example content with CMS tokens:
+
+**WRONG - Hardcoded example content:**
+\`\`\`html
+<div class="videos-grid">
+  <article class="video-card">
+    <img src="/images/example-video.jpg" alt="Example">
+    <h2>Example Video Title</h2>
+    <p>Example description text...</p>
+  </article>
+</div>
+\`\`\`
+
+**CORRECT - CMS tokens with loop:**
+\`\`\`html
+<div class="videos-grid">
+  {{#each video sort="publishedAt" order="desc"}}
+  <article class="video-card">
+    {{#if videothumbnail}}
+      <img src="{{videothumbnail}}" alt="{{name}}">
+    {{/if}}
+    <h2><a href="{{url}}">{{name}}</a></h2>
+    <p>{{shortdescription}}</p>
+  </article>
+  {{/each}}
+</div>
+\`\`\`
+
+---
+
+## Always Wrap Content Images in Conditionals
+
+Since CMS images may not be uploaded, always check:
+\`\`\`html
+{{#if mainImage}}
+  <img src="{{mainImage}}" alt="{{name}}" class="hero-image">
+{{/if}}
+\`\`\`
+
+Or provide a CSS fallback (not a hardcoded placeholder image):
+\`\`\`html
+{{#if mainImage}}
+  <img src="{{mainImage}}" alt="{{name}}">
+{{else}}
+  <div class="placeholder-image"></div>
+{{/if}}
+\`\`\`
+
+---
+
+## Image Field Names by Collection
+
+**Blog Posts:**
+- \`{{mainImage}}\` - Hero/cover image
+- \`{{thumbnailImage}}\` - Small preview image
+
+**Team Members:**
+- \`{{photo}}\` - Headshot
+
+**Authors:**
+- \`{{picture}}\` - Author photo
+
+**Custom Collections:**
+- **Token name = field slug** defined when creating the collection
+- e.g., field slug \`videothumbnail\` → \`{{videothumbnail}}\`
+- e.g., field slug \`ogimage\` → \`{{ogimage}}\`
+- e.g., field slug \`productImage\` → \`{{productImage}}\`
+
+**Use \`get_tenant_schema\` tool to see exact field slugs for a tenant's custom collections.**
+
+---
+
+## How CMS Images Work
+
+1. User creates a custom collection with image fields (e.g., \`videothumbnail\`)
+2. User uploads images via CMS dashboard
+3. Template uses the field slug as the token: \`{{videothumbnail}}\`
+4. CMS automatically provides the correct URL at runtime
+
+---
+
+## Common Mistakes
+
+1. **Replacing logos with CMS tokens** - Keep static UI images as \`/public/\` paths
+2. **Hardcoding example blog/product images** - Use \`{{#each}}\` loops with CMS tokens
+3. **Wrong field names** - \`{{photo}}\` for team, \`{{picture}}\` for authors
+4. **Missing conditionals** - Always wrap optional content images in \`{{#if}}\`
+5. **Hardcoded placeholder images** - Use CSS placeholders, not image files`,
     data_edit_keys: `# Inline Editing with data-edit-key
 
 Make text editable in the CMS visual editor:

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,CA4ajD"}
+{"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,CA4fjD"}

package/dist/tools/get-schema.js

@@ -323,6 +323,86 @@ For HTML content that should NOT be escaped:
 
 ---
 
+## Image Handling in Templates
+
+### Two Types of Images
+
+**1. Static/UI Images** - Logos, icons, decorative backgrounds, UI elements
+- These are bundled with the site package
+- Use \`/public/\` paths
+- Keep these as static files
+
+**2. Content Images** - Blog photos, team headshots, product images, user-uploaded media
+- These are managed through the CMS dashboard
+- Use CMS tokens like \`{{mainImage}}\`, \`{{photo}}\`
+- Never hardcode example/placeholder content images
+
+### Static UI Images (Keep as /public/ paths)
+
+\`\`\`html
+<!-- These are CORRECT - static UI elements -->
+<img src="/public/images/logo.png" alt="Company Logo">
+<img src="/public/images/icons/arrow.svg" alt="">
+<div style="background-image: url('/public/images/hero-bg.jpg')">
+<link rel="icon" href="/public/images/favicon.ico">
+\`\`\`
+
+### Content Images (Use CMS Tokens)
+
+\`\`\`html
+<!-- These are CORRECT - CMS-managed content -->
+<img src="{{mainImage}}" alt="{{name}}">
+<img src="{{thumbnailImage}}" alt="{{name}}">
+<img src="{{photo}}" alt="{{name}}">
+
+<!-- WRONG - Don't hardcode example/placeholder content -->
+<img src="/images/sample-blog-post.jpg" alt="Sample Post">
+<img src="/images/placeholder-team.jpg" alt="Team Member">
+\`\`\`
+
+### Image Field Pattern
+
+Always wrap image fields in conditionals since they may not be set:
+
+\`\`\`html
+{{#if mainImage}}
+  <img src="{{mainImage}}" alt="{{name}}" class="hero-image">
+{{/if}}
+\`\`\`
+
+### Custom Collection Image Fields
+
+For custom collections, the **token name matches the field slug** defined when creating the collection.
+
+**Example:** A "video" collection with these fields:
+- \`videothumbnail\` (type: image)
+- \`ogimage\` (type: image)
+- \`shortdescription\` (type: text)
+
+**Template uses the field slugs as tokens:**
+\`\`\`html
+{{#each video sort="publishedAt" order="desc"}}
+<article class="video-card">
+  {{#if videothumbnail}}
+    <img src="{{videothumbnail}}" alt="{{name}}">
+  {{/if}}
+  <h2><a href="{{url}}">{{name}}</a></h2>
+  <p>{{shortdescription}}</p>
+</article>
+{{/each}}
+\`\`\`
+
+**To find exact field slugs for a tenant's custom collections, use the \`get_tenant_schema\` tool.**
+
+### Common Mistakes to Avoid
+
+1. **Replacing logos/icons with CMS tokens** - Static UI images should stay as \`/public/\` paths
+2. **Hardcoding example blog/product content** - Use \`{{#each}}\` loops with CMS tokens
+3. **Missing \`{{#each}}\` loops** - Dynamic content requires iteration over the collection
+4. **Wrong field names** - Token must match the exact field slug (case-sensitive)
+
+---
+
 ## CMS Template Configuration
 
 Templates are configured in manifest.json using a **flat format** that is the SINGLE SOURCE OF TRUTH for URL paths.

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.21",
+  "version": "1.0.23",
   "description": "MCP server for AI-assisted website conversion to CMS format. Provides validation, examples, and schema tools.",
   "main": "dist/index.js",
   "bin": {