@semanticintent/semantic-chirp-intelligence-mcp 4.0.1 → 4.0.2

package/.chirp-data/opponent.json

@@ -20,5 +20,5 @@
       "position": "D"
     }
   ],
-  "updated_at": "2026-09-01T20:20:55.207Z"
+  "updated_at": "2026-09-01T20:56:50.722Z"
 }

package/.chirp-data/roster.json

@@ -30,5 +30,5 @@
       "slot": "LW"
     }
   ],
-  "updated_at": "2026-09-01T20:20:55.063Z"
+  "updated_at": "2026-09-01T20:56:50.579Z"
 }

package/.chirp-data/standings.json

@@ -13,5 +13,5 @@
       "points": 138
     }
   ],
-  "updated_at": "2026-09-01T20:20:55.360Z"
+  "updated_at": "2026-09-01T20:56:50.874Z"
 }

package/build/analyses/DraftPickAnalysis.js

@@ -81,7 +81,7 @@ export class DraftPickAnalysis extends AnalysisTemplate {
             draftResultsAvailable: false,
             manualDraftedCount: draftedNames.size,
             rosterPositions,
-            playoffWindow: this.resolvePlayoffWindow(null),
+            playoffWindow: this.resolvePlayoffWindow(args),
             poolCaveat: rawData.pool_caveat
         };
     }
@@ -127,26 +127,38 @@ export class DraftPickAnalysis extends AnalysisTemplate {
         const contract = this.mergeContractWithDefaults(semanticContract);
         const enhanced = ChirpIntelligence.enhance(this.toolName, analysisResults, contract);
         const top = analysisResults.candidates[0];
+        // The playoff clause is only truthful when a window was actually resolved.
+        const windowResolved = analysisResults.playoff_window?.resolved === true;
+        const scheduleClause = top && windowResolved && top.playoff_games !== null
+            ? `, and ${top.team} plays ${top.playoff_games} games in your playoff window`
+            : '';
         let chirp;
         if (!top) {
             chirp = 'Nobody left worth chirping about. Either the pool is empty or everyone is drafted.';
         }
         else if (top.adp_delta !== null && top.adp_delta >= 12) {
+            // v4 has no market ADP. average_pick is this player's rank by production,
+            // so the claim is "better player than this slot", not "the room drafts
+            // him earlier" — nothing here knows what a room does.
             chirp =
-                `${top.name} is still sitting there at ${analysisResults.pick_number} and the room ` +
-                    `usually takes him at ${top.average_pick}. That is ${Math.round(top.adp_delta)} picks of ` +
-                    `free value. Take him before someone wakes up.`;
+                `${top.name} is the ${this.ordinal(top.average_pick ?? 0)} best producer left and you are ` +
+                    `picking at ${analysisResults.pick_number}. That is ${Math.round(top.adp_delta)} slots of ` +
+                    `talent above where you are sitting${scheduleClause}.`;
         }
         else if (top.fills_need) {
             chirp =
-                `${top.name} fills the hole you actually have (${top.position}), and ` +
-                    `${top.team} plays ${top.playoff_games ?? '?'} games in your playoff window. ` +
+                `${top.name} fills the hole you actually have (${top.position})${scheduleClause}. ` +
                     `Best available is a luxury; a full lineup is not.`;
         }
         else {
             chirp =
-                `${top.name} is the pick. No bargain, no drama — just the best board-and-schedule ` +
-                    `combination left at ${analysisResults.pick_number}.`;
+                `${top.name} is the pick. No bargain, no drama — just the best producer left ` +
+                    `at ${analysisResults.pick_number}${scheduleClause}.`;
+        }
+        if (!windowResolved) {
+            chirp +=
+                ' I have not scored your playoff weeks — pass playoff_start_week and ' +
+                    'playoff_end_week and the schedule becomes a tiebreaker.';
         }
         if (analysisResults.players_off_board === 0) {
             chirp +=
@@ -249,6 +261,18 @@ export class DraftPickAnalysis extends AnalysisTemplate {
             reasoning: this.reasoningFor(player, adpDelta, playoffGames, weekCount, fillsNeed)
         };
     }
+    /** 1 -> "1st", 2 -> "2nd", 23 -> "23rd". */
+    ordinal(n) {
+        const rem100 = n % 100;
+        if (rem100 >= 11 && rem100 <= 13)
+            return `${n}th`;
+        switch (n % 10) {
+            case 1: return `${n}st`;
+            case 2: return `${n}nd`;
+            case 3: return `${n}rd`;
+            default: return `${n}th`;
+        }
+    }
     verdictFor(adpDelta) {
         if (adpDelta === null)
             return 'FAIR';
@@ -391,25 +415,32 @@ export class DraftPickAnalysis extends AnalysisTemplate {
         }
         return counts;
     }
-    resolvePlayoffWindow(settings) {
-        const leagueMeta = settings?.fantasy_content?.league?.[0] ?? {};
-        const leagueSettings = settings?.fantasy_content?.league?.[1]?.settings?.[0] ?? {};
-        const startDate = leagueMeta.start_date;
-        const endWeek = Number(leagueMeta.end_week ?? leagueSettings.end_week ?? 0);
-        const playoffStartWeek = Number(leagueSettings.playoff_start_week ?? 0);
-        if (!startDate || !playoffStartWeek || !endWeek || playoffStartWeek > endWeek) {
+    /**
+     * Resolve the fantasy playoff weeks to calendar dates.
+     *
+     * v4 has no league settings to read, so the weeks come from the caller and
+     * week 1 is anchored to the NHL season's own opening night. Without stated
+     * weeks the window is unresolved, and the schedule component stays neutral
+     * rather than silently scoring the wrong three weeks.
+     */
+    resolvePlayoffWindow(args) {
+        const startWeek = Number(args?.playoff_start_week ?? 0);
+        const endWeek = Number(args?.playoff_end_week ?? 0);
+        const seasonStart = NHL_SCHEDULE.getSeasonStartDate();
+        if (!startWeek || !endWeek || startWeek > endWeek || !seasonStart) {
             return { resolved: false, start: null, end: null, weeks: [] };
         }
-        const week1Monday = NhlScheduleService.weekStart(startDate);
+        const week1Monday = NhlScheduleService.weekStart(seasonStart);
         const weeks = [];
-        for (let week = playoffStartWeek; week <= endWeek; week++) {
+        for (let week = startWeek; week <= endWeek; week++) {
             weeks.push(NhlScheduleService.addDays(week1Monday, (week - 1) * 7));
         }
         return {
             resolved: true,
-            playoff_start_week: playoffStartWeek,
+            week_1_anchor: `${week1Monday} (NHL season opener)`,
+            playoff_start_week: startWeek,
             end_week: endWeek,
-            start: NhlScheduleService.addDays(week1Monday, (playoffStartWeek - 1) * 7),
+            start: NhlScheduleService.addDays(week1Monday, (startWeek - 1) * 7),
             end: NhlScheduleService.addDays(week1Monday, endWeek * 7 - 1),
             weeks
         };

package/build/index.js

@@ -1218,8 +1218,16 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         pool_size: {
                             type: "number",
-                            description: "How deep to pull the player pool (default 150, max 300)",
-                            default: 150
+                            description: "How deep to pull the player pool (default 250, max 400)",
+                            default: 250
+                        },
+                        playoff_start_week: {
+                            type: "number",
+                            description: "First week of your fantasy playoffs. Supply this with playoff_end_week and each club's playoff-window schedule becomes a tiebreaker between similar players."
+                        },
+                        playoff_end_week: {
+                            type: "number",
+                            description: "Final week of your fantasy playoffs (commonly your league's last week)."
                         },
                         ...baseChirpSchema
                     }
@@ -1638,7 +1646,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         already_drafted: args?.already_drafted,
                         roster_needs: args?.roster_needs,
                         max_results: args?.max_results,
-                        pool_size: args?.pool_size
+                        pool_size: args?.pool_size,
+                        playoff_start_week: args?.playoff_start_week,
+                        playoff_end_week: args?.playoff_end_week
                     }, semanticContract);
                     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
                 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@semanticintent/semantic-chirp-intelligence-mcp",
-  "version": "4.0.1",
-  "description": "Universal fantasy hockey intelligence — a Model Context Protocol server that reads NHL schedule and player data and analyses any roster you paste. No account, no API key, no platform lock-in.",
+  "version": "4.0.2",
+  "description": "Universal fantasy hockey intelligence \u2014 a Model Context Protocol server that reads NHL schedule and player data and analyses any roster you paste. No account, no API key, no platform lock-in.",
   "type": "module",
   "main": "build/index.js",
   "scripts": {