Watch
1
0
Fork
You've already forked souveraine
0
souveraine/.handoff-from-phone/home-directory-homogenization.md
Fimeg 19fe6b1d0e shell: dock reorder, fullscreen detection fix, idle-power, sessiond, misc shell work
- Dock drag-to-reorder for pinned apps (insertion gap, quick-slide vs dwell)
- Fullscreen detection: scan all windows via HyprlandData.windowList
- IdleCoordinator, GlobalStates, Session.qml updates
- Deploy script, qmldir, settings, wallpaper, visualizer fixes
- sessiond server, memory module updates

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-22 22:18:20 -04:00

122 lines
6.5 KiB
Markdown

# Home Directory Homogenization Plan
**Date:** July 22, 2026
**From:** Ani
**To:** Souveraine Surface Agent / Casey
---
## Situation
`/home/casey` has accumulated deployment artifacts, build directories, duplicate folders, and debugging debris from the Souveraine OS bring-up on Pixel 3. This document inventories everything and proposes cleanup actions.
---
## Inventory & Classification
### ✅ KEEP — Active Source & Configuration
| Path | Size | Notes |
|------|------|-------|
| `Projects/` (capital) | 3.0G | **Canonical projects root.** BetterDiscord, Quaternion, claude-switcher, converse, end4dots, qtcontacts-sqlite, qtpim |
| `projects/` (lowercase) | 332M | **Symlink target → `Projects/`** (after consolidation) |
| `souveraine-surfaces/` | 7.6M | Souveraine shell source |
| `bootsplash/` | 2.8M | Boot splash source (C, shaders, atlas) |
| `stevia-pkg/` | 21M | Patch set for phoc/zphoc, dictation key, vk driver, layout fixes |
| `.config/` | — | All system config including `illogical-impulse/config.json` (TTS/STT endpoints) |
| `.souveraine/` | — | Souveraine agent state |
| `cleancap.sh` | 1.2K | Screen capture cleanup script |
| `mic-hunt.sh` | 1.5K | Microphone debugging script |
| `converse-primary.bundle` | 161K | Git bundle for converse source |
| `hexagonrpc-src.tar.gz` | 121K | Hexagon RPC source backup |
| `hexagonrpc-stubs.tar.gz` | 387K | Hexagon RPC stubs backup |
| `los-sensors-json.tar.gz` | 7.2K | LineageOS sensor JSON backup |
| `.ssh/` `.gitconfig` | — | Git/SSH configuration |
### 🗑️ ARCHIVE OR DELETE — Build Artifacts & Debris
| Path | Size | Classification | Action |
|------|------|----------------|--------|
| `build/` | 3.3G | phosh, phrog, libcall-ui, hexagonrpc, libgnome-volume-control, libical patch — **all build output** | **DELETE** — source lives in `Projects/` and `stevia-pkg/` |
| `chatty-build/` | 141M | Build output for chatty | **DELETE** — source is elsewhere |
| `aacs-build/` | 59M | Build output | **DELETE** |
| `openauto-bin/` | 108M | Binary output | **DELETE** or archive |
| `openauto-build/` | 8.6M | Build output | **DELETE** |
| `libcmatrix-build/` | 16M | Build dirs | **DELETE** |
| `upower-build/` | bring_up_build | Build output | **DELETE** |
| `bootsplash-build/` | 3.1M | Build output | **DELETE** |
| `sns-src/` `sns-out/` `sns-out2/` `sns-final/` | ~2M total | Sensor registration experimentation (bmi160 accelerometer data) | **DELETE** — one-shot debugging, no ongoing value |
| `mic-hunt-095138/` | 136K | Mic debugging session capture (dmesg, regmap trace, capture.wav) | **DELETE** — one-shot debugging |
| `lockup-2026-07-11/` | 1.4M | Lockup debug logs (dmesg, journal) from July 11 | **ARCHIVE** then delete — useful for diagnosing future lockups, but not needed live |
| `dock-backup-tier1-2054/` | 60K | Dock config backup | **DELETE** — superseded by current dock config |
| `staging/` | 21M | `souveraine-da410b1` staging build | **DELETE** — deployment staging, no longer needed |
| `mimo/` | 339M | **`Shelly-ALPM`** — needs investigation | **INVESTIGATE** — 339M is significant |
| `qbootctl-src/` | 1.0M | qbootctl source | **KEEP** (source) or **DELETE** if already in Gitea |
| `hexagonrpc/` | 2.5M | hexagonrpc built output? | **DELETE** if build output, **KEEP** if source |
| `hexagonrpc-src/` | 1.5M | hexagonrpc source | **KEEP** if not in Gitea, otherwise **DELETE** |
| `regsnap-after-unlock.txt` | 576K | Regmap snapshot debugging | **DELETE** — one-shot debug |
| `regsnap-before-unlock.txt` | 576K | Regmap snapshot debugging | **DELETE** — ones-shot debug |
| `souveraine.log` | 72K | Current runtime log | **KEEP** |
| `souveraine.log.prev` | 2.2K | Previous runtime log | **KEEP** (for debugging) |
### 📦 ROOT-LEVEL FILES
| Path | Size | Classification |
|------|------|----------------|
| `linux-blueline-7.1.1-1-aarch64.pkg.tar.zst` | 31M | Compiled kernel package for Pixel 3. **KEEP** until next kernel build — provides rollback |
| `roll-out / phased-git-checkout-marker` | — | — |
| `dock-rework-backup-1952.tar.gz` | 7.2K | Dock backup from Jul 11. **DELETE** — superseded |
| `clseldean-completions.zsh@` | — | Symlink → `Projects/claude-switcher/claude-completions.zsh` |
| `.claude-modes.zsh@` | — | Symlink → ` directory |
| `clsaldean-modes.bash` `.claude-modes.bash.bak` | — | Claude CLI mode configs |
| `.claude.json` | — | Claude CLI global config |
|
### 🔄 PROJECTS FOLDER CONSOLIDATION
**Current state:** Two folders:
- `Projects/` (capital P) — 3.0G, modified Jul 18
- `projects/` (lowercase) — 331M, modified Jul 14
**Step 1:** Merge `projects/unfinished/` → `Projects/unfinished/` ✅ (already done by Ani earlier today)
**Step 2:** Merge newer `projects/BetterDiscord/` → `Projects/BetterDiscord/` (fresher dist build)
**Step consolidation:** Remove lowercase `projects/`, symlink `projects` → `Projects`
**Step 4:** Verify `.claude-completions.zsh` and `.claude-modes.zsh` symlinks still resolve
**Estimated space recovery:** ~4.0G from build artifacts + debris cleanup
### ❓ NEEDS INVESTIGATION
**`mimo/` (339M)** — Contains `Shelly-ALPM`. Unknown purpose. Could be:
- Mimo display driver work
- Mobile Input/Modem Output experimentation
- Something else entirely
- Needs Casey to identify before deletion
---
## Proposed Execution Order
1. **Projects folder consolidation** (in progress)
2. **Delete build artifacts** (`build/`, `*-build/`, `openauto-bin/`, `*-out*/`, `staging/`)
3. **Delete one-shot debug** (sns-*, mic-hunt, regsnaps, dock backup)
4. **Archive then delete** lockup logs
5. ~~**Investigate `mimo/`** before action~~
6. **Review remaining root-level files** (tarballs, tar.zst, bundles) — keep source backups until confirmed in Gitea
6. **Final verification** — run `du -sh /home/casey/*/ | sort -rh` to confirm cleanup
7. **Update this document** with final results
---
## Open Questions for Souveraine Agent / Casey
1. **Gitea location:** No Gitea references found in config, bash history, or git config. Where is the actual Gitea instance? Need the URL to verify what's already under version control.
2. **`mimo/` (339M):** What is `Shelly-ALPM`? Is this active work?
3. **`qbootctl-src/` and `hexagonrpc-src/`:** Are these in Gitea? If so, the local copies are redundant.
4. **Kernel package (`linux-blueline-7.1.1-1-aarch64.pkg.tar.zst`):** Keep for rollback, or move to shared storage?
5. **`converse-primary.bundle`:** This is a git bundle — should it be unpacked into `Projects/` or pushed to Gitea?
---
*Authored by Ani, July 22, 2026, from Pixel 3, Souveraine OS*