@curenorway/kode-cli 1.12.0 → 1.13.0

package/README.md

@@ -4,12 +4,14 @@ Command-line tool for managing JavaScript and CSS scripts for Webflow sites via
 
 ## Features
 
-- **Pull/Push scripts** - Sync scripts between local files and remote CDN
+- **Pull/Push scripts** - Sync scripts between local files and remote CDN with conflict detection
+- **Sync awareness** - Staleness indicators show when local state is out of date
+- **Deploy dry-run** - Preview what will be deployed before executing
+- **Doctor command** - Diagnose configuration issues and check for CLI updates
 - **Watch mode** - Auto-sync on file changes with retry on failure
 - **Staging/Production** - Separate environments with explicit production enable
 - **Rollback** - Quick recovery to previous deployments
-- **AI Context** - Generate and manage context for AI agents
-- **Page Context Caching** - Save page structures for AI development
+- **AI-ready** - Auto-generates KODE.md documentation for AI agents
 - **MCP Integration** - Works with Cure Kode MCP for AI agents
 
 ## Installation
@@ -53,9 +55,10 @@ kode init
 
 Creates:
 - `.cure-kode/config.json` - Site configuration and API key
+- `.cure-kode/KODE.md` - Auto-generated documentation (scripts, pages, commands)
 - `.cure-kode/context.md` - AI context file
 - `.cure-kode-scripts/` - Scripts directory
-- `CLAUDE.md` - AI agent instructions (with metadata documentation)
+- `CLAUDE.md` - Reference to KODE.md (prepended, never overwrites existing content)
 - `.mcp.json` - MCP server configuration (cure-kode, webflow, playwright)
 
 ### `kode pull`
@@ -104,9 +107,9 @@ Deploy scripts to staging or production.
 
 ```bash
 kode deploy                 # Deploy to staging (default)
+kode deploy --dry-run       # Preview deployment without executing
 kode deploy --promote       # Promote staging to production
 kode deploy --force         # Force release stale deploy lock
-kode deploy -n "Release v2" # Deploy with notes
 ```
 
 **Note:** Production must be enabled before promoting. See `kode production`.
@@ -165,7 +168,7 @@ kode context --json         # Output as JSON
 
 ### `kode status`
 
-Show current project status.
+Show current project status with staleness indicators.
 
 ```bash
 kode status
@@ -174,9 +177,44 @@ kode status
 Shows:
 - Site info and CDN URL
 - Production enabled state
-- Script sync status
+- Script sync status with staleness warnings
+- Per-script indicators: modified locally, server updated, conflicts
 - Deployment versions
 
+### `kode doctor`
+
+Diagnose configuration and environment issues.
+
+```bash
+kode doctor
+```
+
+Checks:
+- Project configuration and API key validity
+- Network connectivity and API access
+- MCP server configuration
+- KODE.md and CLAUDE.md setup
+- Security (.gitignore for API key)
+- Sync state staleness
+- CLI version and available updates
+
+### `kode diff <script>`
+
+Show differences between local and remote script versions.
+
+```bash
+kode diff my-script    # Compare local vs remote
+```
+
+### `kode sync`
+
+Bidirectional sync with conflict detection.
+
+```bash
+kode sync              # Sync both directions
+kode sync --dry-run    # Preview what would change
+```
+
 ## Configuration
 
 ### Project Config (`.cure-kode/config.json`)
@@ -206,15 +244,17 @@ Default: `.cure-kode-scripts/` (avoids conflicts with AI-generated `scripts/` fo
 ```
 your-project/
 ├── .cure-kode/
-│   ├── config.json       # Project configuration
+│   ├── config.json       # Project configuration (gitignored)
+│   ├── scripts.json      # Sync state for conflict detection
+│   ├── KODE.md           # Auto-generated documentation
 │   ├── context.md        # AI context (notes, discoveries)
 │   └── pages/            # Cached page contexts
 ├── .cure-kode-scripts/   # Your scripts directory
-│   ├── init.js
-│   ├── tracking.js
+│   ├── main.js
+│   ├── form-handler.js
 │   └── styles.css
 ├── .mcp.json             # MCP server configuration
-└── CLAUDE.md             # AI agent instructions
+└── CLAUDE.md             # Reference to KODE.md (your content preserved)
 ```
 
 ## Workflow Examples

package/dist/{chunk-XU4YS3JQ.js → chunk-C2BM7IJ6.js}

@@ -1201,7 +1201,7 @@ Option C: Full rollback
 }
 
 // src/version.ts
-var CLI_VERSION = "1.12.0";
+var CLI_VERSION = "1.12.1";
 
 // src/commands/init.ts
 import chalk from "chalk";
@@ -1288,6 +1288,29 @@ Page-specific scripts only load when URL matches these patterns:
 `;
     }
     md += `
+`;
+  }
+  const pageSpecificScripts = scripts.filter(
+    (s) => s.scope === "page-specific" && s.pageAssignments && s.pageAssignments.length > 0
+  );
+  if (pageSpecificScripts.length > 0) {
+    md += `---
+
+## Script \u2192 Page Assignments
+
+| Script | Pages |
+|--------|-------|
+`;
+    for (const script of pageSpecificScripts) {
+      const pageList = script.pageAssignments.map((pa) => {
+        const page = pages.find((p) => p.slug === pa.pageSlug);
+        const patterns = page ? ` (\`${page.patterns.join("`, `")}\`)` : "";
+        return `\`${pa.pageSlug}\`${patterns}`;
+      }).join(", ");
+      md += `| \`${script.slug}\` | ${pageList} |
+`;
+    }
+    md += `
 `;
   }
   md += `---
@@ -1383,15 +1406,22 @@ function updateKodeDocs(projectRoot, siteName, siteSlug, scripts, pages) {
   const claudeMd = ensureClaudeMdReference(projectRoot);
   return { kodeMd, claudeMd };
 }
-function scriptsToDocsFormat(scripts) {
-  return scripts.map((s) => ({
-    slug: s.slug,
-    name: s.name,
-    type: s.type,
-    scope: s.scope,
-    autoLoad: s.auto_load,
-    purpose: s.metadata?.purpose || s.description
-  }));
+function scriptsToDocsFormat(scripts, pages) {
+  return scripts.map((s) => {
+    const pageAssignments = (s.pages || []).filter((p) => p.is_enabled).map((p) => {
+      const page = pages?.find((pg) => pg.id === p.page_id);
+      return page ? { pageId: page.id, pageSlug: page.slug, pageName: page.name } : null;
+    }).filter((p) => p !== null);
+    return {
+      slug: s.slug,
+      name: s.name,
+      type: s.type,
+      scope: s.scope,
+      autoLoad: s.auto_load,
+      purpose: s.metadata?.purpose || s.description,
+      pageAssignments: pageAssignments.length > 0 ? pageAssignments : void 0
+    };
+  });
 }
 function pagesToInfoFormat(pages) {
   return pages.filter((p) => p.is_active).map((p) => ({
@@ -1584,7 +1614,7 @@ config.json
       cwd,
       config.siteName,
       config.siteSlug,
-      scriptsToDocsFormat(scripts),
+      scriptsToDocsFormat(scripts, pages),
       pagesToInfoFormat(pages)
     );
     const siteInfo = {
@@ -2034,10 +2064,19 @@ Fant ikke skript "${options.script}".`));
     if (skipped > 0) {
       console.log(chalk2.dim(`Hoppet over ${skipped} skript`));
     }
+    let pages = [];
+    try {
+      pages = await client.listPages(config.siteId);
+    } catch {
+    }
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const metadata = scripts.map((s) => {
       const filePath = join5(scriptsDir, `${s.slug}.${s.type === "javascript" ? "js" : "css"}`);
       const localContent = existsSync5(filePath) ? readFileSync5(filePath, "utf-8") : s.content;
+      const pageAssignments = (s.pages || []).filter((p) => p.is_enabled).map((p) => {
+        const page = pages.find((pg) => pg.id === p.page_id);
+        return page ? { pageId: page.id, pageSlug: page.slug, pageName: page.name } : null;
+      }).filter((p) => p !== null);
       return {
         id: s.id,
         slug: s.slug,
@@ -2047,6 +2086,7 @@ Fant ikke skript "${options.script}".`));
         autoLoad: s.auto_load,
         version: s.current_version,
         loadOrder: s.load_order,
+        pageAssignments: pageAssignments.length > 0 ? pageAssignments : void 0,
         lastPulledVersion: s.current_version,
         lastPulledAt: now,
         contentHash: hashContent(localContent)
@@ -2054,12 +2094,11 @@ Fant ikke skript "${options.script}".`));
     });
     writeFileSync5(metadataPath, JSON.stringify(metadata, null, 2));
     try {
-      const pages = await client.listPages(config.siteId);
       const result = updateClaudeMd(
         projectRoot,
         config.siteName,
         config.siteSlug,
-        scriptsToDocsFormat(scripts),
+        scriptsToDocsFormat(scripts, pages),
         pagesToInfoFormat(pages)
       );
       if (result.kodeMd.created) {
@@ -2233,12 +2272,21 @@ ${conflicts} skript med konflikter (bruk --force for \xE5 overskrive)`));
 ${emptyScriptCount} tomme skript lastet opp`));
       console.log(chalk3.dim("Tomme skript har ingen effekt ved deploy."));
     }
+    let pages = [];
+    try {
+      pages = await client.listPages(config.siteId);
+    } catch {
+    }
     const updatedScripts = await client.listScripts(config.siteId);
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const updatedMetadata = updatedScripts.map((s) => {
       const ext = s.type === "javascript" ? "js" : "css";
       const filePath = join6(scriptsDir, `${s.slug}.${ext}`);
       const localContent = existsSync6(filePath) ? readFileSync6(filePath, "utf-8") : s.content;
+      const pageAssignments = (s.pages || []).filter((p) => p.is_enabled).map((p) => {
+        const page = pages.find((pg) => pg.id === p.page_id);
+        return page ? { pageId: page.id, pageSlug: page.slug, pageName: page.name } : null;
+      }).filter((p) => p !== null);
       return {
         id: s.id,
         slug: s.slug,
@@ -2248,6 +2296,7 @@ ${emptyScriptCount} tomme skript lastet opp`));
         autoLoad: s.auto_load,
         version: s.current_version,
         loadOrder: s.load_order,
+        pageAssignments: pageAssignments.length > 0 ? pageAssignments : void 0,
         lastPulledVersion: s.current_version,
         lastPulledAt: now,
         contentHash: hashContent2(localContent)
@@ -2255,12 +2304,11 @@ ${emptyScriptCount} tomme skript lastet opp`));
     });
     writeFileSync6(metadataPath, JSON.stringify(updatedMetadata, null, 2));
     try {
-      const pages = await client.listPages(config.siteId);
       const result = updateClaudeMd(
         projectRoot,
         config.siteName,
         config.siteSlug,
-        scriptsToDocsFormat(updatedScripts),
+        scriptsToDocsFormat(updatedScripts, pages),
         pagesToInfoFormat(pages)
       );
       if (result.kodeMd.created) {

package/dist/cli.js

@@ -21,7 +21,7 @@ import {
   updateClaudeMd,
   updateKodeDocs,
   watchCommand
-} from "./chunk-XU4YS3JQ.js";
+} from "./chunk-C2BM7IJ6.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -65,7 +65,7 @@ async function upgradeCommand() {
       projectRoot,
       config.siteName,
       config.siteSlug,
-      scriptsToDocsFormat(scripts),
+      scriptsToDocsFormat(scripts, pages),
       pagesToInfoFormat(pages)
     );
     if (result.kodeMd.created) {
@@ -845,7 +845,7 @@ async function updateClaudeMdCommand() {
       projectRoot,
       config.siteName,
       config.siteSlug,
-      scriptsToDocsFormat(scripts),
+      scriptsToDocsFormat(scripts, pages),
       pagesToInfoFormat(pages)
     );
     if (result.kodeMd.created) {
@@ -1077,11 +1077,20 @@ async function syncCommand(options) {
       console.log(chalk7.dim('  Bruk "kode pull --force <script>" for \xE5 overskrive lokalt'));
     }
     const updatedScripts = await client.listScripts(config.siteId);
+    let pages = [];
+    try {
+      pages = await client.listPages(config.siteId);
+    } catch {
+    }
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const updatedMetadata = updatedScripts.map((s) => {
       const ext = s.type === "javascript" ? "js" : "css";
       const filePath = join2(scriptsDir, `${s.slug}.${ext}`);
       const localContent = existsSync2(filePath) ? readFileSync2(filePath, "utf-8") : s.content;
+      const pageAssignments = (s.pages || []).filter((p) => p.is_enabled).map((p) => {
+        const page = pages.find((pg) => pg.id === p.page_id);
+        return page ? { pageId: page.id, pageSlug: page.slug, pageName: page.name } : null;
+      }).filter((p) => p !== null);
       return {
         id: s.id,
         slug: s.slug,
@@ -1091,6 +1100,7 @@ async function syncCommand(options) {
         autoLoad: s.auto_load,
         version: s.current_version,
         loadOrder: s.load_order,
+        pageAssignments: pageAssignments.length > 0 ? pageAssignments : void 0,
         lastPulledVersion: s.current_version,
         lastPulledAt: now,
         contentHash: hashContent(localContent)

package/dist/index.d.ts

@@ -66,6 +66,10 @@ interface CdnScript {
     current_version: number;
     is_active: boolean;
     load_order: number;
+    pages?: Array<{
+        page_id: string;
+        is_enabled: boolean;
+    }>;
 }
 interface CdnPage {
     id: string;

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curenorway/kode-cli",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "CLI for Cure Kode CDN - manage, deploy, and sync JS/CSS scripts for Webflow sites with AI agent support",
   "type": "module",
   "bin": {