summaryrefslogtreecommitdiff
path: root/skills/chapter25-codex-notes.md
diff options
context:
space:
mode:
authorCliff Click <cliffc@acm.org>2026-11-15 16:11:39 -0800
committerCliff Click <cliffc@acm.org>2026-11-15 16:11:39 -0800
commit9fe7c6f9697b5bbf3041261fdc60040e75cc674f (patch)
treed92a8ff20ed984938d90ad8917b4d67fba9fb745 /skills/chapter25-codex-notes.md
parentf0a6c6757a795b8e186de0076836a87acef59fa7 (diff)
downloadSimple-9fe7c6f9697b5bbf3041261fdc60040e75cc674f.tar.gz
Simple-9fe7c6f9697b5bbf3041261fdc60040e75cc674f.zip
Split off chapter 31
Ch 32 will be focused on compiler performance issues.
Diffstat (limited to 'skills/chapter25-codex-notes.md')
-rw-r--r--skills/chapter25-codex-notes.md21
1 files changed, 18 insertions, 3 deletions
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/`.