codeforge-dev 1.5.0 → 1.5.1

package/.devcontainer/.env

@@ -17,6 +17,9 @@ SETUP_ALIASES=true
 # Setup: install official Anthropic plugins
 SETUP_PLUGINS=true
 
+# Setup: auto-update Claude Code CLI to latest on container start (runs in background)
+SETUP_UPDATE_CLAUDE=true
+
 # Plugin blacklist (comma-separated plugin names to skip during auto-install)
 # Example: PLUGIN_BLACKLIST="workflow-enhancer,auto-formatter"
-PLUGIN_BLACKLIST="workflow-enhancer"
+PLUGIN_BLACKLIST="workflow-enhancer,planning-reminder"

package/.devcontainer/CHANGELOG.md

@@ -16,6 +16,10 @@
   - Creates `claude-teams` session on container start
 - **Biome feature**: Fast JS/TS/JSON/CSS formatter via global `@biomejs/biome` install
 - **External terminal connectors**: Bash (`.sh`) and PowerShell (`.ps1`) scripts to connect host terminals to devcontainer tmux sessions
+- **Claude Code auto-update**: `setup-update-claude.sh` checks for newer Claude Code native binary on every container start
+  - Runs non-blocking in background via `setup.sh`
+  - Downloads from GCS, verifies SHA256 checksum, atomic binary replacement
+  - Controlled by `SETUP_UPDATE_CLAUDE` env var in `.env` (default: `true`)
 
 #### Plugins
 - **code-directive plugin**: Replaces `codedirective-skills` with expanded hook infrastructure
@@ -32,6 +36,7 @@
 - **Default model**: Claude Opus 4-5 → **Claude Opus 4-6** (frontier)
 - **Max output tokens**: 64,000 → **128,000**
 - **Container memory**: 3GB → **4GB** (`--memory-swap` raised to 8GB)
+- **External terminal connectors**: Now run as `vscode` user and auto-launch `cc` on new tmux sessions
 - **Auto-formatter**: Switched from PostToolUse (`format-file.py`) to Stop hook (`format-on-stop.py`)
   - Added Biome support for JS/TS/CSS alongside existing Black and gofmt
   - Batch-formats all edited files when Claude stops instead of formatting on every edit

package/.devcontainer/connect-external-terminal.ps1

@@ -72,6 +72,15 @@ Write-Host ""
 Write-Host "======================================"
 Write-Host ""
 
-# Connect to container with tmux
-# -A attaches to existing session or creates new one
-docker exec -it $CONTAINER_ID tmux new-session -A -s $TMUX_SESSION
+# Connect to container with tmux as vscode user (where aliases are defined)
+# If session exists, reattach. Otherwise create in /workspaces and auto-run cc.
+docker exec -it --user vscode $CONTAINER_ID bash -c "
+  if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
+    tmux attach-session -t '$TMUX_SESSION'
+  else
+    tmux new-session -d -s '$TMUX_SESSION' -c /workspaces
+    sleep 0.5
+    tmux send-keys -t '$TMUX_SESSION' 'cc' Enter
+    tmux attach-session -t '$TMUX_SESSION'
+  fi
+"

package/.devcontainer/connect-external-terminal.sh

@@ -64,6 +64,15 @@ echo ""
 echo "======================================"
 echo ""
 
-# Connect to container with tmux
-# -A attaches to existing session or creates new one
-exec docker exec -it "$CONTAINER_ID" tmux new-session -A -s "$TMUX_SESSION"
+# Connect to container with tmux as vscode user (where aliases are defined)
+# If session exists, reattach. Otherwise create in /workspaces and auto-run cc.
+exec docker exec -it --user vscode "$CONTAINER_ID" bash -c "
+  if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
+    tmux attach-session -t '$TMUX_SESSION'
+  else
+    tmux new-session -d -s '$TMUX_SESSION' -c /workspaces
+    sleep 0.5
+    tmux send-keys -t '$TMUX_SESSION' 'cc' Enter
+    tmux attach-session -t '$TMUX_SESSION'
+  fi
+"

package/.devcontainer/scripts/setup-update-claude.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+# Update Claude Code CLI to the latest version (native binary only)
+# Runs non-blocking in background by default via setup.sh
+# All failures are warnings — this script never blocks container startup
+
+echo "[update-claude] Checking for Claude Code updates..."
+
+# === CLEANUP TRAP ===
+cleanup() {
+    rm -f /tmp/claude-update 2>/dev/null || true
+    rm -f /tmp/claude-update-manifest.json 2>/dev/null || true
+}
+trap cleanup EXIT
+
+# === VERIFY CLAUDE IS INSTALLED ===
+if ! command -v claude &>/dev/null; then
+    echo "[update-claude] Claude Code not found, skipping update"
+    exit 0
+fi
+
+# === DETECT INSTALL METHOD ===
+CLAUDE_PATH=$(command -v claude)
+if [[ "$CLAUDE_PATH" != "/usr/local/bin/claude" ]]; then
+    echo "[update-claude] Non-native install detected ($CLAUDE_PATH), skipping"
+    exit 0
+fi
+
+# === VALIDATE DEPENDENCIES ===
+for dep in curl jq sha256sum sudo; do
+    if ! command -v "$dep" &>/dev/null; then
+        echo "[update-claude] WARNING: $dep not available, skipping update"
+        exit 0
+    fi
+done
+
+# === GET CURRENT VERSION ===
+CURRENT_VERSION=$(claude --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "unknown")
+echo "[update-claude] Current version: ${CURRENT_VERSION}"
+
+# === FETCH LATEST VERSION ===
+BASE_URL="https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases"
+
+LATEST_VERSION=$(curl -fsSL "${BASE_URL}/stable" 2>/dev/null)
+if [ -z "$LATEST_VERSION" ]; then
+    echo "[update-claude] WARNING: Failed to fetch latest version, skipping"
+    exit 0
+fi
+
+echo "[update-claude] Latest version: ${LATEST_VERSION}"
+
+# === COMPARE VERSIONS ===
+if [ "$CURRENT_VERSION" = "$LATEST_VERSION" ]; then
+    echo "[update-claude] Already up to date (${CURRENT_VERSION})"
+    exit 0
+fi
+
+echo "[update-claude] Updating from ${CURRENT_VERSION} to ${LATEST_VERSION}..."
+
+# === DETECT PLATFORM ===
+ARCH=$(uname -m)
+case "${ARCH}" in
+    x86_64)
+        PLATFORM="linux-x64"
+        ;;
+    aarch64|arm64)
+        PLATFORM="linux-arm64"
+        ;;
+    *)
+        echo "[update-claude] WARNING: Unsupported architecture: ${ARCH}, skipping"
+        exit 0
+        ;;
+esac
+
+# Detect musl (Alpine Linux)
+if ldd --version 2>&1 | grep -qi musl; then
+    PLATFORM="${PLATFORM}-musl"
+fi
+
+echo "[update-claude] Platform: ${PLATFORM}"
+
+# === DOWNLOAD MANIFEST ===
+MANIFEST_URL="${BASE_URL}/${LATEST_VERSION}/manifest.json"
+
+if ! curl -fsSL "${MANIFEST_URL}" -o /tmp/claude-update-manifest.json 2>/dev/null; then
+    echo "[update-claude] WARNING: Failed to download manifest, skipping"
+    exit 0
+fi
+
+# === EXTRACT AND VERIFY CHECKSUM ===
+EXPECTED_CHECKSUM=$(jq -r ".platforms.\"${PLATFORM}\".checksum" /tmp/claude-update-manifest.json)
+if [ -z "${EXPECTED_CHECKSUM}" ] || [ "${EXPECTED_CHECKSUM}" = "null" ]; then
+    echo "[update-claude] WARNING: Platform ${PLATFORM} not found in manifest, skipping"
+    exit 0
+fi
+
+# === DOWNLOAD BINARY ===
+BINARY_URL="${BASE_URL}/${LATEST_VERSION}/${PLATFORM}/claude"
+
+if ! curl -fsSL "${BINARY_URL}" -o /tmp/claude-update 2>/dev/null; then
+    echo "[update-claude] WARNING: Failed to download binary, skipping"
+    exit 0
+fi
+
+# === VERIFY CHECKSUM ===
+ACTUAL_CHECKSUM=$(sha256sum /tmp/claude-update | cut -d' ' -f1)
+
+if [ "${ACTUAL_CHECKSUM}" != "${EXPECTED_CHECKSUM}" ]; then
+    echo "[update-claude] WARNING: Checksum verification failed, skipping"
+    echo "[update-claude]   Expected: ${EXPECTED_CHECKSUM}"
+    echo "[update-claude]   Actual:   ${ACTUAL_CHECKSUM}"
+    exit 0
+fi
+
+# === INSTALL (atomic replace) ===
+chmod +x /tmp/claude-update
+if ! sudo mv /tmp/claude-update /usr/local/bin/claude; then
+    echo "[update-claude] WARNING: Failed to install update (sudo mv failed), skipping"
+    exit 0
+fi
+
+# === VERIFY UPDATE ===
+INSTALLED_VERSION=$(claude --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "unknown")
+echo "[update-claude] Updated Claude Code: ${CURRENT_VERSION} → ${INSTALLED_VERSION}"

package/.devcontainer/scripts/setup.sh

@@ -21,8 +21,9 @@ fi
 : "${SETUP_ALIASES:=true}"
 : "${OVERWRITE_CONFIG:=false}"
 : "${SETUP_PLUGINS:=true}"
+: "${SETUP_UPDATE_CLAUDE:=true}"
 
-export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES OVERWRITE_CONFIG SETUP_PLUGINS
+export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES OVERWRITE_CONFIG SETUP_PLUGINS SETUP_UPDATE_CLAUDE
 
 
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
@@ -53,6 +54,17 @@ run_script "$SCRIPT_DIR/setup-aliases.sh" "$SETUP_ALIASES"
 run_script "$SCRIPT_DIR/setup-plugins.sh" "$SETUP_PLUGINS"
 run_script "$SCRIPT_DIR/setup-irie-claude.sh" "true"
 
+# Non-blocking: check for Claude Code updates in background
+if [ "$SETUP_UPDATE_CLAUDE" = "true" ]; then
+    if [ -f "$SCRIPT_DIR/setup-update-claude.sh" ]; then
+        echo "Running setup-update-claude (background)..."
+        bash "$SCRIPT_DIR/setup-update-claude.sh" &
+        disown
+    fi
+else
+    echo "Skipping setup-update-claude (disabled)"
+fi
+
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "  Setup Complete"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeforge-dev",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Complete development container that sets up Claude Code with modular devcontainer features, modern dev tools, and persistent configurations. Drop it into any project and get a production-ready AI development environment in minutes.",
   "main": "setup.js",
   "bin": {