@tscircuit/fanout-solver 0.0.16 → 0.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +18 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -204,7 +204,9 @@ The repository also loads all 200 samples from
204
204
  [`tscircuit/dataset-srj19`](https://github.com/tscircuit/dataset-srj19) as a
205
205
  pinned development dependency. The adapter keeps the complete obstacle field
206
206
  but selects only connections that touch the BGA, producing progressively larger
207
- two-layer fanout problems with opposite-layer passive overlays.
207
+ fanout problems with opposite-side passive overlays. Every adapted problem uses
208
+ the same six-layer stackup (`top`, `inner1` through `inner4`, and `bottom`) so
209
+ benchmark improvements are directly comparable.
208
210
 
209
211
  Run the full benchmark with:
210
212
 
@@ -213,10 +215,21 @@ Run the full benchmark with:
213
215
  ```
214
216
 
215
217
  Use `--sample sample001`, `--limit 10`, or
216
- `--max-layer-combinations 16` for shorter runs. Partial solutions are reported
217
- as benchmark results instead of failing the command, making current completion
218
- rates a baseline for solver improvements. `bun run benchmark:srj19` is an alias
219
- for the same command.
218
+ `--max-layer-combinations 16` for shorter runs. Samples run one at a time by
219
+ default and print progress as they finish. `--concurrency 8` runs isolated
220
+ samples in parallel, and `--sample-timeout-seconds 600` prevents a difficult
221
+ sample from blocking the remaining work. Each run writes the full ordered
222
+ results to `benchmark-results/srj19.json` and
223
+ `benchmark-results/srj19.md`. Partial solutions are reported as benchmark
224
+ results instead of failing the command, making current completion rates a
225
+ baseline for solver improvements. `bun run benchmark:srj19` is an alias for the
226
+ same command.
227
+
228
+ The `SRJ19 Benchmark` GitHub Actions workflow runs the complete dataset on a
229
+ Blacksmith 32-vCPU ARM runner with 32 sample processes by default. It can be
230
+ started manually with an optional sample id, or for a pull request by adding
231
+ `[BENCHMARK TEST]` to its title. The workflow publishes the Markdown summary and
232
+ uploads both reports as an artifact.
220
233
 
221
234
  Run `bun run start` and open the `datasets/srj19` Cosmos fixture to step the
222
235
  selected sample through `GenericSolverDebugger`. The page has Previous/Next,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tscircuit/fanout-solver",
3
- "version": "0.0.16",
3
+ "version": "0.0.17",
4
4
  "description": "BGA fanout solver with coordinated bus-layer escapes for SimpleRouteJson",
5
5
  "module": "lib/index.ts",
6
6
  "type": "module",