feat: 5.1 — transform-all replaces the removed translate alias

CHANGELOG.md

@@ -9,7 +9,24 @@ Detailed notes for major releases live in `RELEASE_NOTES_V*.md` and on
 
 ## [Unreleased]
 
-Nothing yet.
+### Added
+
+- **`devtb transform-all <source> <file>`** (Python engine) — fan one
+  source out to every other framework through the universal route, with a
+  per-target fidelity table. Replaces `translate-all`.
+
+### Removed
+
+- The **`translate` and `translate-all` CLI commands** (deprecated since
+  4.14.0; window closed per the one-minor policy). Both now exit with a
+  pointer to `transform` / `transform-all`. The engine method
+  `DEVTB_Translator::translate()` is unaffected (WordPress runtime).
+
+### Fixed
+
+- `devtb` help no longer lists `list-frameworks` and `validate` as
+  deprecated — they were never deprecated and remain supported PHP-engine
+  utilities.
 
 ## [5.0.0] — 2026-07-04
 

README.md

@@ -62,7 +62,7 @@ flowchart TD
 | Command | Engine | Status | Notes |
 |---|---|---|---|
 | `transform` | Python | **Recommended** | JSON-native, 100% metadata, ~0.5s/page |
-| `translate` | PHP (WordPress runtime) | **Deprecated — removed in 5.1** | Identical universal pipeline; fidelity reported per conversion |
+| `transform-all` | Python | Supported | One source → every other framework, per-target fidelity table |
 
 ---
 
@@ -389,7 +389,7 @@ v4.3.1 → v4.3.3 notes: [v4.3.3 release](https://github.com/coryhubbell/Develop
 
 ### Requirements
 
-- PHP **8.1+** (for the `translate` path, theme install, and REST API)
+- PHP **8.1+** (for the WordPress runtime, theme install, and REST API)
 - Python **3.9+** (for the `transform` path and CLI); local verification is pinned to **3.11** via `.python-version`
 - Node **20.19.0**, **22.13.0+**, or **24+** + npm (only to rebuild the React admin UI from source)
 - Composer 2.0+ and pip (only if installing from source)
@@ -438,8 +438,8 @@ make verify
 # JSON-native transform (recommended for JSON-based frameworks)
 ./devtb transform elementor bootstrap input.json -o output.html
 
-# translate is deprecated (removed in 5.1) — same lossless path, PHP engine
-./devtb translate divi avada input.html -o output.html
+# fan out to every framework at once (per-target fidelity table)
+./devtb transform-all divi input.html
 
 # Transform an entire site export
 ./devtb transform-site elementor bootstrap ./export-kit/

devtb

@@ -3,8 +3,8 @@
 # DEVTB - DevelopmentTranslation Bridge CLI
 # =============================================================================
 # Unified CLI wrapper that routes commands to the appropriate backend:
-#   - transform, transform-site, analyze → Python (v4 JSON-native engine)
-#   - translate, translate-all, etc. → PHP (v3 HTML intermediate)
+#   - transform, transform-all, transform-site, analyze → Python engine
+#   - list-frameworks, validate → PHP engine (WordPress runtime utilities)
 #
 # Version: 5.0.0
 # =============================================================================
@@ -28,8 +28,8 @@ VERSION="5.0.0"
 show_version() {
     echo "DevelopmentTranslation Bridge v${VERSION}"
     echo "  One schema, two conforming runtimes (parse -> universal -> convert)"
-    echo "  Python engine: transform commands + translate alias"
-    echo "  PHP engine: WordPress runtime (translate, deprecated)"
+    echo "  Python engine: transform commands"
+    echo "  PHP engine: WordPress runtime utilities"
 }
 
 # Show help
@@ -43,14 +43,13 @@ show_help() {
     echo "USAGE:"
     echo "  devtb <command> [options]"
     echo ""
-    echo "COMMANDS (v4 Python - JSON-native, lossless):"
+    echo "COMMANDS (Python engine - JSON-native, lossless):"
     echo "  transform <source> <target> <file>    Transform a file (100% metadata preserved)"
+    echo "  transform-all <source> <file>         Transform to every other framework"
     echo "  transform-site <source> <target> <dir> Transform all files in directory"
     echo "  analyze <framework> <file>            Analyze page builder content"
     echo ""
-    echo "COMMANDS (deprecated — removed in 5.1):"
-    echo "  translate <source> <target> <file>    Same lossless path as transform (PHP engine)"
-    echo "  translate-all <source> <file>         Translate to all frameworks (PHP)"
+    echo "COMMANDS (PHP engine utilities):"
     echo "  list-frameworks                       List supported frameworks"
     echo "  validate <framework> <file>           Validate file format"
     echo ""
@@ -66,13 +65,13 @@ show_help() {
     echo "  devtb transform elementor bootstrap page.json"
     echo "  devtb analyze elementor page.json"
     echo ""
-    echo "  # translate is a deprecated alias of transform (same lossless path)"
-    echo "  devtb translate bootstrap divi page.html"
-    echo "  devtb translate-all bootstrap page.html"
+    echo "  # fan out to every framework at once"
+    echo "  devtb transform-all bootstrap page.html"
     echo ""
     echo "NOTE:"
-    echo "  As of RFC 5.0 Phase 3, every conversion rides the lossless"
-    echo "  parse → universal → convert path; fidelity is reported per conversion."
+    echo "  Every conversion rides the lossless parse → universal → convert"
+    echo "  path; fidelity is reported per conversion. 'translate' was"
+    echo "  removed in 5.1 — use 'transform'."
     echo ""
     echo "For more info: https://github.com/coryhubbell/development-translation-bridge"
     echo ""
@@ -131,15 +130,19 @@ main() {
     shift
 
     case "$cmd" in
-        # v4 Python commands (JSON-native)
-        transform|transform-site|analyze)
+        # Python engine (JSON-native)
+        transform|transform-all|transform-site|analyze)
             run_python "$cmd" "$@"
             ;;
 
-        # Deprecated (RFC 5.0 Phase 3): translate now rides the same
-        # parse → universal → convert path as transform (inside the PHP
-        # engine, which serves all 182 pairs) and is removed in 5.1.
-        translate|translate-all|list-frameworks|validate)
+        # Removed in 5.1 (deprecated since 4.14.0)
+        translate|translate-all)
+            echo -e "${RED}'$cmd' was removed in 5.1 — use 'devtb transform' / 'devtb transform-all'.${NC}"
+            exit 1
+            ;;
+
+        # PHP engine utilities (WordPress runtime)
+        list-frameworks|validate)
             run_php "$cmd" "$@"
             ;;