Reconcile canonical roadmap with merged work and retire superseded Android Auto experiment #39

Closed
opened 2026-09-18 08:47:57 +02:00 by alexander · 0 comments
Owner

Migrated from GitHub issue #132. Forgejo issue: #39. GitHub source content synchronized on 2026-09-19. Migrated issue references below use Forgejo numbers where an equivalent issue exists; historical references without a Forgejo counterpart remain explicit GitHub links.

Classification

Documentation-only roadmap reconciliation. This expands the original secondary-slot bookkeeping task because the same audit found the canonical roadmap now carries several factual state mismatches.

Problem

docs/roadmap.md is BookWave's sole sequencing authority, but its current-state preface/committed chain has fallen behind GitHub history:

  • GitHub PR #78 has merged; its Android Auto contract and ADR-0029 are no longer pending branch-only work.
  • GitHub PR #86 has merged.
  • GitHub PR #98 has merged.
  • GitHub PR #93 is still open as of this issue refinement and must not be described as merged until GitHub says so.
  • GitHub PR #113 implemented #14 / BW-DOC-01, and #14 is now closed completed.
  • #10 / BW-AUTO-01 is no longer blocked on GitHub #78.
  • #33's settings-UI prerequisite (GitHub #98) has landed.
  • #42 / BW-DEP-01 now owns execution of the staged latest-stable migration described by docs/latest-stable-upgrade-plan.md.

Separately, BW-AUTO-03 still says to measure Android Auto secondary action slots, even though GitHub #78 already settled that against Media3 1.11.0 and real-device evidence: SLOT_BACK_SECONDARY / SLOT_FORWARD_SECONDARY are discarded by the legacy conversion before the projected host sees them.

Leaving factual prerequisites stale undermines the point of having one canonical roadmap and can send fresh workers toward work that is already complete or no longer blocked.

Scope

Documentation only:

  • refresh the committed/current-state section from actual GitHub merged/open state at implementation time;
  • mark GitHub #78/GitHub #86/GitHub #98 as merged/completed historical prerequisites rather than pending chain items;
  • keep GitHub #93 accurately described from its actual current GitHub state at the time the docs PR starts;
  • reflect that #14 was completed by GitHub PR #113;
  • update dependency/status wording for issues unblocked by those merges, including #10 and #33;
  • add/reference #42 / BW-DEP-01 as the execution owner for docs/latest-stable-upgrade-plan.md at an appropriate maintenance position without letting dependency novelty outrank correctness work automatically;
  • retire the BW-AUTO-03 secondary-slot experiment from future work;
  • keep useful historical evidence in ADR-0029 / docs/android-auto-player-opportunities.md explaining why secondary slots failed;
  • narrow remaining BW-AUTO-03 experiments to questions that are genuinely still open, such as primary-slot rendering, completion metadata, metadata extras/link rendering, richer series/chapter presentation and browse artwork/content-provider value;
  • update links/status wording only where current repository history proves it stale.

Explicitly out of scope

  • No runtime/application code.
  • No dependency changes.
  • No media-button layout redesign.
  • No work on #34/#35/#36/#38.
  • No implementation of #10/#24/#33/#40/#41/#42 or any other backlog issue.
  • No resurrection of the secondary-slot implementation.
  • Do not rewrite accepted ADR reasoning to make history look cleaner.
  • Do not silently reorder the product roadmap beyond factual prerequisite/status reconciliation; any substantive priority change should be explicit and justified in review.

Current-state rule

At implementation time, refresh actual main, open PRs, recently merged PRs and relevant issue states before editing. Do not trust the snapshots above if GitHub has moved meanwhile.

Acceptance

  • The canonical roadmap distinguishes merged work from open work correctly at the moment the documentation PR is opened.
  • No issue remains labelled blocked by a prerequisite that has already merged.
  • GitHub #93 is not prematurely treated as merged.
  • #42 is discoverable as the dependency-migration execution owner while docs/latest-stable-upgrade-plan.md remains the detailed child plan.
  • The canonical roadmap no longer schedules secondary-slot measurement as future work.
  • Historical docs may still describe the failed secondary-slot experiment explicitly as history.
  • Remaining Android Auto experiments are only questions not already settled by GitHub #78.
  • No application behavior changes are included.

Relationships

> Migrated from [GitHub issue #132](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/132). Forgejo issue: #39. GitHub source content synchronized on 2026-09-19. Migrated issue references below use Forgejo numbers where an equivalent issue exists; historical references without a Forgejo counterpart remain explicit GitHub links. ## Classification Documentation-only roadmap reconciliation. This expands the original secondary-slot bookkeeping task because the same audit found the canonical roadmap now carries several factual state mismatches. ## Problem `docs/roadmap.md` is BookWave's sole sequencing authority, but its current-state preface/committed chain has fallen behind GitHub history: - [GitHub PR #78](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/78) has merged; its Android Auto contract and ADR-0029 are no longer pending branch-only work. - [GitHub PR #86](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/86) has merged. - [GitHub PR #98](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/98) has merged. - [GitHub PR #93](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/93) is still open as of this issue refinement and must **not** be described as merged until GitHub says so. - [GitHub PR #113](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/113) implemented #14 / BW-DOC-01, and #14 is now closed completed. - #10 / BW-AUTO-01 is no longer blocked on [GitHub #78](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/78). - #33's settings-UI prerequisite ([GitHub #98](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/98)) has landed. - #42 / BW-DEP-01 now owns execution of the staged latest-stable migration described by `docs/latest-stable-upgrade-plan.md`. Separately, BW-AUTO-03 still says to measure Android Auto **secondary action slots**, even though [GitHub #78](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/78) already settled that against Media3 1.11.0 and real-device evidence: `SLOT_BACK_SECONDARY` / `SLOT_FORWARD_SECONDARY` are discarded by the legacy conversion before the projected host sees them. Leaving factual prerequisites stale undermines the point of having one canonical roadmap and can send fresh workers toward work that is already complete or no longer blocked. ## Scope Documentation only: - refresh the committed/current-state section from actual GitHub merged/open state at implementation time; - mark [GitHub #78](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/78)/[GitHub #86](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/86)/[GitHub #98](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/98) as merged/completed historical prerequisites rather than pending chain items; - keep [GitHub #93](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/93) accurately described from its actual current GitHub state at the time the docs PR starts; - reflect that #14 was completed by [GitHub PR #113](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/113); - update dependency/status wording for issues unblocked by those merges, including #10 and #33; - add/reference #42 / BW-DEP-01 as the execution owner for `docs/latest-stable-upgrade-plan.md` at an appropriate maintenance position without letting dependency novelty outrank correctness work automatically; - retire the BW-AUTO-03 secondary-slot experiment from future work; - keep useful historical evidence in ADR-0029 / `docs/android-auto-player-opportunities.md` explaining why secondary slots failed; - narrow remaining BW-AUTO-03 experiments to questions that are genuinely still open, such as primary-slot rendering, completion metadata, metadata extras/link rendering, richer series/chapter presentation and browse artwork/content-provider value; - update links/status wording only where current repository history proves it stale. ## Explicitly out of scope - No runtime/application code. - No dependency changes. - No media-button layout redesign. - No work on #34/#35/#36/#38. - No implementation of #10/#24/#33/#40/#41/#42 or any other backlog issue. - No resurrection of the secondary-slot implementation. - Do not rewrite accepted ADR reasoning to make history look cleaner. - Do not silently reorder the product roadmap beyond factual prerequisite/status reconciliation; any substantive priority change should be explicit and justified in review. ## Current-state rule At implementation time, refresh actual `main`, open PRs, recently merged PRs and relevant issue states before editing. Do not trust the snapshots above if GitHub has moved meanwhile. ## Acceptance - The canonical roadmap distinguishes merged work from open work correctly at the moment the documentation PR is opened. - No issue remains labelled blocked by a prerequisite that has already merged. - [GitHub #93](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/93) is not prematurely treated as merged. - #42 is discoverable as the dependency-migration execution owner while `docs/latest-stable-upgrade-plan.md` remains the detailed child plan. - The canonical roadmap no longer schedules secondary-slot measurement as future work. - Historical docs may still describe the failed secondary-slot experiment explicitly as history. - Remaining Android Auto experiments are only questions not already settled by [GitHub #78](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/issues/78). - No application behavior changes are included. ## Relationships - [GitHub PR #78](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/78) / ADR-0029 - [GitHub PR #86](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/86) - [GitHub PR #98](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/98) - [GitHub PR #113](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/113) / #14 - [GitHub PR #93](https://github.com/AlexanderWilhelmsenBerg/Audiobookshelf-Manager-Claude/pull/93) - #10 - #33 - #42 - `docs/latest-stable-upgrade-plan.md` - `docs/android-auto-player-opportunities.md`
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
alexander/Audiobookshelf-Manager-Claude#39
No description provided.