Skip to content

feat: add native Dock Doctor USB diagnostics - #1

Merged
Kb2uka merged 3 commits into
mainfrom
feat/dock-doctor
Sep 13, 2026
Merged

Kb2uka merged 3 commits into
mainfrom
feat/dock-doctor

Conversation

@Kb2uka

@Kb2uka Kb2uka commented Sep 13, 2026 •

Copy link
Copy Markdown
Owner

Summary

Adds Dock Doctor, a native Omarchy window for USB topology, observed connection history, and comparisons against a saved working baseline. Device selection, tree/list views, event filters, baseline replacement confirmation, local report export, and isolated illustrative mode are functional. USB discovery never changes hardware.

Proof

Native interface

Narrow window capture

The screenshot is explicitly illustrative. Live startup reads sysfs. A separate remote read-only scan detected three USB nodes (two root controllers and one peripheral).

Fail-first probes reproduced empty retained-state acceptance, transient write failures, growing error text, misleading protocol diagnostics, stale live messages after demo/reconnection, and zero-width popup items. The final regression suite passes.

Gates

  • Exact revision 0c8de024fe0f964ce0e7b78f7269013f3a17a306: all registered gates passed from an isolated OptiPlex worktree.
  • 55 backend tests and 19 Qt results passed; Python compilation and Omarchy manifest validation passed.
  • Native Quickshell window loaded and exercised open/close/reopen under isolated headless Weston; pidfds verify both observer and event monitor exit with the shell.
  • Filesystem regression coverage includes symlinks, special files, ownership, hardlinks, bounded reads, raced parent/destination paths, atomic rollback, and observer locking.
  • Observer EOF/SIGTERM/SIGKILL cleanup and successor startup passed. The native shutdown regression failed before the parent-death binding and passes afterward.
  • Hosted Linux x64/arm64 and Qt checks passed.

Review rounds

Round Seat A Seat B Accepted Rejected Needs a human
1 Missing; substitute 4/5 (1) 4/5 (3) 2 2 0
2 Missing; superseded 4/5 (2) 2 0 0
3 Missing; substitute 5/5 (0) 5/5 (0) 0 0 0

The permitted substitute replaced an original seat that produced no verdict on retry. Round 2 was superseded after a native shutdown regression exposed an event-monitor leak. That leak, both accepted follow-up findings, and the earlier accepted findings are fixed. Both completed final reviewers returned 5/5 with no findings. Missing primary verdicts are explicitly recorded and are not counted as passes. Rejected findings concerned an unsupported Windows runtime and a percent-sign path scenario disproved by a remote Qt probe.

Needs a human

  • Physical arm64 hardware and manual cable/hub hotplug timing remain untested. Short events between scans can be missed.
  • Marketplace maintainers decide listing approval after exact-commit validation. Publication is authorized by the owner.

factory: rounds=3 evidence=A,B,D host=optiplex

@Kb2uka
Kb2uka marked this pull request as ready for review September 13, 2026 15:41
@Kb2uka
Kb2uka merged commit c94ddbb into main Sep 13, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant