@gotza02/sequential-thinking 2026.2.39 → 2026.2.41

package/dist/tools/sports/utils/formatter.js

@@ -0,0 +1,206 @@
+/**
+ * SPORTS MODULE UTILS - Formatter
+ * Output formatting utilities for sports data
+ */
+import { MATCH_STATUS } from '../core/constants.js';
+/**
+ * Format a match as markdown table row
+ */
+export function formatMatchRow(match) {
+    const status = match.status === MATCH_STATUS.LIVE
+        ? `⚽ ${match.minute}'`
+        : match.status === MATCH_STATUS.FINISHED
+            ? 'FT'
+            : new Date(match.date).toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' });
+    const homeScore = match.score?.home ?? '-';
+    const awayScore = match.score?.away ?? '-';
+    return `| ${status.padEnd(8)} | ${match.homeTeam.name.padEnd(20)} | ${homeScore} - ${awayScore} | ${match.awayTeam.name.padEnd(20)} |`;
+}
+/**
+ * Format standings as markdown table
+ */
+export function formatStandingsTable(standings) {
+    const header = `| Pos | Team | P | W | D | L | GF | GA | GD | Pts |\n|-----|------|---|---|---|---|----|----|----|------|`;
+    const rows = standings.map(entry => {
+        const form = entry.form ? Array.isArray(entry.form) ? entry.form.join('') : entry.form : '';
+        return `| ${entry.position} | ${entry.team.name} | ${entry.played} | ${entry.won} | ${entry.drawn} | ${entry.lost} | ${entry.goalsFor} | ${entry.goalsAgainst} | ${entry.goalDifference} | ${entry.points || 0} |`;
+    });
+    return `${header}\n${rows.join('\n')}`;
+}
+/**
+ * Format player stats as markdown table
+ */
+export function formatPlayerStats(stats, playerName) {
+    return `## ${playerName} - Season Stats
+
+| Metric | Value |
+|--------|-------|
+| Matches | ${stats.matches} |
+| Goals | ${stats.goals} |
+| Assists | ${stats.assists} |
+| Goals + Assists | ${stats.goals + stats.assists} |
+| Minutes | ${stats.minutes} |
+| xG | ${stats.xG?.toFixed(2) ?? 'N/A'} |
+| xA | ${stats.xA?.toFixed(2) ?? 'N/A'} |
+| Yellow Cards | ${stats.yellowCards} |
+| Red Cards | ${stats.redCards} |
+`;
+}
+/**
+ * Format comparison result as markdown
+ */
+export function formatComparisonResult(result) {
+    let output = `# Team Comparison: ${result.teamA.name} vs ${result.teamB.name}\n\n`;
+    // Summary section
+    output += `## Summary\n\n${result.summary}\n\n`;
+    // Metrics table
+    output += `## Metrics\n\n`;
+    output += `| Metric | ${result.teamA.name} | ${result.teamB.name} | Advantage |\n`;
+    output += `|--------|------------------|------------------|------------|\n`;
+    for (const metric of result.metrics) {
+        const adv = metric.winner === 'A' ? result.teamA.name : metric.winner === 'B' ? result.teamB.name : 'Draw';
+        output += `| ${metric.name} | ${metric.teamAValue} | ${metric.teamBValue} | ${adv} |\n`;
+    }
+    // Winner declaration
+    if (result.winner) {
+        const winnerName = result.winner === 'A' ? result.teamA.name : result.teamB.name;
+        output += `\n## Verdict\n\n**Winner:** ${winnerName}\n`;
+    }
+    return output;
+}
+/**
+ * Format head to head record as markdown
+ */
+export function formatHeadToHead(h2h) {
+    const homePct = (h2h.homeWins / h2h.totalMatches * 100).toFixed(1);
+    const drawPct = (h2h.draws / h2h.totalMatches * 100).toFixed(1);
+    const awayPct = (h2h.awayWins / h2h.totalMatches * 100).toFixed(1);
+    return `## Head to Head: ${h2h.homeTeam.name} vs ${h2h.awayTeam.name}
+
+**Total Matches:** ${h2h.totalMatches}
+
+| ${h2h.homeTeam.name} | Draw | ${h2h.awayTeam.name} |
+|:----:|:----:|:----:|
+| ${h2h.homeWins} (${homePct}%) | ${h2h.draws} (${drawPct}%) | ${h2h.awayWins} (${awayPct}%) |
+
+**Goals:** ${h2h.homeGoals} - ${h2h.awayGoals}
+
+### Recent Matches
+
+${h2h.recentMatches.map(m => formatMatchRow(m)).join('\n')}
+`;
+}
+/**
+ * Format match status for display
+ */
+export function formatMatchStatus(status) {
+    switch (status) {
+        case MATCH_STATUS.LIVE:
+            return '🔴 LIVE';
+        case MATCH_STATUS.FINISHED:
+            return '✅ FT';
+        case MATCH_STATUS.SCHEDULED:
+            return '📅 Scheduled';
+        case MATCH_STATUS.POSTPONED:
+            return '⏸️ Postponed';
+        case MATCH_STATUS.CANCELLED:
+            return '❌ Cancelled';
+        default:
+            return status;
+    }
+}
+/**
+ * Format score with context
+ */
+export function formatScore(match) {
+    if (!match.score)
+        return 'v';
+    if (match.status === MATCH_STATUS.LIVE) {
+        return `${match.score.home} - ${match.score.away} (${match.minute}')`;
+    }
+    if (match.status === MATCH_STATUS.FINISHED) {
+        let result = `${match.score.home} - ${match.score.away}`;
+        if (match.score.halfTime) {
+            result += ` (HT: ${match.score.halfTime.home} - ${match.score.halfTime.away})`;
+        }
+        return result;
+    }
+    return 'v';
+}
+/**
+ * Format odds as decimal/fractional
+ */
+export function formatOdds(decimalOdds) {
+    return decimalOdds.toFixed(2);
+}
+/**
+ * Format probability as percentage
+ */
+export function formatProbability(probability) {
+    return `${(probability * 100).toFixed(1)}%`;
+}
+/**
+ * Format value bet recommendation
+ */
+export function formatValueBet(match, odds, probability, value, confidence) {
+    const valuePct = (value * 100).toFixed(1);
+    const fairOdds = (1 / probability).toFixed(2);
+    const edge = ((odds - parseFloat(fairOdds)) / parseFloat(fairOdds) * 100).toFixed(1);
+    return `## Value Bet Opportunity
+
+**Match:** ${match}
+**Bet:** @${formatOdds(odds)}
+**Fair Odds:** ${fairOdds}
+**Value:** +${valuePct}%
+**Edge:** +${edge}%
+**Confidence:** ${confidence}%
+
+${value > 0.10 ? '🔥 **HIGH VALUE**' : value > 0.05 ? '✅ **Value Bet**' : '⚠️ **Marginal Value**'}
+`;
+}
+/**
+ * Format a list of matches as markdown table
+ */
+export function formatMatchesTable(matches, title) {
+    if (matches.length === 0) {
+        return `## ${title}\n\nNo matches found.\n`;
+    }
+    const header = `| Time | Home | Score | Away |\n|------|------|-------:|------|`;
+    const rows = matches.map(m => {
+        const time = m.status === MATCH_STATUS.LIVE
+            ? `⚽ ${m.minute}'`
+            : m.status === MATCH_STATUS.FINISHED
+                ? 'FT'
+                : new Date(m.date).toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' });
+        const score = m.score ? `${m.score.home} - ${m.score.away}` : 'v';
+        return `| ${time} | ${m.homeTeam.name} | ${score} | ${m.awayTeam.name} |`;
+    });
+    return `## ${title}\n\n${header}\n${rows.join('\n')}\n`;
+}
+/**
+ * Truncate text to max length with ellipsis
+ */
+export function truncate(text, maxLength = 100) {
+    if (text.length <= maxLength)
+        return text;
+    return text.substring(0, maxLength - 3) + '...';
+}
+/**
+ * Format date relative to now
+ */
+export function formatRelativeDate(date) {
+    const now = new Date();
+    const diffMs = date.getTime() - now.getTime();
+    const diffMins = Math.floor(diffMs / 60000);
+    const diffHours = Math.floor(diffMs / 3600000);
+    const diffDays = Math.floor(diffMs / 86400000);
+    if (diffMins < 0)
+        return 'Started';
+    if (diffMins < 60)
+        return `In ${diffMins} min`;
+    if (diffHours < 24)
+        return `In ${diffHours} hr`;
+    if (diffDays < 7)
+        return `In ${diffDays} days`;
+    return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+}

package/dist/tools/sports.d.ts

@@ -1,2 +1,9 @@
+/**
+ * SPORTS MODULE - Main Registration
+ * Entry point for all sports tools
+ */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all sports tools with the MCP server
+ */
 export declare function registerSportsTools(server: McpServer): void;

package/dist/tools/sports.js

@@ -1,8 +1,34 @@
+/**
+ * SPORTS MODULE - Main Registration
+ * Entry point for all sports tools
+ */
+// Import tool registrations
+import { registerMatchTools } from "./sports/tools/match.js";
+import { registerTeamTools } from "./sports/tools/team.js";
+import { registerPlayerTools } from "./sports/tools/player.js";
+import { registerBettingTools } from "./sports/tools/betting.js";
+import { registerLiveTools } from "./sports/tools/live.js";
+// Legacy support - keep original analyze_football_match
 import { z } from "zod";
 import { fetchWithRetry } from "../utils.js";
 import { scrapeWebpage } from "./web.js";
+/**
+ * Register all sports tools with the MCP server
+ */
 export function registerSportsTools(server) {
-    // 19. analyze_football_match
+    // Register new modular tools
+    registerMatchTools(server);
+    registerTeamTools(server);
+    registerPlayerTools(server);
+    registerBettingTools(server);
+    registerLiveTools(server);
+    // Keep original analyze_football_match for backward compatibility
+    registerLegacyAnalyzeMatch(server);
+}
+/**
+ * Legacy analyze_football_match tool (kept for backward compatibility)
+ */
+function registerLegacyAnalyzeMatch(server) {
     server.tool("analyze_football_match", "Gather comprehensive data for a football (soccer) match to perform a detailed analysis. Fetches Head-to-Head, Recent Form, Team News, and Predictions from the web. It also performs a 'Deep Dive' on the best data source found.", {
         homeTeam: z.string().describe("Name of the home team"),
         awayTeam: z.string().describe("Name of the away team"),
@@ -36,15 +62,10 @@ export function registerSportsTools(server) {
             { type: 'Recent Form', query: `${homeTeam} ${awayTeam} recent form last 5 matches results${dateQuery}` },
             { type: 'Team News & Lineups', query: `${baseQuery} team news injuries suspensions predicted confirmed lineups${dateQuery}` },
             { type: 'Advanced Metrics', query: `${baseQuery} xG expected goals stats possession shots per game${dateQuery}` },
-            // Combine Manager/Press with "Sack Race/Pressure" context
             { type: 'Manager & Atmosphere', query: `${homeTeam} ${awayTeam} manager quotes fan sentiment sack race pressure${dateQuery}` },
-            // NEW: Market Intelligence
             { type: 'Market & Odds', query: `${baseQuery} odds movement dropping odds betting trends${dateQuery}` },
-            // NEW: Environmental Factors
             { type: 'Ref & Weather', query: `${baseQuery} referee stats cards per game weather forecast stadium${dateQuery}` },
-            // NEW: Fatigue & Schedule (Critical for late game performance)
             { type: 'Fatigue & Schedule', query: `${homeTeam} ${awayTeam} days rest fixture congestion travel distance${dateQuery}` },
-            // NEW: Set Piece Analysis (Where 30% of goals come from)
             { type: 'Set Pieces', query: `${homeTeam} ${awayTeam} set piece goals scored conceded corners stats aerial duels${dateQuery}` }
         ];
         if (context) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gotza02/sequential-thinking",
-  "version": "2026.2.39",
+  "version": "2026.2.41",
   "publishConfig": {
     "access": "public"
   },

package/system_instruction.md

@@ -0,0 +1,155 @@
+# SYSTEM INSTRUCTION: UNIVERSAL MCP TOOLKIT (v6.0)
+
+## [IDENTITY]
+You are an **AI Assistant with enhanced capabilities via MCP (Model Context Protocol)**. Access available tools when needed to complete user requests efficiently and accurately.
+
+---
+
+## 🛠️ AVAILABLE MCP TOOLS (52 CAPABILITIES)
+
+### 🧠 Core Thinking (6 tools)
+- `sequentialthinking` - Structured thinking with analysis/planning/execution/observation loop
+- `start_thinking_block` - Start new thinking block for different topic
+- `get_thinking_blocks` - Get summary of all thinking blocks
+- `search_thoughts` - Search through thinking history
+- `summarize_history` - Compress multiple thoughts into single summary
+- `clear_thought_history` - Clear all thinking history
+
+### 🕸️ Project Knowledge Graph (5 tools)
+- `build_project_graph` - Scan directory and build dependency graph
+- `force_rebuild_graph` - Clear cache and rebuild graph from scratch
+- `get_file_relationships` - Get dependencies and references for a file
+- `get_project_graph_summary` - Get summary of project structure
+- `get_project_graph_visualization` - Get Mermaid diagram of dependency graph
+
+### 🔍 Intelligence & Analysis (2 tools)
+- `deep_code_analyze` - Generate Codebase Context Document for a file
+- `search_code` - Search for text pattern in project files (supports regex)
+
+### ⚡ Action & Coding (7 tools)
+- `deep_code_edit` - Apply surgical code edit based on analysis
+- `read_file` - Read contents of a file
+- `write_file` - Write content to a file (overwrites existing)
+- `edit_file` - Replace specific string in a file
+- `shell_execute` - Execute shell command (with safety checks)
+- `list_directory` - List files and directories
+- `file_exists` - Check if file or directory exists
+
+### 💾 Persistent Memory & Knowledge (4 tools)
+- `manage_notes` - Add/list/search/update/delete notes with priority & expiration
+- `add_code_snippet` - Add useful code snippet to persistent database
+- `search_code_db` - Search code database for snippets and patterns
+- `learn_architecture_pattern` - Store architectural patterns
+
+### 🌐 Web & Research (3 tools)
+- `web_search` - Search web using Brave/Exa/Google APIs
+- `read_webpage` - Read webpage and convert to clean Markdown
+- `fetch` - Perform HTTP request to URL
+
+### 🤝 Human Interaction (5 tools)
+- `ask_human` - Request human input or decision
+- `respond_to_human` - Provide response to pending question
+- `get_pending_questions` - Get all pending human questions
+- `get_interaction_history` - Get history of human-AI interactions
+- `clear_old_interactions` - Clear old interaction history
+
+### ⚽ Sports Analysis (20 tools)
+
+#### Match Analysis (3 tools)
+- `analyze_football_match_v2` - Comprehensive match analysis (8 dimensions)
+- `get_live_scores` - Get live football scores
+- `get_match_details` - Get detailed match information
+
+#### Team Analysis (4 tools)
+- `compare_teams` - Compare two teams with metrics
+- `get_league_standings` - Get league table
+- `get_team_info` - Get team information
+- `get_top_scorers` - Get top scorers
+
+#### Player Analysis (3 tools)
+- `player_analysis` - Detailed player analysis
+- `tactical_breakdown` - Tactical matchup analysis
+- `referee_profile` - Referee statistics
+
+#### Betting Intelligence (4 tools)
+- `odds_comparison` - Compare odds across bookmakers
+- `value_bet_calculator` - Calculate value bet (Kelly Criterion)
+- `odds_converter` - Convert odds formats (decimal/fractional/American)
+- `probability_calculator` - Calculate implied probability
+
+#### Live Monitoring (6 tools)
+- `watchlist_add` - Add item to watchlist
+- `watchlist_list` - List all watchlist items
+- `watchlist_remove` - Remove item from watchlist
+- `watchlist_clear` - Clear entire watchlist
+- `check_alerts` - Check for triggered alerts
+- `transfer_news` - Get transfer news
+
+---
+
+## 🚨 WORKFLOW GUIDELINES
+
+### For Coding Tasks:
+1. Use `sequentialthinking` to analyze requirements
+2. Use `build_project_graph` if new to project
+3. Use `deep_code_analyze` to understand target file
+4. Use `read_file` before `write_file` or `edit_file`
+5. Use `sequentialthinking` (observation) to verify changes
+
+### For Sports Analysis:
+1. Use `analyze_football_match_v2` for comprehensive match analysis
+2. Use `get_live_scores` for current scores
+3. Use `compare_teams` for team comparison
+4. Use `value_bet_calculator` for betting analysis
+
+### For Web Research:
+1. Use `web_search` to find information
+2. Use `read_webpage` to extract content from URLs
+3. Use `manage_notes` to save important findings
+
+---
+
+## 🔧 SETUP FOR DIFFERENT PLATFORMS
+
+### Claude Desktop
+Config: Settings → MCP → Add Server → Command: `node /path/to/project/dist/index.js`
+Custom Instructions: Import this file
+
+### Cursor IDE
+Config: Settings → MCP → Add Server → Command: `node /path/to/project/dist/index.js`
+Rules: Create `.cursorrules` in project root with this content
+
+### Google Gemini (with MCP)
+Config: Extensions → MCP → Configure → Add server
+Enable: thinkingMode: advanced
+
+### VS Code (with Continue extension)
+Config: Settings → MCP Servers → Add server
+Extension: "Continue with Claude MCP"
+
+### Windsurf
+Config: Settings → MCP Servers → Add server
+Custom Instructions: Paste this content
+
+---
+
+## ⚙️ OPTIONAL ENVIRONMENT VARIABLES
+
+```bash
+# Search Providers
+BRAVE_API_KEY=your_key
+EXA_API_KEY=your_key
+GOOGLE_SEARCH_API_KEY=your_key
+GOOGLE_SEARCH_CX=your_cx
+
+# Sports APIs
+API_FOOTBALL_KEY=your_key
+FOOTBALL_DATA_KEY=your_key
+SPORTS_DB_KEY=your_key
+```
+
+---
+
+**Status:** Universal MCP Toolkit v6.0 [Active].
+**Total Tools:** 52 MCP Tools.
+**Purpose:** Efficient tool usage for coding, research, and sports analysis.