jared
/
server-desktop-01
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
server-desktop-01/CLAUDE.md

56 lines
3.3 KiB
Markdown
Raw Permalink Normal View History

docs(wm): Phase 4 progress, Hyprland config reference, and keybindings Add Phase 4 progress entry documenting windowrule syntax fix for Hyprland 0.51 (stripping invalid ^(...)$ wrapping). Include CLAUDE.md project instructions, version-aware Hyprland config reference docs, and keybindings cheatsheet PDF for future reference.
2026-05-07 13:43:43 +00:00
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## What this repo is
Documentation and planning for a GNOME → Hyprland migration on Fedora 43. No build system, no tests, no executables. The actual system configuration lives in `~/.dotfiles/` (separate Forgejo repo), managed with GNU Stow.
## Key locations outside this repo
| What | Where |
|------|-------|
| Hyprland config | `~/.dotfiles/hypr/.config/hypr/hyprland.conf` |
| DMS source configs | `~/.dotfiles/hypr/.config/hypr/dms/` |
| Symlink target | `~/.config/hypr/` → symlinked via `stow hypr` |
| Hyprland log | `~/.cache/hyprland/hyprland.log` |
| Dotfiles remote | `git@forgejo.swansoncloud.com:jared/dotfiles.git` |
docs: add Synology and VPS inventory docs, update CLAUDE.md Added comprehensive operational documentation for Synology DS218plus access, backup paths, and restic commands. Added VPS inventory with notes on Hyperthrive DigitalOcean recovery and OVH migration plan. Updated CLAUDE.md to reference new docs, expand known workarounds with cursor and NVIDIA DRM details, and clarify hardware status.
2026-05-15 14:19:50 +00:00
| Synology DS218plus access + backup paths | `docs/synology.md` |
| VPS inventory + access notes | `docs/vps-inventory.md` |
docs(wm): Phase 4 progress, Hyprland config reference, and keybindings Add Phase 4 progress entry documenting windowrule syntax fix for Hyprland 0.51 (stripping invalid ^(...)$ wrapping). Include CLAUDE.md project instructions, version-aware Hyprland config reference docs, and keybindings cheatsheet PDF for future reference.
2026-05-07 13:43:43 +00:00
## Hyprland configuration
**Installed version:** 0.51.1 (Fedora 43). See `docs/hyprland/version-history.md` before applying patterns from the official wiki — the wiki tracks git HEAD, which is ahead of the installed version.
**Window rule syntax for 0.48–0.51** (not the block syntax shown in current wiki):
```
windowrule = match:class classname, effect
windowrule = match:class classname, match:title titlepattern, effect1, effect2
```
Do NOT use `^(...)$` wrapping — Hyprland 0.51 rejects it as "Invalid rulev2". Use plain names or bare regexes (e.g. `^org\.gnome\.` for a prefix match).
**Block syntax** (`windowrule { }`) is 0.52+ only — do not use until after a Fedora upgrade.
## Docs structure
- `docs/window-manager/` — migration plan, phased progress log, keybindings cheatsheet
- `docs/hyprland/` — version-aware Hyprland config reference; update these when Hyprland is upgraded
Add gitignore, RAM incident diagnosis, and new docs Confirms bad RAM (memtest86+ single-bit flips) as root cause of the 2026-06-24 Btrfs corruption incident, adds fedora-upgrade.md and other pending docs, and gitignores the doc-hygiene state directory. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-02 17:02:40 +00:00
- `docs/fedora-upgrade.md` — distro release-upgrade procedure; F43→44 deferred (solopasha COPR aquamarine not rebuilt vs F44 libdisplay-info)
docs: add Synology and VPS inventory docs, update CLAUDE.md Added comprehensive operational documentation for Synology DS218plus access, backup paths, and restic commands. Added VPS inventory with notes on Hyperthrive DigitalOcean recovery and OVH migration plan. Updated CLAUDE.md to reference new docs, expand known workarounds with cursor and NVIDIA DRM details, and clarify hardware status.
2026-05-15 14:19:50 +00:00
- `docs/synology.md` — DS218plus SSH alias, `/volume1/backup` map, restic repo commands, recovery notes
docs: record DigitalOcean VPS deletion in vps-inventory The old Hyperthrive DigitalOcean VPS (161.35.12.75) was deleted 2026-06-24 after all services migrated to the OVH VPS (verified live, no DNS pointing at the old IP). Mark the section DELETED, retain recovery notes as historical, and update the CLAUDE.md docs pointer. Full migration record lives in ~/projects/server-ovh-prod-01-main/. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-24 15:48:25 +00:00
- `docs/vps-inventory.md` — OVH VPS (`ovh-vps`) access notes; old Hyperthrive DO VPS deleted 2026-06-24 (historical notes retained)
docs: log Chrome SIGBUS incident from Btrfs csum corruption Chrome crashed repeatedly with SIGBUS on launch. Root cause was a corrupt data block in ~/.config/google-chrome/Profile 2/Favicons on a single-copy Btrfs volume (csum failures correlated to the second with each crash). A scrub found two further uncorrectable blocks (a Chrome cache file and a gdm help file); both fixed. SSD SMART is clean and the corruption is static across scrubs, pointing at a past RAM/bus event rather than a failing drive. Adds docs/incidents.md (dated incident log) and a CLAUDE.md pointer. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-24 17:49:13 +00:00
- `docs/incidents.md` — dated incident log (diagnosed-and-fixed issues): symptom, root cause, ruled-out, fix, follow-up
docs(wm): Phase 4 progress, Hyprland config reference, and keybindings Add Phase 4 progress entry documenting windowrule syntax fix for Hyprland 0.51 (stripping invalid ^(...)$ wrapping). Include CLAUDE.md project instructions, version-aware Hyprland config reference docs, and keybindings cheatsheet PDF for future reference.
2026-05-07 13:43:43 +00:00
## Project status
Phases 0–3 complete (install, config, dotfiles integration). Phase 4 (first successful Hyprland login and smoke tests) is in progress. Phase 5 (tuning) is deferred.
docs: add Synology and VPS inventory docs, update CLAUDE.md Added comprehensive operational documentation for Synology DS218plus access, backup paths, and restic commands. Added VPS inventory with notes on Hyperthrive DigitalOcean recovery and OVH migration plan. Updated CLAUDE.md to reference new docs, expand known workarounds with cursor and NVIDIA DRM details, and clarify hardware status.
2026-05-15 14:19:50 +00:00
Known workarounds in place:
- `hyprpolkitagent` replaced with `xfce-polkit` due to Qt 6.9/6.10 private ABI mismatch in solopasha COPR (affects hyprland-qt-support, hyprland-qtutils). Revisit when COPR rebuilds against Qt 6.10.
- GDM Wayland→Hyprland cursor handoff leaves stale cursor ghost at login position. Fixed with `exec-once = sleep 1 && hyprctl dispatch movecursor 0 0` in hyprland.conf. If unreliable, fallback is `WaylandEnable=false` in /etc/gdm/custom.conf (makes GDM use X11 greeter for clean KMS handoff).
- `cursor { no_hardware_cursors = true; use_cpu_buffer = 1 }` set in dms/cursor.conf to prevent NVIDIA DRM (akmod-nvidia loaded for RTX 3060) from interfering with AMD Vega cursor plane rendering.
docs(wm): Phase 4 progress, Hyprland config reference, and keybindings Add Phase 4 progress entry documenting windowrule syntax fix for Hyprland 0.51 (stripping invalid ^(...)$ wrapping). Include CLAUDE.md project instructions, version-aware Hyprland config reference docs, and keybindings cheatsheet PDF for future reference.
2026-05-07 13:43:43 +00:00
## Hardware
- AMD Vega iGPU (primary display, Wayland)
docs: add Synology and VPS inventory docs, update CLAUDE.md Added comprehensive operational documentation for Synology DS218plus access, backup paths, and restic commands. Added VPS inventory with notes on Hyperthrive DigitalOcean recovery and OVH migration plan. Updated CLAUDE.md to reference new docs, expand known workarounds with cursor and NVIDIA DRM details, and clarify hardware status.
2026-05-15 14:19:50 +00:00
- NVIDIA RTX 3060 dGPU (no display connected — `akmod-nvidia` is installed and loads `nvidia_drm` at boot)