@ankimcp/anki-mcp-server 0.11.0 → 0.12.1

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.tool.js

@@ -0,0 +1,165 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var DeckStatsTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeckStatsTool = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_nest_1 = require("@rekog/mcp-nest");
+const zod_1 = require("zod");
+const anki_connect_client_1 = require("../../../../clients/anki-connect.client");
+const anki_utils_1 = require("../../../../utils/anki.utils");
+const stats_utils_1 = require("../../../../utils/stats.utils");
+let DeckStatsTool = DeckStatsTool_1 = class DeckStatsTool {
+    ankiClient;
+    logger = new common_1.Logger(DeckStatsTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async execute(params, context) {
+        try {
+            const { deck, ease_buckets = [2.0, 2.5, 3.0], interval_buckets = [7, 21, 90], } = params;
+            this.logger.log(`Getting statistics for deck: ${deck}`);
+            await context.reportProgress({ progress: 10, total: 100 });
+            this.logger.log("Fetching deck statistics...");
+            const deckStatsResponse = await this.ankiClient.invoke("getDeckStats", {
+                decks: [deck],
+            });
+            if (!deckStatsResponse || Object.keys(deckStatsResponse).length === 0) {
+                throw new Error(`Deck "${deck}" not found`);
+            }
+            const deckStatsArray = Object.values(deckStatsResponse);
+            const deckStats = deckStatsArray.find((s) => s.name === deck);
+            if (!deckStats) {
+                throw new Error(`Deck "${deck}" not found in statistics response`);
+            }
+            const counts = {
+                total: deckStats.total_in_deck || 0,
+                new: deckStats.new_count || 0,
+                learning: deckStats.learn_count || 0,
+                review: deckStats.review_count || 0,
+            };
+            await context.reportProgress({ progress: 30, total: 100 });
+            if (counts.total === 0) {
+                this.logger.log(`Deck "${deck}" is empty`);
+                const result = {
+                    deck,
+                    counts,
+                    ease: (0, stats_utils_1.computeDistribution)([], { boundaries: ease_buckets }),
+                    intervals: (0, stats_utils_1.computeDistribution)([], {
+                        boundaries: interval_buckets,
+                        unitSuffix: "d",
+                    }),
+                };
+                await context.reportProgress({ progress: 100, total: 100 });
+                return (0, anki_utils_1.createSuccessResponse)(result);
+            }
+            this.logger.log("Finding cards in deck...");
+            const escapedDeckName = deck.replace(/"/g, '\\"');
+            const cardIds = await this.ankiClient.invoke("findCards", {
+                query: `"deck:${escapedDeckName}"`,
+            });
+            if (!cardIds || cardIds.length === 0) {
+                this.logger.warn(`No cards found via findCards for deck "${deck}", using counts from getDeckStats`);
+                const result = {
+                    deck,
+                    counts,
+                    ease: (0, stats_utils_1.computeDistribution)([], { boundaries: ease_buckets }),
+                    intervals: (0, stats_utils_1.computeDistribution)([], {
+                        boundaries: interval_buckets,
+                        unitSuffix: "d",
+                    }),
+                };
+                await context.reportProgress({ progress: 100, total: 100 });
+                return (0, anki_utils_1.createSuccessResponse)(result);
+            }
+            await context.reportProgress({ progress: 50, total: 100 });
+            this.logger.log(`Fetching ease factors for ${cardIds.length} cards...`);
+            const easeFactorsRaw = await this.ankiClient.invoke("getEaseFactors", {
+                cards: cardIds,
+            });
+            const easeValues = easeFactorsRaw
+                .map((e) => e / 1000)
+                .filter((e) => e > 0);
+            await context.reportProgress({ progress: 70, total: 100 });
+            this.logger.log(`Fetching intervals for ${cardIds.length} cards...`);
+            const intervalsRaw = await this.ankiClient.invoke("getIntervals", {
+                cards: cardIds,
+            });
+            const intervalValues = intervalsRaw.filter((i) => i > 0);
+            await context.reportProgress({ progress: 90, total: 100 });
+            this.logger.log("Computing distributions...");
+            const ease = (0, stats_utils_1.computeDistribution)(easeValues, {
+                boundaries: ease_buckets,
+            });
+            const intervals = (0, stats_utils_1.computeDistribution)(intervalValues, {
+                boundaries: interval_buckets,
+                unitSuffix: "d",
+            });
+            const result = {
+                deck,
+                counts,
+                ease,
+                intervals,
+            };
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Successfully retrieved statistics for deck "${deck}": ${counts.total} total cards, ` +
+                `${ease.count} cards with ease values, ${intervals.count} review cards`);
+            return (0, anki_utils_1.createSuccessResponse)(result);
+        }
+        catch (error) {
+            this.logger.error(`Failed to get deck statistics`, error);
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                hint: "Make sure Anki is running and the deck name is correct. Use list_decks to see available decks.",
+            });
+        }
+    }
+};
+exports.DeckStatsTool = DeckStatsTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "deck_stats",
+        description: "Get comprehensive statistics for a single deck including card counts, ease factor distribution, and interval distribution. " +
+            "Use this to analyze deck health, identify struggling cards (low ease), or understand review scheduling patterns. " +
+            "Ease buckets and interval buckets can be customized to focus on specific ranges.",
+        parameters: zod_1.z.object({
+            deck: zod_1.z
+                .string()
+                .min(1)
+                .describe("Deck name to get statistics for (e.g., 'Japanese::JLPT N5')"),
+            ease_buckets: zod_1.z
+                .array(zod_1.z.number().positive())
+                .optional()
+                .default([2.0, 2.5, 3.0])
+                .refine((arr) => arr.length === 0 || arr.every((v, i, a) => i === 0 || v > a[i - 1]), {
+                message: "Bucket boundaries must be in ascending order",
+            })
+                .describe("Bucket boundaries for ease factor distribution. Default: [2.0, 2.5, 3.0]. " +
+                "Example: [2.0, 2.5, 3.0] creates buckets: <2.0, 2.0-2.5, 2.5-3.0, >3.0"),
+            interval_buckets: zod_1.z
+                .array(zod_1.z.number().positive())
+                .optional()
+                .default([7, 21, 90])
+                .refine((arr) => arr.length === 0 || arr.every((v, i, a) => i === 0 || v > a[i - 1]), {
+                message: "Bucket boundaries must be in ascending order",
+            })
+                .describe("Bucket boundaries for interval distribution in days. Default: [7, 21, 90]. " +
+                "Example: [7, 21, 90] creates buckets: <7d, 7-21d, 21-90d, >90d"),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], DeckStatsTool.prototype, "execute", null);
+exports.DeckStatsTool = DeckStatsTool = DeckStatsTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], DeckStatsTool);
+//# sourceMappingURL=deck-stats.tool.js.map

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.tool.js.map

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

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.types.d.ts

@@ -0,0 +1,25 @@
+import { DistributionMetrics } from "@/mcp/utils/stats.utils";
+export interface AnkiDeckStatsResponse {
+    deck_id: number;
+    name: string;
+    new_count: number;
+    learn_count: number;
+    review_count: number;
+    total_in_deck: number;
+}
+export interface DeckStatsParams {
+    deck: string;
+    ease_buckets?: number[];
+    interval_buckets?: number[];
+}
+export interface DeckStatsResult {
+    deck: string;
+    counts: {
+        total: number;
+        new: number;
+        learning: number;
+        review: number;
+    };
+    ease: DistributionMetrics;
+    intervals: DistributionMetrics;
+}

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=deck-stats.types.js.map

package/dist/mcp/primitives/essential/tools/deck-stats/deck-stats.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deck-stats.types.js","sourceRoot":"","sources":["../../../../../../src/mcp/primitives/essential/tools/deck-stats/deck-stats.types.ts"],"names":[],"mappings":""}

package/dist/mcp/primitives/essential/tools/deck-stats/index.d.ts

@@ -0,0 +1,2 @@
+export { DeckStatsTool } from "./deck-stats.tool";
+export type { DeckStatsParams, DeckStatsResult } from "./deck-stats.types";

package/dist/mcp/primitives/essential/tools/deck-stats/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeckStatsTool = void 0;
+var deck_stats_tool_1 = require("./deck-stats.tool");
+Object.defineProperty(exports, "DeckStatsTool", { enumerable: true, get: function () { return deck_stats_tool_1.DeckStatsTool; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/primitives/essential/tools/deck-stats/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/mcp/primitives/essential/tools/deck-stats/index.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAAzC,gHAAA,aAAa,OAAA"}

package/dist/mcp/primitives/essential/tools/review-stats/index.d.ts

@@ -0,0 +1,2 @@
+export { ReviewStatsTool } from "./review-stats.tool";
+export type { ReviewStatsParams, ReviewStatsResult, } from "./review-stats.types";

package/dist/mcp/primitives/essential/tools/review-stats/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewStatsTool = void 0;
+var review_stats_tool_1 = require("./review-stats.tool");
+Object.defineProperty(exports, "ReviewStatsTool", { enumerable: true, get: function () { return review_stats_tool_1.ReviewStatsTool; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/primitives/essential/tools/review-stats/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/mcp/primitives/essential/tools/review-stats/index.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAA7C,oHAAA,eAAe,OAAA"}

package/dist/mcp/primitives/essential/tools/review-stats/review-stats.tool.d.ts

@@ -0,0 +1,108 @@
+import type { Context } from "@rekog/mcp-nest";
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export declare class ReviewStatsTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    execute(params: {
+        deck: string;
+        start_date: string;
+        end_date?: string;
+    }, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        } | {
+            type: "resource";
+            resource: {
+                uri: string;
+                text: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                uri: string;
+                blob: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+    private getTodayISO;
+}

package/dist/mcp/primitives/essential/tools/review-stats/review-stats.tool.js

@@ -0,0 +1,149 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var ReviewStatsTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewStatsTool = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_nest_1 = require("@rekog/mcp-nest");
+const zod_1 = require("zod");
+const anki_connect_client_1 = require("../../../../clients/anki-connect.client");
+const anki_utils_1 = require("../../../../utils/anki.utils");
+const stats_utils_1 = require("../../../../utils/stats.utils");
+const MS_PER_DAY = 86400000;
+let ReviewStatsTool = ReviewStatsTool_1 = class ReviewStatsTool {
+    ankiClient;
+    logger = new common_1.Logger(ReviewStatsTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async execute(params, context) {
+        try {
+            const { deck, start_date } = params;
+            const end_date = params.end_date || this.getTodayISO();
+            this.logger.log(`Getting review statistics from ${start_date} to ${end_date} for deck: ${deck}`);
+            await context.reportProgress({ progress: 10, total: 100 });
+            const startTimestamp = new Date(start_date).getTime();
+            const endTimestamp = new Date(end_date).getTime() + MS_PER_DAY;
+            this.logger.log(`Fetching detailed review data for deck: ${deck}...`);
+            const reviews = await this.ankiClient.invoke("cardReviews", {
+                startID: startTimestamp,
+                deck: deck,
+            });
+            await context.reportProgress({ progress: 40, total: 100 });
+            const filteredReviews = reviews.filter((review) => review[0] <= endTimestamp);
+            this.logger.log("Calculating daily review counts from reviews...");
+            const reviewsByDayMap = new Map();
+            for (const review of filteredReviews) {
+                const date = new Date(review[0]).toISOString().split("T")[0];
+                reviewsByDayMap.set(date, (reviewsByDayMap.get(date) ?? 0) + 1);
+            }
+            const reviewsByDay = Array.from(reviewsByDayMap.entries())
+                .map(([date, count]) => ({ date, count }))
+                .sort((a, b) => a.date.localeCompare(b.date));
+            await context.reportProgress({ progress: 60, total: 100 });
+            const buttonPresses = filteredReviews.map((review) => review[3]);
+            this.logger.log("Computing retention metrics...");
+            const retention = (0, stats_utils_1.computeRetention)(buttonPresses);
+            await context.reportProgress({ progress: 80, total: 100 });
+            this.logger.log("Calculating summary statistics...");
+            const totalReviews = reviewsByDay.reduce((sum, r) => sum + r.count, 0);
+            const daysStudied = reviewsByDay.filter((r) => r.count > 0).length;
+            const averagePerDay = reviewsByDay.length > 0 ? totalReviews / reviewsByDay.length : 0;
+            const nonZeroDays = reviewsByDay.filter((r) => r.count > 0);
+            const maxDay = nonZeroDays.length > 0
+                ? nonZeroDays.reduce((max, r) => (r.count > max.count ? r : max))
+                : null;
+            const minDay = nonZeroDays.length > 0
+                ? nonZeroDays.reduce((min, r) => (r.count < min.count ? r : min))
+                : null;
+            const streak = (0, stats_utils_1.calculateStreak)(reviewsByDay);
+            await context.reportProgress({ progress: 90, total: 100 });
+            const result = {
+                period: {
+                    start: start_date,
+                    end: end_date,
+                },
+                deck: deck,
+                reviews_by_day: reviewsByDay,
+                summary: {
+                    total_reviews: totalReviews,
+                    average_per_day: averagePerDay,
+                    days_studied: daysStudied,
+                    max_day: maxDay,
+                    min_day: minDay,
+                    streak,
+                },
+                retention,
+            };
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Successfully retrieved review statistics: ${totalReviews} total reviews, ` +
+                `${daysStudied} days studied, ${(retention.overall * 100).toFixed(1)}% retention, ` +
+                `${streak} day streak`);
+            return (0, anki_utils_1.createSuccessResponse)(result);
+        }
+        catch (error) {
+            this.logger.error(`Failed to get review statistics`, error);
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                hint: "Make sure Anki is running and date format is YYYY-MM-DD. Use list_decks to verify deck name if filtering by deck.",
+            });
+        }
+    }
+    getTodayISO() {
+        const today = new Date();
+        return today.toISOString().split("T")[0];
+    }
+};
+exports.ReviewStatsTool = ReviewStatsTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "review_stats",
+        description: "Get review history analysis including temporal patterns, retention metrics, and study streak information. " +
+            "Use this to analyze learning progress over time, identify review patterns, and track consistency. " +
+            "Requires a start date and deck name; end date defaults to today.",
+        parameters: zod_1.z
+            .object({
+            deck: zod_1.z
+                .string()
+                .describe("Deck name to filter reviews (REQUIRED - AnkiConnect API requires a deck)"),
+            start_date: zod_1.z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/, "Must be ISO date format: YYYY-MM-DD")
+                .refine((date) => !isNaN(Date.parse(date)), {
+                message: "Must be a valid date",
+            })
+                .describe("Start date for analysis (ISO format: YYYY-MM-DD) - REQUIRED"),
+            end_date: zod_1.z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/, "Must be ISO date format: YYYY-MM-DD")
+                .refine((date) => !isNaN(Date.parse(date)), {
+                message: "Must be a valid date",
+            })
+                .optional()
+                .describe("End date (defaults to today)"),
+        })
+            .refine((data) => {
+            if (!data.end_date)
+                return true;
+            return new Date(data.start_date) <= new Date(data.end_date);
+        }, {
+            message: "start_date must be less than or equal to end_date",
+            path: ["start_date"],
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], ReviewStatsTool.prototype, "execute", null);
+exports.ReviewStatsTool = ReviewStatsTool = ReviewStatsTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], ReviewStatsTool);
+//# sourceMappingURL=review-stats.tool.js.map

package/dist/mcp/primitives/essential/tools/review-stats/review-stats.tool.js.map

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

package/dist/mcp/primitives/essential/tools/review-stats/review-stats.types.d.ts

@@ -0,0 +1,47 @@
+import { RetentionMetrics } from "@/mcp/utils/stats.utils";
+export interface ReviewStatsParams {
+    deck?: string;
+    start_date: string;
+    end_date?: string;
+}
+export interface CardReviewsParams {
+    startID: number;
+    deck?: string;
+}
+export type CardReviewTuple = [
+    timestamp: number,
+    cardId: number,
+    usn: number,
+    buttonPressed: number,
+    newInterval: number,
+    previousInterval: number,
+    ease: number,
+    timeTaken: number,
+    reviewType: number
+];
+export interface ReviewStatsResult {
+    period: {
+        start: string;
+        end: string;
+    };
+    deck: string;
+    reviews_by_day: Array<{
+        date: string;
+        count: number;
+    }>;
+    summary: {
+        total_reviews: number;
+        average_per_day: number;
+        days_studied: number;
+        max_day: {
+            date: string;
+            count: number;
+        } | null;
+        min_day: {
+            date: string;
+            count: number;
+        } | null;
+        streak: number;
+    };
+    retention: RetentionMetrics;
+}

package/dist/mcp/primitives/essential/tools/review-stats/review-stats.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=review-stats.types.js.map

package/dist/mcp/primitives/essential/tools/review-stats/review-stats.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-stats.types.js","sourceRoot":"","sources":["../../../../../../src/mcp/primitives/essential/tools/review-stats/review-stats.types.ts"],"names":[],"mappings":""}

package/dist/mcp/utils/stats.utils.d.ts

@@ -0,0 +1,28 @@
+export interface DistributionMetrics {
+    mean: number;
+    median: number;
+    min: number;
+    max: number;
+    count: number;
+    buckets: Record<string, number>;
+}
+export interface BucketConfig {
+    boundaries: number[];
+    formatLabel?: (lower: number | null, upper: number | null) => string;
+    unitSuffix?: string;
+}
+export interface RetentionMetrics {
+    overall: number;
+    by_rating: {
+        again: number;
+        hard: number;
+        good: number;
+        easy: number;
+    };
+}
+export declare function computeDistribution(values: number[], config: BucketConfig): DistributionMetrics;
+export declare function computeRetention(buttonPresses: number[]): RetentionMetrics;
+export declare function calculateStreak(reviewsByDay: Array<{
+    date: string;
+    count: number;
+}>): number;