repo: remove broken bump-z/bump-y targets, fix tools/README.md stale fbtest.c row

bump-z/bump-y referenced STARFORTH_VERSION_MAJOR/MINOR/PATCH/STARFORTH_VERSION_STRING
fields that never existed in the generated include/version.h, so they could never
have worked. Removed rather than fixed since CLAUDE.md already documents hand-editing
VERSION/LITHOS_VERSION in Makefile.starkernel as the real convention.

tools/README.md documented a fbtest.c that never existed in any commit; replaced with
the ttftest.c row that actually matches the tools/ directory.

Part of the pre-Artemis closeout pass (FABRIC-2.md Section C).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Robert Allan James
2026-08-15 05:58:14 -04:00
co-authored by Claude Sonnet 5
parent e3d4e202e2
commit b9e8fdc3ae
4 changed files with 19 additions and 34 deletions
+13 -4
View File
@@ -491,11 +491,20 @@ and recorded.
**Ruling:** flag and leave as-is, same precedent as the other Section C dead-code items —
not removed without explicit instruction.
- [ ] `src/*.c.bak` files (`vm.c.bak`, `doe_metrics.c.bak`, `inference_engine.c.bak`) remain
tracked in git at `src/` top level. Repo hygiene debt, not intentional (also noted in
`.claude/CLAUDE.md`).
- [ ] `bump-z`/`bump-y` Makefile targets reference `STARFORTH_VERSION_MAJOR`/`MINOR`/`PATCH`/
tracked in git at `src/` top level. Confirmed 2026-08-15: added in the initial commit
(`a5ed8c3`) and never touched since; each diverges heavily from its live counterpart
(1716/237/291 line diffs) — stale historical snapshots, not a second copy of anything
current, and not referenced by either build's `*.c` wildcard. Fully recoverable via
`git show a5ed8c3:src/vm.c.bak` if ever needed. Deletion (`git rm`) was attempted but
blocked by the session's permission classifier as a destructive tracked-file removal —
needs Captain Bob's direct `git rm` or an explicit go-ahead in a session where the
classifier allows it.
- [x] `bump-z`/`bump-y` Makefile targets reference `STARFORTH_VERSION_MAJOR`/`MINOR`/`PATCH`/
`STARFORTH_VERSION_STRING` fields that don't exist in the actual generated
`include/version.h` (also noted in `.claude/CLAUDE.md`).
`include/version.h`. **Ruling 2026-08-15:** removed outright rather than fixed — CLAUDE.md
already documents hand-editing `VERSION`/`LITHOS_VERSION` in `Makefile.starkernel` as the
real convention, so a working bump-z/bump-y would just be a second, redundant path. Also
removed the corresponding `.PHONY` entries. `.claude/CLAUDE.md` updated to match.
- [x] **Kconfig/`menuconfig` has never been exercised end-to-end.** Every knob added so far
(including item 4.1's `STADIUM_WORD_HEAT_QUANTUM`/`STADIUM_WORD_COOL_RATE_Q48`) has only
ever been verified via its `Makefile.starkernel` default. Nobody has run