cm-engine-runner 1.2.2 → 1.2.4

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(tree:*)",
+      "Bash(wc:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(npm install:*)"
+    ]
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,57 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+cm-engine-runner is a lightweight JavaScript library for running chess engines in the browser. It provides an abstraction layer supporting multiple backends: Stockfish (via WebWorkers) and Polyglot opening books.
+
+## Development Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Run the demo/test page
+# Open index.html in a browser (uses importmap for ES6 module resolution)
+```
+
+No build step is required - the library uses pure ES6 modules that run directly in browsers.
+
+## Architecture
+
+The project uses an **adapter pattern** with a base class and engine-specific implementations:
+
+```
+EngineRunner (base class)
+    ├── StockfishRunner  →  WebWorker  →  Stockfish WASM engine
+    └── PolyglotRunner   →  cm-polyglot  →  Opening book (.bin)
+```
+
+### Core Files
+
+- `src/EngineRunner.js` - Abstract base class defining the interface and state machine (`ENGINE_STATE`: LOADING, LOADED, READY, THINKING)
+- `src/StockfishRunner.js` - Stockfish adapter implementing UCI protocol communication, skill levels 1-20 with depth mapping
+- `src/PolyglotRunner.js` - Polyglot opening book reader with probability-weighted move selection
+- `engines/stockfish-v10-niklasf.js` - Compiled Stockfish v10 engine (runs in WebWorker)
+
+### API Pattern
+
+All adapters share this interface:
+```javascript
+runner.calculateMove(fen, props) → Promise<{from, to, promotion?, score?, ponder?}>
+```
+
+### Adding a New Engine
+
+1. Extend `EngineRunner` class
+2. Implement `init()` to set up the engine
+3. Implement `calculateMove(fen, props)` returning a Promise with move data
+4. Manage engine state via `ENGINE_STATE` constants
+
+## Key Implementation Details
+
+- Uses `importmap` in index.html for browser-based ES6 module resolution (no bundler)
+- StockfishRunner communicates with the engine via `postMessage` using UCI protocol
+- `responseDelay` prop adds artificial delay for UX purposes
+- `debug` prop enables console logging

package/index.html

@@ -33,11 +33,11 @@
     const positionEndGame = "8/8/8/2k5/4K3/8/8/8"
     console.log("polyglot", positionEndGame, await polyglotRunner.calculateMove(positionEndGame))
 
-    const stockfishRunner = new StockfishRunner({workerUrl: "./engines/stockfish-v10-niklasf.js", responseDelay: 0, debug: true})
+    const stockfishRunner = new StockfishRunner({workerUrl: "./node_modules/stockfish/src/stockfish-17.1-lite-single-03e3232.js", responseDelay: 0, debug: true})
     console.log("stockfish", await stockfishRunner.calculateMove(startingFewMoves))
     const postitionBlackWillWin = "4k3/3r4/8/8/8/8/6K1/8 w - - 0 1"
     console.log("stockfish",  await stockfishRunner.calculateMove(postitionBlackWillWin, {level: 1}))
-    console.log("stockfish",  await stockfishRunner.calculateMove(postitionBlackWillWin, {level: 10}))
+    console.log("stockfish",  await stockfishRunner.calculateMove(postitionBlackWillWin, {level: 20}))
 
     const positionManyPawns = "ppppkppp/pppppppp/pppppppp/pppppppp/8/5N2/8/RNBQKB1R b KQ - 0 1"
     console.log("stockfish",  await stockfishRunner.calculateMove(positionManyPawns, {level: 3}))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cm-engine-runner",
   "description": "Abstraction layer to run chess engines, supports opening books",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "type": "module",
   "main": "index.js",
   "scripts": {
@@ -27,6 +27,7 @@
     "teevi": "^2.2.4"
   },
   "dependencies": {
-    "cm-polyglot": "^1.1.0"
+    "cm-polyglot": "^1.1.0",
+    "stockfish": "^17.1.0"
   }
 }

package/src/StockfishRunner.js

@@ -80,8 +80,8 @@ export class StockfishRunner extends EngineRunner {
                 }
                 this.score = tmpScore
             }
-            // match = line.match(/^bestmove ([a-h][1-8])([a-h][1-8])([qrbn])?/) // ponder is not always included
-            match = line.match(/^bestmove ([a-h][1-8])([a-h][1-8])([qrbn])?( ponder ([a-h][1-8])?([a-h][1-8])?)?/)
+            // match = line.match(/^bestmove ([a-h][1-8])([a-h][1-8])([qrbk])?/) // ponder is not always included
+            match = line.match(/^bestmove ([a-h][1-8])([a-h][1-8])([qrbk])?( ponder ([a-h][1-8])?([a-h][1-8])?)?/)
             if (match) {
                 this.engineState = ENGINE_STATE.READY
                 if (match[4] !== undefined) {
@@ -103,6 +103,7 @@ export class StockfishRunner extends EngineRunner {
 
     calculateMove(fen, props = { level: 4 }) {
         this.engineState = ENGINE_STATE.THINKING
+        this.score = undefined // Reset score to avoid carrying over stale values
         const timeoutPromise = new Promise((resolve) => {
             setTimeout(async () => {
                 resolve()