Robert Allan JamesandClaude Sonnet 5
e40134da0d
First entry in the "cookbook" track: a demo capsule plus HOWTO, per the sequencing laid out after the POST-coverage sweep. Built entirely in FORTH on top of existing primitives -- fabric.4th's LINE (raster Bresenham) and Q.SIN/Q.COS (Q48.16 trig), plus PLOT/FB-WIDTH/FB-HEIGHT -- no new C words. FORWARD/BACK/LEFT/RIGHT/PENUP/PENDOWN/HOME/SETXY/SETHEADING/SETCOLOR give the classic turtle model; POLYGON and STAR compose FORWARD+turn into simple demo shapes; TURTLE-DEMO is a one-call visual smoke test. Not wired into init.4th -- REPL-invoked only, matching the original idea's own scope. Verified: mkcapsule --lint clean, hosted-build logic trace shows zero VM errors and correct stack balance through the whole vocabulary, zero build warnings and capsule loads cleanly on all three kernel architectures. Visual pixel-level confirmation not yet done (needs an interactive gtk-display session or driving past the ~25-30 min DoE-before-REPL wall), documented as an open item in the HOWTO. HOWTO: docs/working/architecture/TURTLE-GRAPHICS-HOWTO-20260819.md Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
docs/working/architecture/
Living system-design documentation: physics engine, HAL, heartbeat,
pipelining, word-ACL, adaptive systems, getting-started, and dated
design/finding notes for individual VM subsystems. This is the working-tier
source material that docs/formal/scraps/architecture/ is generated from.
- 03-architecture/ — Core architecture reference:
OVERVIEW.md, plusadaptive-systems/,hal/,heartbeat-system/,physics-engine/,pipelining/,word-acl/subtrees. Has its ownREADME.md. - getting-started/ — New-user and developer setup
guides (
DEVELOPER.md,INSTALL.adoc,QUICKSTART.adoc,quick-start/). Has its ownREADME.md. - architecture-internals/ —
INIT_SYSTEM.adoc,MESSAGING.adoc. - build-and-tooling/ —
BUILD_OPTIONS.adoc,DOCUMENTATION_README.adoc,INIT_TOOLS.adoc. - doxygen/ —
DOXYGEN_QUICK_REFERENCE.adoc,DOXYGEN_STYLE_GUIDE.adoc. MAMA_FORTH_SUPERVISOR_ARCHITECTURE.adoc— Mama VM supervisor design.PHYSICS_CONE_OF_INFLUENCE_DESIGN.adoc,PHYSICS_CONTROL_SYSTEM_DESIGN.adoc,PHYSICS_SIGNAL_MAP.adoc— physics-engine control-system design notes.VM_FORMALIZATION_PLAN.adoc— plan for Isabelle/HOL VM formalization.heartbeat_csv_export.md— heartbeat CSV export design (implementation status tracked in.claude/CLAUDE.md).- Dated design/finding notes for the Tripod VMs:
ARTEMIS-BAM-ACCEPTANCE-*,ARTEMIS-BLOCK-PHYSICS-DESIGN-*,ARTEMIS-FREEMAP-CAPSULE-RESERVATION-GAP-*,CAPSULE-BLOCK-PERSISTENCE-BOUNDARY-FINDING-*,CAPSULE-LOADER-DEFINITIONS-ONLY-DESIGN-*,HERMES-MESSAGE-BLOCK-STORAGE-DESIGN-*,HERMES-MESSAGE-CHANNEL-PHYSICS-DESIGN-*,K-PUSH-DICTIONARY-SHADOWING-BUG-*,VM-FLEET-ATTRACTOR-DESIGN-*,VM-PHYSICS-DYNAMIC-FLEET-DESIGN-*.
See also
docs/03-architecture/README.md— the binding-constraint Tripod/ACL docs, distinct from this design-notes tree.docs/formal/scraps/README.md— the press-ready fragment tier this material feeds.- Project root