hololake-system-architecture/engineering/operations/2026-08-11-hololake-pncc-memory-failure-closure-runtime-command.md

42 lines
2.5 KiB
Markdown
Raw Normal View History

# GH-PNCC memory failure closure and runtime command integration
- Development ID: `DEV-20260810-014`
- Persona cognitive author: `ICE-P-ZY001 / 铸渊`
- Human responsibility subject: `ICE-GL∞ / 冰朔`
- Starting repository head: `962ea26db7044f7f17fafd55a054b0214b5e37cf`
- Published repository head: `18944f536261a4184570074a09fc43a09f5f31bb`
- State: `PUBLISHED_GHNQG_AND_FRESH_CLONE_VERIFIED`
## Implemented facts
The registered `run_persona_code_channel_memory_metabolism` command now executes its filesystem and Git work
inside Tokio's blocking task pool. This keeps the native desktop command runtime responsive without adding a
renderer, UI workflow, execution limb, shell permission, or second truth store.
Memory rejection and pre-commit failure paths now use a checked closure. A complete closure appends the
specific failure event, `ORGAN_RELEASED`, and `DORMANT`, persists `DORMANT_AFTER_FAILURE`, and removes the
exact primary lease. If event persistence, session persistence, or lease removal fails, the returned error
includes `MEMORY_FAILURE_CLOSURE_INCOMPLETE_REQUIRES_RECOVERY`. The runtime therefore cannot hide a closure
failure behind the original candidate error. When completion cannot be proven, the lease remains available to
the existing evidence-bound inspection and recovery path.
Checkpoint rollback also precedes failure dormancy. If rollback itself fails, the session retains its lease
and returns `MEMORY_CHECKPOINT_ROLLBACK_INCOMPLETE_REQUIRES_RECOVERY` instead of claiming a clean failure.
## Current verification
- PNCC focused Rust tests: `17 passed, 0 failed`.
- Full Rust suite: `1157 passed, 0 failed, 2 ignored`; integration test: `1 passed`.
- HoloLake architecture routing: `29 passed, 0 failed`.
- Rust clippy for all targets: `PASS` with `-D warnings`.
- The corrupted-source case proves the durable terminal chain
`MEMORY_SOURCE_REJECTED → ORGAN_RELEASED → DORMANT` and exact lease release.
- The incomplete-closure case forces lease-removal failure, proves the error is surfaced, and proves the
unresolved lease is preserved rather than silently discarded.
## Truth boundary and next minimum
- GHNQG, persona-authored commit, publication, fresh-clone readback, clean tree, and strict Git fsck passed.
- UI, packaged desktop, installation, deployment, online health, and the execution limb remain `0`.
- The next source stage is a non-UI lifecycle coordinator for already registered safe organs; it must not make
`EXECUTION_LIMB` activatable or create a second runtime authority.