jev-chess 1.0.0

package/dist/classicMatches.js

@@ -0,0 +1,223 @@
+import { choice, getTypeSafeClient, noul, score } from "./typeSafeClient.js";
+export const CLASSIC_MATCHES = [
+    {
+        id: "immortal-game",
+        title: "The Immortal Game",
+        white: "Adolf Anderssen",
+        black: "Lionel Kieseritzky",
+        year: 1851,
+        event: "London (Casual match during 1st International Tournament)",
+        result: "1-0",
+        eco: "C33",
+        opening: "King's Gambit Accepted",
+        description: "Anderssen gave up both rooks and a bishop, followed by his queen, delivering checkmate with his three remaining minor pieces.",
+        keyMoveIndex: 38, // 20. Ke2! or 22. Qf6+!
+        moves: [
+            "e4", "e5", "f4", "exf4", "Bc4", "Qh4+", "Kf1", "b5", "Bxb5", "Nf6",
+            "Nf3", "Qh6", "d3", "Nh5", "Nh4", "Qg5", "Nf5", "c6", "g4", "Nf6",
+            "Rg1", "cxb5", "h4", "Qg6", "h5", "Qg5", "Qf3", "Ng8", "Bxf4", "Qf6",
+            "Nc3", "Bc5", "Nd5", "Qxb2", "Bd6", "Bxg1", "e5", "Qxa1+", "Ke2", "Na6",
+            "Nxg7+", "Kd8", "Qf6+", "Nxf6", "Be7#"
+        ],
+    },
+    {
+        id: "opera-game",
+        title: "The Opera Game",
+        white: "Paul Morphy",
+        black: "Duke of Brunswick & Count Isouard",
+        year: 1858,
+        event: "Paris Opera House (Norma intermission)",
+        result: "1-0",
+        eco: "C41",
+        opening: "Philidor Defense",
+        description: "Morphy's quintessential demonstration of rapid development, open lines, and deflection queen sacrifice ending in checkmate with rook and bishop.",
+        keyMoveIndex: 30, // 16. Qb8+!
+        moves: [
+            "e4", "e5", "Nf3", "d6", "d4", "Bg4", "dxe5", "Bxf3", "Qxf3", "dxe5",
+            "Bc4", "Nf6", "Qb3", "Qe7", "Nc3", "c6", "Bg5", "b5", "Nxb5", "cxb5",
+            "Bxb5+", "Nbd7", "O-O-O", "Rd8", "Rxd7", "Rxd7", "Rd1", "Qe6", "Bxd7+", "Nxd7",
+            "Qb8+", "Nxb8", "Rd8#"
+        ],
+    },
+    {
+        id: "game-of-the-century",
+        title: "Game of the Century",
+        white: "Donald Byrne",
+        black: "Bobby Fischer (age 13)",
+        year: 1956,
+        event: "Rosenwald Memorial Tournament, New York",
+        result: "0-1",
+        eco: "D92",
+        opening: "Grünfeld Defence, 5.Bf4",
+        description: "A 13-year-old Bobby Fischer sacrifices his queen on move 17 (Be6!!) to unleash an unstoppable windmill attack with bishop and knight.",
+        keyMoveIndex: 33, // 17... Be6!!
+        moves: [
+            "Nf3", "Nf6", "c4", "g6", "Nc3", "Bg7", "d4", "O-O", "Bf4", "d5",
+            "Qb3", "dxc4", "Qxc4", "c6", "e4", "Nbd7", "Rd1", "Nb6", "Qc5", "Bg4",
+            "Bg5", "Na4", "Qa3", "Nxc3", "bxc3", "Nxe4", "Bxe7", "Qb6", "Bc4", "Nxc3",
+            "Bc5", "Rfe8+", "Kf1", "Be6", "Bxb6", "Bxc4+", "Kg1", "Ne2+", "Kf1", "Nxd4+",
+            "Kg1", "Ne2+", "Kf1", "Nc3+", "Kg1", "axb6", "Qb4", "Ra4", "Qxb6", "Nxd1",
+            "h3", "Rxa2", "Kh2", "Nxf2", "Re1", "Rxe1", "Qd8+", "Bf8", "Nxe1", "Bd5",
+            "Nf3", "Ne4", "Qb8", "b5", "h4", "h5", "Ne5", "Kg7", "Kg1", "Bc5+",
+            "Kf1", "Ng3+", "Ke1", "Bb4+", "Kd1", "Bb3+", "Kc1", "Ne2+", "Kb1", "Nc3+",
+            "Kc1", "Rc2#"
+        ],
+    },
+    {
+        id: "kasparov-immortal",
+        title: "Kasparov's Immortal",
+        white: "Garry Kasparov",
+        black: "Veselin Topalov",
+        year: 1999,
+        event: "Hoogovens Group A, Wijk aan Zee",
+        result: "1-0",
+        eco: "B07",
+        opening: "Pirc Defense",
+        description: "Kasparov sacrifices his rook on d4 (24. Rxd4!!) initiating a spectacular 15-move king hunt that drove the black king across the entire board.",
+        keyMoveIndex: 46, // 24. Rxd4!!
+        moves: [
+            "e4", "d6", "d4", "Nf6", "Nc3", "g6", "Be3", "Bg7", "Qd2", "c6",
+            "f3", "b5", "Nge2", "Nbd7", "Bh6", "Bxh6", "Qxh6", "Bb7", "a3", "e5",
+            "O-O-O", "Qe7", "Kb1", "a6", "Nc1", "O-O-O", "Nb3", "exd4", "Rxd4", "c5",
+            "Rd1", "Nb6", "g3", "Kb8", "Na5", "Ba8", "Bh3", "d5", "Qf4+", "Ka7",
+            "Rhe1", "d4", "Nd5", "Nbxd5", "exd5", "Qd6", "Rxd4", "cxd4", "Re7+", "Kb6",
+            "Qxd4+", "Kxa5", "b4+", "Ka4", "Qc3", "Qxd5", "Ra7", "Bb7", "Rxb7", "Qc4",
+            "Qxf6", "Kxa3", "Qxa6+", "Kxb4", "c3+", "Kxc3", "Qa1+", "Kd2", "Qb2+", "Kd1",
+            "Bf1", "Rd2", "Rd7+", "Rxd7", "Bxc4", "bxc4", "Qxh8", "Rd3", "Qa8", "c3",
+            "Qa4+", "Ke1", "f4", "f5", "Kc1", "Rd2", "Qa7"
+        ],
+    },
+    {
+        id: "tal-larsen-1965",
+        title: "Tal's Wild Central Sacrifice",
+        white: "Mikhail Tal",
+        black: "Bent Larsen",
+        year: 1965,
+        event: "Candidates Semifinal, Bled, Match Game 10",
+        result: "1-0",
+        eco: "B57",
+        opening: "Sicilian Defense, Richter-Rauzer",
+        description: "Tal's famous intuitive piece sacrifice 16. Nxd5!! blowing open the center against Larsen's uncastled king to clinch the match.",
+        keyMoveIndex: 30, // 16. Nxd5!!
+        moves: [
+            "e4", "c5", "Nf3", "Nc6", "d4", "cxd4", "Nxd4", "e6", "Nc3", "d6",
+            "Be3", "Nf6", "f4", "Be7", "Qf3", "O-O", "O-O-O", "Qc7", "Ndb5", "Qb8",
+            "g4", "a6", "Nd4", "Nxd4", "Bxd4", "b5", "g5", "Nd7", "Bd3", "b4",
+            "Nd5", "exd5", "exd5", "f5", "Rde1", "Rf7", "h4", "Bb7", "Bxf5", "Rxf5",
+            "Rxe7", "Ne5", "Qe4", "Qf8", "fxe5", "Rf4", "Qe3", "Rf3", "Qe2", "Qxe7",
+            "Qxf3", "dxe5", "Re1", "Rd8", "Rxe5", "Qd6", "Qf4", "Rf8", "Qe4", "Bc8",
+            "b3", "a5", "h5", "Bd7", "h6"
+        ],
+    },
+];
+const MATCH_ARCHETYPES = {
+    romantic_swashbuckler: "Cascading material sacrifices culminating in a forced mating net",
+    dynamic_initiative: "Relentless piece tempo and coordinated piece pressure dominating passive defenders",
+    positional_squeeze: "Prophylactic clamp, suffocating opponent counterplay before technical breakthrough",
+    tactical_firestorm: "Sharp double-edged complications with king chases and critical calculate-or-die tactics",
+};
+const BRILLIANCE_RUBRIC = [
+    "Standard technical victory with routine exchanges",
+    "Well-played competitive game with solid tactical execution",
+    "Brilliant game featuring deep calculation and attractive piece play",
+    "Immortal artistic masterpiece that redefined chess literature",
+];
+const MATCH_SHARPNESS_RUBRIC = [
+    "Solid and quiet; long positional maneuvering behind closed pawns",
+    "Balanced fighting contest with strategic tension",
+    "Very sharp; frequent piece contact, king exposure, and tactical threats",
+    "Wild tactical hurricane; mutual piece sacrifices and all-out monarch assault",
+];
+export class ClassicMatchStudio {
+    get client() {
+        return getTypeSafeClient();
+    }
+    /**
+     * Classifies a classic chess match using TypeSafe System One.
+     */
+    async classifyMatch(match) {
+        const turningMove = match.moves[match.keyMoveIndex] ?? match.moves[match.moves.length - 1] ?? "e4";
+        const moveNum = Math.floor((match.keyMoveIndex) / 2) + 1;
+        const state = {
+            match_meta: {
+                id: match.id,
+                title: match.title,
+                white: match.white,
+                black: match.black,
+                year: match.year,
+                eco: match.eco,
+                opening: match.opening,
+                result: match.result,
+                total_moves: match.moves.length,
+            },
+            turning_point: {
+                move_number: moveNum,
+                san: turningMove,
+                description: match.description,
+            },
+            moves_sample: match.moves.slice(0, 30),
+        };
+        const response = await this.client.systemOne({
+            state,
+            questions: {
+                archetype: choice("Which historical chess archetype best classifies `match_meta.title`?", MATCH_ARCHETYPES),
+                brilliance: score("Rate the aesthetic and instructive brilliance of this classic match:", BRILLIANCE_RUBRIC),
+                sharpness: score("Rate the overall tactical sharpness and volatility of this game:", MATCH_SHARPNESS_RUBRIC),
+                decisive_sacrifice: noul("Does this match feature a sound, decisive piece or queen sacrifice for the initiative?"),
+            },
+        });
+        const archetype = response.answers.archetype.choice;
+        const brillianceScore = response.answers.brilliance.score;
+        const sharpnessScore = response.answers.sharpness.score;
+        const hasSac = response.answers.decisive_sacrifice.noul >= 0.6;
+        // Deterministically count tactical themes from move properties
+        let checksAndCaptures = 0;
+        let pawnMoves = 0;
+        for (const m of match.moves) {
+            if (m.includes("+") || m.includes("x") || m.includes("#"))
+                checksAndCaptures++;
+            else if (m.toLowerCase()[0] >= "a" && m.toLowerCase()[0] <= "h" && !m.includes("O"))
+                pawnMoves++;
+        }
+        const total = Math.max(1, match.moves.length);
+        const tacticalPct = Math.round((checksAndCaptures / total) * 100);
+        const pawnPct = Math.round((pawnMoves / total) * 100);
+        const piecePct = Math.max(10, 100 - tacticalPct - pawnPct);
+        const prophylPct = Math.round(piecePct * 0.35);
+        let verdict = `${match.title} (${match.year}) is a classic ${archetype.replace(/_/g, " ")}. `;
+        if (brillianceScore >= 2.3) {
+            verdict += "Widely celebrated as one of the finest artistic achievements in the history of the game.";
+        }
+        else {
+            verdict += "A deeply instructive showcase of classical principles and aggressive tactical conversion.";
+        }
+        return {
+            matchId: match.id,
+            title: match.title,
+            archetype: archetype.replace(/_/g, " ").toUpperCase(),
+            aestheticBrilliance: {
+                score: brillianceScore,
+                level: BRILLIANCE_RUBRIC[Math.min(BRILLIANCE_RUBRIC.length - 1, Math.round(brillianceScore))] ?? "Masterpiece",
+                confidence: response.answers.brilliance.confidence,
+            },
+            overallSharpness: {
+                score: sharpnessScore,
+                level: MATCH_SHARPNESS_RUBRIC[Math.min(MATCH_SHARPNESS_RUBRIC.length - 1, Math.round(sharpnessScore))] ?? "Sharp",
+            },
+            hasDecisiveSacrifice: hasSac,
+            turningPoint: {
+                moveNumber: moveNum,
+                san: turningMove,
+                annotation: match.description,
+            },
+            strategicBreakdown: {
+                tacticalStrikesPct: tacticalPct,
+                pawnBreaksPct: pawnPct,
+                prophylaxisPct: prophylPct,
+                pieceActivationPct: piecePct,
+            },
+            verdict,
+        };
+    }
+}
+//# sourceMappingURL=classicMatches.js.map

package/dist/classicMatches.js.map

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

package/dist/demo.d.ts

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

package/dist/demo.d.ts.map

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

package/dist/demo.js

@@ -0,0 +1,142 @@
+import { ChessEngine } from "./chessEngine.js";
+import { MoveResolver } from "./moveResolver.js";
+import { MoveEvaluator } from "./moveEvaluator.js";
+import { PersonaEngine } from "./personaEngine.js";
+import { GameReviewer } from "./gameReviewer.js";
+import { getTypeSafeClient } from "./typeSafeClient.js";
+async function runDemo() {
+    const client = getTypeSafeClient();
+    console.log("================================================================================");
+    console.log("   ♟️  JEV-CHESS: DESIGNING CHESS MOVES & GAMES WITH TYPESAFE AI  ♟️");
+    console.log("================================================================================");
+    console.log(`Backend Mode: ${client.isLive ? "🟢 LIVE (TypeSafe API - jev-latest)" : "🟡 SIMULATED (Calibrated offline fallback)"}`);
+    console.log("Principle: Code enforces board physics & rules; TypeSafe System One provides fast semantic judgment.\n");
+    const engine = new ChessEngine();
+    // ---------------------------------------------------------------------------
+    // SECTION 1: MOVE DESIGN - NATURAL LANGUAGE INTENT RESOLUTION
+    // ---------------------------------------------------------------------------
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("1. MOVE RESOLUTION: 'Select Instead of Generate' Pattern (TypeSafe Choice)");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    // Play standard 1. e4 e5
+    engine.makeMove("e4");
+    engine.makeMove("e5");
+    console.log(`Current Board FEN: ${engine.fen()}`);
+    console.log(`Turn: ${engine.turn()} | Move: 2\n`);
+    const resolver = new MoveResolver();
+    const queries = [
+        "Develop my knight towards the center and attack their pawn",
+        "Push the queen's pawn two squares forward to contest the center",
+        "Teleport my rook directly to the other side", // Intent with no legal match
+    ];
+    for (const q of queries) {
+        console.log(`> Human command: "${q}"`);
+        const result = await resolver.resolveIntent(engine, q);
+        if (result.matchedMove) {
+            console.log(`  ✅ Matched Legal Move: ${result.matchedMove.san} (${result.matchedMove.description})`);
+            console.log(`     Confidence: ${(result.confidence * 100).toFixed(1)}%`);
+        }
+        else {
+            console.log(`  ⚠️ Ambiguous or Illegal Command!`);
+            console.log(`     Confidence: ${(result.confidence * 100).toFixed(1)}% (Clarification Required)`);
+            if (result.alternativeCandidates.length > 0) {
+                console.log(`     Did you mean: ${result.alternativeCandidates.join(", ")}?`);
+            }
+        }
+        console.log();
+    }
+    // Play White 2. Nf3, Black 2. Nc6, White 3. Bc4, Black 3. Bc5
+    engine.makeMove("Nf3");
+    engine.makeMove("Nc6");
+    engine.makeMove("Bc4");
+    engine.makeMove("Bc5");
+    // ---------------------------------------------------------------------------
+    // SECTION 2: MOVE DESIGN - MULTI-DIMENSIONAL QUALITATIVE EVALUATION
+    // ---------------------------------------------------------------------------
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("2. MOVE EVALUATION: Parallel Atomic Judgments (Score, Choice, Noul)");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    const evaluator = new MoveEvaluator();
+    const testMoves = ["c3", "O-O", "Bxf7+"];
+    for (const san of testMoves) {
+        // Check if legal in current or alternate position
+        const candidates = engine.getAnnotatedMoves();
+        let moveObj = candidates.find((m) => m.san === san);
+        if (!moveObj) {
+            // Create synthetic candidate for demonstration if not currently legal
+            moveObj = {
+                san,
+                from: "c2",
+                to: "c3",
+                piece: "pawn",
+                color: "white",
+                isCapture: san.includes("x"),
+                isCheck: san.includes("+"),
+                isCastling: san === "O-O",
+                description: san === "O-O" ? "Kingside castle" : `Move ${san}`,
+            };
+        }
+        const evalResult = await evaluator.evaluateMove(engine, moveObj);
+        console.log(`Move: ${evalResult.san}`);
+        console.log(`  Badge:                  ${evalResult.commentaryBadge}`);
+        console.log(`  Tactical Sharpness:     ${evalResult.tacticalSharpness.score.toFixed(1)} / 3.0 (${evalResult.tacticalSharpness.level})`);
+        console.log(`  Strategic Theme:        ${evalResult.strategicTheme.theme} (Confidence: ${(evalResult.strategicTheme.confidence * 100).toFixed(0)}%)`);
+        console.log(`  King Attack Threat:     ${(evalResult.kingAttackRisk.probability * 100).toFixed(0)}%`);
+        console.log(`  Psychological Pressure: ${(evalResult.psychologicalPressure.probability * 100).toFixed(0)}%`);
+        console.log();
+    }
+    // ---------------------------------------------------------------------------
+    // SECTION 3: GAME DESIGN - PERSONA AI OPPONENTS VIA COMPOSITE SCORING
+    // ---------------------------------------------------------------------------
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("3. GAME DESIGN: Persona AI Opponents via Composite Scoring");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("Demonstrating how atomic scores are re-weighted in code to produce distinct personalities without rerunning inference:\n");
+    const personaEngine = new PersonaEngine();
+    const personas = ["tal", "petrosian", "capablanca", "coffeehouse"];
+    for (const pId of personas) {
+        const decision = await personaEngine.selectMove(engine, pId, 4);
+        const p = decision.persona;
+        console.log(`👤 ${p.name} - "${p.title}"`);
+        console.log(`   Weights: Aggression=${p.weights.aggression}, Prophylaxis=${p.weights.prophylaxis}, Complexity=${p.weights.complexity}, Greed=${p.weights.materialGreed}`);
+        console.log(`   Decision: Plays ${decision.selectedMove.san} (${decision.selectedMove.description})`);
+        console.log(`   Top 3 Ranked Moves:`);
+        for (let i = 0; i < Math.min(3, decision.rankedCandidates.length); i++) {
+            const c = decision.rankedCandidates[i];
+            console.log(`     #${i + 1} ${c.move.san.padEnd(5)} | Composite Score: ${c.compositeScore.toFixed(3)} (Agg:${c.dimensionScores.aggression.toFixed(1)}, Pro:${c.dimensionScores.prophylaxis.toFixed(1)}, Comp:${c.dimensionScores.complexity.toFixed(1)}, Greed:${c.dimensionScores.materialGreed.toFixed(2)})`);
+        }
+        console.log();
+    }
+    // ---------------------------------------------------------------------------
+    // SECTION 4: GAME REVIEW - POST-GAME BLUNDER TAXONOMY & DIAGNOSTICS
+    // ---------------------------------------------------------------------------
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("4. GAME REVIEW: Structured Mistake Diagnostics (The Cascade Pattern)");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    const reviewer = new GameReviewer();
+    const sampleBlunder = {
+        san: "Qxh7??",
+        from: "d3",
+        to: "h7",
+        piece: "queen",
+        color: "white",
+        isCapture: true,
+        isCheck: false,
+        isCastling: false,
+        description: "Queen captures h7 pawn without checking king safety",
+    };
+    const diagnosis = await reviewer.diagnoseMove(engine, sampleBlunder, 14);
+    console.log(`Reviewed Move: Move ${diagnosis.moveNumber} White played ${diagnosis.playedMove}`);
+    console.log(`  Mistake Taxonomy:    ${diagnosis.mistakeArchetype.toUpperCase()}`);
+    console.log(`  Defensive Difficulty: ${diagnosis.defensiveDifficulty.toFixed(1)} / 3.0`);
+    console.log(`  Game Tension Level:   ${diagnosis.tacticalTension.toFixed(1)} / 3.0`);
+    console.log(`  Coach Feedback:       "${diagnosis.coachAdvice}"\n`);
+    console.log("================================================================================");
+    console.log("   ✅ TypeSafe Chess Moves and Games Architecture demonstrated successfully!    ");
+    console.log("================================================================================");
+}
+runDemo().catch((err) => {
+    console.error("Demo failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=demo.js.map

package/dist/demo.js.map

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

package/dist/gameReviewer.d.ts

@@ -0,0 +1,11 @@
+import type { ChessEngine } from "./chessEngine.js";
+import type { AnnotatedMove, BlunderDiagnosis } from "./types.js";
+/**
+ * Diagnostic Game Reviewer that classifies chess moves and blunders into actionable semantic concepts.
+ * Pattern: Verification & Escalation / Structured Diagnostics.
+ */
+export declare class GameReviewer {
+    private get client();
+    diagnoseMove(engine: ChessEngine, move: AnnotatedMove, moveNumber: number): Promise<BlunderDiagnosis>;
+}
+//# sourceMappingURL=gameReviewer.d.ts.map

package/dist/gameReviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameReviewer.d.ts","sourceRoot":"","sources":["../src/gameReviewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAyBpF;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,KAAK,MAAM,GAEjB;IAEY,YAAY,CACvB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAuE3B;CACF"}

package/dist/gameReviewer.js

@@ -0,0 +1,89 @@
+import { choice, getTypeSafeClient, score } from "./typeSafeClient.js";
+const MISTAKE_ARCHETYPES = {
+    sound_move: "A solid, principled move with no critical defect",
+    tactical_blindness: "Overlooked an immediate tactical blow, fork, pin, skewer, or check",
+    poisoned_pawn_greed: "Grabbed material at the fatal expense of development or king safety",
+    over_extension: "Pushed pawns or pieces too far forward, creating irreparable structural holes",
+    passive_concession: "Retreated timidly, yielding tempo and spatial dominance to the opponent",
+    king_safety_negligence: "Compromised the pawn shield or exposed the monarch to a deadly storm",
+};
+const DEFENSIVE_DIFFICULTY_RUBRIC = [
+    "Comfortable defense; natural and straightforward moves maintain balance",
+    "Tense defense; requires disciplined calculation and piece coordination",
+    "Precise tightrope; requires narrow, counter-intuitive only-moves to survive",
+    "Hopeless or practically impossible for a human player to defend under pressure",
+];
+const TENSION_RUBRIC = [
+    "Peaceful and quiet; strategic maneuvering behind closed lines",
+    "Building central friction and contested outposts",
+    "Sharp tactical skirmish; pieces in contact and multiple captures pending",
+    "Decisive boiling point; mutual king attacks and explosive complications",
+];
+/**
+ * Diagnostic Game Reviewer that classifies chess moves and blunders into actionable semantic concepts.
+ * Pattern: Verification & Escalation / Structured Diagnostics.
+ */
+export class GameReviewer {
+    get client() {
+        return getTypeSafeClient();
+    }
+    async diagnoseMove(engine, move, moveNumber) {
+        const boardContext = engine.getBoardContext();
+        const state = {
+            game_state: {
+                fen: boardContext.fen,
+                turn: boardContext.turn,
+                phase: boardContext.gamePhase,
+                material: boardContext.materialBalance.description,
+                recent_moves: boardContext.recentHistory,
+            },
+            played_move: {
+                san: move.san,
+                description: move.description,
+                is_capture: move.isCapture,
+                is_check: move.isCheck,
+            },
+        };
+        const response = await this.client.systemOne({
+            state,
+            questions: {
+                archetype: choice("Which mistake or positional category best describes `played_move.san`?", MISTAKE_ARCHETYPES),
+                defensive_difficulty: score("How difficult is it to defend or recover from this position after `played_move.san`?", DEFENSIVE_DIFFICULTY_RUBRIC),
+                tension: score("What is the overall tactical and psychological tension level on the board?", TENSION_RUBRIC),
+            },
+        });
+        const archetypeChoice = response.answers.archetype.choice;
+        const diffScore = response.answers.defensive_difficulty.score;
+        const tensionScore = response.answers.tension.score;
+        let coachAdvice = "Keep developing actively and control the center.";
+        switch (archetypeChoice) {
+            case "tactical_blindness":
+                coachAdvice = "Always scan for opponent checks, captures, and threats before finalizing your move.";
+                break;
+            case "poisoned_pawn_greed":
+                coachAdvice = "Do not go pawn hunting with an uncastled king or uncoordinated pieces!";
+                break;
+            case "over_extension":
+                coachAdvice = "Pawns cannot move backwards; every advance creates irreversible weaknesses.";
+                break;
+            case "passive_concession":
+                coachAdvice = "When pushed, look for counter-attacking resources rather than passive retreats.";
+                break;
+            case "king_safety_negligence":
+                coachAdvice = "Castling and securing your king should take priority over peripheral adventures.";
+                break;
+            case "sound_move":
+                coachAdvice = "Excellent, harmonious play. Continue executing your strategic plan.";
+                break;
+        }
+        return {
+            moveNumber,
+            playedMove: move.san,
+            mistakeArchetype: archetypeChoice,
+            defensiveDifficulty: diffScore,
+            tacticalTension: tensionScore,
+            coachAdvice,
+        };
+    }
+}
+//# sourceMappingURL=gameReviewer.js.map

package/dist/gameReviewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameReviewer.js","sourceRoot":"","sources":["../src/gameReviewer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGvE,MAAM,kBAAkB,GAAqC;IAC3D,UAAU,EAAE,kDAAkD;IAC9D,kBAAkB,EAAE,oEAAoE;IACxF,mBAAmB,EAAE,qEAAqE;IAC1F,cAAc,EAAE,+EAA+E;IAC/F,kBAAkB,EAAE,yEAAyE;IAC7F,sBAAsB,EAAE,sEAAsE;CAC/F,CAAC;AAEF,MAAM,2BAA2B,GAAG;IAClC,yEAAyE;IACzE,wEAAwE;IACxE,6EAA6E;IAC7E,gFAAgF;CACxE,CAAC;AAEX,MAAM,cAAc,GAAG;IACrB,+DAA+D;IAC/D,kDAAkD;IAClD,0EAA0E;IAC1E,yEAAyE;CACjE,CAAC;AAEX;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB,IAAY,MAAM;QAChB,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,MAAmB,EACnB,IAAmB,EACnB,UAAkB;QAElB,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAE9C,MAAM,KAAK,GAAG;YACZ,UAAU,EAAE;gBACV,GAAG,EAAE,YAAY,CAAC,GAAG;gBACrB,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,KAAK,EAAE,YAAY,CAAC,SAAS;gBAC7B,QAAQ,EAAE,YAAY,CAAC,eAAe,CAAC,WAAW;gBAClD,YAAY,EAAE,YAAY,CAAC,aAAa;aACzC;YACD,WAAW,EAAE;gBACX,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,SAAS;gBAC1B,QAAQ,EAAE,IAAI,CAAC,OAAO;aACvB;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3C,KAAK;YACL,SAAS,EAAE;gBACT,SAAS,EAAE,MAAM,CACf,wEAAwE,EACxE,kBAAkB,CACnB;gBACD,oBAAoB,EAAE,KAAK,CACzB,sFAAsF,EACtF,2BAA2B,CAC5B;gBACD,OAAO,EAAE,KAAK,CACZ,4EAA4E,EAC5E,cAAc,CACf;aACF;SACF,CAAC,CAAC;QAEH,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,MAA0B,CAAC;QAC9E,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC;QAC9D,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QAEpD,IAAI,WAAW,GAAG,kDAAkD,CAAC;QACrE,QAAQ,eAAe,EAAE,CAAC;YACxB,KAAK,oBAAoB;gBACvB,WAAW,GAAG,qFAAqF,CAAC;gBACpG,MAAM;YACR,KAAK,qBAAqB;gBACxB,WAAW,GAAG,wEAAwE,CAAC;gBACvF,MAAM;YACR,KAAK,gBAAgB;gBACnB,WAAW,GAAG,6EAA6E,CAAC;gBAC5F,MAAM;YACR,KAAK,oBAAoB;gBACvB,WAAW,GAAG,iFAAiF,CAAC;gBAChG,MAAM;YACR,KAAK,wBAAwB;gBAC3B,WAAW,GAAG,kFAAkF,CAAC;gBACjG,MAAM;YACR,KAAK,YAAY;gBACf,WAAW,GAAG,qEAAqE,CAAC;gBACpF,MAAM;QACV,CAAC;QAED,OAAO;YACL,UAAU;YACV,UAAU,EAAE,IAAI,CAAC,GAAG;YACpB,gBAAgB,EAAE,eAAe;YACjC,mBAAmB,EAAE,SAAS;YAC9B,eAAe,EAAE,YAAY;YAC7B,WAAW;SACZ,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export * from "./chessEngine.js";
+export * from "./typeSafeClient.js";
+export * from "./moveResolver.js";
+export * from "./moveEvaluator.js";
+export * from "./personaEngine.js";
+export * from "./gameReviewer.js";
+export * from "./classicMatches.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export * from "./chessEngine.js";
+export * from "./typeSafeClient.js";
+export * from "./moveResolver.js";
+export * from "./moveEvaluator.js";
+export * from "./personaEngine.js";
+export * from "./gameReviewer.js";
+export * from "./classicMatches.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/moveEvaluator.d.ts

@@ -0,0 +1,11 @@
+import type { ChessEngine } from "./chessEngine.js";
+import type { AnnotatedMove, MoveEvaluation } from "./types.js";
+/**
+ * Multi-dimensional qualitative evaluator for chess moves using TypeSafe AI.
+ * Pattern: Parallel Atomic Judgments + Code-Controlled Badge Synthesis.
+ */
+export declare class MoveEvaluator {
+    private get client();
+    evaluateMove(engine: ChessEngine, move: AnnotatedMove): Promise<MoveEvaluation>;
+}
+//# sourceMappingURL=moveEvaluator.d.ts.map

package/dist/moveEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveEvaluator.d.ts","sourceRoot":"","sources":["../src/moveEvaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAkBhE;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,KAAK,MAAM,GAEjB;IAEY,YAAY,CACvB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,cAAc,CAAC,CAwFzB;CACF"}