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
31 lines
2.0 KiB
Markdown
31 lines
2.0 KiB
Markdown
# 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.
|