Issue Prioritization & Execution Plan (2026-04)

[justin808]

Purpose

Consolidated tracker for all open non-docs issues as of the 2026-04-11 triage.
Docs issues are tracked separately in #2678.

Triage results: 18 issues closed (11 work-done, 4 stale/won't-do, 3 resolved-enough). See commit history for close reasons on each.

---

Tier 1: High-Value Features (P1)

Issues that directly improve the product for end users or unblock key workflows.

• Rspack support for RSC #1828 — Rspack support for RSC (P1, discussion) — key competitive feature
• Add per-request store (AsyncLocalStorage) so Server Components can access railsContext without prop drilling #3100 — Per-request store (AsyncLocalStorage) for railsContext — eliminates prop drilling in Server Components
• Add ssr prop to RSCRoute to skip server-side rendering of the RSC payload #3101 — Add ssr prop to RSCRoute to skip SSR of RSC payload — labeled "do not merge", needs design review
• Add imperative refetch API to RSCRoute: ref handle and useCurrentRSCRoute hook #3106 — Imperative refetch API for RSCRoute (ref handle + useCurrentRSCRoute hook)
• Track E: improve first-run and scaffold CI consistency for RSC flows #2796 — Track E: first-run/scaffold CI consistency for RSC flows — PR Scaffold CI workflow and build scripts for first-run consistency #3097 open

Tier 2: Active PRs Ready to Land (review & merge)

These have open PRs and should be reviewed/merged to reduce the open issue count.

• Refactor: Replace stub-throw + Object.assign pattern with capability-based composition for ReactOnRails JS object #2904 — Refactor: capability-based composition for ReactOnRails JS object — PR refactor: replace stub-throw + Object.assign with capability-based composition #3096 open
• Refactor: Replace runtime react_on_rails_pro? checks with strategy pattern + RenderRequest + JsCodeBuilder #2905 — Refactor: strategy pattern replacing runtime react_on_rails_pro? checks — PR refactor: add RenderRequest, JsCodeBuilder, and RenderingStrategy abstractions #3094 open
• Follow-up: CSP nonce sanitization consolidation and validation policy #2582 — CSP nonce sanitization consolidation (P2) — PR Consolidate CSP nonce sanitization into shared module #2828 open
• Follow-up: Deferred review items from PR #2849 #2880 — Deferred review items from PR Improve create-react-on-rails-app fresh app onboarding #2849 — PR fix: address deferred review items from PR #2849 #3093 open
• Follow-up: Cross-env validation and documentation clarity for renderer password #2887 — Cross-env validation for renderer password — PR fix: cross-env validation and docs for renderer password #3090 open (low priority, defensive)

Tier 3: Well-Scoped Fixes (good agent/contributor tasks)

Concrete, well-defined issues that can be picked up independently.

• react_on_rails:pro auto-upgrade: import rewriter misses jest.mock and declare module; Gemfile swap overwrites version pins #3104 — Pro auto-upgrade: import rewriter misses jest.mock and declare module; Gemfile swap overwrites version pins
• bin/ci-local and script/ci-changes-detector fail silently on shallow clones with long-lived branches #3108 — bin/ci-local and script/ci-changes-detector fail silently on shallow clones with long-lived branches
• Observation: multiple guard scripts reimplement base-ref handling #3107 — Multiple guard scripts reimplement base-ref handling (DRY opportunity)
• AGENTS.md changes trigger unnecessary CI workflow runs #2574 — AGENTS.md changes trigger unnecessary CI runs (partially fixed for PRs, not for push-to-main)
• Follow-up: tighten Doctor/SystemChecker webpack config diagnostics during Rspack migration #2633 — Tighten Doctor/SystemChecker webpack config diagnostics for Rspack migration
• Fix benchmark workflow #2546 — Fix benchmark workflow (Bencher 404 "Head Version not found")
• Remove "Setup Node with V8 Crash Retry" action #2184 — Remove "Setup Node with V8 Crash Retry" GitHub Action (used by 10+ workflows, needs migration plan)
• CI: Improve workflow verification retry logic in run-skipped-ci #2000 — Improve workflow verification retry logic in run-skipped-ci (still uses fixed 5s wait)
• Improve test assertions: Replace ambiguous call_count patterns with explicit have_received checks #2157 — Replace call_count test patterns with have_received in port_selector_spec.rb
• Use Error causes #1746 — Use ES2022 Error.cause in TypeScript error handling

Tier 4: Larger Improvements (plan before starting)

These require design decisions or broader changes. Plan first, then execute.

• Add support for react 19.2.1 and make a plan for implementing **Partial Pre-rendering** feature #2182 — React 19 support + Partial Pre-rendering plan (Abanoub) — React 19 already supported, PPR needs planning
• RFC: Rename bundler-agnostic config files from *WebpackConfig.js to bundler-neutral names #2552 — Rename *WebpackConfig.js files to bundler-neutral names (breaking change, needs migration path)
• Enhancement: Extensible bin/dev precompile pattern as alternative to precompile_hook #2347 — Extensible bin/dev precompile pattern (P1) — template implemented, docs page pending — partially done
• Improve generator robustness and error handling #1958 — Improve generator robustness and error handling — partially done, remaining items unclear
• Finish merging linting between Core and Pro #2214 — Finish merging linting between Core and Pro — RuboCop done, ESLint configs still separate
• Incorporate Everything Claude Code (ECC) patterns for enhanced AI-assisted development #2572 — Incorporate ECC patterns for AI-assisted dev — .claude/ partially set up, session hooks not done

Tier 5: Nice-to-Have / Long-Term (P3)

Low priority items. Tackle opportunistically or when related work happens nearby.

• Enable StrictMode everywhere in spec/dummy  #1465 — Enable React StrictMode in spec/dummy
• Convert spec/dummy/client to Typescript #1583 — Convert spec/dummy/client to TypeScript
• Add lock file for creating packs #1627 — Add lock file for creating packs (staleness check exists, no concurrency lock)
• Create load tests and add them to CI #1658 — Create load tests and add them to CI
• Fix Coveralls setup #1692 — Fix Coveralls setup (no coverage reporting currently)
• Add rake task to generate and export reference webpack/rspack configurations #1862 — Add rake task to export reference webpack/rspack configurations
• Investigate AI security scanners for React on Rails #2018 — Investigate AI security scanners
• Add OpenTelemetry support for Node Renderer #2156 — Add OpenTelemetry support for Node Renderer
• Add performance tests for different SSR and client rendering operations #2169 — Add performance tests for SSR/client rendering operations
• Use pnpm catalogs to decrease duplication between package.json files #2180 — Use pnpm catalogs to reduce duplication between package.json files
• Improve bundler caching in CI #2224 — Improve bundler caching in CI

Stale Open PRs (cleanup candidates)

These open PRs may need attention:

• PR fix: centralize CI docs-only detection and add CLI flag validation #3091 — Targets upcoming-v16.3.0 for Optimize length-prefixed protocol performance for in-process RSC path #2898, but commit already on main. Can be closed.
• PR Add comprehensive --rsc-pro generator tests #3098 — Tests for Track A: add --rsc-pro generator mode with matched Pro/RSC defaults #2793, but Track A: add --rsc-pro generator mode with matched Pro/RSC defaults #2793 is already closed. Evaluate if tests should still land.
• PR Merge upcoming-v16.3.0 into main #2903 — upcoming-v16.3.0 → main merge, stale since April 5. Evaluate if still needed.
• PR NO MERGE: Replacement for #2835 (reapply RSC payload embedding optimization) #2879 — "NO MERGE" replacement for reverted Eliminate double JSON.stringify in RSC payload embedding #2835. Decide: reapply or close.
• PR Add Async Props documentation with animated SVG diagrams #2265 — Async props docs with animated SVGs. Open since March 2026. Review or close.
• PR Add error scenarios hub and test pages #2497 — Error scenarios hub. Open since February 2026. Review or close.

---

Summary Stats

Category	Count
Issues closed in this triage	18
Remaining open issues (non-docs)	~38
Remaining open docs issues (in #2678)	8
Open PRs linked to open issues	10
Stale open PRs to evaluate	6