Generator boundary
Produce deterministic dark and light color-only artifacts from the Nugu palette.
Exit when generation and palette validation pass for both modes.
Runtime state and command boundary
Provide Nuguland-owned desired-mode selection, toggle, preparation, and read-only status against the existing XDG state file; preserve existing valid mode during migration.
Exit when isolated failure/recovery and serialization tests pass without Nugu source available.
Deliver typed Registry-owned Config sections, the Sections form and Light setup deep link; DDC execution stays in Brightness and its core controls remain Light-local.
Prove Config publication/failure/retry, retained navigation/drafts, DDC stages/cancellation, reviewed QML pixels, named suites and full gates.
Consumer adapters
Publish the selected preference for the XDG Settings portal; preserve native WezTerm appearance and indexed TUI inheritance, plus named installed-artifact integrations for explicit-RGB consumers.
Runtime code selects preinstalled variants only and never imports generators or regenerates palettes.
Exit when native private-portal/terminal/editor/mail proofs pass and partial failures report selected intent truthfully.
Startup integration
Have every startup/manual compatibility wrapper delegate to the same Nuguland runtime implementation, reconciling installed artifacts and preference from preserved authority before consumer startup.
Exit when direct and legacy cold-start success/refusal, startup reconciliation, and repository invariance pass.
Contract verification
Run generator checks, both transitions, desktop-preference assertions, repository-diff invariance, and human visual review.
Exit only when the full round trip passes without a tracked change.
Delivered Config slices
Installed-artifact theme runtime with Nugu source unavailable, preserved mode authority and truthful publication/recovery.
Typed Config Sections proof for appearance and DDC setup; operational Light controls remain local.
Calendar account, Vault profile and Noko setup migrated; persisted bar orientation and per-section focus/scroll share the generic renderer.
Verification: 101 JS/MJS tests, 27 Rust tests, 16 loads, full nested UI 22/22, actual typing and reviewed QML pixels.
Queued orientation-write proof rejects removal of queue handling; production implementation passes 16 concurrent runs.
Failed-to-launch paths remain explicitly unproven; native stubs and private portal proof do not establish real accounts, hardware or installed-desktop delivery.
Live human visual acceptance remains open.
---
id: NL-PLAN-7AB0F679
type: plan
title: Nugu desktop theme rollout
spec: NL-SPEC-83056D8D
status: approved
---
# Nugu desktop theme rollout
1. **Generator boundary**
Produce deterministic dark and light color-only artifacts from the Nugu palette.
Exit when generation and palette validation pass for both modes.
2. **Runtime state and command boundary**
Provide Nuguland-owned desired-mode selection, toggle, preparation, and read-only status against the existing XDG state file; preserve existing valid mode during migration.
Exit when isolated failure/recovery and serialization tests pass without Nugu source available.
Deliver typed Registry-owned Config sections, the Sections form and Light setup deep link; DDC execution stays in Brightness and its core controls remain Light-local.
Prove Config publication/failure/retry, retained navigation/drafts, DDC stages/cancellation, reviewed QML pixels, named suites and full gates.
3. **Consumer adapters**
Publish the selected preference for the XDG Settings portal; preserve native WezTerm appearance and indexed TUI inheritance, plus named installed-artifact integrations for explicit-RGB consumers.
Runtime code selects preinstalled variants only and never imports generators or regenerates palettes.
Exit when native private-portal/terminal/editor/mail proofs pass and partial failures report selected intent truthfully.
4. **Startup integration**
Have every startup/manual compatibility wrapper delegate to the same Nuguland runtime implementation, reconciling installed artifacts and preference from preserved authority before consumer startup.
Exit when direct and legacy cold-start success/refusal, startup reconciliation, and repository invariance pass.
5. **Contract verification**
Run generator checks, both transitions, desktop-preference assertions, repository-diff invariance, and human visual review.
Exit only when the full round trip passes without a tracked change.
## Delivered Config slices
1. Installed-artifact theme runtime with Nugu source unavailable, preserved mode authority and truthful publication/recovery.
2. Typed Config Sections proof for appearance and DDC setup; operational Light controls remain local.
3. Calendar account, Vault profile and Noko setup migrated; persisted bar orientation and per-section focus/scroll share the generic renderer.
Verification: 101 JS/MJS tests, 27 Rust tests, 16 loads, full nested UI 22/22, actual typing and reviewed QML pixels.
Queued orientation-write proof rejects removal of queue handling; production implementation passes 16 concurrent runs.
Failed-to-launch paths remain explicitly unproven; native stubs and private portal proof do not establish real accounts, hardware or installed-desktop delivery.
Live human visual acceptance remains open.