TSZ Project Bench
Use for project-corpus rows, benchmark harness, fixture metadata, PGO bench
setup, and website benchmark data.
Rules
- Read
AGENTS.md and docs/plan/ROADMAP.md for durable benchmark/project
work.
- Inspect overlapping PRs/issues.
- Red row = correctness blocker before speed problem unless failure is runtime,
residency, timeout, or OOM.
- Keep fixture metadata shared across
project-fixtures.sh,
bench-vs-tsgo.sh, and project-compile-guard.sh.
- Wrap long/heavy local commands with
scripts/safe-run.sh.
Sources
scripts/bench/project-fixtures.shscripts/bench/bench-vs-tsgo.shscripts/ci/project-compile-guard.shcrates/tsz-website/src/_data/benchmark_data.js.github/workflows/bench.yml
Workflow
- Identify row, phase, and first failure: prepare,
tsc validation, tsz check,
emit scope, crash, timeout, OOM, metadata, website ingestion, timing.
- Required/canary/all set:
TSZ_PROJECT_COMPILE_SET=<required|canary|all>.
- Reproduce with the narrowest filter.
- If typecheck fails, reduce to owning compiler operation before optimizing.
- For speed work, name repeated operation and complexity change. No
fixture-name special cases.
Commands
./scripts/bench/bench-vs-tsgo.sh --prepare-only
./scripts/bench/bench-vs-tsgo.sh --quick --filter "<row>" --json-file /tmp/bench.json
TSZ_PROJECT_COMPILE_FILTER="<row>" TSZ_PROJECT_COMPILE_SET=required scripts/ci/project-compile-guard.sh
TSZ_PROJECT_COMPILE_ALLOW_FAILURES=1 TSZ_PROJECT_COMPILE_SET=all scripts/ci/project-compile-guard.sh
PR notes: goal (green, fast, or grow), row, before/after failure class,
first broken phase, owner layer, fixture metadata changes, whether timing is
meaningful, commands/CI links.
1---2name: tsz-project-bench3description: Work on TSZ benchmark and project-corpus compatibility. Use when investigating bench.yml failures, project compile guard rows, benchmark dashboard data, PGO bench setup, fixture metadata drift, or real-project blockers such as utility-types, ts-toolbelt, ts-essentials, rxjs, type-fest, zod, kysely, Next, or Vite.4---56# TSZ Project Bench78Use for project-corpus rows, benchmark harness, fixture metadata, PGO bench9setup, and website benchmark data.1011## Rules1213- Read `AGENTS.md` and `docs/plan/ROADMAP.md` for durable benchmark/project14 work.15- Inspect overlapping PRs/issues.16- Red row = correctness blocker before speed problem unless failure is runtime,17 residency, timeout, or OOM.18- Keep fixture metadata shared across `project-fixtures.sh`,19 `bench-vs-tsgo.sh`, and `project-compile-guard.sh`.20- Wrap long/heavy local commands with `scripts/safe-run.sh`.2122## Sources2324- `scripts/bench/project-fixtures.sh`25- `scripts/bench/bench-vs-tsgo.sh`26- `scripts/ci/project-compile-guard.sh`27- `crates/tsz-website/src/_data/benchmark_data.js`28- `.github/workflows/bench.yml`2930## Workflow31321. Identify row, phase, and first failure: prepare, `tsc` validation, tsz check,33 emit scope, crash, timeout, OOM, metadata, website ingestion, timing.342. Required/canary/all set: `TSZ_PROJECT_COMPILE_SET=<required|canary|all>`.353. Reproduce with the narrowest filter.364. If typecheck fails, reduce to owning compiler operation before optimizing.375. For speed work, name repeated operation and complexity change. No38 fixture-name special cases.3940## Commands4142```bash43./scripts/bench/bench-vs-tsgo.sh --prepare-only44./scripts/bench/bench-vs-tsgo.sh --quick --filter "<row>" --json-file /tmp/bench.json45TSZ_PROJECT_COMPILE_FILTER="<row>" TSZ_PROJECT_COMPILE_SET=required scripts/ci/project-compile-guard.sh46TSZ_PROJECT_COMPILE_ALLOW_FAILURES=1 TSZ_PROJECT_COMPILE_SET=all scripts/ci/project-compile-guard.sh47```4849PR notes: goal (`green`, `fast`, or `grow`), row, before/after failure class,50first broken phase, owner layer, fixture metadata changes, whether timing is51meaningful, commands/CI links.
tsz-org