nevaforget/moonarch
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add moonarch-doctor and shorthand aliases to README and CLAUDE.md
Some checks failed
Update PKGBUILD version / update-pkgver (push) Failing after 3s
Details

Browse Source
This commit is contained in:
nevaforget 2026-04-10 08:21:38 +02:00
parent b8753bf84f
commit 97e4b81930
2 changed files with 24 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
CLAUDE.md
View File

@ -38,6 +38,17 @@ Waybar wird über `moonarch-waybar` gestartet (nicht direkt). Der Wrapper merged
- Benötigt `jq` (in PKGBUILD als Dependency) - Benötigt `jq` (in PKGBUILD als Dependency)
- System-Config muss valides JSON sein (kein JSONC) - 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 ## Konventionen
- Paketlisten sind einfache Textdateien, ein Paket pro Zeile, Kommentare mit `#` - Paketlisten sind einfache Textdateien, ein Paket pro Zeile, Kommentare mit `#`

15
README.md
View File

@ -86,13 +86,23 @@ The script will:
### Update ### Update
```bash ```bash
moonarch-update moonup # or: moonarch-update
``` ```
Interactive updater that upgrades system and AUR packages, reconciles package lists Interactive updater that upgrades system and AUR packages, reconciles package lists
against what's installed, and cleans orphaned packages. Config deployment happens against what's installed, and cleans orphaned packages. Config deployment happens
automatically via the moonarch-git package on `paru -Syu`. 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 ## Project Structure
``` ```
@ -107,7 +117,8 @@ scripts/
lib.sh Shared helpers sourced by all scripts lib.sh Shared helpers sourced by all scripts
post-install.sh Main automation (packages, configs, themes, services) post-install.sh Main automation (packages, configs, themes, services)
transform.sh Convert existing Arch+Wayland system to Moonarch 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/ defaults/
xdg/ System-wide XDG configs (deployed to /etc/xdg/) xdg/ System-wide XDG configs (deployed to /etc/xdg/)