feat: complete Phase 4 - remove embedded file_ops component (#183)

- Remove tools/file_ops/ embedded Go binary (deprecated since Phase 3)
- Consolidate to external pre-built WASM component only
- Update toolchains to reference external component exclusively
- Update test fixtures to use external component
- Remove deprecated file_ops_source flag (was "embedded" vs "external")
- Simplify toolchain registration in MODULE.bazel
- Update toolchains/file_ops_toolchain.bzl repository generation

The external bazel-file-ops-component with LOCAL AOT compilation is now
the sole implementation, providing 100x faster startup times compared to
the previous embedded Go binary approach.

This closes issue #183 - finally completing the migration to the external
component that was marked as deprecated in Phase 3.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: avrabe

MODULE.bazel

@@ -227,8 +227,9 @@ register_toolchains("@nodejs_toolchains//:all")
 # Register jco toolchain for JavaScript/TypeScript components
 register_toolchains("@jco_toolchain//:jco_toolchain")
 
-# File Operations Component toolchain for universal file handling
-register_toolchains("//toolchains:file_ops_toolchain_local")
+# File Operations Component toolchain - Phase 4 (Final)
+# Now uses external pre-built WASM component from bazel-file-ops-component
+register_toolchains("//toolchains:file_ops_toolchain_external_public")
 
 # External File Operations Component from bazel-file-ops-component
 # Phase 2: External component with LOCAL AOT compilation

MODULE.bazel.lock

@@ -1,79 +1,86 @@
 {
   "tool_name": "nodejs",
   "github_repo": "nodejs/node",
-  "latest_version": "20.18.0",
-  "last_checked": "2025-08-17T10:30:00Z",
-  "note": "Node.js runtime for hermetic jco toolchain installation",
+  "latest_version": "25.2.1",
+  "last_checked": "2025-12-05T06:36:02.906041Z",
   "versions": {
+    "25.2.1": {
+      "release_date": "2025-11-17",
+      "platforms": {
+        "darwin_arm64": {
+          "sha256": "be87e21bd235a451fad02c89e5bf7cb17e206e4cd89dd5664f20d19e7dfde6f9",
+          "url_suffix": "darwin-arm64.tar.gz"
+        },
+        "linux_arm64": {
+          "sha256": "905238a17be9ae62c16e596019268d8ca9f0fc3142602a1f860dc4a7c1ddbf82",
+          "url_suffix": "linux-arm64.tar.xz"
+        },
+        "darwin_amd64": {
+          "sha256": "c266da5a9075a56e1aa02460ce8df96fca9e796c388abe94a8df4949945df6b6",
+          "url_suffix": "darwin-x64.tar.gz"
+        },
+        "linux_amd64": {
+          "sha256": "2094ecdc844ea11e9777cac42672b0d89cd63d27204193a587dc5a2d276bb940",
+          "url_suffix": "linux-x64.tar.xz"
+        }
+      }
+    },
     "18.20.8": {
       "release_date": "2024-09-03",
       "platforms": {
-        "darwin_amd64": {
-          "sha256": "ed2554677188f4afc0d050ecd8bd56effb2572d6518f8da6d40321ede6698509",
-          "url_suffix": "darwin-x64.tar.gz",
-          "binary_path": "node-v{}-darwin-x64/bin/node",
-          "npm_path": "node-v{}-darwin-x64/bin/npm"
+        "linux_amd64": {
+          "sha256": "27a9f3f14d5e99ad05a07ed3524ba3ee92f8ff8b6db5ff80b00f9feb5ec8097a",
+          "url_suffix": "linux-x64.tar.gz"
         },
         "darwin_arm64": {
           "sha256": "bae4965d29d29bd32f96364eefbe3bca576a03e917ddbb70b9330d75f2cacd76",
-          "url_suffix": "darwin-arm64.tar.gz",
-          "binary_path": "node-v{}-darwin-arm64/bin/node",
-          "npm_path": "node-v{}-darwin-arm64/bin/npm"
+          "url_suffix": "darwin-arm64.tar.gz"
         },
-        "linux_amd64": {
-          "sha256": "27a9f3f14d5e99ad05a07ed3524ba3ee92f8ff8b6db5ff80b00f9feb5ec8097a",
-          "url_suffix": "linux-x64.tar.gz",
-          "binary_path": "node-v{}-linux-x64/bin/node",
-          "npm_path": "node-v{}-linux-x64/bin/npm"
+        "windows_amd64": {
+          "sha256": "1a1e40260a6facba83636e4cd0ba01eb5bd1386896824b36645afba44857384a",
+          "url_suffix": "win-x64.zip"
+        },
+        "darwin_amd64": {
+          "sha256": "ed2554677188f4afc0d050ecd8bd56effb2572d6518f8da6d40321ede6698509",
+          "url_suffix": "darwin-x64.tar.gz"
         },
         "linux_arm64": {
           "sha256": "2e3dfc51154e6fea9fc86a90c4ea8f3ecb8b60acaf7367c4b76691da192571c1",
-          "url_suffix": "linux-arm64.tar.gz",
-          "binary_path": "node-v{}-linux-arm64/bin/node",
-          "npm_path": "node-v{}-linux-arm64/bin/npm"
-        },
-        "windows_amd64": {
-          "sha256": "1a1e40260a6facba83636e4cd0ba01eb5bd1386896824b36645afba44857384a",
-          "url_suffix": "win-x64.zip",
-          "binary_path": "node-v{}-win-x64/node.exe",
-          "npm_path": "node-v{}-win-x64/npm.cmd"
+          "url_suffix": "linux-arm64.tar.gz"
         }
       }
     },
     "20.18.0": {
       "release_date": "2024-10-03",
       "platforms": {
-        "darwin_amd64": {
-          "sha256": "c02aa7560612a4e2cc359fd89fae7aedde370c06db621f2040a4a9f830a125dc",
-          "url_suffix": "darwin-x64.tar.gz",
-          "binary_path": "node-v{}-darwin-x64/bin/node",
-          "npm_path": "node-v{}-darwin-x64/bin/npm"
-        },
-        "darwin_arm64": {
-          "sha256": "92e180624259d082562592bb12548037c6a417069be29e452ec5d158d657b4be",
-          "url_suffix": "darwin-arm64.tar.gz",
-          "binary_path": "node-v{}-darwin-arm64/bin/node",
-          "npm_path": "node-v{}-darwin-arm64/bin/npm"
+        "windows_amd64": {
+          "sha256": "f5cea43414cc33024bbe5867f208d1c9c915d6a38e92abeee07ed9e563662297",
+          "url_suffix": "win-x64.zip"
         },
         "linux_amd64": {
           "sha256": "24a5d58a1d4c2903478f4b7c3cfd2eeb5cea2cae3baee11a4dc6a1fed25fec6c",
-          "url_suffix": "linux-x64.tar.gz",
-          "binary_path": "node-v{}-linux-x64/bin/node",
-          "npm_path": "node-v{}-linux-x64/bin/npm"
+          "url_suffix": "linux-x64.tar.gz"
+        },
+        "darwin_amd64": {
+          "sha256": "c02aa7560612a4e2cc359fd89fae7aedde370c06db621f2040a4a9f830a125dc",
+          "url_suffix": "darwin-x64.tar.gz"
         },
         "linux_arm64": {
           "sha256": "38bccb35c06ee4edbcd00c77976e3fad1d69d2e57c3c0c363d1700a2a2493278",
-          "url_suffix": "linux-arm64.tar.gz",
-          "binary_path": "node-v{}-linux-arm64/bin/node",
-          "npm_path": "node-v{}-linux-arm64/bin/npm"
+          "url_suffix": "linux-arm64.tar.gz"
         },
-        "windows_amd64": {
-          "sha256": "f5cea43414cc33024bbe5867f208d1c9c915d6a38e92abeee07ed9e563662297",
-          "url_suffix": "win-x64.zip",
-          "binary_path": "node-v{}-win-x64/node.exe",
-          "npm_path": "node-v{}-win-x64/npm.cmd"
+        "darwin_arm64": {
+          "sha256": "92e180624259d082562592bb12548037c6a417069be29e452ec5d158d657b4be",
+          "url_suffix": "darwin-arm64.tar.gz"
         }
       }
     }
-  }
-}
+  },
+  "supported_platforms": [
+    "darwin_amd64",
+    "darwin_arm64",
+    "linux_amd64",
+    "linux_arm64",
+    "windows_amd64"
+  ]
+}

checksums/registry.bzl

@@ -9,23 +9,28 @@
       "platforms": {
         "linux_amd64": {
           "sha256": "ce30f33c5bc40095cfb4e74ae5fb4ba515d4f4bef2d597831bc7afaaf0d55b6c",
-          "url_suffix": "x86_64-unknown-linux-musl"
+          "url_suffix": "x86_64-unknown-linux-musl",
+          "platform_name": "x86_64-unknown-linux-musl"
         },
         "linux_arm64": {
           "sha256": "3b78ae7c732c1376d1c21b570d07152a07342e9c4f75bff1511cde5f6af01f12",
-          "url_suffix": "aarch64-unknown-linux-musl"
+          "url_suffix": "aarch64-unknown-linux-musl",
+          "platform_name": "aarch64-unknown-linux-musl"
         },
         "darwin_amd64": {
           "sha256": "d5fa365a4920d19a61837a42c9273b0b8ec696fd3047af864a860f46005773a5",
-          "url_suffix": "x86_64-apple-darwin"
+          "url_suffix": "x86_64-apple-darwin",
+          "platform_name": "x86_64-apple-darwin"
         },
         "darwin_arm64": {
           "sha256": "f08496f49312abd68d9709c735a987d6a17d2295a1240020d217a9de8dcaaacd",
-          "url_suffix": "aarch64-apple-darwin"
+          "url_suffix": "aarch64-apple-darwin",
+          "platform_name": "aarch64-apple-darwin"
         },
         "windows_amd64": {
           "sha256": "b3509dfc3bb9d1e598e7b2790ef6efe5b6c8b696f2ad0e997e9ae6dd20bb6f13",
-          "url_suffix": "x86_64-pc-windows-gnu"
+          "url_suffix": "x86_64-pc-windows-gnu",
+          "platform_name": "x86_64-pc-windows-gnu"
         }
       }
     },
@@ -34,23 +39,28 @@
       "platforms": {
         "linux_amd64": {
           "sha256": "9fee2d8603dc50403ebed580b47b8661b582ffde8a9174bf193b89ca00decf0f",
-          "url_suffix": "x86_64-unknown-linux-musl"
+          "url_suffix": "x86_64-unknown-linux-musl",
+          "platform_name": "x86_64-unknown-linux-musl"
         },
         "linux_arm64": {
           "sha256": "af966d4efbd411900073270bd4261ac42d9550af8ba26ed49288bb942476c5a9",
-          "url_suffix": "aarch64-unknown-linux-musl"
+          "url_suffix": "aarch64-unknown-linux-musl",
+          "platform_name": "aarch64-unknown-linux-musl"
         },
         "darwin_amd64": {
           "sha256": "cc58f94c611b3b7f27b16dd0a9a9fc63c91c662582ac7eaa9a14f2dac87b07f8",
-          "url_suffix": "x86_64-apple-darwin"
+          "url_suffix": "x86_64-apple-darwin",
+          "platform_name": "x86_64-apple-darwin"
         },
         "darwin_arm64": {
           "sha256": "6ca7f69f3e2bbab41f375a35e486d53e5b4968ea94271ea9d9bd59b0d2b65c13",
-          "url_suffix": "aarch64-apple-darwin"
+          "url_suffix": "aarch64-apple-darwin",
+          "platform_name": "aarch64-apple-darwin"
         },
         "windows_amd64": {
           "sha256": "7ee34ea41cd567b2578929acce3c609e28818d03f0414914a3939f066737d872",
-          "url_suffix": "x86_64-pc-windows-gnu"
+          "url_suffix": "x86_64-pc-windows-gnu",
+          "platform_name": "x86_64-pc-windows-gnu"
         }
       }
     }

checksums/tools/nodejs.json

@@ -97,7 +97,7 @@ file_ops_integration_test = rule(
             doc = "Which implementation is being tested",
         ),
         "_file_ops_component": attr.label(
-            default = "//tools/file_ops:file_ops",
+            default = "//tools/file_ops_external:file_ops_external",
             executable = True,
             cfg = "exec",
         ),

checksums/tools/wac.json

@@ -204,32 +204,22 @@ bzl_library(
 # Note: C++ toolchain configuration has been moved to @wasi_sdk repository
 # The cc_toolchain is now registered via @wasi_sdk//:cc_toolchain in MODULE.bazel
 
-file_ops_toolchain(
-    name = "file_ops_toolchain_impl",
-    file_ops_component = "//tools/file_ops:file_ops",
-    wit_files = ["//tools/file_ops:wit_files"],
-)
-
-toolchain(
-    name = "file_ops_toolchain_local",
-    # Universal toolchain - works on all platforms
-    toolchain = ":file_ops_toolchain_impl",
-    toolchain_type = ":file_ops_toolchain_type",
-)
 
-# Phase 1 Integration: External File Operations Component from bazel-file-ops-component
+# External File Operations Component from bazel-file-ops-component
 # This uses the pre-built WASM component from https://github.com/pulseengine/bazel-file-ops-component
+# Phase 4 (FINAL): Embedded component removed, external is now the only option
+# WIT files are embedded in the compiled WASM component
 
 file_ops_toolchain(
-    name = "file_ops_toolchain_external_impl",
+    name = "file_ops_toolchain_impl",
     file_ops_component = "//tools/file_ops_external:file_ops_external",
-    wit_files = ["//tools/file_ops:wit_files"],
+    wit_files = [],  # WIT embedded in WASM - extract with wasm-tools if needed
 )
 
 toolchain(
-    name = "file_ops_toolchain_external",
-    # External component toolchain (opt-in for Phase 1)
-    toolchain = ":file_ops_toolchain_external_impl",
+    name = "file_ops_toolchain_external_public",
+    # External component toolchain (now default and only option, public for MODULE.bazel registration)
+    toolchain = ":file_ops_toolchain_impl",
     toolchain_type = ":file_ops_toolchain_type",
 )
 
@@ -258,22 +248,11 @@ string_flag(
     ],
 )
 
-# File Operations Source Selection
-# Phase 3: DEPRECATION - Embedded component will be removed in v2.0.0
-#
-# The embedded component (tools/file_ops/) is DEPRECATED and will be removed in v2.0.0.
-# See docs/MIGRATION.md for migration guide.
+# File Operations Implementation Selection
+# Phase 4 (FINAL): Embedded component removed. External component is now the only option.
 #
-# Default is "external" with AOT support (100x faster startup)
-# Only use "embedded" if you encounter critical issues - this option will be removed soon.
-string_flag(
-    name = "file_ops_source",
-    build_setting_default = "external",  # Phase 2+: External with AOT is default
-    values = [
-        "embedded",  # DEPRECATED - Will be removed in v2.0.0 (Phase 4)
-        "external",  # RECOMMENDED - External component with AOT (default)
-    ],
-)
+# Implementation preference can still be controlled via the file_ops_implementation flag
+# for choosing between TinyGo and Rust implementations of the external component.
 
 # Configuration settings for implementation selection
 config_setting(
@@ -297,20 +276,5 @@ config_setting(
     },
 )
 
-# Configuration settings for source selection (Phase 2: External with AOT is default)
-config_setting(
-    name = "file_ops_use_embedded",
-    flag_values = {
-        ":file_ops_source": "embedded",
-    },
-)
-
-config_setting(
-    name = "file_ops_use_external",
-    flag_values = {
-        ":file_ops_source": "external",
-    },
-)
-
 # WASI Preview 1 Component Adapter
 exports_files(["wasi_snapshot_preview1.command.wasm"])