docs(kernel): R7a survey complete — the C/C++ bug-for-bug port checklist (#1344)

Step 1 of the §0a recipe for the C/C++ port: every tree-sitter.ts branch,
extractor-config field, name-salvage helper, and gate the walker must
mirror, with file:line anchors. Locks the architecture: preParse (all seven
blanking passes) hoists to the kernel route point so none of it ports to
Rust; Metal/CUDA stay on wasm this round; one dual-language walker module.
Key asymmetries surveyed: value-refs are C-only (cpp absent from
VALUE_REF_LANGS), static-member refs are cpp-only, fn-ref spec is
cFamilySpec with addressOfOnly for cpp.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Colby Mchenry
2026-07-17 13:02:52 -05:00
committed by GitHub
co-authored by Claude Fable 5
parent 705e501328
commit 34ad0801aa
2 changed files with 124 additions and 1 deletions
+8 -1
View File
@@ -67,7 +67,14 @@ them are the ORIGINAL plan and carry expectations that measurement later correct
last big rock)** > backpressure ~120s (checkpoint I/O floor) > E-scan/
settle/read-mapping (~7090s each, approaching honest work) > the 8c
re-run formality (est. ~15.5min).
- [ ] **R7a. C/C++ port**biggest single-language effort; unlocks cg1212's parse
- [ ] **R7a. C/C++ port**STARTED 2026-07-17: the §0a-recipe step-1 survey is
COMPLETE — every TS branch, quirk, and helper is enumerated with line
anchors in **`docs/design/ccpp-kernel-port-checklist.md`** (read it FIRST;
it also fixes the architecture: preParse hoisted to the route point so no
blanking ports to Rust, Metal/CUDA stay wasm this round, one dual-lang
walker module). Next: grammars (upgrade+vendor from matched tags, suite
green BEFORE the walker), then the walker, then the §5 gate ladder.
Original scope note: biggest single-language effort; unlocks cg1212's parse
expectation (6.2m → ~1.52m, 23% of that wall) + CARLA/UE/llvm-class repos;
Metal + CUDA ride along (their blanking pre-passes stay TS-side — `preParse`
is offset-preserving and the route point can apply it before the kernel call;