Claude
ce04420f6b
Session notes from reading the repo and reviewing the v4 engine and kernel v4 path. Findings are reported, not fixed (Captain Bob's Law). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
2.0 KiB
Reading progress (update after every batch)
Session 1, 2026-11-11. Per-read cap ~25k tokens; large files in 400–700 line pages.
Documents — DONE in full
.claude/CLAUDE.md, .claude/README.md, docs/CLAUDE.md, docs/README.md, docs/DEAD-AND-REVISED.md, README.md, CONTRIBUTING.md, CHANGELOG.md; docs/v4.0.0/{JUSTIFICATION, ENGINE, NUCLEUS, MACHINE, DATASHEET-F18, STICK, V3-PARITY, DECOMPOSITION, MESH, POST79}; plans {engine-step4, identity-gate, stick-4, stick-5, alpha4-documents}; docs/fabric/FABRIC-3.md (all 6,515 lines), FABRIC-3.7, FABRIC-4; docs/reference/{ROADMAP, M7.1, word-acl/DESIGN, kernel-args/DESIGN, hosted-acceptance-test}; boards/BRINGUP.md + all board READMEs; v4/README.md; experiments/bare_metal/{README, CLAUDE}; disk/README.md; proof/{COVERAGE, FINDINGS}; capsules/README.md; kernel/src/hal/README.md; docs/working/README.md; docs/formal/CLAUDE.md (first 80 lines).
Documents — PARTIAL (structure + key sections)
FABRIC-3.5 (§XV, §XXII, §XXXV full), FABRIC-3.6 (handoff, rules, findings full), FABRIC-0 (§1–15 full), FABRIC-1, FABRIC-2 (§C full), docs/INDEX.md (skimmed).
Documents — SURVEYED only (not read file by file)
docs/working/** (253), docs/formal/** (255), docs/patent/** (43, legal hold), experiments/** analysis, .claude/{TRIPOD,HERMES,ARTEMIS,CONSOLE}.md (frozen), capsules/MANIFEST*.md, BLOCK_MAP.md, remaining 11 plans, docs/reference/{DICTIONARY, STARFORTH_PRIMITIVES, ONTOLOGY, L8_ADAPTIVE_CONFIG_TABLE}.
Code review — NEXT
v4/ (engine, system, tools, tests) → kernel/src/v4 → kernel/src core (boot, arch, usb, gpt, hal) → capsules/v4 → tools/mkcapsule.c → scripts/ (nightly.sh, qemu_session.py) → .gitea/workflows → Makefiles → v3 (light).
Code review status (2026-11-11, end of session 1 pass)
Reviewed: v4/src (all engine files), v4/system boot.c request loop + post.c + blocks.c guards, kernel/src/v4 (sk_v4.c, mint, marker, grow, identity 160–320). Findings in code-review.md. Remaining list at the bottom of code-review.md.