docs: the 12 duplicates deleted; README rewritten to the system as it is

Captain Bob's rulings, 2026-10-14: "delete" -- the duplicates listed in
DELETE-CANDIDATES.md are removed (the list stays as the record; the
formal tier's provenance comments repointed at the maintained copies) --
and "rewrite" the README: v2.1.0, the Tripod as Hera/Artemis/Hestia,
kernel-Hermes, identities on thumbdrives, the corrected ACL overhead,
1052-test POST and the current parity line, keyboards and storage, board
images carrying both systems and how to switch, and docs/README.md as
the way in.  The book is left as it is, to be reworked later.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rajames
2026-10-14 16:45:39 -04:00
co-authored by Claude Opus 5.5
parent 776c89457e
commit f8fbc37698
23 changed files with 91 additions and 4932 deletions
-84
View File
@@ -1,84 +0,0 @@
# LithosAnanke Hardware Abstraction Layer (HAL)
This directory contains HAL documentation for the LithosAnanke kernel branch.
> **HISTORICAL — L4Re/Fiasco.OC**: L4Re references throughout this directory's docs describe a target that was a supported platform through mid-2026. L4Re support has since been removed as an active target — `src/platform/l4re/time.c` and related `#ifdef __l4__` code are retained for reference but no longer wired into any build.
---
## Document Overview
| Document | Purpose |
|----------|---------|
| [overview.md](overview.md) | HAL architecture and design principles |
| [interfaces.md](interfaces.md) | HAL function specifications and contracts |
| [lithosananke-integration.md](lithosananke-integration.md) | Kernel-specific HAL implementation |
| [platform-implementations.md](platform-implementations.md) | How to implement HAL for a platform |
| [migration-plan.md](migration-plan.md) | Migration from hosted to kernel |
---
## Reading Order
1. **overview.md** — Understand why HAL exists
2. **interfaces.md** — Learn the contracts
3. **lithosananke-integration.md** — See kernel implementation
4. **platform-implementations.md** — Reference implementations
---
## HAL Subsystems
```
hal_time.h — Monotonic time, timers
hal_interrupt.h — IRQ management, ISR registration
hal_memory.h — Allocation, page mapping
hal_console.h — Character I/O (UART, framebuffer)
hal_cpu.h — CPU ID, relax/halt, SMP
hal_panic.h — Fatal error handling
```
---
## Current State (lithosananke branch)
The HAL is **partially implemented** in LithosAnanke:
| Subsystem | Status | Location |
|-----------|--------|----------|
| Time | Implemented | `src/starkernel/arch/amd64/timer.c` |
| Interrupts | Implemented | `src/starkernel/arch/amd64/interrupts.c` |
| Memory | Implemented | `src/starkernel/memory/` |
| Console | Implemented | `src/starkernel/hal/console.c` |
| CPU | Partial | `src/starkernel/arch/amd64/apic.c` |
| Panic | Implemented | `src/starkernel/hal/hal.c` |
---
## Relationship to Hosted StarForth
The HAL enables the same VM code to run on:
- **Linux** (hosted, POSIX)
- **LithosAnanke** (freestanding, bare metal)
- **L4Re** (microkernel, optional)
```
┌─────────────────────────────────────┐
│ StarForth VM + Physics Subsystems │
│ (platform-agnostic) │
├─────────────────────────────────────┤
│ HAL Layer │
├──────────┬──────────┬───────────────┤
│ Linux │ L4Re │ LithosAnanke │
│ (POSIX) │ (micro) │ (kernel) │
└──────────┴──────────┴───────────────┘
```
---
## See Also
- [../README.md](../README.md) — LithosAnanke overview
- [../ROADMAP.md](../ROADMAP.md) — Milestone roadmap
- [../M7.1.md](../M7.1.md) — Init Capsule Architecture