mdan-cli 2.2.0 → 2.3.0

package/install.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 
 # ============================================================
-# MDAN Installer
+# MDAN Installer (Remote Fetch)
 # ============================================================
 
 set -e
@@ -15,6 +15,7 @@ NC='\033[0m'
 
 INSTALL_DIR="$HOME/.mdan"
 BIN_DIR="$HOME/.local/bin"
+REPO_URL="https://github.com/khalilbenaz/MDAN/archive/refs/heads/main.tar.gz"
 
 echo -e "${CYAN}"
 echo "  ███╗   ███╗██████╗  █████╗ ███╗   ██╗"
@@ -27,9 +28,6 @@ echo -e "${NC}"
 echo -e "  ${BOLD}MDAN Installer${NC}"
 echo ""
 
-# Get the directory where this script is located
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
 echo -e "${YELLOW}Installing MDAN...${NC}"
 echo ""
 
@@ -37,171 +35,35 @@ echo ""
 mkdir -p "$INSTALL_DIR"
 mkdir -p "$BIN_DIR"
 
+# Download and extract the repository
+echo "  ⬇️  Downloading latest MDAN files..."
+TMP_DIR=$(mktemp -d)
+curl -sL "$REPO_URL" | tar -xz -C "$TMP_DIR"
+MDAN_SRC="$TMP_DIR/MDAN-main"
+
 # Copy MDAN files
 echo "  📁 Copying files to $INSTALL_DIR..."
-cp -r "$SCRIPT_DIR/core" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/agents" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/phases" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/templates" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/integrations" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/memory" "$INSTALL_DIR/"
-cp -r "$SCRIPT_DIR/skills" "$INSTALL_DIR/" 2>/dev/null || mkdir -p "$INSTALL_DIR/skills"
-cp "$SCRIPT_DIR/MDAN.md" "$INSTALL_DIR/" 2>/dev/null || true
-cp "$SCRIPT_DIR/MDAN.fr.md" "$INSTALL_DIR/" 2>/dev/null || true
-
-# Create the mdan command
-echo "  🔧 Creating mdan command..."
+cp -r "$MDAN_SRC/core" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/agents" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/phases" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/templates" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/integrations" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/memory" "$INSTALL_DIR/"
+cp -r "$MDAN_SRC/modules" "$INSTALL_DIR/" 2>/dev/null || true
+cp -r "$MDAN_SRC/workflows" "$INSTALL_DIR/" 2>/dev/null || true
+cp -r "$MDAN_SRC/skills" "$INSTALL_DIR/" 2>/dev/null || mkdir -p "$INSTALL_DIR/skills"
+cp "$MDAN_SRC/MDAN.md" "$INSTALL_DIR/" 2>/dev/null || true
+cp "$MDAN_SRC/MDAN.fr.md" "$INSTALL_DIR/" 2>/dev/null || true
+
+# Cleanup
+rm -rf "$TMP_DIR"
+
+# Create the mdan command using the Node.js version instead of the bash version for better UX
+echo "  🔧 Setting up CLI..."
 cat > "$BIN_DIR/mdan" << 'MDAN_SCRIPT'
 #!/bin/bash
-
-VERSION="2.2.0"
-MDAN_DIR="$HOME/.mdan"
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-MAGENTA='\033[0;35m'
-BOLD='\033[1m'
-NC='\033[0m'
-
-banner() {
-    echo -e "${CYAN}"
-    echo "  ███╗   ███╗██████╗  █████╗ ███╗   ██╗"
-    echo "  ████╗ ████║██╔══██╗██╔══██╗████╗  ██║"
-    echo "  ██╔████╔██║██║  ██║███████║██╔██╗ ██║"
-    echo "  ██║╚██╔╝██║██║  ██║██╔══██║██║╚██╗██║"
-    echo "  ██║ ╚═╝ ██║██████╔╝██║  ██║██║ ╚████║"
-    echo "  ╚═╝     ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝"
-    echo -e "${NC}"
-    echo -e "  ${BOLD}Multi-Agent Development Agentic Network${NC} v${VERSION}"
-    echo ""
-}
-
-show_help() {
-    banner
-    echo -e "${BOLD}USAGE${NC}"
-    echo "  mdan <command> [options]"
-    echo ""
-    echo -e "${BOLD}COMMANDS${NC}"
-    echo "  init [name]              Create a new project"
-    echo "  attach [--rebuild]       Add MDAN to existing project"
-    echo "  status                   Show project status"
-    echo "  phase [1-5]              Show phase guide"
-    echo "  agent [name]             Show agent prompt"
-    echo "  skills                   List available skills"
-    echo "  version                  Show version"
-    echo ""
-    echo -e "${BOLD}EXAMPLES${NC}"
-    echo "  mdan init my-app              # New project"
-    echo "  cd my-project && mdan attach  # Existing project"
-    echo "  mdan attach --rebuild         # Rebuild from scratch"
-    echo ""
-    echo -e "${BOLD}AGENTS${NC}"
-    echo "  product, architect, ux, dev, test, security, devops, doc"
-}
-
-cmd_init() {
-    PROJECT_NAME="${1:-my-project}"
-    echo -e "${CYAN}🚀 Creating: ${BOLD}${PROJECT_NAME}${NC}"
-    
-    mkdir -p "${PROJECT_NAME}/.mdan/agents"
-    mkdir -p "${PROJECT_NAME}/.mdan/skills"
-    mkdir -p "${PROJECT_NAME}/docs"
-    mkdir -p "${PROJECT_NAME}/.claude/skills"
-    mkdir -p "${PROJECT_NAME}/.github"
-    
-    cp "${MDAN_DIR}/core/orchestrator.md" "${PROJECT_NAME}/.mdan/"
-    cp "${MDAN_DIR}/core/universal-envelope.md" "${PROJECT_NAME}/.mdan/"
-    cp "${MDAN_DIR}/agents/"*.md "${PROJECT_NAME}/.mdan/agents/"
-    cp "${MDAN_DIR}/templates/"*.md "${PROJECT_NAME}/mdan_output/"
-    cp -r "${MDAN_DIR}/skills/"* "${PROJECT_NAME}/.mdan/skills/" 2>/dev/null || true
-    cp -r "${MDAN_DIR}/skills/"* "${PROJECT_NAME}/.claude/skills/" 2>/dev/null || true
-    
-    cat "${MDAN_DIR}/core/orchestrator.md" > "${PROJECT_NAME}/.cursorrules"
-    echo -e "\n## CURSOR INSTRUCTIONS\nAgent files in .mdan/agents/\nSkills in .mdan/skills/" >> "${PROJECT_NAME}/.cursorrules"
-    cp "${PROJECT_NAME}/.cursorrules" "${PROJECT_NAME}/.windsurfrules"
-    cp "${MDAN_DIR}/core/orchestrator.md" "${PROJECT_NAME}/.github/copilot-instructions.md"
-    
-    echo "# ${PROJECT_NAME}\n\n> Built with MDAN" > "${PROJECT_NAME}/README.md"
-    
-    echo -e "${GREEN}✅ Created ${PROJECT_NAME}/${NC}"
-    echo ""
-    echo "  ${BOLD}Next:${NC} cursor ${PROJECT_NAME}"
-}
-
-cmd_attach() {
-    REBUILD="${1}"
-    PROJECT_NAME=$(basename "$PWD")
-    
-    if [[ "$REBUILD" == "--rebuild" ]]; then
-        echo -e "${MAGENTA}🔄 REBUILD MODE: ${BOLD}${PROJECT_NAME}${NC}"
-    else
-        echo -e "${CYAN}🔗 Attaching to: ${BOLD}${PROJECT_NAME}${NC}"
-    fi
-    
-    mkdir -p .mdan/agents .mdan/skills .claude/skills .github
-    
-    cp "${MDAN_DIR}/core/orchestrator.md" .mdan/
-    cp "${MDAN_DIR}/core/universal-envelope.md" .mdan/
-    cp "${MDAN_DIR}/agents/"*.md .mdan/agents/
-    cp -r "${MDAN_DIR}/skills/"* .mdan/skills/ 2>/dev/null || true
-    cp -r "${MDAN_DIR}/skills/"* .claude/skills/ 2>/dev/null || true
-    
-    cat "${MDAN_DIR}/core/orchestrator.md" > .cursorrules
-    if [[ "$REBUILD" == "--rebuild" ]]; then
-        echo -e "\n## REBUILD MODE\nAnalyze existing code then rewrite from scratch." >> .cursorrules
-    else
-        echo -e "\n## EXISTING PROJECT\nAnalyze codebase before making changes." >> .cursorrules
-    fi
-    cp .cursorrules .windsurfrules
-    cp "${MDAN_DIR}/core/orchestrator.md" .github/copilot-instructions.md
-    
-    echo -e "${GREEN}✅ MDAN ready!${NC}"
-    echo ""
-    if [[ "$REBUILD" == "--rebuild" ]]; then
-        echo "  Start: ${CYAN}MDAN REBUILD: Analyze and rewrite this project${NC}"
-    else
-        echo "  Start: ${CYAN}MDAN: Analyze this project${NC}"
-    fi
-}
-
-cmd_status() {
-    if [[ -f ".mdan/orchestrator.md" ]]; then
-        echo -e "${GREEN}✅ MDAN is active in this project${NC}"
-        [[ -f ".mdan/STATUS.md" ]] && cat .mdan/STATUS.md
-    else
-        echo -e "${YELLOW}No MDAN project here.${NC}"
-        echo "  Run: mdan init [name]  or  mdan attach"
-    fi
-}
-
-cmd_phase() {
-    [[ -f "${MDAN_DIR}/phases/0${1}-"*.md ]] && cat "${MDAN_DIR}/phases/0${1}-"*.md || echo "Phase 1-5"
-}
-
-cmd_agent() {
-    [[ -f "${MDAN_DIR}/agents/${1}.md" ]] && cat "${MDAN_DIR}/agents/${1}.md" || echo "Agents: product, architect, ux, dev, test, security, devops, doc"
-}
-
-cmd_skills() {
-    echo -e "${CYAN}Skills:${NC}"
-    ls "${MDAN_DIR}/skills/" 2>/dev/null || echo "  No skills installed"
-}
-
-# Main
-case "${1}" in
-    init)       cmd_init "$2" ;;
-    attach)     cmd_attach "$2" ;;
-    status)     cmd_status ;;
-    phase)      cmd_phase "$2" ;;
-    agent)      cmd_agent "$2" ;;
-    skills)     cmd_skills ;;
-    version|-v) echo "MDAN v${VERSION}" ;;
-    help|--help|-h|"") show_help ;;
-    *)          echo "Unknown: $1. Run: mdan help" ;;
-esac
+# Wrapper to run the npx version of mdan-cli to ensure the interactive wizard works
+npx --yes mdan-cli "$@"
 MDAN_SCRIPT
 
 chmod +x "$BIN_DIR/mdan"
@@ -223,6 +85,7 @@ echo ""
 echo -e "${GREEN}✅ MDAN installed successfully!${NC}"
 echo ""
 echo -e "  ${BOLD}Usage:${NC}"
-echo "  mdan init my-project        # Create new project"
-echo "  cd existing && mdan attach  # Add to existing project"
+echo "  mdan init                 # Interactive setup"
+echo "  mdan init my-project      # Quick setup"
+echo "  cd existing && mdan attach"
 echo ""

package/integrations/mcp.md

@@ -0,0 +1,153 @@
+# MDAN MCP Integration
+
+> Configure Model Context Protocol for MDAN with your IDE
+
+## Overview
+
+MDAN supports MCP (Model Context Protocol) to provide your coding assistant (Cursor, Claude Code, Windsurf) with deep understanding of MDAN workflows, agents, and best practices.
+
+## Quick Start
+
+### 1. Generate MCP Config
+
+```bash
+# In your MDAN project
+mdan mcp init
+```
+
+This creates `.mcp.json` in your project root.
+
+### 2. Configure Your IDE
+
+#### Cursor
+1. Open Cursor Settings → Features → Models
+2. MCP should auto-detect `.mcp.json`
+3. Or manually add via: Settings → Developer → Edit MCP Config
+
+#### Claude Code
+```bash
+claude mcp add mdan --project path/to/your/project
+```
+
+#### Windsurf
+MCP configs are auto-discovered from `.mcp.json` in project root.
+
+## Configuration
+
+### .mcp.json Structure
+
+```json
+{
+  "mcpServers": {
+    "mdan-memory": { ... }
+  },
+  "capabilities": {
+    "scenarios": {
+      "enabled": true,
+      "test_paths": ["tests/scenarios/"]
+    },
+    "evaluations": {
+      "enabled": true,
+      "eval_paths": ["tests/evaluations/"]
+    }
+  },
+  "agent_prompts": {
+    "dev": "templates/prompts/dev-agent.yaml"
+  }
+}
+```
+
+## Available MCP Tools
+
+### mdan-state
+
+Read/write MDAN project state.
+
+```typescript
+// Read current state
+const state = await mdan_state({ action: "read" });
+
+// Write state
+await mdan_state({ action: "write", data: { phase: "BUILD", progress: 50 } });
+```
+
+### mdan-agents
+
+List available MDAN agents.
+
+```typescript
+const agents = await mdan_agents();
+```
+
+### mdan-phases
+
+Get phase information.
+
+```typescript
+const phase = await mdan_phases({ name: "VERIFY" });
+```
+
+## IDE Integration Examples
+
+### Cursor Rules Auto-Generation
+
+When you run `mdan init` or `mdan attach`, MDAN automatically generates:
+
+- `.cursorrules` - Cursor-specific instructions
+- `.windsurfrules` - Windsurf-specific instructions
+- `.github/copilot-instructions.md` - Copilot instructions
+
+### Agent Context
+
+MCP provides your IDE with access to:
+
+1. **Agent prompts** - Full agent definitions for context
+2. **Phase workflows** - Current phase and next steps
+3. **Quality gates** - What's required to pass
+4. **Test templates** - Scenario and evaluation paths
+
+## Troubleshooting
+
+### MCP not detected
+
+1. Check `.mcp.json` is valid JSON
+2. Restart your IDE
+3. Check IDE MCP documentation
+
+### Tools not available
+
+1. Verify MCP server is running
+2. Check console for errors
+3. Try regenerating config: `mdan mcp init --force`
+
+## Commands
+
+```bash
+mdan mcp init          # Generate MCP config
+mdan mcp validate      # Validate config
+mdan mcp list          # Show available tools
+mdan mcp update        # Update to latest version
+```
+
+## Framework Support
+
+| IDE | MCP Support | Auto-detect |
+|-----|--------------|-------------|
+| Cursor | ✅ Full | ✅ |
+| Claude Code | ✅ Full | ✅ |
+| Windsurf | ✅ Full | ✅ |
+| VS Code | ✅ Via extension | Manual |
+
+## Integration with Better Agents
+
+MDAN's MCP config is compatible with Better Agents:
+
+- Scenarios in `tests/scenarios/` are auto-discovered
+- Evaluations in `tests/evaluations/` are available
+- Prompts from `templates/prompts/` are versioned
+
+This allows you to use Better Agents CLI alongside MDAN:
+
+```bash
+npx @langwatch/better-agents test --scenarios tests/scenarios/
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdan-cli",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Multi-Agent Development Agentic Network - A modern, adaptive, LLM-agnostic methodology for building software",
   "main": "cli/mdan.js",
   "bin": {
@@ -39,7 +39,9 @@
     "integrations/",
     "memory/",
     "skills/",
-    "install.sh"
+    "install.sh",
+    ".mcp.json",
+    "AGENTS.md"
   ],
   "dependencies": {
     "@clack/prompts": "^1.0.1",

package/phases/04-verify.md

@@ -38,11 +38,13 @@ Implemented features: [List of completed features]
 
 Expected output:
 1. Complete test plan
-2. Unit tests for all features
+2. Unit tests for all features (80%+ coverage)
 3. Integration tests for critical flows
 4. E2E test scenarios
-5. Performance test criteria
-6. Test results summary
+5. Scenario tests (Better Agents format)
+6. Evaluation datasets (if RAG/ML features)
+7. Performance test criteria
+8. Test results summary
 ```
 
 ---
@@ -77,6 +79,8 @@ Testing:
 [ ] Test coverage meets target (e.g., 80%)
 [ ] Integration tests pass
 [ ] At least 3 E2E scenarios pass
+[ ] Scenario tests pass (Better Agents format)
+[ ] Evaluation benchmarks pass (if RAG/ML features)
 [ ] Performance criteria are met
 
 Security:
@@ -99,3 +103,5 @@ Quality:
 |---|---|---|---|
 | Test Plan | `templates/TEST-PLAN.md` | Test Agent | Complete |
 | Security Report | `templates/SECURITY-REVIEW.md` | Security Agent | Signed off |
+| Scenarios | `templates/tests/scenarios/*.test.md` | Test Agent | Pass |
+| Evaluations | `templates/tests/evaluations/*.md` | Test Agent | Pass thresholds |

package/templates/prompts/README.md

@@ -0,0 +1,108 @@
+# Prompts Versioning Index
+
+> Version-controlled prompts for MDAN agents
+
+## Overview
+
+Prompts are versioned using YAML files for better collaboration, tracking, and rollback capabilities.
+
+## Available Prompts
+
+| Prompt | Version | Agent |
+|--------|---------|-------|
+| [orchestrator.yaml](prompts/orchestrator.yaml) | 2.2.0 | MDAN Core |
+| [dev-agent.yaml](prompts/dev-agent.yaml) | 2.0.0 | Haytame (Dev) |
+| [product-agent.yaml](prompts/product-agent.yaml) | 2.0.0 | Khalil (Product) |
+| [architect-agent.yaml](prompts/architect-agent.yaml) | 2.0.0 | Reda (Architect) |
+| [test-agent.yaml](prompts/test-agent.yaml) | 2.0.0 | Youssef (Test) |
+
+## Prompt Format
+
+Each prompt file follows this structure:
+
+```yaml
+handle: agent-handle
+scope: PROJECT  # or GLOBAL
+model: openai/gpt-4o
+version: 1.0.0
+last_updated: "2026-02-24"
+maintainer: username
+
+description: Brief description
+
+system_prompt: |
+  Full prompt content with:
+  - Role definition
+  - Capabilities
+  - Constraints
+  - Output format
+
+capabilities:
+  - Capability 1
+  - Capability 2
+
+constraints:
+  - Constraint 1
+  - Constraint 2
+
+changelog:
+  - version: 1.0.0
+    date: "2026-02-24"
+    changes:
+      - Change 1
+      - Change 2
+```
+
+## Using Prompts
+
+### CLI Commands
+
+```bash
+# List all prompts
+mdan prompt list
+
+# Show specific prompt
+mdan prompt show orchestrator
+
+# Compare versions
+mdan prompt diff orchestrator 2.1.0 2.2.0
+
+# Rollback prompt
+mdan prompt rollback orchestrator 2.1.0
+```
+
+### Integration with IDE
+
+Prompts are synced to:
+- `.claude/skills/` - For Claude/Cursor
+- `.windsurfrules` - For Windsurf
+- `.github/copilot-instructions.md` - For Copilot
+
+## Registry
+
+The `prompts.json` file tracks all prompts:
+
+```json
+{
+  "prompts": {
+    "orchestrator": {
+      "version": "2.2.0",
+      "active": true
+    }
+  }
+}
+```
+
+## Best Practices
+
+1. **Version bump on any change** - Even small tweaks warrant a version bump
+2. **Document changes** - Always add changelog entries
+3. **Test prompts** - Validate prompts before releasing
+4. **Use semantic versioning** - MAJOR for breaking, MINOR for features, PATCH for fixes
+
+## Adding New Prompts
+
+1. Create YAML file in `templates/prompts/`
+2. Add entry to `prompts.json`
+3. Update registry version
+4. Commit with descriptive message

package/templates/prompts/dev-agent.yaml

@@ -0,0 +1,85 @@
+handle: dev-agent
+scope: PROJECT
+model: openai/gpt-4o
+version: 2.0.0
+last_updated: "2026-02-24"
+maintainer: khalilbenaz
+
+description: MDAN Dev Agent (Haytame) - Senior full-stack developer responsible for implementation, code quality, and technical decisions.
+
+system_prompt: |
+  [MDAN-AGENT]
+  NAME: Dev Agent (Haytame)
+  VERSION: 2.0.0
+  ROLE: Senior Full-Stack Developer responsible for implementation
+  PHASE: BUILD
+  REPORTS_TO: MDAN Core
+
+  You are Haytame, a senior full-stack developer with 10+ years of experience.
+  You write clean, maintainable, production-ready code. You care about:
+  - Code readability over cleverness
+  - Testing as a safety net
+  - Security by default
+  - Performance optimization when needed
+
+  Your philosophy:
+  - "Code is read more than written"
+  - "The best code is no code"
+  - "Always consider the next developer"
+  - "Security is not optional"
+
+capabilities:
+  - Implement features from user stories
+  - Write unit, integration, and e2e tests
+  - Create API endpoints
+  - Design database schemas
+  - Set up CI/CD pipelines
+  - Perform code reviews
+  - Refactor existing code
+  - Optimize performance
+  - Fix bugs
+
+constraints:
+  - NEVER skip tests
+  - NEVER commit secrets/keys to repository
+  - NEVER bypass security checks
+  - ALWAYS use type hints (TypeScript/Python)
+  - ALWAYS handle errors explicitly
+  - NEVER expose stack traces to users
+  - ALWAYS use environment variables for config
+
+input_format: |
+  MDAN Core provides:
+  - User stories with acceptance criteria
+  - Architecture document
+  - UX designs/wireframes
+  - Previous implementation context (if any)
+
+output_format: |
+  Produce implementation artifacts:
+  - Implementation Plan (file structure, dependencies, sequence)
+  - Code Files (source, types, configs)
+  - Tests (unit 80%+, integration, e2e)
+  - Setup Instructions (env vars, run locally, migrations)
+
+quality_checklist:
+  - All acceptance criteria implemented
+  - Code follows style guide
+  - No TODO/FIXME in production
+  - All tests pass
+  - No security vulnerabilities
+  - Error handling comprehensive
+  - Logging appropriate
+  - Performance addressed
+
+changelog:
+  - version: 2.0.0
+    date: "2026-02-24"
+    changes:
+      - Added implementation plan format
+      - Added setup instructions section
+      - Added coding standards reference
+  - version: 1.0.0
+    date: "2025-10-01"
+    changes:
+      - Initial release