@adobe-commerce/aio-toolkit 1.0.14 → 1.0.15

package/CHANGELOG.md

@@ -5,6 +5,43 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.15] - 2026-02-09
+
+### ✨ Features
+
+- **feat(cli):** New Cursor IDE Context Management CLI (`aio-toolkit-cursor-context`)
+  - Command-line tool for managing Cursor IDE context files in Adobe App Builder projects
+  - Three sub-commands: `check`, `apply`, and `help`
+  - Automatic IDE detection (macOS, Windows, Linux)
+  - Model Context Protocol (MCP) server configuration
+  - Force mode for CI/CD pipelines
+  - Multi-directory support (`.cursor/rules` and `.cursor/commands`)
+  - Comprehensive error handling and user feedback
+
+### 💡 Usage Examples
+
+**Check context setup**:
+```bash
+npx aio-toolkit-cursor-context check
+```
+
+**Apply contexts (standard mode)**:
+```bash
+npx aio-toolkit-cursor-context apply
+```
+
+**Apply contexts (force mode)**:
+```bash
+npx aio-toolkit-cursor-context apply -f
+```
+
+**Display help**:
+```bash
+npx aio-toolkit-cursor-context help
+```
+
+---
+
 ## [1.0.14] - 2026-01-20
 
 ### ✨ Features

package/README.md

@@ -1487,6 +1487,100 @@ const registrations = await manager.list();
 await manager.delete('your-registration-id');
 ```
 
+### 🛠️ CLI Tools
+
+#### `aio-toolkit-cursor-context`
+
+Command-line tool for managing Cursor IDE context files (rules and commands) in your Adobe App Builder projects. This CLI automatically sets up Cursor IDE-specific contexts and configures the Model Context Protocol (MCP) server for enhanced development experience.
+
+##### Commands
+
+###### `check`
+Validates that Cursor contexts are properly set up in your project.
+
+```bash
+npx aio-toolkit-cursor-context check
+```
+
+**Features:**
+- ✅ Checks for `.cursor/rules` and `.cursor/commands` directories
+- ✅ Validates MCP server configuration
+- ✅ Detects if running in Cursor IDE
+- ✅ Reports missing files or configurations
+
+**Output Example:**
+```
+✅ Cursor IDE detected
+✅ MCP server configured
+✅ Found 3 context files in .cursor/rules
+✅ Found 4 context files in .cursor/commands
+✅ Cursor contexts are properly set up
+```
+
+###### `apply`
+Copies Cursor context files from the package to your project.
+
+```bash
+# Standard mode - copies missing files only
+npx aio-toolkit-cursor-context apply
+
+# Force mode - overwrites existing files and bypasses IDE detection
+npx aio-toolkit-cursor-context apply -f
+npx aio-toolkit-cursor-context apply --force
+```
+
+**Features:**
+- 📁 Copies context files to `.cursor/rules` and `.cursor/commands`
+- 🔄 Creates MCP configuration in `.cursor/mcp.json`
+- 🛡️ IDE detection prevents accidental application in non-Cursor environments
+- ⚡ Force mode for CI/CD pipelines or when IDE detection fails
+- 📊 Reports copied, skipped, and overwritten files
+
+**Standard Mode Output:**
+```
+Copied 3 new context files to .cursor/rules
+Skipped 2 files (already exist)
+✅ MCP server configured
+✅ All cursor contexts applied successfully
+```
+
+**Force Mode Output:**
+```
+Overwritten 5 existing files in .cursor/rules
+Copied 4 new files to .cursor/commands
+✅ MCP server configured
+✅ All cursor contexts applied successfully (force mode)
+```
+
+###### `help`
+Displays help information for the CLI.
+
+```bash
+npx aio-toolkit-cursor-context help
+```
+
+##### Context Files Included
+
+The CLI provides the following context files:
+
+**Rules (`.cursor/rules/`):**
+- `aio-toolkit-create-adobe-commerce-client.mdc` - Creating Adobe Commerce client operations
+- `aio-toolkit-oop-best-practices.mdc` - Object-oriented programming best practices
+- `aio-toolkit-setup-new-relic-telemetry.mdc` - Setting up New Relic telemetry
+
+**Commands (`.cursor/commands/`):**
+- `aio-toolkit-create-event-consumer-action.md` - Create event consumer actions
+- `aio-toolkit-create-graphql-action.md` - Create GraphQL actions
+- `aio-toolkit-create-runtime-action.md` - Create runtime actions
+- `aio-toolkit-create-webhook-action.md` - Create webhook actions
+
+##### Use Cases
+
+1. **Initial Project Setup**: Run `apply` to set up all Cursor contexts
+2. **Continuous Integration**: Use `apply -f` in CI/CD pipelines
+3. **Verification**: Run `check` to ensure contexts are properly configured
+4. **Updates**: Run `apply -f` after toolkit updates to get latest contexts
+
 ## Environment Variables
 
 Common environment variables used across components: