Skip to content

feat!: RFC 5.0 Phase 4 — remove the v3 mapping engine (one engine story)#48

Merged
coryhubbell merged 1 commit into
mainfrom
feat/5x-phase4-one-engine-story
Jul 4, 2026
Merged

feat!: RFC 5.0 Phase 4 — remove the v3 mapping engine (one engine story)#48
coryhubbell merged 1 commit into
mainfrom
feat/5x-phase4-one-engine-story

Conversation

@coryhubbell

Copy link
Copy Markdown
Owner

Summary

RFC 5.0 Phase 4 (breaking). The HTML-intermediate pipeline is removed: class-mapping-engine.php (863 lines of v3 similarity-scoring) is deleted along with the translator's mapping-fallback branch. Every conversion — both engines, all surfaces — rides parse → universal → convert. This completes the RFC: one schema, two conforming runtimes.

Why it's safe

  • The 182-pair matrix was verified green on the universal route before removal (Phase 3) and stays green after — no pair was relying on the fallback.
  • The content-survival check remains as an advisory warning; the per-conversion fidelity stat quantifies any loss.
  • REST/CLI/translate() signatures unchanged. DEVTB_Component remains the PHP engine's internal model — it just isn't an interchange format anywhere public (the mapping engine was its last pipeline consumer).

Also in this PR

  • Deprecation copy corrected across devtb/PHP CLI/Python CLI/README: the translate alias survives 5.0 and is removed in 5.1 (one-minor policy).
  • README + devtb engine story rewritten ("one schema, two conforming runtimes"); RFC marked COMPLETE.
  • CHANGELOG breaking entry + migration notes (direct DEVTB_Mapping_Engine users → parse_to_universal() / translate_universal()).

Test evidence

PHPUnit 344/5,691 · pytest 306 (39/39 matrix) · 3 e2e smokes × 2 engines — all green, plus a live CLI spot-check (route=universal, fidelity reported, 5.1 deprecation copy).

🤖 Generated with Claude Code

BREAKING: the HTML-intermediate pipeline is gone. Every conversion rides
parse → universal → convert; there is no fuzzy-mapping fallback.

- Delete translation-bridge/core/class-mapping-engine.php (863 lines) and
  the translator's mapping-fallback branch + map_components(); the
  content-survival check is now an advisory warning quantified by the
  per-conversion fidelity stat; stats route is always 'universal'
- Drop the mapping-engine requires from functions.php and the matrix test
  (all 182 pairs pass on the universal route alone — verified before
  and after removal)
- DEVTB_Component is no longer an interchange format on any public
  surface (the mapping engine was its last pipeline consumer); it remains
  the PHP engine's internal model
- Deprecation copy corrected: the translate alias survives 5.0 and is
  removed in 5.1 (RFC one-minor policy); devtb/README engine story
  rewritten as "one schema, two conforming runtimes"
- CHANGELOG carries the breaking entry + migration notes

Suites: PHP 344/5,691 · Python 306 · 3 e2e smokes × 2 engines — green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@coryhubbell coryhubbell merged commit 96eeb32 into main Jul 4, 2026
10 checks passed
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