aboutsummaryrefslogtreecommitdiff
path: root/todo.org
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-07-09 17:57:29 -0500
committerCraig Jennings <c@cjennings.net>2026-07-09 17:57:29 -0500
commit186b27d3ab10ffa40fff8103f35bf1226e05ab3a (patch)
tree4d77fdb834d6dd60cd5c61ea24c9f90c6d1744a7 /todo.org
parentcb0a67ee022619251747e18edfcb63cf6e5f9fd9 (diff)
downloadarchsetup-186b27d3ab10ffa40fff8103f35bf1226e05ab3a.tar.gz
archsetup-186b27d3ab10ffa40fff8103f35bf1226e05ab3a.zip
docs: close the audio-doctor decisions, spec is READYHEADmain
All eight decisions resolved. DOCTOR is a section-header key; CLI-first with the GUI as a face; hung and dead are two verdicts sharing one remedy; the remedy tiers stand as drafted; a stream-active guard refuses the audible remedies and is overridable by pressing again; xruns stay out of v1. Two consequences the questions did not make obvious. Taking the guard is what lets the pipewire-pulse restart stay at Confirm — the danger lives in the state of the machine, not the identity of the remedy. And the guard must read stream state from pw-dump rather than pactl: the remedies it protects are the ones you reach for when the Pulse layer is dead, so a pactl-fed guard would go blind exactly when it is needed. Tier 4 drops its xrun probe to match the decision, rather than leaving the probe list contradicting the answer.
Diffstat (limited to 'todo.org')
-rw-r--r--todo.org2
1 files changed, 1 insertions, 1 deletions
diff --git a/todo.org b/todo.org
index 6b3214f..1196e19 100644
--- a/todo.org
+++ b/todo.org
@@ -1129,7 +1129,7 @@ Verified: the only =eval= left in =archsetup= is line 578 in =retry_install=, an
:PROPERTIES:
:LAST_REVIEWED: 2026-07-09
:END:
-What happens when pipewire or pulseaudio is broken — would we know? Spec written 2026-07-09: [[file:docs/specs/2026-07-09-audio-doctor-spec.org][docs/specs/2026-07-09-audio-doctor-spec.org]] (DRAFT, 6 open decisions; Phase 0 shipped). Grounded in a live survey of ratio's stack: there is no PulseAudio (pipewire + wireplumber + pipewire-pulse, all user-scope, so no sudo anywhere), =pactl= hangs against a server that accepts and never answers, and the panel can't diagnose itself because =pactl= is the layer most likely to be down. Mirrors the net panel's diag/classify/repair/doctor split, not the maint console's priv-verb table.
+What happens when pipewire or pulseaudio is broken — would we know? Spec: [[file:docs/specs/2026-07-09-audio-doctor-spec.org][docs/specs/2026-07-09-audio-doctor-spec.org]] — *READY*, all eight decisions closed 2026-07-09, Phase 0 shipped. Buildable: Phase 1 diag, Phase 2 classify, Phase 3 repair + doctor, Phase 4 the DOCTOR key and wall. Grounded in a live survey of ratio's stack: there is no PulseAudio (pipewire + wireplumber + pipewire-pulse, all user-scope, so no sudo anywhere), =pactl= hangs against a server that accepts and never answers, and the panel can't diagnose itself because =pactl= is the layer most likely to be down. Mirrors the net panel's diag/classify/repair/doctor split, not the maint console's priv-verb table.
Re-graded =[#C]= → =[#B]= by the 2026-07-09 audit: the spec is written, Phase 0 shipped, and six decisions are all that stand between this and a build. Active backlog, not parking lot.