computerd: cleanup code comments

Author: aron-cf

.github/actions/install/action.yml

@@ -16,9 +16,7 @@ runs:
         registry-url: ${{ inputs.registry-url }}
         cache: npm
 
-    # npm ci compiles the vendored fuse-napi addon for
-    # @cloudflare/computerd, which needs the libfuse 3 headers. Without
-    # them the install, and with it every job, fails.
+    # npm ci compiles computerd's vendored FUSE addon against these.
     - name: Install the libfuse 3 headers
       if: runner.os == 'Linux'
       shell: bash

.github/workflows/ci.yml

@@ -67,9 +67,8 @@ jobs:
             path: packages/computerd
             needs-siblings: true
             build-computerd-bin: true
-            # fuse3 ships fusermount3, which the real-FUSE tests mount
-            # through. The addon itself is compiled during npm ci. xz-utils
-            # extracts the target Node binary used by build:bin.
+            # fuse3 provides fusermount3 for the real-FUSE tests; xz-utils
+            # unpacks the Node binary build:bin injects into.
             system-deps: "fuse3 xz-utils"
     steps:
       - uses: actions/checkout@v6

.github/workflows/next-computerd-image.yml

@@ -67,8 +67,7 @@ jobs:
       - name: Build all workspaces
         run: npm run build --workspaces --if-present
 
-      # build:bin compiles the FUSE addon inside a Debian trixie container,
-      # so the runner needs Docker but no FUSE packages of its own.
+      # Compiles the FUSE addon in a container, so no FUSE packages here.
       - name: Build the computerd binary
         run: npm run build:bin --workspace @cloudflare/computerd
 

examples/container/Dockerfile

@@ -18,9 +18,8 @@ FROM ghcr.io/cloudflare/computer-computerd-linux-x64:0.5.1 AS computerd
 
 FROM debian:stable-slim
 
-# fuse3 brings libfuse 3. Releases after 0.4.1 link it and need 3.17
-# or newer, which is Debian trixie. 0.4.1 and earlier link libfuse 2
-# instead, hence libfuse2t64; drop it once the pin above is past 0.4.1.
+# libfuse2t64 is for the pinned 0.4.1 binary. Later releases need only
+# fuse3, at libfuse 3.17 or newer (Debian trixie); drop it then.
 RUN apt-get update \
  && apt-get install -y --no-install-recommends \
       fuse3 libfuse2t64 ca-certificates curl gnupg git \

examples/egress/Dockerfile

@@ -2,9 +2,8 @@ FROM ghcr.io/cloudflare/computer-computerd-linux-x64:0.5.1 AS computerd
 
 FROM debian:trixie-slim
 
-# fuse3 brings libfuse 3. Releases after 0.4.1 link it and need 3.17
-# or newer, which is Debian trixie. 0.4.1 and earlier link libfuse 2
-# instead, hence libfuse2t64; drop it once the pin above is past 0.4.1.
+# libfuse2t64 is for the pinned 0.4.1 binary. Later releases need only
+# fuse3, at libfuse 3.17 or newer (Debian trixie); drop it then.
 RUN apt-get update \
  && apt-get install -y --no-install-recommends \
       fuse3 libfuse2t64 ca-certificates curl \

examples/mcp/Dockerfile

@@ -2,9 +2,8 @@ FROM ghcr.io/cloudflare/computer-computerd-linux-x64:0.5.1 AS computerd
 
 FROM node:22-trixie-slim
 
-# fuse3 brings libfuse 3. Releases after 0.4.1 link it and need 3.17
-# or newer, which is Debian trixie. 0.4.1 and earlier link libfuse 2
-# instead, hence libfuse2t64; drop it once the pin above is past 0.4.1.
+# libfuse2t64 is for the pinned 0.4.1 binary. Later releases need only
+# fuse3, at libfuse 3.17 or newer (Debian trixie); drop it then.
 RUN apt-get update \
  && apt-get install -y --no-install-recommends \
       ca-certificates curl fuse3 git libfuse2t64 \

examples/think-compare-runtimes/Dockerfile.workspace

@@ -16,9 +16,8 @@ FROM ghcr.io/cloudflare/computer-computerd-linux-x64:0.5.1 AS computerd
 
 FROM --platform=linux/amd64 node:22-trixie-slim
 
-# fuse3 brings libfuse 3. Releases after 0.4.1 link it and need 3.17
-# or newer, which is Debian trixie. 0.4.1 and earlier link libfuse 2
-# instead, hence libfuse2t64; drop it once the pin above is past 0.4.1.
+# libfuse2t64 is for the pinned 0.4.1 binary. Later releases need only
+# fuse3, at libfuse 3.17 or newer (Debian trixie); drop it then.
 RUN apt-get update \
  && apt-get install -y --no-install-recommends \
       ca-certificates git fuse3 libfuse2t64 \

examples/think/Dockerfile

@@ -20,9 +20,8 @@ FROM debian:stable-slim
 # come in handy for ad-hoc agent commands too. The cost is ~120 MB
 # of layer over the base; acceptable for an example whose whole
 # point is running real build/test workflows.
-# fuse3 brings libfuse 3. Releases after 0.4.1 link it and need 3.17
-# or newer, which is Debian trixie. 0.4.1 and earlier link libfuse 2
-# instead, hence libfuse2t64; drop it once the pin above is past 0.4.1.
+# libfuse2t64 is for the pinned 0.4.1 binary. Later releases need only
+# fuse3, at libfuse 3.17 or newer (Debian trixie); drop it then.
 RUN apt-get update \
  && apt-get install -y --no-install-recommends \
       fuse3 libfuse2t64 ca-certificates curl gnupg git \

examples/tutorial/Dockerfile

@@ -18,9 +18,8 @@ ARG TYPST_VERSION=0.15.1
 # pandoc converts the agent's markdown; typst is the PDF engine, a
 # single 30 MB binary instead of the several hundred megabytes a LaTeX
 # install would cost. curl is only the download tool for those two.
-# fuse3 brings libfuse 3. Releases after 0.4.1 link it and need 3.17
-# or newer, which is Debian trixie. 0.4.1 and earlier link libfuse 2
-# instead, hence libfuse2t64; drop it once the pin above is past 0.4.1.
+# libfuse2t64 is for the pinned 0.4.1 binary. Later releases need only
+# fuse3, at libfuse 3.17 or newer (Debian trixie); drop it then.
 RUN apt-get update \
  && apt-get install -y --no-install-recommends \
       fuse3 libfuse2t64 ca-certificates curl xz-utils \

packages/computer/test-harness/run-computerd.sh

@@ -48,8 +48,7 @@ RUN apt-get update >/dev/null \
 DOCKERFILE
 fi
 
-# Forward local-only path and FUSE tuning settings from the caller, so a
-# test can boot computerd with MOUNT_IGNORE or COMPUTERD_FUSE_TRACE set.
+# Lets a test boot computerd with MOUNT_IGNORE or COMPUTERD_FUSE_* set.
 FORWARD_ENV=()
 while IFS='=' read -r name _; do
   case "$name" in