multisite-cms-mcp 1.5.7 → 1.5.9

package/dist/index.js

@@ -15,6 +15,7 @@ const create_site_1 = require("./tools/create-site");
 const deploy_package_1 = require("./tools/deploy-package");
 const get_field_types_1 = require("./tools/get-field-types");
 const sync_schema_1 = require("./tools/sync-schema");
+const generate_samples_1 = require("./tools/generate-samples");
 const server = new index_js_1.Server({
     name: 'multisite-cms',
     version: '1.0.0',
@@ -119,6 +120,7 @@ const TOOLS = [
                         'equality_comparison',
                         'youtube_embed',
                         'nested_collection_loop',
+                        'loop_variables',
                     ],
                     description: 'The type of example to retrieve',
                 },
@@ -290,6 +292,25 @@ const TOOLS = [
             required: ['projectId'],
         },
     },
+    {
+        name: 'generate_sample_items',
+        description: 'Generate sample items for collections with placeholder content. Automatically handles dependency ordering - collections with relation fields are populated after their parent collections. Use this after creating new collections with sync_schema to preview how they will look. Requires authentication.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project ID (UUID) or project name. Use list_projects to see available projects.',
+                },
+                collectionSlugs: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional: Specific collection slugs to generate samples for. If not provided, generates samples for all empty collections.',
+                },
+            },
+            required: ['projectId'],
+        },
+    },
 ];
 // Handle list tools request
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
@@ -349,6 +370,12 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     fieldsToAdd: params.fieldsToAdd,
                 });
                 break;
+            case 'generate_sample_items':
+                result = await (0, generate_samples_1.generateSampleItems)({
+                    projectId: params.projectId,
+                    collectionSlugs: params.collectionSlugs,
+                });
+                break;
             default:
                 return {
                     content: [{ type: 'text', text: `Unknown tool: ${name}` }],

package/dist/tools/generate-samples.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generate Sample Items Tool
+ *
+ * Generates sample items for collections with automatic dependency ordering.
+ * Handles relation fields by generating parent collections first.
+ * Requires authentication.
+ */
+interface GenerateSamplesInput {
+    projectId: string;
+    collectionSlugs?: string[];
+}
+/**
+ * Generate sample items for collections
+ *
+ * @param input - The input with projectId and optional collectionSlugs
+ */
+export declare function generateSampleItems(input: GenerateSamplesInput): Promise<string>;
+export {};
+//# sourceMappingURL=generate-samples.d.ts.map

package/dist/tools/generate-samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-samples.d.ts","sourceRoot":"","sources":["../../src/tools/generate-samples.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH,UAAU,oBAAoB;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAmID;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoLtF"}

package/dist/tools/generate-samples.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * Generate Sample Items Tool
+ *
+ * Generates sample items for collections with automatic dependency ordering.
+ * Handles relation fields by generating parent collections first.
+ * Requires authentication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSampleItems = generateSampleItems;
+const api_client_1 = require("../lib/api-client");
+const device_flow_1 = require("../lib/device-flow");
+// ============ Constants ============
+const AUTH_REQUIRED_MESSAGE = `# Authentication Required
+
+This tool requires authentication to generate sample items.
+
+**To authenticate:**
+1. Set the FASTMODE_AUTH_TOKEN environment variable, OR
+2. Run this tool again and follow the browser-based login flow
+
+Use \`list_projects\` to verify your authentication status.
+`;
+// ============ Helper Functions ============
+/**
+ * Resolve project identifier to tenant ID
+ */
+async function resolveProjectId(projectIdentifier) {
+    const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidPattern.test(projectIdentifier)) {
+        return { tenantId: projectIdentifier };
+    }
+    const response = await (0, api_client_1.apiRequest)('/api/tenants');
+    if ((0, api_client_1.isApiError)(response)) {
+        return { error: `Failed to look up project: ${response.error}` };
+    }
+    const match = response.data.find(p => p.name.toLowerCase() === projectIdentifier.toLowerCase());
+    if (match) {
+        return { tenantId: match.id };
+    }
+    const partialMatch = response.data.find(p => p.name.toLowerCase().includes(projectIdentifier.toLowerCase()));
+    if (partialMatch) {
+        return { tenantId: partialMatch.id };
+    }
+    return {
+        error: `Project "${projectIdentifier}" not found. Use list_projects to see available projects.`
+    };
+}
+/**
+ * Topological sort of collections based on relation dependencies
+ * Returns collections ordered so that dependencies come first
+ */
+function sortByDependencies(collections) {
+    const slugToCollection = new Map();
+    const inDegree = new Map();
+    const adjacencyList = new Map();
+    // Initialize
+    for (const col of collections) {
+        slugToCollection.set(col.slug, col);
+        inDegree.set(col.slug, 0);
+        adjacencyList.set(col.slug, []);
+    }
+    // Build dependency graph
+    // If collection A has a relation to collection B, then B must be populated first
+    // So B -> A (B is a dependency of A)
+    for (const col of collections) {
+        for (const field of col.fields) {
+            if (field.type === 'relation' && field.referenceCollection) {
+                const refSlug = field.referenceCollection;
+                // Only count if the referenced collection is in our list
+                if (slugToCollection.has(refSlug)) {
+                    // refSlug must come before col.slug
+                    const deps = adjacencyList.get(refSlug) || [];
+                    deps.push(col.slug);
+                    adjacencyList.set(refSlug, deps);
+                    inDegree.set(col.slug, (inDegree.get(col.slug) || 0) + 1);
+                }
+            }
+        }
+    }
+    // Kahn's algorithm for topological sort
+    const queue = [];
+    const result = [];
+    // Start with nodes that have no dependencies
+    for (const [slug, degree] of inDegree) {
+        if (degree === 0) {
+            queue.push(slug);
+        }
+    }
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const col = slugToCollection.get(current);
+        if (col) {
+            result.push(col);
+        }
+        // Reduce in-degree for dependent collections
+        const dependents = adjacencyList.get(current) || [];
+        for (const dep of dependents) {
+            const newDegree = (inDegree.get(dep) || 0) - 1;
+            inDegree.set(dep, newDegree);
+            if (newDegree === 0) {
+                queue.push(dep);
+            }
+        }
+    }
+    // If there are still collections not in result (cycle detected), add them anyway
+    for (const col of collections) {
+        if (!result.find(c => c.slug === col.slug)) {
+            result.push(col);
+        }
+    }
+    return result;
+}
+// ============ Main Function ============
+/**
+ * Generate sample items for collections
+ *
+ * @param input - The input with projectId and optional collectionSlugs
+ */
+async function generateSampleItems(input) {
+    // Check authentication
+    if (await (0, api_client_1.needsAuthentication)()) {
+        const authResult = await (0, device_flow_1.ensureAuthenticated)();
+        if (!authResult.authenticated) {
+            return AUTH_REQUIRED_MESSAGE;
+        }
+    }
+    const { projectId, collectionSlugs } = input;
+    // Validate input
+    if (!projectId) {
+        return `# Error: Missing projectId
+
+Please provide a projectId. Use \`list_projects\` to see your available projects.
+`;
+    }
+    // Resolve project ID
+    const resolved = await resolveProjectId(projectId);
+    if ('error' in resolved) {
+        return `# Project Not Found
+
+${resolved.error}
+`;
+    }
+    const { tenantId } = resolved;
+    // Fetch all collections for this project
+    const collectionsRes = await (0, api_client_1.apiRequest)('/api/collections', { tenantId });
+    if ((0, api_client_1.isApiError)(collectionsRes)) {
+        // Check if auth error
+        if (collectionsRes.error.includes('401') || collectionsRes.error.includes('auth')) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated) {
+                return AUTH_REQUIRED_MESSAGE;
+            }
+        }
+        return `# Error
+
+Failed to fetch collections: ${collectionsRes.error}
+`;
+    }
+    const allCollections = collectionsRes.data;
+    if (allCollections.length === 0) {
+        return `# No Collections Found
+
+This project has no collections yet. Use \`sync_schema\` to create collections first.
+`;
+    }
+    // Determine which collections to generate samples for
+    let targetCollections;
+    if (collectionSlugs && collectionSlugs.length > 0) {
+        // Specific collections requested
+        targetCollections = [];
+        const notFound = [];
+        for (const slug of collectionSlugs) {
+            const col = allCollections.find(c => c.slug.toLowerCase() === slug.toLowerCase());
+            if (col) {
+                targetCollections.push(col);
+            }
+            else {
+                notFound.push(slug);
+            }
+        }
+        if (notFound.length > 0) {
+            return `# Collections Not Found
+
+The following collections were not found: ${notFound.join(', ')}
+
+Available collections: ${allCollections.map(c => c.slug).join(', ')}
+`;
+        }
+    }
+    else {
+        // All collections - check which ones are empty
+        const emptyCollections = [];
+        for (const col of allCollections) {
+            const itemsRes = await (0, api_client_1.apiRequest)(`/api/collections/${col.id}/items`, { tenantId });
+            if (!(0, api_client_1.isApiError)(itemsRes) && itemsRes.data.length === 0) {
+                emptyCollections.push(col);
+            }
+        }
+        if (emptyCollections.length === 0) {
+            return `# No Empty Collections
+
+All collections already have items. To regenerate samples for specific collections, provide their slugs.
+
+Collections with items: ${allCollections.map(c => c.slug).join(', ')}
+`;
+        }
+        targetCollections = emptyCollections;
+    }
+    // Sort collections by dependencies (parents first)
+    const sortedCollections = sortByDependencies(targetCollections);
+    // Generate samples for each collection in order
+    const results = [];
+    const generated = [];
+    const failed = [];
+    results.push('## Generation Order\n');
+    results.push('Collections are processed in dependency order (parent collections first):\n');
+    results.push(sortedCollections.map((c, i) => `${i + 1}. ${c.name} (\`${c.slug}\`)`).join('\n'));
+    results.push('\n');
+    for (const col of sortedCollections) {
+        // Check for relation fields and their dependencies
+        const relationFields = col.fields.filter(f => f.type === 'relation' && f.referenceCollection);
+        const dependencies = relationFields.map(f => f.referenceCollection).filter(Boolean);
+        let dependencyNote = '';
+        if (dependencies.length > 0) {
+            dependencyNote = ` (depends on: ${dependencies.join(', ')})`;
+        }
+        // Call the generate-samples endpoint
+        const generateRes = await (0, api_client_1.apiRequest)(`/api/collections/${col.id}/generate-samples`, {
+            tenantId,
+            method: 'POST',
+        });
+        if ((0, api_client_1.isApiError)(generateRes)) {
+            failed.push({ collection: col.slug, error: generateRes.error });
+            results.push(`❌ **${col.name}** - Failed: ${generateRes.error}${dependencyNote}`);
+        }
+        else {
+            const count = generateRes.data.data?.length || 5;
+            generated.push({ collection: col.slug, count });
+            results.push(`✅ **${col.name}** - Generated ${count} sample items${dependencyNote}`);
+        }
+    }
+    // Build summary
+    let output = `# Sample Items Generated
+
+**Project ID:** \`${tenantId}\`
+
+## Summary
+
+| Metric | Count |
+|--------|-------|
+| Collections Processed | ${sortedCollections.length} |
+| Successfully Generated | ${generated.length} |
+| Failed | ${failed.length} |
+
+${results.join('\n')}
+`;
+    if (failed.length > 0) {
+        output += `\n## Errors\n\n`;
+        for (const f of failed) {
+            output += `- **${f.collection}**: ${f.error}\n`;
+        }
+    }
+    if (generated.length > 0) {
+        output += `\n---\n\n**Next Steps:**
+- View the generated items in the CMS dashboard
+- Edit or delete sample items as needed
+- These are placeholder items - replace with real content when ready
+`;
+    }
+    return output;
+}

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,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AA+2BlJ;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA0D1E"}
+{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAu4BlJ;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA2D1E"}

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

@@ -36,7 +36,9 @@ Based on what \`list_projects\` returns:
 2. Call \`create_site(name)\` to create the project
 3. You'll receive a projectId to use for deployment
 4. After building the package, call \`sync_schema\` to create collections/fields
-5. Proceed to Phase 1 (Website Analysis)
+5. **Ask the user:** "Would you like me to generate sample items so you can preview how the collections will look?"
+6. If yes, call \`generate_sample_items(projectId)\` - it handles dependency ordering automatically
+7. Proceed to Phase 1 (Website Analysis)
 
 ---
 
@@ -577,10 +579,32 @@ Use \`@root.\` to access collections from the root context when you need to be e
 \`\`\`
 
 ## Loop Variables
-Inside {{#each}}:
+Inside {{#each}} loops, these special variables are available:
+
+**Standalone tokens:**
 - \`{{@first}}\` - true for first item
 - \`{{@last}}\` - true for last item  
-- \`{{@index}}\` - zero-based index
+- \`{{@index}}\` - zero-based index (0, 1, 2...)
+- \`{{@length}}\` - total number of items
+
+**Conditional usage:**
+\`\`\`html
+{{#each posts}}
+  {{#if @first}}<div class="featured">{{/if}}
+  {{#unless @first}}<hr class="separator">{{/unless}}
+  <article>{{name}}</article>
+  {{#unless @last}},{{/unless}}
+{{/each}}
+\`\`\`
+
+| Pattern | Use Case |
+|---------|----------|
+| \`{{#if @first}}\` | Style first item differently |
+| \`{{#unless @first}}\` | Add separator before all but first |
+| \`{{#if @last}}\` | Style last item differently |
+| \`{{#unless @last}}\` | Add comma/separator after all but last |
+
+**Important:** Loop variables only work inside \`{{#each}}\` blocks. Using them outside a loop will not work.
 
 ## Parent Context (\`../\`)
 Inside loops, access the parent scope:
@@ -923,6 +947,7 @@ Use these MCP tools during conversion:
 - \`validate_manifest\` - Check your manifest.json
 - \`validate_template\` - Check template token usage
 - \`validate_package\` - Full package validation
+- \`generate_sample_items\` - Create placeholder items after creating new collections (handles relation dependencies automatically)
 
 **Validate as you work** - don't wait until the end!`;
     }

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' | 'image_handling' | 'relation_fields' | 'data_edit_keys' | 'each_loop' | 'conditional_if' | 'nested_fields' | 'featured_posts' | 'parent_context' | 'equality_comparison' | 'youtube_embed' | 'nested_collection_loop';
+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' | 'relation_fields' | 'data_edit_keys' | 'each_loop' | 'conditional_if' | 'nested_fields' | 'featured_posts' | 'parent_context' | 'equality_comparison' | 'youtube_embed' | 'nested_collection_loop' | 'loop_variables';
 /**
  * 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,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,eAAe,GACf,wBAAwB,CAAC;AAmqC7B;;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,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,eAAe,GACf,wBAAwB,GACxB,gBAAgB,CAAC;AAgvCrB;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}

package/dist/tools/get-example.js

@@ -1162,6 +1162,82 @@ This sidebar pattern can be included on:
 This gives you URLs like:
 - \`/docs\` - Documentation index showing all categories with their pages
 - \`/docs/quick-start-guide\` - Individual doc page`,
+    loop_variables: `# Loop Variables
+
+Special variables available inside \`{{#each}}\` loops.
+
+## Available Variables
+
+| Variable | Description |
+|----------|-------------|
+| \`{{@index}}\` | Zero-based index (0, 1, 2...) |
+| \`{{@first}}\` | True for first item only |
+| \`{{@last}}\` | True for last item only |
+| \`{{@length}}\` | Total number of items |
+
+---
+
+## Conditional Usage
+
+Use loop variables in conditionals for styling:
+
+\`\`\`html
+{{#each team_members}}
+  {{#if @first}}
+    <div class="featured-member">{{name}} - Team Lead</div>
+  {{else}}
+    <div class="member">{{name}}</div>
+  {{/if}}
+{{/each}}
+\`\`\`
+
+---
+
+## Common Patterns
+
+### Add separator between items (not before first):
+\`\`\`html
+{{#each tags}}
+  {{#unless @first}} | {{/unless}}
+  <span>{{name}}</span>
+{{/each}}
+\`\`\`
+Output: \`Tag1 | Tag2 | Tag3\`
+
+### Comma-separated list (no comma after last):
+\`\`\`html
+{{#each authors}}
+  <span>{{name}}</span>{{#unless @last}}, {{/unless}}
+{{/each}}
+\`\`\`
+Output: \`Alice, Bob, Charlie\`
+
+### Style first and last items:
+\`\`\`html
+{{#each posts}}
+  <article class="{{#if @first}}first{{/if}} {{#if @last}}last{{/if}}">
+    {{name}}
+  </article>
+{{/each}}
+\`\`\`
+
+### Show position number:
+\`\`\`html
+{{#each leaderboard}}
+  <div class="rank-{{@index}}">
+    #{{@index}}: {{name}} - {{score}} points
+  </div>
+{{/each}}
+\`\`\`
+
+---
+
+## Important Notes
+
+- Loop variables **only work inside \`{{#each}}\`** blocks
+- Using them outside a loop will not work and will log a warning
+- \`{{#unless @first}}\` is the opposite of \`{{#if @first}}\`
+- \`{{#unless @last}}\` is the opposite of \`{{#if @last}}\``,
 };
 /**
  * Returns example code for a specific pattern

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

@@ -1 +1 @@
-{"version":3,"file":"validate-template.d.ts","sourceRoot":"","sources":["../../src/tools/validate-template.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AAmRrE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA4djB"}
+{"version":3,"file":"validate-template.d.ts","sourceRoot":"","sources":["../../src/tools/validate-template.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AAuTrE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAkejB"}

package/dist/tools/validate-template.js

@@ -205,6 +205,36 @@ function extractCollectionReferences(html) {
     }
     return [...new Set(collections)]; // Unique collections
 }
+/**
+ * Validate that loop variables (@first, @last, @index) are only used inside {{#each}} blocks
+ * Returns warnings for any usage found outside loops
+ */
+function validateLoopVariables(html) {
+    const warnings = [];
+    // Find all @first, @last, @index, @length usage (standalone or in conditionals)
+    const loopVarPattern = /\{\{[#/]?(?:if|unless)?\s*@(first|last|index|length)[^}]*\}\}/g;
+    // Find all {{#each}}...{{/each}} blocks
+    // Use a simple approach: remove all loop content and check what's left
+    let outsideLoops = html;
+    // Repeatedly remove innermost loops until none left
+    // This handles nested loops correctly
+    let previousLength = 0;
+    while (outsideLoops.length !== previousLength) {
+        previousLength = outsideLoops.length;
+        // Match non-greedy: find {{#each...}} followed by content without nested {{#each}}, then {{/each}}
+        outsideLoops = outsideLoops.replace(/\{\{#each[^}]*\}\}(?:(?!\{\{#each)[\s\S])*?\{\{\/each\}\}/g, '');
+    }
+    // Now check if any loop variables remain in the content outside loops
+    const matches = outsideLoops.match(loopVarPattern);
+    if (matches && matches.length > 0) {
+        const uniqueVars = [...new Set(matches.map(m => {
+                const varMatch = m.match(/@(first|last|index|length)/);
+                return varMatch ? `@${varMatch[1]}` : m;
+            }))];
+        warnings.push(`- Loop variables (${uniqueVars.join(', ')}) found outside {{#each}} blocks. These only work inside loops.`);
+    }
+    return warnings;
+}
 /**
  * Validates an HTML template for correct CMS token usage
  *
@@ -279,6 +309,11 @@ async function validateTemplate(html, templateType, collectionSlug, projectId) {
     if (unlessOpens !== unlessCloses) {
         errors.push(`- Unbalanced {{#unless}}: ${unlessOpens} opens, ${unlessCloses} closes`);
     }
+    // Check for loop variables (@first, @last, @index) used outside {{#each}} blocks
+    const loopVarWarnings = validateLoopVariables(html);
+    for (const warning of loopVarWarnings) {
+        warnings.push(warning);
+    }
     // Check for data-edit-key in static pages
     if (templateType === 'static_page') {
         const editKeys = html.match(/data-edit-key="[^"]+"/g) || [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.5.7",
+  "version": "1.5.9",
   "description": "MCP server for Fast Mode CMS. Convert websites, validate packages, and deploy directly to Fast Mode. Includes authentication, project creation, schema sync, and one-click deployment.",
   "main": "dist/index.js",
   "bin": {