@curenorway/kode-cli 1.10.0 → 1.12.1

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