Reconcile roadmap and migration documentation with current Forgejo state #62

Merged
alexander merged 10 commits from mcp/docs-forgejo-reconciliation into main 2026-09-19 19:50:36 +02:00
Owner

Baseline

  • current main: 62ec15362ca613854c111bd660727675af3081cb
  • documentation-only reconciliation after the Forgejo migration and the 2026-09-19 correctness merges

Documents changed

  • docs/roadmap.md
  • docs/latest-stable-upgrade-plan.md
  • version-control.md
  • docs/dependency-compatibility-inventory.md
  • docs/README.md
  • README.md
  • AGENTS.md

No application source, tests, Gradle/dependency pins, workflows, or runtime behavior are changed.

Reconciled state

  • removes completed foreground realtime (#40 implementation / PR #5) and recent-book hydration (#41 / PR #57) from active roadmap sequencing;
  • records #11 / PR #59 and #36 / PR #60 as merged routing ownership/continuity boundaries instead of future stages;
  • records #38 / PR #56, #18 / PR #55, and #7 / PR #58 as merged rather than active implementation;
  • keeps #34 and #35 active because their implementation PR is still under separate review and has not merged;
  • moves active planning references to current Forgejo issue numbers and labels pre-migration GitHub PR numbers only as historical provenance;
  • updates the download/system/iOS roadmap lanes to current Forgejo issue numbers;
  • separates merged implementation from physical-device/host acceptance so automated tests are not presented as car/headset/sensor evidence.

Dependency migration

  • Phase 0: complete, maintained through the live ledger;
  • Phases 1–3: partially advanced where compatible; Gradle 9 / AGP 9 / API 37 remain ADR-0011-gated;
  • Phase 4: complete at the current compatible frontier;
  • Phase 5: complete at the current mutually compatible frontier;
  • Phase 6: next executable dependency lane;
  • Phases 7–9: remain staged; Phase 8 is partially advanced by the Forgejo CI migration.

version-control.md now describes the live Forgejo CI surface: self-hosted linux-amd64, the digest-pinned BookWave CI image, exact checkout/cache/upload action refs, Gitleaks 8.30.1, and the remaining actions/download-artifact@v3 compatibility tag.

Tracker inconsistencies intentionally not changed

  • Forgejo #40 is still open although PR #5 merged its implementation.
  • Forgejo #42 is closed although BW-DEP-01 still has executable and gated phases remaining.

Those tracker states are documented here but were not edited by this documentation-only PR.

Concurrent work kept separate

PR #61 owns the current #34/#35 implementation and edits ADR-0029 / docs/risks.md. This PR intentionally does not pre-accept that work or modify those files.

## Baseline - current `main`: `62ec15362ca613854c111bd660727675af3081cb` - documentation-only reconciliation after the Forgejo migration and the 2026-09-19 correctness merges ## Documents changed - `docs/roadmap.md` - `docs/latest-stable-upgrade-plan.md` - `version-control.md` - `docs/dependency-compatibility-inventory.md` - `docs/README.md` - `README.md` - `AGENTS.md` No application source, tests, Gradle/dependency pins, workflows, or runtime behavior are changed. ## Reconciled state - removes completed foreground realtime (#40 implementation / PR #5) and recent-book hydration (#41 / PR #57) from active roadmap sequencing; - records #11 / PR #59 and #36 / PR #60 as merged routing ownership/continuity boundaries instead of future stages; - records #38 / PR #56, #18 / PR #55, and #7 / PR #58 as merged rather than active implementation; - keeps #34 and #35 active because their implementation PR is still under separate review and has not merged; - moves active planning references to current Forgejo issue numbers and labels pre-migration GitHub PR numbers only as historical provenance; - updates the download/system/iOS roadmap lanes to current Forgejo issue numbers; - separates merged implementation from physical-device/host acceptance so automated tests are not presented as car/headset/sensor evidence. ## Dependency migration - Phase 0: complete, maintained through the live ledger; - Phases 1–3: partially advanced where compatible; Gradle 9 / AGP 9 / API 37 remain ADR-0011-gated; - Phase 4: complete at the current compatible frontier; - Phase 5: complete at the current mutually compatible frontier; - Phase 6: next executable dependency lane; - Phases 7–9: remain staged; Phase 8 is partially advanced by the Forgejo CI migration. `version-control.md` now describes the live Forgejo CI surface: self-hosted `linux-amd64`, the digest-pinned BookWave CI image, exact checkout/cache/upload action refs, Gitleaks 8.30.1, and the remaining `actions/download-artifact@v3` compatibility tag. ## Tracker inconsistencies intentionally not changed - Forgejo #40 is still open although PR #5 merged its implementation. - Forgejo #42 is closed although BW-DEP-01 still has executable and gated phases remaining. Those tracker states are documented here but were not edited by this documentation-only PR. ## Concurrent work kept separate PR #61 owns the current #34/#35 implementation and edits ADR-0029 / `docs/risks.md`. This PR intentionally does not pre-accept that work or modify those files.
alexander deleted branch mcp/docs-forgejo-reconciliation 2026-09-19 19:50:36 +02:00
Sign in to join this conversation.
No reviewers
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!62
No description provided.