multisite-cms-mcp 1.0.13 → 1.0.15

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

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

@@ -422,6 +422,20 @@ Use for rich text content:
 {{/unless}}
 \`\`\`
 
+## Equality Comparisons
+\`\`\`html
+<!-- Show when equal -->
+{{#if (eq fieldA fieldB)}}...{{/if}}
+
+<!-- Show when NOT equal (common for Related Posts) -->
+{{#unless (eq slug ../slug)}}
+  <a href="{{url}}">{{name}}</a>
+{{/unless}}
+
+<!-- Compare to literal string -->
+{{#eq status "published"}}...{{/eq}}
+\`\`\`
+
 ## Loop Variables
 Inside {{#each}}:
 - \`{{@first}}\` - true for first item
@@ -431,12 +445,19 @@ Inside {{#each}}:
 ## Parent Context (\`../\`)
 Inside loops, access the parent scope:
 \`\`\`html
+<!-- Filter posts by current author -->
 {{#each blogs}}
   {{#if (eq author.name ../name)}}
-    <!-- Only show posts by current author -->
     <h3>{{name}}</h3>
   {{/if}}
 {{/each}}
+
+<!-- Related Posts (exclude current) -->
+{{#each blogs limit=3}}
+  {{#unless (eq slug ../slug)}}
+    <a href="{{url}}">{{name}}</a>
+  {{/unless}}
+{{/each}}
 \`\`\`
 
 - \`../name\` - Parent item's name field

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;AAu0B1B;;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,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,CAAC;AA61B1B;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}

package/dist/tools/get-example.js

@@ -775,33 +775,47 @@ Inside loops, access the **parent scope** (the page's current item) using \`../\
 
 Compare two values using \`(eq field1 field2)\` helper:
 
-**Compare Two Fields:**
+## Show When Equal ({{#if (eq ...)}})
 \`\`\`html
 {{#if (eq author.slug ../slug)}}
   <span class="current-author-badge">✓ Your Post</span>
 {{/if}}
+\`\`\`
 
-{{#if (eq category selectedCategory)}}
-  <div class="active">{{name}}</div>
-{{/if}}
+## Show When NOT Equal ({{#unless (eq ...)}}) - IMPORTANT!
+The most common pattern for "Related Posts" or "Other Items" sections:
+
+\`\`\`html
+<!-- On a blog post page, show other posts EXCEPT the current one -->
+<h3>Related Posts</h3>
+{{#each blogs limit=3}}
+  {{#unless (eq slug ../slug)}}
+    <article>
+      <a href="{{url}}">{{name}}</a>
+      <p>{{postSummary}}</p>
+    </article>
+  {{/unless}}
+{{/each}}
 \`\`\`
 
-**Compare Field to Literal String (use {{#eq}}):**
+**How it works:**
+- \`../slug\` accesses the current page's slug (parent context)
+- \`slug\` is the loop item's slug
+- \`{{#unless (eq slug ../slug)}}\` shows content when they're NOT equal
+- This excludes the current post from the "related" list
+
+## Compare Field to Literal String ({{#eq}})
 \`\`\`html
 {{#eq status "published"}}
   <span class="badge badge-success">Published</span>
 {{/eq}}
 
-{{#eq type "featured"}}
-  <div class="featured-highlight">⭐ {{name}}</div>
-{{/eq}}
-
 {{#eq category "news"}}
   <span class="news-icon">📰</span>
 {{/eq}}
 \`\`\`
 
-**Inside Loops with Parent Context:**
+## Inside Loops with Parent Context
 \`\`\`html
 {{#each blogs}}
   <article class="{{#if (eq author.name ../name)}}highlight{{/if}}">
@@ -813,11 +827,19 @@ Compare two values using \`(eq field1 field2)\` helper:
 {{/each}}
 \`\`\`
 
+## Summary Table
+
+| Syntax | Shows content when... |
+|--------|----------------------|
+| \`{{#if (eq a b)}}\` | a equals b |
+| \`{{#unless (eq a b)}}\` | a does NOT equal b |
+| \`{{#eq field "value"}}\` | field equals "value" |
+
 **Common Use Cases:**
-- Filter items by current category/author/tag
-- Highlight active menu items
-- Show badges for specific statuses
-- Conditional styling based on relationships`,
+- Related posts (exclude current) - use \`{{#unless (eq slug ../slug)}}\`
+- Filter by current author/category - use \`{{#if (eq author.slug ../slug)}}\`
+- Highlight active items - use \`{{#if (eq ...)}}\`
+- Show badges for specific statuses - use \`{{#eq status "value"}}\``,
 };
 /**
  * Returns example code for a specific pattern

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,CAyQjD"}
+{"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,CA6TjD"}

package/dist/tools/get-schema.js

@@ -103,6 +103,7 @@ Downloadable files and documents.
 
 ### Conditionals
 \`\`\`html
+<!-- Check if a field has a value -->
 {{#if mainImage}}
   <img src="{{mainImage}}" alt="{{name}}">
 {{else}}
@@ -114,6 +115,50 @@ Downloadable files and documents.
 {{/unless}}
 \`\`\`
 
+### Collection Empty Checks (Page Level)
+Check if a collection has items - useful for "No posts yet" fallbacks:
+
+\`\`\`html
+{{#each blogs}}
+  <article>{{name}}</article>
+{{/each}}
+
+{{#unless blogs}}
+  <p>No posts yet. Check back soon!</p>
+{{/unless}}
+\`\`\`
+
+**Important:** The \`{{#if blogs}}\` and \`{{#unless blogs}}\` syntax checks if the collection has any published items. Use this OUTSIDE of \`{{#each}}\` loops for empty state handling.
+
+### Equality Comparisons in Conditionals
+Compare two field values using the \`(eq field1 field2)\` helper:
+
+\`\`\`html
+<!-- Show content when fields ARE equal -->
+{{#if (eq author.slug ../slug)}}
+  <span>This is your post!</span>
+{{/if}}
+
+<!-- Show content when fields are NOT equal -->
+{{#unless (eq slug ../slug)}}
+  <a href="{{url}}">{{name}}</a>
+{{/unless}}
+\`\`\`
+
+**Common use case - Related Posts (exclude current):**
+\`\`\`html
+<h3>Other Posts</h3>
+{{#each blogs limit=3}}
+  {{#unless (eq slug ../slug)}}
+    <article>
+      <a href="{{url}}">{{name}}</a>
+    </article>
+  {{/unless}}
+{{/each}}
+\`\`\`
+
+This pattern is essential for "Related Posts" sections where you want to show other posts but NOT the current one.
+
 ### Loop Variables
 Inside \`{{#each}}\` blocks:
 - \`{{@first}}\` - true for first item
@@ -149,17 +194,24 @@ Inside loops, access the parent scope (page's current item) using \`../\`:
 - Category pages: filter items by current category
 - Related items: match based on current detail page
 
-### Equality Comparisons
-Compare two values in conditionals:
+### Equality Helpers Summary
 
+| Syntax | When to use | Shows content when... |
+|--------|-------------|----------------------|
+| \`{{#if (eq field1 field2)}}\` | Compare two fields | Fields ARE equal |
+| \`{{#unless (eq field1 field2)}}\` | Exclude matches | Fields are NOT equal |
+| \`{{#eq field "value"}}\` | Compare to string | Field equals string |
+
+**Examples:**
 \`\`\`html
-{{#if (eq author.name ../name)}}
-  <!-- True when fields match -->
-{{/if}}
+<!-- Show only when author matches current page -->
+{{#if (eq author.slug ../slug)}}...{{/if}}
+
+<!-- Show all EXCEPT current item (Related Posts pattern) -->
+{{#unless (eq slug ../slug)}}...{{/unless}}
 
-{{#eq status "published"}}
-  <!-- Compare field to literal string -->
-{{/eq}}
+<!-- Compare field to a literal value -->
+{{#eq status "published"}}...{{/eq}}
 \`\`\`
 
 ### Rich Text (Triple Braces)

package/package.json

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