Luigit
repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by admin

quickshell/nuguland/.system/plans/NL-PLAN-7AB0F679-nugu-desktop-theme-rollout/index.md

Raw
Rendered preview

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.

---
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.