From e89750d302f4e49ddf67cb6f2c1d903eb67c2730 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 10 Nov 2026 21:53:16 +0000 Subject: [PATCH] Install Composer dependencies with a SessionStart hook in cloud sessions In Claude Code cloud sessions, anonymous requests to api.github.com hit the rate limit (HTTP 403). Composer then falls back to slow git clones for every package, and phpstan/phpstan, which has no git source, can't be installed. The hook resolves composer.lock from the Packagist metadata, builds each GitHub dist zip with a shallow git fetch and git archive (git through the session proxy isn't limited), puts the zips into Composer's cache, and runs composer install. From an empty cache it finishes in about 20 seconds. It runs only in cloud sessions and skips the install while composer.json and the script are unchanged. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01FxhC1Cr7rZzUgw16qS4vNV --- .claude/hooks/session-start.sh | 70 ++++++++++++++++++++++++++++++++++ .claude/settings.json | 14 +++++++ AGENTS.md | 5 +++ 3 files changed, 89 insertions(+) create mode 100755 .claude/hooks/session-start.sh create mode 100644 .claude/settings.json diff --git a/.claude/hooks/session-start.sh b/.claude/hooks/session-start.sh new file mode 100755 index 0000000..45d67e5 --- /dev/null +++ b/.claude/hooks/session-start.sh @@ -0,0 +1,70 @@ +#!/bin/bash +# Installs the Composer dependencies at the start of a Claude Code cloud session. +# +# In cloud sessions, anonymous requests to api.github.com hit the rate limit (HTTP 403). Composer then falls back +# to slow full git clones for every package, and phpstan/phpstan (distributed without a git source) cannot be +# installed at all. Git fetches through the session proxy are not limited, so this script builds the dist zips with +# `git fetch --depth=1` + `git archive` and puts them into Composer's cache before `composer install` runs. +set -euo pipefail + +if [ "${CLAUDE_CODE_REMOTE:-}" != "true" ]; then + exit 0 +fi + +cd "${CLAUDE_PROJECT_DIR:-.}" + +# The sandbox runs as root: Composer skips plugins (phpstan/extension-installer) without this variable +if [ "$(id -u)" = "0" ]; then + export COMPOSER_ALLOW_SUPERUSER=1 + if [ -n "${CLAUDE_ENV_FILE:-}" ]; then + echo 'export COMPOSER_ALLOW_SUPERUSER=1' >> "$CLAUDE_ENV_FILE" + fi +fi +export COMPOSER_PROCESS_TIMEOUT=1800 + +# Writes the dist zip of one locked package into Composer's cache, as Composer would after downloading it +seed_package() { + local cache_file=$1 repo=$2 ref=$3 work + if [ -s "$cache_file" ]; then + return 0 + fi + work=$(mktemp -d) + if git -C "$work" init -q \ + && git -C "$work" fetch -q --depth=1 "https://github.com/$repo.git" "$ref" \ + && mkdir -p "$(dirname "$cache_file")" \ + && git -C "$work" archive --format=zip --prefix=package/ -o "$cache_file.tmp" FETCH_HEAD; then + mv "$cache_file.tmp" "$cache_file" + else + # Composer downloads this package itself + rm -f "$cache_file.tmp" + echo "session-start: could not prefetch $repo@$ref" >&2 + fi + rm -rf "$work" +} +export -f seed_package + +# Run the install only if this script or composer.json changed since the install last succeeded +hashes=vendor/.session-start.sha256 +if ! sha256sum --check --status "$hashes" 2>/dev/null; then + # Delete the old hashes first, so a failed install runs again next time + rm -f "$hashes" + + # composer.lock is not committed: resolve it from the Packagist metadata, which is not rate limited + composer update --no-install --no-interaction --no-progress + + cache_dir=$(composer config cache-files-dir) + php -r ' + $lock = json_decode(file_get_contents("composer.lock"), true, 512, JSON_THROW_ON_ERROR); + foreach ([...$lock["packages"], ...$lock["packages-dev"]] as $package) { + $url = $package["dist"]["url"] ?? ""; + if (preg_match("~^https://api\.github\.com/repos/([^/]+/[^/]+)/zipball/([0-9a-f]{40})$~", $url, $m) === 1) { + // Cache file name used by Composer: /sha1().zip + echo $argv[1], "/", $package["name"], "/", sha1($url), ".zip ", $m[1], " ", $m[2], "\n"; + } + } + ' "$cache_dir" | xargs -P 8 -L 1 bash -c 'seed_package "$@"' _ + + composer install --no-interaction --no-progress + + sha256sum .claude/hooks/session-start.sh composer.json > "$hashes" +fi diff --git a/.claude/settings.json b/.claude/settings.json new file mode 100644 index 0000000..265a5b6 --- /dev/null +++ b/.claude/settings.json @@ -0,0 +1,14 @@ +{ + "hooks": { + "SessionStart": [ + { + "hooks": [ + { + "type": "command", + "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/session-start.sh" + } + ] + } + ] + } +} diff --git a/AGENTS.md b/AGENTS.md index 49324be..955a3b5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -27,6 +27,11 @@ composer phpunit # unit and functional test suites composer demo # runs demo/run.php, a smoke test of real weaving ``` +In Claude Code cloud sessions, the SessionStart hook `.claude/hooks/session-start.sh` runs `composer install` before +the session starts. Anonymous downloads from api.github.com are rate limited there (HTTP 403, and phpstan/phpstan has +no git source to fall back to), so the hook builds the dist zips with `git fetch` and seeds Composer's cache first. +Don't run a second `composer install` while it works; run `composer` as root with `COMPOSER_ALLOW_SUPERUSER=1`. + Run `composer test` before you commit. All three checks must pass. CI (`.github/workflows/ci.yml`) also runs a lowest-dependencies job and `composer audit`.