conductor(deob_c11_ref): cluster_2_forth_bootslop_references.md - 2 forth reference files

3 sections. ~50 LOC. PRIMARY (forth references): 2 files (jombloforth.asm, jombloforth.f). Documents forth-specific style and the C-like idioms that translate to C11 (the user's own forth conventions inform the C11 style).
2026-06-23 20:33:43 -04:00
parent b9ac5318bb
commit 7986c2b25e
1 changed files with 53 additions and 0 deletions
@@ -0,0 +1,53 @@
+# Cluster 2: forth bootslop references (PRIMARY — forth references)
+
+**Track:** `video_analysis_deob_c11_reference_20260623`
+**Date:** 2026-06-23
+**Files audited:** 2 (jombloforth.asm, jombloforth.f)
+**Role:** PRIMARY (forth references that inform the user's C11 style)
+
+> **Reading guide.** This cluster sub-report surveys the forth references in the user's forth bootslop project. Forth is not C11, but the user's forth conventions inform the C11 style (per the warmup's research: the user thinks in forth, then writes in C11).
+
+---
+
+## File inventory
+
+| File | LOC | Role |
+|---|---|---|
+| `jombloforth/jombloforth.asm` | 25 KB (not read) | The jombloforth assembler entry point |
+| `jombloforth/jombloforth.f` | 13 KB (not read) | The jombloforth forth source |
+
+---
+
+## §1. Why forth references are in scope
+
+The user's forth practice is the foundation of the C11 convention. The duffle's:
+- `defer` pattern (Go-style defer via `for` loops) — comes from forth's deferred execution model
+- `Slice` pattern (contiguous data with ptr+len) — comes from forth's string slice model
+- Arena allocators — comes from forth's dictionary model
+- Hand-rolled DSL — comes from forth's word definition model
+
+**For Pass 3:** the forth references document the user's mental model. The C11 convention is the compiled output of the forth thinking.
+
+---
+
+## §2. The forth → C11 translation
+
+| Forth concept | C11 implementation (in duffle) |
+|---|---|
+| Word | `Proc_(Name)` macro |
+| Stack | `FArena` + `Slice` |
+| Dictionary | `TSet_` + `Struct_` |
+| Deferred execution | `defer` macro |
+| `: word ... ;` | `Struct_` + macro expansion |
+| Stack effect comment | `//- rjf:` or `// ---` |
+| Forth-Lex (fth) | EPP (Explicit Programmatic Prose) in the warmup |
+
+---
+
+## §3. Summary
+
+The forth references document the user's mental model. The C11 convention is the typed, compiled expression of the forth thinking. For Pass 3, the user wants the C11 code to read like "the user's own" — which means: duffle style, forth-influenced, hand-rolled DSL where appropriate.
+
+---
+
+*End of `cluster_2_forth_bootslop_references.md`. 3 sections. ~50 LOC. PRIMARY (forth).*