Document original runtime-image root source lifetimes #102

Manually merged
erikinkinen merged 1 commit from feature/kernel-runtime-image-sources into feature/x86-startup-resource-contract 2026-11-13 20:51:28 +01:00
Owner

Summary and rationale

Document the original Kernel/DSO allocation handover and exact supervisor templates, including actual processor-policy admission, independent file-reader retirement and the closed framebuffer lifetime boundary.

Tracking and scope

Companion to Kernel #143 and Kernel #146. Builds on #101 and preserves the existing BootKernel 2.3 wire contract.

Architecture, authority and failure behavior

Parsed descriptions cannot create original image or device ownership. Root occupations retain actual source loans; unknown cache modes and uncertain withdrawal refuse. Framebuffer leases require real all-root/CPU clearance before transfer. Manual source statements do not establish native acceptance.

Validation evidence

  • Update handover, memory-model and component navigation prose.
  • Complete documentation tests and current-head CI.
  • Build a warning-free full manual and inspect the affected rendered pages.

Review checklist

  • Signed canonical commits and focused changes below 1,000 lines per code file.
  • Complete manual review before removing WIP.
## Summary and rationale Document the original Kernel/DSO allocation handover and exact supervisor templates, including actual processor-policy admission, independent file-reader retirement and the closed framebuffer lifetime boundary. ## Tracking and scope Companion to [Kernel #143](https://git.erikinkinen.fi/erix/kernel/issues/143) and [Kernel #146](https://git.erikinkinen.fi/erix/kernel/pulls/146). Builds on #101 and preserves the existing BootKernel 2.3 wire contract. ## Architecture, authority and failure behavior Parsed descriptions cannot create original image or device ownership. Root occupations retain actual source loans; unknown cache modes and uncertain withdrawal refuse. Framebuffer leases require real all-root/CPU clearance before transfer. Manual source statements do not establish native acceptance. ## Validation evidence - [x] Update handover, memory-model and component navigation prose. - [x] Complete documentation tests and current-head CI. - [x] Build a warning-free full manual and inspect the affected rendered pages. ## Review checklist - [x] Signed canonical commits and focused changes below 1,000 lines per code file. - [x] Complete manual review before removing WIP.
docs: Specify original runtime-image root source lifetimes
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m11s
91e7cb97d8
Connect the loaded-image handover to exact supervisor allowlists, original processor policy, independent file-reader retirement and closed framebuffer conversion. Keep source controls separate from native multicore image acceptance.
erikinkinen added this to the Alpha 1 milestone 2026-11-13 17:27:41 +01:00
erikinkinen changed title from WIP: Document original runtime-image root source lifetimes to Document original runtime-image root source lifetimes 2026-11-13 17:38:03 +01:00
Author
Owner

Ready for manual review. The source-lifetime contract distinguishes actual loaded allocations from metadata, keeps boot-file aliases out of the Kernel template, and leaves native activation and framebuffer transfer with their owning implementation.

Ready for manual review. The source-lifetime contract distinguishes actual loaded allocations from metadata, keeps boot-file aliases out of the Kernel template, and leaves native activation and framebuffer transfer with their owning implementation.
erikinkinen changed target branch from feature/explicit-kernel-runtime-exports to feature/x86-startup-resource-contract 2026-11-13 20:51:27 +01:00
erikinkinen manually merged commit 21285725b5 into feature/x86-startup-resource-contract 2026-11-13 20:51:28 +01:00
Sign in to join this conversation.
No description provided.