@maka/maka-cli 5.2.11 → 5.3.1

package/docs/MCP_SERVER.md

@@ -1,396 +0,0 @@
-# Maka CLI MCP Server
-
-The Maka CLI includes an enhanced Model Context Protocol (MCP) server that exposes **all maka-cli capabilities** to AI agents like Claude. This allows AI assistants to discover, understand, and help you use any maka-cli command.
-
-## Quick Start
-
-Start the MCP server:
-
-```bash
-maka ai:mcp
-```
-
-The server starts on `http://localhost:3000` by default and automatically discovers all available maka-cli commands.
-
-## Options
-
-- `--port` - Port to listen on (default: 3000)
-- `--host` - Host to bind to (default: localhost)
-
-### Examples
-
-```bash
-# Start on default port
-maka ai:mcp
-
-# Custom port
-maka ai:mcp --port=8080
-
-# Bind to all network interfaces
-maka ai:mcp --host=0.0.0.0 --port=3001
-```
-
-## Server Features
-
-### Tools
-
-The MCP server provides these tools for AI agents:
-
-#### 1. `list-maka-commands`
-List all available Maka CLI commands with descriptions and usage.
-
-**Parameters:**
-- `filter` (optional): Filter commands by name or category (e.g., "aws", "generate", "deploy")
-
-**Example Usage:**
-```json
-{
-  "name": "list-maka-commands",
-  "arguments": {
-    "filter": "generate"
-  }
-}
-```
-
-#### 2. `get-command-info`
-Get detailed information about a specific command including usage, options, examples, and description.
-
-**Parameters:**
-- `command` (required): Command name (e.g., "create", "generate:component", "aws:create-instance")
-
-**Example Usage:**
-```json
-{
-  "name": "get-command-info",
-  "arguments": {
-    "command": "generate:component"
-  }
-}
-```
-
-#### 3. `execute-maka-command`
-Execute Maka CLI commands with safety restrictions to prevent destructive operations.
-
-**Parameters:**
-- `command` (required): Full command to execute (e.g., "maka --help")
-- `workingDirectory` (optional): Working directory for the command
-
-**Safety Features:**
-- Blocks destructive commands (murder, uninstall, rm, delete)
-- 30-second timeout
-- 10MB output buffer limit
-
-**Example Usage:**
-```json
-{
-  "name": "execute-maka-command",
-  "arguments": {
-    "command": "maka --help"
-  }
-}
-```
-
-#### 4. `get-project-info`
-Get information about the current Maka project including configuration.
-
-**Example Usage:**
-```json
-{
-  "name": "get-project-info",
-  "arguments": {}
-}
-```
-
-### Resources
-
-#### 1. `maka://commands/all`
-Complete reference of all Maka CLI commands in JSON format.
-
-**Format:**
-```json
-[
-  {
-    "name": "create",
-    "aliases": "None",
-    "shortDesc": "Create a new Meteor application",
-    "description": "...",
-    "usage": "maka create <app-name>",
-    "examples": ["maka create MyApp"],
-    "validOpts": ["..."],
-    "requiredOpts": [],
-    "experimental": false
-  }
-]
-```
-
-#### 2. `maka://project/config`
-Current project configuration and metadata.
-
-#### 3. `maka://info`
-Maka CLI version, platform, and system information.
-
-### Prompts
-
-Interactive conversation starters for common workflows:
-
-#### 1. `create-component`
-Component creation wizard with examples and best practices.
-
-**Parameters:**
-- `componentName` (required): Name of the component
-- `componentType` (optional): Type (component, page, layout, template)
-
-#### 2. `deploy-help`
-Deployment guide for different platforms and environments.
-
-**Parameters:**
-- `environment` (optional): Target environment (dev, staging, production)
-- `platform` (optional): Deployment platform (aws, docker, custom)
-
-#### 3. `project-setup`
-Interactive guide for setting up a new Maka project.
-
-**Parameters:**
-- `projectType` (optional): Project type (basic, full-stack, api)
-
-## Protocol
-
-The server implements the [Model Context Protocol](https://modelcontextprotocol.io) specification:
-
-- **Transport**: Streamable HTTP (stateless mode)
-- **Format**: Server-Sent Events (SSE)
-- **Message Protocol**: JSON-RPC 2.0
-- **Protocol Version**: 2024-11-05
-
-## Endpoints
-
-- `POST /mcp` - MCP protocol endpoint (Server-Sent Events)
-- `GET /health` - Health check endpoint
-
-## Testing
-
-### Health Check
-```bash
-curl http://localhost:3000/health
-```
-
-### List Available Tools
-```bash
-curl -X POST http://localhost:3000/mcp \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json, text/event-stream" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 1,
-    "method": "tools/list",
-    "params": {}
-  }'
-```
-
-### Call a Tool
-```bash
-curl -X POST http://localhost:3000/mcp \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json, text/event-stream" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 2,
-    "method": "tools/call",
-    "params": {
-      "name": "list-maka-commands",
-      "arguments": {
-        "filter": "aws"
-      }
-    }
-  }'
-```
-
-## Integrating with Claude Desktop
-
-Add this configuration to your Claude Desktop MCP settings:
-
-```json
-{
-  "mcpServers": {
-    "maka-cli": {
-      "command": "maka",
-      "args": ["ai:mcp", "--port=3000"],
-      "transport": "http",
-      "url": "http://localhost:3000/mcp"
-    }
-  }
-}
-```
-
-Alternatively, run the server manually and configure Claude Desktop to connect to the HTTP endpoint:
-
-```json
-{
-  "mcpServers": {
-    "maka-cli": {
-      "transport": "http",
-      "url": "http://localhost:3000/mcp"
-    }
-  }
-}
-```
-
-## How It Works
-
-### Command Discovery
-
-The MCP server automatically discovers all commands by traversing the Maka CLI command tree:
-
-1. Starts at the root `Maka` command
-2. Recursively explores all subcommands
-3. Extracts metadata (name, description, usage, options, examples)
-4. Filters out internal/hidden commands
-5. Builds a complete command registry
-
-This means **any new command added to maka-cli is automatically exposed** through the MCP server.
-
-### Project Detection
-
-The server detects if you're in a Maka project by looking for `.maka/config.json`. Project-specific information is exposed through the `get-project-info` tool and `maka://project/config` resource.
-
-## Use Cases for AI Agents
-
-With this MCP server, AI agents like Claude can:
-
-1. **Discover Commands**: "What commands are available in maka-cli?"
-2. **Get Help**: "How do I create a new component?"
-3. **Learn Usage**: "Show me examples of the deploy command"
-4. **Execute Commands**: "Run maka --version for me"
-5. **Guide Workflows**: "Walk me through deploying to AWS"
-6. **Project Context**: "What's configured in my current project?"
-
-## Customization
-
-### Adding Custom Tools
-
-Edit `src/commands/ai/mcp.sub.cmd.ts` and add new tools:
-
-```typescript
-server.tool(
-  'my-custom-tool',
-  'Description of what my tool does',
-  {
-    param1: z.string().describe('Description of parameter')
-  },
-  async ({ param1 }) => {
-    // Your tool logic here
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `Result: ${param1}`
-        }
-      ]
-    };
-  }
-);
-```
-
-### Adding Custom Resources
-
-```typescript
-server.resource(
-  'my-resource',
-  'maka://custom/resource',
-  {
-    mimeType: 'application/json',
-    description: 'My custom resource'
-  },
-  async () => {
-    return {
-      contents: [
-        {
-          uri: 'maka://custom/resource',
-          mimeType: 'application/json',
-          text: JSON.stringify({ data: 'value' }, null, 2)
-        }
-      ]
-    };
-  }
-);
-```
-
-### Adding Custom Prompts
-
-```typescript
-server.prompt(
-  'my-workflow',
-  'Guided workflow for a specific task',
-  {
-    taskType: z.enum(['option1', 'option2']).describe('Type of task')
-  },
-  async ({ taskType }) => {
-    return {
-      messages: [
-        {
-          role: 'user',
-          content: {
-            type: 'text',
-            text: `Help me with ${taskType}`
-          }
-        },
-        {
-          role: 'assistant',
-          content: {
-            type: 'text',
-            text: `Here's how to handle ${taskType}...`
-          }
-        }
-      ]
-    };
-  }
-);
-```
-
-## CORS Configuration
-
-The server is configured with CORS enabled for all origins by default. For production:
-
-```typescript
-app.use(cors({
-  origin: 'https://yourdomain.com', // Restrict to specific origin
-  exposedHeaders: ['Mcp-Session-Id']
-}));
-```
-
-## Dependencies
-
-- `@modelcontextprotocol/sdk` - MCP SDK
-- `express` - HTTP server
-- `cors` - CORS middleware
-- `zod` - Schema validation
-
-## Architecture
-
-```
-┌─────────────────┐
-│   AI Agent      │
-│  (e.g. Claude)  │
-└────────┬────────┘
-         │ MCP over HTTP
-         │
-┌────────▼────────┐
-│   MCP Server    │
-│  (ai:mcp cmd)   │
-├─────────────────┤
-│ • Tools         │
-│ • Resources     │
-│ • Prompts       │
-└────────┬────────┘
-         │
-         ├─► Command Discovery (Maka._commands)
-         ├─► Project Detection (.maka/config.json)
-         └─► Command Execution (execSync with safety)
-```
-
-## Resources
-
-- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
-- [MCP SDK on GitHub](https://github.com/modelcontextprotocol/typescript-sdk)
-- [Claude Desktop MCP Integration](https://docs.anthropic.com/claude/docs/model-context-protocol)
-- [Maka CLI Documentation](https://www.maka-cli.com)

package/eslint.config.js

@@ -1,19 +0,0 @@
-import globals from "globals";
-import pluginJs from "@eslint/js";
-import tseslint from "typescript-eslint";
-
-
-export default [
-  {files: ["**/*.{js,mjs,cjs,ts}"]},
-  {languageOptions: { globals: globals.browser }},
-  pluginJs.configs.recommended,
-  ...tseslint.configs.recommended,
-  {
-    rules: {
-      "@typescript-eslint/no-explicit-any": "off",
-    },
-  },
-  {
-    ignores: ["src/templates/**/*"]
-  }
-];

package/jest.config.js

@@ -1,12 +0,0 @@
-export default {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  testMatch: ['**/*.test.ts'],
-  moduleFileExtensions: ['ts', 'js'],
-  transform: {
-    '^.+\\.ts$': 'ts-jest',
-  },
-  coveragePathIgnorePatterns: ['/bundle'],
-  passWithNoTests: true,
-};
-

package/test/integration/default.test.js

@@ -1,84 +0,0 @@
-var assert = require("chai").assert;
-var helpers = require('./integration_helpers');
-
-describe("default languages", function() {
-
-  it('react genenerated correctly', function(done) {
-    helpers.compare('react', [''], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-  it('react-material genenerated correctly', function(done) {
-    helpers.compare('react', ['--theme=material'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-  it('react-ssr genenerated correctly', function(done) {
-    helpers.compare('react', ['--ssr=true'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-
-  it('react-apollo genenerated correctly', function(done) {
-    helpers.compare('react', ['--graphql=apollo'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-  it('react-apollo-ssr genenerated correctly', function(done) {
-    helpers.compare('react', ['--graphql=apollo', '--ssr=true'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-  it('reflux genenerated correctly', function(done) {
-    helpers.compare('react', ['--client=reflux'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-  it('reflux-material genenerated correctly', function(done) {
-    helpers.compare('react', ['--client=reflux', '--theme=material'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-  it('reflux-ssr genenerated correctly', function(done) {
-    helpers.compare('react', ['--client=reflux', '--ssr=true'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-  it('reflux-apollo genenerated correctly', function(done) {
-    helpers.compare('react', ['--client=reflux', '--graphql=apollo'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-  it('reflux-apollo-ssr genenerated correctly', function(done) {
-    helpers.compare('react', ['--client=reflux', '--graphql=apollo', '-ssr=true'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-
-
-  it('blaze genenerated correctly', function(done) {
-    helpers.compare('react', ['--client=blaze'], function(err) {
-      assert(err == null, err);
-      done();
-    });
-  });
-});

package/test/integration/fixtures/blaze/.maka/config.json

@@ -1,30 +0,0 @@
-{
-  "engines": {
-    "html": "html",
-    "js": "js",
-    "css": "css",
-    "api": "none",
-    "client": "blaze",
-    "test": "none",
-    "graphql": "none",
-    "ssr": "false"
-  },
-
-  "template": {
-    "html": "true",
-    "js": "true",
-    "css": "true",
-    "test": "true"
-  },
-  "features": {
-    "withTracker": "true"
-  },
-  "route": {
-    "controller": "",
-    "template": "true"
-  },
-
-  "generator": {
-    "comments": "true"
-  }
-}

package/test/integration/fixtures/blaze/.tern-project

@@ -1,17 +0,0 @@
-{
-    "libs": [
-        "browser",
-        "jquery",
-        "underscore"
-    ],
-    "loadEagerly": [ "*.js", "*/*.js", "*/*/*.js", "*/*/*/*.js" ],
-    "dontLoad": [ ".meteor" ],
-    "plugins": {
-        "meteor": {}
-    },
-    "requirejs": {
-        "baseURL": "./",
-        "paths": {}
-    },
-    "node": {}
-}

package/test/integration/fixtures/blaze/app/.meteor/.finished-upgraders

@@ -1,17 +0,0 @@
-# This file contains information which helps Meteor properly upgrade your
-# app when you run 'meteor update'. You should check it into version control
-# with your project.
-
-notices-for-0.9.0
-notices-for-0.9.1
-0.9.4-platform-file
-notices-for-facebook-graph-api-2
-1.2.0-standard-minifiers-package
-1.2.0-meteor-platform-split
-1.2.0-cordova-changes
-1.2.0-breaking-changes
-1.3.0-split-minifiers-package
-1.4.0-remove-old-dev-bundle-link
-1.4.1-add-shell-server-package
-1.4.3-split-account-service-packages
-1.5-add-dynamic-import-package

package/test/integration/fixtures/blaze/app/.meteor/.id

@@ -1,7 +0,0 @@
-# This file contains a token that is unique to your project.
-# Check it into your repository along with the rest of this directory.
-# It can be used for purposes such as:
-#   - ensuring you don't accidentally deploy one app on top of another
-#   - providing package authors with aggregated statistics
-
-y8p9ecjug4zu.hb4hpnxnc5o7

package/test/integration/fixtures/blaze/app/.meteor/packages

@@ -1,21 +0,0 @@
-# Meteor packages used by this project, one per line.
-# Check this file (and the other files in this directory) into your repository.
-#
-# 'meteor add' and 'meteor remove' will edit this file for you,
-# but you can also edit it by hand.
-
-meteor-base@1.3.0             # Packages every Meteor app needs to have
-mobile-experience@1.0.5       # Packages for a great mobile UX
-mongo@1.4.2                   # The database Meteor supports right now
-blaze-html-templates@1.0.4 # Compile .html files into Meteor Blaze views
-reactive-var@1.0.11            # Reactive variable for tracker
-tracker@1.1.3                 # Meteor's client-side reactive programming library
-
-standard-minifier-css@1.4.0   # CSS minifier run for production mode
-standard-minifier-js@2.3.1    # JS minifier run for production mode
-es5-shim@4.7.0                # ECMAScript 5 compatibility for older browsers
-ecmascript@0.10.0              # Enable ECMAScript2015+ syntax in app code
-shell-server@0.3.1            # Server-side component of the `meteor shell` command
-
-autopublish@1.0.7             # Publish all data to the clients (for prototyping)
-insecure@1.0.7                # Allow all DB writes from clients (for prototyping)

package/test/integration/fixtures/blaze/app/.meteor/platforms

@@ -1,2 +0,0 @@
-server
-browser

package/test/integration/fixtures/blaze/app/.meteor/release

@@ -1 +0,0 @@
-METEOR@1.6.1

package/test/integration/fixtures/blaze/app/.meteor/versions

@@ -1,78 +0,0 @@
-allow-deny@1.1.0
-autopublish@1.0.7
-autoupdate@1.4.0
-babel-compiler@7.0.5
-babel-runtime@1.2.2
-base64@1.0.11
-binary-heap@1.0.10
-blaze@2.3.2
-blaze-html-templates@1.1.2
-blaze-tools@1.0.10
-boilerplate-generator@1.4.0
-caching-compiler@1.1.11
-caching-html-compiler@1.1.2
-callback-hook@1.1.0
-check@1.3.1
-ddp@1.4.0
-ddp-client@2.3.2
-ddp-common@1.4.0
-ddp-server@2.1.2
-deps@1.0.12
-diff-sequence@1.1.0
-dynamic-import@0.3.0
-ecmascript@0.10.5
-ecmascript-runtime@0.5.0
-ecmascript-runtime-client@0.6.2
-ecmascript-runtime-server@0.5.0
-ejson@1.1.0
-es5-shim@4.7.3
-geojson-utils@1.0.10
-hot-code-push@1.0.4
-html-tools@1.0.11
-htmljs@1.0.11
-http@1.4.0
-id-map@1.1.0
-insecure@1.0.7
-jquery@1.11.11
-launch-screen@1.1.1
-livedata@1.0.18
-logging@1.1.20
-meteor@1.8.6
-meteor-base@1.3.0
-minifier-css@1.3.1
-minifier-js@2.3.3
-minimongo@1.4.3
-mobile-experience@1.0.5
-mobile-status-bar@1.0.14
-modules@0.11.5
-modules-runtime@0.9.2
-mongo@1.4.5
-mongo-dev-server@1.1.0
-mongo-id@1.0.7
-npm-mongo@2.2.34
-observe-sequence@1.0.16
-ordered-dict@1.1.0
-promise@0.10.2
-random@1.1.0
-reactive-var@1.0.11
-reload@1.2.0
-retry@1.1.0
-routepolicy@1.0.13
-server-render@0.3.0
-shell-server@0.3.1
-shim-common@0.1.0
-socket-stream-client@0.1.0
-spacebars@1.0.15
-spacebars-compiler@1.1.3
-standard-minifier-css@1.4.1
-standard-minifier-js@2.3.2
-templating@1.3.2
-templating-compiler@1.3.3
-templating-runtime@1.3.2
-templating-tools@1.1.2
-tracker@1.1.3
-ui@1.0.13
-underscore@1.0.10
-url@1.2.0
-webapp@1.5.0
-webapp-hashing@1.0.9

package/test/integration/fixtures/blaze/app/client/.gitkeep

@@ -1 +0,0 @@
-

package/test/integration/fixtures/blaze/app/client/body.html

@@ -1,2 +0,0 @@
-<body>
-</body>