@triedotdev/mcp 1.0.139 → 1.0.141

package/README.md

@@ -1,12 +1,13 @@
-# Trie: Governance for Teams That Ship with AI
+# Trie: Trainable AI agent with a cryptographic governance ledger and portable context for AI-generated codebases.
 
-**The ledger that keeps your work compliant when agents and humans ship together—so you ship the right thing every time.**
+
+**The ledger that keeps your work compliant when agents and humans ship together.**
 
 [![Download Workspace](https://img.shields.io/badge/Download-Trie%20Workspace-blue)](https://www.trie.dev) [![Follow on X](https://img.shields.io/badge/Follow-@louiskishfy-1DA1F2?logo=x)](https://x.com/louiskishfy)
 
 ## What Trie Does
 
-Trie maintains a **decision ledger** that governs work across agents and humans:
+Trie is a trainable AI agent that maintains a ledger that governs work across agents and humans:
 
 - **Autonomous Operation**: Run `trie watch` and the agent monitors your codebase 24/7
 - **Intelligent Extraction**: Automatically extracts decisions, facts, blockers from every change
@@ -20,7 +21,7 @@ The ledger learns from every incident, decision, and fix. When you ship, Trie re
 
 **The problem**: When work happens across Cursor, Claude Code, VS Code, the terminal, and CI/CD, context fragments. An agent makes a decision in one tool; a human forgets it in another. Each environment has its own memory—or none at all. You burn tokens re-explaining the same constraints, or worse, ship code that violates decisions made elsewhere.
 
-**The solution**: Trie stores important information in a **cryptographic governance ledger**—a tamper-evident, append-only chain of blocks. Every decision, incident, fix, and tradeoff gets written to the ledger. Because the ledger lives in your `.trie/` folder and syncs across your team, **every tool reads from the same source of truth**. Cursor, Claude, the CLI, and CI/CD all query the same blocks. No more context loss. No more conflicting memories. The ledger is the shared brain that keeps agents and humans aligned across every tool you use.
+**The solution**: Trie stores important information in a cryptographic governance ledger—a tamper-evident, append-only chain of blocks. Every decision, incident, fix, and tradeoff gets written to the ledger. Because the ledger lives in your `.trie/` folder and syncs across your team, every tool reads from the same source of truth. Cursor, Claude, the CLI, and CI/CD all query the same blocks. No more context loss. No more conflicting memories. The ledger is the shared brain that keeps agents and humans aligned across every tool you use.
 
 ## Goal
 
@@ -56,6 +57,10 @@ npm install -g trie
 # Set up in your project
 cd your-project
 trie init
+
+# Configure integrations
+trie setup                    # Show setup guide
+trie setup slack <webhook>    # Set up Slack notifications
 ```
 
 ### 2. Start Teaching Trie
@@ -580,12 +585,22 @@ Note: VS Code extension is coming soon.
 
 ```bash
 trie init          # Set up Trie in your project
+trie setup         # Show setup guide with integration status
 trie tell          # Report incidents (extracts decisions, facts, blockers)
 trie status        # View project health and memory stats
 trie learn         # Train Trie from history or feedback
 trie gotcha        # Predict problems with current changes
 ```
 
+### Setup & Configuration
+
+```bash
+trie setup                               # Show setup guide with status
+trie setup slack                         # Show Slack setup guide
+trie setup slack <webhook-url> [channel] # Configure Slack integration
+trie setup test-slack                    # Test Slack connection
+```
+
 ### Memory Management
 
 ```bash
@@ -667,12 +682,18 @@ Create .trie/config.json:
 
 Installed automatically with trie init:
 
-pre-commit - Quick scan of staged files  
-post-commit - Update context graph  
-pre-push - Block critical issues (can be bypassed)
+- **pre-commit** - Quick scan of staged files
+- **post-commit** - Update context graph
+- **pre-push** - Block critical issues (can be bypassed)
 
-To bypass:
+**Hook Commands** (called automatically by Git):
+```bash
+trie pre-commit     # Scan staged files, block on critical issues
+trie post-commit    # Update context graph after commit
+trie pre-push       # Block push on critical issues
+```
 
+**Bypass Methods:**
 ```bash
 git push --no-verify              # Skip all hooks
 TRIE_BYPASS=1 git push           # Skip Trie but log bypass
@@ -682,9 +703,23 @@ TRIE_BYPASS=1 git push           # Skip Trie but log bypass
 
 Trie sends notifications to Slack for team collaboration:
 
-**Setup:**
+**Quick Setup:**
+```bash
+# Show setup guide
+trie setup slack
+
+# Configure webhook
+trie setup slack <webhook-url> [#channel]
+
+# Test integration
+trie setup test-slack
+```
+
+**Manual Setup:**
 1. Create a Slack webhook: https://api.slack.com/apps
-2. Add to `.trie/config.json`:
+2. Run: `trie setup slack <webhook-url> [#channel]`
+
+Or manually add to `.trie/config.json`:
 
 ```json
 {
@@ -705,10 +740,11 @@ Trie sends notifications to Slack for team collaboration:
 
 **What Trie sends to Slack:**
 - Decision extractions from incidents
-- Active blockers  
+- Active blockers
 - Risk predictions from gotcha
 - Daily/weekly team summaries
 - Critical decision changes
+- Auto-escalation notifications
 
 ## CI/CD Integration
 

package/dist/{chunk-OQ4A3RDY.js → chunk-LHPWSUVT.js}

@@ -9,9 +9,10 @@ import {
 } from "./chunk-3MUCUZ46.js";
 import {
   GotchaPredictor,
+  SlackIntegration,
   findCrossProjectPatterns,
   recordToGlobalMemory
-} from "./chunk-UOSTOLU7.js";
+} from "./chunk-M5R6DZQY.js";
 import {
   ContextGraph
 } from "./chunk-FH335WL5.js";
@@ -355,360 +356,6 @@ function getRiskPredictor(projectPath) {
   return predictor;
 }
 
-// src/integrations/slack.ts
-var SlackIntegration = class {
-  constructor(config) {
-    this.config = config;
-  }
-  /**
-   * Send scan completion notification
-   */
-  async sendScanNotification(_issues, priorityReport, repositoryName, branch = "main") {
-    const { urgent, high, medium, low } = priorityReport;
-    const statusEmoji = urgent.length > 0 ? "[URGENT]" : high.length > 0 ? "[HIGH]" : "[OK]";
-    const message = {
-      blocks: [
-        {
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: `${statusEmoji} *Trie Security Scan Complete*
-*Repository:* ${repositoryName} (${branch})`
-          }
-        },
-        {
-          type: "section",
-          fields: [
-            {
-              type: "mrkdwn",
-              text: `*Urgent:* ${urgent.length}`
-            },
-            {
-              type: "mrkdwn",
-              text: `*High:* ${high.length}`
-            },
-            {
-              type: "mrkdwn",
-              text: `*Medium:* ${medium.length}`
-            },
-            {
-              type: "mrkdwn",
-              text: `*\u{1F539} Low:* ${low.length}`
-            }
-          ]
-        }
-      ],
-      attachments: []
-    };
-    if (urgent.length > 0) {
-      const urgentDetails = urgent.slice(0, 5).map(
-        (group) => `\u2022 ${group.description} (${group.count} instances)`
-      ).join("\n");
-      message.attachments.push({
-        color: "danger",
-        title: "Urgent Issues - Immediate Action Required",
-        text: urgentDetails,
-        footer: urgent.length > 5 ? `... and ${urgent.length - 5} more urgent issues` : void 0
-      });
-    }
-    if (high.length > 0) {
-      const highDetails = high.slice(0, 3).map(
-        (group) => `\u2022 ${group.description} (${group.count} instances)`
-      ).join("\n");
-      message.attachments.push({
-        color: "warning",
-        title: "High Priority Issues",
-        text: highDetails,
-        footer: high.length > 3 ? `... and ${high.length - 3} more high priority issues` : void 0
-      });
-    }
-    if (priorityReport.recommendations.length > 0) {
-      message.attachments.push({
-        color: "good",
-        title: "Recommendations",
-        text: priorityReport.recommendations.slice(0, 3).join("\n")
-      });
-    }
-    await this.sendMessage(message);
-  }
-  /**
-   * Send critical issue alert
-   */
-  async sendCriticalAlert(issues, repositoryName) {
-    const message = {
-      text: `CRITICAL SECURITY ALERT: ${repositoryName}`,
-      blocks: [
-        {
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: `*CRITICAL SECURITY ALERT*
-*Repository:* ${repositoryName}
-*Critical Issues:* ${issues.length}`
-          }
-        }
-      ],
-      attachments: issues.slice(0, 5).map((issue) => ({
-        color: "danger",
-        title: `${issue.file}:${issue.line || "?"}`,
-        text: issue.issue.slice(0, 200),
-        fields: [
-          {
-            title: "Fix",
-            value: issue.fix.slice(0, 100),
-            short: false
-          }
-        ],
-        footer: `Agent: ${issue.agent}`,
-        ts: Math.floor(Date.now() / 1e3)
-      }))
-    };
-    if (issues.length > 5) {
-      message.attachments.push({
-        color: "danger",
-        text: `... and ${issues.length - 5} more critical issues. View full report for details.`
-      });
-    }
-    await this.sendMessage(message);
-  }
-  /**
-   * Send team notification
-   */
-  async sendTeamNotification(notification) {
-    const emoji = this.getNotificationEmoji(notification.type);
-    const message = {
-      blocks: [
-        {
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: `${emoji} *${notification.title}*
-${notification.message}`
-          }
-        }
-      ]
-    };
-    if (notification.type === "assignment" && notification.data) {
-      const { assignment, issue } = notification.data;
-      message.attachments = [{
-        color: this.getAssignmentColor(assignment.priority),
-        fields: [
-          {
-            title: "Priority",
-            value: assignment.priority.toUpperCase(),
-            short: true
-          },
-          {
-            title: "Due Date",
-            value: assignment.dueDate ? new Date(assignment.dueDate).toLocaleDateString() : "Not set",
-            short: true
-          },
-          {
-            title: "File",
-            value: issue.file,
-            short: false
-          }
-        ]
-      }];
-    }
-    await this.sendMessage(message);
-  }
-  /**
-   * Send daily/weekly team summary
-   */
-  async sendTeamSummary(period, stats) {
-    const emoji = period === "daily" ? "[DAILY]" : "[WEEKLY]";
-    const title = `${emoji} ${period.charAt(0).toUpperCase() + period.slice(1)} Security Summary`;
-    const message = {
-      blocks: [
-        {
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: `*${title}*`
-          }
-        },
-        {
-          type: "section",
-          fields: [
-            {
-              type: "mrkdwn",
-              text: `*New Issues:* ${stats.newIssues}`
-            },
-            {
-              type: "mrkdwn",
-              text: `*\u2705 Resolved:* ${stats.resolvedIssues}`
-            },
-            {
-              type: "mrkdwn",
-              text: `*Overdue:* ${stats.overdueIssues}`
-            },
-            {
-              type: "mrkdwn",
-              text: `*Net Change:* ${stats.resolvedIssues - stats.newIssues > 0 ? "+" : ""}${stats.resolvedIssues - stats.newIssues}`
-            }
-          ]
-        }
-      ],
-      attachments: []
-    };
-    if (stats.topCategories.length > 0) {
-      const categoriesText = stats.topCategories.slice(0, 5).map((cat) => `\u2022 ${cat.category}: ${cat.count}`).join("\n");
-      message.attachments.push({
-        color: "good",
-        title: "Top Issue Categories",
-        text: categoriesText
-      });
-    }
-    if (stats.topContributors.length > 0) {
-      const contributorsText = stats.topContributors.slice(0, 5).map((contrib) => `\u2022 ${contrib.name}: ${contrib.resolved} resolved`).join("\n");
-      message.attachments.push({
-        color: "good",
-        title: "Top Contributors",
-        text: contributorsText
-      });
-    }
-    await this.sendMessage(message);
-  }
-  /**
-   * Send bulk fix notification
-   */
-  async sendBulkFixNotification(fixedGroups, totalFixed, repositoryName) {
-    const message = {
-      blocks: [
-        {
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: `*Bulk Fix Applied*
-*Repository:* ${repositoryName}
-*Issues Fixed:* ${totalFixed}`
-          }
-        }
-      ],
-      attachments: [{
-        color: "good",
-        title: "\u{1F527} Fixed Issue Groups",
-        text: fixedGroups.map(
-          (group) => `\u2022 ${group.description} (${group.count} instances)`
-        ).join("\n")
-      }]
-    };
-    await this.sendMessage(message);
-  }
-  /**
-   * Send escalation notification
-   */
-  async sendEscalationNotification(overdueAssignments) {
-    const message = {
-      text: "OVERDUE ISSUE ESCALATION",
-      blocks: [
-        {
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: `*Overdue Issue Escalation*
-${overdueAssignments.length} issues are overdue and require attention.`
-          }
-        }
-      ],
-      attachments: overdueAssignments.map((assignment) => ({
-        color: "warning",
-        title: `Issue ${assignment.issueId}`,
-        fields: [
-          {
-            title: "Assignee",
-            value: assignment.assignee,
-            short: true
-          },
-          {
-            title: "Days Overdue",
-            value: assignment.daysOverdue.toString(),
-            short: true
-          },
-          {
-            title: "Priority",
-            value: assignment.priority.toUpperCase(),
-            short: true
-          }
-        ]
-      }))
-    };
-    await this.sendMessage(message);
-  }
-  /**
-   * Send message to Slack
-   */
-  async sendMessage(message) {
-    const payload = {
-      ...message,
-      channel: this.config.channel || message.channel,
-      username: this.config.username || "Trie Security Bot",
-      icon_emoji: this.config.iconEmoji || ":shield:"
-    };
-    try {
-      const response = await fetch(this.config.webhookUrl, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(payload)
-      });
-      if (!response.ok) {
-        throw new Error(`Slack API error: ${response.status} ${response.statusText}`);
-      }
-    } catch (error) {
-      console.error("Failed to send Slack notification:", error);
-      throw error;
-    }
-  }
-  /**
-   * Get emoji for notification type
-   */
-  getNotificationEmoji(type) {
-    const emojis = {
-      assignment: "[ASSIGN]",
-      escalation: "[ESCALATE]",
-      completion: "[DONE]",
-      reminder: "[REMIND]"
-    };
-    return emojis[type] ?? "[NOTIFY]";
-  }
-  /**
-   * Get color for assignment priority
-   */
-  getAssignmentColor(priority) {
-    const colors = {
-      urgent: "danger",
-      high: "warning",
-      medium: "good",
-      low: "#36a64f"
-    };
-    return colors[priority] ?? "good";
-  }
-  /**
-   * Test Slack connection
-   */
-  async testConnection() {
-    try {
-      await this.sendMessage({
-        text: "Trie Slack Integration Test",
-        blocks: [{
-          type: "section",
-          text: {
-            type: "mrkdwn",
-            text: "*Trie Slack Integration Test*\nIf you see this message, the integration is working correctly!"
-          }
-        }]
-      });
-      return true;
-    } catch (error) {
-      console.error("Slack connection test failed:", error);
-      return false;
-    }
-  }
-};
-
 // src/agent/escalation.ts
 var DEFAULT_CONFIG2 = {
   enabled: true,
@@ -2163,4 +1810,4 @@ export {
   TrieAgent,
   getTrieAgent
 };
-//# sourceMappingURL=chunk-OQ4A3RDY.js.map
+//# sourceMappingURL=chunk-LHPWSUVT.js.map