From 97e4b81930f4678fe55aa392a5f8794802f1851e Mon Sep 17 00:00:00 2001 From: nevaforget Date: Fri, 10 Apr 2026 08:21:38 +0200 Subject: [PATCH] docs: add moonarch-doctor and shorthand aliases to README and CLAUDE.md --- CLAUDE.md | 11 +++++++++++ README.md | 15 +++++++++++++-- 2 files changed, 24 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 3779d32..9f18c55 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -38,6 +38,17 @@ Waybar wird über `moonarch-waybar` gestartet (nicht direkt). Der Wrapper merged - Benötigt `jq` (in PKGBUILD als Dependency) - System-Config muss valides JSON sein (kein JSONC) +## System Health Check (moonarch-doctor / moondoc) + +Diagnose-Script das den Systemzustand gegen moonarch-Defaults prüft: +- Pakete (official.txt + aur.txt installiert? Orphans?) +- System-Services (NetworkManager, bluetooth, greetd, ufw, auto-cpufreq, etc.) +- User-Services (kanshi, stasis, cliphist-text, cliphist-image) +- Config-Dateien (SHA256-Vergleich deployed vs. moonarch-Default) +- Helper-Scripts + Symlinks (moonup, moondoc) +- System-Config (UFW, Pacman/Paru Repos, Default Shell) +- Verzeichnisse + Permissions + ## Konventionen - Paketlisten sind einfache Textdateien, ein Paket pro Zeile, Kommentare mit `#` diff --git a/README.md b/README.md index e43a2ac..37369e8 100644 --- a/README.md +++ b/README.md @@ -86,13 +86,23 @@ The script will: ### Update ```bash -moonarch-update +moonup # or: moonarch-update ``` Interactive updater that upgrades system and AUR packages, reconciles package lists against what's installed, and cleans orphaned packages. Config deployment happens automatically via the moonarch-git package on `paru -Syu`. +### Health Check + +```bash +moondoc # or: moonarch-doctor +``` + +Diagnostic tool that verifies the system state against moonarch defaults: services, +configs, packages, helper scripts, firewall, shell and directory permissions. Reports +pass/fail/warn per check with a summary at the end. + ## Project Structure ``` @@ -107,7 +117,8 @@ scripts/ lib.sh Shared helpers sourced by all scripts post-install.sh Main automation (packages, configs, themes, services) transform.sh Convert existing Arch+Wayland system to Moonarch - moonarch-update Interactive updater (deployed to /usr/bin/ by package) + moonarch-update Interactive updater (deployed to /usr/bin/ as moonup) + moonarch-doctor System health checker (deployed to /usr/bin/ as moondoc) defaults/ xdg/ System-wide XDG configs (deployed to /etc/xdg/)