agents: Update test guidance

7855c231de3fdb4b27a4a8285c6c17bb32bd46149ac90b5783d26ecf2c3dc98d
Describe the current test suites and correct the focused fixture
command. Remove obsolete session fixture guidance.

Assisted-by: Codex:gpt-6
Alexis Sellier committed ago 1 parent 5ce29261
AGENTS.md +6 -6
98 98
commands are listed in `test/integration.rad`. Child programs have instruction
99 99
budgets instead of wall-clock timeouts.
100 100
101 101
```bash
102 102
timeout 300 make           # Build bin/radiance.rv64.dev from the seed
103 -
timeout 600 make test      # Seed format, std, and binary tests
103 +
timeout 600 make test      # All test suites, including kernel and machine tests
104 104
timeout 300 make std-test  # Standard library tests
105 -
timeout 300 make bin-test  # All IL and executable checks
105 +
timeout 300 make bin-test  # Fixture IL, execution, and rejection checks
106 106
timeout 300 make host-test # std::process against the emulator
107 107
timeout 300 make fmt       # Format the std and kernel sources in place
108 108
```
109 109
110 110
For one executable fixture, replace `NAME` with its basename:
111 111
112 112
```bash
113 113
timeout 300 make test/runner.rv64 test/integration.rv64 test/tests/NAME.rv64
114 -
timeout 10 "$RAD_EMULATOR" -run test/integration.rv64 bin test/tests/NAME.rad
114 +
timeout 10 "${RAD_EMULATOR:-emulator}" $(cat seed/emulator-args) -run \
115 +
    test/integration.rv64 bin test/tests/NAME.rad
115 116
```
116 117
117 118
For an IL-only fixture, build only `test/runner.rv64` and
118 119
`test/integration.rv64` before running the driver. The driver runs existing
119 120
binaries; it does not build them.
125 126
  RV64 backend and assembler code is in `lib/std/arch/rv64/`.
126 127
- Tests: read nearby fixtures and `test/integration/fixtures.rad` for supported
127 128
  checks. `.ril` files check IL; `//! returns: N` requests an executable check.
128 129
  Success fixtures use `@default fn main`, assertions, and a zero return.
129 130
  Inspect generated IL before accepting a new snapshot.
130 -
- Session fixtures: `//! session-support` uses `test/support/std.lib`. Keep
131 -
  individual golden checks below one second. Test production std behavior in std
132 -
  unit suites. Module lists are in `std.lib` and `std.lib.test`.
131 +
- Test production std behavior in std unit suites. Module lists are in
132 +
  `std.lib` and `std.lib.test`.
133 133
- Backend debugging: locate the first incorrect stage, from AST and resolution
134 134
  through IL, assembly, and execution. Use Make recipes with the existing
135 135
  `RADIANCE` settings for diagnostic compilation.
136 136
- Bootstrap changes: read `seed/README`. The seed must compile checked-in source.
137 137
  Update it only when needed, through `timeout 600 make seed` or the documented