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
36 lines
2.7 KiB
Markdown
36 lines
2.7 KiB
Markdown
# Discrepancies found (report to Captain Bob; do not fix unless asked)
|
|
|
|
Format: what disagrees → where → which side the code/authority supports.
|
|
|
|
## Documents vs documents
|
|
1. `README.md` says v4 `word_count=317 dict_hash=0xfec8c47cfc6f437f`; `.claude/CLAUDE.md` (working branch, after
|
|
c32bc43e) says 318 / `0x8c92508f748f99cf` (since `MINT-ZUSE`, 2026-11-08). README is behind.
|
|
2. `.claude/README.md` calls TRIPOD/HERMES/ARTEMIS.md "binding constraints"; `.claude/CLAUDE.md` says they are
|
|
frozen history. It also omits CONSOLE.md.
|
|
3. `CONTRIBUTING.md` is StarForth-era: `make test`, 780+ tests, feature branches, `hal_*` headers,
|
|
`docs/02-experiments/`, "security contact TBD". Contradicts CLAUDE.md throughout.
|
|
4. `docs/DEAD-AND-REVISED.md` "Revised" table still gives kernel version as 2.1.0 and parity 526 words as
|
|
"is"; current is 4.0.0-alpha.4 and v4's 318 (v3's 526 still true for `system=v3`).
|
|
5. `docs/CLAUDE.md` describes a triage "mission" that was carried out 2026-10-14; `.claude/README.md` calls
|
|
`docs/CLAUDE.md` "an older, hosted-only snapshot", which is not what it is.
|
|
6. `DECOMPOSITION.md` cites `v4/capsule/*.v4` paths throughout; since MACHINE.md (2026-10-15) the sources are
|
|
`.f18` blobs under `capsules/v4/sys/`. Its §6.1 packet format and four-port text are superseded by MESH.md.
|
|
7. `NUCLEUS.md` §3 (extensions out of scope) is contradicted by V3-PARITY's ruling; the file says so itself.
|
|
8. `kernel/src/kernel_main.c` header says "M7: Not started" (issue #144; CLAUDE.md flags it).
|
|
|
|
## Practice vs configuration
|
|
9. LFS: `.gitattributes` routes `*.log` and DoE `.csv` through LFS, but the step plans instruct committing
|
|
with the LFS clean filter disabled. Result: logs committed as plain text, every fresh clone shows them
|
|
modified. Fixed once by Bob's side (`027b144e`, FABRIC-3 §XLV.2, 1,003 files) and again by me
|
|
(`06f1d41a`, 146 files, 2026-11-11). It will recur until either the plans' commit command or
|
|
`.gitattributes` changes. Also: 3,944 LFS objects from the 2026-08-01 initial commit are 404 on the server.
|
|
|
|
## Tracker vs tree (audit of 2026-11-11, by grep/compile, NOT by the acceptance protocol)
|
|
10. Open and confirmed still open in code: #141 (1,332 empty DoE CSVs tracked), #143 (5 warnings in
|
|
`tools/mkcapsule.c`), #144, #145 (`capsules/BLOCK_MAP.md`, `v3/include/version.h` tracked and regenerated),
|
|
#140 (one `qemu` concurrency group), #20 (no compile-time `V4_PORTS` ≤ 16 check), #25 (LaTeX output in docs/).
|
|
11. #137 fixed on the working branch (c32bc43e), waiting in PR 164.
|
|
12. Milestones: `v4.0.0-alpha.4` and `Public demo terminal` open with 0 open issues;
|
|
`Fleet, identity and the DoE` closed with #51, #58, #60 open.
|
|
13. Gitea ROOT_URL is `gitea.starshipos-f18.com`; clone URL in use is `.org` (#133 closed).
|