From 57bf2b84d3e0a515e2beae99f24ffbf46f475594 Mon Sep 17 00:00:00 2001 From: bQUARKz Date: Mon, 15 Jun 2026 16:06:53 +0100 Subject: [PATCH] implements PLN-0112 --- crates/console/prometeu-hal/src/lib.rs | 2 + .../console/prometeu-hal/src/render_worker.rs | 190 ++++++++++++++++++ crates/console/prometeu-hal/src/telemetry.rs | 94 +++++++++ discussion/index.ndjson | 2 +- ...fine-render-worker-errors-and-telemetry.md | 2 +- 5 files changed, 288 insertions(+), 2 deletions(-) create mode 100644 crates/console/prometeu-hal/src/render_worker.rs diff --git a/crates/console/prometeu-hal/src/lib.rs b/crates/console/prometeu-hal/src/lib.rs index 00a8931e..62c6863d 100644 --- a/crates/console/prometeu-hal/src/lib.rs +++ b/crates/console/prometeu-hal/src/lib.rs @@ -23,6 +23,7 @@ pub mod platform; pub mod primitives; pub mod render_resources; pub mod render_submission; +pub mod render_worker; pub mod sample; pub mod scene_bank; pub mod scene_layer; @@ -59,4 +60,5 @@ pub use render_submission::{ Gfx2dCommand, GfxUiCommand, HudCommand, HudPacket, RenderOwnership, RenderSubmission, RenderSubmissionPacket, ShellUiFramePacket, }; +pub use render_worker::{RenderWorkerError, RenderWorkerTelemetry}; pub use touch_bridge::TouchBridge; diff --git a/crates/console/prometeu-hal/src/render_worker.rs b/crates/console/prometeu-hal/src/render_worker.rs new file mode 100644 index 00000000..44ebbc60 --- /dev/null +++ b/crates/console/prometeu-hal/src/render_worker.rs @@ -0,0 +1,190 @@ +use std::fmt; + +/// Typed failure surface for the real render worker and its backend. +#[derive(Debug, Clone, Copy, PartialEq, Eq)] +pub enum RenderWorkerError { + BackendUnavailable, + RenderFailed, + PublishFailed, + PresentFailed, + ShutdownTimeout, + StaleSubmissionDiscarded, + WorkerPanic, + InternalFailure, +} + +impl fmt::Display for RenderWorkerError { + fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { + match self { + Self::BackendUnavailable => f.write_str("render backend unavailable"), + Self::RenderFailed => f.write_str("render failed"), + Self::PublishFailed => f.write_str("render publish failed"), + Self::PresentFailed => f.write_str("render present failed"), + Self::ShutdownTimeout => f.write_str("render worker shutdown timed out"), + Self::StaleSubmissionDiscarded => f.write_str("stale render submission discarded"), + Self::WorkerPanic => f.write_str("render worker panicked"), + Self::InternalFailure => f.write_str("internal render worker failure"), + } + } +} + +impl std::error::Error for RenderWorkerError {} + +/// Snapshot of render worker handoff, render, publish, and shutdown counters. +#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)] +pub struct RenderWorkerTelemetry { + pub produced_submissions: u64, + pub replaced_before_consume: u64, + pub consumed_submissions: u64, + pub published_frames: u64, + pub presented_frames: u64, + pub repeated_frames: u64, + pub stale_submission_discards: u64, + pub render_failures: u64, + pub publish_failures: u64, + pub present_failures: u64, + pub shutdown_timeouts: u64, + pub worker_panics: u64, + pub last_produced_frame_id: u64, + pub last_consumed_frame_id: u64, + pub last_published_frame_id: u64, + pub last_presented_frame_id: u64, + pub last_dropped_frame_id: u64, + pub last_error_frame_id: u64, + pub active_render_epoch: u64, +} + +impl RenderWorkerTelemetry { + pub fn record_produced(&mut self, frame_id: u64) { + self.produced_submissions += 1; + self.last_produced_frame_id = frame_id; + } + + pub fn record_replaced_before_consume(&mut self, frame_id: u64) { + self.replaced_before_consume += 1; + self.last_dropped_frame_id = frame_id; + } + + pub fn record_consumed(&mut self, frame_id: u64) { + self.consumed_submissions += 1; + self.last_consumed_frame_id = frame_id; + } + + pub fn record_published(&mut self, frame_id: u64) { + self.published_frames += 1; + self.last_published_frame_id = frame_id; + } + + pub fn record_presented(&mut self, frame_id: u64) { + self.presented_frames += 1; + self.last_presented_frame_id = frame_id; + } + + pub fn record_repeated_frame(&mut self, frame_id: u64) { + self.repeated_frames += 1; + self.last_presented_frame_id = frame_id; + } + + pub fn record_stale_submission_discarded(&mut self, frame_id: u64) { + self.stale_submission_discards += 1; + self.last_dropped_frame_id = frame_id; + } + + pub fn record_error(&mut self, error: RenderWorkerError, frame_id: u64) { + match error { + RenderWorkerError::BackendUnavailable | RenderWorkerError::RenderFailed => { + self.render_failures += 1; + } + RenderWorkerError::PublishFailed => { + self.publish_failures += 1; + } + RenderWorkerError::PresentFailed => { + self.present_failures += 1; + } + RenderWorkerError::ShutdownTimeout => { + self.shutdown_timeouts += 1; + } + RenderWorkerError::WorkerPanic => { + self.worker_panics += 1; + } + RenderWorkerError::StaleSubmissionDiscarded => { + self.stale_submission_discards += 1; + self.last_dropped_frame_id = frame_id; + } + RenderWorkerError::InternalFailure => { + self.render_failures += 1; + } + } + self.last_error_frame_id = frame_id; + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn render_worker_error_is_copy_equatable_and_debuggable() { + let error = RenderWorkerError::ShutdownTimeout; + let copied = error; + + assert_eq!(copied, RenderWorkerError::ShutdownTimeout); + assert_eq!(format!("{:?}", error), "ShutdownTimeout"); + assert_eq!(error.to_string(), "render worker shutdown timed out"); + } + + #[test] + fn render_worker_telemetry_defaults_to_zero() { + assert_eq!( + RenderWorkerTelemetry::default(), + RenderWorkerTelemetry { + produced_submissions: 0, + replaced_before_consume: 0, + consumed_submissions: 0, + published_frames: 0, + presented_frames: 0, + repeated_frames: 0, + stale_submission_discards: 0, + render_failures: 0, + publish_failures: 0, + present_failures: 0, + shutdown_timeouts: 0, + worker_panics: 0, + last_produced_frame_id: 0, + last_consumed_frame_id: 0, + last_published_frame_id: 0, + last_presented_frame_id: 0, + last_dropped_frame_id: 0, + last_error_frame_id: 0, + active_render_epoch: 0, + } + ); + } + + #[test] + fn render_worker_telemetry_records_counters_and_frame_ids() { + let mut telemetry = RenderWorkerTelemetry::default(); + + telemetry.record_produced(10); + telemetry.record_replaced_before_consume(10); + telemetry.record_consumed(11); + telemetry.record_published(11); + telemetry.record_presented(11); + telemetry.record_repeated_frame(11); + telemetry.record_error(RenderWorkerError::PublishFailed, 12); + telemetry.record_error(RenderWorkerError::WorkerPanic, 13); + telemetry.record_stale_submission_discarded(14); + + assert_eq!(telemetry.produced_submissions, 1); + assert_eq!(telemetry.replaced_before_consume, 1); + assert_eq!(telemetry.consumed_submissions, 1); + assert_eq!(telemetry.published_frames, 1); + assert_eq!(telemetry.presented_frames, 1); + assert_eq!(telemetry.repeated_frames, 1); + assert_eq!(telemetry.publish_failures, 1); + assert_eq!(telemetry.worker_panics, 1); + assert_eq!(telemetry.stale_submission_discards, 1); + assert_eq!(telemetry.last_error_frame_id, 13); + assert_eq!(telemetry.last_dropped_frame_id, 14); + } +} diff --git a/crates/console/prometeu-hal/src/telemetry.rs b/crates/console/prometeu-hal/src/telemetry.rs index 17253ac7..405e3f1f 100644 --- a/crates/console/prometeu-hal/src/telemetry.rs +++ b/crates/console/prometeu-hal/src/telemetry.rs @@ -1,4 +1,5 @@ use crate::log::{LogLevel, LogService, LogSource}; +use crate::render_worker::RenderWorkerTelemetry; use std::sync::Arc; use std::sync::atomic::{AtomicU32, AtomicU64, AtomicUsize, Ordering}; @@ -34,20 +35,51 @@ pub struct TelemetryFrame { pub produced_submissions: u64, pub replaced_before_consume: u64, pub consumed_submissions: u64, + pub published_frames: u64, pub presented_frames: u64, pub repeated_presents: u64, pub render_errors: u64, + pub publish_errors: u64, pub present_errors: u64, pub stale_epoch_discards: u64, pub shutdown_discards: u64, + pub shutdown_timeouts: u64, + pub worker_panics: u64, pub last_produced_frame_id: u64, pub last_consumed_frame_id: u64, + pub last_published_frame_id: u64, pub last_presented_frame_id: u64, pub last_dropped_frame_id: u64, pub last_error_frame_id: u64, pub active_render_epoch: u64, } +impl TelemetryFrame { + pub fn render_worker_telemetry(&self) -> RenderWorkerTelemetry { + RenderWorkerTelemetry { + produced_submissions: self.produced_submissions, + replaced_before_consume: self.replaced_before_consume, + consumed_submissions: self.consumed_submissions, + published_frames: self.published_frames, + presented_frames: self.presented_frames, + repeated_frames: self.repeated_presents, + stale_submission_discards: self.stale_epoch_discards, + render_failures: self.render_errors, + publish_failures: self.publish_errors, + present_failures: self.present_errors, + shutdown_timeouts: self.shutdown_timeouts, + worker_panics: self.worker_panics, + last_produced_frame_id: self.last_produced_frame_id, + last_consumed_frame_id: self.last_consumed_frame_id, + last_published_frame_id: self.last_published_frame_id, + last_presented_frame_id: self.last_presented_frame_id, + last_dropped_frame_id: self.last_dropped_frame_id, + last_error_frame_id: self.last_error_frame_id, + active_render_epoch: self.active_render_epoch, + } + } +} + /// Thread-safe, atomic telemetry storage for real-time monitoring by the host. /// This follows the push-based model from DEC-0005 to avoid expensive scans or locks. #[derive(Debug, Default)] @@ -84,14 +116,19 @@ pub struct AtomicTelemetry { pub produced_submissions: AtomicU64, pub replaced_before_consume: AtomicU64, pub consumed_submissions: AtomicU64, + pub published_frames: AtomicU64, pub presented_frames: AtomicU64, pub repeated_presents: AtomicU64, pub render_errors: AtomicU64, + pub publish_errors: AtomicU64, pub present_errors: AtomicU64, pub stale_epoch_discards: AtomicU64, pub shutdown_discards: AtomicU64, + pub shutdown_timeouts: AtomicU64, + pub worker_panics: AtomicU64, pub last_produced_frame_id: AtomicU64, pub last_consumed_frame_id: AtomicU64, + pub last_published_frame_id: AtomicU64, pub last_presented_frame_id: AtomicU64, pub last_dropped_frame_id: AtomicU64, pub last_error_frame_id: AtomicU64, @@ -128,14 +165,19 @@ impl AtomicTelemetry { produced_submissions: self.produced_submissions.load(Ordering::Relaxed), replaced_before_consume: self.replaced_before_consume.load(Ordering::Relaxed), consumed_submissions: self.consumed_submissions.load(Ordering::Relaxed), + published_frames: self.published_frames.load(Ordering::Relaxed), presented_frames: self.presented_frames.load(Ordering::Relaxed), repeated_presents: self.repeated_presents.load(Ordering::Relaxed), render_errors: self.render_errors.load(Ordering::Relaxed), + publish_errors: self.publish_errors.load(Ordering::Relaxed), present_errors: self.present_errors.load(Ordering::Relaxed), stale_epoch_discards: self.stale_epoch_discards.load(Ordering::Relaxed), shutdown_discards: self.shutdown_discards.load(Ordering::Relaxed), + shutdown_timeouts: self.shutdown_timeouts.load(Ordering::Relaxed), + worker_panics: self.worker_panics.load(Ordering::Relaxed), last_produced_frame_id: self.last_produced_frame_id.load(Ordering::Relaxed), last_consumed_frame_id: self.last_consumed_frame_id.load(Ordering::Relaxed), + last_published_frame_id: self.last_published_frame_id.load(Ordering::Relaxed), last_presented_frame_id: self.last_presented_frame_id.load(Ordering::Relaxed), last_dropped_frame_id: self.last_dropped_frame_id.load(Ordering::Relaxed), last_error_frame_id: self.last_error_frame_id.load(Ordering::Relaxed), @@ -165,14 +207,19 @@ impl AtomicTelemetry { self.produced_submissions.store(0, Ordering::Relaxed); self.replaced_before_consume.store(0, Ordering::Relaxed); self.consumed_submissions.store(0, Ordering::Relaxed); + self.published_frames.store(0, Ordering::Relaxed); self.presented_frames.store(0, Ordering::Relaxed); self.repeated_presents.store(0, Ordering::Relaxed); self.render_errors.store(0, Ordering::Relaxed); + self.publish_errors.store(0, Ordering::Relaxed); self.present_errors.store(0, Ordering::Relaxed); self.stale_epoch_discards.store(0, Ordering::Relaxed); self.shutdown_discards.store(0, Ordering::Relaxed); + self.shutdown_timeouts.store(0, Ordering::Relaxed); + self.worker_panics.store(0, Ordering::Relaxed); self.last_produced_frame_id.store(0, Ordering::Relaxed); self.last_consumed_frame_id.store(0, Ordering::Relaxed); + self.last_published_frame_id.store(0, Ordering::Relaxed); self.last_presented_frame_id.store(0, Ordering::Relaxed); self.last_dropped_frame_id.store(0, Ordering::Relaxed); self.last_error_frame_id.store(0, Ordering::Relaxed); @@ -398,4 +445,51 @@ mod tests { assert_eq!(snapshot.vm_heap_allocations, 2); assert_eq!(snapshot.vm_string_materializations, 5); } + + #[test] + fn snapshot_maps_render_worker_telemetry() { + let current = Arc::new(AtomicU32::new(0)); + let tel = AtomicTelemetry::new(current); + tel.produced_submissions.store(2, Ordering::Relaxed); + tel.replaced_before_consume.store(1, Ordering::Relaxed); + tel.consumed_submissions.store(1, Ordering::Relaxed); + tel.published_frames.store(1, Ordering::Relaxed); + tel.presented_frames.store(1, Ordering::Relaxed); + tel.repeated_presents.store(3, Ordering::Relaxed); + tel.render_errors.store(4, Ordering::Relaxed); + tel.publish_errors.store(5, Ordering::Relaxed); + tel.present_errors.store(6, Ordering::Relaxed); + tel.stale_epoch_discards.store(7, Ordering::Relaxed); + tel.shutdown_timeouts.store(8, Ordering::Relaxed); + tel.worker_panics.store(9, Ordering::Relaxed); + tel.last_produced_frame_id.store(10, Ordering::Relaxed); + tel.last_consumed_frame_id.store(11, Ordering::Relaxed); + tel.last_published_frame_id.store(12, Ordering::Relaxed); + tel.last_presented_frame_id.store(13, Ordering::Relaxed); + tel.last_dropped_frame_id.store(14, Ordering::Relaxed); + tel.last_error_frame_id.store(15, Ordering::Relaxed); + tel.active_render_epoch.store(16, Ordering::Relaxed); + + let worker = tel.snapshot().render_worker_telemetry(); + + assert_eq!(worker.produced_submissions, 2); + assert_eq!(worker.replaced_before_consume, 1); + assert_eq!(worker.consumed_submissions, 1); + assert_eq!(worker.published_frames, 1); + assert_eq!(worker.presented_frames, 1); + assert_eq!(worker.repeated_frames, 3); + assert_eq!(worker.render_failures, 4); + assert_eq!(worker.publish_failures, 5); + assert_eq!(worker.present_failures, 6); + assert_eq!(worker.stale_submission_discards, 7); + assert_eq!(worker.shutdown_timeouts, 8); + assert_eq!(worker.worker_panics, 9); + assert_eq!(worker.last_produced_frame_id, 10); + assert_eq!(worker.last_consumed_frame_id, 11); + assert_eq!(worker.last_published_frame_id, 12); + assert_eq!(worker.last_presented_frame_id, 13); + assert_eq!(worker.last_dropped_frame_id, 14); + assert_eq!(worker.last_error_frame_id, 15); + assert_eq!(worker.active_render_epoch, 16); + } } diff --git a/discussion/index.ndjson b/discussion/index.ndjson index 91e7066c..3e5615b6 100644 --- a/discussion/index.ndjson +++ b/discussion/index.ndjson @@ -2,7 +2,7 @@ {"type":"discussion","id":"DSC-0039","status":"abandoned","ticket":"render-pipeline-family-and-future-3d","title":"Render Pipeline Family and Future 3D","created_at":"2026-06-04","updated_at":"2026-06-04","tags":["gfx","renderer","runtime","architecture","pipeline"],"agendas":[{"id":"AGD-0039","file":"AGD-0039-render-pipeline-family-and-future-3d.md","status":"abandoned","created_at":"2026-06-04","updated_at":"2026-06-04","_override_reason":"User explicitly chose to close this agenda without a new decision because DSC-0038 already established enough architecture for future extension, and 3D is intentionally deferred."}],"decisions":[],"plans":[],"lessons":[],"_override_reason":"User explicitly chose to close this agenda without a new decision because DSC-0038 already established enough architecture for future extension, and 3D is intentionally deferred."} {"type":"discussion","id":"DSC-0040","status":"done","ticket":"vm-render-parallel-execution-boundary","title":"VM and Render Parallel Execution Boundary","created_at":"2026-06-04","updated_at":"2026-06-06","tags":["runtime","renderer","vm","concurrency","architecture","perf"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0048","file":"discussion/lessons/DSC-0040-vm-render-parallel-execution-boundary/LSN-0048-render-workers-need-a-closed-packet-contract.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-06"}]} {"type":"discussion","id":"DSC-0041","status":"open","ticket":"foreground-stack-game-pause-shell-vm-backed","title":"Foreground Stack, Game Pause, and VM-Backed Shell Coexistence","created_at":"2026-06-05","updated_at":"2026-06-05","tags":["runtime","os","lifecycle","shell","game","vm","foreground","architecture"],"agendas":[{"id":"AGD-0041","file":"AGD-0041-foreground-stack-game-pause-shell-vm-backed.md","status":"open","created_at":"2026-06-05","updated_at":"2026-06-05"}],"decisions":[],"plans":[],"lessons":[]} -{"type":"discussion","id":"DSC-0042","status":"in_progress","ticket":"real-render-worker-establishment","title":"Real Render Worker Establishment","created_at":"2026-06-06","updated_at":"2026-06-15","tags":["runtime","renderer","worker","concurrency","host","hal","architecture"],"agendas":[{"id":"AGD-0042","file":"AGD-0042-host-hardware-render-boundary-preparation.md","status":"accepted","created_at":"2026-06-06","updated_at":"2026-06-06"},{"id":"AGD-0043","file":"AGD-0043-real-render-worker-establishment.md","status":"accepted","created_at":"2026-06-06","updated_at":"2026-06-15"}],"decisions":[{"id":"DEC-0032","file":"DEC-0032-platform-layer-and-hardwarebridge-elimination.md","status":"accepted","created_at":"2026-06-06","updated_at":"2026-06-06","ref_agenda":"AGD-0042"},{"id":"DEC-0033","file":"DEC-0033-real-render-worker-contract.md","status":"accepted","created_at":"2026-06-15","updated_at":"2026-06-15","ref_agenda":"AGD-0043"}],"plans":[{"id":"PLN-0098","file":"PLN-0098-define-platform-facade-contracts.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0099","file":"PLN-0099-introduce-owned-render-submission-sink.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0100","file":"PLN-0100-migrate-local-render-publication-to-sink.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0101","file":"PLN-0101-remove-immediate-gfx-syscall-rendering.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0102","file":"PLN-0102-introduce-game2d-frame-composer-service.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0103","file":"PLN-0103-introduce-runtime-platform-and-testplatform.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0104","file":"PLN-0104-migrate-vm-runtime-hostcontext-to-platform.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0105","file":"PLN-0105-migrate-firmware-and-hub-to-platform-services.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0106","file":"PLN-0106-migrate-desktop-host-to-platform-services.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0107","file":"PLN-0107-migrate-remaining-platform-domains.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0108","file":"PLN-0108-migrate-tests-to-testplatform.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0109","file":"PLN-0109-remove-hardwarebridge-and-update-specs.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0110","file":"PLN-0110-define-owned-rgba8888-frame-contract.md","status":"done","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0111","file":"PLN-0111-define-read-only-render-resource-access.md","status":"done","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0112","file":"PLN-0112-define-render-worker-errors-and-telemetry.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0113","file":"PLN-0113-implement-thread-safe-latest-wins-handoff.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0114","file":"PLN-0114-add-deterministic-render-worker-test-harness.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0115","file":"PLN-0115-implement-render-worker-controller-lifecycle.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0116","file":"PLN-0116-implement-fake-local-render-backend.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0117","file":"PLN-0117-integrate-runtime-submission-with-worker.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0118","file":"PLN-0118-add-stale-epoch-and-repeat-frame-behavior.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0119","file":"PLN-0119-integrate-desktop-host-worker-presentation.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0120","file":"PLN-0120-update-real-render-worker-specs.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0121","file":"PLN-0121-final-worker-path-validation-and-hardening.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]}],"lessons":[]} +{"type":"discussion","id":"DSC-0042","status":"in_progress","ticket":"real-render-worker-establishment","title":"Real Render Worker Establishment","created_at":"2026-06-06","updated_at":"2026-06-15","tags":["runtime","renderer","worker","concurrency","host","hal","architecture"],"agendas":[{"id":"AGD-0042","file":"AGD-0042-host-hardware-render-boundary-preparation.md","status":"accepted","created_at":"2026-06-06","updated_at":"2026-06-06"},{"id":"AGD-0043","file":"AGD-0043-real-render-worker-establishment.md","status":"accepted","created_at":"2026-06-06","updated_at":"2026-06-15"}],"decisions":[{"id":"DEC-0032","file":"DEC-0032-platform-layer-and-hardwarebridge-elimination.md","status":"accepted","created_at":"2026-06-06","updated_at":"2026-06-06","ref_agenda":"AGD-0042"},{"id":"DEC-0033","file":"DEC-0033-real-render-worker-contract.md","status":"accepted","created_at":"2026-06-15","updated_at":"2026-06-15","ref_agenda":"AGD-0043"}],"plans":[{"id":"PLN-0098","file":"PLN-0098-define-platform-facade-contracts.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0099","file":"PLN-0099-introduce-owned-render-submission-sink.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0100","file":"PLN-0100-migrate-local-render-publication-to-sink.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0101","file":"PLN-0101-remove-immediate-gfx-syscall-rendering.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0102","file":"PLN-0102-introduce-game2d-frame-composer-service.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0103","file":"PLN-0103-introduce-runtime-platform-and-testplatform.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0104","file":"PLN-0104-migrate-vm-runtime-hostcontext-to-platform.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0105","file":"PLN-0105-migrate-firmware-and-hub-to-platform-services.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0106","file":"PLN-0106-migrate-desktop-host-to-platform-services.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0107","file":"PLN-0107-migrate-remaining-platform-domains.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0108","file":"PLN-0108-migrate-tests-to-testplatform.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0109","file":"PLN-0109-remove-hardwarebridge-and-update-specs.md","status":"done","created_at":"2026-06-06","updated_at":"2026-06-15","ref_decisions":["DEC-0032"]},{"id":"PLN-0110","file":"PLN-0110-define-owned-rgba8888-frame-contract.md","status":"done","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0111","file":"PLN-0111-define-read-only-render-resource-access.md","status":"done","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0112","file":"PLN-0112-define-render-worker-errors-and-telemetry.md","status":"done","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0113","file":"PLN-0113-implement-thread-safe-latest-wins-handoff.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0114","file":"PLN-0114-add-deterministic-render-worker-test-harness.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0115","file":"PLN-0115-implement-render-worker-controller-lifecycle.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0116","file":"PLN-0116-implement-fake-local-render-backend.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0117","file":"PLN-0117-integrate-runtime-submission-with-worker.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0118","file":"PLN-0118-add-stale-epoch-and-repeat-frame-behavior.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0119","file":"PLN-0119-integrate-desktop-host-worker-presentation.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0120","file":"PLN-0120-update-real-render-worker-specs.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]},{"id":"PLN-0121","file":"PLN-0121-final-worker-path-validation-and-hardening.md","status":"open","created_at":"2026-06-15","updated_at":"2026-06-15","ref_decisions":["DEC-0033"]}],"lessons":[]} {"type":"discussion","id":"DSC-0038","status":"done","ticket":"render-frame-packet-boundary","title":"Logical Render Pipelines and Command Packets","created_at":"2026-05-25","updated_at":"2026-06-04","tags":["gfx","renderer","runtime","frame-composer","architecture","ui","pipeline"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0047","file":"discussion/lessons/DSC-0038-render-frame-packet-boundary/LSN-0047-typed-render-submissions-preserve-domain-boundaries.md","status":"done","created_at":"2026-06-04","updated_at":"2026-06-04"}]} {"type":"discussion","id":"DSC-0035","status":"done","ticket":"task-owned-shell-windows","title":"Agenda - Task-Owned Shell Windows","created_at":"2026-05-15","updated_at":"2026-05-15","tags":["runtime","os","task","window-manager","shell","lifecycle"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0044","file":"discussion/lessons/DSC-0035-task-owned-shell-windows/LSN-0044-task-window-liveness-belongs-to-the-task.md","status":"done","created_at":"2026-05-15","updated_at":"2026-05-15"}]} {"type":"discussion","id":"DSC-0034","status":"done","ticket":"system-os-domain-facades","title":"Agenda - SystemOS Domain Facades","created_at":"2026-05-15","updated_at":"2026-05-15","tags":["runtime","os","services","api-surface","lifecycle","fs"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0043","file":"discussion/lessons/DSC-0034-system-os-domain-facades/LSN-0043-systemos-domain-facades.md","status":"done","created_at":"2026-05-15","updated_at":"2026-05-15"}]} diff --git a/discussion/workflow/plans/PLN-0112-define-render-worker-errors-and-telemetry.md b/discussion/workflow/plans/PLN-0112-define-render-worker-errors-and-telemetry.md index d9b498fa..6d8df73d 100644 --- a/discussion/workflow/plans/PLN-0112-define-render-worker-errors-and-telemetry.md +++ b/discussion/workflow/plans/PLN-0112-define-render-worker-errors-and-telemetry.md @@ -2,7 +2,7 @@ id: PLN-0112 ticket: real-render-worker-establishment title: Define Render Worker Errors and Telemetry -status: open +status: done created: 2026-06-15 completed: ref_decisions: [DEC-0033]