cc-session-recover 0.1.0

package/scripts/test-fake-quota-flow.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+
+# End-to-end test of the quota-recovery flow in a throwaway dummy repo.
+#
+# No real quota is touched. It fakes:
+#   - a SessionStart event, to prove the standing instructions get injected
+#   - a rate_limit StopFailure event, to prove the hook logs and writes the marker
+#   - the claude CLI itself, failing twice (quota blocked) then succeeding
+#     (quota reset), to prove the watcher retries and resumes the right session
+
+set -eu
+
+TEMPLATE_ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+WORK=$(mktemp -d)
+DUMMY="$WORK/dummy-repo"
+BIN="$WORK/bin"
+PASS=0
+
+cleanup() {
+  [ -n "${WATCHER_PID:-}" ] && kill "$WATCHER_PID" 2>/dev/null
+  rm -rf "$WORK"
+
+  if [ "$PASS" -eq 1 ]; then
+    printf '\nAll fake-quota flow tests passed.\n'
+  else
+    printf '\nFAKE-QUOTA FLOW TEST FAILED.\n' >&2
+  fi
+}
+trap cleanup EXIT
+
+fail() {
+  printf 'FAIL: %s\n' "$1" >&2
+  exit 1
+}
+
+step() {
+  printf '\n== %s\n' "$1"
+}
+
+step "Create dummy repo and install template"
+mkdir -p "$DUMMY"
+git -C "$DUMMY" init -q
+bash "$TEMPLATE_ROOT/scripts/install-into-project.sh" --enable-local-hook "$DUMMY" >/dev/null
+[ -f "$DUMMY/.claude/settings.local.json" ] || fail "hook settings not installed"
+
+step "Fake SessionStart: standing instructions should be injected"
+INJECTED=$(printf '{"session_id":"fake-session-123","hook_event_name":"SessionStart","source":"startup"}' \
+  | CLAUDE_PROJECT_DIR="$DUMMY" bash "$DUMMY/.claude/hooks/inject-standing-instructions.sh")
+printf '%s\n' "$INJECTED" | grep -Fq "auto-continue.md" || fail "injection missing heartbeat instruction"
+printf '%s\n' "$INJECTED" | grep -Fq "HANDOFF.md" || fail "injection missing handoff instruction"
+printf 'ok: SessionStart hook printed the standing instructions\n'
+
+step "Fake status line input: reset time should be cached"
+printf '{"workspace":{"project_dir":"%s"},"model":{"display_name":"Test"},"rate_limits":{"five_hour":{"used_percentage":97,"resets_at":%s}}}' \
+  "$DUMMY" "$(( $(date +%s) + 4 ))" \
+  | bash "$DUMMY/.claude/statusline-quota-cache.sh" >/dev/null
+[ -f "$DUMMY/.claude/rate-limit-state.json" ] || fail "status line wrapper did not cache rate-limit state"
+printf 'ok: status line wrapper cached the reset time\n'
+
+step "Fake quota stop: StopFailure(rate_limit) should log and write the marker"
+printf '{"session_id":"fake-session-123","hook_event_name":"StopFailure","error_type":"rate_limit"}' \
+  | CLAUDE_PROJECT_DIR="$DUMMY" bash "$DUMMY/.claude/hooks/log-stop-failure.sh"
+[ -f "$DUMMY/.claude/stop-failure-events.jsonl" ] || fail "missing stop-failure log"
+[ -f "$DUMMY/.claude/quota-blocked.json" ] || fail "missing quota-blocked marker"
+grep -Fq "hit a rate limit" "$DUMMY/HANDOFF.md" || fail "missing handoff note"
+SESSION=$(jq -r '.hook_input.session_id // empty' "$DUMMY/.claude/quota-blocked.json")
+[ "$SESSION" = "fake-session-123" ] || fail "marker has wrong session_id: $SESSION"
+RESETS=$(jq -r '.rate_limit_state.five_hour_resets_at // empty' "$DUMMY/.claude/quota-blocked.json")
+[ -n "$RESETS" ] || fail "marker missing cached reset time"
+printf 'ok: hook wrote log, handoff note, and marker with session_id and reset time\n'
+
+step "Fake claude CLI: fails twice (blocked), succeeds on third try (reset)"
+mkdir -p "$BIN"
+cat > "$BIN/claude" <<EOF
+#!/usr/bin/env bash
+COUNT_FILE="$WORK/claude-call-count"
+CALLS=\$(cat "\$COUNT_FILE" 2>/dev/null || echo 0)
+CALLS=\$((CALLS + 1))
+echo "\$CALLS" > "\$COUNT_FILE"
+printf '%s\n' "\$*" >> "$WORK/claude-calls.log"
+if [ "\$CALLS" -lt 3 ]; then
+  echo "Limit reached. Resets later." >&2
+  exit 1
+fi
+echo "Resumed and continued the task."
+exit 0
+EOF
+chmod +x "$BIN/claude"
+
+step "Run the watcher against the fake CLI"
+QUOTA_WATCH_INTERVAL=1 QUOTA_RESUME_BUFFER=1 PATH="$BIN:$PATH" \
+  bash "$DUMMY/scripts/quota-watcher.sh" "$DUMMY" >"$WORK/watcher.log" 2>&1 &
+WATCHER_PID=$!
+disown "$WATCHER_PID" 2>/dev/null || true
+
+for _ in $(seq 1 30); do
+  [ ! -f "$DUMMY/.claude/quota-blocked.json" ] && break
+  sleep 1
+done
+
+[ ! -f "$DUMMY/.claude/quota-blocked.json" ] || fail "watcher never cleared the marker"
+CALLS=$(cat "$WORK/claude-call-count")
+[ "$CALLS" -eq 3 ] || fail "expected 3 claude calls (2 blocked + 1 success), got $CALLS"
+grep -Fq -- "-p --resume fake-session-123" "$WORK/claude-calls.log" || fail "watcher did not resume the recorded session"
+grep -Fq "HANDOFF.md" "$WORK/claude-calls.log" || fail "watcher did not pass the auto-continue prompt"
+grep -Fq "sleeping until" "$WORK/watcher.log" || fail "watcher did not use the cached reset time for a precise knock"
+printf 'ok: watcher slept to the known reset time, retried while blocked, resumed the exact session, cleared the marker\n'
+
+PASS=1

package/scripts/verify-claude-loop-workflow.sh

@@ -0,0 +1,102 @@
+#!/usr/bin/env bash
+
+set -u
+
+ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+
+fail() {
+  printf 'FAIL: %s\n' "$1" >&2
+  exit 1
+}
+
+require_file() {
+  [ -f "$ROOT/$1" ] || fail "missing $1"
+}
+
+require_text() {
+  file=$1
+  text=$2
+
+  grep -Fqi -- "$text" "$ROOT/$file" || fail "$file must mention: $text"
+}
+
+require_file ".claude/loop.md"
+require_file ".claude/auto-continue.md"
+require_file "HANDOFF.md"
+require_file ".claude/settings.example.json"
+require_file ".claude/hooks/log-stop-failure.sh"
+require_file ".claude/hooks/inject-standing-instructions.sh"
+require_file ".claude/standing-instructions.md"
+require_file "scripts/test-fake-quota-flow.sh"
+require_file "README.md"
+require_file "docs/claude-code-auto-resume.md"
+require_file "docs/verified-quota-resume-example.md"
+require_file "scripts/install-into-project.sh"
+require_file "scripts/quota-watcher.sh"
+require_file "package.json"
+require_file "bin/cli.js"
+require_file "LICENSE"
+
+require_text ".claude/loop.md" "HANDOFF.md"
+require_text ".claude/loop.md" "git status --short"
+require_text ".claude/loop.md" "one small safe step"
+require_text ".claude/loop.md" "update HANDOFF.md"
+require_text ".claude/loop.md" "stop"
+
+require_text ".claude/auto-continue.md" "HANDOFF.md"
+require_text ".claude/auto-continue.md" "git status --short"
+require_text ".claude/auto-continue.md" "remaining checklist"
+require_text ".claude/auto-continue.md" "safe to fire at any time"
+require_text ".claude/auto-continue.md" "Cancel this recurring schedule"
+
+require_text "docs/claude-code-auto-resume.md" "one-time reminder"
+require_text "docs/claude-code-auto-resume.md" "auto-continue.md"
+require_text "docs/claude-code-auto-resume.md" "heartbeat"
+require_text "docs/claude-code-auto-resume.md" "claude"
+require_text "docs/claude-code-auto-resume.md" "quota or rate limit"
+require_text "docs/claude-code-auto-resume.md" "does not bypass quota"
+require_text "docs/claude-code-auto-resume.md" "terminal must stay open"
+require_text "docs/claude-code-auto-resume.md" "rate_limits.five_hour.resets_at"
+require_text "docs/claude-code-auto-resume.md" "StopFailure"
+require_text "docs/claude-code-auto-resume.md" "Do not use"
+require_text "docs/claude-code-auto-resume.md" "/loop 1m"
+
+require_text "docs/verified-quota-resume-example.md" "02:25"
+require_text "docs/verified-quota-resume-example.md" "one-time reminder"
+require_text "docs/verified-quota-resume-example.md" "git status --short"
+require_text "docs/verified-quota-resume-example.md" "Do not use"
+require_text "docs/verified-quota-resume-example.md" "/loop 1m"
+
+require_text "README.md" "install-into-project.sh"
+require_text "README.md" "one-time reminder"
+require_text "README.md" "not bypass quota"
+
+require_text ".claude/settings.example.json" "SessionStart"
+require_text ".claude/settings.example.json" "inject-standing-instructions.sh"
+require_text ".claude/standing-instructions.md" "auto-continue.md"
+require_text ".claude/standing-instructions.md" "HANDOFF.md"
+require_text ".claude/settings.example.json" "StopFailure"
+require_text ".claude/settings.example.json" "rate_limit"
+require_text ".claude/settings.example.json" "log-stop-failure.sh"
+
+require_text ".claude/hooks/log-stop-failure.sh" "stop-failure-events.jsonl"
+require_text ".claude/hooks/log-stop-failure.sh" "cannot schedule"
+require_text ".claude/hooks/log-stop-failure.sh" "quota-blocked.json"
+
+require_text "scripts/quota-watcher.sh" "quota-blocked.json"
+require_text "scripts/quota-watcher.sh" "auto-continue.md"
+require_text "scripts/quota-watcher.sh" "session_id"
+
+[ -x "$ROOT/.claude/hooks/log-stop-failure.sh" ] || fail ".claude/hooks/log-stop-failure.sh must be executable"
+[ -x "$ROOT/scripts/install-into-project.sh" ] || fail "scripts/install-into-project.sh must be executable"
+[ -x "$ROOT/scripts/quota-watcher.sh" ] || fail "scripts/quota-watcher.sh must be executable"
+[ -x "$ROOT/.claude/hooks/inject-standing-instructions.sh" ] || fail ".claude/hooks/inject-standing-instructions.sh must be executable"
+[ -x "$ROOT/scripts/test-fake-quota-flow.sh" ] || fail "scripts/test-fake-quota-flow.sh must be executable"
+
+for forbidden in "claude -p" "tmux" "screen" "expect" "TIOCSTI"; do
+  if grep -Fqi -- "$forbidden" "$ROOT/.claude/loop.md" "$ROOT/.claude/auto-continue.md" "$ROOT/HANDOFF.md"; then
+    fail "runtime workflow must not require $forbidden"
+  fi
+done
+
+printf 'All Claude Code loop workflow checks passed.\n'