decoupled-cli 2.4.1 → 2.4.2

package/README.md

@@ -1,6 +1,15 @@
 # Decoupled Drupal CLI (decoupled-cli)
 
-A command-line interface for managing Decoupled Drupal spaces, monitoring usage, and interacting with the Decoupled Drupal API using personal access tokens.
+A command-line interface for managing Decoupled Drupal spaces, monitoring usage, and enabling AI assistants to interact with your platform through the Model Context Protocol (MCP).
+
+## Features
+
+- 🔐 **Secure Authentication** - OAuth (Google/GitHub) and Personal Access Tokens
+- 🤖 **AI Integration** - Model Context Protocol support for Claude Code and Cursor
+- 📦 **Space Management** - Create, clone, delete, and monitor Drupal spaces
+- 📊 **Usage Monitoring** - Track storage, bandwidth, and API requests
+- 🚀 **Quick Start** - AI-powered space creation with generated content
+- 📥 **Content Import** - Import content models and data to Drupal
 
 ## Installation
 
@@ -128,6 +137,72 @@ The CLI stores configuration in `~/.decoupled-cli/config.json`:
 
 Actual tokens are stored securely using the system keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service).
 
+## AI Integration with MCP
+
+The CLI supports the Model Context Protocol (MCP), enabling AI assistants in **Claude Code** and **Cursor** to manage your Drupal spaces using natural language.
+
+### Setup
+
+```bash
+# Log in first (if not already)
+decoupled-cli auth login
+
+# Configure MCP for Claude Code
+decoupled-cli mcp configure --ide claude-code
+
+# Or configure for Cursor
+decoupled-cli mcp configure --ide cursor
+```
+
+After configuration, restart your IDE and you can interact with your platform naturally:
+
+**Example conversations:**
+```
+You: "Show me all my Drupal spaces"
+AI: Lists all your spaces with status and URLs
+
+You: "Create a blog space called Tech News"
+AI: Creates the space and returns the ID and URL
+
+You: "What's my current storage usage?"
+AI: Shows organization-wide usage statistics
+
+You: "Clone space 5 and name it Staging"
+AI: Clones the space with all content
+```
+
+### Available MCP Commands
+
+```bash
+# Configure MCP for an IDE
+decoupled-cli mcp configure [--ide <claude-code|cursor>]
+
+# Show configuration status
+decoupled-cli mcp status
+
+# Remove MCP configuration
+decoupled-cli mcp remove
+
+# Show config without writing (for manual setup)
+decoupled-cli mcp configure --show-only
+```
+
+### What AI Can Do
+
+- **Read Operations:**
+  - List all spaces with details
+  - Get space information
+  - View usage statistics
+  - Check organization details
+
+- **Write Operations:**
+  - Create new spaces
+  - Clone existing spaces
+  - Delete spaces
+  - Import content models and data
+
+All operations use your existing authentication and permissions.
+
 ## Commands
 
 ### Spaces Management
@@ -289,6 +364,58 @@ decoupled-cli spaces retry 123
 decoupled-cli spaces refresh-usage 123
 ```
 
+### Content Management
+
+#### Import Content
+```bash
+# Import content model and data from JSON file
+decoupled-cli content import --file content-import.json
+
+# Preview import without applying changes
+decoupled-cli content import --file content-import.json --preview
+
+# Show example import JSON structure
+decoupled-cli content import --example
+```
+
+**Import JSON Format:**
+```json
+{
+  "model": [
+    {
+      "bundle": "blog_post",
+      "label": "Blog Post",
+      "description": "Blog article content type",
+      "body": true,
+      "fields": [
+        {
+          "id": "subtitle",
+          "label": "Subtitle",
+          "type": "string"
+        },
+        {
+          "id": "featured_image",
+          "label": "Featured Image",
+          "type": "image"
+        }
+      ]
+    }
+  ],
+  "content": [
+    {
+      "id": "post1",
+      "type": "node.blog_post",
+      "path": "/blog/my-first-post",
+      "values": {
+        "title": "My First Post",
+        "body": "<p>Post content here</p>",
+        "subtitle": "An introduction"
+      }
+    }
+  ]
+}
+```
+
 ### Usage Monitoring
 
 #### Organization Usage
@@ -506,6 +633,7 @@ decoupled-cli auth test --permissions
 
 The CLI directly uses the Decoupled Drupal API with these endpoints:
 
+**Space Management:**
 - `GET /api/spaces` - List spaces
 - `POST /api/spaces` - Create space
 - `GET /api/spaces/{id}` - Get space details
@@ -514,17 +642,121 @@ The CLI directly uses the Decoupled Drupal API with these endpoints:
 - `POST /api/spaces/{id}/clone` - Clone space
 - `POST /api/spaces/{id}/archive` - Archive space
 - `POST /api/spaces/{id}/unarchive` - Unarchive space
+
+**Content Operations:**
+- `POST /api/spaces/{id}/content-import` - Import content model and data
+
+**Usage & Monitoring:**
 - `GET /api/usage` - Get usage data
-- Token management endpoints (web interface only)
+- `GET /api/organization` - Get organization details
+
+**MCP (Model Context Protocol):**
+- `GET /api/mcp/sse` - SSE connection for MCP clients
+- `POST /api/mcp/messages` - JSON-RPC 2.0 message handler
+
+**Authentication:**
+- Token management endpoints (web interface only at `/organization/tokens`)
 
 ## Contributing
 
 The CLI is built with:
-- Node.js/TypeScript
-- Commander.js for CLI framework
-- Axios for HTTP requests
-- Keytar for secure credential storage
-- Chalk for colored output
-- CLI-table3 for formatted tables
-
-For development and contribution guidelines, see the CLI repository.
+- **Node.js/TypeScript** - Core runtime and type safety
+- **Commander.js** - CLI framework and command parsing
+- **Inquirer** - Interactive prompts
+- **Axios** - HTTP requests for API calls
+- **Keytar** - Secure credential storage (system keychain)
+- **Chalk** - Colored terminal output
+- **CLI-table3** - Formatted table output
+- **Open** - Cross-platform browser opening
+
+### Development
+
+```bash
+# Clone repository
+git clone https://github.com/nextagencyio/decoupled-dashboard.git
+cd decoupled-dashboard/cli
+
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Run locally
+npm start -- [command]
+
+# Watch mode for development
+npm run dev
+```
+
+### Project Structure
+
+```
+cli/
+├── src/
+│   ├── commands/        # CLI command implementations
+│   │   ├── auth.ts           # Authentication commands
+│   │   ├── auth-interactive.ts # OAuth flow
+│   │   ├── spaces.ts         # Space management
+│   │   ├── content.ts        # Content import
+│   │   ├── mcp.ts            # MCP configuration
+│   │   ├── usage.ts          # Usage statistics
+│   │   ├── org.ts            # Organization management
+│   │   ├── health.ts         # Health checks
+│   │   └── config.ts         # CLI configuration
+│   ├── lib/             # Shared utilities
+│   │   ├── api.ts            # API client
+│   │   └── config.ts         # Config management
+│   └── index.ts         # CLI entry point
+├── examples/            # Example files
+│   └── content-import-sample.json
+└── package.json
+```
+
+## Version & Updates
+
+```bash
+# Check current version
+decoupled-cli --version
+
+# Update to latest
+npm install -g decoupled-cli@latest
+
+# View changelog
+npm view decoupled-cli versions
+```
+
+**Current Version:** 2.4.1
+
+**Recent Changes:**
+- Added Model Context Protocol (MCP) support
+- Implemented OAuth authentication flow
+- Added content import functionality
+- Removed legacy AI configuration files
+
+## Getting Help
+
+```bash
+# General help
+decoupled-cli --help
+
+# Command-specific help
+decoupled-cli [command] --help
+
+# Examples
+decoupled-cli spaces --help
+decoupled-cli mcp configure --help
+```
+
+**Additional Resources:**
+- Documentation: Check the main repository docs
+- Issues: Report bugs on GitHub
+- Support: Contact through the dashboard
+
+## License
+
+MIT
+
+---
+
+Made with ❤️ by the Decoupled.io team

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "decoupled-cli",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "Command-line interface for managing Decoupled Drupal spaces, deploying content, and automating workflows. Features AI-powered quick-start, content import, and CI/CD integration.",
   "main": "dist/index.js",
   "bin": {

package/dist/commands/download.d.ts

@@ -1,4 +0,0 @@
-import { Command } from 'commander';
-declare const downloadCommand: Command;
-export { downloadCommand };
-//# sourceMappingURL=download.d.ts.map

package/dist/commands/download.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/commands/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,QAAA,MAAM,eAAe,SAA0B,CAAC;AAiGhD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/commands/download.js

@@ -1,127 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.downloadCommand = void 0;
-const commander_1 = require("commander");
-const chalk_1 = __importDefault(require("chalk"));
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const downloadCommand = new commander_1.Command('download');
-exports.downloadCommand = downloadCommand;
-downloadCommand
-    .description('Download AI configuration files')
-    .argument('<file>', 'AI config file to download (cursorrules, claude, gemini)')
-    .action(async (file) => {
-    try {
-        // Normalize the file argument
-        const availableFiles = {
-            'cursorrules': { filename: '.cursorrules', displayName: 'Cursor Rules' },
-            'cursor': { filename: '.cursorrules', displayName: 'Cursor Rules' },
-            'claude': { filename: 'CLAUDE.md', displayName: 'Claude Code Configuration' },
-            'gemini': { filename: 'GEMINI.md', displayName: 'Google Gemini Configuration' }
-        };
-        const normalizedFile = file.toLowerCase();
-        if (!availableFiles[normalizedFile]) {
-            console.error(chalk_1.default.red(`❌ Unknown file: ${file}`));
-            console.log(chalk_1.default.gray('\nAvailable files:'));
-            Object.entries(availableFiles).forEach(([key, config]) => {
-                console.log(chalk_1.default.gray(`  • ${key} → ${config.filename} (${config.displayName})`));
-            });
-            process.exit(1);
-        }
-        const fileConfig = availableFiles[normalizedFile];
-        const sourceFileName = fileConfig.filename;
-        const displayName = fileConfig.displayName;
-        // Get the directory where the CLI is installed
-        const cliDir = path.resolve(__dirname, '../..');
-        const examplesDir = path.join(cliDir, 'examples');
-        const sourcePath = path.join(examplesDir, sourceFileName);
-        // Check if source file exists
-        if (!fs.existsSync(sourcePath)) {
-            console.error(chalk_1.default.red(`❌ Source file not found: ${sourcePath}`));
-            process.exit(1);
-        }
-        // Destination path (current working directory)
-        const destPath = path.join(process.cwd(), sourceFileName);
-        // Check if destination file already exists
-        if (fs.existsSync(destPath)) {
-            const { default: inquirer } = await Promise.resolve().then(() => __importStar(require('inquirer')));
-            const answers = await inquirer.prompt([
-                {
-                    type: 'confirm',
-                    name: 'overwrite',
-                    message: `File ${sourceFileName} already exists. Overwrite?`,
-                    default: false
-                }
-            ]);
-            if (!answers.overwrite) {
-                console.log(chalk_1.default.yellow('Operation cancelled.'));
-                return;
-            }
-        }
-        // Read and write the file
-        const content = fs.readFileSync(sourcePath, 'utf8');
-        fs.writeFileSync(destPath, content, 'utf8');
-        console.log(chalk_1.default.green(`✅ Downloaded ${displayName}`));
-        console.log(chalk_1.default.gray(`📁 Saved to: ${destPath}`));
-        // Show file size and first few lines as preview
-        const stats = fs.statSync(destPath);
-        const lines = content.split('\n');
-        const previewLines = lines.slice(0, 3).join('\n');
-        console.log(chalk_1.default.gray(`📊 Size: ${stats.size} bytes`));
-        console.log(chalk_1.default.gray('📄 Preview:'));
-        console.log(chalk_1.default.dim(previewLines + (lines.length > 3 ? '\n...' : '')));
-    }
-    catch (error) {
-        console.error(chalk_1.default.red('❌ Failed to download file:'), error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-});
-// Add help examples
-downloadCommand.addHelpText('after', `
-Examples:
-  decoupled-cli download cursorrules     Download .cursorrules file for Cursor AI
-  decoupled-cli download claude          Download CLAUDE.md configuration
-  decoupled-cli download gemini          Download GEMINI.md configuration
-
-Available Files:
-  • cursorrules/.cursor  → .cursorrules (Cursor AI configuration)
-  • claude               → CLAUDE.md (Claude Code configuration)  
-  • gemini               → GEMINI.md (Google Gemini configuration)
-`);
-//# sourceMappingURL=download.js.map

package/dist/commands/download.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/commands/download.ts"],"names":[],"mappings":"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"}