pokertools-arena 0.4.0 → 0.4.1

package/README.md

@@ -17,7 +17,7 @@
 | **Package** | `npx pokertools-arena` |
 | **Runtime** | Node.js ≥ 24 for tooling; any modern browser for the app |
 
-> **Current release: 0.4.0.** This is the methodology and reproducibility release: a paired fixed-state corpus, separated family/sizing correctness, fragmentation-invariance metrics with confidence intervals, standardized counters, and a reorganized repository with one source of truth per report.
+> **Current release: 0.4.1.** A maintenance release on top of the 0.4.0 methodology work: modal tooltips now float above overflow, the launcher starts exactly once when its default port is busy, and the real-API diagnostics skip cleanly when repository secrets are absent.
 
 ---
 

package/bin/pokertools-arena.mjs

@@ -135,7 +135,7 @@ function safePath(urlPath) {
   return resolved.startsWith(root) ? resolved : null;
 }
 
-const server = createServer(async (req, res) => {
+async function handleRequest(req, res) {
   try {
     const urlPath = (req.url || '/').split('?')[0];
     if (urlPath === '/arena-env.js') {
@@ -160,7 +160,7 @@ const server = createServer(async (req, res) => {
     res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
     res.end('Not found');
   }
-});
+}
 
 function openBrowser(url) {
   const platform = process.platform;
@@ -176,6 +176,11 @@ function openBrowser(url) {
 }
 
 function listen(port) {
+  // A fresh Server per attempt. Reusing one Server and calling listen() again
+  // from inside its EADDRINUSE handler makes Node emit 'listening' twice, which
+  // printed the banner twice and opened two browser windows when the port was
+  // already in use.
+  const server = createServer(handleRequest);
   server.once('error', error => {
     if (error.code === 'EADDRINUSE' && port < requestedPort + 20) return listen(port + 1);
     console.error(`pokertools-arena: ${error.message}`);

package/docs/diagnostics/SUMMARY.md

@@ -1,4 +1,4 @@
-# pokertools-arena 0.4.0 — benchmark methodology & results
+# pokertools-arena 0.4.1 — benchmark methodology & results
 
 Generated: 2026-09-19T18:19:58.352Z
 Methodology: paired fixed-state corpus; deterministic interleaving with recorded experiment seed.

package/docs/diagnostics/summary.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.4.0",
+  "version": "0.4.1",
   "generatedAt": "2026-09-19T18:19:58.352Z",
   "experiments": [
     "paired"

package/docs/releases/RELEASE_NOTES.md

@@ -1,5 +1,28 @@
 # Release notes
 
+## 0.4.1 — Maintenance
+
+A maintenance release on top of the 0.4.0 methodology work.
+
+### Tooltips
+
+- Modal tooltips are rendered by a single fixed-position element attached to the
+  topmost open `<dialog>`. They escape the modal's overflow clipping, flip above
+  the trigger when there is no room below, and stay inside the viewport, so every
+  information tooltip is fully visible.
+
+### Launcher
+
+- The local launcher binds a fresh HTTP server per port attempt. When the default
+  port is already in use it now starts exactly once (one banner, one browser
+  window) on the next free port instead of starting twice.
+
+### CI
+
+- Real-API diagnostics have a credential preflight. When the `OPENAI_*`
+  repository secrets are not configured the diagnostics job is skipped with a
+  notice instead of failing a published release.
+
 ## 0.4.0 — Methodology, reproducibility and repository organization
 
 This release does not redesign the 0.3.0 decision foundations. It makes the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pokertools-arena",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Browser-first AI poker benchmark powered by @pokertools/engine with generic OpenAI-compatible endpoints, optional OpenRouter/Jev Decisions routing, deterministic hierarchical decisions, paired fixed-state methodology, and reproducible reporting.",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
     "check": "node --check src/app.js && node --check src/benchmark/scenarios.js && node --check build.mjs && node --check bin/pokertools-arena.mjs && node tests/release-check.mjs",
     "test": "npm run build && npm run check && npm run test:unit && npm run test:integration",
     "test:unit": "node tests/unit/decision-scenarios.mjs && node tests/unit/decision-diagnostics.mjs && node tests/unit/hierarchical-decision-tests.mjs && node tests/unit/methodology-tests.mjs && node tests/unit/size-bucket-tests.mjs && node tests/unit/paired-architecture-tests.mjs && node tests/unit/archive-content.mjs && node tests/unit/report-consistency.mjs",
-    "test:integration": "node tests/integration/pokertools-integration.mjs && node tests/integration/env-bootstrap.mjs",
+    "test:integration": "node tests/integration/pokertools-integration.mjs && node tests/integration/env-bootstrap.mjs && node tests/integration/launcher-port-retry.mjs",
     "test:diagnostics": "node tests/real/real-decision-diagnostics.mjs",
     "test:diagnostics:dry": "node tests/real/real-decision-diagnostics.mjs --dry-run",
     "test:real": "node tests/real/real-decision-diagnostics.mjs && node tests/real/real-paired-corpus.mjs",