diff options
Diffstat (limited to 'skills')
| -rw-r--r-- | skills/chapter-split.md | 6 | ||||
| -rw-r--r-- | skills/chapter25-codex-notes.md | 37 |
2 files changed, 29 insertions, 14 deletions
diff --git a/skills/chapter-split.md b/skills/chapter-split.md index 67a974e4..3ec656a9 100644 --- a/skills/chapter-split.md +++ b/skills/chapter-split.md @@ -4,6 +4,12 @@ Cliff approved the seven-part split on 2026-10-19 and the final numbering on 2026-10-24. The old combined Chapters 24 and 25 are retired; their history is available in Git. Every new directory is a complete compiler snapshot. +On 2026-11-01, Cliff added [Chapter 29: Tech Debt Cleanup](../chapter29/README.md). +It starts from Chapter 28b with the parser split into `parser/` components, +`Var` in that package, and `IterPeeps` in `codegen/`. Keep Chapter 28b's original +parser as the preceding snapshot. Source privacy is deferred; the privacy +experiments and test-fixture adaptations are not part of the new chapter. + | 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 4632698a..ff5722a2 100644 --- a/skills/chapter25-codex-notes.md +++ b/skills/chapter25-codex-notes.md @@ -18,20 +18,27 @@ The [incremental build design](incremental-builds.md) expands the roadmap's dependency and output-ownership requirements. For shared viewer work, read [the graph viewer notes](graph-viewer-codex-notes.md). -## Reset checkpoint (2026-10-29) +## Current workspace (2026-11-01) -Chapter 28b's Encoding/Export cleanup is committed as `f47c7d1f`; the tree -was clean before this notes update. All 570 chapter tests passed on Windows -and Linux. Encoding prepares per-unit objects; Export only writes/links them. -Select combined in-memory output before Encoding, and request Serialize before -Lower for file output. There is no Export fallback that re-encodes the graph. +Chapter 29 is **Tech Debt Cleanup**. Cliff approved keeping the parser split +and moving it into this new snapshot; continue parser work there. Chapter 28b +retains the original parser. The new `parser/` package follows the grammar; +`Var` belongs there and `IterPeeps` belongs in `codegen/`. -Cliff wants to pivot to new language work and a new chapter. The next project -has not been chosen: discuss it before implementing. His goals are readable, -simple, usable; type variables/generics for real collections and low-annotation -automatic memory reclamation are major priorities. Privacy and subclassing -are smaller candidates. The roadmap owns remaining cleanup work; do not resume -it automatically or create a chapter merely because a reset happened. +Source privacy is deferred. `ai_priv` retains the earlier implementation, +`cc_priv` the tests, and local branch `archive/cc_priv-parser-before-ch29` +preserves the combined working state before the split. Do not reintroduce +privacy checks or fixture adaptations as incidental parser cleanup. + +Constructor completion remains open. `addReturn` merges field states already, +but final helper memory can hide missing initialization after conversions. +`parseInitializer` returns the declaration initializer, not the user constructor. +Prefer simplifying around the merged scope before stores; consider the older +same-named constructor binding, parsed before later fields, when removing +`_ctorExits`. No constructor semantics were changed by the chapter split. + +The roadmap retains language candidates, including automatic memory management +and a small game with graphics, keyboard input, and sound. ## Collaboration preferences @@ -61,8 +68,10 @@ it automatically or create a chapter merely because a reset happened. with a ternary expression over an if/else. - Do not wrap normal compiler algorithms in try/finally when no exceptions are expected. Keep the lifetime and phase transitions explicit. -- Space declaration initializers as `Type name = expression;`. Preserve - deliberate column alignment when it makes related declarations easier to read. +- Space assignments and declaration initializers as `x = expression` and + `Type name = expression;`. Preserve deliberate column alignment across rows. +- Name the shared parser reference `P`, including in parser components, to match + `CodeGen.P`. - Do not introduce Java streams. Use loops and explicit sorts; ask Cliff before making any exception. - Cliff often debugs the same failure in parallel. If asked to work in a side |