mirror of
https://github.com/spalencsar/bearhub.git
synced 2026-07-07 19:44:15 +02:00
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:
20
ROADMAP.md
20
ROADMAP.md
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user