multisite-cms-mcp 1.6.2 → 1.7.1

package/README.md

@@ -27,12 +27,34 @@ Fast Mode is a modern CMS platform that turns static HTML websites into fully ed
 
 This MCP server provides tools for AI assistants (Claude, Cursor, etc.) to help you convert websites to Fast Mode format and deploy them.
 
+### IMPORTANT: Start with get_started
+
+The `get_started` tool is your entry point for any task. It automatically:
+- Checks authentication status
+- Lists your projects with status
+- Shows collection/field details
+- Returns the exact workflow for your task
+
+```
+get_started(intent: "add_content", projectId: "my-project")
+```
+
+**Available intents:**
+| Intent | Use Case |
+|--------|----------|
+| `explore` | See what projects and content exist |
+| `add_content` | Create/edit CMS items (blog posts, team, etc.) |
+| `update_schema` | Add collections or fields |
+| `convert` | Build a new website from scratch |
+| `deploy` | Push changes live |
+
 ### Validation Tools (No Auth Required)
 
 These tools work without authentication — perfect for converting and validating websites before deploying:
 
 | Tool | Description |
 |------|-------------|
+| `get_started` | **CALL FIRST** - Checks state and returns exact workflow |
 | `get_field_types` | Get available field types for creating custom fields |
 | `validate_manifest` | Validate your manifest.json file |
 | `validate_template` | Check HTML templates for correct token usage, form handling, and schema validation |
@@ -131,9 +153,15 @@ Add to your Claude config:
 
 ## Quick Start
 
-### 1. Convert a Website
+### 1. Start with get_started
+
+Ask your AI assistant what you want to do:
 
-Ask your AI assistant:
+> "I want to add some blog posts to my Fast Mode site"
+
+The AI will call `get_started(intent: "add_content")` to see your projects and schema.
+
+### 2. Convert a Website
 
 > "Convert this website to Fast Mode format"
 
@@ -207,11 +235,26 @@ When you validate a template with a project ID, the tool will:
 | `datetime` | Date + time picker |
 | `image` | Image uploads (heroImage, thumbnail, photo) |
 | `url` | Links (website, social profiles) |
-| `videoEmbed` | Video URLs (YouTube, Vimeo, Wistia, Loom) |
+| `videoEmbed` | **Use for video content** - YouTube, Vimeo, Wistia, Loom. Template: `{{#videoEmbed field}}{{/videoEmbed}}` |
 | `email` | Email addresses |
 | `select` | Single dropdown choice (category, status) |
 | `multiSelect` | Multiple dropdown choices (tags) |
-| `relation` | Link to another collection (author → authors) |
+| `relation` | **Use for linked content** (author → authors). Template: `{{author.name}}`, `{{author.url}}` |
+
+### Field Type Tips
+
+The MCP server now provides intelligent field type suggestions when you use sync_schema:
+
+**For Video Content:**
+- Use `videoEmbed` type (NOT `url` or `text`)
+- Outputs responsive iframes with correct YouTube settings
+- Template: `{{#videoEmbed videoFieldName}}{{/videoEmbed}}`
+
+**For Linked Content:**
+- Use `relation` type (NOT `text`)
+- Links to items in another collection
+- Access with dot notation: `{{author.name}}`, `{{category.url}}`
+- Requires `referenceCollection` parameter
 
 ### Example: Adding Fields to Existing Collection
 
@@ -420,6 +463,14 @@ Use the `get_conversion_guide` tool for detailed instructions.
 
 ## Changelog
 
+### v1.7.0
+- **get_started Tool** — New intelligent entry point that detects project state and returns exact workflows
+- **Deploy Gate** — `deploy_package` now validates internally and BLOCKS deployment if there are errors
+- **Stricter Validations** — Missing loops, wrong collections, assets outside public/ are now errors (not warnings)
+- **Field Type Suggestions** — sync_schema provides tips when field names suggest better types (e.g., "video" → videoEmbed)
+- **Smart Detection** — validate_template detects video content and relation patterns with guidance
+- **Server Instructions** — Agents see guidance to call get_started first when connecting
+
 ### v1.6.0
 - **CMS Item Management** — New tools: `create_cms_item`, `list_cms_items`, `get_cms_item`, `update_cms_item`, `delete_cms_item`
 - **Delete Safety** — `delete_cms_item` requires explicit `confirmDelete: true` and prompts AI to ask user for permission

package/dist/index.js

@@ -16,7 +16,10 @@ 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 get_started_1 = require("./tools/get-started");
 const cms_items_1 = require("./tools/cms-items");
+// Server instructions - embedded in tool descriptions since MCP SDK doesn't have a dedicated field
+// The get_started tool description acts as the primary entry point guidance for agents
 const server = new index_js_1.Server({
     name: 'multisite-cms',
     version: '1.0.0',
@@ -27,6 +30,26 @@ const server = new index_js_1.Server({
 });
 // Define available tools
 const TOOLS = [
+    // get_started is the FIRST tool - agents should call this first
+    {
+        name: 'get_started',
+        description: 'CALL THIS FIRST. Intelligent entry point that checks authentication, lists your projects, and returns the exact workflow for your task. Provides schema details, field types, and example tool calls with real values.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                intent: {
+                    type: 'string',
+                    enum: ['explore', 'add_content', 'update_schema', 'convert', 'deploy'],
+                    description: 'What you want to do: explore (see projects), add_content (create/edit items), update_schema (add collections/fields), convert (new website), deploy (push changes)',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'Project ID or name to get detailed schema and workflow for',
+                },
+            },
+            required: [],
+        },
+    },
     {
         name: 'validate_manifest',
         description: 'Validate a manifest.json file for the CMS package. Returns errors if the structure is incorrect or required fields are missing.',
@@ -193,7 +216,7 @@ const TOOLS = [
     },
     {
         name: 'deploy_package',
-        description: 'Deploy a website package (.zip file) to Fast Mode. Requires a projectId - use list_projects to find existing projects or create_site to create a new one first. Will check for GitHub sync and block deployment if connected. Use force:true to override.',
+        description: 'FIRST: Call get_started(intent: "deploy") to check project state. Validates and deploys a website package (.zip file). BLOCKS deployment if validation errors exist. Requires a projectId. Will check for GitHub sync and block if connected. Use force:true to override GitHub check.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -224,7 +247,7 @@ const TOOLS = [
     },
     {
         name: 'sync_schema',
-        description: 'IMPORTANT: Create collections and fields in Fast Mode. Uses two-phase creation: all collections are created first, then all fields - so relation fields between collections always work regardless of order. Includes automatic retry for transient failures. Skips duplicates automatically. Call this BEFORE deploying. Requires authentication.',
+        description: 'FIRST: Call get_started(intent: "update_schema") to see current schema. Creates collections and fields in Fast Mode. Uses two-phase creation for relation fields. Skips duplicates. Provides field type suggestions. Call this BEFORE deploying. Requires authentication.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -316,7 +339,7 @@ const TOOLS = [
     },
     {
         name: 'create_cms_item',
-        description: 'Create a new item in a CMS collection. Use this to add content like blog posts, team members, or any custom collection items. Requires authentication.',
+        description: 'FIRST: Call get_started(intent: "add_content") to see collections and field types. Creates a new CMS item. For relation fields, pass the related item ID (not name). For richText fields, use HTML content. Requires authentication.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -403,7 +426,7 @@ const TOOLS = [
     },
     {
         name: 'update_cms_item',
-        description: 'Update an existing CMS item. Use this to modify content in a collection. Requires authentication.',
+        description: 'FIRST: Call get_started(intent: "add_content") to see collections and field types. Updates an existing CMS item. Only provided fields are changed. Requires authentication.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -437,7 +460,7 @@ const TOOLS = [
     },
     {
         name: 'delete_cms_item',
-        description: 'Delete a CMS item. IMPORTANT: You MUST get explicit permission from the user before calling this tool. Ask the user to confirm deletion first. Never delete without user confirmation. This action cannot be undone.',
+        description: 'FIRST: Call get_started(intent: "add_content"). REQUIRES explicit user confirmation before calling. Ask the user to confirm deletion first. Never delete without user confirmation. This action cannot be undone.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -473,6 +496,12 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     try {
         let result;
         switch (name) {
+            case 'get_started':
+                result = await (0, get_started_1.getStarted)({
+                    intent: params.intent,
+                    projectId: params.projectId,
+                });
+                break;
             case 'validate_manifest':
                 result = await (0, validate_manifest_1.validateManifest)(params.manifest);
                 break;

package/dist/lib/context-fetcher.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Context Fetcher
+ *
+ * Centralizes logic for fetching project state, collections, and content.
+ * Used by get_started and other tools that need project context.
+ */
+export interface ProjectSummary {
+    id: string;
+    name: string;
+    subdomain: string;
+    customDomain: string | null;
+    status: 'pending' | 'building' | 'published' | 'failed';
+    hasCollections: boolean;
+    collectionCount: number;
+    hasContent: boolean;
+    totalItems: number;
+    hasPendingChanges: boolean;
+    lastDeployedAt: string | null;
+    githubConnected: boolean;
+    githubRepo: string | null;
+}
+export interface CollectionField {
+    slug: string;
+    name: string;
+    type: string;
+    isRequired: boolean;
+    referenceCollection?: string;
+}
+export interface CollectionSummary {
+    slug: string;
+    name: string;
+    nameSingular: string;
+    fieldCount: number;
+    itemCount: number;
+    fields: CollectionField[];
+}
+export interface ProjectDetail {
+    id: string;
+    name: string;
+    subdomain: string;
+    customDomain: string | null;
+    status: 'pending' | 'building' | 'published' | 'failed';
+    collections: CollectionSummary[];
+    hasPendingChanges: boolean;
+    lastDeployedAt: string | null;
+    githubConnected: boolean;
+}
+export interface ProjectContext {
+    isAuthenticated: boolean;
+    projects: ProjectSummary[];
+    selectedProject?: ProjectDetail;
+}
+/**
+ * Fetch complete project context
+ *
+ * @param projectId - Optional specific project to get detailed info for
+ */
+export declare function fetchProjectContext(projectId?: string): Promise<ProjectContext>;
+/**
+ * Resolve a project identifier to a tenant ID
+ */
+export declare function resolveProjectId(projectIdentifier: string): Promise<{
+    tenantId: string;
+    name: string;
+    subdomain: string;
+} | null>;
+//# sourceMappingURL=context-fetcher.d.ts.map

package/dist/lib/context-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-fetcher.d.ts","sourceRoot":"","sources":["../../src/lib/context-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxD,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxD,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,aAAa,CAAC;CACjC;AAgHD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA6GrF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsCvI"}

package/dist/lib/context-fetcher.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Context Fetcher
+ *
+ * Centralizes logic for fetching project state, collections, and content.
+ * Used by get_started and other tools that need project context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchProjectContext = fetchProjectContext;
+exports.resolveProjectId = resolveProjectId;
+const api_client_1 = require("./api-client");
+// ============ Helper Functions ============
+/**
+ * Fetch all projects for the authenticated user
+ */
+async function fetchProjects() {
+    const response = await (0, api_client_1.apiRequest)('/api/tenants');
+    if ((0, api_client_1.isApiError)(response)) {
+        return [];
+    }
+    return response.data;
+}
+/**
+ * Fetch collections for a specific project
+ */
+async function fetchCollections(tenantId) {
+    const response = await (0, api_client_1.apiRequest)('/api/collections', { tenantId });
+    if ((0, api_client_1.isApiError)(response)) {
+        return [];
+    }
+    return response.data;
+}
+/**
+ * Fetch GitHub connection status for a project
+ */
+async function fetchGitHubStatus(tenantId) {
+    const response = await (0, api_client_1.apiRequest)('/api/github/site-connection', { tenantId });
+    if ((0, api_client_1.isApiError)(response)) {
+        return null;
+    }
+    return response.data;
+}
+// Note: fetchLatestDeploy could be used for detailed deploy state in the future
+// async function fetchLatestDeploy(tenantId: string): Promise<DeployLog | null> {
+//   const response = await apiRequest<DeployLog[]>('/api/deploy/history?limit=1', { tenantId });
+//   if (isApiError(response) || !response.data || response.data.length === 0) {
+//     return null;
+//   }
+//   return response.data[0];
+// }
+/**
+ * Fetch item counts for collections
+ */
+async function fetchCollectionItemCounts(tenantId, collectionSlugs) {
+    const counts = new Map();
+    // Fetch counts in parallel (limit concurrency)
+    const promises = collectionSlugs.slice(0, 10).map(async (slug) => {
+        const response = await (0, api_client_1.apiRequest)(`/api/collections/${slug}/items?limit=0`, { tenantId });
+        if (!(0, api_client_1.isApiError)(response) && response.data) {
+            counts.set(slug, response.data.total || 0);
+        }
+    });
+    await Promise.all(promises);
+    return counts;
+}
+// ============ Main Functions ============
+/**
+ * Fetch complete project context
+ *
+ * @param projectId - Optional specific project to get detailed info for
+ */
+async function fetchProjectContext(projectId) {
+    // Check authentication
+    const isAuthenticated = !(await (0, api_client_1.needsAuthentication)());
+    if (!isAuthenticated) {
+        return {
+            isAuthenticated: false,
+            projects: [],
+        };
+    }
+    // Fetch all projects
+    const tenants = await fetchProjects();
+    // Build project summaries
+    const projects = await Promise.all(tenants.map(async (tenant) => {
+        // Fetch collections for this project (for count)
+        const collections = await fetchCollections(tenant.id);
+        const collectionCount = collections.length;
+        // Calculate total items
+        let totalItems = 0;
+        for (const col of collections) {
+            if (col._count?.items) {
+                totalItems += col._count.items;
+            }
+        }
+        // Fetch GitHub status
+        const github = await fetchGitHubStatus(tenant.id);
+        return {
+            id: tenant.id,
+            name: tenant.name,
+            subdomain: tenant.subdomain,
+            customDomain: tenant.customDomain || null,
+            status: (tenant.site?.status || 'pending'),
+            hasCollections: collectionCount > 0,
+            collectionCount,
+            hasContent: totalItems > 0,
+            totalItems,
+            hasPendingChanges: tenant.site?.hasPendingChanges || false,
+            lastDeployedAt: tenant.site?.updatedAt || null,
+            githubConnected: github?.connected || false,
+            githubRepo: github?.repo || null,
+        };
+    }));
+    // If a specific project is requested, get detailed info
+    let selectedProject;
+    if (projectId) {
+        // Find the project
+        const tenant = tenants.find(t => t.id === projectId ||
+            t.name.toLowerCase() === projectId.toLowerCase() ||
+            t.subdomain.toLowerCase() === projectId.toLowerCase());
+        if (tenant) {
+            // Fetch collections with full field details
+            const collections = await fetchCollections(tenant.id);
+            // Fetch item counts
+            const itemCounts = await fetchCollectionItemCounts(tenant.id, collections.map(c => c.slug));
+            // Fetch GitHub status
+            const github = await fetchGitHubStatus(tenant.id);
+            // Build collection summaries
+            const collectionSummaries = collections.map(col => ({
+                slug: col.slug,
+                name: col.name,
+                nameSingular: col.nameSingular,
+                fieldCount: col.fields.length,
+                itemCount: itemCounts.get(col.slug) || col._count?.items || 0,
+                fields: col.fields.map(f => ({
+                    slug: f.slug,
+                    name: f.name,
+                    type: f.type,
+                    isRequired: f.isRequired || false,
+                    referenceCollection: f.referenceCollection,
+                })),
+            }));
+            selectedProject = {
+                id: tenant.id,
+                name: tenant.name,
+                subdomain: tenant.subdomain,
+                customDomain: tenant.customDomain || null,
+                status: (tenant.site?.status || 'pending'),
+                collections: collectionSummaries,
+                hasPendingChanges: tenant.site?.hasPendingChanges || false,
+                lastDeployedAt: tenant.site?.updatedAt || null,
+                githubConnected: github?.connected || false,
+            };
+        }
+    }
+    return {
+        isAuthenticated: true,
+        projects,
+        selectedProject,
+    };
+}
+/**
+ * Resolve a project identifier to a 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;
+    const tenants = await fetchProjects();
+    // Try exact UUID match
+    if (uuidPattern.test(projectIdentifier)) {
+        const tenant = tenants.find(t => t.id === projectIdentifier);
+        if (tenant) {
+            return { tenantId: tenant.id, name: tenant.name, subdomain: tenant.subdomain };
+        }
+    }
+    // Try exact name match
+    const exactMatch = tenants.find(t => t.name.toLowerCase() === projectIdentifier.toLowerCase());
+    if (exactMatch) {
+        return { tenantId: exactMatch.id, name: exactMatch.name, subdomain: exactMatch.subdomain };
+    }
+    // Try subdomain match
+    const subdomainMatch = tenants.find(t => t.subdomain.toLowerCase() === projectIdentifier.toLowerCase());
+    if (subdomainMatch) {
+        return { tenantId: subdomainMatch.id, name: subdomainMatch.name, subdomain: subdomainMatch.subdomain };
+    }
+    // Try partial match
+    const partialMatch = tenants.find(t => t.name.toLowerCase().includes(projectIdentifier.toLowerCase()));
+    if (partialMatch) {
+        return { tenantId: partialMatch.id, name: partialMatch.name, subdomain: partialMatch.subdomain };
+    }
+    return null;
+}

package/dist/tools/deploy-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-package.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-package.ts"],"names":[],"mappings":"AA0QA;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,CAmGjB"}
+{"version":3,"file":"deploy-package.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-package.ts"],"names":[],"mappings":"AA4QA;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,CA2LjB"}

package/dist/tools/deploy-package.js

@@ -32,13 +32,18 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deployPackage = deployPackage;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
 const api_client_1 = require("../lib/api-client");
 const device_flow_1 = require("../lib/device-flow");
 const credentials_1 = require("../lib/credentials");
+const validate_package_1 = require("./validate-package");
 /**
  * List existing projects for the authenticated user
  */
@@ -280,6 +285,83 @@ Use \`list_projects\` to see available projects, or \`create_site\` to create a
             return formatGitHubBlockMessage(githubStatus.repo, githubStatus.branch || 'main', subdomain);
         }
     }
+    // ============ PRE-DEPLOY VALIDATION GATE ============
+    // Validate the package BEFORE uploading to catch errors early
+    try {
+        const zip = new adm_zip_1.default(zipBuffer);
+        const entries = zip.getEntries();
+        // Build file list from zip
+        const fileList = entries.map(e => e.entryName);
+        // Find and read manifest.json
+        const manifestEntry = entries.find(e => e.entryName === 'manifest.json' ||
+            e.entryName.endsWith('/manifest.json'));
+        if (!manifestEntry) {
+            return `# DEPLOYMENT BLOCKED
+
+**Reason:** Missing manifest.json
+
+Every Fast Mode package requires a manifest.json at the root.
+
+Run \`get_example("manifest_basic")\` to see the required format.
+
+## Expected Package Structure
+
+\`\`\`
+your-site.zip
+├── manifest.json      <- REQUIRED
+├── pages/
+│   ├── index.html
+│   └── ...
+├── public/
+│   └── css/, js/, images/
+└── templates/         (optional, for CMS)
+\`\`\`
+`;
+        }
+        const manifestContent = manifestEntry.getData().toString('utf8');
+        // Collect template contents for validation
+        const templateContents = {};
+        for (const entry of entries) {
+            if (entry.entryName.endsWith('.html') && !entry.isDirectory) {
+                try {
+                    templateContents[entry.entryName] = entry.getData().toString('utf8');
+                }
+                catch {
+                    // Skip files that can't be read
+                }
+            }
+        }
+        // Run full package validation
+        const validationResult = await (0, validate_package_1.validatePackage)(fileList, manifestContent, templateContents);
+        // Only block on actual ERRORS, not warnings
+        if (validationResult.includes('HAS ERRORS') || validationResult.includes('INVALID')) {
+            return `# DEPLOYMENT BLOCKED
+
+Your package has validation errors that must be fixed before deployment.
+
+---
+
+${validationResult}
+
+---
+
+## Next Steps
+
+1. Fix the errors listed above
+2. Rebuild your .zip package
+3. Run \`deploy_package\` again
+
+Use \`validate_template\` and \`validate_manifest\` to check individual files.
+`;
+        }
+        // Validation passed - include summary in success response later
+        console.error('Pre-deploy validation passed');
+    }
+    catch (validationError) {
+        // If validation itself fails (e.g., corrupt zip), log but continue
+        // The upload will fail with a more specific error if the package is truly broken
+        console.error('Pre-deploy validation error:', validationError);
+    }
     // Upload the package
     console.error(`Deploying to ${subdomain}.fastmode.ai...`);
     const uploadResult = await uploadPackage(projectId, zipBuffer);

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,GAAG,iBAAiB,CAAC;AAooCtK;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA+F1E"}
+{"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,GAAG,iBAAiB,CAAC;AAotCtK;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA+F1E"}