@tscircuit/fanout-solver 0.0.15 → 0.0.17

package/README.md

@@ -198,6 +198,44 @@ parameters. Each sample has one shared boundary around all of its footprints,
 and component bounds come from the exact footprinter-generated copper pad
 extents.
 
+## SRJ19 benchmark
+
+The repository also loads all 200 samples from
+[`tscircuit/dataset-srj19`](https://github.com/tscircuit/dataset-srj19) as a
+pinned development dependency. The adapter keeps the complete obstacle field
+but selects only connections that touch the BGA, producing progressively larger
+fanout problems with opposite-side passive overlays. Every adapted problem uses
+the same six-layer stackup (`top`, `inner1` through `inner4`, and `bottom`) so
+benchmark improvements are directly comparable.
+
+Run the full benchmark with:
+
+```sh
+./benchmark.sh
+```
+
+Use `--sample sample001`, `--limit 10`, or
+`--max-layer-combinations 16` for shorter runs. Samples run one at a time by
+default and print progress as they finish. `--concurrency 8` runs isolated
+samples in parallel, and `--sample-timeout-seconds 600` prevents a difficult
+sample from blocking the remaining work. Each run writes the full ordered
+results to `benchmark-results/srj19.json` and
+`benchmark-results/srj19.md`. Partial solutions are reported as benchmark
+results instead of failing the command, making current completion rates a
+baseline for solver improvements. `bun run benchmark:srj19` is an alias for the
+same command.
+
+The `SRJ19 Benchmark` GitHub Actions workflow runs the complete dataset on a
+Blacksmith 32-vCPU ARM runner with 32 sample processes by default. It can be
+started manually with an optional sample id, or for a pull request by adding
+`[BENCHMARK TEST]` to its title. The workflow publishes the Markdown summary and
+uploads both reports as an artifact.
+
+Run `bun run start` and open the `datasets/srj19` Cosmos fixture to step the
+selected sample through `GenericSolverDebugger`. The page has Previous/Next,
+sample dropdown, and range controls and stores the selection in the `sample`
+URL parameter.
+
 ## Dataset 02
 
 `datasets/dataset02.ts` is the four-layer BGA400 stress benchmark. It routes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/fanout-solver",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "BGA fanout solver with coordinated bus-layer escapes for SimpleRouteJson",
   "module": "lib/index.ts",
   "type": "module",
@@ -28,6 +28,7 @@
     "typecheck": "bunx tsc --noEmit",
     "test": "bun test",
     "benchmark": "bun benchmarks/run-benchmark.ts",
+    "benchmark:srj19": "./benchmark.sh",
     "render:dataset": "bun scripts/render-dataset-pngs.ts",
     "format": "biome format --write .",
     "format:check": "biome format ."
@@ -39,6 +40,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.5",
+    "@tsci/tscircuit.dataset-srj19-bga-passive-overlays": "github:tscircuit/dataset-srj19#c1206f3",
     "@tscircuit/footprinter": "0.0.394",
     "@types/bun": "1.3.14",
     "@types/react": "19.2.14",