@triedotdev/mcp 1.0.0

package/QUICK_START.md

@@ -0,0 +1,230 @@
+# Quick Start Guide
+
+Get Trie Agent up and running in minutes to start scanning and fixing AI-generated code.
+
+## Prerequisites
+
+- **Node.js 18+** installed ([download](https://nodejs.org/))
+- **AI coding tool** (Cursor, Claude Code, or VS Code with MCP support)
+
+## Installation
+
+### Step 1: Install Trie Agent
+
+```bash
+npm install -g @triedotdev/mcp
+```
+
+### Step 2: Configure Your AI Tool
+
+No API key required! Trie uses your AI tool's built-in Claude to do the analysis.
+
+## Configuration
+
+### For Claude Code
+
+Use the `claude` CLI to add the MCP server:
+
+```bash
+claude mcp add trie-agent -- node /usr/local/lib/node_modules/@triedotdev/mcp/dist/index.js
+```
+
+Or add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "trie-agent": {
+      "command": "node",
+      "args": ["/usr/local/lib/node_modules/@triedotdev/mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### For Cursor
+
+1. Open Cursor Settings → MCP Servers
+2. Add this configuration:
+
+```json
+{
+  "mcpServers": {
+    "trie-agent": {
+      "command": "node",
+      "args": ["/usr/local/lib/node_modules/@triedotdev/mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+**Note:** If installed globally, the path might be different. Find it with:
+```bash
+npm list -g @triedotdev/mcp
+```
+
+### For VS Code
+
+Add to your VS Code settings (`.vscode/settings.json` or user settings):
+
+```json
+{
+  "mcp.servers": {
+    "trie-agent": {
+      "command": "node",
+      "args": ["/usr/local/lib/node_modules/@triedotdev/mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## Usage
+
+### Scan Your Code
+
+Once configured, use Trie Agent in your AI coding tool:
+
+**In Cursor/Claude Code:**
+```
+Scan this code with Trie Agent
+```
+
+**Or use the MCP tool directly:**
+```
+Use trie_scan to analyze the current file
+```
+
+### Example Workflow
+
+1. **Generate code** with your AI assistant
+2. **Scan for issues:**
+   ```
+   Scan this with Trie Agent
+   ```
+3. **Review results** - Trie will show:
+   - Risk level and activated agents
+   - Critical issues requiring review
+   - Auto-fixable issues
+   - Plain-language explanations
+4. **Apply fixes:**
+   ```
+   Auto-fix the high-confidence issues
+   ```
+5. **Generate tests:**
+   ```
+   Generate tests for this code
+   ```
+
+## Available Tools
+
+- **`trie_scan`** - Scan code with intelligent agent selection
+- **`trie_fix`** - Apply high-confidence fixes automatically
+- **`trie_explain`** - Get plain-language explanations of code/issues
+- **`trie_test`** - Generate tests or check coverage
+- **`trie_commit`** - Create smart commit messages
+- **`trie_register_agent`** - Add custom agents
+
+## Example Output
+
+```
+🔍 TRIE AGENT SCAN
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Smart Triaging:
+✓ Risk Level: high
+✓ Reason: High-risk authentication feature
+✓ Agents activated: security, privacy, legal, architecture, typecheck
+✓ Execution time: 8.2s
+
+Results:
+Score: 72/100 (needs work)
+
+🔴 2 Critical Issues (require your review)
+🟡 3 Serious Issues (can auto-fix)
+🔵 2 Moderate Issues (can auto-fix)
+
+Critical Issues Preview:
+1. Password stored without hashing (auth/signup.ts:23)
+   Agent: Security | Confidence: 100%
+2. PII stored in plain text (models/user.ts:15)
+   Agent: Privacy | Confidence: 95%
+```
+
+## Configuration (Optional)
+
+Create `.trie/config.json` in your project root to customize behavior:
+
+```json
+{
+  "version": "1.0",
+  "triaging": {
+    "enabled": true,
+    "riskThresholds": {
+      "critical": 70,
+      "high": 40,
+      "medium": 20
+    },
+    "autoFixConfidence": 0.95
+  },
+  "agents": {
+    "builtin": {
+      "security": { "enabled": true },
+      "privacy": { "enabled": true },
+      "legal": { "enabled": true },
+      "design-engineer": { "enabled": true }
+    }
+  }
+}
+```
+
+## Troubleshooting
+
+### Agent not found
+
+**Problem:** Can't find the Trie Agent executable
+
+**Solution:** Find the installation path:
+```bash
+npm list -g @triedotdev/mcp
+# Or
+which trie-agent
+```
+
+Update your MCP config with the correct path.
+
+### No agents activating
+
+**Problem:** Scan runs but no agents are triggered
+
+**Solution:**
+- Check that your code matches patterns (auth, payments, UI, etc.)
+- Review the triaging logic in `.trie/config.json`
+- Try scanning a file with known issues (auth, payments, etc.)
+
+### MCP connection fails
+
+**Problem:** Can't connect to Trie Agent server
+
+**Solution:**
+1. Verify Node.js is installed: `node --version` (should be 18+)
+2. Check the path in MCP config is correct
+3. Restart your AI coding tool
+4. Check console/logs for error messages
+
+## Next Steps
+
+- **Try different code patterns** - Test with auth, payments, UI components
+- **Explore agents** - See which agents activate for different code types
+- **Use auto-fix** - Let Trie fix high-confidence issues automatically
+- **Generate tests** - Create comprehensive test suites
+- **Add custom agents** - Extend Trie with your own review logic
+
+## Support
+
+- 📚 **Documentation**: [trie.dev/docs](https://trie.dev/docs)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/Trie-OS/mcp-agent/issues)
+- 💬 **Community**: [Discord](https://discord.gg/trie-ai)
+
+---
+
+**Ready to ship safer code?** Start scanning your AI-generated code now! 🚀

package/README.md

@@ -0,0 +1,235 @@
+# Quick Start Guide
+
+Get Trie Agent up and running in minutes to start scanning and fixing AI-generated code.
+
+## Prerequisites
+
+- **Node.js 18+** installed ([download](https://nodejs.org/))
+- **AI coding tool** (Cursor, Claude Code, or VS Code with MCP support)
+
+## Installation
+
+### Step 1: Install Trie Agent
+
+```bash
+npm install -g @triedotdev/mcp
+```
+
+### Step 2: Configure Your AI Tool
+
+No API key required! Trie uses your AI tool's built-in Claude to do the analysis.
+
+## Configuration
+
+### For Claude Code
+
+Use the `claude` CLI to add the MCP server:
+
+```bash
+claude mcp add trie-agent -- npx @triedotdev/mcp
+```
+
+Or add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "trie-agent": {
+      "command": "npx",
+      "args": ["@triedotdev/mcp"]
+    }
+  }
+}
+```
+
+### For Cursor
+
+1. Open Cursor Settings → MCP Servers
+2. Add this configuration:
+
+```json
+{
+  "mcpServers": {
+    "trie-agent": {
+      "command": "npx",
+      "args": ["@triedotdev/mcp"]
+    }
+  }
+}
+```
+
+### For VS Code
+
+Add to your VS Code settings (`.vscode/settings.json` or user settings):
+
+```json
+{
+  "mcp.servers": {
+    "trie-agent": {
+      "command": "npx",
+      "args": ["@triedotdev/mcp"]
+    }
+  }
+}
+```
+
+## Usage
+
+### Scan Your Code
+
+Once configured, use Trie Agent in your AI coding tool:
+
+**In Cursor/Claude Code:**
+```
+Scan this code with Trie Agent
+```
+
+**Or use the MCP tool directly:**
+```
+Use trie_scan to analyze the current file
+```
+
+### Example Workflow
+
+1. **Generate code** with your AI assistant
+2. **Scan for issues:**
+   ```
+   Scan this with Trie Agent
+   ```
+3. **Review results** - Trie will show:
+   - Risk level and activated agents
+   - Critical issues requiring review
+   - Auto-fixable issues
+   - Plain-language explanations
+4. **Apply fixes:**
+   ```
+   Auto-fix the high-confidence issues
+   ```
+5. **Generate tests:**
+   ```
+   Generate tests for this code
+   ```
+
+## Available Tools
+
+- **`trie_scan`** - Scan code with intelligent agent selection
+- **`trie_fix`** - Apply high-confidence fixes automatically
+- **`trie_explain`** - Get plain-language explanations of code/issues
+- **`trie_test`** - Generate tests or check coverage
+- **`trie_commit`** - Create smart commit messages
+- **`trie_register_agent`** - Add custom agents
+
+## MCP Resources
+
+Trie also exposes read-only MCP resources for querying agent info, cache stats, and scan reports:
+
+| Resource | Description |
+|----------|-------------|
+| `trie://agents` | List all available agents |
+| `trie://config` | Current configuration |
+| `trie://cache/stats` | Cache performance metrics |
+| `trie://signatures` | Vulnerability signature counts |
+| `trie://reports/{file}` | Access scan reports |
+
+See [MCP_USAGE.md](MCP_USAGE.md) for detailed resource documentation.
+
+## Example Output
+
+```
+🔍 TRIE AGENT SCAN
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Smart Triaging:
+✓ Risk Level: high
+✓ Reason: High-risk authentication feature
+✓ Agents activated: security, privacy, legal, architecture, typecheck
+✓ Execution time: 8.2s
+
+Results:
+Score: 72/100 (needs work)
+
+🔴 2 Critical Issues (require your review)
+🟡 3 Serious Issues (can auto-fix)
+🔵 2 Moderate Issues (can auto-fix)
+
+Critical Issues Preview:
+1. Password stored without hashing (auth/signup.ts:23)
+   Agent: Security | Confidence: 100%
+2. PII stored in plain text (models/user.ts:15)
+   Agent: Privacy | Confidence: 95%
+```
+
+## Configuration (Optional)
+
+Create `.trie/config.json` in your project root to customize behavior:
+
+```json
+{
+  "version": "1.0",
+  "triaging": {
+    "enabled": true,
+    "riskThresholds": {
+      "critical": 70,
+      "high": 40,
+      "medium": 20
+    },
+    "autoFixConfidence": 0.95
+  },
+  "agents": {
+    "builtin": {
+      "security": { "enabled": true },
+      "privacy": { "enabled": true },
+      "legal": { "enabled": true },
+      "design-engineer": { "enabled": true }
+    }
+  }
+}
+```
+
+## Troubleshooting
+
+### Agent not found
+
+**Problem:** Can't find the Trie Agent executable
+
+**Solution:** Make sure you have Node.js 18+ installed and try:
+```bash
+npx @triedotdev/mcp --help
+```
+
+### No agents activating
+
+**Problem:** Scan runs but no agents are triggered
+
+**Solution:**
+- Check that your code matches patterns (auth, payments, UI, etc.)
+- Review the triaging logic in `.trie/config.json`
+- Try scanning a file with known issues (auth, payments, etc.)
+
+### MCP connection fails
+
+**Problem:** Can't connect to Trie Agent server
+
+**Solution:**
+1. Verify Node.js is installed: `node --version` (should be 18+)
+2. Check the path in MCP config is correct
+3. Restart your AI coding tool
+4. Check console/logs for error messages
+
+## Next Steps
+
+- **Try different code patterns** - Test with auth, payments, UI components
+- **Explore agents** - See which agents activate for different code types
+- **Use auto-fix** - Let Trie fix high-confidence issues automatically
+- **Generate tests** - Create comprehensive test suites
+- **Add custom agents** - Extend Trie with your own review logic
+
+## Support
+
+- 📚 **Documentation**: [trie.dev/docs](https://trie.dev/docs)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/Trie-OS/mcp-agent/issues)
+- 💬 **Community**: [Discord](https://discord.gg/trie-ai)
+
+---
+
+**Ready to ship safer code?** Start scanning your AI-generated code now! 🚀