pr9.1
This commit is contained in:
@@ -1,92 +1,3 @@
|
||||
# PR-9 — Final Hardening & Baseline Documentation
|
||||
|
||||
This phase finalizes the new Prometeu VM baseline after the architectural reset (GC, closures, coroutines, unified syscall ABI, deterministic scheduler).
|
||||
|
||||
Goals:
|
||||
|
||||
* Consolidated architecture documentation (short, precise, authoritative)
|
||||
* Minimal and controlled public surface area
|
||||
* Removal of temporary feature flags
|
||||
* Final cleanup: dead code, warnings, outdated docs/examples
|
||||
|
||||
All PRs below are self-contained and must compile independently.
|
||||
|
||||
---
|
||||
|
||||
# PR-9.1 — Consolidated Architecture Documentation
|
||||
|
||||
## Briefing
|
||||
|
||||
The project must include a short, authoritative architecture document in English describing the new baseline.
|
||||
|
||||
It must reflect the current state only (no legacy, no transitional wording).
|
||||
|
||||
This document becomes the canonical reference for contributors.
|
||||
|
||||
## Target
|
||||
|
||||
Create `ARCHITECTURE.md` at repository root with sections:
|
||||
|
||||
1. Overview
|
||||
|
||||
* Stack-based VM
|
||||
* GC-managed heap (mark-sweep, non-compacting)
|
||||
* Closures (Model B, hidden arg0)
|
||||
* Cooperative coroutines (FRAME_SYNC safepoints)
|
||||
* Unified syscall ABI
|
||||
|
||||
2. Memory Model
|
||||
|
||||
* Stack vs heap
|
||||
* Heap object kinds
|
||||
* GC roots (VM + suspended coroutines)
|
||||
|
||||
3. Execution Model
|
||||
|
||||
* Interpreter loop
|
||||
* Safepoints
|
||||
* Scheduler behavior
|
||||
|
||||
4. Verification Model
|
||||
|
||||
* Verifier responsibilities
|
||||
* Runtime vs verifier guarantees
|
||||
|
||||
5. Non-Goals
|
||||
|
||||
* No RC
|
||||
* No HIP
|
||||
* No preemption
|
||||
* No mailbox
|
||||
|
||||
The document must be concise (no more than ~4–6 pages equivalent).
|
||||
|
||||
## Acceptance Checklist
|
||||
|
||||
* [ ] ARCHITECTURE.md exists.
|
||||
* [ ] No mention of RC/HIP.
|
||||
* [ ] Reflects actual implementation.
|
||||
* [ ] Reviewed for consistency with code.
|
||||
|
||||
## Tests
|
||||
|
||||
Manual review required.
|
||||
|
||||
## Junie Instructions
|
||||
|
||||
You MAY:
|
||||
|
||||
* Create new documentation files.
|
||||
|
||||
You MUST NOT:
|
||||
|
||||
* Invent features not implemented.
|
||||
* Reference legacy behavior.
|
||||
|
||||
If architecture details are unclear, STOP and request clarification.
|
||||
|
||||
---
|
||||
|
||||
# PR-9.2 — Public Surface Area Minimization
|
||||
|
||||
## Briefing
|
||||
|
||||
Reference in New Issue
Block a user