From eb6cad23300d36440fd33a4c0eda0a9ef0a3b731 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 19 Sep 2026 12:29:15 +0000 Subject: [PATCH] FABRIC-3.6.md: add START HERE session handoff Written so a cold session told "go build it" can begin without re-deriving anything. Records where the code actually is -- the Gitea instance, not the empty GitHub StarForth repo that cost this session time at the outset, and not the read-only mirror -- plus the branch, its head, and that no code has been written yet. States the two-document split and the rule that 3.5 is authoritative and a task proving a ruling wrong is a finding to record rather than a divergence to make quietly. Carries the five traps this project's own history proves are real, since a fresh session would otherwise walk into each: silent failure is the dominant mode and a green boot is weak evidence; grep cannot establish capsule reachability, having put six live capsules at zero references; fleet_conserved cannot see Stadium heat, so a leaking allocator leaves it reporting fine; dict_hash changing is expected while diverging is the stop condition; and CLAUDE.md carries four known-stale claims to trust the code over. Names the three blocked decisions and the standing prohibitions -- no branches, no stashing, no fixing in passing, no bundling, nothing without authorization. No credentials committed; the handoff names the host and repo only. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01VkM1zHGvBerLF6aqkHPweP --- FABRIC-3.6.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/FABRIC-3.6.md b/FABRIC-3.6.md index b9be1140..34655654 100644 --- a/FABRIC-3.6.md +++ b/FABRIC-3.6.md @@ -1,5 +1,56 @@ # FABRIC-3.6.md — the Tripod/kernel reshuffle: execution log +> ## START HERE — session handoff +> +> **If you have just been told "go build it", read this section, then `FABRIC-3.5.md`'s §XLI, +> then start at task 0.0 below. Do not re-derive the design — it is settled.** +> +> **Where the code is.** This repo is **LithosAnanke, on the Gitea instance at +> `gitea.strshipos.com`, repo `admin/LithosAnanake`** — Captain Bob has the credentials. +> **The GitHub repo `rajames440/StarForth` is empty**; do not be misled by it, and note +> `rajames440/StarForth-` is a read-only mirror that says not to push. `master` is the sole +> production line. Work on branch **`claude/starshipos-tripod-kernel-reshuffle-itbjns`** +> (head `2032974` at handoff, 34 commits ahead of `master` at `e56974e`, clean fast-forward, +> documentation only — **no code has been written**). +> +> **The two documents.** `FABRIC-3.5.md` is the **design record and is authoritative** — every +> ruling, with its reasoning and evidence, §I–§XLIII. **This** document is the execution log. +> Rulings are cited here, never restated. **If a task proves a ruling wrong, record the finding +> here and amend `FABRIC-3.5.md` — never silently diverge.** +> +> **First action: task 0.0**, the three-ISA baseline. It is a gate, not a formality — see its +> own rationale below. **Nothing else starts until it is recorded.** +> +> **Five traps this project's own history proves are real. A fresh session will walk into these:** +> +> 1. **Silent failure is the dominant mode here.** `FABRIC-3.5.md` §XXXV.0 lists four +> independent instances. Most relevantly: *"a switch storm and a healthy idle REPL produce an +> identical serial log."* **A green boot is weak evidence.** Name the specific observation +> that proves a task worked, before running it. +> 2. **`grep` cannot establish capsule reachability.** Capsules are birthed by name from runtime +> strings. A reference count over `capsules/` and `src/` put the six live `init-l8-*` +> capsules at **zero references**; including `experiments/` found 18–19 each. §XXII.2. **Use +> the three routes, never grep alone.** +> 3. **`fleet_conserved` cannot see Stadium heat.** The two heat accountings are entirely +> decoupled (§XXXIX). A leaking message allocator leaves `fleet_conserved` reporting a serene +> `1`. **Stage B's evidence is the ledger plus `stadium_conserved()`, never `fleet_conserved`.** +> 4. **`dict_hash` *changing* is expected; `dict_hash` *diverging* across architectures is the +> stop condition.** §XXXIV.6. Do not "fix" a changed hash. +> 5. **`.claude/CLAUDE.md` has four known-stale claims** (§XXVI.1): 23 theory files (there are +> 52), `LITHOS_VERSION` 2.0.1 (it is 2.0.0), the ACL-pinning rule (contradicted by live code +> at `kernel_main.c:771-782`), and the 1024-byte `mkcapsule` framing (it is block range +> `[2048,5120)` and a 16-content-line cap). **Trust the code over that file where they +> disagree.** +> +> **Blocked, and not to be worked around:** Phase 3 needs three decisions from Captain Bob — +> **B1** channels (one membership or negotiation), **B2** the `SK_SWITCH_MAX_SLOTS` ceiling of +> 16, **B4** the payload bound against `INPUT_BUFFER_SIZE` 1025. **All design is complete; these +> are rulings, not investigations.** +> +> **Do not:** create branches, stash, fix defects found in passing, bundle tasks into one +> commit, or start any task without explicit authorization. Captain Bob's Law, +> `.claude/CLAUDE.md`. + **Status: LIVING WORKING DOCUMENT, opened 2026-09-19.** This is the **execution** record for the reshuffle designed in `FABRIC-3.5.md`. Work is tracked, annotated and closed here.