fix(dx): unblock claude worktree start and pre-push hooks (#7059)

* fix(claude): remove blocking WorktreeCreate yarn install hook

The synchronous WorktreeCreate hook ran yarn install with a 120s
timeout, blocking the Claude Code TUI when launched with `-w`. With
puppeteer and playwright in deps, the install reliably exceeds the
timeout.

The async SessionStart hook already handles "first session in a new
worktree" via its `[ ! -d node_modules ]` guard, so the WorktreeCreate
hook is redundant.

Also harden SessionStart:
- Skip puppeteer/playwright browser downloads
- Bump timeout 120 -> 300

* fix(lefthook): disable docker-dependent pre-push hooks

Comment out pre-push hooks that require docker:
- prune-legacy-containers
- build-pytest-image
- *-pytest code-block test tasks (cloud, cloud-dedicated,
  cloud-serverless, clustered, telegraf, v2)

These blocked pushes for any change when docker was not running
locally, even when the change had nothing to do with code blocks
or container management.

Replace prune-legacy-containers with list-legacy-containers, a
fault-safe task that exits 0 when docker is unavailable and only
warns about exited influxdata-docs containers when docker is
running. Run code-block tests on demand via yarn test:codeblocks:*.

Author: jstirnaman

.claude/settings.json

@@ -107,25 +107,13 @@
         ]
       }
     ],
-    "WorktreeCreate": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "CYPRESS_INSTALL_BINARY=0 yarn install --frozen-lockfile 2>&1 | tail -3",
-            "timeout": 120,
-            "statusMessage": "Installing dependencies in new worktree"
-          }
-        ]
-      }
-    ],
     "SessionStart": [
       {
         "hooks": [
           {
             "type": "command",
-            "command": "[ ! -d node_modules ] && CYPRESS_INSTALL_BINARY=0 yarn install --frozen-lockfile 2>&1 | tail -3 || true",
-            "timeout": 120,
+            "command": "[ ! -d node_modules ] && CYPRESS_INSTALL_BINARY=0 PUPPETEER_SKIP_DOWNLOAD=1 PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 yarn install --frozen-lockfile 2>&1 | tail -3 || true",
+            "timeout": 300,
             "async": true,
             "statusMessage": "Checking dependencies"
           }

lefthook.yml

@@ -175,56 +175,86 @@ pre-push:
         exit $?
 
     # Manage Docker containers
-    prune-legacy-containers:
-      priority: 1
-      tags: test 
-      run: '(docker container ls --format "{{.ID}}"
-          --filter label=tag=influxdata-docs
-          --filter status=exited | xargs docker rm)
-          || true'
-    build-pytest-image:
+    # Disabled: original task fails when docker is not installed or running.
+    # Replaced by list-legacy-containers below, which exits 0 when docker
+    # is unavailable so the push is not blocked.
+    # prune-legacy-containers:
+    #   priority: 1
+    #   tags: test
+    #   run: '(docker container ls --format "{{.ID}}"
+    #       --filter label=tag=influxdata-docs
+    #       --filter status=exited | xargs docker rm)
+    #       || true'
+    list-legacy-containers:
       tags: test
-      run: yarn build:pytest:image
-
-    # Test code blocks in markdown files
-    cloud-pytest:
-      glob: content/influxdb/cloud/*.md
-      tags: test,codeblocks,v2
-      env:
-        SERVICE: cloud-pytest
-      run: yarn test:codeblocks:cloud '{staged_files}'
-
-    cloud-dedicated-pytest:
-      tags: test,codeblocks,v3
-      glob: content/influxdb3/cloud-dedicated/*.md
       run: |
-        yarn test:codeblocks:cloud-dedicated '{staged_files}' &&
-        ./test/scripts/monitor-tests.sh stop cloud-dedicated-pytest
-
-    cloud-serverless-pytest:
-      tags: test,codeblocks,v3
-      glob: content/influxdb3/cloud-serverless/*.md
-      env:
-        SERVICE: cloud-serverless-pytest
-      run: yarn test:codeblocks:cloud-serverless '{staged_files}'
-
-    clustered-pytest:
-      tags: test,codeblocks,v3
-      glob: content/influxdb3/clustered/*.md
-      run: |
-        yarn test:codeblocks:clustered '{staged_files}' &&
-        ./test/scripts/monitor-tests.sh stop clustered-pytest
-
-    telegraf-pytest:
-      tags: test,codeblocks
-      glob: content/telegraf/*.md
-      env:
-        SERVICE: telegraf-pytest
-      run: yarn test:codeblocks:telegraf '{staged_files}'
+        if ! command -v docker >/dev/null 2>&1; then
+          exit 0
+        fi
+        if ! docker info >/dev/null 2>&1; then
+          exit 0
+        fi
+        legacy=$(docker container ls -a \
+          --format "{{.ID}} {{.Names}}" \
+          --filter label=tag=influxdata-docs \
+          --filter status=exited 2>/dev/null)
+        if [ -n "$legacy" ]; then
+          echo "Note: exited influxdata-docs containers found (push not blocked):"
+          echo "$legacy" | sed 's/^/    /'
+          echo "Prune with: docker container prune --filter label=tag=influxdata-docs"
+        fi
+        exit 0
+    # Disabled: builds the pytest image used by the *-pytest tasks below.
+    # Now that those tasks are disabled, this task is dead weight and fails
+    # when docker is not installed. Run `yarn build:pytest:image` manually
+    # before invoking `yarn test:codeblocks:*` if you need a fresh image.
+    # build-pytest-image:
+    #   tags: test
+    #   run: yarn build:pytest:image
 
-    v2-pytest:
-      tags: test,codeblocks,v2
-      glob: content/influxdb/v2/*.md
-      env:
-        SERVICE: v2-pytest
-      run: yarn test:codeblocks:v2 '{staged_files}'
+    # Test code blocks in markdown files
+    # Disabled: codeblock tests require docker and a configured product
+    # environment. Run them on demand instead:
+    #   yarn test:codeblocks:all
+    #   yarn test:codeblocks:<product>
+    # cloud-pytest:
+    #   glob: content/influxdb/cloud/*.md
+    #   tags: test,codeblocks,v2
+    #   env:
+    #     SERVICE: cloud-pytest
+    #   run: yarn test:codeblocks:cloud '{staged_files}'
+    #
+    # cloud-dedicated-pytest:
+    #   tags: test,codeblocks,v3
+    #   glob: content/influxdb3/cloud-dedicated/*.md
+    #   run: |
+    #     yarn test:codeblocks:cloud-dedicated '{staged_files}' &&
+    #     ./test/scripts/monitor-tests.sh stop cloud-dedicated-pytest
+    #
+    # cloud-serverless-pytest:
+    #   tags: test,codeblocks,v3
+    #   glob: content/influxdb3/cloud-serverless/*.md
+    #   env:
+    #     SERVICE: cloud-serverless-pytest
+    #   run: yarn test:codeblocks:cloud-serverless '{staged_files}'
+    #
+    # clustered-pytest:
+    #   tags: test,codeblocks,v3
+    #   glob: content/influxdb3/clustered/*.md
+    #   run: |
+    #     yarn test:codeblocks:clustered '{staged_files}' &&
+    #     ./test/scripts/monitor-tests.sh stop clustered-pytest
+    #
+    # telegraf-pytest:
+    #   tags: test,codeblocks
+    #   glob: content/telegraf/*.md
+    #   env:
+    #     SERVICE: telegraf-pytest
+    #   run: yarn test:codeblocks:telegraf '{staged_files}'
+    #
+    # v2-pytest:
+    #   tags: test,codeblocks,v2
+    #   glob: content/influxdb/v2/*.md
+    #   env:
+    #     SERVICE: v2-pytest
+    #   run: yarn test:codeblocks:v2 '{staged_files}'