midas-mcp 1.0.0

package/README.md

@@ -0,0 +1,167 @@
+# midas-mcp
+
+**Everything you vibecode turns to gold.**
+
+An MCP server that brings the Elite Vibecoding methodology into Cursor as an interactive coach. Guides users through the two-phase process, provides expert prompts, and audits projects against the 12 ingredients of production readiness.
+
+## Installation
+
+```bash
+npm install -g midas-mcp
+```
+
+## Cursor Configuration
+
+Add to your Cursor settings (`~/.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "midas": {
+      "command": "npx",
+      "args": ["midas-mcp"]
+    }
+  }
+}
+```
+
+## What Midas Does
+
+### Phase Guidance
+
+Midas tracks your current phase and guides you through:
+
+**Phase 1: Eagle Sight (Pre-Build)**
+```
+💡 Idea → 🔍 Research → 🧠 Brainlift → 📋 PRD → 🗺️ Gameplan
+```
+
+**Phase 2: Build (7-Step Process)**
+```
+1. User Rules → 2. Index Codebase → 3. Read Files → 4. Research
+5. Write Code + Tests → 6. Run Tests → 7. Log → Fix → Repeat
+```
+
+### Tools
+
+| Tool | Description |
+|------|-------------|
+| `midas_start_project` | Initialize Eagle Sight, create docs folder structure |
+| `midas_get_phase` | Get current phase and recommended next steps |
+| `midas_set_phase` | Move to a specific phase |
+| `midas_audit` | Score project against 12 ingredients |
+| `midas_check_docs` | Verify brainlift/prd/gameplan completeness |
+| `midas_oneshot` | Apply the Oneshot Paradigm for error recovery |
+| `midas_tornado` | Trigger Research + Logs + Tests cycle |
+| `midas_horizon` | Expand horizontal context for better output |
+
+### Prompts
+
+Pre-built expert prompts you can invoke:
+
+| Prompt | Purpose |
+|--------|---------|
+| `master_prompt` | Session initialization with full context loading |
+| `execution_prompt` | Start building with TDD approach |
+| `safe_refactor` | Move code safely between files |
+| `bug_investigation` | Root cause analysis before fixing |
+| `security_review` | Check for vulnerabilities |
+| `feature_planning` | Plan before implementing |
+
+### Resources
+
+Documentation available on demand:
+
+- `midas://methodology` - Core philosophy
+- `midas://eagle-sight` - Pre-build process
+- `midas://process` - 7-step development loop
+- `midas://oneshot` - Fix backward paradigm
+- `midas://tornado` - Research + Logs + Tests
+- `midas://horizon` - Horizontal vs vertical context
+- `midas://ingredients/{1-12}` - Production guidelines
+- `midas://cheatsheet` - Quick reference
+
+## The Three Principles
+
+When you hit problems, Midas applies:
+
+### 1. Oneshot Paradigm
+When things break, go back with error + context instead of patching forward.
+```
+Original Prompt + Error Log + "Avoid this" = Working Solution
+```
+
+### 2. Tornado Building
+Three forces spinning together solve any problem:
+```
+Research + Logs + Tests = Solution
+```
+
+### 3. Horizon Thinking
+AI thinks vertical (implementation). You provide horizontal (context).
+```
+Wrong output? Widen your horizontal context.
+```
+
+## Usage Examples
+
+### Starting a New Project
+
+```
+User: "I want to build a task management app"
+
+Midas: Initiates Eagle Sight phase, creates docs folder,
+       guides through Brainlift → PRD → Gameplan
+```
+
+### When Stuck on a Bug
+
+```
+User: "This keeps failing with the same error"
+
+Midas: Detects repeated failures, suggests Oneshot approach,
+       helps construct enhanced prompt with error context
+```
+
+### Checking Production Readiness
+
+```
+User: "Is my project ready to ship?"
+
+Midas: Runs 12 ingredients audit, scores each category,
+       identifies gaps and provides remediation guidance
+```
+
+## The 12 Ingredients
+
+Midas audits against:
+
+| # | Ingredient | Category |
+|---|------------|----------|
+| 1 | Frontend | Core |
+| 2 | Backend | Core |
+| 3 | Database | Core |
+| 4 | Authentication | Core |
+| 5 | API Integrations | Power |
+| 6 | State Management | Power |
+| 7 | Design/UX | Power |
+| 8 | Testing | Protection |
+| 9 | Security | Protection |
+| 10 | Error Handling | Protection |
+| 11 | Version Control | Mastery |
+| 12 | Deployment | Mastery |
+
+**Completion levels:** 1-4 (functional), 1-8 (polished), 1-12 (production-ready)
+
+## Development
+
+```bash
+cd midas-mcp
+npm install
+npm run build
+npm run dev
+```
+
+## License
+
+MIT

package/dist/docs/CHEATSHEET.md

@@ -0,0 +1,122 @@
+# Cheat Sheet
+
+Quick reference for the vibecoding methodology.
+
+---
+
+## The Two Phases
+
+**Phase 1: Eagle Sight (Pre-Build)**
+```
+Idea → Research → Brainlift → PRD → Gameplan
+```
+
+**Phase 2: Build (7-Step Process)**
+```
+1. User Rules → 2. Index Codebase → 3. Read Files → 4. Research
+5. Write Code + Tests → 6. Run Tests → 7. Log → Fix → Repeat
+```
+
+---
+
+## The Three Principles
+
+**Oneshot Paradigm**
+```
+When broken → STOP → Original prompt + error log → Works
+3 strikes = restart with full context
+```
+
+**Tornado Building**
+```
+Research + Logs + Tests = Solution
+Each feeds the others until solved
+```
+
+**Horizon Thinking**
+```
+AI = Vertical (implementation)
+You = Horizontal (context, patterns, constraints)
+Wrong output? Widen your horizontal.
+```
+
+---
+
+## Key Prompts
+
+**Session Start:**
+```
+Read user rules. Ask clarifying questions. Make todos. Don't start yet.
+```
+
+**Execution:**
+```
+Continue todos. Write AND run tests. Commit when done.
+```
+
+**When Stuck:**
+```
+Research [topic]. Add logs at [points]. Write tests for [behavior].
+```
+
+---
+
+## The Prompt Formula
+
+```
+PROMPT = CONTEXT + TASK + CONSTRAINTS + OUTPUT
+```
+
+---
+
+## Quick Fixes
+
+| Problem | Solution |
+|---------|----------|
+| AI hallucinating | "Ask clarifying questions first" |
+| Generic output | Add more horizontal context |
+| Broken code | Oneshot: original + error + avoid |
+| Stuck on bug | Spin the Tornado |
+| Code doesn't fit | Check patterns to follow |
+
+---
+
+## AI Strengths
+
+Let AI handle: boilerplate, types, tests, refactoring, docs, regex, SQL, CSS, API integrations
+
+You control: architecture, security, business logic, performance, UX, code review, deployment
+
+---
+
+## Antipatterns
+
+| Avoid | Instead |
+|-------|---------|
+| YOLO prompting | One feature at a time |
+| Blind trust | Read and test everything |
+| Context neglect | Complete context sandwich |
+| Fix forward forever | Oneshot after 3 strikes |
+| Security afterthought | Security from day 1 |
+| No tests | Tests alongside code |
+
+---
+
+## Recovery Phrases
+
+| Problem | Say |
+|---------|-----|
+| Wrong approach | "Let's try a different approach. What if we..." |
+| Too complex | "Simplify this. Give me the minimal version." |
+| Missing context | "Here's more context: [paste]" |
+| Going in circles | "Let's step back. What's the core problem?" |
+
+---
+
+## Speed Tips
+
+- Use `@file` references instead of pasting
+- Batch similar operations
+- Template reuse: "Follow the pattern in [file]"
+- Stop mid-generation if you have enough (Esc)
+- One clear ask per message

package/dist/docs/INGREDIENTS.md

@@ -0,0 +1,173 @@
+# The 12 Ingredients
+
+Production readiness checklist for any application.
+
+---
+
+## Core Ingredients (1-4)
+
+Every app needs these. Without them, nothing works.
+
+### 1. Frontend
+What users see and touch. UI, buttons, screens, interactions.
+
+**Checklist:**
+- [ ] Responsive design (mobile, tablet, desktop)
+- [ ] Accessibility basics (labels, contrast, keyboard nav)
+- [ ] Loading states for async operations
+- [ ] Error states with recovery options
+- [ ] Consistent component patterns
+
+### 2. Backend
+Server logic, APIs, business rules.
+
+**Checklist:**
+- [ ] RESTful or GraphQL API structure
+- [ ] Input validation on all endpoints
+- [ ] Proper HTTP status codes
+- [ ] Rate limiting on public endpoints
+- [ ] Graceful error responses
+
+### 3. Database
+Where data lives and persists.
+
+**Checklist:**
+- [ ] Schema designed for access patterns
+- [ ] Indexes on frequently queried fields
+- [ ] Foreign key constraints where appropriate
+- [ ] Backup strategy defined
+- [ ] Migration system in place
+
+### 4. Authentication
+Who users are, login/signup, permissions.
+
+**Checklist:**
+- [ ] Secure password hashing (bcrypt/argon2)
+- [ ] Session/token management
+- [ ] Password reset flow
+- [ ] Account lockout after failed attempts
+- [ ] Secure cookie settings (httpOnly, secure, sameSite)
+
+---
+
+## Power Ingredients (5-7)
+
+These transform a basic app into something real.
+
+### 5. API Integrations
+Connecting to external services.
+
+**Checklist:**
+- [ ] API keys stored securely (env vars)
+- [ ] Retry logic with exponential backoff
+- [ ] Timeout handling
+- [ ] Circuit breakers for failing services
+- [ ] Rate limit awareness
+
+### 6. State Management
+How data flows through your app.
+
+**Checklist:**
+- [ ] Clear data flow pattern
+- [ ] Loading/error/success states
+- [ ] Optimistic updates where appropriate
+- [ ] Cache invalidation strategy
+- [ ] No prop drilling hell
+
+### 7. Design/UX
+Making it beautiful and usable.
+
+**Checklist:**
+- [ ] Consistent visual language
+- [ ] Clear user feedback for actions
+- [ ] Intuitive navigation
+- [ ] Empty states designed
+- [ ] Mobile-first or responsive
+
+---
+
+## Protection Ingredients (8-10)
+
+Without protection, your app is vulnerable.
+
+### 8. Testing
+Proving it works before shipping.
+
+**Checklist:**
+- [ ] Unit tests for business logic
+- [ ] Integration tests for API endpoints
+- [ ] E2E tests for critical flows
+- [ ] Tests run in CI before deploy
+- [ ] Coverage on new code
+
+### 9. Security
+Protection from attacks, data safety.
+
+**Checklist:**
+- [ ] SQL injection prevention (parameterized queries)
+- [ ] XSS prevention (output encoding)
+- [ ] CSRF protection
+- [ ] Secrets not in code or logs
+- [ ] Dependencies audited for vulnerabilities
+
+### 10. Error Handling
+Graceful failures, logging, recovery.
+
+**Checklist:**
+- [ ] Try/catch on async operations
+- [ ] User-friendly error messages
+- [ ] Errors logged with context
+- [ ] No sensitive data in error responses
+- [ ] Recovery actions available
+
+---
+
+## Mastery Ingredients (11-12)
+
+These separate hobby projects from professional software.
+
+### 11. Version Control
+Git, tracking changes, collaboration.
+
+**Checklist:**
+- [ ] Meaningful commit messages
+- [ ] Feature branches for development
+- [ ] No secrets committed (ever)
+- [ ] .gitignore comprehensive
+- [ ] PR reviews before merge
+
+### 12. Deployment
+CI/CD, hosting, getting it to users.
+
+**Checklist:**
+- [ ] Automated deployment pipeline
+- [ ] Staging environment for testing
+- [ ] Rollback capability
+- [ ] Environment variables managed
+- [ ] Health checks configured
+
+---
+
+## Audit Scoring
+
+When Midas audits a project:
+
+| Score | Meaning |
+|-------|---------|
+| 1-4 complete | Functional - it works |
+| 5-7 complete | Integrated - it connects |
+| 8-10 complete | Protected - it's safe |
+| 11-12 complete | Professional - it ships |
+
+**All 12 = Production Ready**
+
+---
+
+## Quick Audit Questions
+
+For each ingredient, ask:
+
+1. **Does it exist?** (binary)
+2. **Does it work correctly?** (functional)
+3. **Is it complete?** (coverage)
+4. **Is it maintainable?** (quality)