0
Fork 0
mirror of https://github.com/TanStack/router.git synced 2026-11-16 19:38:07 +00:00

docs(compiler-test-utils): oracle documents for compiler implementers

packages/compiler-test-utils/oracle/ explains the compiler test oracle to
whoever replaces or rewrites a compiler:

- SPEC.md: the spec the tests cite (G rules, J1-J7 clauses, §5 freedoms,
  §8 checking rules), with the maintainers' rulings folded in.
- RULINGS.md: the decisions behind the clauses, and the authorized test
  workarounds for upstream bugs with when to remove them.
- KNOWN-BUGS.md: the .fails pins by compiler job, generated from the
  tests, and the upstream issues.
- README.md: the goal, where each job's tests live, corpus vs
  implementation tests, pins, and how the suite was validated.

The package AGENTS.md files point to it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Sheraff 2026-10-20 23:41:24 +02:00
commit 1c4c5218dc
No known key found for this signature in database
9 changed files with 2141 additions and 0 deletions