diff options
| author | Cliff Click <cliffc@acm.org> | 2026-11-15 16:11:39 -0800 |
|---|---|---|
| committer | Cliff Click <cliffc@acm.org> | 2026-11-15 16:11:39 -0800 |
| commit | 9fe7c6f9697b5bbf3041261fdc60040e75cc674f (patch) | |
| tree | d92a8ff20ed984938d90ad8917b4d67fba9fb745 /skills | |
| parent | f0a6c6757a795b8e186de0076836a87acef59fa7 (diff) | |
| download | Simple-ch32.tar.gz Simple-ch32.zip | |
Split off chapter 31ch32
Ch 32 will be focused on compiler performance issues.
Diffstat (limited to 'skills')
| -rw-r--r-- | skills/chapter-split.md | 9 | ||||
| -rw-r--r-- | skills/chapter25-codex-notes.md | 21 |
2 files changed, 26 insertions, 4 deletions
diff --git a/skills/chapter-split.md b/skills/chapter-split.md index c5dee447..6e0846f4 100644 --- a/skills/chapter-split.md +++ b/skills/chapter-split.md @@ -20,9 +20,16 @@ On 2026-11-08, Cliff merged and pushed Chapter 30, then requested [Chapter 31](../chapter31/README.md) on branch `ch31`. It starts from the completed Chapter 30 compiler. Chapter 31 develops software drawing, audio, time and math libraries, array initialization and static data, and graphical -games including tic-tac-toe and Breakout. New work belongs in `chapter31/`, +games including tic-tac-toe and Breakout. That work completed in `chapter31/`, preserving Chapter 30 as the preceding snapshot. +On 2026-11-15, Cliff closed Chapter 31 as the graphics, games, and library +snapshot and requested [Chapter 32: Compiler Internal Speedups](../chapter32/README.md) +on branch `ch32`. Move the test parallelism/JVM sizing, shallow type queries, +verification sampling, and worklist filtering into the new complete snapshot. +Keep the completed graphics/library code, including current runtime-argument +and README edits, in Chapter 31. New compiler work belongs in `chapter32/`. + | Previous directory | Final chapter | |---|---| | chapter-sccp | 24a: SCCP within a function | diff --git a/skills/chapter25-codex-notes.md b/skills/chapter25-codex-notes.md index 05c11a7f..e7362c3b 100644 --- a/skills/chapter25-codex-notes.md +++ b/skills/chapter25-codex-notes.md @@ -33,9 +33,24 @@ field shapes, existing Iter/SCCP propagates them, and TypeCheck checks and erase the views. Borrowed partials can read proven fields but cannot write; unknown callers promise no initialized fields. No new passes or backward demand walks. -## Chapter 31: restart guidance (2026-11-14) +## Chapter 32: restart guidance (2026-11-15) -Continue work in `chapter31/`; preserve the preceding chapter snapshots. +Continue in `chapter32/` on branch `ch32`. Chapter 31 is complete as the +graphics, games, and library snapshot; keep its compiler before the speedups. +The chapter32 README teaches the current performance work: parallel test JVMs +and lattice partitions, shallow isConstant/isFinal, log-10 verification, and +narrow worklist notifications. It also records measurements and next targets. +Each snapshot remains independently runnable. Retain native coverage and the +existing Make/JUnit harness; use identity maps for Node bookkeeping. + +The copied local profiling scripts and evidence are under chapter32/build/test-profile, +outside the tracked compiler. Full tests passed before the move at default and +log-8 verification, with focused regressions at log 1. These are dated results. +Read current Git state; the chapter split does not imply a commit or push. + +## Chapter 31: completed snapshot (2026-11-14 guidance, superseded by Chapter 32) + +Chapter 31 is complete; preserve it and the preceding chapter snapshots. There is no unfinished task from this session. Check Git status before editing: Cliff is actively refactoring Breakout and editing README/Canvas alongside us. Preserve those edits and let him do the game-method moves himself. No commit, @@ -169,7 +184,7 @@ arbitrary TypePtr values at outside escapes. ## Chapter 29 parser snapshot (historical) Chapter 29 is **Tech Debt Cleanup**. Cliff approved keeping the parser split -and moving it into that snapshot; current work belongs in Chapter 31. Chapter 28b +and moving it into that snapshot; current work belongs in Chapter 32. Chapter 28b retains the original parser. The new `parser/` package follows the grammar; `Var` belongs there and `IterPeeps` belongs in `codegen/`. |
