Changelog
All notable changes to afs-as are documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
0.1.0 - 2026-04-06
Initial release. The standalone surface, library API, and differential test
suite are documented in README.md.
Added
- ARM64 instruction encoding for the supported standalone surface, including data processing, loads/stores, branches, FP/SIMD, atomics, system, and CFI.
- Two-pass assembler with label resolution, expression classification, and
Mach-O relocation emission (
PAGE21,PAGEOFF12,BRANCH26,GOT_LOAD_*,TLVP_LOAD_*,SUBTRACTOR,UNSIGNED,ADDEND). - Mach-O 64 object writer: header, segment, sections, symbol table, dynamic symbol table, build version, and linker optimization hints.
- Standalone CLI (
afs-as) with--help,--version,-o,-,--, and documented exit codes. - Library API:
assemble_source,assemble_stmts,assemble_instructions.assemble_instructionsis a trusted fast path used by the ARMFORTAS compiler and panics on invalidInstvalues by design. - Diagnostics with file, line, column, source snippet, and caret.
- Layered test infrastructure: instruction-level differential against Apple
as, full-object corpus parity, round-trip stability, structured fuzzing, garbage panic-resistance fuzzing, structured malformed-mutation rejection, end-to-end link/run, CLI smoke, diagnostic snapshots, performance sanity, and a clang probe dashboard covering ~94 C patterns at-O0and-O2.
View source
| 1 | # Changelog |
| 2 | |
| 3 | All notable changes to `afs-as` are documented in this file. |
| 4 | |
| 5 | The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), |
| 6 | and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). |
| 7 | |
| 8 | ## [Unreleased] |
| 9 | |
| 10 | ## [0.1.0] - 2026-04-06 |
| 11 | |
| 12 | Initial release. The standalone surface, library API, and differential test |
| 13 | suite are documented in `README.md`. |
| 14 | |
| 15 | ### Added |
| 16 | |
| 17 | - ARM64 instruction encoding for the supported standalone surface, including |
| 18 | data processing, loads/stores, branches, FP/SIMD, atomics, system, and CFI. |
| 19 | - Two-pass assembler with label resolution, expression classification, and |
| 20 | Mach-O relocation emission (`PAGE21`, `PAGEOFF12`, `BRANCH26`, `GOT_LOAD_*`, |
| 21 | `TLVP_LOAD_*`, `SUBTRACTOR`, `UNSIGNED`, `ADDEND`). |
| 22 | - Mach-O 64 object writer: header, segment, sections, symbol table, dynamic |
| 23 | symbol table, build version, and linker optimization hints. |
| 24 | - Standalone CLI (`afs-as`) with `--help`, `--version`, `-o`, `-`, `--`, and |
| 25 | documented exit codes. |
| 26 | - Library API: `assemble_source`, `assemble_stmts`, `assemble_instructions`. |
| 27 | `assemble_instructions` is a trusted fast path used by the ARMFORTAS |
| 28 | compiler and panics on invalid `Inst` values by design. |
| 29 | - Diagnostics with file, line, column, source snippet, and caret. |
| 30 | - Layered test infrastructure: instruction-level differential against Apple |
| 31 | `as`, full-object corpus parity, round-trip stability, structured fuzzing, |
| 32 | garbage panic-resistance fuzzing, structured malformed-mutation rejection, |
| 33 | end-to-end link/run, CLI smoke, diagnostic snapshots, performance sanity, |
| 34 | and a clang probe dashboard covering ~94 C patterns at `-O0` and `-O2`. |
| 35 | |
| 36 | [Unreleased]: https://github.com/FortranGoingOnForty/afs-as/compare/v0.1.0...HEAD |
| 37 | [0.1.0]: https://github.com/FortranGoingOnForty/afs-as/releases/tag/v0.1.0 |