feat: add CI-gated claude-dev image package

Define claude-dev capabilities as a tested contract and deploy immutable tags only after smoke checks so daily tooling upgrades remain CI-first and rollback-safe.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

claude-dev/Dockerfile

@@ -0,0 +1,60 @@
+FROM node:20-bookworm
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+      bash \
+      ca-certificates \
+      curl \
+      fd-find \
+      gh \
+      git \
+      jq \
+      make \
+      openssh-client \
+      python3 \
+      ripgrep \
+      rsync \
+      unzip \
+      wget \
+      zip \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN ln -sf /usr/bin/fdfind /usr/local/bin/fd
+
+ARG YQ_VERSION=v4.44.6
+RUN wget -q -O /usr/local/bin/yq "https://github.com/mikefarah/yq/releases/download/${YQ_VERSION}/yq_linux_amd64" \
+    && chmod +x /usr/local/bin/yq
+
+RUN npm install -g @anthropic-ai/claude-code
+
+RUN python3 - <<'PY'
+from pathlib import Path
+
+path = Path("/usr/local/lib/node_modules/@anthropic-ai/claude-code/cli.js")
+if not path.exists():
+    raise SystemExit(f"claude cli not found: {path}")
+
+content = path.read_text()
+old = 'F8.get("https://api.anthropic.com/api/hello",{headers:K8($)}).catch((()=>!1))'
+if old not in content:
+    raise SystemExit("preflight patch target not found in claude cli; refusing to build")
+
+patched = content.replace(old, "!0")
+path.write_text(patched)
+
+if old in path.read_text():
+    raise SystemExit("preflight patch did not apply cleanly")
+
+print("Applied Claude preflight bypass patch")
+PY
+
+WORKDIR /repos/nas-tools
+
+COPY required-tools.txt /opt/claude-dev/required-tools.txt
+COPY scripts /opt/claude-dev/scripts
+
+RUN chmod +x /opt/claude-dev/scripts/*.sh
+
+CMD ["bash"]

claude-dev/docker-compose.yml

@@ -0,0 +1,15 @@
+services:
+  claude-dev:
+    image: claude-dev:${CLAUDE_DEV_IMAGE_TAG:?CLAUDE_DEV_IMAGE_TAG is required}
+    container_name: claude-dev
+    restart: unless-stopped
+    network_mode: host
+    stdin_open: true
+    tty: true
+    working_dir: /repos/nas-tools
+    volumes:
+      - /volume1/repos:/repos
+      - /volume1/docker/claude-dev/claude-config:/root/.claude
+      - /volume1/docker/claude-dev/claude-config/.claude.json:/root/.claude.json
+      - /volume1/docker/claude-dev/gitea_token:/root/.gitea_token:ro
+      - /volume1/docker/claude-dev/bashrc:/root/.bashrc

claude-dev/required-tools.txt

@@ -0,0 +1,16 @@
+gh
+git
+jq
+yq
+curl
+wget
+python3
+node
+npm
+rg
+fd
+rsync
+zip
+unzip
+make
+claude

claude-dev/scripts/smoke-auth.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+require_mounts="${REQUIRE_MOUNTS:-0}"
+
+auth_ok=true
+
+check_required_file() {
+  local path="$1"
+  if [[ ! -e "$path" ]]; then
+    echo "Missing required mounted path: $path" >&2
+    auth_ok=false
+    return
+  fi
+  if [[ ! -r "$path" ]]; then
+    echo "Path is not readable: $path" >&2
+    auth_ok=false
+    return
+  fi
+  if [[ -f "$path" ]] && [[ ! -s "$path" ]]; then
+    echo "Path is empty: $path" >&2
+    auth_ok=false
+    return
+  fi
+  echo "Verified mounted path: $path"
+}
+
+if [[ "$require_mounts" == "1" ]]; then
+  check_required_file "/root/.claude"
+  check_required_file "/root/.claude.json"
+  check_required_file "/root/.gitea_token"
+
+  if [[ -f "/root/.claude/.git-credentials" ]]; then
+    echo "Verified mounted path: /root/.claude/.git-credentials"
+  else
+    echo "Missing expected git credentials file: /root/.claude/.git-credentials" >&2
+    auth_ok=false
+  fi
+fi
+
+if [[ -n "${GH_TOKEN:-}" ]]; then
+  if GH_TOKEN="$GH_TOKEN" gh auth status >/dev/null 2>&1; then
+    echo "gh auth status succeeded with GH_TOKEN"
+  else
+    echo "gh auth status failed with GH_TOKEN provided" >&2
+    auth_ok=false
+  fi
+else
+  if gh auth status >/dev/null 2>&1; then
+    echo "gh auth status succeeded using persisted auth"
+  else
+    echo "gh auth status not configured (allowed without GH_TOKEN)"
+  fi
+fi
+
+if [[ "$auth_ok" != "true" ]]; then
+  exit 1
+fi
+
+echo "Auth/config smoke checks passed"

claude-dev/scripts/smoke-network.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+check_http_status() {
+  local url="$1"
+  local allowed_regex="$2"
+
+  local code
+  code=$(curl -sS -o /dev/null -m 10 -w "%{http_code}" "$url")
+  if [[ ! "$code" =~ $allowed_regex ]]; then
+    echo "Unexpected HTTP status from $url: $code" >&2
+    return 1
+  fi
+  echo "$url => HTTP $code"
+}
+
+if ! getent hosts api.bytecatcode.org >/dev/null 2>&1; then
+  echo "DNS lookup failed for api.bytecatcode.org" >&2
+  exit 1
+fi
+
+echo "DNS lookup passed for api.bytecatcode.org"
+
+check_http_status "https://api.bytecatcode.org" '^(200|301|302|400|401|403|404)$'
+check_http_status "http://127.0.0.1:3300" '^(200|301|302|401|403|404)$'
+
+echo "Network smoke checks passed"

claude-dev/scripts/smoke-tools.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TOOLS_FILE="${1:-/opt/claude-dev/required-tools.txt}"
+
+if [[ ! -f "$TOOLS_FILE" ]]; then
+  echo "required tools file not found: $TOOLS_FILE" >&2
+  exit 1
+fi
+
+missing=()
+while IFS= read -r tool; do
+  [[ -z "$tool" ]] && continue
+  [[ "$tool" =~ ^# ]] && continue
+  if ! command -v "$tool" >/dev/null 2>&1; then
+    missing+=("$tool")
+  fi
+done < "$TOOLS_FILE"
+
+if (( ${#missing[@]} > 0 )); then
+  echo "Missing required tools:" >&2
+  printf ' - %s\n' "${missing[@]}" >&2
+  exit 1
+fi
+
+echo "All required tools are present"

claude-dev/target-tag.txt

@@ -0,0 +1 @@
+auto