Files
LithosAnanake/docs/working/architecture
Robert Allan JamesandClaude Sonnet 5 413b5a9bbf Verify turtle.4th rendering live, revert overdue ART-STRESS-CAMPAIGN disable
Disabled capsules/artemis/init.4th block 4170's ART-STRESS-CAMPAIGN -- its
own comment already said to revert to disabled once the K-invariant/
heartbeat verification run (item 4.6, closed earlier this session) was
done. This was the actual ~25-30 minute wall blocking interactive REPL
access, unrelated to any DoE mechanism.

Verified capsules/turtle.4th and capsules/sdk.4th live in a gtk-display
QEMU session: a red hexagon (6 100 POLYGON) and a green self-intersecting
star (100 STAR) both render with correct geometry and color. Screenshot in
evidence/amd64/.

Two real obstacles found and worked around along the way: CS's full-
framebuffer PLOT loop is far slower under TCG than previously documented
(closer to 20+ minutes than "slow"), and the kernel's heartbeat CSV logging
draws to the same console surface PLOT writes pixels to, overwriting
drawings within a fraction of a second unless silenced first with the
existing HB-OFF word. Both HOWTOs updated to record this.

Re-verified full three-arch acceptance boot (POST, DoE, parity) with the
ART-STRESS-CAMPAIGN change: 1012/0/0 and matching dict_hash on all three,
identical to the pre-change baseline.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-19 07:57:43 -04:00
..

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, plus adaptive-systems/, hal/, heartbeat-system/, physics-engine/, pipelining/, word-acl/ subtrees. Has its own README.md.
  • getting-started/ — New-user and developer setup guides (DEVELOPER.md, INSTALL.adoc, QUICKSTART.adoc, quick-start/). Has its own README.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