@curenorway/kode-cli 1.2.1 → 1.3.0

package/dist/{chunk-43RZM4JR.js → chunk-5S7XIMSB.js}

@@ -98,11 +98,14 @@ function parseContext(content) {
     for (const row of rows) {
       const cols = row.split("|").map((c) => c.trim()).filter(Boolean);
       if (cols.length >= 3) {
+        const hasAutoCol = cols.length >= 5 || cols.length === 4 && (cols[3] === "\u26A1" || cols[3] === "\u25CB");
         context.scripts.push({
           slug: cols[0],
           type: cols[1].toLowerCase() === "css" ? "css" : "javascript",
           scope: cols[2].toLowerCase() === "page-specific" ? "page-specific" : "global",
-          purpose: cols[3] || void 0
+          autoLoad: hasAutoCol ? cols[3] === "\u26A1" : true,
+          // Default to true for old format
+          purpose: hasAutoCol ? cols[4] || void 0 : cols[3] || void 0
         });
       }
     }
@@ -161,16 +164,20 @@ function serializeContext(context) {
   md += `## Scripts
 
 `;
-  md += `| Script | Type | Scope | Purpose |
+  md += `| Script | Type | Scope | Auto | Purpose |
 `;
-  md += `|--------|------|-------|--------|
+  md += `|--------|------|-------|------|--------|
 `;
   for (const script of context.scripts) {
     const purpose = script.purpose || "(add purpose)";
-    md += `| ${script.slug} | ${script.type === "css" ? "CSS" : "JS"} | ${script.scope} | ${purpose} |
+    const autoIcon = script.autoLoad ? "\u26A1" : "\u25CB";
+    md += `| ${script.slug} | ${script.type === "css" ? "CSS" : "JS"} | ${script.scope} | ${autoIcon} | ${purpose} |
 `;
   }
   md += `
+`;
+  md += `> Legend: \u26A1 = auto-loads, \u25CB = manual load via \`CK.loadScript()\`
+
 `;
   if (context.pages && context.pages.length > 0) {
     md += `## Pages
@@ -324,7 +331,8 @@ function generateInitialContext(config, scripts, site) {
     scripts: scripts.map((s) => ({
       slug: s.slug,
       type: s.type,
-      scope: s.scope
+      scope: s.scope,
+      autoLoad: s.auto_load
     })),
     pages: [],
     notes: [],
@@ -507,28 +515,92 @@ Page context includes:
 - **Forms**: Form fields, labels, and submit buttons
 - **CMS**: Collection patterns with item counts
 
+## Script Loading Behavior
+
+Scripts have two properties that control loading:
+
+| Property | Values | Description |
+|----------|--------|-------------|
+| **scope** | \`global\` / \`page-specific\` | Where the script loads |
+| **autoLoad** | \`true\` / \`false\` | Whether it loads automatically |
+
+### Loading Matrix
+
+| Scope | Auto-Load | Behavior |
+|-------|-----------|----------|
+| **global + true** | Default for new scripts. Content is **inlined** into init.js, executes immediately on all pages. |
+| **global + false** | Listed in config but NOT loaded. Call \`CK.loadScript('slug')\` manually to load. |
+| **page-specific + true** | Dynamically loaded when URL matches assigned page patterns. |
+| **page-specific + false** | Not loaded automatically. Call \`CK.loadScript('slug')\` when needed. |
+
+### CLI Flags
+
+\`\`\`bash
+kode push --auto-load       # Force enable auto-load for new scripts
+kode push --no-auto-load    # Disable auto-load (for manual loading)
+\`\`\`
+
+### Page-Specific Scripts
+
+For page-specific scripts, you must:
+1. Create with \`scope: 'page-specific'\`
+2. Assign to pages via MCP: \`kode_assign_script_to_page\`
+3. Deploy to make changes live
+
+### Manual Loading
+
+To load scripts on-demand (for modals, lazy-load, etc.):
+
+\`\`\`javascript
+// Load a script that has autoLoad: false
+CK.loadScript('my-modal-script')
+
+// Check if loaded
+if (CK.isLoaded('my-modal-script')) {
+  // already loaded
+}
+\`\`\`
+
 ## Best Practices
 
 1. **Always deploy to staging first** - Test before production
-2. **Use page-specific scripts** - Don't pollute global scope
-3. **Document your changes** - Update context.md
-4. **Cache page HTML** - Use \`kode html <url> --save\` to understand structure
+2. **Use page-specific scripts** for page-only functionality
+3. **Use \`autoLoad: false\`** for lazy-loaded features (modals, etc.)
+4. **Document your changes** - Update context.md
+5. **Cache page HTML** - Use \`kode html <url> --save\` to understand structure
 
 ## MCP Tools
 
 If using the Kode MCP server, these tools are available:
-- \`kode_list_scripts\` - List all scripts
+
+### Script Management
+- \`kode_list_scripts\` - List all scripts with scope and autoLoad status
 - \`kode_get_script\` - Get script content
-- \`kode_create_script\` - Create new script
-- \`kode_update_script\` - Update script content
-- \`kode_deploy\` - Deploy to environment
+- \`kode_create_script\` - Create new script (accepts \`scope\` and \`autoLoad\`)
+- \`kode_update_script\` - Update script content, scope, or autoLoad
+- \`kode_delete_script\` - Delete a script
+
+### Page Assignment (for page-specific scripts)
+- \`kode_list_pages\` - List page definitions with URL patterns
+- \`kode_assign_script_to_page\` - Assign a script to a page
+- \`kode_remove_script_from_page\` - Remove script from page
+
+### Deployment
+- \`kode_deploy\` - Deploy to staging or production
+- \`kode_promote\` - Promote staging to production
 - \`kode_status\` - Get deployment status
+
+### HTML Analysis
 - \`kode_fetch_html\` - Analyze page HTML
+- \`kode_fetch_html_smart\` - Analyze with CMS truncation
+- \`kode_refresh_page\` - Fetch and cache page structure
+- \`kode_get_page_context\` - Get cached page structure (with CSS selectors)
+- \`kode_list_pages_context\` - List cached page contexts
+
+### Context
 - \`kode_read_context\` - Read context file
 - \`kode_update_context\` - Update context file
-- \`kode_refresh_page\` - Fetch and cache page structure
-- \`kode_get_page_context\` - Get cached page structure
-- \`kode_list_pages\` - List cached pages
+- \`kode_site_info\` - Get site configuration and CDN URLs
 `;
 }
 
@@ -952,8 +1024,9 @@ async function pullCommand(options) {
       }
       writeFileSync4(filePath, script.content);
       const scopeTag = script.scope === "global" ? chalk2.blue("[G]") : chalk2.magenta("[P]");
+      const loadTag = script.auto_load ? chalk2.green("\u26A1") : chalk2.dim("\u25CB");
       console.log(
-        chalk2.green(`  \u2713 ${fileName}`) + chalk2.dim(` v${script.current_version} ${scopeTag}`)
+        chalk2.green(`  \u2713 ${fileName}`) + chalk2.dim(` v${script.current_version}`) + ` ${scopeTag} ${loadTag}`
       );
       pulled++;
     }
@@ -971,10 +1044,12 @@ async function pullCommand(options) {
       name: s.name,
       type: s.type,
       scope: s.scope,
+      autoLoad: s.auto_load,
       version: s.current_version,
       loadOrder: s.load_order
     }));
     writeFileSync4(metadataPath, JSON.stringify(metadata, null, 2));
+    console.log(chalk2.dim("\nLegend: [G]=Global [P]=Page-specific \u26A1=Auto-load \u25CB=Manual load"));
   } catch (error) {
     spinner.fail("Failed to pull scripts");
     console.error(chalk2.red("\nError:"), error);
@@ -1062,15 +1137,19 @@ async function pushCommand(options) {
         pushed++;
       } else {
         const createSpinner = ora3(`Creating ${file}...`).start();
+        const scriptScope = localMeta?.scope || "global";
         const newScript = await client.createScript(config.siteId, {
           name: slug.charAt(0).toUpperCase() + slug.slice(1).replace(/-/g, " "),
           slug,
           type,
-          scope: localMeta?.scope || "global",
+          scope: scriptScope,
+          // autoLoad: if explicitly set via CLI, use that; otherwise let API default based on scope
+          autoLoad: options.autoLoad,
           content
         });
+        const autoLoadInfo = newScript.auto_load ? chalk3.green("auto-load") : chalk3.dim("manual");
         createSpinner.succeed(
-          chalk3.green(`  \u2713 ${file}`) + chalk3.cyan(" (new)")
+          chalk3.green(`  \u2713 ${file}`) + chalk3.cyan(" (new)") + ` [${autoLoadInfo}]`
         );
         created++;
       }
@@ -1092,6 +1171,7 @@ async function pushCommand(options) {
       name: s.name,
       type: s.type,
       scope: s.scope,
+      autoLoad: s.auto_load,
       version: s.current_version,
       loadOrder: s.load_order
     }));
@@ -1863,6 +1943,7 @@ async function contextCommand(options) {
             slug: s.slug,
             type: s.type,
             scope: s.scope,
+            autoLoad: s.auto_load,
             purpose: existing?.purpose
           };
         }),

package/dist/cli.js

@@ -14,7 +14,7 @@ import {
   readPageContext,
   statusCommand,
   watchCommand
-} from "./chunk-43RZM4JR.js";
+} from "./chunk-5S7XIMSB.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -238,7 +238,7 @@ program.command("init").description("Initialize Cure Kode in current directory")
 program.command("pull").description("Download scripts from Cure to local files").argument("[script]", "Specific script slug to pull").option("-f, --force", "Overwrite local changes").action((script, options) => {
   pullCommand({ script, ...options });
 });
-program.command("push").description("Upload local scripts to Cure").argument("[script]", "Specific script file or slug to push").option("-m, --message <message>", "Change summary").option("-a, --all", "Push all scripts even if unchanged").action((script, options) => {
+program.command("push").description("Upload local scripts to Cure").argument("[script]", "Specific script file or slug to push").option("-m, --message <message>", "Change summary").option("-a, --all", "Push all scripts even if unchanged").option("--auto-load", "Enable auto-loading for new scripts (default for global)").option("--no-auto-load", "Disable auto-loading for new scripts").action((script, options) => {
   pushCommand({ script, ...options });
 });
 program.command("watch").description("Watch for changes and auto-push").option("-d, --deploy", "Auto-deploy after each push").action((options) => {

package/dist/index.d.ts

@@ -58,6 +58,7 @@ interface CdnScript {
     slug: string;
     type: 'javascript' | 'css';
     scope: 'global' | 'page-specific';
+    auto_load: boolean;
     content: string;
     current_version: number;
     is_active: boolean;
@@ -121,12 +122,14 @@ declare class KodeApiClient {
         slug: string;
         type: 'javascript' | 'css';
         scope?: 'global' | 'page-specific';
+        autoLoad?: boolean;
         content?: string;
     }): Promise<CdnScript>;
     updateScript(scriptId: string, data: {
         content?: string;
         name?: string;
         scope?: 'global' | 'page-specific';
+        autoLoad?: boolean;
         changeSummary?: string;
     }): Promise<CdnScript>;
     deleteScript(scriptId: string): Promise<void>;
@@ -136,6 +139,7 @@ declare class KodeApiClient {
         content: string;
         type: 'javascript' | 'css';
         scope?: 'global' | 'page-specific';
+        autoLoad?: boolean;
         changeSummary?: string;
     }): Promise<CdnScript>;
     listPages(siteId: string): Promise<CdnPage[]>;
@@ -183,6 +187,7 @@ declare function pushCommand(options: {
     script?: string;
     message?: string;
     all?: boolean;
+    autoLoad?: boolean;
 }): Promise<void>;
 
 /**
@@ -240,6 +245,7 @@ interface KodeScriptContext {
     slug: string;
     type: 'javascript' | 'css';
     scope: 'global' | 'page-specific';
+    autoLoad: boolean;
     purpose?: string;
 }
 interface KodePageContext {

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   updateScriptPurpose,
   watchCommand,
   writeContext
-} from "./chunk-43RZM4JR.js";
+} from "./chunk-5S7XIMSB.js";
 export {
   KodeApiClient,
   KodeApiError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curenorway/kode-cli",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "CLI tool for Cure Kode - manage JS/CSS scripts for Webflow sites",
   "type": "module",
   "bin": {