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

package/.chirp-data/opponent.json

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

package/.chirp-data/roster.json

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

package/.chirp-data/standings.json

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

package/README.md

@@ -37,7 +37,7 @@ occasional chirp.
 - 🗓️ **Schedule intelligence** — every game count comes from the NHL's public club-schedule API, per club, per week
 - 🏛️ **Semantic Anchoring Governance** — every tool declares its intent; a dashboard surfaces the health metrics
 - 🧩 **Template Pattern architecture** — analyses are composable, consistent, and testable
-- 🔒 **Read-only & local** — OAuth 2.0, minimum permissions, no third-party data egress
+- 🔒 **Read-only & local** — no credentials of any kind, no third-party data egress; your roster never leaves your machine
 
 ---
 
@@ -53,7 +53,8 @@ occasional chirp.
 ├─────────────────────────────────────────────────────────────┤
 │  Intelligence layer (src/analyses/ + src/template/)          │
 │    • AnalysisTemplate   — shared Template Pattern base         │
-│    • Ice / Streaming / GamesInHand / WeekendStream / Lineup   │
+│    • Ice / Lineup / GamesInHand / Streaming / WeekendStream    │
+│    • Breakout / ScheduleValue / DraftPick                     │
 ├─────────────────────────────────────────────────────────────┤
 │  Services (src/services/)                                     │
 │    • ChirpIntelligence  — turns data into chirp               │
@@ -174,10 +175,7 @@ Edit your Claude Desktop config:
   "mcpServers": {
     "semantic-chirp-intelligence-mcp": {
       "command": "node",
-      "args": ["/absolute/path/to/semantic-chirp-intelligence-mcp/build/index.js"],
-      "env": {
-        "DOTENV_CONFIG_QUIET": "true"
-      }
+      "args": ["/absolute/path/to/semantic-chirp-intelligence-mcp/build/index.js"]
     }
   }
 }
@@ -185,11 +183,9 @@ Edit your Claude Desktop config:
 
 Use an **absolute path** to `build/index.js` (forward slashes, even on Windows). Restart Claude Desktop — the CHIRP tools will appear.
 
-Your credentials stay in the project's git-ignored `.env`; the server resolves
-it from its own install directory, so it is found regardless of the working
-directory the client launches it with. You do **not** need to copy secrets into
-the client config. If you prefer to set them there anyway, a client `env` block
-still overrides the file.
+There is no `env` block, because there is nothing to configure. Your pasted
+roster is stored in the project's git-ignored `.chirp-data/` and never leaves
+your machine.
 
 ---
 
@@ -203,7 +199,7 @@ Once connected, just talk to Claude about your team:
 - *"Where do I have a games-in-hand edge over my opponent?"*
 - *"Find me streaming goalies for the weekend — real value, not desperation pickups."*
 - *"Am I winning my matchup? Which categories am I losing?"*
-- *"Who are the hottest waiver adds in my league?"*
+- *"Who are the best players not on my roster right now?"*
 - *"Show me the governance dashboard."*
 
 ---
@@ -232,7 +228,7 @@ semantic-chirp-intelligence-mcp/
 │   ├── services/           # NhlScheduleService, NhlStatsService, RosterStore,
 │   │                       #   LeagueDataService, ChirpIntelligence
 │   ├── config/             # tool-metadata, personality-modes, chirp-styles
-│   ├── domain/             # types, governance, nhl-teams, yahoo-stats
+│   ├── domain/             # types, governance, nhl-teams
 ├── tests/                  # vitest tests
 ├── scripts/preflight.mjs   # build + NHL API check
 ├── scripts/smoke.mjs       # calls every tool, flags crash-like responses

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,6 +1,6 @@
 {
   "name": "@semanticintent/semantic-chirp-intelligence-mcp",
-  "version": "4.0.0",
+  "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",
@@ -43,7 +43,6 @@
     "vitest": "^4.1.10"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.19.1",
-    "dotenv": "^17.4.2"
+    "@modelcontextprotocol/sdk": "^1.19.1"
   }
 }