@curenorway/kode-cli 1.7.1 → 1.9.0

package/dist/{chunk-KAYIHS2T.js → chunk-HKPZVOMY.js}

@@ -426,6 +426,35 @@ Scripts have two properties: **scope** and **autoLoad**.
 
 **CLI flags**: \`kode push --auto-load\` or \`kode push --no-auto-load\`
 
+### Script Metadata (Documentation)
+
+**ALWAYS provide metadata when creating or updating scripts.** This helps other AI agents and the Chrome extension understand what scripts do.
+
+| Field | Description | Example |
+|-------|-------------|---------|
+| \`purpose\` | What the script does (1-2 sentences) | "Adds smooth scroll behavior to anchor links" |
+| \`triggers\` | When the script runs | \`[{ event: 'domReady' }, { event: 'click', selector: '.nav-link' }]\` |
+| \`dependencies\` | External libraries needed | \`[{ name: 'gsap', version: '3.12' }]\` |
+| \`domTargets\` | CSS selectors the script affects | \`[{ selector: '.hero-title' }, { selector: '#contact-form' }]\` |
+
+**MCP Tools**:
+- \`kode_create_script\` / \`kode_update_script\` \u2192 include \`metadata: { purpose: "..." }\`
+- \`kode_analyze_script\` \u2192 auto-detect triggers, dependencies, and DOM targets from code
+- \`kode_get_script_metadata\` \u2192 get existing metadata and AI summary
+
+**Example**:
+\`\`\`json
+{
+  "name": "smooth-scroll",
+  "content": "...",
+  "metadata": {
+    "purpose": "Adds smooth scroll animation to all anchor links",
+    "triggers": [{ "event": "click", "selector": "a[href^='#']" }],
+    "domTargets": [{ "selector": "a[href^='#']" }]
+  }
+}
+\`\`\`
+
 ### Context
 
 **Read \`.cure-kode/context.md\` before working on scripts** - it contains:
@@ -597,13 +626,119 @@ if (CK.isLoaded('my-modal-script')) {
 }
 \`\`\`
 
+## Script Metadata (Documentation)
+
+**IMPORTANT: Always provide metadata when creating or updating scripts!**
+
+Metadata helps:
+- Other AI agents understand what scripts do
+- The Chrome extension display script info
+- Future debugging and maintenance
+
+### Metadata Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| \`purpose\` | string | 1-2 sentence description of what the script does |
+| \`triggers\` | array | Events that activate the script |
+| \`dependencies\` | array | External libraries the script needs |
+| \`domTargets\` | array | CSS selectors the script manipulates |
+
+### Trigger Events
+
+\`\`\`typescript
+type TriggerEvent =
+  | 'domReady'    // DOMContentLoaded
+  | 'load'        // window.onload
+  | 'scroll'      // scroll events
+  | 'click'       // click events
+  | 'hover'       // mouseenter/mouseleave
+  | 'resize'      // window resize
+  | 'mutation'    // MutationObserver
+  | 'interval'    // setInterval
+  | 'timeout'     // setTimeout
+  | 'formSubmit'  // form submission
+  | 'visibility'  // IntersectionObserver
+  | 'immediate'   // runs immediately
+  | 'custom'      // custom event
+
+// Each trigger can have optional selector/target
+{ event: 'click', selector: '.btn-primary' }
+{ event: 'scroll', target: 'window' }
+\`\`\`
+
+### Providing Metadata via MCP
+
+When creating scripts:
+\`\`\`javascript
+kode_create_script({
+  name: 'accordion',
+  slug: 'accordion',
+  type: 'javascript',
+  content: '// accordion code...',
+  metadata: {
+    purpose: 'Expands and collapses FAQ accordion items on click',
+    triggers: [
+      { event: 'domReady' },
+      { event: 'click', selector: '.accordion-trigger' }
+    ],
+    domTargets: [
+      { selector: '.accordion-trigger' },
+      { selector: '.accordion-content' }
+    ]
+  }
+})
+\`\`\`
+
+When updating scripts:
+\`\`\`javascript
+kode_update_script({
+  scriptId: 'xxx',
+  content: '// updated code...',
+  metadata: {
+    purpose: 'Updated description...',
+    // ... other fields
+  }
+})
+\`\`\`
+
+### Auto-Analyze Scripts
+
+Use \`kode_analyze_script\` to automatically detect metadata from code:
+\`\`\`javascript
+kode_analyze_script({ scriptId: 'xxx' })
+// Returns detected: triggers, dependencies, domTargets
+\`\`\`
+
+The analyzer detects:
+- **DOM selectors**: querySelector, getElementById, getElementsByClassName
+- **Event listeners**: addEventListener, on events
+- **Dependencies**: Library globals (gsap, Swiper, jQuery, etc.)
+- **Timing patterns**: DOMContentLoaded, load, intervals
+
+### Get Script Metadata
+
+\`\`\`javascript
+kode_get_script_metadata({ scriptId: 'xxx' })
+// Returns: purpose, triggers, dependencies, domTargets, aiSummary
+\`\`\`
+
+### Best Practice Workflow
+
+1. **Create script** with at least \`purpose\` in metadata
+2. **Run analyze** to auto-detect triggers and targets
+3. **Update metadata** with any corrections or additions
+4. **Deploy** - metadata is included in init.js for Chrome extension
+
 ## Best Practices
 
 1. **Always deploy to staging first** - Test before production
-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
+2. **Always provide metadata** - At minimum, include \`purpose\` when creating scripts
+3. **Use page-specific scripts** for page-only functionality
+4. **Use \`autoLoad: false\`** for lazy-loaded features (modals, etc.)
+5. **Document your changes** - Update context.md
+6. **Cache page HTML** - Use \`kode html <url> --save\` to understand structure
+7. **Run analyze after creating** - Use \`kode_analyze_script\` to auto-detect metadata
 
 ## MCP Tools
 
@@ -611,10 +746,12 @@ If using the Kode MCP server, these tools are available:
 
 ### 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 (accepts \`scope\` and \`autoLoad\`)
-- \`kode_update_script\` - Update script content, scope, or autoLoad
+- \`kode_get_script\` - Get script content (use \`includeContent: false\` to save tokens)
+- \`kode_create_script\` - Create new script (accepts \`scope\`, \`autoLoad\`, \`metadata\`)
+- \`kode_update_script\` - Update script content, scope, autoLoad, or metadata
 - \`kode_delete_script\` - Delete a script
+- \`kode_analyze_script\` - Auto-detect metadata (triggers, dependencies, DOM targets) from code
+- \`kode_get_script_metadata\` - Get script metadata and AI summary
 
 ### Page Assignment (for page-specific scripts)
 - \`kode_list_pages\` - List page definitions with URL patterns
@@ -1266,9 +1403,9 @@ config.json
     }
     mcpConfig.mcpServers = mcpConfig.mcpServers || {};
     mcpConfig.mcpServers["cure-kode"] = {
+      type: "stdio",
       command: "npx",
-      args: ["-y", "@curenorway/kode-mcp"],
-      env: {}
+      args: ["-y", "@curenorway/kode-mcp"]
     };
     let webflowToken = site.webflow_token;
     let webflowMcpMethod = null;
@@ -1317,6 +1454,7 @@ config.json
     }
     if (webflowMcpMethod === "token" && webflowToken) {
       mcpConfig.mcpServers["webflow"] = {
+        type: "stdio",
         command: "npx",
         args: ["-y", "webflow-mcp-server@latest"],
         env: {
@@ -1325,10 +1463,12 @@ config.json
       };
     } else if (webflowMcpMethod === "oauth") {
       mcpConfig.mcpServers["webflow"] = {
+        type: "http",
         url: "https://mcp.webflow.com/sse"
       };
     }
     mcpConfig.mcpServers["playwright"] = {
+      type: "stdio",
       command: "npx",
       args: ["-y", "@playwright/mcp@latest"]
     };
@@ -1610,6 +1750,16 @@ var KodeApiClient = class {
   async getDeploymentStatus(siteId) {
     return this.request(`/api/cdn/sites/${siteId}/deployments/status`);
   }
+  // Production enabled toggle (v2.3)
+  async setProductionEnabled(siteId, enabled, productionDomain) {
+    return this.request(`/api/cdn/sites/${siteId}/production`, {
+      method: "POST",
+      body: JSON.stringify({
+        enabled,
+        productionDomain
+      })
+    });
+  }
   // HTML Fetch
   async fetchHtml(url) {
     return this.request("/api/cdn/fetch-html", {
@@ -2005,9 +2155,20 @@ async function deployCommand(environment, options) {
   }
   const shouldPromote = options?.promote || environment === "production";
   if (shouldPromote) {
-    const spinner2 = ora4("Promoting staging to production...").start();
+    const client = createApiClient(config);
+    const spinner2 = ora4("Sjekker produksjonsstatus...").start();
     try {
-      const client = createApiClient(config);
+      const status = await client.getDeploymentStatus(config.siteId);
+      if (!status.productionEnabled) {
+        spinner2.fail("Produksjon er ikke aktivert");
+        console.log();
+        console.log(chalk5.yellow("\u26A0\uFE0F  Produksjon er deaktivert for dette prosjektet."));
+        console.log(chalk5.dim("   Aktiver produksjon f\xF8rst:"));
+        console.log(chalk5.dim("   kode production enable [--domain <domain>]"));
+        console.log();
+        return;
+      }
+      spinner2.text = "Promoterer staging til produksjon...";
       const deployment = await client.promoteToProduction(config.siteId);
       spinner2.succeed("Promoted to production");
       console.log();
@@ -2434,17 +2595,29 @@ async function statusCommand(options) {
     } else {
       console.log(chalk7.blue("  Staging: ") + chalk7.yellow("\u25CB") + chalk7.dim(" No deployments"));
     }
+    const productionEnabled = deployStatus.productionEnabled ?? false;
     const prodStatus = deployStatus.production.lastSuccessful;
-    if (prodStatus) {
+    if (!productionEnabled) {
+      console.log(
+        chalk7.gray("  Production: ") + chalk7.gray("\u25CB") + chalk7.gray(" Deaktivert") + chalk7.dim(" (kun staging)")
+      );
+      console.log();
+      console.log(
+        chalk7.dim('  \u{1F4A1} Run "kode production enable" to activate production environment.')
+      );
+    } else if (prodStatus) {
       console.log(
         chalk7.green("  Production: ") + chalk7.green("\u25CF") + chalk7.dim(` v${prodStatus.version}`) + chalk7.dim(` (${formatDate(prodStatus.completedAt)})`)
       );
+      if (deployStatus.productionDomain) {
+        console.log(chalk7.dim(`     Domain: ${deployStatus.productionDomain}`));
+      }
     } else {
       console.log(
-        chalk7.green("  Production: ") + chalk7.yellow("\u25CB") + chalk7.dim(" No deployments")
+        chalk7.green("  Production: ") + chalk7.yellow("\u25CB") + chalk7.dim(" Aktivert, ingen deployments enda")
       );
     }
-    if (deployStatus.canPromote) {
+    if (deployStatus.canPromote && productionEnabled) {
       console.log();
       console.log(
         chalk7.cyan('  \u{1F4A1} Staging is ahead of production. Run "kode deploy --promote" to update.')

package/dist/cli.js

@@ -15,11 +15,11 @@ import {
   readPageContext,
   statusCommand,
   watchCommand
-} from "./chunk-KAYIHS2T.js";
+} from "./chunk-HKPZVOMY.js";
 
 // src/cli.ts
 import { Command } from "commander";
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 import { createRequire } from "module";
 
 // src/commands/pages.ts
@@ -248,11 +248,17 @@ async function setCommand(script, options) {
   }
 }
 
-// src/commands/update-claude-md.ts
+// src/commands/production.ts
 import chalk3 from "chalk";
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-async function updateClaudeMdCommand() {
+import ora2 from "ora";
+async function productionCommand(action, options) {
+  if (!["enable", "disable", "status"].includes(action)) {
+    console.log(chalk3.red("\u274C Invalid action. Use: enable, disable, or status"));
+    console.log(chalk3.dim("   kode production enable [--domain <domain>]"));
+    console.log(chalk3.dim("   kode production disable"));
+    console.log(chalk3.dim("   kode production status"));
+    return;
+  }
   const projectRoot = findProjectRoot();
   if (!projectRoot) {
     console.log(chalk3.red("\u274C Not in a Cure Kode project."));
@@ -264,11 +270,93 @@ async function updateClaudeMdCommand() {
     console.log(chalk3.red("\u274C Could not read project configuration."));
     return;
   }
+  const client = createApiClient(config);
+  if (action === "status") {
+    const spinner2 = ora2("Fetching production status...").start();
+    try {
+      const status = await client.getDeploymentStatus(config.siteId);
+      spinner2.stop();
+      console.log();
+      console.log(chalk3.bold("Production Status"));
+      console.log();
+      if (status.productionEnabled) {
+        console.log(chalk3.green("  \u25CF Produksjon er aktivert"));
+        if (status.productionDomain) {
+          console.log(chalk3.dim(`    Domain: ${status.productionDomain}`));
+        }
+        if (status.production.lastSuccessful) {
+          console.log(
+            chalk3.dim(
+              `    Siste deploy: v${status.production.lastSuccessful.version}`
+            )
+          );
+        }
+      } else {
+        console.log(chalk3.gray("  \u25CB Produksjon er deaktivert"));
+        console.log(chalk3.dim("    Kun staging er aktiv"));
+      }
+      console.log();
+    } catch (error) {
+      spinner2.fail("Failed to fetch status");
+      console.error(chalk3.red("\nError:"), error.message || error);
+    }
+    return;
+  }
+  const spinner = ora2(
+    action === "enable" ? "Aktiverer produksjon..." : "Deaktiverer produksjon..."
+  ).start();
+  try {
+    const result = await client.setProductionEnabled(
+      config.siteId,
+      action === "enable",
+      options?.domain
+    );
+    spinner.stop();
+    console.log();
+    if (action === "enable") {
+      console.log(chalk3.green("\u2713 Produksjon er n\xE5 aktivert"));
+      if (result.productionDomain) {
+        console.log(chalk3.dim(`  Domain: ${result.productionDomain}`));
+      }
+      console.log();
+      console.log(chalk3.dim("  Neste steg:"));
+      console.log(chalk3.dim("  1. Deploy til staging: kode deploy"));
+      console.log(chalk3.dim("  2. Promoter til produksjon: kode deploy --promote"));
+    } else {
+      console.log(chalk3.yellow("\u2713 Produksjon er n\xE5 deaktivert"));
+      console.log(chalk3.dim("  Kun staging-milj\xF8et er aktivt."));
+      console.log(
+        chalk3.dim("  Produksjonsdomenet vil f\xE5 en tom script-respons.")
+      );
+    }
+    console.log();
+  } catch (error) {
+    spinner.fail(action === "enable" ? "Kunne ikke aktivere produksjon" : "Kunne ikke deaktivere produksjon");
+    console.error(chalk3.red("\nError:"), error.message || error);
+  }
+}
+
+// src/commands/update-claude-md.ts
+import chalk4 from "chalk";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+async function updateClaudeMdCommand() {
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.log(chalk4.red("\u274C Not in a Cure Kode project."));
+    console.log(chalk4.dim('   Run "kode init" first.'));
+    return;
+  }
+  const config = getProjectConfig(projectRoot);
+  if (!config) {
+    console.log(chalk4.red("\u274C Could not read project configuration."));
+    return;
+  }
   const claudeMdPath = join(projectRoot, "CLAUDE.md");
   const newKodeSection = generateClaudeMdMinimal(config.siteName, config.siteSlug);
   if (!existsSync(claudeMdPath)) {
     writeFileSync(claudeMdPath, newKodeSection);
-    console.log(chalk3.green("\u2705 Created CLAUDE.md with Cure Kode section"));
+    console.log(chalk4.green("\u2705 Created CLAUDE.md with Cure Kode section"));
     return;
   }
   let content = readFileSync(claudeMdPath, "utf-8");
@@ -287,18 +375,18 @@ async function updateClaudeMdCommand() {
   content = newKodeSection + "---\n\n" + content;
   writeFileSync(claudeMdPath, content);
   if (removedCount > 1) {
-    console.log(chalk3.green(`\u2705 Cleaned up ${removedCount} duplicate Kode sections and added fresh one`));
+    console.log(chalk4.green(`\u2705 Cleaned up ${removedCount} duplicate Kode sections and added fresh one`));
   } else if (removedCount === 1) {
-    console.log(chalk3.green("\u2705 Updated Cure Kode section in CLAUDE.md"));
+    console.log(chalk4.green("\u2705 Updated Cure Kode section in CLAUDE.md"));
   } else {
-    console.log(chalk3.green("\u2705 Added Cure Kode section to CLAUDE.md"));
+    console.log(chalk4.green("\u2705 Added Cure Kode section to CLAUDE.md"));
   }
   console.log();
-  console.log(chalk3.dim("The Cure Kode section now includes:"));
-  console.log(chalk3.dim("  \u2022 What is Cure Kode (internal tool explanation)"));
-  console.log(chalk3.dim("  \u2022 CDN URL with script tag for Webflow"));
-  console.log(chalk3.dim("  \u2022 Workflow steps"));
-  console.log(chalk3.dim("  \u2022 Command reference"));
+  console.log(chalk4.dim("The Cure Kode section now includes:"));
+  console.log(chalk4.dim("  \u2022 What is Cure Kode (internal tool explanation)"));
+  console.log(chalk4.dim("  \u2022 CDN URL with script tag for Webflow"));
+  console.log(chalk4.dim("  \u2022 Workflow steps"));
+  console.log(chalk4.dim("  \u2022 Command reference"));
 }
 
 // src/cli.ts
@@ -336,12 +424,15 @@ program.command("context").description("View or edit project context for AI agen
 program.command("set <script>").description("Update script settings (scope, autoLoad)").option("--scope <scope>", "Set scope: global or page-specific").option("--auto-load", "Enable auto-loading").option("--no-auto-load", "Disable auto-loading").action((script, options) => {
   setCommand(script, options);
 });
+program.command("production <action>").description("Enable or disable production environment (v2.3)").option("-d, --domain <domain>", "Set production domain when enabling").action((action, options) => {
+  productionCommand(action, options);
+});
 program.command("update-claude-md").alias("ucm").description("Add or update Cure Kode section in CLAUDE.md").action(() => {
   updateClaudeMdCommand();
 });
 program.showHelpAfterError();
 console.log();
-console.log(chalk4.bold("  Cure Kode CLI"));
-console.log(chalk4.dim("  Manage JS/CSS for Webflow sites"));
+console.log(chalk5.bold("  Cure Kode CLI"));
+console.log(chalk5.dim("  Manage JS/CSS for Webflow sites"));
 console.log();
 program.parse();

package/dist/index.d.ts

@@ -146,6 +146,8 @@ declare class KodeApiClient {
     deploy(siteId: string, environment?: 'staging' | 'production'): Promise<CdnDeployment>;
     promoteToProduction(siteId: string, stagingDeploymentId?: string): Promise<CdnDeployment>;
     getDeploymentStatus(siteId: string): Promise<{
+        productionEnabled: boolean;
+        productionDomain: string | null;
         staging: {
             latest: CdnDeployment | null;
             lastSuccessful: any;
@@ -156,6 +158,11 @@ declare class KodeApiClient {
         };
         canPromote: boolean;
     }>;
+    setProductionEnabled(siteId: string, enabled: boolean, productionDomain?: string): Promise<{
+        success: boolean;
+        productionEnabled: boolean;
+        productionDomain: string | null;
+    }>;
     fetchHtml(url: string): Promise<ParsedHtmlResult>;
 }
 /**

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   updateScriptPurpose,
   watchCommand,
   writeContext
-} from "./chunk-KAYIHS2T.js";
+} from "./chunk-HKPZVOMY.js";
 export {
   KodeApiClient,
   KodeApiError,

package/package.json

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