Skip to content

docs(roadmap): add the post-2.0 engineering roadmap#324

Merged
DemchaAV merged 1 commit into
2.0-devfrom
build/2.0-roadmap-refresh
Jul 6, 2026
Merged

docs(roadmap): add the post-2.0 engineering roadmap#324
DemchaAV merged 1 commit into
2.0-devfrom
build/2.0-roadmap-refresh

Conversation

@DemchaAV

@DemchaAV DemchaAV commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Why

The engineering work deliberately deferred past the 2.0 line (internal refactors, scale, tooling) was only tracked privately. This puts it in a committed, forward-looking roadmap so it isn't lost, and refreshes the docs index (which still called the shipped v1.6 roadmap "current").

What

  • docs/roadmaps/post-2.0-engineering.md (new) — deferred engineering items, each with a status:
    • Decompose the layout hot files — LayoutCompiler (~1690 LOC) and TextFlowSupport (~1900 LOC) along their seams (pagination / row / stack / decoration), output unchanged.
    • Retire the internal Entity / EntityManager model (the live coordinate/geometry/guides are still built on it; a real engine refactor + removing the graph-compose-testing legacy snapshot overloads).
    • FAIL_ON_UNCONVERGED layout policy flag.
    • Streaming / bounded-memory rendering for very large documents.
    • ArchUnit module-boundary guards (replace brittle path-greps).
    • Cross-module coverage aggregation (a dedicated non-published module — report-aggregate doesn't traverse test-scope deps).
    • Post-GA per-module japicmp baselines + break mode.
  • docs/README.md — link the new roadmap at the top of "Roadmaps & migrations"; relabel v1.6-roadmap.md as shipped.

No public-API or code changes; describes intent, not internal planning artifacts.

Tests

Docs-only. CanonicalSurfaceGuardTest (scans docs/** for retired legacy tokens): 8 tests, 0 failures. New roadmap link resolves; no broken references.

Capture the engineering work deferred past the 2.0 line in a forward-looking
roadmap: decomposing the layout hot files (LayoutCompiler / TextFlowSupport),
retiring the internal Entity model, a fail-on-unconverged layout policy,
streaming / bounded-memory rendering, ArchUnit boundary guards, cross-module
coverage aggregation, and post-GA per-module japicmp baselines. Link it from
the docs index and relabel the shipped v1.6 roadmap.
@DemchaAV DemchaAV merged commit 142ac40 into 2.0-dev Jul 6, 2026
10 checks passed
@DemchaAV DemchaAV deleted the build/2.0-roadmap-refresh branch July 6, 2026 18:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant