Skip to content

docs: refresh roadmap with visual map, open issues, and future work inventory - #1941

Merged
LucasSantana-Dev merged 3 commits into
mainfrom
docs/visual-roadmap-refresh
Aug 3, 2026
Merged

LucasSantana-Dev merged 3 commits into
mainfrom
docs/visual-roadmap-refresh

Conversation

@LucasSantana-Dev

@LucasSantana-Dev LucasSantana-Dev commented Aug 3, 2026 •

Copy link
Copy Markdown
Owner

What

Rewrites docs/roadmap.md (stale since 2026-05-05, v2.9.0) as a visual roadmap:

  • Mermaid mindmap — full inventory at a glance: issues / features / integrations / infrastructure
  • Mermaid timeline — dated decision gates, 4 overdue flagged (CSP enforce, Guild Automation decision, autoplay re-measure, Lavalink re-eval)
  • 25 open issues grouped (Features / CI-Ops / Security / Bot-debt-docs) with links + labels
  • Future features / integrations / infrastructure — every item verified unshipped against the codebase (2026-08-03), each with source citation (decisions/, .claude/plans/, docs/)
  • Non-goals section — recorded do-not-re-propose items (Apple Music, Kafka, bot B/G, moonrepo)

Sources

Full sweep of decisions/ (~130 ADRs), .claude/plans/ (~40 plans), docs/, README, and gh issue list. Spec: .claude/plans/spec-visual-roadmap.md.

Verification

Both Mermaid blocks parse clean (mindmap + timeline, checked with mermaid parser). Docs-only change.


Summary by cubic

Rewrites docs/roadmap.md into a visual roadmap (Mermaid mindmap + timeline), replacing the stale v2.9.0 with a v2.39.x refresh dated 2026-08-03. Marks only past-due gates as overdue (Guild Automation and Lavalink), removes shipped “streamBridge fallback surfacing,” and keeps a clean inventory of 25 open issues and future features/integrations/infrastructure with sources and verified-unshipped checks, plus non-goals and a “Recently shipped” context; Mermaid parses clean and this is docs-only.

Written for commit 3f71412. Summary will update on new commits.

Review in cubic

Summary by CodeRabbit

  • Documentation
    • Replaced the outdated v2.9.0 roadmap with an updated v2.39.x roadmap dated August 3, 2026.
    • Added visual and timeline overviews, decision gates, categorized open issues, planned features and integrations, infrastructure work, and explicit non-goals.
    • Included context on recently shipped v2.38–v2.39 updates.

@github-actions github-actions Bot added the size/l label Aug 3, 2026
@coderabbitai

coderabbitai Bot commented Aug 3, 2026 •

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The roadmap was replaced with a refreshed v2.39.x plan dated 2026-08-03. It now covers decision gates, open issues, future features, infrastructure work, non-goals, and v2.38–v2.39 release context.

Changes

Roadmap documentation refresh

Layer / File(s) Summary
Roadmap structure and decision gates
docs/roadmap.md
Updated roadmap metadata and added visual and timeline Mermaid maps with overdue decision gates.
Open issues and future work
docs/roadmap.md
Added 25 categorized open issues and documented verified future features and integrations.
Infrastructure and release context
docs/roadmap.md
Added future infrastructure plans, explicit non-goals, and recently shipped v2.38–v2.39 work.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the documentation roadmap refresh and its main additions.
✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/visual-roadmap-refresh

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown

Failed to generate code suggestions for PR

@graphify-labs graphify-labs Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks safe to merge — no coupling regressions and no blocking issues, checked against the code graph (not a self-assessment).

Graphify reviewed this change.

Looks safe to merge — no coupling regressions and no blocking issues, checked against the code graph (not a self-assessment).


Graphify review — findings

This pull request replaces the entire docs/roadmap.md file with a substantially rewritten and expanded version, updating the header from version v2.9.0 (dated 2026-05-05) to v2.39.x (dated 2026-08-03). It restructures the roadmap around new sections including Mermaid-based visual maps, overdue time gates, a catalog of 25 open GitHub issues grouped by category, and future features/integrations/infrastructure, replacing the prior Now/Next/Deferred/Recently-shipped format. The change is documentation-only and touches a single Markdown file.

No blocking issues surfaced.

Analysis details — impact, health, verification

Impact & health

Graphify review

Impact — 19 functions depend on the 19 functions this change touches.

Health — grade A; no new coupling hotspots.

Verification — 19 functions in the blast radius were not formally verified this run (proofs are advisory here).

Gate & verification

graphify gate

PASS — objectively clean (no health regressions, tests not run — proofs not run this pass (advisory)). Grounded, not self-assessed.

Advisory (not blocking):

  • verification_scope: 19 function(s) in the blast radius were not formally verified this run

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/roadmap.md`:
- Line 163: Update the Lavalink + youtube-source migration entry in the roadmap
to replace “due now” with “overdue as of 2026-08-03,” preserving the existing
deadline and escalation-gate details.
- Around line 77-88: Update the roadmap section heading around the Mermaid
timeline to avoid labeling future gates as overdue: rename “Overdue time gates”
to “Decision gates by due date” while preserving the existing timeline entries.
- Line 83: Align the Guild Automation gate status between the entry at
2026-07-06 and the decision entry around line 201 so both use the same state;
update whichever status is inaccurate while preserving the existing migration
details.
- Line 149: Update the “Music UX polish” roadmap bullet to remove “streamBridge
fallback surfacing,” since it is already shipped; retain the other
verified-unshipped UX items and their existing references unchanged.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 3733e0d9-9c61-45ff-83ed-c6180ee6de61

📥 Commits

Reviewing files that changed from the base of the PR and between fdca34a and 0e89794.

📒 Files selected for processing (1)
  • docs/roadmap.md

Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 1 file

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
LucasSantana-Dev added a commit that referenced this pull request Aug 3, 2026
)

## Why

Security gate fails on every PR (e.g. #1941): `scripts/audit-gate.mjs`
exits 1 because its own anti-rot check found 4 ACCEPTED entries that are
no longer reported (`@discordjs/node-pre-gyp`, `rimraf`, `glob`,
`minimatch`) — and behind that, `brace-expansion` was blocking on a
re-issued advisory id.

## What

- `npm audit fix` (non-breaking): `brace-expansion` 5.0.7 → 5.0.9
(GHSA-mh99-v99m-4gvg), `valibot` 1.2.0 → 1.4.2 (GHSA-5qjj-4xww-7phc);
nested vulnerable brace-expansion copies deduped.
- Deleted the 5 stale ACCEPTED entries from `scripts/audit-gate.mjs`
(the @discordjs/opus → node-pre-gyp chain is now only reported as
moderate, below the gate's high/critical bar).
- `react-router`/`react-router-dom` stay accepted pending the v8
migration (#1878) — untouched.

## Verification

`node scripts/audit-gate.mjs` → exit 0: "No unaccepted high/critical
findings in production dependencies." Production audit now reports only
the accepted react-router pair as high.

Relates #1879 (dev toolchain advisories — partial; this clears the
production-visible ones).

<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Fixes the CI security audit gate by removing stale ACCEPTED entries and
applying non‑breaking `npm audit fix` updates. The gate now passes; only
the accepted `react-router` pair remains high until the v8 migration.

- **Bug Fixes**
- Removed 5 stale ACCEPTED entries in `scripts/audit-gate.mjs` for the
`@discordjs/node-pre-gyp` → `rimraf` → `glob` → `minimatch` →
`brace-expansion` chain (no longer high/critical in prod).
- Gate exits 0; `react-router`/`react-router-dom` remain accepted
pending v8 migration (#1878).

- **Dependencies**
  - `brace-expansion` 5.0.7 → 5.0.9 (GHSA-mh99-v99m-4gvg).
  - `valibot` 1.2.0 → 1.4.2 (GHSA-5qjj-4xww-7phc).

<sup>Written for commit 169ea64.
Summary will update on new commits.</sup>

<a
href="https://cubic.dev/pr/LucasSantana-Dev/Lucky/pull/1942?utm_source=github"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img
alt="Review in cubic"
src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a>

<!-- End of auto-generated description by cubic. -->



<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Chores**
* Removed several accepted production-audit entries and their associated
advisory rationale and version pinning.


<!-- end of auto-generated comment: release notes by coderabbit.ai -->

@graphify-labs graphify-labs Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks safe to merge — no coupling regressions and no blocking issues, checked against the code graph (not a self-assessment).

Graphify reviewed this change.

Looks safe to merge — no coupling regressions and no blocking issues, checked against the code graph (not a self-assessment).


Graphify review — findings

This pull request substantially rewrites docs/roadmap.md, refreshing it from the 2026-05-05 (v2.9.0) version to a 2026-08-03 (v2.39.x) version. It replaces the previous Now/Next/Deferred/Recently-shipped structure with new sections including Mermaid-based visual maps, overdue time gates, a table of 25 open GitHub issues grouped by category (features, CI/ops, security, bot/tech-debt), and expanded future features/integrations/infrastructure listings. The change is documentation-only and touches roadmap content sourced from open issues, decisions/, and .claude/plans/. Review surface is limited to the accuracy, formatting, and cross-references within this single Markdown file.

No blocking issues surfaced.

Analysis details — impact, health, verification

Impact & health

Graphify review

Impact — 19 functions depend on the 19 functions this change touches.

Health — grade A; no new coupling hotspots.

Verification — 19 functions in the blast radius were not formally verified this run (proofs are advisory here).

Gate & verification

graphify gate

PASS — objectively clean (no health regressions, tests not run — proofs not run this pass (advisory)). Grounded, not self-assessed.

Advisory (not blocking):

  • verification_scope: 19 function(s) in the blast radius were not formally verified this run

- rename overdue-gates section; only past-due entries marked overdue
- align Guild Automation gate status (overdue everywhere)
- drop streamBridge fallback surfacing (shipped in v2.39.0, #1920)
- Lavalink gate: mark overdue as of 2026-08-03

@graphify-labs graphify-labs Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks safe to merge — no coupling regressions and no blocking issues, checked against the code graph (not a self-assessment).

Graphify reviewed this change.

Looks safe to merge — no coupling regressions and no blocking issues, checked against the code graph (not a self-assessment).


Graphify review — findings

This PR rewrites docs/roadmap.md, updating it from the v2.9.0 snapshot (2026-05-05) to a v2.39.x refresh dated 2026-08-03. It replaces the old Now/Next/Deferred/Recently-shipped structure with new sections including Mermaid visual maps (mindmap and timeline), decision gates by due date, a table of 25 open GitHub issues grouped by category, and expanded future features/integrations/infrastructure listings. The changes are documentation-only and describe roadmap items sourced from open issues, decisions/, and .claude/plans/.

No blocking issues surfaced.

Analysis details — impact, health, verification

Impact & health

Graphify review

Impact — 19 functions depend on the 19 functions this change touches.

Health — grade A; no new coupling hotspots.

Verification — 19 functions in the blast radius were not formally verified this run (proofs are advisory here).

Gate & verification

graphify gate

PASS — objectively clean (no health regressions, tests not run — proofs not run this pass (advisory)). Grounded, not self-assessed.

Advisory (not blocking):

  • verification_scope: 19 function(s) in the blast radius were not formally verified this run

@sonarqubecloud

sonarqubecloud Bot commented Aug 3, 2026

Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

0 issues found across 1 file (changes from recent commits).

Auto-approved: Docs-only rewrite of the stale roadmap into a Mermaid visual map, timeline, and issue inventory; no production behavior changes. The change is bounded and clearly beneficial, and remaining risk is ordinary documentation accuracy.

Re-trigger cubic

@LucasSantana-Dev
LucasSantana-Dev merged commit d637e1f into main Aug 3, 2026
40 checks passed
@LucasSantana-Dev
LucasSantana-Dev deleted the docs/visual-roadmap-refresh branch August 3, 2026 10:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant