multisite-cms-mcp 1.0.7 → 1.0.9

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

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

@@ -61,10 +61,10 @@ Do NOT change it to \`/blog\`.
 Use the manifest's path configuration to maintain original URLs.`,
     structure: `# Package Structure
 
-Create a ZIP file with this exact structure:
+Create a package with this structure (can be at repo root OR in a subfolder like cms_package/):
 
 \`\`\`
-website-package.zip
+website-package/           # Can be at root or in a subfolder
 ├── manifest.json          # Required: Defines pages and CMS templates
 ├── public/                # Static assets (CSS, JS, images, fonts)
 │   ├── css/
@@ -84,6 +84,26 @@ website-package.zip
     └── downloads.html
 \`\`\`
 
+**SUPPORTED REPO STRUCTURES:**
+\`\`\`
+Option 1: CMS files at root
+repo/
+├── manifest.json
+├── pages/
+├── public/
+└── templates/
+
+Option 2: CMS files in subfolder (e.g. for Next.js projects)
+repo/
+├── app/                   # Next.js app (ignored)
+├── cms_package/           # CMS files here
+│   ├── manifest.json
+│   ├── pages/
+│   ├── public/
+│   └── templates/
+└── package.json
+\`\`\`
+
 ## Folder Rules
 
 ### public/
@@ -122,7 +142,10 @@ website-package.zip
     "team": "templates/team.html",
     "teamPath": "/team",
     "downloads": "templates/downloads.html",
-    "downloadsPath": "/downloads"
+    "downloadsPath": "/downloads",
+    "authorsIndex": "templates/authors_index.html",
+    "authorDetail": "templates/author_detail.html",
+    "authorsIndexPath": "/authors"
   },
   "defaultHeadHtml": "<!-- fonts, meta tags -->"
 }
@@ -144,6 +167,7 @@ Each page needs:
 - \`blogPostPath: "/resources"\` → Posts at /resources/post-slug
 - \`teamPath: "/about/team"\` → Team at /about/team
 - \`downloadsPath: "/library"\` → Downloads at /library
+- \`authorsIndexPath: "/contributors"\` → Authors at /contributors, detail at /contributors/slug
 
 **IMPORTANT:** Match paths to the original site's URLs!
 
@@ -169,7 +193,7 @@ For dynamic collections beyond the built-ins:
 2. **Detail Templates** - Single item pages (blog_post.html)
 3. **Static Pages** - Fixed content with data-edit-key
 
-## Index Template Pattern
+## Index Template Pattern (Blog List)
 
 \`\`\`html
 <main class="blog-page">
@@ -192,7 +216,15 @@ For dynamic collections beyond the built-ins:
 </main>
 \`\`\`
 
-## Detail Template Pattern
+**CRITICAL FIELD NAMES for blogs:**
+- \`{{name}}\` = Post title (NOT {{title}})
+- \`{{mainImage}}\` = Hero image (NOT {{coverImageUrl}})
+- \`{{thumbnailImage}}\` = Preview image
+- \`{{postSummary}}\` = Excerpt (NOT {{excerpt}})
+- \`{{{postBody}}}\` = Content (NOT {{bodyHtml}}, uses TRIPLE braces)
+- \`{{url}}\` = Generated link to detail page
+
+## Detail Template Pattern (Blog Post)
 
 \`\`\`html
 <article class="blog-post">
@@ -208,12 +240,101 @@ For dynamic collections beyond the built-ins:
     </div>
   {{/if}}
   
+  {{#if publishedAt}}
+    <time>{{publishedAt}}</time>
+  {{/if}}
+  
   <div class="content">
     {{{postBody}}}
   </div>
 </article>
 \`\`\`
 
+## Team Template Pattern
+
+\`\`\`html
+<div class="team-grid">
+  {{#each team sort="order" order="asc"}}
+  <div class="team-member">
+    {{#if photo}}
+      <img src="{{photo}}" alt="{{name}}">
+    {{/if}}
+    <h3>{{name}}</h3>
+    {{#if role}}
+      <p class="role">{{role}}</p>
+    {{/if}}
+    {{#if bio}}
+      <div class="bio">{{{bio}}}</div>
+    {{/if}}
+  </div>
+  {{/each}}
+</div>
+\`\`\`
+
+**CRITICAL FIELD NAMES for team:**
+- \`{{name}}\` = Team member name
+- \`{{role}}\` = Job title
+- \`{{photo}}\` = Headshot (NOT {{picture}})
+- \`{{{bio}}}\` = Biography (TRIPLE braces for HTML)
+- \`{{order}}\` = Display order
+
+## Author Index Template Pattern
+
+\`\`\`html
+<div class="authors-grid">
+  {{#each authors}}
+  <div class="author-card">
+    {{#if picture}}
+      <img src="{{picture}}" alt="{{name}}">
+    {{/if}}
+    <h3><a href="{{url}}">{{name}}</a></h3>
+    {{#if bio}}
+      <div class="bio-excerpt">{{{bio}}}</div>
+    {{/if}}
+  </div>
+  {{/each}}
+</div>
+\`\`\`
+
+## Author Detail Template Pattern
+
+\`\`\`html
+<article class="author-profile">
+  {{#if picture}}
+    <img src="{{picture}}" alt="{{name}}" class="author-photo">
+  {{/if}}
+  
+  <h1>{{name}}</h1>
+  
+  {{#if bio}}
+    <div class="bio">{{{bio}}}</div>
+  {{/if}}
+  
+  {{#if email}}
+    <a href="mailto:{{email}}">{{email}}</a>
+  {{/if}}
+  
+  <!-- Posts by this author -->
+  <h2>Posts by {{name}}</h2>
+  {{#each blogs}}
+    {{#if (eq author.name ../name)}}
+      <article>
+        <h3><a href="{{url}}">{{name}}</a></h3>
+        <p>{{postSummary}}</p>
+      </article>
+    {{/if}}
+  {{/each}}
+</article>
+\`\`\`
+
+**CRITICAL FIELD NAMES for authors:**
+- \`{{name}}\` = Author name
+- \`{{picture}}\` = Author photo (NOT {{photo}})
+- \`{{{bio}}}\` = Biography (TRIPLE braces for HTML)
+- \`{{email}}\` = Email address
+- \`{{url}}\` = Link to author detail page
+- Use \`{{#if (eq author.name ../name)}}\` to filter posts by current author
+
 ## Static Page Pattern
 
 \`\`\`html

package/dist/tools/get-example.js

@@ -68,7 +68,7 @@ When your site uses different URLs than the defaults:
     "downloadsPath": "/resources",
     "authorsIndex": "templates/contributors.html",
     "authorDetail": "templates/contributor.html",
-    "authorsPath": "/contributors"
+    "authorsIndexPath": "/contributors"
   }
 }
 \`\`\`

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,CAuH5E"}
+{"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,CAoI5E"}

package/dist/tools/validate-manifest.js

@@ -19,7 +19,7 @@ const cmsTemplatesSchema = zod_1.z.object({
     downloadsPath: zod_1.z.string().startsWith('/').optional(),
     authorsIndex: zod_1.z.string().optional(),
     authorDetail: zod_1.z.string().optional(),
-    authorsPath: zod_1.z.string().startsWith('/').optional(),
+    authorsIndexPath: zod_1.z.string().startsWith('/').optional(),
     collectionPaths: zod_1.z.record(zod_1.z.string().startsWith('/')).optional(),
 }).optional();
 const manifestSchema = zod_1.z.object({
@@ -109,6 +109,17 @@ The manifest.json file is not valid JSON. Check for:
         if (templates.blogIndexPath !== templates.blogPostPath && templates.blogIndexPath && templates.blogPostPath) {
             warnings.push(`- blogIndexPath (${templates.blogIndexPath}) differs from blogPostPath (${templates.blogPostPath}) - usually these should match`);
         }
+        // Check for common author path mistake
+        if (templates.authorsPath && !templates.authorsIndexPath) {
+            warnings.push('- Found "authorsPath" but expected "authorsIndexPath" - rename to authorsIndexPath');
+        }
+        // Check author template consistency
+        if (templates.authorsIndex && !templates.authorsIndexPath) {
+            warnings.push('- authorsIndex template defined but no authorsIndexPath - will default to /authors');
+        }
+        if (templates.authorDetail && !templates.authorsIndex) {
+            warnings.push('- authorDetail template defined but no authorsIndex - authors need both templates');
+        }
     }
     // Build result
     let output = '';

package/package.json

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