5 Commits

Include renames

Author	SHA1	Message	Date
rajamesandClaude Opus 5.5	41f59afeb3	test(v4.0.0): execute UM/MOD on the golden model; measure stack headroom ... UM/MOD is assembled exactly as DECOMPOSITION.md section 4 gives it and needs no change: it is exact for every uhi < ud at 32- and 64-bit cells. It is checked against q*d + r = uhi:ulo with r < d through v4_umul, so no second C divider has to be trusted. Coverage: all edge-vector triples with uhi < ud plus 20000 pseudo-random cases (top-bit, small and near-maximum divisors), optimised and under ASan+UBSan. Two hand mutations each fail more than 15000 checks. New headroom probe: runs a word with marked cells under the canary and under its return address and reports how many survive, since the D-2 circular stacks overwrite silently instead of faulting. Measured: UM* 6 data cells under its args, 4 return entries under its return UM/MOD 3 data cells under its args, 3 return entries under its return DECOMPOSITION.md: UM/MOD marked executed, with its defined range and stack limits. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-02 19:48:04 -04:00
rajamesandClaude Opus 5.5	9a391eb0ad	feat(v4.0.0): full-range UM* under plain F18 +* (D-3) ... UM* as first written in DECOMPOSITION.md section 4 was exact only while u1 <= 2^(n-2): plain +* loses the carry out of T and its shift keeps T's sign bit, so the loop is exact only while S and T stay in [-2^(n-2), 2^(n-2)). The rewrite multiplies by s = u1 2/, which always lies in that range, starting T at t0 = u2 2/ when u1 is odd, so the loop yields hi:lo = t0 + s*u2 exactly. Then u1*u2 = 2*(hi:lo) + c_lo + c_hi*2^n c_lo = u1 & u2 & 1 c_hi = (u1<0 ? u2 : 0) + (u1 odd and u2<0 ? 1 : 0) restores the halved-away bits and the unsigned reading of both top bits. test_foundation.c runs the new definition against v4_umul over every pair of the edge vectors plus 20000 pseudo-random pairs, at 32- and 64-bit cells, optimised and under ASan+UBSan. The two pinned failing cases are now ordinary exactness checks. Two hand mutations of the correction step each fail more than 10000 checks at both widths. DECOMPOSITION.md: section 4 UM* replaced, D-3 ruling text updated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-02 19:21:17 -04:00
rajamesandClaude Opus 5.5	067f317c47	feat(v4.0.0): hosted golden model, single node ... First code for StarForth v4 (JUSTIFICATION.md section 10, step 1): one node of the 32-instruction core as a C99 model, with cell width as a build parameter. - Node: P, A, B, F18 circular stacks (10 and 9 deep, D-2), word-addressed memory (D-1), 5% guard bands on every bounded list. - Instruction word: six 5-bit slots in 32 bits at every cell width. - Executor: all 32 opcodes of DECOMPOSITION.md 1.3. Cell arithmetic wraps explicitly; no signed overflow or implementation-defined shift. - Heat: per-opcode and per-call-target counters and the anti-clock, driven by instruction retirement (1.4, D-6 interim). - Slot packer and runner for tests, and a reference unsigned multiply in plain C99 with no 128-bit type. Tests run at 32- and 64-bit cells, and under ASan and UBSan. They cover every opcode and execute the first section 4 definitions (NIP SWAP OR NEGATE ROT 0< 0= 2DUP - U<) against the C operation each stands for. UM* as written in section 4 is exact only while u1 <= 2^(n-2). Two known failing cases are pinned in test_foundation.c until it is rewritten. DECOMPOSITION.md: record D-9, the instruction word is 32 bits at every cell width (ruled 2026-10-02). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-02 14:38:27 -04:00
Claude	f238f02afa	docs(v4.0.0): record D-1..D-8 rulings in DECOMPOSITION.md ... D-1 word addressing; D-2 F18 circular stacks (10/9 deep), hidden, so DEPTH/PICK/ROLL/.S/SP@/SP! are retired everywhere and the DSP register is dropped; D-3 plain F18 +* (UM* flagged for revision); D-5 host width matches the host CPU; D-7 moot; D-8 signed Q48.16; D-4 and D-6 deferred to the hosted-mesh step. Adds a note that every CAP definition must be re-checked against the 10/9 stack depths. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BY9HMwK5Cetz3caBgHGyds	2026-10-01 00:55:20 +00:00
Claude	3c709c115b	docs(v4.0.0): add StarForth v4 justification and primitive decomposition ... JUSTIFICATION.md records why v4 exists and the reasoning behind each major design decision. DECOMPOSITION.md assigns every v3 C primitive a fate on the 32-instruction F18-derived core. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BY9HMwK5Cetz3caBgHGyds	2026-09-29 06:50:28 +00:00