Planned work

Forward-looking roadmaps: what is intended, why, the open problems, and the design of features not yet built. These are distinct from the design docs one level up (../), which describe the system as it is — when a feature here ships, its durable design moves up to the matching design doc and the entry here shrinks to whatever remains open.

Roadmap	Scope	Design doc
RELEASE.md	Cross-cutting initial-release punchlist: release scope, deferred features, and per-subsystem completion/validation items.	—
OPTIMIZER.md	Completing the O2 SSA mid-end, expanded inlining, -O0/-O1 performance work, machine register-constraint improvements.	../OPT.md
LINKER.md	Incremental linking: the file-based object-link redesign and remaining non-ELF format coverage.	../LINK.md
JIT.md	Function-level hot reload, Go-runtime-style codegen support, and remaining JIT host-portability work.	../JIT.md
DEBUG.md	The Windows debugger host adapter, x64/rv64 displaced single-step, profiling, and DWARF gaps.	../DBG.md, ../DWARF.md
WASM.md	Completing the Wasm object backend and remaining parser/validator coverage.	../WASM.md
ARCH.md	Remaining native-backend completeness for x64/rv64 relative to the aa64 reference, and per-call cost follow-ups.	../ARCH.md
BOOTSTRAP.md	The 3-stage self-build reproducibility goal and the open -O1 issues blocking it.	../BUILD.md
windows.md	Self-hosting kit on Windows: cross-built kit.exe runs cc + JIT on aarch64-windows; the open self-host miscompile crash, JIT printf, x64 parity, compile-on-VM lane, and the Windows 3-stage bootstrap.	../WINDOWS.md
BUILD.md	A new content-addressed build coordinator (Bazel/Nix-style incremental builds layered on the CAS) — storage state machine, caching algorithm, recipe protocol. Distinct from ../BUILD.md (kit's own Makefile build).	— (new subsystem)
BUILD_COMMANDS.md	The kit-native build-exe/build-lib/build-obj verbs that replace compile: polyglot, in-memory compile+link with --group flag scoping and full link-flag control. Distinct from BUILD.md (the CAS coordinator).	../DRIVER.md
LLGEN_IMPORT.md	Importing the standalone LL(1)/Pratt parser and lexer generator into libkit, including public API renames, file moves, build gates, and a kit llgen command.	—
TODO.md	Open deferred fixes and code smells only. Completed items are removed instead of checked off. Not a roadmap; a current backlog.	—