Browse Source

docs(readme): Expand v2.5.1 Recent Updates with design-system milestone

The previous v2.5.1 entry only covered the initial windows-ops
skill commit. The skill has since gone through three refinement
rounds (added drive-dependencies/recover-clone/disk-health/boot-perf,
plus the visual refactor onto TERMINAL-DESIGN.md). Recent Updates
now reflects the full scope:

- windows-ops skill entry rewritten with the stethoscope brand
  emoji 🩺 and acknowledging all 7 scripts + 5 reference catalogs;
  notes the storahci-attribution bug exposed and fixed during the
  visual refactor; quotes the actual disk numbers from the
  dogfood workstation.
- New bullet for _lib/term.ps1 — the PowerShell port of the design
  system. Notes the three-implementation discipline (term.sh +
  term.ps1 + summon.py Term class) and the brand registry entry.
- New bullet for the DESIGN.md → TERMINAL-DESIGN.md rename.

Also cleaned up a content collision created during the earlier
edit (some original v2.5.1 text fused with the new rename bullet).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
0xDarkMatter 4 weeks ago
parent
commit
e09e01c6fa
1 changed files with 3 additions and 1 deletions
  1. 3 1
      README.md

+ 3 - 1
README.md

@@ -23,7 +23,9 @@ From Python async patterns to Rust ownership models, from AWS Fargate deployment
 ## Recent Updates
 
 **v2.5.1** (May 2026)
-- 🪟 **`windows-ops` skill** - Comprehensive Windows workstation operations. Diagnoses slow boot, identifies failing drives, decodes BSOD crashes, manages startup apps across all five mechanisms (registry Run keys, services, scheduled tasks, startup folders, group policy), and audits event logs. The killer feature is `scripts/health-audit.ps1` — a one-shot diagnostic ladder that walks WHEA → storage → crashes → startup → resources and emits a verdict block (specific failing drive identified by `\Device\HarddiskN` → drive letter mapping; storahci Event 129 reset counts; Event 41 BugCheck decoding with Properties[0] not Properties[1]; pre-crash timeline correlation). `scripts/safe-disable-startup.ps1` implements the StartupApproved registry mechanism — what Task Manager's "Disable" button actually does — so non-admin users can disable HKLM startup entries for themselves. `scripts/crash-triage.ps1` walks the N minutes before a crash, flagging smoking guns (storahci resets → storage failure cascade; WHEA before crash → hardware fault; GPU driver warnings → driver hang). Three reference files codify the deep content: full storage event ID catalog with severity thresholds (per-month counts that indicate failure for HDD vs SSD), Windows BugCheck code catalog mapping symptom → likely codes, and the all-five-mechanisms startup catalog with vendor-pattern checklists. Dogfooded on a real workstation with a dying 8TB HGST HDD: correctly identified failing drive (1943 + 1646 + 20 storahci resets) and decoded two recent crashes with discriminator (power-button-held = hang vs no-button = power-loss).
+- 🩺 **`windows-ops` skill** - Comprehensive Windows workstation operations rendered as a proper claude-mods instrument. Brand `🩺` (stethoscope) — diagnostics is the verb. Seven scripts (`health-audit`, `disk-health`, `crash-triage`, `drive-dependencies`, `recover-clone`, `safe-disable-startup`, `boot-perf`) plus five reference catalogs (storage events, BugCheck codes, startup mechanisms, recovery patterns, remote diagnostics). The killer feature is `health-audit.ps1` which renders a state-grouped panel: failing/warn/pass/info sections, critical alert with cross-script wayfinding when a failing drive is detected, footer indicators showing high-action signals (`⬤ storage` busted + `• N crashes`). Maps `\Device\HarddiskN` → drive letter so the verdict identifies a specific drive, not a Disk number. `crash-triage.ps1` decodes Event 41 with `Properties[0]` (the actual BugCheck code, not `Properties[1]` like most Stack Overflow answers) and walks the N minutes before crash flagging smoking guns. `safe-disable-startup.ps1` implements the StartupApproved registry mechanism so non-admin users can disable HKLM startup entries. `drive-dependencies.ps1` is the "safe to disconnect?" check before pulling a drive. `recover-clone.ps1` uses `robocopy /R:0` so retries don't accelerate a failing drive's death. Dogfooded on a real workstation with a dying 8TB HGST HDD — correctly identified the drive (1943 Event 7 + 1646 Event 154 + 20 storahci resets), decoded two recent crashes with cause discrimination (PowerButtonTimestamp non-zero = forced shutdown of hung machine; zero = hard power loss). Bug exposed and fixed during the visual refactor: storahci resets had been attributed to every disk's verdict, falsely flagging healthy drives as FAILING.
+- 🎨 **`_lib/term.ps1`** - PowerShell port of the Terminal Panel Design System (`docs/TERMINAL-DESIGN.md`). Mirror of `_lib/term.sh` with PowerShell-native idioms (Verb-Noun cmdlets, `$Script:` scope, `ValidateSet` params, `Get-TermDisplayWidth` for emoji-aware width handling). Gives PowerShell-based skills the same panel chrome, glyph palette, color tokens, and grid as bash siblings. Three implementations of the spec now coexist: `term.sh` (fleet-ops + future bash), `term.ps1` (windows-ops + future PowerShell), and the `Term` class in `summon.py` (summon + future Python). Brand registry gains `windows-ops = 🩺 | [H]`. The design doc's § 9 section renamed from "Implementation — `skills/_lib/term.sh`" to "three siblings of the same spec" acknowledging the multi-language reality. All seven windows-ops scripts source `term.ps1` and render panels; JSON output paths remain pure data with no chrome contamination.
+- 📐 **`docs/DESIGN.md` → `docs/TERMINAL-DESIGN.md`** - Renamed for specificity. The doc was always about terminal panel rendering; the generic name was a collision risk. All 6 cross-references updated (README, rules, term.sh, fleet.sh, summon SKILL.md + summon.py).
 
 **v2.5.0** (May 2026)
 - 🌐 **`net-ops` skill** - Cross-platform network troubleshooting (Windows / macOS / Linux) via local or remote SSH with a layered diagnostic ladder: link → ICMP → socket → DNS infrastructure → OS resolver → app. NDP-aware IPv6 classifier (disabled / ULA-only / no-route / path-broken / healthy), MTU/PMTU test, time-skew check, browser DoH detection (Chrome / Brave / Firefox), WSL2/container awareness. Modes: `--watch`, `--json` (NDJSON), `--redact` for opsec-clean dumps, `--quick` for skip-if-healthy. Per-OS probe + dns-audit + repair scripts, reverse-mode probe, 24-test self-suite.