ani-mcp 0.15.0 → 0.15.2

package/dist/api/client.js

@@ -249,7 +249,7 @@ export function warmCache() {
     const username = process.env.ANILIST_USERNAME;
     if (!username)
         return;
-    log("cache-warm", username);
+    log("cache-warm", "starting cache warm for default user");
     // Fire and forget - don't block startup
     Promise.all([
         anilistClient.fetchList(username, "ANIME"),

package/dist/constants.d.ts

@@ -0,0 +1,21 @@
+/** Tuning constants used across multiple engine modules */
+export declare const MAX_UNDO = 20;
+export declare const MAX_TAGS = 20;
+export declare const MIN_TAG_COUNT = 3;
+export declare const BAYESIAN_PRIOR_WEIGHT = 0.5;
+export declare const BAYESIAN_PRIOR_COUNT = 3;
+export declare const MAX_DEPTH = 30;
+export declare const CARD_WIDTH = 800;
+export declare const CARD_HEIGHT = 560;
+export declare const COMPAT_CARD_HEIGHT = 640;
+export declare const MATCHER_GENRE_WEIGHT = 0.5;
+export declare const MATCHER_TAG_WEIGHT = 0.3;
+export declare const MATCHER_COMMUNITY_WEIGHT = 0.2;
+export declare const MOOD_BOOST = 1.3;
+export declare const MOOD_PENALTY = 0.6;
+export declare const MIN_COMMUNITY_SCORE = 50;
+export declare const POPULARITY_PENALTY_MAX = 0.15;
+export declare const POPULARITY_CEILING = 100000;
+export declare const SIMILAR_GENRE_WEIGHT = 0.4;
+export declare const SIMILAR_TAG_WEIGHT = 0.3;
+export declare const SIMILAR_REC_WEIGHT = 0.3;

package/dist/constants.js

@@ -0,0 +1,43 @@
+/** Tuning constants used across multiple engine modules */
+// === Undo ===
+// Max undo records kept in the session stack
+export const MAX_UNDO = 20;
+// === Taste Profile ===
+// Max tags returned in a taste profile to keep output focused
+export const MAX_TAGS = 20;
+// Tags must appear in at least this many entries to rank
+export const MIN_TAG_COUNT = 3;
+// Bayesian smoothing: pull sparse genre/tag observations toward neutral
+// prior_weight blends prior with observed; prior_count is the pseudocount threshold
+export const BAYESIAN_PRIOR_WEIGHT = 0.5;
+export const BAYESIAN_PRIOR_COUNT = 3;
+// === Franchise ===
+// Max BFS depth to prevent runaway traversal on deeply linked franchises
+export const MAX_DEPTH = 30;
+// === Card Dimensions ===
+// 800x560 fits social media previews (roughly 10:7 aspect ratio)
+export const CARD_WIDTH = 800;
+export const CARD_HEIGHT = 560;
+export const COMPAT_CARD_HEIGHT = 640;
+// === Matcher Weights ===
+// Personal taste matcher (anilist_pick, anilist_explain):
+// genre dominates because users identify most strongly with genre preferences,
+// tags refine within genre, community score guards against niche low-quality titles
+export const MATCHER_GENRE_WEIGHT = 0.5;
+export const MATCHER_TAG_WEIGHT = 0.3;
+export const MATCHER_COMMUNITY_WEIGHT = 0.2;
+// Mood boost/penalty as a multiplier on the final score
+export const MOOD_BOOST = 1.3;
+export const MOOD_PENALTY = 0.6;
+// Minimum community score (out of 100) to avoid poorly-rated titles
+export const MIN_COMMUNITY_SCORE = 50;
+// Diversity nudge: log-scale penalty for very popular titles (max 15%)
+export const POPULARITY_PENALTY_MAX = 0.15;
+export const POPULARITY_CEILING = 100_000;
+// === Similar Weights ===
+// Content similarity matcher (anilist_similar):
+// genre and tag overlap are equally important for content matching,
+// community recs provide a collaborative-filtering signal as a tiebreaker
+export const SIMILAR_GENRE_WEIGHT = 0.4;
+export const SIMILAR_TAG_WEIGHT = 0.3;
+export const SIMILAR_REC_WEIGHT = 0.3;

package/dist/engine/card.js

@@ -1,9 +1,15 @@
 /** Generates shareable SVG cards for taste profiles, compatibility, and year-in-review */
 import sharp from "sharp";
+import { CARD_WIDTH, CARD_HEIGHT, COMPAT_CARD_HEIGHT } from "../constants.js";
+// === Logging ===
+const DEBUG = process.env.DEBUG === "true" || process.env.DEBUG === "1";
+function log(event, detail) {
+    if (!DEBUG)
+        return;
+    const msg = detail ? `[ani-mcp] ${event}: ${detail}` : `[ani-mcp] ${event}`;
+    console.error(msg);
+}
 // === Constants ===
-const CARD_WIDTH = 800;
-const CARD_HEIGHT = 560;
-const COMPAT_CARD_HEIGHT = 640;
 // Brand palette (from assets/icon.svg)
 const BRAND_BLUE = "#02A9FF";
 const BRAND_BLUE_DARK = "#0284C7";
@@ -34,7 +40,8 @@ export async function fetchAvatarB64(url) {
         const contentType = res.headers.get("content-type") ?? "image/jpeg";
         return `data:${contentType};base64,${buf.toString("base64")}`;
     }
-    catch {
+    catch (err) {
+        log("avatar fetch failed", err instanceof Error ? err.message : String(err));
         return null;
     }
 }

package/dist/engine/franchise.js

@@ -1,8 +1,7 @@
 /** Franchise graph traversal for watch order guidance. */
+import { MAX_DEPTH } from "../constants.js";
 // Main formats in a franchise timeline
 const MAIN_FORMATS = new Set(["TV", "MOVIE", "ONA", "TV_SHORT"]);
-// Max BFS depth to prevent runaway traversal
-const MAX_DEPTH = 30;
 /** Find the earliest entry by following PREQUEL edges backward */
 function findRoot(startId, relationsMap) {
     let current = startId;

package/dist/engine/matcher.js

@@ -1,17 +1,5 @@
 /** Scores candidate media against a taste profile with natural-language explanations */
-// === Constants ===
-// How much each signal contributes to the final score
-const GENRE_WEIGHT = 0.5;
-const TAG_WEIGHT = 0.3;
-const COMMUNITY_WEIGHT = 0.2;
-// Mood boost/penalty as a multiplier on the final score
-const MOOD_BOOST = 1.3;
-const MOOD_PENALTY = 0.6;
-// Minimum community score (out of 100) to avoid recommending poorly-rated titles
-const MIN_COMMUNITY_SCORE = 50;
-// Diversity nudge: log-scale penalty for very popular titles (max 15%)
-const POPULARITY_PENALTY_MAX = 0.15;
-const POPULARITY_CEILING = 100_000;
+import { MATCHER_GENRE_WEIGHT as GENRE_WEIGHT, MATCHER_TAG_WEIGHT as TAG_WEIGHT, MATCHER_COMMUNITY_WEIGHT as COMMUNITY_WEIGHT, MOOD_BOOST, MOOD_PENALTY, MIN_COMMUNITY_SCORE, POPULARITY_PENALTY_MAX, POPULARITY_CEILING, } from "../constants.js";
 // === Matcher ===
 /** Score and rank candidates against a user's taste profile */
 export function matchCandidates(candidates, profile, mood) {

package/dist/engine/similar.js

@@ -1,8 +1,9 @@
 /** Ranks candidates by content similarity to a source title */
-// === Constants ===
-const GENRE_WEIGHT = 0.4;
-const TAG_WEIGHT = 0.3;
-const REC_WEIGHT = 0.3;
+import { SIMILAR_GENRE_WEIGHT as GENRE_WEIGHT, SIMILAR_TAG_WEIGHT as TAG_WEIGHT, SIMILAR_REC_WEIGHT as REC_WEIGHT, } from "../constants.js";
+// Non-spoiler tag names from a media entry
+function tagNames(media) {
+    return new Set(media.tags.filter((t) => !t.isMediaSpoiler).map((t) => t.name));
+}
 // === Similarity Engine ===
 /** Rank candidates by genre/tag overlap and community recommendation strength */
 export function rankSimilar(source, candidates, recRatings) {
@@ -11,7 +12,7 @@ export function rankSimilar(source, candidates, recRatings) {
     // Normalize rec ratings to 0-1
     const maxRating = Math.max(1, ...recRatings.values());
     const sourceGenres = new Set(source.genres);
-    const sourceTags = new Set(source.tags.filter((t) => !t.isMediaSpoiler).map((t) => t.name));
+    const sourceTags = tagNames(source);
     const results = [];
     for (const candidate of candidates) {
         const reasons = [];
@@ -24,7 +25,7 @@ export function rankSimilar(source, candidates, recRatings) {
             reasons.push(`Shares genres: ${genreIntersection.join(", ")}`);
         }
         // Tag overlap: Jaccard on non-spoiler tags
-        const candidateTags = new Set(candidate.tags.filter((t) => !t.isMediaSpoiler).map((t) => t.name));
+        const candidateTags = tagNames(candidate);
         const tagIntersection = [...sourceTags].filter((t) => candidateTags.has(t));
         const tagUnion = new Set([...sourceTags, ...candidateTags]);
         const tagOverlap = tagUnion.size > 0 ? tagIntersection.length / tagUnion.size : 0;

package/dist/engine/taste.js

@@ -1,4 +1,5 @@
 /** Builds a weighted taste profile from a user's scored anime/manga list */
+import { MAX_TAGS, MIN_TAG_COUNT, BAYESIAN_PRIOR_WEIGHT, BAYESIAN_PRIOR_COUNT, } from "../constants.js";
 import { dateToEpoch } from "../utils.js";
 // === Constants ===
 // AniList community mean hovers around 7.0-7.2
@@ -7,16 +8,9 @@ const SITE_MEAN = 7.0;
 const MIN_ENTRIES = 5;
 // Entries scored 0 are unscored on AniList (not a real 0/10)
 const UNSCORED = 0;
-// Cap the number of tags returned to keep output focused
-const MAX_TAGS = 20;
-// Tags must appear in at least this many entries to rank
-const MIN_TAG_COUNT = 3;
 // Recency decay: entries from HALF_LIFE years ago get ~50% weight
 const DECAY_HALF_LIFE_YEARS = 3;
 const DECAY_LAMBDA = Math.LN2 / DECAY_HALF_LIFE_YEARS;
-// Bayesian smoothing: pull sparse observations toward a neutral prior
-const BAYESIAN_PRIOR_WEIGHT = 0.5;
-const BAYESIAN_PRIOR_COUNT = 3;
 // === Profile Builder ===
 /** Build a taste profile from scored list entries */
 export function buildTasteProfile(entries) {

package/dist/engine/undo.js

@@ -1,6 +1,6 @@
 /** Session-scoped undo stack for write operations. */
+import { MAX_UNDO } from "../constants.js";
 // === Stack ===
-const MAX_UNDO = 20;
 const stack = [];
 /** Push a record onto the undo stack, trimming oldest if full */
 export function pushUndo(record) {

package/dist/index.js

@@ -36,7 +36,7 @@ if (!process.env.ANILIST_TOKEN) {
 }
 const server = new FastMCP({
     name: "ani-mcp",
-    version: "0.15.0",
+    version: "0.15.2",
     instructions: "ani-mcp is a local MCP server for AniList. " +
         "Read-only tools work without authentication. " +
         "Write tools require ANILIST_TOKEN set in the server's environment config. " +

package/dist/resources.js

@@ -1,10 +1,16 @@
 /** MCP Resources: expose user context without tool calls */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { anilistClient } from "./api/client.js";
 import { USER_PROFILE_QUERY } from "./api/queries.js";
 import { buildTasteProfile, describeTasteProfile, formatTasteProfileText, } from "./engine/taste.js";
 import { formatProfile } from "./tools/social.js";
 import { formatListEntry } from "./tools/lists.js";
 import { getDefaultUsername, getScoreFormat } from "./utils.js";
+// Read version from package.json at startup
+const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+const PKG_VERSION = JSON.parse(readFileSync(pkgPath, "utf-8")).version;
 /** Register MCP resources on the server */
 export function registerResources(server) {
     // === User Profile ===
@@ -100,7 +106,7 @@ export function registerResources(server) {
         async load() {
             const lines = ["# ani-mcp Status", ""];
             // Server version
-            lines.push(`Version: 0.14.0`);
+            lines.push(`Version: ${PKG_VERSION}`);
             // Auth status
             const hasToken = Boolean(process.env.ANILIST_TOKEN);
             const hasUsername = Boolean(process.env.ANILIST_USERNAME);

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.3",
   "name": "ani-mcp",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "display_name": "AniList MCP",
   "description": "A smart MCP server for AniList that gets your anime/manga taste - not just API calls.",
   "author": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ani-mcp",
   "mcpName": "io.github.gavxm/ani-mcp",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "A smart [MCP](https://modelcontextprotocol.io) server for [AniList](https://anilist.co) that gets your anime/manga taste - not just API calls.",
   "type": "module",
   "main": "dist/index.js",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/gavxm/ani-mcp",
     "source": "github"
   },
-  "version": "0.15.0",
+  "version": "0.15.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "ani-mcp",
-      "version": "0.15.0",
+      "version": "0.15.2",
       "transport": {
         "type": "stdio"
       },