decoupled-cli 2.4.0 → 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/dist/index.js

@@ -14,7 +14,6 @@ const usage_1 = require("./commands/usage");
 const org_1 = require("./commands/org");
 const health_1 = require("./commands/health");
 const config_1 = require("./commands/config");
-const download_1 = require("./commands/download");
 const content_1 = require("./commands/content");
 const mcp_1 = require("./commands/mcp");
 // Read version from package.json
@@ -37,7 +36,6 @@ program.addCommand(usage_1.usageCommand);
 program.addCommand(org_1.orgCommand);
 program.addCommand(health_1.healthCommand);
 program.addCommand(config_1.configCommand);
-program.addCommand(download_1.downloadCommand);
 program.addCommand(content_1.contentCommand);
 program.addCommand(mcp_1.mcpCommand);
 // Handle unknown commands

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AACpC,kDAA0B;AAC1B,2BAAkC;AAClC,+BAA4B;AAC5B,0CAA8C;AAC9C,8CAAkD;AAClD,4CAAgD;AAChD,wCAA4C;AAC5C,8CAAkD;AAClD,8CAAkD;AAClD,kDAAsD;AACtD,gDAAoD;AACpD,wCAA4C;AAE5C,iCAAiC;AACjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAC1D,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,yCAAyC,CAAC;KACtD,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;KAClD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;KAClD,MAAM,CAAC,WAAW,EAAE,sBAAsB,CAAC;KAC3C,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC;KAC9C,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;AAE1D,eAAe;AACf,OAAO,CAAC,UAAU,CAAC,kBAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,oBAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,gBAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,0BAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,wBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,gBAAU,CAAC,CAAC;AAE/B,0BAA0B;AAC1B,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,+BAA+B;AAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;AAEhB,oCAAoC;AACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AACpC,kDAA0B;AAC1B,2BAAkC;AAClC,+BAA4B;AAC5B,0CAA8C;AAC9C,8CAAkD;AAClD,4CAAgD;AAChD,wCAA4C;AAC5C,8CAAkD;AAClD,8CAAkD;AAClD,gDAAoD;AACpD,wCAA4C;AAE5C,iCAAiC;AACjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAC1D,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,yCAAyC,CAAC;KACtD,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;KAClD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;KAClD,MAAM,CAAC,WAAW,EAAE,sBAAsB,CAAC;KAC3C,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC;KAC9C,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;AAE1D,eAAe;AACf,OAAO,CAAC,UAAU,CAAC,kBAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,oBAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,gBAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,wBAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,gBAAU,CAAC,CAAC;AAE/B,0BAA0B;AAC1B,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,+BAA+B;AAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;AAEhB,oCAAoC;AACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "decoupled-cli",
-  "version": "2.4.0",
+  "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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"}

package/examples/.cursorrules

@@ -1,189 +0,0 @@
-You are the Cursor AI working in a Next.js + Drupal monorepo. Follow these rules to deliver complete, working features end-to-end.
-
-# Project Overview
-- Architecture: Headless Drupal backend with Next.js frontend
-- Backend: Drupal 11 with GraphQL Compose and DC Import API
-- Frontend: Next.js 15 with TypeScript, Tailwind CSS, Apollo GraphQL
-- Environment: DDEV local development
-
-# Environment Configuration
-- Environment variables in `.env.local`:
-  - `NEXT_PUBLIC_DRUPAL_BASE_URL` – Drupal base URL
-  - `DRUPAL_CLIENT_ID` / `DRUPAL_CLIENT_SECRET` – OAuth credentials
-  - `DRUPAL_REVALIDATE_SECRET` – On-demand revalidation secret
-  - `NODE_TLS_REJECT_UNAUTHORIZED=0` – Allow self-signed certs (dev)
-
-# DC CLI Usage
-**CRITICAL**: Use DC CLI instead of direct API calls.
-
-First-time setup:
-```bash
-decoupled-cli auth login         # Authenticate with platform
-decoupled-cli spaces use <id>    # Set default space (optional)
-decoupled-cli spaces current     # Verify setup
-```
-
-# End-to-End Workflow
-When asked to implement a new content type (e.g., “create a product page”), complete all steps:
-
-1) Verify CLI authentication
-```bash
-decoupled-cli auth status        # Check if authenticated
-decoupled-cli spaces list        # List available spaces
-decoupled-cli spaces use <id>    # Set default space if needed
-```
-
-2) Plan content type
-- Define name + machine name
-- List fields and types
-- Determine components, routes, display needs
-
-3) Create DC Import JSON
-- Get example format: `decoupled-cli spaces content-import --example`
-- Include model definition and sample content
-- Important: In `values`, use field ID directly, never with `field_` prefix
-- For image fields: Use full URLs with Drupal domain from `.env.local`, not relative paths
-
-Template:
-```json
-{
-  "model": [
-    {
-      "bundle": "content_type_name",
-      "description": "Description",
-      "label": "Content Type Label",
-      "body": true,
-      "fields": [
-        { "id": "field_name", "label": "Field Label", "type": "text|string|image|datetime|bool|text[]" }
-      ]
-    }
-  ],
-  "content": [
-    {
-      "id": "item1",
-      "type": "node.content_type_name",
-      "path": "/content-type/item-slug",
-      "values": {
-        "title": "Item Title",
-        "body": "<p>Body content</p>",
-        "field_name": "field_value",
-        "image_field": {
-          "uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png",
-          "alt": "Image description",
-          "title": "Image title"
-        }
-      }
-    }
-  ]
-}
-```
-
-4) Import via DC CLI
-```bash
-# Import content type and sample content
-decoupled-cli spaces content-import --file content-type-import.json --preview  # Preview first
-decoupled-cli spaces content-import --file content-type-import.json              # Apply changes
-
-# Generate example if needed
-decoupled-cli spaces content-import --example > content-type-import.json
-```
-- **CRITICAL**: Immediately run schema generation:
-```bash
-npm run generate-schema
-```
-- Verify: machine names, created nodes, and GraphQL schema updates
-
-4) Implement frontend
-- Files:
-```
-app/
-  components/
-    [ContentType]Card.tsx
-    [ContentType]Renderer.tsx
-    DynamicIcon.tsx (optional)
-  [content-type]/page.tsx
-  [...slug]/page.tsx (update)
-lib/
-  queries.ts (update)
-  types.ts (update)
-```
- - GraphQL: add list query and update `GET_NODE_BY_PATH` cases
- - Types: add `Drupal[ContentType]` and `[...]Data` interfaces
- - Components: card + renderer; use `dangerouslySetInnerHTML` for processed HTML
- - Routing: handle in dynamic route switch by `__typename`
- - Navigation: add link in `app/components/Header.tsx`; update `navigationItems` and active detection with `pathname.startsWith('/route/')`
- - DC GraphQL fields return simple types (`string`, `string[]`, `bool`, etc.), not `{ processed }` objects — probe schema with a quick query before typing components
-
-5) Build and test
-- `npm run build` → fix TypeScript/build errors
-- `npm run dev` → verify listing and detail views
-- Check URLs: `/[content-type]`, `/[content-type]/[slug]`
-
-Checklist:
-- [ ] DC import succeeds
-- [ ] **Schema generation runs (`npm run generate-schema`)**
-- [ ] GraphQL schema exposes fields
-- [ ] Types compile
-- [ ] Build passes
-- [ ] Listing and detail pages render
-- [ ] Navigation works, responsive design verified
-
-# Component Architecture
-- Per type, create `[ContentType]Card.tsx` (listing) and `[ContentType]Renderer.tsx` (detail)
-- Cards: preview data + CTA; Renderers: full display, responsive layout
-- Place components in `app/components/`; listing in `app/[content-type]/page.tsx`; update `app/[...slug]/page.tsx` to route by `__typename`
-
-# Field Types Reference
-- `text` – Rich HTML field
-- `string` – Short text (≤255 chars)
-- `image` – Single image upload
-- `image[]` – Multiple image uploads
-- `datetime` – Date/time
-- `bool` – Boolean
-- `text[]` – Rich HTML list
-- `string[]` – Plain text list (recommended for features/specs)
-
-# Common Patterns
-- Product: `price (string)`, `product_images (image[])`, `in_stock (bool)`, `features (string[])`
-  - Image URI: `{"uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png", "alt": "Product image", "title": "Product"}`
-- Event: `event_date (datetime)`, `location (string)`, `speakers (string[])`
-- Team: `position (string)`, `profile_image (image)`, `bio (text)`
-  - Image URI: `{"uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png", "alt": "Team member photo", "title": "Profile"}`
-- Case Study: `project_url (string)`, `technologies (string[])`, `project_images (image[])`
-  - Image URI: `{"uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png", "alt": "Project screenshot", "title": "Interface"}`
-
-# Troubleshooting
-- DC import fails: check OAuth, JSON structure, no `field_` in values
-- **Schema not updated**: ALWAYS run `npm run generate-schema` after DC imports
-- GraphQL errors: confirm content type exists, clear GraphQL cache, regenerate schema
-- Build errors: verify types, imports, query syntax
-- Content not showing: confirm field names match GraphQL schema; for HTML use `dangerouslySetInnerHTML={{ __html: field.processed }}`
-- **Field name mismatches**: DC field IDs may transform (e.g., `in_stock` → `inStock` in GraphQL)
-
-Debug commands:
-```bash
-decoupled-cli auth status                                          # Check authentication
-decoupled-cli spaces list                                          # List available spaces
-decoupled-cli spaces current                                       # Show default space
-decoupled-cli health check                                         # Platform status
-decoupled-cli spaces content-import --file test.json --preview    # Preview import
-# MOST IMPORTANT: Generate fresh schema after any import
-npm run generate-schema
-# Check schema includes your content type
-grep -i [content_type] schema/schema.graphql
-```
-```
-
-# Best Practices
-1. **ALWAYS run `npm run generate-schema` immediately after DC imports**
-2. Create sample content for immediate testing
-3. Prefer `string[]` for simple lists; use `text[]` only when necessary
-4. Verify GraphQL field names against the actual schema (may differ from DC field IDs)
-5. Handle empty/missing data gracefully
-6. Keep TypeScript types accurate and complete
-7. Use semantic HTML and ensure responsive design
-8. **Navigation integration**: Update `navigationItems` array and use `.startsWith()` for active detection
-9. **Component architecture**: Create Card + Renderer components per content type
-
-# Success Criteria
-- Builds without errors; routes render correctly; navigation works; responsive; proper fallbacks; follows design patterns; integrates with existing auth and routing.