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
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 |