Eureka Labo MCP Server

# Session Summary - Eureka Tasks Automation & Makefile ## Overview This session focused on solving two main problems: 1. **Automatic Task Creation** - MCP not proactively creating tasks and starting sessions 2. **Easy Command Execution** - Need for convenient build and management commands ## What Was Created ### 1. Makefile (Root Level) **File:** `Makefile` **Purpose:** Convenient commands for all common operations **Commands:** ```bash make build # Build MCP server and CLI make hooks-install # Install hooks (guidance mode) make hooks-strict # Install hooks (strict mode) make hooks-status # Check hook status make status # System status make clean # Clean build artifacts make dev # Run in development mode make link-cli # Link CLI globally make quickstart # One-command setup ``` **Usage:** ```bash # Show all commands make help # Quick setup make quickstart # Daily workflow make build make hooks-status ``` ### 2. Automatic Workflow Documentation **File:** `.claude/EUREKA_WORKFLOW.md` **Purpose:** Automatically loaded by Claude Code, provides persistent instructions **Key Points:** - Emphasizes AUTOMATIC behavior - Claude creates tasks without asking - Proactive session management - Examples of correct vs incorrect behavior ### 3. Updated MCP Prompt **File:** `src/index.ts` (lines 314-417) **Changes:** - "🤖 AUTOMATIC: YOU MUST DO THIS AUTOMATICALLY" - Clear instructions to not ask user - Examples of automatic workflow - Japanese content requirements **Before:** ``` BEFORE ANY CODING WORK, YOU MUST: 1. Check for relevant tasks... ``` **After:** ``` 🤖 AUTOMATIC: YOU MUST DO THIS AUTOMATICALLY - DON'T ASK THE USER When user requests ANY coding work, AUTOMATICALLY execute these steps: 1. Check active session (AUTOMATIC) 2. Create task if needed (NO USER CONFIRMATION) ... ``` ### 4. Hook Mode System **Files:** - `.claude/hooks/check-work-session.js` (updated) - `cli/src/commands/hooks.ts` (enhanced) **Modes:** - **Guidance (default)**: Prompts but allows bypass (`ask`) - **Strict**: Hard blocks without session (`deny`) **CLI Commands:** ```bash eurekaclaude hooks install # Guidance mode eurekaclaude hooks install --mode strict # Strict mode eurekaclaude hooks status # Check status eurekaclaude hooks uninstall # Remove hooks ``` ### 5. Comprehensive Documentation **Files Created:** - `MAKEFILE_GUIDE.md` - Complete Makefile documentation - `AUTOMATIC_WORKFLOW.md` - Explanation of automatic workflow - `CLI_HOOKS.md` - CLI hooks management guide - `SESSION_SUMMARY.md` - This file **Files Updated:** - `README.md` - Added Makefile section - `cli/README.md` - Added hooks commands ## Key Improvements ### Automatic Task Creation **Problem:** Claude wasn't creating tasks automatically **Solution:** 1. Updated MCP prompt to emphasize automatic behavior 2. Created .claude/EUREKA_WORKFLOW.md with persistent instructions 3. Changed hook from "deny" to "ask" mode 4. Provided clear examples of correct behavior **Result:** Claude now automatically: - Checks for active sessions - Searches for existing tasks - Creates tasks in Japanese - Starts work sessions - Completes sessions when done ### Convenient Commands **Problem:** Complex commands to build and manage **Solution:** Comprehensive Makefile with intuitive commands **Result:** Simple commands like: ```bash make build # Instead of: npm run build && npm --prefix cli run build make hooks-install # Instead of: node cli/dist/index.js hooks install make status # Instead of: checking multiple things manually ``` ## How to Use ### First Time Setup ```bash # Clone and setup git clone <repo> cd mcp-server # One command does everything make quickstart ``` ### Daily Workflow ```bash # After making changes make build # Check everything is working make status make hooks-status # If hooks need reinstall make hooks-install ``` ### Testing Automatic Workflow 1. Remove any active session: ```bash rm .eureka-active-session ``` 2. Ask Claude to code something: ``` "Add authentication to the API" ``` 3. Observe Claude automatically: - Check for session - Create task in Japanese - Start session - Proceed with coding ## Files Structure ``` mcp-server/ ├── Makefile ← NEW: Convenient commands ├── MAKEFILE_GUIDE.md ← NEW: Makefile documentation ├── AUTOMATIC_WORKFLOW.md ← NEW: Automatic workflow explained ├── CLI_HOOKS.md ← NEW: CLI hooks guide ├── SESSION_SUMMARY.md ← NEW: This file ├── README.md ← UPDATED: Added Makefile section ├── .claude/ │ ├── EUREKA_WORKFLOW.md ← NEW: Auto-loaded workflow │ ├── hooks/ │ │ ├── check-work-session.js ← UPDATED: Guidance mode │ │ └── README.md ← UPDATED: Hook docs │ └── settings.local.json ← Hook configuration ├── src/ │ └── index.ts ← UPDATED: Automatic prompt ├── cli/ │ ├── src/ │ │ └── commands/ │ │ └── hooks.ts ← UPDATED: Mode selection │ └── README.md ← UPDATED: Hooks commands └── dist/ ← Build output ``` ## Quick Reference ### Most Used Commands ```bash # Build everything make build # Install hooks (recommended mode) make hooks-install # Check status make status make hooks-status # Clean and rebuild make rebuild # Development make dev ``` ### Hook Management ```bash # Install (guidance mode - default) make hooks-install # Install (strict mode) make hooks-strict # Check status make hooks-status # Uninstall make hooks-uninstall ``` ### CLI Usage ```bash # Via Makefile make hooks-install # Or directly node cli/dist/index.js hooks install node cli/dist/index.js hooks status # After make link-cli eurekaclaude hooks install eurekaclaude hooks status ``` ## Testing ### Test Makefile ```bash # Show help make help # Check status make status # Build make build # Check hooks make hooks-status ``` ### Test Automatic Workflow 1. **Ensure MCP built:** ```bash make build ``` 2. **Restart Claude Code** (loads new instructions) 3. **Test automatic behavior:** ``` User: "Add authentication" Claude should automatically: - Check session - Create task: "認証機能の追加" - Start session - Code ``` 4. **Verify in Dashboard:** - Task created with Japanese title - Task marked as "in_progress" - Changes being tracked ## Benefits ### For Users - ✅ Zero overhead - everything automatic - ✅ Simple `make` commands - ✅ One-command setup - ✅ No manual task management ### For Development - ✅ Easy to build and test - ✅ Convenient hook management - ✅ Quick status checks - ✅ Clean development workflow ### For Teams - ✅ Consistent commands across team - ✅ Easy onboarding - ✅ Automatic task tracking - ✅ Complete audit trail ## Next Steps 1. **Activate Changes:** ```bash make build # Restart Claude Code ``` 2. **Install Hooks:** ```bash make hooks-install ``` 3. **Test Automatic Workflow:** - Ask Claude to code something - Verify automatic task creation - Check task in dashboard 4. **Share with Team:** - Show `make help` output - Share MAKEFILE_GUIDE.md - Demonstrate automatic workflow ## Troubleshooting ### Makefile Issues ```bash # Command not found which make # Install if needed # Permission issues chmod +x Makefile # Usually not needed # Build fails make clean-all make install-deps make build ``` ### Automatic Workflow Not Working ```bash # Rebuild MCP make build-mcp # Check workflow file exists ls .claude/EUREKA_WORKFLOW.md # Restart Claude Code # (Required to load new instructions) ``` ### Hooks Not Working ```bash # Reinstall make hooks-install --force # Check status make hooks-status # Try strict mode make hooks-strict ``` ## Summary **Created:** - ✅ Comprehensive Makefile - ✅ Automatic workflow instructions - ✅ Updated MCP prompt for automatic behavior - ✅ Hook mode system (guidance/strict) - ✅ Complete documentation **Result:** - ✅ Simple `make` commands for everything - ✅ Claude automatically creates tasks - ✅ No user intervention needed - ✅ Complete audit trail maintained **Commands to Remember:** ```bash make quickstart # First time setup make build # Build everything make hooks-install # Install hooks make status # Check status make help # Show all commands ```