rajamesandClaude Opus 5.5
1ce705783c
(Q.REDUCE) is v3's q48_reduce_angle: the angle as one cell in [-pi, pi]. x / 2pi does not fit a cell, but only the remainder is needed, and |x| mod 2pi is two UM/MOD steps (high cell first, its remainder leading the low cell); then the sign of x and one step of 2pi back into range. Q.SIN is v3's q48_sin_approx on the reduced angle: the odd Taylor series to n = 11, each term the last times x^2 over n(n-1), stopping below 10 ulp. After the reduction every value fits one cell, so the 6-cell variable (QT) holds single cells. The loop is laid out for Q.COS to jump into, so the pair share it without an extra call level. Checked bit for bit against v3 (both functions ported into the test) on 33 edge angles -- around +-pi/2, +-pi, +-2pi, the 32-bit seam and both 64-bit extremes -- and 3000 pseudo-random angles of every size and sign, at 32- and 64-bit cells, optimised and ASan+UBSan (`make test`, `make sanitize`). Mutating either range boundary, the series length or the sign alternation fails. Moving the 10-ulp stop to 11 fails nothing, and a scan of all 205888 reduced angles in C shows why: no input's result depends on it, for sine or cosine. Headroom (data under arg / return): (Q.REDUCE) 5/5, Q.SIN 3/2. Test results on the amd64 host only. This is a development check, not acceptance (JUSTIFICATION.md section 16). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
StarForth / LithosAnanke Documentation
This is the lithosananke branch: the bare-metal StarKernel side of the project
(contrast master, which is the hosted-VM-only side). Documentation follows the
two-tier model described in docs/CLAUDE.md: formal/ is the polished,
citable LaTeX tier; working/ is living design notes and drafts that feed it.
Everything else in this directory is branch- or subsystem-specific material that
doesn't fit either tier.
Layout
- formal/ — Three-volume LaTeX documentation set (research volumes,
practitioner books, standalone reports) plus the
scraps/fragment library it's assembled from. Audience: patent counsel, SSRN reviewers, licensees, hobbyists with hardware in hand. Seeformal/CLAUDE.mdfor authoring conventions. - working/ — Living documents: architecture design notes, DoE
experiment logs, hardware/platform notes, draft specs, academic-paper source
material, and an archive of superseded docs. Source material for
formal/. - 03-architecture/ — Tripod VM architecture constraints (Hera/Hermes/Artemis) and the word-level ACL system design.
- lithosananke/ — LithosAnanke kernel branch documentation: milestone roadmap, system architecture, HAL reference, kernel command-line argument design, and the amd64 APIC-timer ISR postmortem.
- birthing/ — VM birthing plan and status for the Hera-spawns- Hermes/Artemis constellation, plus three-architecture QEMU acceptance logs.
- patent/ — Provisional patent application source. Legal hold — ask Bob before touching anything in this directory.
- api/ — Generated Doxygen tag file and warnings log (gitignored; not part of the tracked doc tree).
- pptx/ — Elevator-pitch and deep-dive slide decks for different audiences (technical, non-technical, academic, PhD-level).
Current Active Work
- LithosAnanke M7/M7.1 — VM parity validation and init capsule architecture.
See
lithosananke/README.mdandlithosananke/M7.1.md. - Word-level ACL system — Phase 6 complete on
master; Phase 7 (LithosAnanke parity) is the next step. See03-architecture/word-acl/README.md. - Tripod VMs — Hera (governor), Hermes (messenger), Artemis (memory/block
storage). See
03-architecture/tripod/README.mdandbirthing/.
Contributing
- Place new material in
working/first; promote toformal/only when it's ready to be cited (seeformal/CLAUDE.mdfor promotion criteria). - Never touch
patent/,formal/patent/,formal/scraps/legal/, orworking/legal/without Bob's explicit instruction. - Add a
README.mdto any new category-level subdirectory, following the format used throughout this tree: orientation paragraph + bullet list of real files with one-line descriptions.