@triedotdev/mcp 1.0.80 → 1.0.82

package/README.md

@@ -10,6 +10,7 @@
 - **Sets and tracks goals**: "Reduce login bugs by 50%" then actually measures progress and celebrates wins
 - **Tests your theories**: "Mondays have more bugs" — Trie validates with real data and builds confidence over time
 - **Learns from your incidents**: Train it on your specific patterns, not generic rules that don't fit your prompting
+- **Predicts "Gotchas" proactively**: Ingests Linear tickets and correlates them with past failures to warn you before you even push code
 
 ## Goal
 
@@ -49,15 +50,15 @@ trie status
 When bugs happen, tell Trie about them:
 
 ```bash
-# Report an incident
-trie tell "Users can't log in after the password reset"
+# Report a specific incident
+trie tell "Users can't log in after password reset"
 
-# Before pushing code
-trie check
+# Train Trie from your history (reverts/bugfixes)
+trie learn
 
-# Give feedback on warnings
-trie ok    # This warning was helpful
-trie bad   # This was a false alarm
+# Give feedback on patterns (staged files)
+trie ok    # Pattern is good
+trie bad   # Pattern is bad
 ```
 
 ## Why Trie Exists
@@ -172,6 +173,42 @@ trie watch
 
 Interactive panels for goals, memory, scout activity, and more.
 
+**Running in Background:**
+To keep `trie watch` running in the background, use `screen` or `tmux`:
+
+```bash
+# Using screen
+screen -S trie-watch
+trie watch
+# Press Ctrl+A then D to detach
+# Reattach with: screen -r trie-watch
+
+# Using tmux
+tmux new -s trie-watch
+trie watch
+# Press Ctrl+B then D to detach
+# Reattach with: tmux attach -t trie-watch
+```
+
+This allows you to keep the guardian running while using other terminals. The interactive dashboard will be available when you reattach.
+
+### JIT Defect Prediction ("Gotchas")
+Trie connects to your issue tracker and project history to predict problems *while you work*:
+
+```bash
+# 1. Connect Linear
+trie linear auth <your-api-key>
+trie linear sync
+
+# 2. Learn from history automatically
+trie learn
+
+# 3. Predict for current changes
+trie gotcha
+```
+
+Trie will warn you if your current task correlates with historical regressions or high-risk signatures.
+
 ### Integration with AI Coding Tools
 
 Trie provides MCP (Model Context Protocol) tools for seamless integration with Claude, Cursor, and other AI assistants:
@@ -237,17 +274,41 @@ trie init
 ```
 
 ### API Key Configuration
-For enhanced AI-powered analysis, set up your Anthropic API key:
+Trie works best with these keys:
+
+1. **ANTHROPIC_API_KEY**: Enables AI-powered analysis and explanations.
+2. **LINEAR_API_KEY**: Enables JIT defect prediction by syncing your active tickets.
+
+#### 1. Set via Environment (Recommended for MCP)
+Add these to your `.env` file or shell config:
 
 ```bash
-# Add to your .env file (recommended)
-echo "ANTHROPIC_API_KEY=your-api-key-here" >> .env
+export ANTHROPIC_API_KEY=sk-ant-...
+export LINEAR_API_KEY=lin_api_...
+```
 
-# Or set as environment variable
-export ANTHROPIC_API_KEY=your-api-key-here
+#### 2. Set via CLI (Persistent per project)
+```bash
+trie linear auth <your-key>
 ```
 
-**Note:** Trie works offline without an API key using built-in templates, but the AI-enhanced analysis provides much richer insights and explanations.
+#### 3. Set in MCP Config (Cursor/Claude Code)
+Add to your MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "trie": {
+      "command": "npx",
+      "args": ["-y", "@triedotdev/mcp"],
+      "env": {
+        "ANTHROPIC_API_KEY": "your-key",
+        "LINEAR_API_KEY": "your-key"
+      }
+    }
+  }
+}
+```
 
 ### AI Tool Integration
 
@@ -260,7 +321,8 @@ Add to your MCP settings:
       "command": "trie",
       "args": ["mcp"],
       "env": {
-        "ANTHROPIC_API_KEY": "your-api-key-here"
+        "ANTHROPIC_API_KEY": "your-api-key-here",
+        "LINEAR_API_KEY": "your-key"
       }
     }
   }
@@ -279,8 +341,8 @@ Cursor has built-in MCP support. Add the above configuration to your Cursor MCP
 trie init          # Set up Trie in your project
 trie scan          # Analyze codebase with intelligent skill selection
 trie status        # View project health and memory stats
-trie check         # Quick risk check before pushing (< 500ms)
-trie tell "<msg>"  # Report an incident to build memory
+trie learn         # Train Trie from history or feedback
+trie gotcha        # Predict problems with current changes
 ```
 
 ### Memory Management
@@ -288,6 +350,7 @@ trie tell "<msg>"  # Report an incident to build memory
 trie memory search "auth"     # Search incident history
 trie memory stats             # View memory statistics
 trie memory purge smart       # Clean up old/resolved issues
+trie learn                    # Extract patterns from reverts/fixes
 ```
 
 ### Goals & Learning
@@ -295,18 +358,24 @@ trie memory purge smart       # Clean up old/resolved issues
 trie goal add "<goal>"           # Set improvement goal
 trie hypothesis add "<theory>"   # Test a hypothesis
 trie goal list                   # View progress
+trie linear sync                 # Sync Linear tickets for intent context
 ```
 
 ### Feedback & Training
 ```bash
-trie ok          # Last warning was helpful
-trie bad         # Last warning was wrong
+trie ok          # Pattern is good (alias: learn ok)
+trie bad         # Pattern is bad (alias: learn bad)
+trie learn       # Learn from your git history
 trie pause       # Disable warnings for 1 hour
 ```
 
 ### Watch Mode
 ```bash
 trie watch       # Start interactive monitoring dashboard
+
+# Run in background with screen/tmux:
+screen -S trie-watch && trie watch    # Detach: Ctrl+A, D
+tmux new -s trie-watch && trie watch  # Detach: Ctrl+B, D
 ```
 
 ## Configuration

package/dist/{agent-smith-XGYNJUCJ.js → agent-smith-MCKGNWPL.js}

@@ -1,8 +1,8 @@
 import {
   AgentSmithSkill,
   PATTERN_HUNTER_CONFIGS
-} from "./chunk-EWQF6INU.js";
-import "./chunk-Z7N7KDK3.js";
+} from "./chunk-TBRU735C.js";
+import "./chunk-DCJKNE2L.js";
 import "./chunk-CM7EHNQK.js";
 import "./chunk-MIL54SAF.js";
 import "./chunk-DGUM43GV.js";
@@ -11,4 +11,4 @@ export {
   AgentSmithSkill,
   PATTERN_HUNTER_CONFIGS
 };
-//# sourceMappingURL=agent-smith-XGYNJUCJ.js.map
+//# sourceMappingURL=agent-smith-MCKGNWPL.js.map

package/dist/{agent-smith-runner-QHYGVRNR.js → agent-smith-runner-GP5HLL7E.js}

@@ -1,11 +1,11 @@
 import {
   AgentSmithSkill
-} from "./chunk-EWQF6INU.js";
+} from "./chunk-TBRU735C.js";
 import {
   getAIStatusMessage,
   isAIAvailable,
   runAIAnalysis
-} from "./chunk-Z7N7KDK3.js";
+} from "./chunk-DCJKNE2L.js";
 import {
   getWorkingDirectory
 } from "./chunk-CM7EHNQK.js";
@@ -570,4 +570,4 @@ ${getAIStatusMessage()}`);
 export {
   runAgentSmith
 };
-//# sourceMappingURL=agent-smith-runner-QHYGVRNR.js.map
+//# sourceMappingURL=agent-smith-runner-GP5HLL7E.js.map

package/dist/{chunk-45NUFTNV.js → chunk-7OVM6KEY.js}

@@ -2,6 +2,10 @@ import {
   getGoalManager,
   getInsightStore
 } from "./chunk-U5P3O5G5.js";
+import {
+  ContextGraph,
+  GotchaPredictor
+} from "./chunk-B7CLAOEK.js";
 import {
   getGuardianState
 } from "./chunk-75J4HQTD.js";
@@ -12,7 +16,7 @@ import {
 import {
   isAIAvailable,
   runAIAnalysis
-} from "./chunk-Z7N7KDK3.js";
+} from "./chunk-DCJKNE2L.js";
 import {
   getHistoricalInsights,
   searchIssues,
@@ -1970,6 +1974,7 @@ var GuardianAgent = class {
   hypothesisEngine;
   escalationManager;
   metaLearner;
+  gotchaPredictor;
   constructor(projectPath) {
     this.projectPath = projectPath;
     this.projectName = basename2(projectPath);
@@ -1980,6 +1985,7 @@ var GuardianAgent = class {
     this.hypothesisEngine = getHypothesisEngine(projectPath);
     this.escalationManager = getEscalationManager(projectPath);
     this.metaLearner = getMetaLearner(projectPath);
+    this.gotchaPredictor = new GotchaPredictor(projectPath, new ContextGraph(projectPath));
   }
   /**
    * Initialize the Guardian - loads persistent state and historical data
@@ -2271,6 +2277,27 @@ var GuardianAgent = class {
             await this.markInsightCreated("risk-prediction");
           }
         }
+        const gotchas = await this.gotchaPredictor.predictGotchas(context.filesChanged);
+        for (const gotcha of gotchas) {
+          if (this.canCreateInsight(`gotcha-${gotcha.id}`)) {
+            const explanation = await this.gotchaPredictor.synthesizeGotchaExplanation(gotcha);
+            const insight = this.createInsight({
+              type: "warning",
+              message: `[Gotcha] ${gotcha.message}`,
+              context: explanation,
+              suggestedAction: gotcha.recommendation,
+              priority: gotcha.riskLevel === "critical" ? 9 : 7,
+              category: "quality",
+              details: {
+                affectedFiles: context.filesChanged.map((f) => basename2(f)),
+                examples: [gotcha.message, explanation]
+              }
+            });
+            newInsights.push(insight);
+            await this.addInsight(insight);
+            await this.markInsightCreated(`gotcha-${gotcha.id}`);
+          }
+        }
       } catch {
       }
     }
@@ -2563,4 +2590,4 @@ export {
   GuardianAgent,
   getGuardian
 };
-//# sourceMappingURL=chunk-45NUFTNV.js.map
+//# sourceMappingURL=chunk-7OVM6KEY.js.map