@reicek/neataptic-ts 0.1.24 → 0.1.26

package/.github/copilot-instructions.md

@@ -91,6 +91,15 @@ When a generated `src/**/README.md` appears outdated relative to the code or JSD
 - run `npm run docs` to refresh generated documentation when needed,
 - consider `educational-docs` pre-approved to run `npm run docs` after doc-affecting edits so README files stay synchronized and drift does not confuse later work.
 
+CI-sensitive docs and tooling validation
+---------------------------------------
+When a task touches `.github/workflows/**`, `package.json`, `package-lock.json`, `scripts/**` that launch docs or browser tooling, Mermaid rendering, Puppeteer/Chromium, or any dependency change that can affect those paths:
+
+- do not treat local Windows success as sufficient evidence for GitHub-hosted Linux runners,
+- run `npm ci` after manifest or lockfile edits and report pass/fail before claiming the workflow is fixed,
+- run `npm run docs` when Mermaid, Puppeteer, docs generation, or related launch scripts are affected,
+- when browser-based docs tooling runs in Linux CI, explicitly account for Chromium sandbox restrictions and prefer durable script-level launch configuration over workflow-only ad hoc flags.
+
 Folder README reconnaissance (read this before deep code search)
 ---------------------------------------------------------------
 Because JSDoc is auto-compiled into each folder's `README.md`, those README files are the fastest condensed overview of a module's purpose, exported surface, neighboring files, and intended usage.
@@ -327,8 +336,10 @@ When you modify or create files under `src/` or `test/`, run (or advise running)
    Quick checks to run (recommended)
    --------------------------------
    - TypeScript: run `npm run build` and report pass/fail.
+   - Clean install: when `package.json`, `package-lock.json`, or workflow/runtime tooling changes, run `npm ci` and report pass/fail.
    - Tests heuristic: flag test files that contain more than one `expect(` occurrence (these should be split into multiple `it()` blocks).
    - JSDoc: for new exported symbols, ensure a JSDoc block with `@param`/`@returns` exists (or flag if missing).
+   - CI browser/docs tooling: when the changed path can invoke Mermaid, Puppeteer, or Chromium in CI, validate `npm run docs` and do not assume local non-Linux success generalizes to GitHub-hosted Linux.
    - ES2023 modernization: flag legacy patterns and suggest modern equivalents (see below one-liners).
 
    PowerShell examples (local validation)

package/.github/skills/trace-analyzer-extension/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: trace-analyzer-extension
-description: 'Extend scripts/analyze-trace.ts with new rollups, comparisons, script attribution, percentiles, or deterministic report sections. Use when the existing trace analyzer cannot answer an engineering question about Chrome trace or Perfetto data.'
+description: 'Extend scripts/analyze-trace/analyze-trace.ts with new rollups, comparisons, script attribution, percentiles, or deterministic report sections. Use when the existing trace analyzer cannot answer an engineering question about Chrome trace or Perfetto data.'
 argument-hint: 'Describe the trace question, missing metric, and validation trace file.'
 user-invocable: true
 disable-model-invocation: false
@@ -8,7 +8,7 @@ disable-model-invocation: false
 
 # Trace Analyzer Extension
 
-Use this skill when an agent needs to modify `scripts/analyze-trace.ts` instead
+Use this skill when an agent needs to modify `scripts/analyze-trace/analyze-trace.ts` instead
 of only consuming its current output.
 
 ## When to Use
@@ -27,7 +27,7 @@ of only consuming its current output.
 ## Standard Workflow
 
 1. State the engineering question the current analyzer cannot answer.
-2. Read `scripts/analyze-trace.ts` before proposing a new section.
+2. Read `scripts/analyze-trace/analyze-trace.ts` before proposing a new section.
 3. Prefer extending existing helpers over adding parallel ad hoc logic.
 4. Keep output deterministic, text-first, and easy to compare across captures.
 5. Validate the new output against a real trace file from the repo.

package/.github/skills/trace-analyzer-extension/assets/extension-checklist.md

@@ -1,6 +1,6 @@
 # Trace Analyzer Extension Checklist
 
-Use this checklist before finalizing changes to `scripts/analyze-trace.ts`.
+Use this checklist before finalizing changes to `scripts/analyze-trace/analyze-trace.ts`.
 
 ## Before Editing
 

package/.github/skills/trace-analyzer-extension/references/analyzer-extension-workflow.md

@@ -1,6 +1,6 @@
 # Analyzer Extension Workflow
 
-This reference explains how to safely extend `scripts/analyze-trace.ts` without
+This reference explains how to safely extend `scripts/analyze-trace/analyze-trace.ts` without
 turning it into a one-off debugging script.
 
 ## Start With the Question

package/.github/skills/trace-audit-reporting/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: trace-audit-reporting
-description: 'Analyze Chrome trace or Perfetto trace captures, run scripts/analyze-trace.ts, map hotspots to NeatapticTS source files, and generate a detailed performance report with findings, evidence, and an action plan. Use when auditing renderer, worker, GPU, requestAnimationFrame, postMessage, or long-task regressions.'
+description: 'Analyze Chrome trace or Perfetto trace captures, run scripts/analyze-trace/analyze-trace.ts, map hotspots to NeatapticTS source files, and generate a detailed performance report with findings, evidence, and an action plan. Use when auditing renderer, worker, GPU, requestAnimationFrame, postMessage, or long-task regressions.'
 argument-hint: 'Describe the trace file, feature area, and target report file.'
 user-invocable: true
 disable-model-invocation: false
@@ -42,7 +42,7 @@ surface for the library rather than the final destination for a workaround.
 - [Trace analysis workflow](./references/trace-analysis-workflow.md)
 - [Performance report template](./assets/performance-report-template.md)
 - Companion skill: `trace-analyzer-extension` for modifying
-  `scripts/analyze-trace.ts` itself when new rollups or comparisons are needed.
+  `scripts/analyze-trace/analyze-trace.ts` itself when new rollups or comparisons are needed.
 
 ## Standard Workflow
 
@@ -97,7 +97,7 @@ surface for the library rather than the final destination for a workaround.
 
 ## Repo-Specific Notes
 
-- This repository already includes `scripts/analyze-trace.ts` for compact,
+- This repository already includes `scripts/analyze-trace/analyze-trace.ts` for compact,
   thread-aware trace audits.
 - For work in `src/` or `test/`, consult the nearest folder `README.md` before
   deep file reads.

package/.github/skills/trace-audit-reporting/references/trace-analysis-workflow.md

@@ -116,7 +116,7 @@ Use these heuristics when the trace touches evaluation or inference paths:
 
 ## When to Extend the Analyzer
 
-Modify `scripts/analyze-trace.ts` only when the existing output cannot answer a
+Modify `scripts/analyze-trace/analyze-trace.ts` only when the existing output cannot answer a
 meaningful engineering question.
 
 Good reasons to extend it:

package/.github/workflows/ci.yml

@@ -11,11 +11,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Use Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
       - name: Install dependencies
         run: npm ci
       - name: Run tests

package/.github/workflows/deploy-pages.yml

@@ -22,12 +22,12 @@ jobs:
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version: 24
 
       - name: Install dependencies
         run: npm ci
@@ -36,13 +36,13 @@ jobs:
         run: npm run docs
 
       - name: Setup Pages
-        uses: actions/configure-pages@v5
+        uses: actions/configure-pages@v6
 
       - name: Upload docs artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         with:
           path: docs
 
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5

package/.github/workflows/manual_release_pipeline.yml

@@ -25,15 +25,15 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           ref: ${{ github.event.inputs.branch }}
           fetch-depth: 0
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
 
       - name: Install dependencies
         run: npm ci

package/.github/workflows/publish.yml

@@ -51,24 +51,23 @@ jobs:
       LOOP_SKIP: 'false'
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Use npm cache
         if: ${{ env.LOOP_SKIP == 'false' }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version: 24
           cache: 'npm'
 
       - name: Setup Node (npmjs)
         if: ${{ env.LOOP_SKIP == 'false' }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version: 24
           registry-url: https://registry.npmjs.org
-          always-auth: true
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
@@ -141,11 +140,10 @@ jobs:
 
       - name: Setup Node (GitHub Packages)
         if: ${{ env.LOOP_SKIP == 'false' }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version: 24
           registry-url: https://npm.pkg.github.com/
-          always-auth: true
         env:
           NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
@@ -188,17 +186,18 @@ jobs:
           fi
       - name: Create GitHub Release
         if: ${{ env.LOOP_SKIP == 'false' && env.RUN_PUBLISH == 'true' && github.event_name != 'release' }}
-        uses: actions/create-release@v1
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: v${{ steps.pkgver.outputs.version }}
-          release_name: v${{ steps.pkgver.outputs.version }}
-          body: |
-            Automated release for version v${{ steps.pkgver.outputs.version }}.
-            Generated by publish workflow.
-          draft: false
-          prerelease: false
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -e
+          TAG="v${{ steps.pkgver.outputs.version }}"
+          if gh release view "$TAG" >/dev/null 2>&1; then
+            echo "GitHub release $TAG already exists."
+          else
+            gh release create "$TAG" \
+              --title "$TAG" \
+              --notes "Automated release for version $TAG.\nGenerated by publish workflow."
+          fi
 
       - name: Summary
         run: |

package/.github/workflows/release_dispatch.yml

@@ -12,14 +12,14 @@ jobs:
   bump-and-release:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
 
       - name: Install deps
         run: npm ci

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reicek/neataptic-ts",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "Architecture-free neural network library with genetic algorithm implementations",
   "main": "./dist/neataptic.js",
   "module": "./dist/neataptic.js",
@@ -12,6 +12,7 @@
     "pretest": "npm run build",
     "test:bench": "npm run jest:base -- --no-cache --runInBand --verbose --testPathPatterns=benchmark",
     "bench:asciiMaze": "node -r ts-node/register test/benchmarks/asciiMaze.micro.bench.ts",
+    "bench:tables": "npm run docs:build-scripts && node ./dist-docs/scripts/generate-bench-tables.js",
     "test:silent": "npm run jest:base -- --no-cache --coverage --collect-coverage --runInBand --testPathIgnorePatterns=.e2e.test.ts --testPathIgnorePatterns=benchmark\\..*\\.test\\.ts$ --silent",
     "deploy": "npm run build && npm run test:dist && npm publish",
     "build": "npm run build:webpack && npm run build:ts",
@@ -20,28 +21,33 @@
     "build:ascii-maze": "npx esbuild test/examples/asciiMaze/browser-entry.ts --bundle --outfile=docs/assets/ascii-maze.bundle.js --platform=browser --format=iife --minify --sourcemap --external:fs --external:child_process --external:path",
     "build:flappy-worker": "npx esbuild test/examples/flappy_bird/flappyEvolution.worker.ts --bundle --outfile=docs/assets/flappy-evolution.worker.bundle.js --platform=browser --format=iife --minify --sourcemap --external:fs --external:child_process --external:path",
     "build:flappy-bird": "npx esbuild test/examples/flappy_bird/browser-entry/browser-entry.ts --bundle --outfile=docs/assets/flappy-bird.bundle.js --platform=browser --format=iife --minify --sourcemap --external:fs --external:child_process --external:path",
-    "trace:analyze": "npx ts-node scripts/analyze-trace.ts",
+    "trace:analyze": "npm run docs:build-scripts && node ./dist-docs/scripts/analyze-trace/analyze-trace.js",
     "start:local-server": "npx http-server . -p 8080 -c-1",
     "start:ts": "ts-node src/neataptic.ts",
     "test:e2e": "cross-env FORCE_COLOR=true NODE_OPTIONS=--no-experimental-webstorage jest e2e.test.ts --config=jest.config.mjs --no-cache --runInBand",
     "test:e2e:logs": "npm run jest:base -- e2e.test.ts --verbose --runInBand --no-cache",
     "test:dist": "npm run build:ts && npm run jest:base -- --no-cache --coverage --collect-coverage --runInBand --testPathIgnorePatterns=.e2e.test.ts --testPathIgnorePatterns=benchmark\\..*\\.test\\.ts$",
-    "docs:build-scripts": "tsc -p tsconfig.docs.json && node scripts/write-dist-docs-pkg.mjs",
-    "docs:folders:src": "npm run docs:build-scripts && node ./dist-docs/scripts/generate-docs.js --target=src",
-    "docs:folders:asciiMaze": "npm run docs:build-scripts && node ./dist-docs/scripts/generate-docs.js --target=asciiMaze",
-    "docs:folders:flappy-bird": "npm run docs:build-scripts && node ./dist-docs/scripts/generate-docs.js --target=flappy-bird",
-    "docs:folders": "npm run docs:folders:src && npm run docs:folders:asciiMaze && npm run docs:folders:flappy-bird",
-    "docs:html": "npm run docs:build-scripts && node ./dist-docs/scripts/render-docs-html.js",
-    "docs:mermaid:validate": "node ./scripts/mermaid-cli.mjs validate",
-    "docs:mermaid:export": "node ./scripts/mermaid-cli.mjs export",
-    "docs:examples": "node scripts/copy-examples.mjs",
+    "docs:build-scripts": "tsc -p tsconfig.docs.json && node ./dist-docs/scripts/write-dist-docs-pkg.js",
+    "docs:folders:src:built": "node ./dist-docs/scripts/generate-docs/generate-docs.js --target=src",
+    "docs:folders:src": "npm run docs:build-scripts && npm run docs:folders:src:built",
+    "docs:folders:asciiMaze:built": "node ./dist-docs/scripts/generate-docs/generate-docs.js --target=asciiMaze",
+    "docs:folders:asciiMaze": "npm run docs:build-scripts && npm run docs:folders:asciiMaze:built",
+    "docs:folders:flappy-bird:built": "node ./dist-docs/scripts/generate-docs/generate-docs.js --target=flappy-bird",
+    "docs:folders:flappy-bird": "npm run docs:build-scripts && npm run docs:folders:flappy-bird:built",
+    "docs:folders": "npm run docs:build-scripts && node ./dist-docs/scripts/run-docs.js folders",
+    "docs:html:built": "node ./dist-docs/scripts/render-docs-html.js",
+    "docs:html": "npm run docs:build-scripts && npm run docs:html:built",
+    "docs:mermaid:validate": "npm run docs:build-scripts && node ./dist-docs/scripts/mermaid-cli.js validate",
+    "docs:mermaid:export": "npm run docs:build-scripts && node ./dist-docs/scripts/mermaid-cli.js export",
+    "docs:examples:built": "node ./dist-docs/scripts/copy-examples.js",
+    "docs:examples": "npm run docs:build-scripts && npm run docs:examples:built",
     "prettier": "npm run prettier:tests && npm run prettier:src",
     "prettier:tests": "npx prettier --write test/**/*.ts",
     "prettier:src": "npx prettier --write src/**/*.ts",
-    "docs": "npm run build:ascii-maze && npm run build:flappy-worker && npm run build:flappy-bird && npm run docs:examples && npm run docs:folders && node ./dist-docs/scripts/render-docs-html.js",
+    "docs": "npm run docs:build-scripts && node ./dist-docs/scripts/run-docs.js all",
     "lint": "eslint src/ test/",
     "lint:fix": "eslint src/ --fix",
-    "onnx:export": "node scripts/export-onnx.mjs"
+    "onnx:export": "npm run docs:build-scripts && node ./dist-docs/scripts/export-onnx.js"
   },
   "exports": {
     ".": {
@@ -60,13 +66,13 @@
     "@types/seedrandom": "^3.0.8",
     "@types/webpack": "^5.28.5",
     "@types/webpack-dev-server": "^4.7.2",
-    "@typescript-eslint/eslint-plugin": "^8.57.0",
-    "@typescript-eslint/parser": "^8.57.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
     "chai": "^6.2.2",
     "copy-webpack-plugin": "^14.0.0",
     "cross-env": "^10.1.0",
     "esbuild": "^0.27.4",
-    "eslint": "^10.0.3",
+    "eslint": "^10.1.0",
     "eslint-plugin-prefer-arrow": "^1.2.3",
     "fast-glob": "^3.3.3",
     "fs-extra": "^11.3.4",
@@ -74,7 +80,7 @@
     "jest": "^30.3.0",
     "jest-environment-jsdom": "^30.3.0",
     "jsdoc-to-markdown": "^9.1.3",
-    "marked": "^17.0.4",
+    "marked": "^17.0.5",
     "mermaid": "^11.13.0",
     "mkdocs": "^0.0.1",
     "puppeteer": "^23.11.1",
@@ -83,9 +89,9 @@
     "ts-morph": "^27.0.2",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "undici-types": "^7.24.0",
+    "undici-types": "^7.24.6",
     "webpack": "^5.105.4",
-    "webpack-cli": "^6.0.1"
+    "webpack-cli": "^7.0.2"
   },
   "repository": {
     "type": "git",
@@ -120,6 +126,6 @@
   },
   "dependencies": {
     "seedrandom": "^3.0.5",
-    "undici": "^7.24.0"
+    "undici": "^7.24.6"
   }
 }

package/plans/Flappy_Bird_Folder_Documentation_Pass.md

@@ -37,13 +37,13 @@ tour of the example architecture rather than a sparse export inventory.
 ## Steps
 
 - [x] Step 1: Tidy the root `test/examples/flappy_bird` surface and verify the
-  README inventory-driven workflow.
+      README inventory-driven workflow.
 - [x] Step 2: Tidy the worker and trainer-facing folders.
 - [x] Step 3: Tidy shared simulation, environment, constants, and evaluation
-  folders.
+      folders.
 - [x] Step 4: Tidy browser-entry and its nested README-owning folders one by one.
 - [x] Step 5: Regenerate docs, run focused validation, and record any durable
-  boundary notes that changed during the pass.
+      boundary notes that changed during the pass.
 
 ## Step 1 Inventory
 
@@ -114,4 +114,4 @@ tour of the example architecture rather than a sparse export inventory.
 - The todo list reflects completion folder by folder.
 - Docs regeneration succeeds after documentation-affecting changes.
 - A later session can resume from this plan and the todo list without prior chat
-  history.
+  history.

package/plans/README.md

@@ -25,34 +25,57 @@ Recommended reading order:
 
 Selection guide:
 
+- `plans/analyze-trace-solid-split.plans.md`: completed trace-analyzer tooling split and reopen point for future script-boundary work.
+- `plans/architecture-solid-split.plans.md`: active architecture folderization and boundary-ownership cleanup across `src/architecture`.
 - `plans/neat.plans.md`: core NEAT correctness, innovation tracking, crossover alignment, speciation invariants.
 - `plans/Roadmap.md`: dependency-aware execution order across all initiatives.
 - `plans/Architecture_Primitives_Node_Group_Layer.md`: first-class architecture-building primitives such as nodes, groups, and layers.
+- `plans/asciiMaze-typescript-repair.plans.md`: completed `asciiMaze` TypeScript repair baseline and reopen point for future diagnostics.
 - `plans/Browser_Build_and_CDN_Distribution.md`: browser packaging, CDN usage, and distribution ergonomics.
 - `plans/Construct_From_Parts_Graph_Assembly.md`: deterministic graph assembly and validated network construction from parts.
+- `plans/ES2023 migration`: repository-wide ES2023 syntax and modernization lane.
 - `plans/Evolution_Training_Interoperability_Contracts.md`: contracts between evolution workflows and gradient-based training.
+- `plans/Flappy_Bird_Folder_Documentation_Pass.md`: completed Flappy Bird folder documentation baseline and reopen point for example-docs follow-up.
+- `plans/generate-docs-solid-split.plans.md`: completed docs-generator tooling split and reopen point for future `scripts/generate-docs/` work.
 - `plans/HyperEvoDevoMorphoNEAT.md`: evo-devo and morphology-oriented research direction.
 - `plans/Interactive_Examples_and_Learning_Path.md`: runnable examples, onboarding flow, and learning-path improvements.
 - `plans/Memory_Optimization.md`: scaling, memory layout, and strategies for very large networks.
+- `plans/methods-docs.plans.md`: completed educational-docs lane for `src/methods` and reopen point for methods documentation drift.
+- `plans/methods-solid-split.plans.md`: completed structural split lane for `src/methods` and reopen point for later refactors.
+- `plans/neat-docs.plans.md`: active educational-docs lane for NEAT surfaces and generated README quality.
+- `plans/neat-test-surface-repair.plans.md`: completed NEAT public test-surface repair baseline and reopen point for future compatibility regressions.
 - `plans/Network_Visualization_Export_Schema.md`: stable export schema for visualization and inspection tooling.
 - `plans/ONNX_EXPORT_PLAN.md`: ONNX export/import architecture and rollout phases.
 - `plans/Population_Save_Resume_and_Checkpointing.md`: checkpointing, persistence, save/resume workflows.
 - `plans/Preconfigured_Architectures_MLP_LSTM_GRU_NARX.md`: prebuilt architecture constructors and sequence-oriented builders.
+- `plans/render-docs-html-solid-split.plans.md`: completed HTML docs renderer split and reopen point for future docs-site tooling work.
 - `plans/src-no-explicit-any-cleanup.plans.md`: completed `src/` strict-typing cleanup baseline for `@typescript-eslint/no-explicit-any`, kept as the reopen point if later refactors reintroduce debt.
 - `plans/Stable_Activation_Ordering_and_Explicit_IO_Roles.md`: deterministic execution ordering and explicit input/output roles.
 - `plans/Standalone_Inference_Export.md`: dependency-free exported inference runtime.
 - `plans/Turnkey_Multithread_Evaluation_API.md`: parallel evaluation API for Node and browser workers.
+- `plans/utils-docs.plans.md`: completed educational-docs lane for `src/utils` and reopen point for later documentation drift.
 - `plans/Worker_Friendly_Network_Serialization_Fastpath.md`: fast serialization path for worker-based evaluation.
 
 Task-to-plan trigger phrases:
 
+- trace analyzer, Chrome trace, Perfetto report script, `trace:analyze`, tooling split reopen: `plans/analyze-trace-solid-split.plans.md`
+- architecture split, folderization, orchestration-first cleanup in `src/architecture`: `plans/architecture-solid-split.plans.md`
 - NEAT correctness, innovation IDs, crossover, compatibility distance, speciation: `plans/neat.plans.md`
 - roadmap, sequence, dependency order, what comes first: `plans/Roadmap.md`
 - architecture builder, layer API, node/group primitives: `plans/Architecture_Primitives_Node_Group_Layer.md`
+- asciiMaze TypeScript diagnostics, example test compile failures, reopen asciiMaze repair: `plans/asciiMaze-typescript-repair.plans.md`
 - construct from parts, graph assembly, deterministic builder: `plans/Construct_From_Parts_Graph_Assembly.md`
 - browser bundle, CDN, browser-first usage: `plans/Browser_Build_and_CDN_Distribution.md`
+- ES2023, immutable array methods, modernization pass, syntax cleanup, migration sequencing: `plans/ES2023 migration`
+- Flappy Bird docs pass, example folder documentation, generated README quality for Flappy: `plans/Flappy_Bird_Folder_Documentation_Pass.md`
+- generate-docs, folder README generation, docs.order, docs generator split: `plans/generate-docs-solid-split.plans.md`
 - ONNX, import/export interoperability: `plans/ONNX_EXPORT_PLAN.md`
+- methods docs, methods README quality, educational-docs for methods: `plans/methods-docs.plans.md`
+- methods split, `src/methods` refactor, methods folderization: `plans/methods-solid-split.plans.md`
+- NEAT docs, generated README quality, NEAT documentation lane: `plans/neat-docs.plans.md`
+- NEAT test surface, public type compatibility, root facade repair: `plans/neat-test-surface-repair.plans.md`
 - explicit any, no-explicit-any, strict typing, src lint cleanup follow-up, reopen completed cleanup lane: `plans/src-no-explicit-any-cleanup.plans.md`
+- HTML docs renderer, sidebar, Mermaid validation, docs site tooling split: `plans/render-docs-html-solid-split.plans.md`
 - visualization, schema, inspect network shape: `plans/Network_Visualization_Export_Schema.md`
 - checkpoint, resume, save population: `plans/Population_Save_Resume_and_Checkpointing.md`
 - workers, threads, parallel evaluation: `plans/Turnkey_Multithread_Evaluation_API.md`
@@ -64,6 +87,7 @@ Task-to-plan trigger phrases:
 - preconfigured models, MLP, LSTM, GRU, NARX builders: `plans/Preconfigured_Architectures_MLP_LSTM_GRU_NARX.md`
 - examples, tutorials, learning path, onboarding: `plans/Interactive_Examples_and_Learning_Path.md`
 - evo-devo, morphology, research-heavy extensions: `plans/HyperEvoDevoMorphoNEAT.md`
+- utils docs, utility README quality, educational-docs for `src/utils`: `plans/utils-docs.plans.md`
 
 Working rule:
 When a task changes code in a way that could conflict with one of these plans, mention the relevant plan in the working notes or final summary and call out any mismatch instead of silently diverging from the roadmap.