@semanticintent/semantic-chirp-intelligence-mcp 3.0.0 → 4.0.0

package/build/index.js

@@ -7,41 +7,28 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 // Node.js
-import * as fs from "fs";
 import * as path from "path";
+import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
-import * as dotenv from "dotenv";
-import https from "https";
-import { parseString } from "xml2js";
-import { promisify } from "util";
 import { GOVERNANCE_MONITOR, validateSemanticChirpContract, auditSemanticContract, checkGovernanceHealth } from './domain/governance.js';
 // Config layer
 import { CHIRP_STYLES } from './config/chirp-styles.js';
 import { PERSONALITY_MODES } from './config/personality-modes.js';
 import { TOOL_METADATA } from './config/tool-metadata.js';
-// Services layer
-import { YahooApiClient } from './services/YahooApiClient.js';
 // Analysis layer
 import { IceAnalysis } from './analyses/IceAnalysis.js';
 import { GamesInHandAnalysis } from './analyses/GamesInHandAnalysis.js';
 import { StreamingAnalysis } from './analyses/StreamingAnalysis.js';
 import { LineupAnalysis } from './analyses/LineupAnalysis.js';
 import { WeekendStreamAnalysis } from './analyses/WeekendStreamAnalysis.js';
-// Experimental: Semantic Intent Parser
-import { SEMANTIC_PLAYER_COMPARISON, getPlayerComparisonInputSchema, executePlayerComparison } from './experimental/semantic-tool-integration.js';
-import { SEMANTIC_BREAKOUT_ANALYSIS, getBreakoutAnalysisInputSchema, executeBreakoutAnalysis } from './experimental/semantic-breakout-tool.js';
 import { BreakoutAnalysis } from './analyses/BreakoutAnalysis.js';
-dotenv.config();
-const parseXML = promisify(parseString);
+import { ScheduleValueAnalysis } from './analyses/ScheduleValueAnalysis.js';
+import { DraftPickAnalysis } from './analyses/DraftPickAnalysis.js';
+import { NHL_STATS } from './services/NhlStatsService.js';
+import { ROSTER_STORE } from './services/RosterStore.js';
+import { LEAGUE_DATA, NO_ROSTER_MESSAGE, NO_OPPONENT_MESSAGE } from './services/LeagueDataService.js';
+import { NHL_SCHEDULE, NhlScheduleService } from './services/NhlScheduleService.js';
 // Configuration
-const YAHOO_CLIENT_ID = process.env.YAHOO_CLIENT_ID;
-const YAHOO_CLIENT_SECRET = process.env.YAHOO_CLIENT_SECRET;
-const LEAGUE_ID = process.env.YAHOO_LEAGUE_ID;
-const TEAM_ID = process.env.YAHOO_TEAM_ID;
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const TOKEN_FILE = path.join(__dirname, "..", ".yahoo-oauth.json");
-const YAHOO_API_BASE = "https://fantasysports.yahooapis.com/fantasy/v2";
 // ==========================================
 // 🔧 MCP Tool Schema Base
 // ==========================================
@@ -65,101 +52,15 @@ const baseChirpSchema = {
 // ==========================================
 // 🏗️ Service Initialization
 // ==========================================
-// Initialize Yahoo API client
-const yahooClient = new YahooApiClient(YAHOO_CLIENT_ID, YAHOO_CLIENT_SECRET, YAHOO_API_BASE);
 // Initialize analysis instances
-const iceAnalysis = new IceAnalysis(yahooClient, LEAGUE_ID, TEAM_ID);
-const gamesInHandAnalysis = new GamesInHandAnalysis(yahooClient, LEAGUE_ID, TEAM_ID);
-const streamingAnalysis = new StreamingAnalysis(yahooClient, LEAGUE_ID, TEAM_ID);
-const lineupAnalysis = new LineupAnalysis(yahooClient, LEAGUE_ID, TEAM_ID);
-const breakoutAnalysis = new BreakoutAnalysis(yahooClient, LEAGUE_ID, TEAM_ID);
-const weekendStreamAnalysis = new WeekendStreamAnalysis(yahooClient, LEAGUE_ID, TEAM_ID);
-let cachedToken = null;
-function loadToken() {
-    try {
-        console.error(`[DEBUG] Looking for token at: ${TOKEN_FILE}`);
-        if (fs.existsSync(TOKEN_FILE)) {
-            const tokenData = fs.readFileSync(TOKEN_FILE, "utf8");
-            const token = JSON.parse(tokenData);
-            console.error(`[DEBUG] Token loaded successfully`);
-            cachedToken = token;
-            return token;
-        }
-        else {
-            console.error(`[DEBUG] Token file not found`);
-        }
-    }
-    catch (error) {
-        console.error("[ERROR] Error loading token:", error);
-    }
-    return null;
-}
-function saveToken(token) {
-    token.expires_at = Date.now() + (token.expires_in * 1000);
-    fs.writeFileSync(TOKEN_FILE, JSON.stringify(token, null, 2));
-    cachedToken = token;
-    console.error("[DEBUG] Token saved successfully");
-}
-async function refreshAccessToken() {
-    const token = cachedToken || loadToken();
-    if (!token) {
-        throw new Error("No refresh token available. Please re-authenticate.");
-    }
-    console.error("[DEBUG] Refreshing access token...");
-    const tokenData = new URLSearchParams({
-        client_id: YAHOO_CLIENT_ID,
-        client_secret: YAHOO_CLIENT_SECRET,
-        redirect_uri: "oob",
-        refresh_token: token.refresh_token,
-        grant_type: "refresh_token",
-    });
-    const options = {
-        hostname: "api.login.yahoo.com",
-        port: 443,
-        path: "/oauth2/get_token",
-        method: "POST",
-        headers: {
-            "Content-Type": "application/x-www-form-urlencoded",
-            "Content-Length": tokenData.toString().length,
-        },
-    };
-    return new Promise((resolve, reject) => {
-        const req = https.request(options, (res) => {
-            let data = "";
-            res.on("data", (chunk) => {
-                data += chunk;
-            });
-            res.on("end", () => {
-                try {
-                    const newToken = JSON.parse(data);
-                    saveToken(newToken);
-                    console.error("[DEBUG] Token refreshed successfully");
-                    resolve(newToken.access_token);
-                }
-                catch (error) {
-                    reject(new Error(`Failed to parse token response: ${error}`));
-                }
-            });
-        });
-        req.on("error", (error) => {
-            reject(error);
-        });
-        req.write(tokenData.toString());
-        req.end();
-    });
-}
-async function getValidAccessToken() {
-    const token = cachedToken || loadToken();
-    if (!token) {
-        throw new Error("No authentication token found! Run: node authenticate.js");
-    }
-    // Check if token is expired (with 5 minute buffer)
-    if (token.expires_at && token.expires_at < Date.now() + 300000) {
-        console.error("[DEBUG] Token expired or expiring soon, refreshing...");
-        return await refreshAccessToken();
-    }
-    return token.access_token;
-}
+const iceAnalysis = new IceAnalysis();
+const gamesInHandAnalysis = new GamesInHandAnalysis();
+const streamingAnalysis = new StreamingAnalysis();
+const lineupAnalysis = new LineupAnalysis();
+const breakoutAnalysis = new BreakoutAnalysis();
+const scheduleValueAnalysis = new ScheduleValueAnalysis();
+const draftPickAnalysis = new DraftPickAnalysis();
+const weekendStreamAnalysis = new WeekendStreamAnalysis();
 // Helper function to find current matchup by status
 function findCurrentMatchup(matchups) {
     console.error('[DEBUG] findCurrentMatchup called');
@@ -196,282 +97,167 @@ function findCurrentMatchup(matchups) {
         return null;
     return matchups[lastKey].matchup;
 }
-// Yahoo API helper function
-async function yahooApiRequest(endpoint, format = "json") {
-    const accessToken = await getValidAccessToken();
-    const url = `${YAHOO_API_BASE}${endpoint}${endpoint.includes('?') ? '&' : '?'}format=${format}`;
-    console.error(`[DEBUG] API Request: ${endpoint}`);
-    return new Promise((resolve, reject) => {
-        const urlObj = new URL(url);
-        const options = {
-            hostname: urlObj.hostname,
-            port: 443,
-            path: urlObj.pathname + urlObj.search,
-            method: "GET",
-            headers: {
-                Authorization: `Bearer ${accessToken}`,
-                Accept: "application/json",
-            },
-        };
-        const req = https.request(options, (res) => {
-            let data = "";
-            res.on("data", (chunk) => {
-                data += chunk;
-            });
-            res.on("end", () => {
-                if (res.statusCode === 401) {
-                    // Token expired, try to refresh and retry
-                    refreshAccessToken()
-                        .then(() => yahooApiRequest(endpoint, format))
-                        .then(resolve)
-                        .catch(reject);
-                    return;
-                }
-                if (res.statusCode !== 200) {
-                    reject(new Error(`API returned status ${res.statusCode}: ${data}`));
-                    return;
-                }
-                try {
-                    const parsed = JSON.parse(data);
-                    resolve(parsed);
-                }
-                catch (error) {
-                    reject(new Error(`Failed to parse API response: ${error}`));
-                }
-            });
-        });
-        req.on("error", (error) => {
-            reject(error);
-        });
-        req.end();
-    });
-}
 // Tool: Get Team Roster
 async function getTeamRoster() {
-    const data = await yahooApiRequest(`/team/nhl.l.${LEAGUE_ID}.t.${TEAM_ID}/roster`);
-    const teamArray = data.fantasy_content.team[0];
-    const rosterData = data.fantasy_content.team[1].roster["0"].players;
-    // Extract team info
-    const teamKey = teamArray.find((item) => item.team_key)?.team_key;
-    const teamName = teamArray.find((item) => item.name)?.name;
-    // Parse players
-    const playerKeys = Object.keys(rosterData).filter(key => key !== 'count');
-    const players = playerKeys.map(key => {
-        const playerData = rosterData[key].player[0];
-        const positionData = rosterData[key].player[1];
-        // Find attributes in the array
-        const playerId = playerData.find((item) => item.player_id)?.player_id;
-        const name = playerData.find((item) => item.name)?.name?.full;
-        const displayPosition = playerData.find((item) => item.display_position)?.display_position;
-        const team = playerData.find((item) => item.editorial_team_abbr)?.editorial_team_abbr;
-        const status = playerData.find((item) => item.status)?.status || "";
-        const selectedPos = positionData?.selected_position?.find((item) => item.position)?.position || "BN";
-        return {
-            player_id: playerId,
-            name: name,
-            position: displayPosition,
-            team: team,
-            status: status,
-            selected_position: selectedPos,
-        };
-    });
+    await Promise.all([NHL_STATS.load(), NHL_SCHEDULE.load()]);
+    const roster = LEAGUE_DATA.getRoster();
+    if (!roster)
+        return { error: NO_ROSTER_MESSAGE };
+    const today = NhlScheduleService.today();
+    const weekEnd = NhlScheduleService.addDays(today, 6);
     return {
-        team_key: teamKey,
-        team_name: teamName,
-        roster: players,
+        team_name: roster.team_name,
+        player_count: roster.players.length,
+        players: roster.players.map((p) => ({
+            ...p,
+            games_next_7_days: NHL_SCHEDULE.isAvailable()
+                ? NHL_SCHEDULE.countGamesInRange(p.team, today, weekEnd)
+                : null,
+            season_stats: p.stats ?? null
+        })),
+        data_source: `NHL public API (rosters ${NHL_STATS.getSeasons().roster}, stats ${NHL_STATS.getSeasons().stats})`
     };
 }
 // Tool: Get League Standings
 async function getLeagueStandings() {
-    const data = await yahooApiRequest(`/league/nhl.l.${LEAGUE_ID}/standings`);
-    const teams = data.fantasy_content.league[1].standings[0].teams;
-    const standings = Object.keys(teams)
-        .filter(key => key !== 'count')
-        .map(key => {
-        const team = teams[key].team[0];
-        const standings = teams[key].team[1].team_standings;
+    const standings = LEAGUE_DATA.getStandings();
+    if (!standings) {
         return {
-            team_name: team[2].name,
-            rank: standings.rank,
-            wins: standings.outcome_totals?.wins || 0,
-            losses: standings.outcome_totals?.losses || 0,
-            ties: standings.outcome_totals?.ties || 0,
-            points: standings.points_for,
+            error: 'No standings stored. Paste them with `set_standings` — copy the standings ' +
+                'table from your league, one team per line.'
         };
-    });
-    return { standings };
-}
-// Tool: Get Current Matchup
-async function getCurrentMatchup() {
-    console.error('[DEBUG] getCurrentMatchup called');
-    const data = await yahooApiRequest(`/team/nhl.l.${LEAGUE_ID}.t.${TEAM_ID}/matchups`);
-    console.error('[DEBUG] API response received');
-    const matchups = data.fantasy_content.team[1].matchups;
-    console.error('[DEBUG] Matchups count:', matchups?.count);
-    // Debug: log first 3 matchup keys and their structure
-    if (matchups) {
-        const keys = Object.keys(matchups).filter(k => k !== 'count').slice(0, 3);
-        keys.forEach(key => {
-            const m = matchups[key];
-            console.error(`[DEBUG] matchups["${key}"] structure:`, JSON.stringify({
-                hasMatchup: !!m?.matchup,
-                isArray: Array.isArray(m?.matchup),
-                week: m?.matchup?.[0]?.week || m?.matchup?.week,
-                status: m?.matchup?.[0]?.status || m?.matchup?.status
-            }));
-        });
-    }
-    const currentMatchup = findCurrentMatchup(matchups);
-    if (!currentMatchup) {
-        console.error('[DEBUG] No current matchup found');
-        return { message: "No current matchup (bye week or season not started)" };
-    }
-    // currentMatchup is the matchup object with structure:
-    // matchup = { "0": { teams: {...} }, week: "1", status: "postevent", ... }
-    const matchupData = currentMatchup[0];
-    const week = currentMatchup.week;
-    const status = currentMatchup.status;
-    const teams = matchupData?.teams;
-    if (!teams) {
-        console.error('[DEBUG] No teams found in matchup');
-        return { message: "No teams data in current matchup" };
     }
-    console.error('[DEBUG] Final result:', {
-        week,
-        status,
-        opponent: teams['1']?.team?.[0]?.[2]?.name
-    });
     return {
-        week,
-        status,
-        your_team: teams['0']?.team?.[0]?.[2]?.name || 'Unknown',
-        opponent: teams['1']?.team?.[0]?.[2]?.name || 'Unknown',
+        teams: standings.rows.length,
+        standings: standings.rows,
+        updated_at: standings.updated_at
     };
 }
+// Tool: Get Current Matchup
+// Removed in v4: getCurrentMatchup required live fantasy-platform data
+// (live matchup scoring, weekly results, or league ownership) that no
+// public source exposes. See CHANGELOG for the full list.
 // Tool: Search Players
 async function searchPlayers(position, count = 25) {
-    let endpoint = `/league/nhl.l.${LEAGUE_ID}/players;status=A;count=${count}`;
-    if (position) {
-        endpoint += `;position=${position}`;
+    await NHL_STATS.load();
+    if (!NHL_STATS.isAvailable()) {
+        return { error: 'NHL player data unavailable', reason: NHL_STATS.getUnavailableReason() };
     }
-    const data = await yahooApiRequest(endpoint);
-    const playersData = data.fantasy_content.league[1].players;
-    const players = Object.keys(playersData)
-        .filter(key => key !== 'count')
-        .map(key => {
-        const playerData = playersData[key].player[0];
-        // Find attributes in the array using .find() to handle dynamic structure
-        const playerId = playerData.find((item) => item.player_id)?.player_id;
-        const name = playerData.find((item) => item.name)?.name?.full;
-        const displayPosition = playerData.find((item) => item.display_position)?.display_position;
-        const team = playerData.find((item) => item.editorial_team_abbr)?.editorial_team_abbr;
-        const percentOwned = playerData.find((item) => item.percent_owned)?.percent_owned?.value || "0";
-        return {
-            player_id: playerId,
-            name: name,
-            position: displayPosition,
-            team: team,
-            percent_owned: percentOwned,
-        };
-    });
-    return { players };
-}
-// Tool: Get Player Stats
-async function getPlayerStats(playerId) {
-    const data = await yahooApiRequest(`/player/nhl.p.${playerId}/stats`);
-    const playerData = data.fantasy_content.player[0];
-    const stats = data.fantasy_content.player[1]?.player_stats?.stats || [];
-    // Find attributes in the array using .find() to handle dynamic structure
-    const playerIdResult = playerData.find((item) => item.player_id)?.player_id;
-    const name = playerData.find((item) => item.name)?.name?.full;
-    const displayPosition = playerData.find((item) => item.display_position)?.display_position;
-    const team = playerData.find((item) => item.editorial_team_abbr)?.editorial_team_abbr;
+    // Fantasy platforms say LW/RW; the NHL says L/R.
+    const wanted = String(position ?? '').toUpperCase()
+        .replace(/^LW$/, 'L').replace(/^RW$/, 'R');
+    const owned = new Set((LEAGUE_DATA.getRoster()?.players ?? []).map((p) => p.player_id));
+    const players = NHL_STATS.getAll()
+        .filter(p => !wanted || p.position === wanted)
+        .map(p => ({
+        player_id: p.player_id,
+        name: p.name,
+        team: p.team,
+        position: p.position,
+        on_your_roster: owned.has(p.player_id),
+        season_stats: p.stats ?? null,
+        // Rank skaters by production, goalies by wins.
+        rank_value: p.position === 'G' ? (p.stats?.wins ?? 0) : (p.stats?.points ?? 0)
+    }))
+        .sort((a, b) => b.rank_value - a.rank_value)
+        .slice(0, Math.max(1, count));
     return {
-        player_id: playerIdResult,
-        name: name,
-        position: displayPosition,
-        team: team,
-        stats: stats,
+        position: position ?? 'all',
+        returned: players.length,
+        players,
+        note: 'Ranked by last season production across all NHL players. Whether a player ' +
+            'is available in your league is league-private and not knowable here — ' +
+            'on_your_roster reflects only the roster you pasted.',
+        data_source: `NHL public API (stats ${NHL_STATS.getSeasons().stats})`
     };
 }
-// Tool: Get Weekly Stats
-async function getWeeklyStats() {
-    const data = await yahooApiRequest(`/team/nhl.l.${LEAGUE_ID}.t.${TEAM_ID}/matchups`);
-    const matchups = data.fantasy_content.team[1].matchups;
-    const currentMatchup = findCurrentMatchup(matchups);
-    if (!currentMatchup) {
-        return { message: "No current matchup" };
-    }
-    // currentMatchup structure: { "0": { teams: {...} }, week: 5, status: "midevent", ... }
-    const teams = currentMatchup["0"]?.teams;
-    const week = currentMatchup.week;
-    const status = currentMatchup.status;
-    if (!teams) {
-        return { message: "No teams data in current matchup" };
+// Tool: Get Player Stats
+async function getPlayerStats(playerId) {
+    await Promise.all([NHL_STATS.load(), NHL_SCHEDULE.load()]);
+    // Accept an NHL id or, far more usefully, a name a human would type.
+    const direct = NHL_STATS.getById(playerId);
+    const resolution = direct ? { player: direct } : NHL_STATS.resolve(playerId);
+    if (!resolution.player) {
+        const r = resolution;
+        return {
+            error: `Could not resolve "${playerId}" to a single NHL player`,
+            reason: r.reason,
+            ...(r.ambiguous ? { candidates: r.ambiguous.map((p) => `${p.name} (${p.team} ${p.position})`) } : {})
+        };
     }
-    // Extract games remaining data
-    const yourGames = teams['0']?.team?.[1]?.team_remaining_games?.total;
-    const oppGames = teams['1']?.team?.[1]?.team_remaining_games?.total;
+    const p = resolution.player;
+    const today = NhlScheduleService.today();
     return {
-        week,
-        status,
-        your_team: {
-            name: teams['0']?.team?.[0]?.[2]?.name || 'Unknown',
-            stats: teams['0']?.team?.[1]?.team_stats?.stats || [],
-            games_remaining: yourGames?.remaining_games || 0,
-            games_completed: yourGames?.completed_games || 0,
-            live_games: yourGames?.live_games || 0,
-        },
-        opponent: {
-            name: teams['1']?.team?.[0]?.[2]?.name || 'Unknown',
-            stats: teams['1']?.team?.[1]?.team_stats?.stats || [],
-            games_remaining: oppGames?.remaining_games || 0,
-            games_completed: oppGames?.completed_games || 0,
-            live_games: oppGames?.live_games || 0,
-        },
-        games_in_hand: {
-            your_remaining: yourGames?.remaining_games || 0,
-            opponent_remaining: oppGames?.remaining_games || 0,
-            difference: (yourGames?.remaining_games || 0) - (oppGames?.remaining_games || 0),
-            advantage: (yourGames?.remaining_games || 0) > (oppGames?.remaining_games || 0) ? "You" : "Opponent"
-        }
+        player_id: p.player_id,
+        name: p.name,
+        team: p.team,
+        position: p.position,
+        season_stats: p.stats ?? null,
+        stats_season: NHL_STATS.getSeasons().stats,
+        games_next_7_days: NHL_SCHEDULE.isAvailable()
+            ? NHL_SCHEDULE.countGamesInRange(p.team, today, NhlScheduleService.addDays(today, 6))
+            : null,
+        upcoming: NHL_SCHEDULE.isAvailable()
+            ? NHL_SCHEDULE.getGamesInRange(p.team, today, NhlScheduleService.addDays(today, 13)).slice(0, 6)
+            : []
     };
 }
+// Tool: Get Weekly Stats
+// Removed in v4: getWeeklyStats required live fantasy-platform data
+// (live matchup scoring, weekly results, or league ownership) that no
+// public source exposes. See CHANGELOG for the full list.
 // Tool: Compare Matchup
 async function compareMatchup() {
-    const data = await yahooApiRequest(`/team/nhl.l.${LEAGUE_ID}.t.${TEAM_ID}/matchups`);
-    const matchups = data.fantasy_content.team[1].matchups;
-    const currentMatchup = findCurrentMatchup(matchups);
-    if (!currentMatchup) {
-        return { message: "No current matchup" };
-    }
-    // currentMatchup structure: { "0": { teams: {...} }, week: 5, status: "midevent", ... }
-    const teams = currentMatchup["0"]?.teams;
-    const week = currentMatchup.week;
-    if (!teams) {
-        return { message: "No teams data in current matchup" };
-    }
-    const yourStats = teams['0']?.team?.[1]?.team_stats?.stats || [];
-    const oppStats = teams['1']?.team?.[1]?.team_stats?.stats || [];
-    const comparison = yourStats.map((stat, idx) => {
-        const yourVal = parseFloat(stat.stat.value) || 0;
-        const oppVal = parseFloat(oppStats[idx]?.stat?.value || 0) || 0;
-        return {
-            category: stat.stat.display_name,
-            stat_id: stat.stat.stat_id,
-            your_value: yourVal,
-            opp_value: oppVal,
-            winning: yourVal > oppVal,
-        };
+    await Promise.all([NHL_STATS.load(), NHL_SCHEDULE.load()]);
+    const mine = LEAGUE_DATA.getRoster();
+    const theirs = LEAGUE_DATA.getOpponentRoster();
+    if (!mine)
+        return { error: NO_ROSTER_MESSAGE };
+    if (!theirs)
+        return { error: NO_OPPONENT_MESSAGE };
+    const today = NhlScheduleService.today();
+    const weekEnd = NhlScheduleService.addDays(today, 6);
+    const summarize = (roster) => {
+        const totals = { G: 0, A: 0, P: 0, '+/-': 0, PIM: 0, SOG: 0, PPG: 0, W: 0 };
+        let games = 0;
+        for (const p of roster.players) {
+            if (p.selected_position === 'IR')
+                continue;
+            const s = p.stats ?? {};
+            totals.G += s.goals ?? 0;
+            totals.A += s.assists ?? 0;
+            totals.P += s.points ?? 0;
+            totals['+/-'] += s.plus_minus ?? 0;
+            totals.PIM += s.penalty_minutes ?? 0;
+            totals.SOG += s.shots ?? 0;
+            totals.PPG += s.power_play_goals ?? 0;
+            totals.W += s.wins ?? 0;
+            games += NHL_SCHEDULE.isAvailable() ? NHL_SCHEDULE.countGamesInRange(p.team, today, weekEnd) : 0;
+        }
+        return { team_name: roster.team_name, totals, games_this_week: games };
+    };
+    const you = summarize(mine);
+    const them = summarize(theirs);
+    const categories = Object.keys(you.totals).map(cat => {
+        const a = you.totals[cat];
+        const b = them.totals[cat];
+        return { category: cat, you: Math.round(a * 10) / 10, opponent: Math.round(b * 10) / 10,
+            edge: a === b ? 'EVEN' : a > b ? 'YOU' : 'OPPONENT' };
     });
-    const categoriesWinning = comparison.filter((c) => c.winning).length;
+    const won = categories.filter(c => c.edge === 'YOU').length;
     return {
-        week,
-        your_team: teams['0']?.team?.[0]?.[2]?.name || 'Unknown',
-        opponent: teams['1']?.team?.[0]?.[2]?.name || 'Unknown',
-        categories_winning: categoriesWinning,
-        categories_total: comparison.length,
-        category_breakdown: comparison,
+        your_team: you.team_name,
+        opponent: them.team_name,
+        categories,
+        category_edge: `${won}-${categories.filter(c => c.edge === 'OPPONENT').length}`,
+        schedule: {
+            your_games_this_week: you.games_this_week,
+            opponent_games_this_week: them.games_this_week,
+            advantage: you.games_this_week - them.games_this_week
+        },
+        basis: `Last season totals (${NHL_STATS.getSeasons().stats}) as a proxy for current strength, ` +
+            'plus real games scheduled this week. Not live scoring — this compares roster ' +
+            'quality and volume, not what has actually happened in your matchup.'
     };
 }
 async function getRosterTransactionRecommendations(lookAheadDays = 7, targetPositions) {
@@ -488,7 +274,7 @@ async function getRosterTransactionRecommendations(lookAheadDays = 7, targetPosi
         // Find transaction opportunities
         const recommendations = [];
         // 1. IMMEDIATE FIXES (injured players)
-        const injuredActive = roster.roster.filter(p => p.status && p.status !== "" && !p.selected_position.includes("IR"));
+        const injuredActive = (roster.players ?? []).filter((p) => p.status && p.status !== "" && !p.selected_position.includes("IR"));
         for (const player of injuredActive) {
             recommendations.push({
                 priority: "CRITICAL",
@@ -910,35 +696,159 @@ function findBenchUpgrades(roster, streaming) {
 // - getStreamingRecommendations() → StreamingAnalysis
 // ==========================================
 // Tool: Get Trending Players
-async function getTrendingPlayers(trendType = "add", count = 25) {
-    const sortParam = trendType === "add" ? "AR" : "OR";
-    const endpoint = `/league/nhl.l.${LEAGUE_ID}/players;status=A;sort=${sortParam};count=${count}`;
-    const data = await yahooApiRequest(endpoint);
-    const playersData = data.fantasy_content.league[1].players;
-    const players = Object.keys(playersData)
-        .filter(key => key !== 'count')
-        .map(key => {
-        const playerData = playersData[key].player[0];
-        // Find attributes in the array using .find() to handle dynamic structure
-        const playerId = playerData.find((item) => item.player_id)?.player_id;
-        const name = playerData.find((item) => item.name)?.name?.full;
-        const displayPosition = playerData.find((item) => item.display_position)?.display_position;
-        const team = playerData.find((item) => item.editorial_team_abbr)?.editorial_team_abbr;
-        const percentOwned = playerData.find((item) => item.percent_owned)?.percent_owned?.value || "0";
+// Removed in v4: getTrendingPlayers required live fantasy-platform data
+// (live matchup scoring, weekly results, or league ownership) that no
+// public source exposes. See CHANGELOG for the full list.
+// Tool: Chirp Opponent
+async function chirpOpponent(chirpIntensity = 'savage', personalityMode = 'roast_master') {
+    await Promise.all([NHL_STATS.load(), NHL_SCHEDULE.load()]);
+    const theirs = LEAGUE_DATA.getOpponentRoster();
+    if (!theirs)
+        return { error: NO_OPPONENT_MESSAGE };
+    const today = NhlScheduleService.today();
+    const weekEnd = NhlScheduleService.addDays(today, 6);
+    const players = theirs.players.map((p) => ({
+        name: p.name,
+        team: p.team,
+        position: p.position,
+        slot: p.selected_position,
+        points_last_season: p.stats?.points ?? null,
+        games_this_week: NHL_SCHEDULE.isAvailable()
+            ? NHL_SCHEDULE.countGamesInRange(p.team, today, weekEnd)
+            : null
+    }));
+    const onIr = players.filter(p => p.slot === 'IR');
+    const idle = players.filter(p => p.games_this_week === 0);
+    const light = players.filter(p => (p.games_this_week ?? 9) <= 2 && p.slot !== 'IR');
+    const totalGames = players.reduce((n, p) => n + (p.games_this_week ?? 0), 0);
+    const style = CHIRP_STYLES[chirpIntensity] ?? CHIRP_STYLES.standard;
+    const persona = PERSONALITY_MODES[personalityMode] ?? PERSONALITY_MODES.analytical;
+    const lines = [];
+    if (idle.length)
+        lines.push(`${idle.length} of their players don't play at all this week. Free real estate.`);
+    if (light.length)
+        lines.push(`${light.length} more are stuck on two games or fewer.`);
+    if (onIr.length)
+        lines.push(`${onIr.length} parked on IR — that roster is holding a hospital ward.`);
+    if (!lines.length)
+        lines.push(`${theirs.team_name} is actually well set up this week. Annoying, but true.`);
+    return {
+        opponent: theirs.team_name,
+        roster_size: players.length,
+        total_games_this_week: totalGames,
+        weaknesses: { idle_players: idle.map(p => p.name), light_schedule: light.map(p => p.name), on_ir: onIr.map(p => p.name) },
+        players,
+        chirp: lines.join(' '),
+        chirp_style: style?.tone,
+        personality: persona?.voice,
+        basis: 'Real NHL schedule for this week, plus the opponent roster you pasted.'
+    };
+}
+// Tool: Analyze Trade
+async function analyzeTradeImpact(giving, receiving, chirpIntensity = 'standard') {
+    await Promise.all([NHL_STATS.load(), NHL_SCHEDULE.load()]);
+    if (!NHL_STATS.isAvailable()) {
+        return { error: 'NHL player data unavailable', reason: NHL_STATS.getUnavailableReason() };
+    }
+    const categories = ['G', 'A', 'P', '+/-', 'PIM', 'SOG', 'PPG', 'W', 'GAA', 'SV%'];
+    const lowerIsBetter = new Set(['GAA']);
+    const resolveSide = (names) => names.map(n => {
+        const r = NHL_STATS.resolve(n);
         return {
-            player_id: playerId,
-            name: name,
-            position: displayPosition,
-            team: team,
-            percent_owned: percentOwned,
+            input: n,
+            found: Boolean(r.player),
+            name: r.player?.name ?? n,
+            team: r.player?.team ?? '?',
+            position: r.player?.position ?? '?',
+            stats: r.player?.stats ?? null,
+            ...(r.ambiguous ? { candidates: r.ambiguous.map(p => `${p.name} (${p.team} ${p.position})`) } : {}),
+            ...(r.player ? {} : { reason: r.reason })
         };
     });
-    return { trend_type: trendType, players };
+    const sum = (side) => {
+        const totals = {};
+        const rates = {};
+        for (const p of side.filter(x => x.found && x.stats)) {
+            const s = p.stats;
+            totals.G = (totals.G ?? 0) + (s.goals ?? 0);
+            totals.A = (totals.A ?? 0) + (s.assists ?? 0);
+            totals.P = (totals.P ?? 0) + (s.points ?? 0);
+            totals['+/-'] = (totals['+/-'] ?? 0) + (s.plus_minus ?? 0);
+            totals.PIM = (totals.PIM ?? 0) + (s.penalty_minutes ?? 0);
+            totals.SOG = (totals.SOG ?? 0) + (s.shots ?? 0);
+            totals.PPG = (totals.PPG ?? 0) + (s.power_play_goals ?? 0);
+            totals.W = (totals.W ?? 0) + (s.wins ?? 0);
+            // Rate stats average rather than sum, and only across goalies who have them.
+            if (s.goals_against_average !== undefined)
+                (rates.GAA ??= []).push(s.goals_against_average);
+            if (s.save_percentage !== undefined)
+                (rates['SV%'] ??= []).push(s.save_percentage);
+        }
+        for (const [cat, values] of Object.entries(rates)) {
+            if (values.length)
+                totals[cat] = values.reduce((a, b) => a + b, 0) / values.length;
+        }
+        return totals;
+    };
+    const givingPlayers = resolveSide(giving);
+    const receivingPlayers = resolveSide(receiving);
+    const out = sum(givingPlayers);
+    const inn = sum(receivingPlayers);
+    let wins = 0, losses = 0;
+    const breakdown = categories.map(cat => {
+        const g = out[cat], r = inn[cat];
+        if (g === undefined && r === undefined)
+            return null;
+        const gv = g ?? 0, rv = r ?? 0;
+        const better = lowerIsBetter.has(cat) ? rv < gv : rv > gv;
+        const same = Math.abs(rv - gv) < 1e-9;
+        if (!same)
+            better ? wins++ : losses++;
+        const round = (n) => Math.round(n * 1000) / 1000;
+        return { category: cat, giving_up: round(gv), receiving: round(rv),
+            net: round(rv - gv), verdict: same ? 'PUSH' : better ? 'GAIN' : 'LOSS' };
+    }).filter(Boolean);
+    const verdict = wins > losses ? 'ACCEPT' : wins < losses ? 'DECLINE' : 'PUSH';
+    const unresolved = [...givingPlayers, ...receivingPlayers].filter(p => !p.found);
+    return {
+        giving: givingPlayers,
+        receiving: receivingPlayers,
+        category_breakdown: breakdown,
+        categories_gained: wins,
+        categories_lost: losses,
+        verdict,
+        chirp: verdict === 'ACCEPT'
+            ? `You win ${wins} categories to ${losses}. Take it before they think twice.`
+            : verdict === 'DECLINE'
+                ? `You lose ${losses} categories to ${wins}. That's not a trade, that's a donation.`
+                : `Dead even at ${wins}-${losses}. Decide on need, not numbers.`,
+        ...(unresolved.length ? { unresolved } : {}),
+        basis: `Last full season totals (${NHL_STATS.getSeasons().stats}) from the NHL public API. ` +
+            'GAA and SV% are averaged across goalies; counting stats are summed. ' +
+            'This measures past production, not your league\'s scoring settings.',
+        chirp_intensity: chirpIntensity
+    };
+}
+/**
+ * Version reported in the MCP handshake.
+ *
+ * Read from package.json rather than hardcoded — this string had drifted to
+ * 3.0.0 while the package was on 3.2.0, so clients were told the wrong version.
+ */
+function readPackageVersion() {
+    try {
+        const packageRoot = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
+        const pkg = JSON.parse(readFileSync(path.join(packageRoot, "package.json"), "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
 }
 // Initialize MCP Server
 const server = new Server({
     name: "semantic-chirp-intelligence-mcp",
-    version: "3.0.0",
+    version: readPackageVersion(),
 }, {
     capabilities: {
         tools: {},
@@ -964,14 +874,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     properties: {},
                 },
             },
-            {
-                name: "get_current_matchup",
-                description: "Get information about your current week's matchup",
-                inputSchema: {
-                    type: "object",
-                    properties: {},
-                },
-            },
             {
                 name: "search_players",
                 description: "Search for available players (free agents) by position. Returns top available players.",
@@ -1004,14 +906,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ["player_id"],
                 },
             },
-            {
-                name: "get_weekly_stats",
-                description: "Get your team's current week statistics and compare with opponent",
-                inputSchema: {
-                    type: "object",
-                    properties: {},
-                },
-            },
             {
                 name: "compare_matchup",
                 description: "Get detailed category-by-category comparison with your current opponent",
@@ -1028,40 +922,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     properties: {},
                 },
             },
-            {
-                name: "get_trending_players",
-                description: "Get trending players (most added or most owned) to identify hot pickups",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        trend_type: {
-                            type: "string",
-                            description: "Type of trending: 'add' for most added, 'own' for most owned",
-                            enum: ["add", "own"],
-                            default: "add",
-                        },
-                        count: {
-                            type: "number",
-                            description: "Number of players to return (default 25)",
-                            default: 25,
-                        },
-                    },
-                },
-            },
-            {
-                name: "debug_api_call",
-                description: "Debug tool to see raw Yahoo API responses for troubleshooting",
-                inputSchema: {
-                    type: "object",
-                    properties: {
-                        endpoint: {
-                            type: "string",
-                            description: "API endpoint to call (e.g., '/team/nhl.l.{LEAGUE_ID}.t.{TEAM_ID}/roster')",
-                        },
-                    },
-                    required: ["endpoint"],
-                },
-            },
             {
                 name: "get_streaming_recommendations",
                 description: "Get AI-powered streaming recommendations based on team schedules, player trends, and ownership. Identifies players on teams with favorable schedules (more games remaining this week) for optimal waiver pickups.",
@@ -1153,14 +1013,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 }
             },
             {
-                name: SEMANTIC_PLAYER_COMPARISON.name,
-                description: `${SEMANTIC_PLAYER_COMPARISON.description} - Auto-configured from semantic intent!`,
-                inputSchema: getPlayerComparisonInputSchema()
-            },
-            {
-                name: SEMANTIC_BREAKOUT_ANALYSIS.name,
-                description: `${SEMANTIC_BREAKOUT_ANALYSIS.description} - 🏒 Comprehensive breakout analysis with data-driven scoring (40% recent, 30% projections, 20% opportunity, 10% risk)`,
-                inputSchema: getBreakoutAnalysisInputSchema()
+                name: "analyze_breakout_players",
+                description: "📈 Find breakout candidates among NHL players not on the rosters you have provided, scored on real season production, opportunity and risk. Availability in your league is league-private and cannot be determined here — treat these as candidates to check.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        position_filter: { type: "array", items: { type: "string" }, description: "Limit to positions, e.g. [\"C\", \"D\"]" },
+                        breakout_age_max: { type: "number", description: "Maximum age for a breakout candidate (default 26)" },
+                        min_score: { type: "number", description: "Minimum breakout score to include" },
+                        max_results: { type: "number", description: "How many candidates to return (default 10)" },
+                        ...baseChirpSchema
+                    }
+                }
             },
             {
                 name: "analyze_weekend_streams",
@@ -1212,7 +1076,155 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     },
                     required: ["date_range"]
                 }
-            }
+            },
+            {
+                name: "chirp_opponent",
+                description: "Scout your current matchup opponent's roster and generate savage trash talk based on their weaknesses — injuries, IR mismanagement, bench-heavy lineups. Pure ChirpIQX energy.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        ...baseChirpSchema,
+                    },
+                },
+            },
+            {
+                name: "analyze_trade",
+                description: "Evaluate a trade offer by comparing the net category impact of players you're giving vs receiving. Returns a category-by-category breakdown and an ACCEPT / DECLINE / PUSH verdict with chirp commentary.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        giving: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Player names you are giving away (e.g. [\"Nathan MacKinnon\", \"Mitch Marner\"])",
+                        },
+                        receiving: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Player names you are receiving (e.g. [\"Auston Matthews\"])",
+                        },
+                        ...baseChirpSchema,
+                    },
+                    required: ["giving", "receiving"],
+                },
+            },
+            {
+                name: "set_roster",
+                description: "📋 Paste your team's roster to teach CHIRP who you own. Works with text copied from any fantasy platform — Yahoo, ESPN, Sleeper, a spreadsheet, or just a list of names. Player names are resolved against live NHL rosters, so team and position fill themselves in. Anything that can't be resolved to exactly one player is reported back rather than guessed. No account or API key needed.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        roster_text: {
+                            type: "string",
+                            description: "The pasted roster. One player per line, in whatever shape you copied it — \"Auston Matthews\", \"MATTHEWS, Auston\", or a full row like \"C  Auston Matthews  TOR - C  Q\". BN and IR slots are preserved if present."
+                        },
+                        team_name: {
+                            type: "string",
+                            description: "What to call this team (default: \"My Team\")"
+                        }
+                    },
+                    required: ["roster_text"]
+                }
+            },
+            {
+                name: "set_opponent_roster",
+                description: "📋 Paste your weekly opponent's roster, so head-to-head tools (games-in-hand, matchup comparison, opponent scouting) can work without a league account. Same forgiving format as set_roster.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        roster_text: { type: "string", description: "The pasted opponent roster, one player per line" },
+                        team_name: { type: "string", description: "Opponent's team name (default: \"Opponent\")" }
+                    },
+                    required: ["roster_text"]
+                }
+            },
+            {
+                name: "set_standings",
+                description: "📊 Paste your league standings to give CHIRP league context. Extracts rank, team name, record and points from rows like \"1. TeamDestroyersz 8-2-1 142 pts\".",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        standings_text: { type: "string", description: "The pasted standings, one team per line" }
+                    },
+                    required: ["standings_text"]
+                }
+            },
+            {
+                name: "show_stored_data",
+                description: "🗂️ Show what CHIRP currently knows about your league — stored roster, opponent roster and standings, with when each was last updated. Use `clear` to forget one of them.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        clear: {
+                            type: "string",
+                            enum: ["roster", "opponent", "standings"],
+                            description: "Optionally forget one stored item instead of showing everything"
+                        }
+                    }
+                }
+            },
+            {
+                name: "schedule_value",
+                description: "🗓️ Rate all 32 NHL clubs on what their schedule is worth to a fantasy roster — total games, four-game weeks, light weeks, back-to-backs, and games played during YOUR league's playoff weeks (read from your Yahoo league settings, not guessed). The draft tiebreaker when two players are close.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        teams: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Limit to specific clubs (NHL or Yahoo abbreviations, e.g. [\"TOR\", \"SJ\"]). Omit to rate all 32."
+                        },
+                        playoff_start_week: {
+                            type: "number",
+                            description: "Override the fantasy playoff start week. Defaults to playoff_start_week from your Yahoo league settings."
+                        },
+                        playoff_end_week: {
+                            type: "number",
+                            description: "Override the final fantasy week. Defaults to your league's end_week."
+                        },
+                        top_n: {
+                            type: "number",
+                            description: "How many clubs to highlight (default 8)",
+                            default: 8
+                        },
+                        ...baseChirpSchema
+                    }
+                }
+            },
+            {
+                name: "chirp_draft_pick",
+                description: "❄️ ICE at the draft table — with a pick on the clock, ranks who to take against YOUR draft: who is already gone, what your roster still needs, Yahoo's ADP (so 'value' means the market is wrong here), and each club's schedule during your league's playoff weeks. Pass already_drafted if Yahoo's draft results lag your live draft.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        pick_number: {
+                            type: "number",
+                            description: "The pick currently on the clock. Inferred from Yahoo draft results if omitted."
+                        },
+                        already_drafted: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Player names already off the board. Merged with Yahoo's draft results — use this when Yahoo's API lags a fast live draft."
+                        },
+                        roster_needs: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Positions you still need, e.g. [\"RW\", \"G\"]. Inferred from your roster if omitted."
+                        },
+                        max_results: {
+                            type: "number",
+                            description: "How many candidates to return (default 8)",
+                            default: 8
+                        },
+                        pool_size: {
+                            type: "number",
+                            description: "How deep to pull the player pool (default 150, max 300)",
+                            default: 150
+                        },
+                        ...baseChirpSchema
+                    }
+                }
+            },
         ],
     };
 });
@@ -1233,12 +1245,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(standings, null, 2) }],
                 };
             }
-            case "get_current_matchup": {
-                const matchup = await getCurrentMatchup();
-                return {
-                    content: [{ type: "text", text: JSON.stringify(matchup, null, 2) }],
-                };
-            }
             case "search_players": {
                 const position = args?.position;
                 const count = args?.count || 25;
@@ -1257,12 +1263,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(stats, null, 2) }],
                 };
             }
-            case "get_weekly_stats": {
-                const stats = await getWeeklyStats();
-                return {
-                    content: [{ type: "text", text: JSON.stringify(stats, null, 2) }],
-                };
-            }
             case "compare_matchup": {
                 const comparison = await compareMatchup();
                 return {
@@ -1283,24 +1283,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
                 };
             }
-            case "get_trending_players": {
-                const trendType = args?.trend_type || "add";
-                const count = args?.count || 25;
-                const trending = await getTrendingPlayers(trendType, count);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(trending, null, 2) }],
-                };
-            }
-            case "debug_api_call": {
-                const endpoint = args?.endpoint;
-                if (!endpoint) {
-                    throw new Error("endpoint is required");
-                }
-                const rawData = await yahooApiRequest(endpoint);
-                return {
-                    content: [{ type: "text", text: JSON.stringify(rawData, null, 2) }],
-                };
-            }
             case "get_streaming_recommendations": {
                 // 🎯 Template Method Pattern: Use StreamingAnalysis class
                 const semanticContract = {
@@ -1459,27 +1441,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(reportData, null, 2) }]
                 };
             }
-            case "semantic_player_comparison": {
-                try {
-                    const result = await executePlayerComparison(args, getPlayerStats, searchPlayers);
-                    return {
-                        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-                    };
-                }
-                catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : String(error);
-                    return {
-                        content: [{ type: "text", text: JSON.stringify({
-                                    error: errorMessage,
-                                    note: "This is an experimental semantic intent-driven tool"
-                                }, null, 2) }],
-                        isError: true
-                    };
-                }
-            }
             case "analyze_breakout_players": {
                 try {
-                    const result = await executeBreakoutAnalysis(args, breakoutAnalysis);
+                    const result = await breakoutAnalysis.executeAnalysis({
+                        position_filter: args?.position_filter,
+                        breakout_age_max: args?.breakout_age_max,
+                        min_score: args?.min_score,
+                        max_results: args?.max_results
+                    }, {
+                        chirp_intensity: args?.chirp_intensity || 'standard',
+                        personality_mode: args?.personality_mode || 'analytical',
+                        enable_chirp: args?.enable_chirp !== false,
+                        semantic_intent: 'user_requested'
+                    });
                     return {
                         content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
                     };
@@ -1529,6 +1503,156 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     };
                 }
             }
+            case "chirp_opponent": {
+                const intensity = args?.chirp_intensity || 'savage';
+                const mode = args?.personality_mode || 'roast_master';
+                const result = await chirpOpponent(intensity, mode);
+                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            }
+            case "analyze_trade": {
+                const giving = args?.giving;
+                const receiving = args?.receiving;
+                if (!giving || !receiving || giving.length === 0 || receiving.length === 0) {
+                    throw new Error("Both 'giving' and 'receiving' arrays are required and must not be empty.");
+                }
+                const intensity = args?.chirp_intensity || 'standard';
+                const result = await analyzeTradeImpact(giving, receiving, intensity);
+                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            }
+            case "set_roster":
+            case "set_opponent_roster": {
+                const key = name === "set_roster" ? "roster" : "opponent";
+                const text = args?.roster_text;
+                if (!text || !text.trim()) {
+                    throw new Error("roster_text is required — paste your roster, one player per line.");
+                }
+                await NHL_STATS.load();
+                if (!NHL_STATS.isAvailable()) {
+                    return { content: [{ type: "text", text: JSON.stringify({
+                                    error: "NHL player data unavailable",
+                                    reason: NHL_STATS.getUnavailableReason(),
+                                    note: "Names are resolved against live NHL rosters; retry shortly."
+                                }, null, 2) }], isError: true };
+                }
+                const report = ROSTER_STORE.parseRoster(text);
+                const label = args?.team_name || (key === "roster" ? "My Team" : "Opponent");
+                if (report.resolved.length === 0) {
+                    return { content: [{ type: "text", text: JSON.stringify({
+                                    saved: false,
+                                    reason: "No player names could be resolved from that text.",
+                                    lines_read: report.lines_read,
+                                    unresolved: report.unresolved,
+                                    ambiguous: report.ambiguous
+                                }, null, 2) }], isError: true };
+                }
+                const stored = ROSTER_STORE.saveRoster(key, report.resolved, label);
+                return { content: [{ type: "text", text: JSON.stringify({
+                                saved: true,
+                                team: label,
+                                players_resolved: report.resolved.length,
+                                lines_read: report.lines_read,
+                                roster: stored.players,
+                                // Surfaced, never silently dropped - the user decides what to do.
+                                needs_attention: {
+                                    unresolved: report.unresolved,
+                                    ambiguous: report.ambiguous
+                                },
+                                note: report.unresolved.length || report.ambiguous.length
+                                    ? "Some lines could not be matched to exactly one NHL player. Re-run set_roster with corrected names to include them."
+                                    : "All lines resolved.",
+                                data_source: `NHL public API (rosters ${NHL_STATS.getSeasons().roster}, stats ${NHL_STATS.getSeasons().stats})`
+                            }, null, 2) }] };
+            }
+            case "set_standings": {
+                const text = args?.standings_text;
+                if (!text || !text.trim()) {
+                    throw new Error("standings_text is required — paste your league standings, one team per line.");
+                }
+                const rows = ROSTER_STORE.parseStandings(text);
+                if (rows.length === 0) {
+                    return { content: [{ type: "text", text: JSON.stringify({
+                                    saved: false,
+                                    reason: "No standings rows could be read from that text."
+                                }, null, 2) }], isError: true };
+                }
+                ROSTER_STORE.saveStandings(rows);
+                return { content: [{ type: "text", text: JSON.stringify({
+                                saved: true, teams: rows.length, standings: rows
+                            }, null, 2) }] };
+            }
+            case "show_stored_data": {
+                const clearKey = args?.clear;
+                if (clearKey) {
+                    const removed = ROSTER_STORE.clear(clearKey);
+                    return { content: [{ type: "text", text: JSON.stringify({
+                                    cleared: clearKey, existed: removed
+                                }, null, 2) }] };
+                }
+                const roster = ROSTER_STORE.getRoster('roster');
+                const opponent = ROSTER_STORE.getRoster('opponent');
+                const standings = ROSTER_STORE.getStandings();
+                return { content: [{ type: "text", text: JSON.stringify({
+                                roster: roster ?? "not set — paste yours with set_roster",
+                                opponent: opponent ?? "not set — paste one with set_opponent_roster",
+                                standings: standings ?? "not set — paste them with set_standings",
+                                storage: ROSTER_STORE.getDataDir()
+                            }, null, 2) }] };
+            }
+            case "schedule_value": {
+                try {
+                    const semanticContract = {
+                        chirp_intensity: args?.chirp_intensity || 'standard',
+                        personality_mode: args?.personality_mode || 'analytical',
+                        enable_chirp: args?.enable_chirp !== false,
+                        semantic_intent: 'user_requested'
+                    };
+                    const result = await scheduleValueAnalysis.executeAnalysis({
+                        teams: args?.teams,
+                        playoff_start_week: args?.playoff_start_week,
+                        playoff_end_week: args?.playoff_end_week,
+                        top_n: args?.top_n
+                    }, semanticContract);
+                    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    error: errorMessage,
+                                    note: "Schedule value analysis failed - rates NHL club schedules against your league's playoff weeks"
+                                }, null, 2) }],
+                        isError: true
+                    };
+                }
+            }
+            case "chirp_draft_pick": {
+                try {
+                    const semanticContract = {
+                        chirp_intensity: args?.chirp_intensity || 'ice_cold',
+                        personality_mode: args?.personality_mode || 'championship_coach',
+                        enable_chirp: args?.enable_chirp !== false,
+                        semantic_intent: 'user_requested'
+                    };
+                    const result = await draftPickAnalysis.executeAnalysis({
+                        pick_number: args?.pick_number,
+                        already_drafted: args?.already_drafted,
+                        roster_needs: args?.roster_needs,
+                        max_results: args?.max_results,
+                        pool_size: args?.pool_size
+                    }, semanticContract);
+                    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    error: errorMessage,
+                                    note: "Draft pick analysis failed - pass already_drafted explicitly if Yahoo draft results are unavailable"
+                                }, null, 2) }],
+                        isError: true
+                    };
+                }
+            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }
@@ -1544,6 +1668,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("🏒❄️ Semantic Chirp Intelligence MCP v3.0 - ICE is ON! (Official API)");
+    console.error(`🏒❄️ Semantic Chirp Intelligence MCP v${readPackageVersion()} - ICE is ON! (Real schedule, real stats)`);
 }
 main().catch(console.error);