| Commit message (Collapse) | Author | Age | Files | Lines |
|---|
| |
|
|
|
|
| |
The engine-telegraph state dial (references filed in the catalogue's working directory — an electric indicator and a ship's engine-order telegraph): a cream pie of labeled sectors with a red pointer and its little flag naming the active state, stepping with a swing on click. The annunciator grid shows states as cells and the rotary selector is input; state-by-pointer-on-sectors was the missing indication form.
I verified it in headless Chrome: clicks step through all six states and wrap, no console exceptions.
|
| |
|
|
|
|
| |
The critical-switch idiom after a flight-deck panel (reference filed in the catalogue's working directory): cast guard posts flank the lever and a red collar marks it critical. The guard is the point — friction sized to consequence, the physical cousin of the kit's arm-to-fire confirm. A second reference (an SCE-style switch with a rectangular guard plate) confirmed the idiom while it was being built.
I verified it in headless Chrome: the lever throws both ways with legends relighting, no console exceptions.
|
| |
|
|
|
|
| |
The heavy master-power selector after a marine battery switch (reference filed in the catalogue's working directory): the whole red disc turns with a molded grip bar and a cream index notch, stepping OFF, ON, COMBINE with the active legend lit. A disc that is itself the handle was the one heavy-switch form the kit lacked.
I verified it in headless Chrome: clicks cycle all three positions and wrap, the disc rotates with its settle transition, no console exceptions.
|
| |
|
|
|
|
| |
The red T-bar gain switch after a classic mic-preamp: a bar-grip handle with a cream index over a dot ring, snapping between labeled dB detents from -80 to +10. This completes the kit's handle-form taxonomy — round, skirted, lever, spun, and knurled-with-spade were built; the bar grip was the missing form.
I verified it in headless Chrome: drags snap between detents in both directions and the readout follows, no console exceptions.
|
| |
|
|
|
|
| |
A frequency-domain plot after a mastering processor's response display (references filed in the catalogue's working directory): log-frequency grid from 32 Hz to 16 kHz with labeled dB rails, an amber bell curve drawn live from a peak the user places, and a handle draggable in both axes at once. The kit's other traces are time-domain; this is its first x/y function display and its first two-axis drag.
I verified it in headless Chrome: press places the peak, dragging moves it in frequency and gain together, the curve and readout follow, no console exceptions.
|
| |
|
|
|
|
|
|
|
|
| |
Three widgets closing the reference batch (pedal references filed in the catalogue's working directory):
- R23 spun-aluminum knob: bright machined face with concentric tooling rings inside a knurled grip ring, red index over dot ticks. Promoted from the banked queue after a second independent reference confirmed it.
- R24 stomp switch + jewel: the pedal engage pair — a chrome dome stomp and the faceted jewel that reports the state, translated to the kit's amber.
- R25 fourteen-segment display: the starburst alphanumeric that spells words, with a per-letter segment map and glow. Click cycles ZOOM/ECHO/TAPE/MOOD/HALL/COMP.
I verified all three in headless Chrome: the knob tracks drags, the stomp toggles the jewel both ways, the display respells on click with the exact segment count the letter map predicts, no console exceptions.
|
| |
|
|
|
|
|
|
| |
A detented slide switch after a drum machine's variation control (reference filed in the catalogue's working directory): a chrome pill parks at A, AB, or B, the active legend lights, and the LED pair below reports honestly — A or B lights its own dot, AB lights both. Clicking a position moves the pill with a short settle.
The kit had toggles, segmented buttons, and continuous sliders, but no detented multi-position slide.
I verified all three positions in headless Chrome: the pill parks, legends relight, and the LED count matches the position (2 for AB, 1 otherwise), no console exceptions.
|
| |
|
|
|
|
|
|
| |
The classic program-select idiom after a digital reverb's program bank (reference filed in the catalogue's working directory): eight identical dark keys, numbered, with a red LED dot above each. The LED carries the selection, not the key face — exactly one lit at a time, and the readout names the program. Keys press with the same momentary dip as the entry keypad.
This maps directly onto a workspace selector for the waybar target.
I verified it in headless Chrome: clicking a key moves the single lit LED and renames the readout, no console exceptions.
|
| |
|
|
|
|
|
|
| |
An equalizer-style tone selector pair as inline SVG (reference filed in the catalogue's working directory): each numbered drum shows through a tall window with curvature shading, and the center value sits on an inverted chip. The drums drag independently with a short roll transition.
This differs from the thumbwheel, which shows one number in a separate window. Here the visible number strip is itself the control face, like the source hardware.
I verified both drums in headless Chrome: independent drags roll the strips and update the chips, no console exceptions.
|
| |
|
|
|
|
|
|
| |
A sampler-style edit screen as inline SVG: a monochrome LCD with the sample drawn as bars around a dotted centerline, S and E flags marking the selected region, the selection drawn bright against dim surroundings, and the header and status-bar chrome of the source device. Dragging moves whichever flag is nearer the pointer, and the flags cannot cross.
Region selection on a waveform is a new interaction for the kit. The existing waveform strip is display-only.
I verified it in headless Chrome: each flag moves independently by proximity, the selection re-brightens, no console exceptions.
|
| |
|
|
|
|
|
|
| |
Two narrow rail channels after a compressor's blend/mix pair (reference filed in the catalogue's working directory): a lit amber numeral column (100 down to 0) inside each screwed rail, a cream thumb tab riding the rail's edge, and the numeral nearest the value lighting bright. The channels drag independently and the readout carries both.
This differs from the R12 slot fader on both counts that matter: the scale is a lit column inside the channel rather than engraved beside it, and the control is a side tab rather than a T-handle.
I verified both channels in headless Chrome: independent drags move each tab and relight the nearest figure, no console exceptions.
|
| |
|
|
|
|
| |
The round-tube scope after a 1950s bench oscilloscope (reference filed in the catalogue's working directory): pale phosphor face in a screwed porthole bezel, dark graticule, and a bright live trace with a soft glow underlay. The kit's rectangular N11 scope is the modern face; this is the pre-60s one, light screen instead of dark.
I verified it in headless Chrome: the trace animates and Vpp tracks the envelope, no console exceptions.
|
| |
|
|
|
|
| |
R16 is the first composed card: a display window, an indicator lamp pod, and a 4x3 key grid working as one instrument. Digits fill the amber display (dim dashes for empty positions), the top lamp lights while the buffer holds anything, the amber check key confirms and the amber cross key clears with a lamp flash. The keycaps are worn gray with per-key numeral jitter, after an industrial keypad prop (reference filed in the catalogue's working directory).
I verified the flow in headless Chrome: digits append, confirm reports the code and empties the buffer, clear flashes the lamp, no console exceptions.
|
| |
|
|
| |
The count went stale twice in one session. The masthead now names the batches without a number.
|
| |
|
|
|
|
|
|
|
| |
Two radio-receiver widgets as inline SVG, after a 1920s GE receiver panel and a Hallicrafters shortwave dial pair:
- R14 spade-pointer tuning knob: a knurled bakelite knob carries a bright spade pointer over a 0-10 scale rendered as engraved relief (each mark drawn with a light offset twin, ink-free like the source panel). The knurl ring turns with the knob.
- R15 multi-band dial: four nested band arcs on a cream face read by one long needle; the active ring draws bold and the rest fade. Dragging the main dial tunes within the active band's frequency range, and clicking the bandspread dial steps bands, turning its own needle.
I verified both in headless Chrome: the spade knob tracks drags, tuning moves the needle and readout, the band click switches range and re-weights the rings, no console exceptions. The gallery is at 68 cards.
|
| |
|
|
|
|
|
|
|
| |
Two more reference-batch widgets as inline SVG, from channel-strip references (the fader's source screenshot is filed in the catalogue's working directory):
- R12 chrome slot fader: a chrome T-handle with a conical nose rides a recessed slot, the signed dB scale (+12 to -24) engraved on a screwed-down plate. Drag; the readout shows signed dB.
- R13 edgewise strip meter: a parchment vertical scale with the compressed log spacing of a gain-reduction meter (0/3/6/12/20/40), a dark bar riding its edge. Drag-driven.
I verified both in headless Chrome: handle and bar track drags with correct dB interpolation, no console exceptions. The gallery is at 66 cards.
|
| |
|
|
|
|
|
|
|
|
|
| |
Four more reference-batch widgets as inline SVG, from pasted hardware references (a hi-fi chrome level window, aviation instrument clusters, and a vintage altimeter):
- R08 chrome MIN/MAX indicator: polished ring, brushed metal dome, cog hub, dark pointer sweeping MIN to MAX.
- R09 black-face aviation gauge: amber ticks and numerals on black, painted green/amber/red zone arcs per the airspeed-indicator scheme, glowing amber needle.
- R10 data matrix readout: a lit amber data block with labeled fields; click cycles SYS/NET/TIME pages, and the TIME page runs off the real clock.
- R11 warning flag window: a striped barber-pole slides into the window when tripped, the mechanical alarm idiom as distinct from a lamp.
I verified all four in headless Chrome: both meters track drags, the pages cycle, the flag trips and clears, no console exceptions. The gallery is at 64 cards.
|
| |
|
|
|
|
|
|
|
|
|
|
| |
Three more reference-batch widgets as inline SVG, from the Berna-style faceplate set:
- R05 filter slider bank: eight band faders with teal double-arrow caps on black tracks, frequency labels up top, a dB rail at the side. Per-band drag; the readout names the band and its attenuation.
- R06 chicken-head selector: the tapered lever aims at the engraved position (OFF/LO/MID/HI); the active legend lights. Click steps through.
- R07 round panel meter: porthole black bezel, cream dial, printed dB arc with red zone, drag-driven needle.
R07 shares the VU-law dB interpolation with R01 through a new vuDb helper, so the nonlinear scale lives in one place.
I verified all three in headless Chrome: band drags update cap and readout, the selector steps and relights, the meter needle tracks drags, no console exceptions. The gallery is at 60 cards.
|
| |
|
|
|
|
|
|
|
|
|
| |
I built four widgets as inline SVG (the substrate that ports to svg.el), modeled on 1950s-60s lab and console hardware from the reference photos now filed in the catalogue's working directory:
- R01 moving-coil VU meter: cream face, authentic nonlinear dB arc (-20 to +3), red zone, ballistic needle on the live signal.
- R02 calibrated vernier dial: rotating tick-ring disc with radial numerals under a fixed hairline, fluted bakelite knob, reads to a tenth.
- R03 bat-handle toggle: chrome lever on a hex bushing, snaps ON/OFF with lit legends.
- R04 bakelite fluted knob: scalloped skirt, glossy dome, amber index over a printed 0-10 scale.
I verified all four in headless Chrome: the VU animates with ballistics, the dial and knob track drags, the toggle throws, no console exceptions. The gallery now carries 57 cards.
|
| |
|
|
| |
The generated file declares (provide 'gallery-tokens), but `require` resolves a feature by filename, so as tokens.el it could never load from a load-path. The name now matches the feature. gen_tokens.py, the renderer's load, and the README follow.
|
| |
|
|
|
|
|
|
|
|
| |
gallery-widget.el is the proof-of-concept Emacs renderer: it reads the generated tokens.el and renders the needle gauge (card 10) as SVG via svg.el. Rasterized through librsvg (the renderer Emacs itself uses), it matches the web card side by side: same arc, ticks, glowing amber needle, half-dome hub, and readout from the same tokens. That closes the riskiest unknown in the three-target plan, so the component pattern can now scale widget by widget.
The comparison surfaced a real gallery bug: the web gauge's ticks were invisible. Their transform-origin put the rotation center 40px below the dial, so the rotated ticks landed outside the clipped area. I moved the ticks to the arc's top edge with the origin at the pivot, and all three now show at -60/0/+60.
The parseability test caught a second bug: the mono token's font stack carries double quotes, which broke the font-family XML attribute. The renderer swaps them to single quotes.
Tests are ERT (tests/gallery-widgets/), covering token resolution, angle math (normal/boundary/error), and the rendered document's structure. make test-unit now runs the elisp suites alongside the python ones, and make test-elisp runs them alone.
|
| |
|
|
|
|
|
|
|
|
|
|
| |
The colors, glows, gradient ramp, and pulse rate were hardcoded literals scattered across ~40 sites in the gallery. Retuning the amber meant a find-and-replace through the whole file. I pulled them into tokens.json as the single source.
gen_tokens.py reads that source and emits three targets: web CSS custom properties (into the gallery :root, between markers), waybar GTK @define-color declarations, and an elisp alist for the future svg.el renderer. The three genuinely differ (CSS --vars with rgb-triple glows, GTK @define-color with underscore names, elisp hex alist), which is why one generator beats three hand-maintained copies.
The amber hue is defined once, and its glow triples are derived from the hex, so retuning it means editing one line and rerunning the generator.
The gallery render is unchanged. I verified it pixel-identical against the prior commit with reduced-motion forced and the live clock masked (diff of 0).
Tests cover hex conversion, the three emitters, marker replacement, and idempotency: 27 tests, 100% line coverage, wired into make test-unit.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
| |
I wrapped the status-lamp and jewel-pilot indicators in an inline-flex row so they render. Their sub-elements were bare inline spans, so the fixed width/height were ignored and the widgets collapsed to empty stages. The other multi-element widgets already use this pattern.
The transport cluster looked dead because the reel spokes were near-black on a near-black reel, so the rotation was invisible. Steel spokes plus one amber index spoke make the spin legible. The button logic was already correct.
All pulses now run at 1s ease-in-out. The busy lamp was 0.7s, fast enough to read as a flash rather than a pulse. I marked 1s as the standard cadence so new widgets inherit it.
I shifted the gold accent to a warm amber across the tokens, glow colors, and lit gradients together, so nothing stays yellow next to amber.
I removed the magic-eye tube, dropped from the instrument-panel design that draws from this gallery.
I renamed the file to panel-widget-gallery.html (the living catalogue now, not a dated prototype) and updated the two inbound links.
|
| |
|
|
| |
Turn the panel widget gallery into a driveable kit. Drag the faders, rotary and concentric knobs, encoder, crossfader, thumbwheel, jog wheel, and the gauge needles; click the switches, keys, DIP bank, keyed switch, transport, radio bank, patch-bay, and lamps. Every card shows a live readout that tracks the control. Adds a batch of new console idioms across controls, meters, and readouts (oscilloscope, EQ bars, strip-chart, split-flap, VFD marquee, annunciator, jewel lamps, tape counter, and more).
|
| |
|
|
| |
Bring the hi-fi selector and vacuum-tube idioms from the Takuzu design pass into the panel widget kit: a rotary selector, a slide-rule tuner dial, a nixie tube, and a magic-eye tube.
|
| |
|
|
|
|
|
|
| |
I ran spec-response Phase 6 on both READY specs. Each gets a SPEC_ID-bound parent task in todo.org with one child per implementation phase. Both specs flip from READY to DOING.
Only the read-only detection phases are buildable now, so they're marked solo: net Phase 0 (the control-plane probe) and bt Phases 0-1 (the two probes plus the firmware-hint Guide verdict). The privileged phases stay lower priority and carry a note: they're gated on the shared cross-panel run-time privilege model that doesn't exist yet. Shipping them before the Confirm floor would let --fix run root ops via passwordless sudo ungated.
I held off writing the manual-testing checklists. The phases that need live or reboot verification are the blocked ones, so their checklists would be planning work that can't start yet.
|
| |
|
|
|
|
|
|
|
|
| |
I ran spec-response on both, then two more skeptical review rounds until each reached Ready with caveats, no blocking findings. I verified every current-behavior claim against the live engine before each response. The skeptical passes earned their place by catching real blockers the first round missed.
Net: my round-1 "redaction copy/--json surface" was invented. That surface doesn't exist: SSID redaction is event-log-only and --json is raw. I re-resolved it as parity with the existing link-step behavior, plus a separate task for the systemic gap. I also made all three control-plane verdicts fixable, since a terminal outcome would never run its own fix (doctor.py:181). And I repointed the auth classifier at the profile key-mgmt and scan-security signals that carry the SAE/hidden distinction.
Bt: the AutoEnable default is true, not false (bluez 5.87), so round 1 had the "dead every boot" premise backwards and would false-positive on healthy machines. The fault now fires only on an explicit AutoEnable=false, a disabled service, or a TLP entry. The verdict "code" is an additive schema.step key, not one that exists today.
Both specs carry one caveat: Phases 1-2 need the shared cross-panel run-time privilege model, which doesn't exist yet. A hard ordering gate now sits on each: shipping the Privileged verdicts before the Confirm floor would let --fix run root ops via passwordless sudo ungated. Only Phase 0 is buildable today.
|
| |
|
|
|
|
|
|
|
|
| |
Reviewed both DRAFT expansion specs against the live engines. Both stay Not ready: three open decisions apiece plus one blocking finding each.
Net: the Security dimension claims connection names are already redacted, but redact.py covers only SSID, MAC, IP, secret-keys, and portal_url, so the new keyfile-perms and rival-manager verdicts would leak a connection name into the wall and --json. Four non-blocking fixes alongside it: nm-restart's scope was overstated, is-enabled isn't used yet, some message text was listed as classifier verdicts, and the priv.py dispatch integration wants naming.
Bt: the doctor has no named-verdict layer to hang the proposed no-adapter-firmware and powered-off-persistent verdicts on. A step carries a pass/fail/warn/info status and the run an ok/warn/fail overall, nothing more. How each new verdict is represented has to be settled before Phase 1. Three non-blocking notes cover the widening sudoers surface, the real diagnostic surface, and the bounded journalctl precedent.
Both designs are sound and target verified-real gaps: neither engine reads the config or logs the specs propose to add.
|
| |
|
|
|
|
|
|
| |
I ran the audio doctor's design arc for the net and bluetooth doctors: a blind by-layer research catalogue of failure modes, a symptom-cluster triage, then a spec per doctor.
The taxonomy holds ~74 network and ~55 bluetooth distinct root causes, each sourced to a forum or issue-tracker report, sorted into eight network and five bluetooth symptom clusters. The clusters are keyed to each doctor's existing probe ladder, so the fix-versus-guide boundary falls along the tiers the doctor already walks. Every entry carries a remedy class (auto, privileged, reboot-tail, or guide), reusing the audio doctor's four-class run-time privilege model.
The two specs are expansions, not rewrites. The net doctor is already the most mature of the three: its classifier reaches six of the eight clusters today, so its spec adds only the control-plane cluster (a rival network manager, a masked NetworkManager, a bad keyfile) and sharper auth naming. The bt doctor's chain is structurally right but blind at both ends, so its spec adds a probe that names the firmware blob the kernel already logged and a probe that catches an adapter that power-on won't keep on across reboots. Both stay DRAFT with three open decisions each, headed for spec-review.
|
| |
|
|
|
|
| |
I grounded the spec in the taxonomy and its triage. A new "Verdict clusters and remedy classes" section maps the doctor's verdicts onto the nine saturation-tested symptom clusters, ties the four remedy classes to the run-time privilege decision, and names the three new probes the taxonomy implies: dmesg hints, the unmute-doesn't-stick signature, and re-probe-after-idle.
v1 stays the buildable core, phases 0 through 4. The rest of the taxonomy is staged as later phases so v1 isn't blocked on it.
|
| |
|
|
|
|
| |
A blind resample tested whether the nine-cluster taxonomy was representative or an artifact of the first sweep. Ten agents drew 108 fresh reports through five different doors per direction, mostly non-Arch and 2024-2026, none shown the clusters. Zero forced a new cluster. About 70 re-found existing entries. The other 34 were new distinct root causes that all fit existing clusters.
I folded the 34 new entries in, 16 input and 18 output, each tagged with its cluster and remedy class, and recorded the test and its verdict. The clusters are complete and stable. Entries keep growing under them without changing the design.
|
| |
|
|
|
|
| |
I sorted both directions into nine symptom clusters each, every entry tagged Auto, Privileged, Reboot-tail, or Guide under the privilege model. The clusters mirror the doctor's probe ladder, so the boundary between what it fixes and what it can only guide falls along the tiers it already probes.
Two findings are worth keeping. The buildable core reduces to five primitives on both sides (set-default, set-card-profile, unmute, restart-services, config-drop-in), so the breadth is in the diagnosis, not the remedies. And the clusters imply three new read-only probes: dmesg-pattern hints, an unmute-doesn't-stick signature, and a re-probe-after-idle.
|
| |
|
|
|
|
|
|
| |
The input and output doctor reaches firmware, ALSA saved state, modprobe, and packages, which need root. The parent spec decided "no sudo anywhere," correct when the feature was user-scope PipeWire. This supersedes that.
The doctor resolves its privilege at run time from three signals: passwordless sudo (sudo -n true, which never hangs), a tty to prompt at, and whether it is the GUI panel. Four remedy classes follow. Auto is user-scope and runs anywhere. Privileged needs sudo, so it runs where passwordless sudo exists, prompts on a CLI, and degrades to Guide otherwise. Reboot-tail runs the applicable part, then instructs the reboot. Guide is physical, BIOS, or wait-for-upstream. Passwordless sudo is not consequence-free, so every Privileged and Reboot-tail remedy defaults to Confirm or Arm, never silent Auto.
This was Craig's call, and he wants it as a cross-panel standard. I filed a task to factor the privilege resolution into a shared helper the net, bluetooth, maint, and audio doctors all use.
|
| |
|
|
|
|
| |
This catalogues real, user-reported ways the microphone and speakers fail on Linux, to feed the audio doctor's triage. It holds 58 input and 59 output distinct root causes, across eight layers each: kernel/driver/firmware, ALSA, PipeWire, Bluetooth, HDMI, USB, app/portal, hardware. Every entry carries its symptom, cause, concrete fix, a sudo/reboot tag, and a source.
The sudo/reboot tag is the triage lever. A no-sudo, no-reboot fix is a candidate for a doctor remedy. A firmware, BIOS, or physical fix can only ever be a printed instruction. Triage into build, guide, or out is the next pass.
|
| |
|
|
|
|
|
|
| |
I ran a second pass across four critical lenses: buildability, technical correctness, adversarial failure-modes, and internal consistency. The technical foundations held. I verified every load-bearing code and /proc/asound claim against the real tree.
I recorded eight findings, two of them blocking. The mic-unmute remedy fails open on an unreadable graph, and a privacy event must fail closed. A Bluetooth or USB-non-ALSA mic classifies as no-mic-hardware because it never appears under /proc/asound. I also fixed three mechanical inconsistencies in place: a remedy miscount, and two stray OUTPUT/INPUT doctor-key labels the SPEAKERS/MICROPHONE rename missed.
The spec stays DRAFT. The blocking findings gate it from READY.
|
| |
|
|
|
|
|
|
|
|
|
|
| |
Craig left four notes on the draft. This closes all of them.
He ratified two open decisions: don't rebuild push-to-talk, since the source-mute is the safety property, and read /proc/asound directly for the kernel tier. Both close DONE.
He flagged a naming collision. The doctor keys can't be OUTPUT/INPUT, because the CONTROLS section already carries INPUT/OUTPUT mute toggles. They become SPEAKERS and MICROPHONE, with a distinct diagnostic style held consistent across every panel. I recorded it as a new decision and left the visual treatment open for his eye.
He asked for a failure-modes map, so the spec gains a table of every fault by probe tier with its verdict and remedy, output and input together.
A spec-review had also left two blocking findings. The kernel-to-graph one was real: ALSA card ids and PipeWire node names are different namespaces, so "compare the sets" was undefined. I took the reviewer's coarse rule as the v1 definition. mic-unrecognized fires when the kernel capture set is non-empty and the graph has zero non-monitor hardware sources. Per-device correlation is logged as vNext. That finding closes. The open-decisions one stays until the last three land.
|
| |
|
|
| |
audio doctor takes only --fix and --force today, so a lone --input would read as a special case on a bare command. Craig's call: add both --output and --input as explicit flags and alias bare audio doctor to --output. The directions are named symmetrically, --input has a sibling, and nothing that scripts the bare command breaks.
|
| |
|
|
|
|
|
|
|
|
|
|
| |
The doctor never examines the microphone. diag collects default_source and default_source_present, the classifier reads neither, so a muted mic, a stale default source, and a mic the sound server can't see all classify as healthy. Chrome losing the mic this morning surfaced it: the stack was genuinely fine and the doctor had nothing useful to say.
The design grew past the gap in one conversation. An empty source list is normal on a mic-less desktop and a failure on a machine that should have one, and no probe can tell those apart. The missing fact comes from the user's finger: a doctor key on each of the OUTPUTS and INPUTS section headers, where pressing the input one asserts a mic should exist. That retires the DOCTOR header key I shipped hours earlier, and it dissolves the precedence question a single classifier would have faced.
A new probe tier sits below PipeWire. /proc/asound lists capture-capable cards, needs no package, spawns no process, and can't hang, so it separates "the software lost a microphone the kernel sees" from "nothing is plugged in".
Push-to-talk stays as it is. It mutes the source, the one state where the server guarantees nothing is captured. A link-based push-to-talk fails open, and a crash mid-hold is a hot mic reading as muted. The doctor reads ptt.read_state() instead of guessing.
Four decisions are open. Three are closed.
|
| |
|
|
|
|
|
|
| |
The doctor shipped end to end, so the spec goes to IMPLEMENTED and the task closes with a dated record of what landed.
Three things the Decisions did not anticipate are written into the history rather than left for a reader to infer. A tenth verdict for missing tooling, because an absent pactl is an unobserved stack and not a broken one. A re-probed marker between a fix run's two row blocks. And DIAGNOSE as the read-only key's name, which Craig settled after asking why this panel carries two keys where the net panel carries one.
I filed the wall-controls convergence as its own task. Craig wants the net panel's copy and close pair on every output wall, and today no two of the four agree.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
| |
The draft said build_status had no pactl timeout and froze the panel. Driving
it disproved that: pactl.run defaults to timeout=8 and raises PactlTimeout, so
the panel degrades.
The real defect was narrower and is now fixed. Two of build_status's four reads
sat outside its degrade guard, so a server that answered the device lists and
then stopped answering raised out of a function contracted to return ok:False,
and waybar's audio module died rather than dimming.
Corrected in place with the reasoning, rather than dropped, since a spec that
quietly loses a wrong claim teaches nothing about why it was wrong.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Answers the four questions the request asked, from a live survey rather than
from memory. There is no PulseAudio: the stack is pipewire, wireplumber, and
pipewire-pulse, all user-scope, so no remedy in this feature needs sudo — which
is why it mirrors the net panel's doctor rather than the maintenance console's
privileged verb table.
Two findings shape the design. pactl hangs against a server that accepts and
never answers, which is exactly the fault a doctor exists to diagnose, so every
probe is bounded. And the panel cannot diagnose itself, because pactl is the
layer most likely to be down — the probes read systemctl and pw-dump before
they touch it.
Filed the panel's own missing timeout as a separate bug. It freezes the audio
panel today, independently of any doctor.
Seven decisions left open; the spec is DRAFT and nothing gets built until they
close.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
The repo carries an open task to publish it, and docs/ leaked things a clone
could neither use nor should see.
Absolute paths under one user's home become the repo root, a home-relative
path, or a named variable, so the snippets stay runnable for anyone. The
testinfra example takes its user from an env var instead of hardcoding one.
References into a private sibling project and into the gitignored tooling
directory are replaced by what they mean; as written they were dead links in
any clone but the author's.
Five documents claimed a co-author who is not a person. An #+AUTHOR line
survives conversion into docx, a wiki page, or a PDF, so it is worth being
exact about: these documents have one author.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
The four host capability inventories, the TrueNAS hardware specs, and the
ratio USB/xHCI record now live as roam nodes under ~/org/roam/hardware/,
linked from the Homelab Hardware Inventory index. The copies here are gone.
Carried rather than pointed at. A pointer keeps one canonical copy, but a
third project that discovers a durable hardware fact would then have to write
into this repo to record it, which the cross-project rules forbid — so the
fact would land in an inbox instead of on the device's page. Moving keeps one
canonical copy without closing the write path.
system-health-check.org resolves a host's inventory by its #+HOSTNAME: keyword
under ${ROAM_DIR:-$HOME/org/roam}/hardware/, never by filename: a node's
timestamp prefix does not survive a rename. A host with no roam clone takes the
same NO INVENTORY FILE path it always did.
strix-soak-watch.org lands here from home, beside the workflow whose Phase 3
invokes it. It is a workflow, not an inventory page.
|
| | |
|
| | |
|
| |
|
|
|
|
|
|
| |
The workflow and the four host capability inventories move here from the home project. System maintenance is archsetup's domain, and this puts the thresholds TOML and both of its consumers in one repo.
The workflow's prose severity rules now cite the installed TOML keys, and the TOML wins on disagreement. Inventory paths point at docs/homelab-inventory/. A note routes routine ratio/velox checks to the maint CLI, leaving this workflow for the non-Arch hosts and forensic deep dives.
Only the #+HOSTNAME: capability inventories moved (ratio, velox, mybitch, truenas, plus the truenas hardware-specs asset they link). The personal gear records stay in home, and the home-side removal is handed off through its inbox.
|
| | |
|
| |
|
|
|
|
| |
The spec encodes the converged 2026-07-06/07 design as 13 decisions and 13 phases (CLI-first maint package, four-layer test strategy) and carries its full review trail inside, live-verified on ratio. Late calls landed during authoring: the bar glyph replaces custom/sysmon, doubles as the laptop battery display, and keeps the btop scratchpad on right-click.
todo.org now carries the build: 13 phase tasks under a SPEC_ID-stamped parent, the manual-testing collector, the flip-to-IMPLEMENTED closer, and the vNext deferral.
|
| |
|
|
|
|
|
|
| |
The design doc replaces the install-health framing in system-monitor-design-ideas.org with a maintenance console: dense metric subpanels behind a persistent selector, a doctor that streams into a results wall, determinate remedies only (guard-armed updates, curation lifecycles for noise, listeners, containers, and orphans), rotary band selectors on the tall subpanels, and a CLI-first build with a four-layer test strategy. Every decision is dated in the doc.
Prototypes A-E5 keep the exploration path: five divergent layouts converging into E5, a fully interactive simulation whose GOOD/BAD snapshots become the build's test fixtures.
todo.org gains the spec-create task, the panel keybinding-family task, and scope notes on the net/bt doctor retrofit.
|
