cfb-stats-mcp 0.1.0

package/dist/tools/export-subtitles.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { readFileSync, writeFileSync } from "node:fs";
+import { logger } from "../logger.js";
+/**
+ * Convert float seconds to SRT timestamp format "HH:MM:SS,mmm".
+ * Uses comma separator (not period) per SRT spec.
+ */
+export function formatSrtTimestamp(seconds) {
+    const totalMs = Math.round(seconds * 1000);
+    const ms = totalMs % 1000;
+    const totalSecs = Math.floor(totalMs / 1000);
+    const s = totalSecs % 60;
+    const totalMins = Math.floor(totalSecs / 60);
+    const m = totalMins % 60;
+    const h = Math.floor(totalMins / 60);
+    return (`${String(h).padStart(2, "0")}:` +
+        `${String(m).padStart(2, "0")}:` +
+        `${String(s).padStart(2, "0")},` +
+        `${String(ms).padStart(3, "0")}`);
+}
+/**
+ * Generate SRT subtitle string from a transcript.
+ * Uses segment-level timing (not word-level) per D4 decision.
+ * Returns empty string for transcripts with no segments.
+ */
+export function generateSrt(transcript) {
+    if (transcript.segments.length === 0) {
+        return "";
+    }
+    const entries = transcript.segments.map((segment, index) => {
+        const num = index + 1;
+        const start = formatSrtTimestamp(segment.start);
+        const end = formatSrtTimestamp(segment.end);
+        return `${num}\n${start} --> ${end}\n${segment.text}`;
+    });
+    return entries.join("\n\n") + "\n";
+}
+/**
+ * Read a corrected transcript JSON from disk, generate SRT, and write to file.
+ * Returns success/failure with descriptive message.
+ */
+export function exportSubtitles(transcriptPath, outputPath) {
+    try {
+        const raw = readFileSync(transcriptPath, "utf-8");
+        const transcript = JSON.parse(raw);
+        const srt = generateSrt(transcript);
+        writeFileSync(outputPath, srt, "utf-8");
+        const count = transcript.segments.length;
+        return {
+            success: true,
+            message: `Exported ${count} subtitle segments to ${outputPath}`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to export subtitles: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+const inputSchema = {
+    transcript_path: z
+        .string()
+        .describe("Path to the corrected transcript JSON file"),
+    output_path: z.string().describe("Output path for the SRT file"),
+};
+export function registerExportSubtitlesTool(server) {
+    server.registerTool("export_subtitles", {
+        title: "Export Subtitles",
+        description: "Exports a corrected transcript as an SRT subtitle file for YouTube upload. " +
+            "Reads the transcript JSON and writes a .srt file with segment-level timestamps.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, (args) => {
+        try {
+            const result = exportSubtitles(args.transcript_path, args.output_path);
+            logger.info("export_subtitles tool invoked", {
+                transcript_path: args.transcript_path,
+                output_path: args.output_path,
+                success: result.success,
+            });
+            if (!result.success) {
+                return {
+                    content: [{ type: "text", text: result.message }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: "text", text: result.message }],
+            };
+        }
+        catch (error) {
+            const message = `Failed to export subtitles: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("export_subtitles tool error", { error: message });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=export-subtitles.js.map

package/dist/tools/export-subtitles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-subtitles.js","sourceRoot":"","sources":["../../src/tools/export-subtitles.ts"],"names":[],"mappings":"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"}

package/dist/tools/export-subtitles.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=export-subtitles.test.d.ts.map

package/dist/tools/export-subtitles.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-subtitles.test.d.ts","sourceRoot":"","sources":["../../src/tools/export-subtitles.test.ts"],"names":[],"mappings":""}

package/dist/tools/export-subtitles.test.js

@@ -0,0 +1,152 @@
+import { vi, describe, it, expect, beforeEach } from "vitest";
+vi.mock("node:fs", () => ({
+    readFileSync: vi.fn(),
+    writeFileSync: vi.fn(),
+}));
+vi.mock("../logger.js", () => ({
+    logger: {
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+    },
+}));
+import { formatSrtTimestamp, generateSrt, exportSubtitles, } from "./export-subtitles.js";
+import { readFileSync, writeFileSync } from "node:fs";
+const mockReadFileSync = vi.mocked(readFileSync);
+const mockWriteFileSync = vi.mocked(writeFileSync);
+function makeTranscript(overrides) {
+    const segments = overrides?.segments ?? [
+        {
+            start: 0.0,
+            end: 5.0,
+            text: "Hello world",
+            words: [
+                {
+                    word: "Hello",
+                    start: 0.0,
+                    end: 0.5,
+                    score: 0.95,
+                    speaker: "SPEAKER_00",
+                },
+                {
+                    word: "world",
+                    start: 0.6,
+                    end: 1.0,
+                    score: 0.98,
+                    speaker: "SPEAKER_00",
+                },
+            ],
+            speaker: "SPEAKER_00",
+        },
+    ];
+    // Ensure all segments have words array
+    const normalizedSegments = segments.map((s) => ({
+        start: s.start,
+        end: s.end,
+        text: s.text,
+        words: s.words ?? [],
+        speaker: s.speaker ?? null,
+    }));
+    return {
+        version: "1.0",
+        language: "en",
+        segments: normalizedSegments,
+        chapters: [],
+        metadata: null,
+    };
+}
+describe("formatSrtTimestamp", () => {
+    it("formats zero seconds", () => {
+        expect(formatSrtTimestamp(0)).toBe("00:00:00,000");
+    });
+    it("formats fractional seconds with correct rounding", () => {
+        expect(formatSrtTimestamp(5.4)).toBe("00:00:05,400");
+    });
+    it("formats hours, minutes, seconds, and milliseconds", () => {
+        expect(formatSrtTimestamp(3723.15)).toBe("01:02:03,150");
+    });
+});
+describe("generateSrt", () => {
+    it("generates valid SRT from 2 segments", () => {
+        const transcript = makeTranscript({
+            segments: [
+                {
+                    start: 0.0,
+                    end: 5.0,
+                    text: "Hello world",
+                    words: [],
+                    speaker: null,
+                },
+                {
+                    start: 5.0,
+                    end: 10.5,
+                    text: "Second segment here",
+                    words: [],
+                    speaker: null,
+                },
+            ],
+        });
+        const srt = generateSrt(transcript);
+        // 1-based indices
+        expect(srt).toContain("1\n");
+        expect(srt).toContain("2\n");
+        // Comma-separated timestamps with --> separator
+        expect(srt).toContain("00:00:00,000 --> 00:00:05,000");
+        expect(srt).toContain("00:00:05,000 --> 00:00:10,500");
+        // Segment text
+        expect(srt).toContain("Hello world");
+        expect(srt).toContain("Second segment here");
+        // Entries separated by blank lines
+        const entries = srt.trim().split("\n\n");
+        expect(entries).toHaveLength(2);
+        // Trailing newline
+        expect(srt.endsWith("\n")).toBe(true);
+    });
+    it("returns empty string for 0 segments", () => {
+        const transcript = makeTranscript({ segments: [] });
+        expect(generateSrt(transcript)).toBe("");
+    });
+});
+describe("exportSubtitles", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("reads transcript, generates SRT, and writes file", () => {
+        const transcript = makeTranscript({
+            segments: [
+                {
+                    start: 0.0,
+                    end: 5.0,
+                    text: "Hello world",
+                    words: [],
+                    speaker: null,
+                },
+                {
+                    start: 5.0,
+                    end: 10.0,
+                    text: "Goodbye",
+                    words: [],
+                    speaker: null,
+                },
+            ],
+        });
+        mockReadFileSync.mockReturnValue(JSON.stringify(transcript));
+        const result = exportSubtitles("/in/transcript.json", "/out/subtitles.srt");
+        expect(result.success).toBe(true);
+        expect(result.message).toContain("2");
+        expect(result.message).toContain("/out/subtitles.srt");
+        expect(mockReadFileSync).toHaveBeenCalledWith("/in/transcript.json", "utf-8");
+        expect(mockWriteFileSync).toHaveBeenCalledWith("/out/subtitles.srt", expect.any(String), "utf-8");
+    });
+    it("returns success false when transcript file does not exist", () => {
+        mockReadFileSync.mockImplementation(() => {
+            throw new Error("ENOENT: no such file or directory");
+        });
+        const result = exportSubtitles("/missing/transcript.json", "/out/subtitles.srt");
+        expect(result.success).toBe(false);
+        expect(result.message).toMatch(/ENOENT|no such file/i);
+        expect(mockWriteFileSync).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=export-subtitles.test.js.map

package/dist/tools/export-subtitles.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-subtitles.test.js","sourceRoot":"","sources":["../../src/tools/export-subtitles.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/games.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGamesTool(server: McpServer): void;
+//# sourceMappingURL=games.d.ts.map

package/dist/tools/games.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"games.d.ts","sourceRoot":"","sources":["../../src/tools/games.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoDzD"}

package/dist/tools/games.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import { getGames } from "cfbd";
+import { cachedFetch } from "../cfbd-client.js";
+import { formatGames } from "../formatters/game-formatter.js";
+import { logger } from "../logger.js";
+// Schema defined separately for readability. Type assertion needed because
+// MCP SDK v1.27 resolves zod/v3 types from the hoisted zod v4 package,
+// which are structurally identical but nominally distinct from the local
+// zod v3 package's types. Runtime behavior is unaffected.
+const inputSchema = {
+    team: z
+        .string()
+        .describe("Team school name (e.g. 'Alabama', 'Ohio State', 'Texas A&M')"),
+    year: z.number().describe("Season year (e.g. 2024)"),
+    week: z
+        .number()
+        .optional()
+        .describe("Week number - omit for full season"),
+    seasonType: z
+        .enum(["regular", "postseason", "both"])
+        .optional()
+        .describe("Season type filter - defaults to 'both' for full picture"),
+};
+export function registerGamesTool(server) {
+    server.registerTool("cfbd_games", {
+        title: "Game Results",
+        description: "Look up college football game results by team and season. Returns scores, dates, venues, and Elo ratings.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, async (args) => {
+        const { team, year, week } = args;
+        const resolvedSeasonType = args.seasonType ?? "both";
+        try {
+            const games = await cachedFetch("getGames", { year, team, week, seasonType: resolvedSeasonType }, () => getGames({
+                query: { year, team, week, seasonType: resolvedSeasonType },
+            }));
+            const formatted = formatGames(games, team);
+            logger.info("cfbd_games tool invoked", {
+                team,
+                year,
+                week,
+                seasonType: resolvedSeasonType,
+                gameCount: games.length,
+            });
+            return {
+                content: [{ type: "text", text: formatted }],
+            };
+        }
+        catch (error) {
+            const message = `Failed to fetch games: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("cfbd_games tool error", {
+                team,
+                year,
+                week,
+                error: message,
+            });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=games.js.map

package/dist/tools/games.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"games.js","sourceRoot":"","sources":["../../src/tools/games.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAA8B,MAAM,MAAM,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,2EAA2E;AAC3E,uEAAuE;AACvE,yEAAyE;AACzE,0DAA0D;AAC1D,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,8DAA8D,CAC/D;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACpD,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;IACjD,UAAU,EAAE,CAAC;SACV,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;SACvC,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC;AASF,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,2GAA2G;QAC7G,8DAA8D;QAC9D,WAAW,EAAE,WAAkB;KAChC,EACD,KAAK,EAAE,IAAgB,EAAE,EAAE;QACzB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,kBAAkB,GAAe,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC;QAEjE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAC7B,UAAU,EACV,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAE,EACpD,GAAG,EAAE,CACH,QAAQ,CAAC;gBACP,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAE;aAC5D,CAAC,CACL,CAAC;YAEF,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;gBACrC,IAAI;gBACJ,IAAI;gBACJ,IAAI;gBACJ,UAAU,EAAE,kBAAkB;gBAC9B,SAAS,EAAE,KAAK,CAAC,MAAM;aACxB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnG,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACpC,IAAI;gBACJ,IAAI;gBACJ,IAAI;gBACJ,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/head-to-head.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerHeadToHeadTool(server: McpServer): void;
+//# sourceMappingURL=head-to-head.d.ts.map

package/dist/tools/head-to-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-to-head.d.ts","sourceRoot":"","sources":["../../src/tools/head-to-head.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoCzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoE9D"}

package/dist/tools/head-to-head.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { getMatchup } from "cfbd";
+import { cachedFetch } from "../cfbd-client.js";
+import { formatHeadToHead } from "../formatters/head-to-head-formatter.js";
+import { logger } from "../logger.js";
+// See games.ts for why `as any` is needed on inputSchema.
+const inputSchema = {
+    team1: z
+        .string()
+        .describe("First team school name (e.g. 'Alabama')"),
+    team2: z
+        .string()
+        .describe("Second team school name (e.g. 'Auburn')"),
+    startYear: z
+        .number()
+        .optional()
+        .describe("Start of year range filter (e.g. 2017) \u2014 omit for all-time series"),
+    endYear: z
+        .number()
+        .optional()
+        .describe("End of year range filter (e.g. 2024) \u2014 omit for all-time series"),
+};
+export function registerHeadToHeadTool(server) {
+    server.registerTool("cfbd_head_to_head", {
+        title: "Head-to-Head Matchup History",
+        description: "Get historical head-to-head series data between two teams. Shows all-time series record, last 10 and last 5 results, and venue breakdowns. Use startYear/endYear to scope to a coaching era or specific period.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, async (args) => {
+        const queryParams = {
+            team1: args.team1,
+            team2: args.team2,
+        };
+        if (args.startYear != null)
+            queryParams.minYear = args.startYear;
+        if (args.endYear != null)
+            queryParams.maxYear = args.endYear;
+        try {
+            const matchup = await cachedFetch("getMatchup", queryParams, () => getMatchup({
+                query: {
+                    team1: args.team1,
+                    team2: args.team2,
+                    minYear: args.startYear,
+                    maxYear: args.endYear,
+                },
+            }));
+            const hasYearRange = args.startYear != null || args.endYear != null;
+            const formatted = formatHeadToHead(matchup, args.team1, args.team2, hasYearRange);
+            logger.info("cfbd_head_to_head tool invoked", {
+                team1: args.team1,
+                team2: args.team2,
+                startYear: args.startYear,
+                endYear: args.endYear,
+                gameCount: matchup.games.length,
+            });
+            return {
+                content: [{ type: "text", text: formatted }],
+            };
+        }
+        catch (error) {
+            const message = `Failed to fetch head-to-head data: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("cfbd_head_to_head tool error", {
+                team1: args.team1,
+                team2: args.team2,
+                error: message,
+            });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=head-to-head.js.map

package/dist/tools/head-to-head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-to-head.js","sourceRoot":"","sources":["../../src/tools/head-to-head.ts"],"names":[],"mappings":"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"}

package/dist/tools/ratings.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRatingsTool(server: McpServer): void;
+//# sourceMappingURL=ratings.d.ts.map

package/dist/tools/ratings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratings.d.ts","sourceRoot":"","sources":["../../src/tools/ratings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgCzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+D3D"}

package/dist/tools/ratings.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { getSp, getSrs, getElo, getFpi, } from "cfbd";
+import { cachedFetch } from "../cfbd-client.js";
+import { formatRatings } from "../formatters/ratings-formatter.js";
+import { logger } from "../logger.js";
+// See games.ts for why `as any` is needed on inputSchema.
+const inputSchema = {
+    team: z
+        .string()
+        .describe("Team school name (e.g. 'Alabama', 'Ohio State')"),
+    year: z
+        .number()
+        .optional()
+        .describe("Season year (e.g. 2024) — defaults to current season"),
+};
+export function registerRatingsTool(server) {
+    server.registerTool("cfbd_ratings", {
+        title: "Team Ratings",
+        description: "Get multi-system ratings (SP+, SRS, Elo, FPI) for a team. Shows headline numbers: overall rating and ranking, offense/defense breakdowns where available. Use for comparing a team across rating systems or getting a comprehensive strength assessment.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, async (args) => {
+        const year = args.year ?? new Date().getFullYear();
+        try {
+            const [spAll, srsAll, eloAll, fpiAll] = await Promise.all([
+                cachedFetch("getSp", { year }, () => getSp({ query: { year } })),
+                cachedFetch("getSrs", { year, team: args.team }, () => getSrs({ query: { year, team: args.team } })),
+                cachedFetch("getElo", { year, team: args.team }, () => getElo({ query: { year, team: args.team } })),
+                cachedFetch("getFpi", { year, team: args.team }, () => getFpi({ query: { year, team: args.team } })),
+            ]);
+            const teamLower = args.team.toLowerCase();
+            const sp = spAll.find((r) => r.team.toLowerCase() === teamLower);
+            const srs = srsAll.find((r) => r.team.toLowerCase() === teamLower);
+            const elo = eloAll.find((r) => r.team.toLowerCase() === teamLower);
+            const fpi = fpiAll.find((r) => r.team.toLowerCase() === teamLower);
+            const formatted = formatRatings(sp, srs, elo, fpi, args.team, year);
+            logger.info("cfbd_ratings tool invoked", {
+                team: args.team,
+                year,
+                hasSp: !!sp,
+                hasSrs: !!srs,
+                hasElo: !!elo,
+                hasFpi: !!fpi,
+            });
+            return {
+                content: [{ type: "text", text: formatted }],
+            };
+        }
+        catch (error) {
+            const message = `Failed to fetch team ratings: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("cfbd_ratings tool error", {
+                team: args.team,
+                year,
+                error: message,
+            });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=ratings.js.map

package/dist/tools/ratings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratings.js","sourceRoot":"","sources":["../../src/tools/ratings.ts"],"names":[],"mappings":"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"}

package/dist/tools/read-transcript.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Transcript } from "./transcript-types.js";
+/**
+ * Read a transcript JSON file from disk and validate its structure.
+ * Exported separately from the MCP registration for direct testing.
+ */
+export declare function readTranscript(filePath: string): Transcript;
+export declare function registerReadTranscriptTool(server: McpServer): void;
+//# sourceMappingURL=read-transcript.d.ts.map

package/dist/tools/read-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-transcript.d.ts","sourceRoot":"","sources":["../../src/tools/read-transcript.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQxD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CA4B3D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqClE"}

package/dist/tools/read-transcript.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { readFileSync } from "node:fs";
+import { logger } from "../logger.js";
+const inputSchema = {
+    file_path: z
+        .string()
+        .describe("Absolute path to the transcript JSON file"),
+};
+/**
+ * Read a transcript JSON file from disk and validate its structure.
+ * Exported separately from the MCP registration for direct testing.
+ */
+export function readTranscript(filePath) {
+    let raw;
+    try {
+        raw = readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            throw new Error(`Transcript file not found: ${filePath}`);
+        }
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid JSON in transcript file: ${filePath}`);
+    }
+    const transcript = parsed;
+    if (transcript.version !== "1.0") {
+        throw new Error(`Unsupported transcript version "${transcript.version}" (expected "1.0")`);
+    }
+    return transcript;
+}
+export function registerReadTranscriptTool(server) {
+    server.registerTool("read_transcript", {
+        title: "Read Transcript",
+        description: "Reads a transcript JSON file from disk and returns its content. " +
+            "Validates the transcript version is 1.0. Use this to load a transcript " +
+            "before starting proper noun correction.",
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        inputSchema: inputSchema,
+    }, (args) => {
+        try {
+            const transcript = readTranscript(args.file_path);
+            logger.info("read_transcript tool invoked", {
+                file_path: args.file_path,
+                segments: transcript.segments.length,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(transcript, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = `Failed to read transcript: ${error instanceof Error ? error.message : String(error)}`;
+            logger.error("read_transcript tool error", { error: message });
+            return {
+                content: [{ type: "text", text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=read-transcript.js.map

package/dist/tools/read-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-transcript.js","sourceRoot":"","sources":["../../src/tools/read-transcript.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,MAAM,WAAW,GAAG;IAClB,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,2CAA2C,CAAC;CACzD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;QAC7C,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,UAAU,GAAG,MAAoB,CAAC;IAExC,IAAI,UAAU,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,mCAAmC,UAAU,CAAC,OAAO,oBAAoB,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,kEAAkE;YAClE,yEAAyE;YACzE,yCAAyC;QAC3C,8DAA8D;QAC9D,WAAW,EAAE,WAAkB;KAChC,EACD,CAAC,IAA2B,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC1C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;aACrC,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC1C;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvG,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/read-transcript.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=read-transcript.test.d.ts.map

package/dist/tools/read-transcript.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-transcript.test.d.ts","sourceRoot":"","sources":["../../src/tools/read-transcript.test.ts"],"names":[],"mappings":""}