@triedotdev/mcp 1.0.14 → 1.0.16

package/README.md

@@ -2,15 +2,15 @@
 
 **Customizable Parallel Agents for AI Code Review**
 
-17 specialized agents scan your code for security, privacy, compliance, and bugs—all running in parallel. Create custom agents from any document.
+20 specialized agents scan your code for security, privacy, compliance, and bugs - all running in parallel. Create custom agents from any document.
 
 ## Features
 
-- **17 Built-in Agents** - Security, Privacy, SOC 2, Legal, Architecture, Design Engineer, Agent Smith, and more
-- **🔍 Super Reviewer** - Interactive PR reviews: walks through changes file-by-file with AI guidance
-- **🕴️ Agent Smith** - Relentless pattern hunter: finds EVERY violation, tracks dismissed issues, spawns sub-agents
+- **20 Built-in Agents** - Security, Privacy, SOC 2, Legal, Architecture, Performance, E2E, Visual QA, Data Flow, Agent Smith, and more
+- **Super Reviewer** - Interactive PR reviews: walks through changes file-by-file with AI guidance
+- **Agent Smith** - Relentless pattern hunter: finds EVERY violation, tracks dismissed issues, spawns sub-agents
 - **Parallel Execution** - All agents run simultaneously for fast scans
-- **🔥 YOLO Mode** - Autonomous auto-fixing as you code
+- **YOLO Mode** - Autonomous auto-fixing as you code
 - **Custom Agents** - Create agents from PDFs, docs, or style guides
 - **No API Key Required** - Works with any MCP-compatible AI tool (Cursor, Claude Code, VS Code)
 - **Smart Triaging** - Only activates relevant agents based on code context
@@ -62,9 +62,9 @@ Run trie_security on this file
 Run trie_soc2 to check compliance
 ```
 
-## Super Reviewer 🔍
+## Super Reviewer
 
-⭐ **Manually invoked** — Use `trie_pr_review` directly. Not included in `trie_scan`.
+**Manually invoked** - Use `trie_pr_review` directly. Not included in `trie_scan`.
 
 AI accelerates coding 10-100x, but code reviews remain 1-1.5x. You're either waiting on reviewers or drowning in self-review of your own AI-generated output. Super Reviewer fixes this by making **you the driver** while AI handles the heavy lifting.
 
@@ -74,7 +74,7 @@ Use trie_pr_review with pr:"12345"
 ```
 
 **What happens:**
-- AI orders files for comprehension (schemas → core logic → implementation → tests)
+- AI orders files for comprehension (schemas -> core logic -> implementation -> tests)
 - Walks you through each chunk, explaining what changed and why
 - Connects the dots across files, correlates with design docs
 - Hunts for real problems: state bugs, race conditions, missing error handling
@@ -86,9 +86,9 @@ Use trie_pr_review with pr:"12345"
 - Git repository with changes to review
 - For PR reviews: repo must be pushed to GitHub
 
-## Agent Smith 🕴️
+## Agent Smith
 
-⭐ **Manually invoked** — Use `trie_agent_smith` directly. Not included in `trie_scan`.
+**Manually invoked** - Use `trie_agent_smith` directly. Not included in `trie_scan`.
 
 *"I'm going to be honest with you... I hate this code."*
 
@@ -100,7 +100,7 @@ Use trie_smith
 ```
 
 **What makes him different:**
-- **Multiplier Effect**: Finds one issue → searches for EVERY similar instance across the entire codebase
+- **Multiplier Effect**: Finds one issue -> searches for EVERY similar instance across the entire codebase
 - **Persistent Memory**: Remembers dismissed issues. If they multiply, he brings them back: *"Did you really think you could escape?"*
 - **Sub-Agent Swarm**: Deploys specialized hunters in parallel (console-hunter, any-hunter, todo-hunter, var-hunter, empty-catch-hunter, magic-number-hunter)
 - **Inevitability Score**: Calculates how likely each pattern is to cause production issues (0-100)
@@ -120,7 +120,7 @@ Agent Smith stores issue history in `.trie/smith-memory.json`. The memory is aut
 
 **Example output:**
 ```
-🕴️ AGENT SMITH ANALYSIS
+AGENT SMITH ANALYSIS
 
 "Mr. Anderson... I've been expecting you."
 
@@ -136,7 +136,46 @@ VIOLATIONS DETECTED: 47 instances across 6 categories
 "You hear that? That is the sound of inevitability."
 ```
 
-## YOLO Mode 🔥
+## Visual QA Browser
+
+**Screenshot-based visual testing** - Captures your app at 3 viewports and uses Claude Vision to analyze for visual bugs.
+
+```
+Use trie_visual_qa_browser
+Use trie_visual_qa_browser url:"http://localhost:3000"
+```
+
+**How it works:**
+1. Auto-detects running dev server (checks ports 3000, 5173, 8080, etc.)
+2. Launches headless Playwright browser
+3. Captures screenshots at mobile (375px), tablet (768px), and desktop (1440px)
+4. Returns images for Claude Vision to analyze
+
+**What Claude Vision checks:**
+- Broken layouts, overlapping elements
+- Responsive design issues
+- Color contrast and accessibility
+- Missing images, loading states
+- General visual polish
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `url` | Specific URL to screenshot |
+| `port` | Specific port to check |
+| `waitForSelector` | CSS selector to wait for before capture |
+| `waitMs` | Additional wait time after page load |
+
+**First run:** If Playwright browsers aren't installed, run: `npx playwright install chromium`
+
+**Vision model required:** This tool returns screenshots for the LLM to analyze. Works best with:
+- Cursor (Claude has vision)
+- Claude Code (native vision support)
+- OpenCode with Claude/GPT-4V
+
+No API key needed - Trie runs locally and the AI tool's built-in model does the analysis.
+
+## YOLO Mode
 
 **Autonomous auto-fixing** - Trie watches your code and automatically fixes high-confidence issues as you code.
 
@@ -190,7 +229,7 @@ docker-compose up
 
 ## Built-in Agents
 
-### 🔒 Security & Compliance
+### Security & Compliance
 
 | Agent | Command | What It Catches |
 |-------|---------|-----------------|
@@ -199,7 +238,7 @@ docker-compose up
 | **SOC 2** | `trie_soc2` | Access control gaps, missing audit logs, encryption issues, change management |
 | **Legal** | `trie_legal` | HIPAA/COPPA compliance, consent patterns, data retention, cookie tracking |
 
-### 🏗️ Code Quality
+### Code Quality
 
 | Agent | Command | What It Catches |
 |-------|---------|-----------------|
@@ -207,31 +246,36 @@ docker-compose up
 | **Bugs** | `trie_bugs` | Null dereference, race conditions, off-by-one, async bugs, resource leaks |
 | **Types** | `trie_types` | Missing annotations, unsafe casts, implicit `any`, null handling gaps |
 | **Clean** | `trie_clean` | AI code smells: huge files, console.logs, hardcoded URLs, useEffect abuse |
+| **Data Flow** | `trie_data_flow` | Placeholder data, schema mismatches, hardcoded IDs, type coercion bugs |
+| **Performance** | `trie_performance` | Memory leaks, N+1 queries, unnecessary re-renders, bundle size issues |
 
-### 🎨 Design & UX
+### Design & UX
 
 | Agent | Command | What It Catches |
 |-------|---------|-----------------|
 | **Design Engineer** | `trie_design` | Design systems, motion design, creative CSS, Awwwards-level polish |
 | **Accessibility** | `trie_accessibility` | Missing ARIA, color contrast, keyboard nav, screen reader issues (WCAG 2.1) |
 | **UX** | `trie_ux` | Missing loading states, poor error handling, broken flows, edge cases |
+| **Visual QA** | `trie_visual_qa` | Layout shifts (CLS), z-index wars, responsive gaps, animation issues |
+| **Visual QA Browser** | `trie_visual_qa_browser` | Screenshots at 3 viewports for Claude Vision analysis |
 
-### 🛠️ DevOps & Testing
+### DevOps & Testing
 
 | Agent | Command | What It Catches |
 |-------|---------|-----------------|
 | **DevOps** | `trie_devops` | Missing env vars, config issues, no health checks, logging gaps |
 | **Test** | `trie_test` | Missing test coverage, untested edge cases, weak assertions |
+| **E2E** | `trie_e2e` | Flaky tests, hardcoded waits, brittle selectors, missing coverage |
 
-### 🔍 Review & Explanation
+### Review & Explanation
 
 | Agent | Command | What It Does |
 |-------|---------|--------------|
-| **Super Reviewer** ⭐ | `trie_pr_review` | Interactive PR review: walks through changes, explains code, finds issues |
-| **Agent Smith** ⭐ | `trie_agent_smith` | Relentless pattern hunter: finds EVERY instance, tracks dismissed issues, spawns sub-agents |
+| **Super Reviewer** | `trie_pr_review` | Interactive PR review: walks through changes, explains code, finds issues |
+| **Agent Smith** | `trie_agent_smith` | Relentless pattern hunter: finds EVERY instance, tracks dismissed issues, spawns sub-agents |
 | **Comprehension** | `trie_explain` | Plain-language explanations of code, issues, or risks |
 
-> ⭐ **Manually invoked agents** — Super Reviewer and Agent Smith are special-purpose agents designed for explicit invocation. They don't run during `trie_scan`; use their dedicated commands directly.
+**Note:** Super Reviewer and Agent Smith are manually invoked agents. They don't run during `trie_scan`; use their dedicated commands directly.
 
 ## Custom Agents
 
@@ -248,13 +292,14 @@ Custom agents automatically activate during scans based on their rules.
 | Tool | Description |
 |------|-------------|
 | `trie_scan` | Intelligent scan with automatic agent selection |
-| `trie_pr_review` | Interactive PR review — walks through changes file-by-file |
-| `trie_agent_smith` | Relentless pattern hunter — finds EVERY violation, tracks history |
+| `trie_pr_review` | Interactive PR review - walks through changes file-by-file |
+| `trie_agent_smith` | Relentless pattern hunter - finds EVERY violation, tracks history |
 | `trie_fix` | Apply high-confidence fixes |
 | `trie_explain` | Plain-language explanations |
 | `trie_watch` | Continuous scanning mode |
 | `trie_create_agent` | Create custom agent from document |
 | `trie_list_agents` | List all available agents |
+| `trie_visual_qa_browser` | Screenshot app at 3 viewports for Claude Vision analysis |
 
 Plus individual agent tools: `trie_security`, `trie_privacy`, `trie_soc2`, `trie_bugs`, etc.
 
@@ -271,12 +316,12 @@ Smart Triaging:
 
 Results: 72/100
 
-🔴 2 Critical Issues
-   • Hardcoded API key (CC6.1) - src/api.ts:15
-   • SQL injection risk - src/db.ts:42
+[CRITICAL] 2 Critical Issues
+   - Hardcoded API key (CC6.1) - src/api.ts:15
+   - SQL injection risk - src/db.ts:42
 
-🟡 3 Serious Issues (auto-fixable)
-🔵 2 Moderate Issues
+[SERIOUS] 3 Serious Issues (auto-fixable)
+[MODERATE] 2 Moderate Issues
 ```
 
 ## Configuration