[IR-P3][WS2] Phase 3 QueryIR cutover (epic)

[0x054]

Problem statement

Phase 3 needs a controlling epic to coordinate deliverables, acceptance criteria, and traceability for QueryIR cutover.

Intended invariant

Move query execution to typed QueryIR and retire internal JSON query contracts.

Scope boundaries

• Coordinates Phase 3 roadmap scope only
• Tracks delivery issues and phase exit gate evidence
• Defers unrelated feature expansion outside IR roadmap scope

Deliverable checklist

• Sub-issues for all phase deliverables are opened and linked
• Phase deliverables are implemented and verified
• Exit gate evidence is linked in roadmap and issues
• Migration and docs impact fields are kept synchronized

Validation plan

Phase 3 closes only when linked sub-issues are complete and roadmap phase exit gates are satisfied with evidence.

Rollback/failure mode

If scope expands or deliverables split, create follow-up issues and update roadmap + issue links in the same work session.

Roadmap reference

Roadmap reference: docs/plans/2026-06-19-001-ir-first-roadmap.md (Phase 3)

Migration impact

minor - phase-level impact estimate; refine on each sub-issue.

Documentation impact

update-existing - phase requires synchronized docs updates with implementation.

Sync status

Synced with roadmap: 2026-06-19

[0x054]

Phase sub-issues:

• [IR-P3][WS2] Cut runtime query compilation to QueryIR #85 Cut runtime query compilation to QueryIR
• [IR-P3][WS2] Deprecation track for legacy operator-style predicates #86 Deprecation track for legacy operator-style predicates
• [IR-P3][WS2] Remove JSON query payload bridge from core path #87 Remove JSON query payload bridge from core path

[0x054]

Phase 3 epic sync update (working branch, pending PR):

• [IR-P3][WS2] Cut runtime query compilation to QueryIR #85 implemented: runtime query compilation consumes QueryIR envelopes.
• [IR-P3][WS2] Deprecation track for legacy operator-style predicates #86 implemented: operator-style deprecation warnings + docs/migration guidance updates.
• [IR-P3][WS2] Remove JSON query payload bridge from core path #87 implemented: legacy JSON query payload bridge removed from core execution path.

Roadmap/doc synchronization landed in working branch:

• docs/plans/2026-06-19-001-ir-first-roadmap.md (Phase 3 status/deliverables/exit gates/evidence/progress log)
• docs/plans/ir-first-migration-guide.md (Phase 3 entries for [IR-P3][WS2] Cut runtime query compilation to QueryIR #85/[IR-P3][WS2] Deprecation track for legacy operator-style predicates #86/[IR-P3][WS2] Remove JSON query payload bridge from core path #87)

Verification evidence:

• uv run pytest tests/test_static_contracts.py tests/test_query_builder.py tests/test_query_typing.py tests/test_shadow_reports.py -q ✅
• uv run pytest tests/test_ir_vectors_contract.py -q ✅
• uv run pytest tests/test_docs_examples.py -q ✅
• cargo test query_ir_roundtrip_preserves_semantics_signature ⚠️ blocked by local PyO3/Python linker environment (_Py* symbols)

Roadmap reference: docs/plans/2026-06-19-001-ir-first-roadmap.md (Phase 3).

[0x054]

Verification update:

The previously reported Rust linker failure is resolved by running tests with the repo’s documented test feature set.

• ✅ cargo test --no-default-features --features testing query_ir_roundtrip_preserves_semantics_signature

Phase 3 evidence status remains otherwise unchanged; roadmap + migration guide sync updates are in the working branch.

[0x054]

Roadmap sequencing sync update:

• Phase 7 is now explicitly the public upgrade release phase with deprecated compatibility paths still supported.
• Hard removal/cutover moved to Phase 8 with release target v0.13.0.
• Deprecation messaging and docs now point to v0.13.0 instead of Phase 7/next major release.

Roadmap reference: docs/plans/2026-06-19-001-ir-first-roadmap.md.

[0x054]

Sunset-test planning sync update:

• Added an explicit deprecated-compat test inventory to Phase planning.
• Introduced pytest.mark.deprecated_operator_path as the sunset marker for tests that only validate temporary operator-style compatibility.
• Roadmap now carries this as a tracked deliverable for Phase 7 inventory + Phase 8 (v0.13.0) removal.

[0x054]

Phase 3 epic completed via merged PR #106 and linked sub-issues #85, #86, #87.\n\nRoadmap + migration guide + issue synchronization updates are in place, including Phase 7/8 and v0.13.0 deprecation sequencing.