docs: refresh maintainer and agent handoff documentation

Document post-M3 state on main, GitHub vs AUR publishing separation,
AUR pkgrel=11 / source tag gap, M1 UI identity status, and CI test
workflow. packaging/aur/README.md clarifies local-only AUR sync.
This commit is contained in:
Sebastian Palencsar
2026-06-27 10:58:59 +02:00
parent e885826005
commit f638ddf281
6 changed files with 93 additions and 36 deletions

View File

@@ -13,6 +13,8 @@ This roadmap defines how Bearhub becomes an independent, Arch-first project whil
### M1: Identity Completion (2 weeks)
Status (2026-06-27): **not started** — UI/themes still look ~99 % like upstream bauh; README screenshots and runtime data URLs still reference `bauh-files` in places. Namespace (M3) ≠ visual rebrand.
Scope:
- Remove remaining `bauh` naming from UI text, notifications, tray labels, and docs.
- Ensure links (issues, docs, release checks) point to Bearhub endpoints.
@@ -37,7 +39,7 @@ Definition of Done:
### M3: Namespace Migration (`bauh` -> `bearhub`) (3-5 weeks)
Status (2026-06-27): **~95 % complete** — runtime code native under `bearhub/`; `bauh/` is shim-only; version flip done; full shim removal pending one stable release. See `NAMESPACE_MIGRATION.md` and `CHANGELOG.md` `[Unreleased]`.
Status (2026-06-27): **~95 % complete** — runtime code native under `bearhub/`; `bauh/` is shim-only; version flip done; **merged on GitHub `main`** (`CHANGELOG.md` `[Unreleased]`); **not yet in a release tag**; AUR stable still builds `0.10.7-bearhub.6`. Full shim removal pending one stable release. See `NAMESPACE_MIGRATION.md`.
Scope:
- Migrate Python package namespace from `bauh` to `bearhub`.
@@ -50,8 +52,9 @@ Definition of Done:
- Packaging and tests run successfully with new namespace.
Remaining for M3 closure:
- Ship `[Unreleased]` migration changes as a tagged release (`0.10.7-bearhub.7` or `0.10.8`)
- Validate AUR `bearhub` / `bearhub-git` on real Arch systems
- Tag `[Unreleased]` on `main` as `0.10.7-bearhub.7` (or `0.10.8`) and update AUR stable PKGBUILD source URL + checksum
- Publish PKGBUILD to AUR via **local maintainer workflow** (not GitHub push alone)
- Validate `bearhub` / `bearhub-git` on real Arch systems (`yay -Sy` after publish)
- Remove `bauh/*` shims after one stable cycle (Phase D completion)
### M4: Backend Governance (2-3 weeks)
@@ -153,8 +156,9 @@ Rollback strategy:
## Immediate Next Actions
1. Tag release with `CHANGELOG.md` `[Unreleased]` namespace migration entries.
2. Close remaining M1 gaps (smoke-test checklist on real Arch desktop).
3. Build M2 issue list from current crash reports and prioritize top 3.
4. Complete M3 Phase D after one stable release (remove `bauh/*` shims, drop `provides=('bauh')` in AUR).
5. Schedule M6 Qt6 PR-6.2 after M3 tag (namespace stable; do not parallelize full Qt6 migration).
1. Tag release: move `CHANGELOG.md` `[Unreleased]` `0.10.7-bearhub.7` (or `0.10.8`); update `packaging/aur/bearhub/PKGBUILD` source tag + `sha256sums`.
2. Publish AUR stable (`pkgrel` bump as needed); users run `yay -Sy` — see `packaging/aur/README.md`.
3. Close M1 gaps (user-facing Bearhub branding; smoke-test on real Arch desktop).
4. Build M2 issue list from crash reports; prioritize uninstall/Qt teardown.
5. Complete M3 Phase D after one stable release (remove `bauh/*` shims, drop `provides=('bauh')` in AUR).
6. Schedule M6 Qt6 PR-6.2 only after M3 tag is validated.