PureXML/docs/roadmap.md
Mihaela Mihaljevic f7d8fa16d1 docs(roadmap): rebuild tracker references after the GitHub loss
The roadmap and README cited issue numbers from the deleted GitHub
tracker and carried stale XSTS figures (0/39/0/26 and 0/43/0/31 against
the enforced 0/8/0/4). Recreate the load-bearing issues on Codeberg
(#3 production-readiness epic, #4 and #5 gate trackers, #6 performance,
#7 Xalan burn-down), cite them, correct every baseline figure to the
test ratchet, mark shipped work (located diagnostics, the differential
harness) as done, and note that pre-migration numbers in the historical
narrative refer to the lost tracker.

Closes #2
2026-07-05 05:49:57 +02:00

2.9 KiB

Roadmap

Living index of open work. Pin #3 (production readiness for IDE use) for the checklist view. Released v0.4.8 (2026-07-05); pre-1.0 until the production-readiness gates in docs/production-readiness.md are earned.

The tracker was rebuilt on Codeberg after the original issue history was lost with the GitHub repository; pre-migration issue numbers cited in older changelog entries and commit messages refer to that lost tracker.

Current focus (priority order)

  1. #4: drive invalid schemas accepted from 8 to 0. The remainder routes through ParticleRestriction.violation's deliberate under-approximation (docs/release-hurdles.md, Part 1).
  2. #5: drive invalid instances accepted from 4 to 0 (contested-spec and policy-dependent tail, docs/xsts-deviations.md).
  3. Proven (not capped) interactive resource bounds beyond the content matcher (docs/release-hurdles.md, Part 2; the graph-structured-stack matcher's linear bound is already count-asserted).

Parallel: #7 (Xalan XSLT suite burn-down, 26 pinned failures), #6 (performance epic, live table in docs/benchmarks.md).

XSTS gates (current enforced baselines)

These mirror the ratchet asserted in Tests/XSTSSuiteTests.swift; update both together.

Gate Now Issue
Valid schemas rejected 0 at floor, enforced by the ratchet
Invalid schemas accepted 8 #4
Valid instances rejected 0 at floor, enforced by the ratchet
Invalid instances accepted 4 #5

Gates are metric trackers, not implementation tasks. Ratchet baselines in Tests/XSTSSuiteTests.swift when counts fall; a rising count is a regression.

Milestones

Milestone Exit criteria Key issues
M1: Trust the oracle Reference differentials + fuzz done (schema determinism, facet-value, and instance differentials all land opt-in)
M2: Schema compiles correctly #4 to 0 #4
M3: Instances validate correctly #5 to 0 #5
M4: IDE-ready diagnostics Located errors, proven bounds located diagnostics done; bounds under #3
M5: 1.0 All gates at 0 #3, #6, #7

Labels

Label Meaning
epic Grouping issue
gate XSTS outcome metric
task Implementation work
area-schema / area-instance / area-infra / area-xslt / area-perf Subsystem
priority-P0 / P1 / P2 Critical path vs parallel
  • docs/production-readiness.md: the bar for IDE authority
  • docs/schema-validity-burndown.md: schema-side burn-down protocol
  • docs/xsts-deviations.md: deviation taxonomy and documented floors