# Roadmap

Living index of open work. **Pin [#3](https://codeberg.org/NodetteHQ/PureXML/issues/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](https://codeberg.org/NodetteHQ/PureXML/issues/4)**: invalid schemas
   accepted is at 3, and every remaining case is a documented divergence, not
   an open bug: Ik025/Ik027 (cos-st-derived-ok 2.2.4 reading) and schN12
   (src-redefine 6.2.2 cannot be enforced uniformly without rejecting
   mgO013's settled-valid schema). See `docs/xsts-deviations.md`.
2. **[#5](https://codeberg.org/NodetteHQ/PureXML/issues/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](https://codeberg.org/NodetteHQ/PureXML/issues/7)** (Xalan XSLT
suite burn-down, 26 pinned failures),
**[#6](https://codeberg.org/NodetteHQ/PureXML/issues/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 | 3 | [#4](https://codeberg.org/NodetteHQ/PureXML/issues/4) |
| Valid instances rejected | 0 | at floor, enforced by the ratchet |
| Invalid instances accepted | 4 | [#5](https://codeberg.org/NodetteHQ/PureXML/issues/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 |

## Related docs

- `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