all-for-claudecode 2.0.0 → 2.2.0

package/scripts/afc-subagent-stop.sh

@@ -4,6 +4,9 @@ set -euo pipefail
 # SubagentStop Hook: Log subagent completion/failure results to pipeline log
 # Enables pipeline orchestrator to track task progress
 
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
 # shellcheck disable=SC2329
 cleanup() {
   :
@@ -11,7 +14,6 @@ cleanup() {
 trap cleanup EXIT
 
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
 RESULTS_LOG="$PROJECT_DIR/.claude/.afc-task-results.log"
 
 # Read hook data from stdin
@@ -34,7 +36,7 @@ if [ "$STOP_HOOK_ACTIVE" = "true" ]; then
 fi
 
 # Exit silently if pipeline is inactive
-if [ ! -f "$PIPELINE_FLAG" ]; then
+if ! afc_state_is_active; then
   exit 0
 fi
 

package/scripts/afc-task-completed-gate.sh

@@ -5,60 +5,54 @@ set -euo pipefail
 #
 # Gap fix: "Prompts are not enforcement" -> Physical enforcement via exit 2
 
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
 # trap: Preserve exit code on abnormal termination + stderr message
 # shellcheck disable=SC2329
 cleanup() {
   local exit_code=$?
   if [ "$exit_code" -ne 0 ] && [ "$exit_code" -ne 2 ]; then
-    echo "AFC TASK GATE: Abnormal exit (exit code: $exit_code)" >&2
+    echo "[afc:task-gate] Abnormal exit (code: $exit_code)" >&2
   fi
   exit "$exit_code"
 }
 trap cleanup EXIT
 
-PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-PIPELINE_FLAG="${PROJECT_DIR}/.claude/.afc-active"
-CI_FLAG="${PROJECT_DIR}/.claude/.afc-ci-passed"
-PHASE_FLAG="${PROJECT_DIR}/.claude/.afc-phase"
-
 # Consume stdin (required -- pipe breaks if not consumed)
 cat > /dev/null
 
 # If pipeline is not active -> pass through
-if [ ! -f "$PIPELINE_FLAG" ]; then
+if ! afc_state_is_active; then
   exit 0
 fi
 
-FEATURE="$(head -1 "$PIPELINE_FLAG" | tr -d '\n\r')"
+FEATURE="$(afc_state_read feature || echo '')"
 
-# Check current Phase if phase file exists
-CURRENT_PHASE=""
-if [ -f "$PHASE_FLAG" ]; then
-  CURRENT_PHASE="$(head -1 "$PHASE_FLAG" | tr -d '\n\r')"
-fi
-CURRENT_PHASE="${CURRENT_PHASE:-}"
+# Check current Phase
+CURRENT_PHASE="$(afc_state_read phase || echo '')"
 
-# Spec/Plan/Tasks Phase (1-3) do not require CI -> pass through
-case "${CURRENT_PHASE:-}" in
-  spec|plan|tasks)
-    exit 0
-    ;;
-esac
+# Preparatory phases do not require CI -> pass through
+if afc_is_ci_exempt "${CURRENT_PHASE:-}"; then
+  exit 0
+fi
 
 # Implement/Review/Clean Phase (4-6) require CI to pass
-if [ ! -f "$CI_FLAG" ]; then
-  echo "AFC TASK GATE: CI has not been run. Pipeline '${FEATURE:-unknown}' Phase '${CURRENT_PHASE:-unknown}' requires passing the CI gate. Run your CI command and record the timestamp in .claude/.afc-ci-passed." >&2
+CI_TIME="$(afc_state_read ciPassedAt 2>/dev/null || echo '')"
+CI_TIME="$(printf '%s' "$CI_TIME" | tr -dc '0-9')"
+CI_TIME="${CI_TIME:-0}"
+
+if [ "$CI_TIME" -eq 0 ]; then
+  printf "[afc:task-gate] CI has not been run. Pipeline '%s' Phase '%s' requires CI gate.\n  → Run your CI command to pass the gate\n" "${FEATURE:-unknown}" "${CURRENT_PHASE:-unknown}" >&2
   exit 2
 fi
 
 # Verify CI passed within the last 10 minutes (prevent stale results)
-CI_TIME="$(cat "$CI_FLAG" 2>/dev/null | head -1 | tr -dc '0-9' || true)"
-CI_TIME="${CI_TIME:-0}"
 NOW="$(date +%s)"
 if [ "$CI_TIME" -gt 0 ]; then
   DIFF=$(( NOW - CI_TIME ))
   if [ "$DIFF" -gt 600 ]; then
-    echo "AFC TASK GATE: CI results are stale (${DIFF} seconds ago). Please run your CI command again." >&2
+    printf "[afc:task-gate] CI results are stale (%ss ago).\n  → Run your CI command again\n" "$DIFF" >&2
     exit 2
   fi
 fi

package/scripts/afc-teammate-idle.sh

@@ -5,42 +5,37 @@ set -euo pipefail
 #
 # Gap fix: "Prompts are not enforcement" -> Physical enforcement via exit 2
 
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
 # trap: Preserve exit code on abnormal termination + stderr message
 # shellcheck disable=SC2329
 cleanup() {
   local exit_code=$?
   if [ "$exit_code" -ne 0 ] && [ "$exit_code" -ne 2 ]; then
-    echo "AFC TEAMMATE GATE: Abnormal exit (exit code: $exit_code)" >&2
+    echo "[afc:teammate] Abnormal exit (code: $exit_code)" >&2
   fi
   exit "$exit_code"
 }
 trap cleanup EXIT
 
-PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-PIPELINE_FLAG="${PROJECT_DIR}/.claude/.afc-active"
-PHASE_FLAG="${PROJECT_DIR}/.claude/.afc-phase"
-
 # Consume stdin (required -- pipe breaks if not consumed)
 cat > /dev/null
 
 # If pipeline is not active -> pass through
-if [ ! -f "$PIPELINE_FLAG" ]; then
+if ! afc_state_is_active; then
   exit 0
 fi
 
-FEATURE="$(head -1 "$PIPELINE_FLAG" | tr -d '\n\r')"
+FEATURE="$(afc_state_read feature || echo '')"
 
-# Check current Phase if phase file exists
-CURRENT_PHASE=""
-if [ -f "$PHASE_FLAG" ]; then
-  CURRENT_PHASE="$(head -1 "$PHASE_FLAG" | tr -d '\n\r')"
-fi
-CURRENT_PHASE="${CURRENT_PHASE:-}"
+# Check current Phase
+CURRENT_PHASE="$(afc_state_read phase || echo '')"
 
 # Block idle during implement/review Phase -> force work to continue
 case "${CURRENT_PHASE:-}" in
   implement|review)
-    echo "AFC TEAMMATE GATE: Pipeline '${FEATURE:-unknown}' Phase '${CURRENT_PHASE:-unknown}' is active. Please complete the task." >&2
+    printf "[afc:teammate] Pipeline '%s' Phase '%s' is active.\n  → Complete the current task before going idle\n" "${FEATURE:-unknown}" "${CURRENT_PHASE:-unknown}" >&2
     exit 2
     ;;
   *)

package/scripts/afc-test-pre-gen.sh

@@ -0,0 +1,141 @@
+#!/bin/bash
+set -euo pipefail
+
+# afc-test-pre-gen.sh — Generate ShellSpec test skeletons for testable tasks
+# Reads a tasks.md file, identifies tasks targeting .sh scripts, and generates
+# pending ShellSpec spec files for scripts that lack test coverage.
+#
+# Usage: afc-test-pre-gen.sh <tasks_file> [output_dir]
+#   tasks_file : path to a tasks.md file
+#   output_dir : directory for generated spec files (default: spec/ relative to project root)
+# Exit: 0 = success, 1 = error
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+# shellcheck disable=SC2329
+cleanup() {
+  :
+}
+trap cleanup EXIT
+
+# --- Argument validation ---
+TASKS_FILE="${1:-}"
+if [ -z "$TASKS_FILE" ]; then
+  printf '[afc:test-pre-gen] Usage: %s <tasks_file> [output_dir]\n' "$0" >&2
+  exit 1
+fi
+
+if [ ! -f "$TASKS_FILE" ]; then
+  printf '[afc:test-pre-gen] Error: file not found: %s\n' "$TASKS_FILE" >&2
+  exit 1
+fi
+
+OUTPUT_DIR="${2:-${PROJECT_DIR}/spec}"
+mkdir -p "$OUTPUT_DIR"
+
+# --- Counters ---
+TASKS_ANALYZED=0
+TESTABLE_SH=0
+SKIPPED_NON_SH=0
+ALREADY_EXISTS=0
+GENERATED=0
+GENERATED_FILES=""
+
+# --- Parse tasks ---
+# Match lines like: - [ ] T001 ... `scripts/some-name.sh`
+# Also handles: - [x] T001 ... (checked tasks are still analyzed)
+while IFS= read -r line || [ -n "$line" ]; do
+  # Only match task lines: - [ ] TNNN or - [x] TNNN
+  if ! printf '%s\n' "$line" | grep -qE '^\s*-\s*\[[ xX]\]\s+T[0-9]+'; then
+    continue
+  fi
+
+  TASKS_ANALYZED=$((TASKS_ANALYZED + 1))
+
+  # Extract all backtick-quoted file paths from the line
+  # shellcheck disable=SC2207,SC2016
+  PATHS=($(printf '%s\n' "$line" | grep -oE '`[^`]+`' | tr -d '`'))
+
+  if [ ${#PATHS[@]} -eq 0 ]; then
+    continue
+  fi
+
+  HAS_SH_TARGET=false
+  for fpath in "${PATHS[@]}"; do
+    # Only process .sh files under scripts/
+    case "$fpath" in
+      scripts/*.sh)
+        HAS_SH_TARGET=true
+        TESTABLE_SH=$((TESTABLE_SH + 1))
+
+        # Extract script name from path (e.g., scripts/afc-blast-radius.sh -> afc-blast-radius.sh)
+        SCRIPT_NAME="${fpath##*/}"
+        # Derive spec name (e.g., afc-blast-radius.sh -> afc-blast-radius_spec.sh)
+        SPEC_NAME="${SCRIPT_NAME%.sh}_spec.sh"
+        SPEC_PATH="${OUTPUT_DIR}/${SPEC_NAME}"
+
+        # Check if spec already exists
+        if [ -f "$SPEC_PATH" ]; then
+          ALREADY_EXISTS=$((ALREADY_EXISTS + 1))
+          printf '[afc:test-pre-gen] Skip (exists): %s\n' "$SPEC_NAME" >&2
+          continue
+        fi
+
+        # Generate ShellSpec skeleton
+        cat > "$SPEC_PATH" << SKELETON
+#!/bin/bash
+# shellcheck shell=bash
+# Auto-generated test skeleton for ${SCRIPT_NAME}
+# TODO: Replace Pending examples with real tests
+
+Describe "${SCRIPT_NAME}"
+  setup() {
+    setup_tmpdir TEST_DIR
+  }
+  cleanup() { cleanup_tmpdir "\$TEST_DIR"; }
+  Before "setup"
+  After "cleanup"
+
+  Context "basic usage"
+    It "exits 0 on valid input"
+      Pending "implement test"
+    End
+
+    It "exits 1 on missing arguments"
+      Pending "implement test"
+    End
+  End
+End
+SKELETON
+
+        GENERATED=$((GENERATED + 1))
+        if [ -n "$GENERATED_FILES" ]; then
+          GENERATED_FILES="${GENERATED_FILES}, ${SPEC_NAME}"
+        else
+          GENERATED_FILES="${SPEC_NAME}"
+        fi
+        printf '[afc:test-pre-gen] Generated: %s\n' "$SPEC_NAME" >&2
+        ;;
+      *)
+        # Non-.sh file — counted once per task below
+        ;;
+    esac
+  done
+
+  if [ "$HAS_SH_TARGET" = false ]; then
+    SKIPPED_NON_SH=$((SKIPPED_NON_SH + 1))
+  fi
+done < "$TASKS_FILE"
+
+# --- Summary report ---
+printf 'Test pre-generation:\n'
+printf '  Tasks analyzed: %d\n' "$TASKS_ANALYZED"
+printf '  Testable (.sh): %d\n' "$TESTABLE_SH"
+printf '  Skipped (non-.sh): %d\n' "$SKIPPED_NON_SH"
+printf '  Already exists: %d\n' "$ALREADY_EXISTS"
+printf '  Generated: %d skeletons\n' "$GENERATED"
+if [ -n "$GENERATED_FILES" ]; then
+  printf '  Files: %s\n' "$GENERATED_FILES"
+else
+  printf '  Files: (none)\n'
+fi

package/scripts/afc-timeline-log.sh

@@ -10,6 +10,9 @@ set -euo pipefail
 # message:    human-readable description
 # extra_json_fields: optional JSON object string to merge (e.g. '{"tool":"bash"}')
 
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
 # shellcheck disable=SC2329
 cleanup() {
   :
@@ -36,14 +39,14 @@ fi
 EVENT_TYPE=$(printf '%s' "$EVENT_TYPE" | tr -d '\n\r' | cut -c1-64)
 MESSAGE=$(printf '%s' "$MESSAGE"     | tr -d '\n\r' | cut -c1-500)
 
-# Read pipeline state (gracefully handle missing files)
+# Read pipeline state (gracefully handle missing state)
 FEATURE="none"
 PHASE="none"
-if [ -f "$FLAG_DIR/.afc-active" ]; then
-  FEATURE=$(head -1 "$FLAG_DIR/.afc-active" | tr -d '\n\r' | cut -c1-100)
-fi
-if [ -f "$FLAG_DIR/.afc-phase" ]; then
-  PHASE=$(head -1 "$FLAG_DIR/.afc-phase" | tr -d '\n\r' | cut -c1-64)
+if afc_state_is_active; then
+  FEATURE=$(afc_state_read feature || echo "none")
+  FEATURE=$(printf '%s' "$FEATURE" | cut -c1-100)
+  PHASE=$(afc_state_read phase || echo "none")
+  PHASE=$(printf '%s' "$PHASE" | cut -c1-64)
 fi
 
 # Timestamp (no jq dependency)

package/scripts/afc-user-prompt-submit.sh

@@ -4,30 +4,28 @@ set -euo pipefail
 # UserPromptSubmit Hook: Inject pipeline Phase/Feature context on every prompt
 # Exit 0 immediately if pipeline is inactive (minimize overhead)
 
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
 # shellcheck disable=SC2329
 cleanup() {
   :
 }
 trap cleanup EXIT
 
-PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
-PHASE_FLAG="$PROJECT_DIR/.claude/.afc-phase"
-
 # Consume stdin (required -- pipe breaks if not consumed)
 cat > /dev/null
 
 # Exit silently if pipeline is inactive
-if [ ! -f "$PIPELINE_FLAG" ]; then
+if ! afc_state_is_active; then
   exit 0
 fi
 
 # Read Feature/Phase + JSON-safe processing (strip special characters)
-FEATURE="$(head -1 "$PIPELINE_FLAG" | tr -d '\n\r' | tr -d '"' | cut -c1-100)"
-PHASE="unknown"
-if [ -f "$PHASE_FLAG" ]; then
-  PHASE="$(head -1 "$PHASE_FLAG" | tr -d '\n\r' | tr -d '"' | cut -c1-100)"
-fi
+FEATURE="$(afc_state_read feature || echo '')"
+FEATURE="$(printf '%s' "$FEATURE" | tr -d '"' | cut -c1-100)"
+PHASE="$(afc_state_read phase || echo 'unknown')"
+PHASE="$(printf '%s' "$PHASE" | tr -d '"' | cut -c1-100)"
 
 # Output additionalContext to stdout (injected into Claude context)
 printf '{"hookSpecificOutput":{"additionalContext":"[Pipeline: %s] [Phase: %s]"}}\n' "$FEATURE" "$PHASE"

package/scripts/afc-worktree-create.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+set -euo pipefail
+
+# WorktreeCreate Hook: Inject pipeline context into new worktrees
+# Ensures worker worktrees have access to pipeline state and config
+
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
+# shellcheck disable=SC2329
+cleanup() {
+  :
+}
+trap cleanup EXIT
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+# Read hook data from stdin
+INPUT=$(cat)
+
+# Exit silently if pipeline is inactive
+if ! afc_state_is_active; then
+  exit 0
+fi
+
+# Parse worktree_path from stdin JSON
+WORKTREE_PATH=""
+if command -v jq &>/dev/null; then
+  WORKTREE_PATH=$(printf '%s\n' "$INPUT" | jq -r '.worktree_path // empty' 2>/dev/null || true)
+else
+  WORKTREE_PATH=$(printf '%s\n' "$INPUT" | grep -o '"worktree_path"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*:[[:space:]]*"//;s/"$//' 2>/dev/null || true)
+fi
+
+# Exit if no worktree path provided
+if [ -z "$WORKTREE_PATH" ]; then
+  exit 0
+fi
+
+# Read pipeline state
+FEATURE=$(afc_state_read feature || echo "unknown")
+PHASE=$(afc_state_read phase || echo "unknown")
+
+# Inject pipeline context into worktree
+CONTEXT="[AFC WORKTREE] Feature: $FEATURE | Phase: ${PHASE:-unknown} | Source: $PROJECT_DIR"
+
+# Output as hookSpecificOutput JSON
+if command -v jq &>/dev/null; then
+  jq -n --arg ctx "$CONTEXT" \
+    '{"hookSpecificOutput":{"additionalContext":$ctx}}' 2>/dev/null || true
+else
+  # shellcheck disable=SC1003
+  SAFE_CONTEXT=$(printf '%s' "$CONTEXT" | tr -d '"' | tr -d '\\' | cut -c1-2000)
+  printf '{"hookSpecificOutput":{"additionalContext":"%s"}}\n' "$SAFE_CONTEXT"
+fi
+
+exit 0

package/scripts/afc-worktree-remove.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+set -euo pipefail
+
+# WorktreeRemove Hook: Archive worker results when worktree is removed
+# Ensures task results are preserved in the main project log
+
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
+# shellcheck disable=SC2329
+cleanup() {
+  :
+}
+trap cleanup EXIT
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+RESULTS_LOG="$PROJECT_DIR/.claude/.afc-task-results.log"
+
+# Read hook data from stdin
+INPUT=$(cat)
+
+# Exit silently if pipeline is inactive (also handles race condition on pipeline end)
+if ! afc_state_is_active; then
+  exit 0
+fi
+
+# Parse worktree_path from stdin JSON
+WORKTREE_PATH=""
+if command -v jq &>/dev/null; then
+  WORKTREE_PATH=$(printf '%s\n' "$INPUT" | jq -r '.worktree_path // empty' 2>/dev/null || true)
+else
+  WORKTREE_PATH=$(printf '%s\n' "$INPUT" | grep -o '"worktree_path"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*:[[:space:]]*"//;s/"$//' 2>/dev/null || true)
+fi
+
+# Exit if no worktree path provided
+if [ -z "$WORKTREE_PATH" ]; then
+  exit 0
+fi
+
+# Archive worktree task results to main project
+WORKTREE_RESULTS="$WORKTREE_PATH/.claude/.afc-task-results.log"
+if [ -f "$WORKTREE_RESULTS" ]; then
+  printf '%s\n' "--- worktree: $WORKTREE_PATH ---" >> "$RESULTS_LOG"
+  cat "$WORKTREE_RESULTS" >> "$RESULTS_LOG" 2>/dev/null || true
+fi
+
+exit 0

package/scripts/install-shellspec.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Install ShellSpec locally to vendor/shellspec/
+# Usage: bash scripts/install-shellspec.sh
+set -euo pipefail
+
+trap cleanup EXIT
+cleanup() { :; }
+
+SHELLSPEC_VERSION="0.28.1"
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+VENDOR_DIR="$PROJECT_ROOT/vendor"
+SHELLSPEC_DIR="$VENDOR_DIR/shellspec"
+
+if [ -f "$SHELLSPEC_DIR/shellspec" ]; then
+  printf 'ShellSpec %s already installed at %s\n' "$SHELLSPEC_VERSION" "$SHELLSPEC_DIR"
+  exit 0
+fi
+
+printf 'Installing ShellSpec %s to %s ...\n' "$SHELLSPEC_VERSION" "$SHELLSPEC_DIR"
+
+mkdir -p "$VENDOR_DIR"
+
+TARBALL_URL="https://github.com/shellspec/shellspec/archive/refs/tags/${SHELLSPEC_VERSION}.tar.gz"
+
+if command -v curl >/dev/null 2>&1; then
+  curl -fsSL "$TARBALL_URL" | tar -xzf - -C "$VENDOR_DIR"
+elif command -v wget >/dev/null 2>&1; then
+  wget -qO - "$TARBALL_URL" | tar -xzf - -C "$VENDOR_DIR"
+else
+  printf '[afc] Error: curl or wget is required to install ShellSpec\n' >&2
+  exit 1
+fi
+
+mv "$VENDOR_DIR/shellspec-${SHELLSPEC_VERSION}" "$SHELLSPEC_DIR"
+chmod +x "$SHELLSPEC_DIR/shellspec"
+
+printf 'ShellSpec %s installed successfully at %s\n' "$SHELLSPEC_VERSION" "$SHELLSPEC_DIR"
+printf 'Run tests with: npm test\n'

package/scripts/pre-compact-checkpoint.sh

@@ -5,6 +5,9 @@ set -euo pipefail
 #
 # Gap fix: Enforces OMC auto-state-save via physical script
 
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
 # shellcheck disable=SC2329
 cleanup() {
   # Extend here if temporary file cleanup is needed
@@ -50,10 +53,9 @@ if [ -n "$ALL_STAGED" ]; then
 fi
 
 # Check afc pipeline active status
-PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
 PIPELINE_FEATURE=""
-if [ -f "$PIPELINE_FLAG" ]; then
-  PIPELINE_FEATURE=$(head -1 "$PIPELINE_FLAG" 2>/dev/null | tr -d '\n\r' || true)
+if afc_state_is_active; then
+  PIPELINE_FEATURE=$(afc_state_read feature || true)
 fi
 
 # Check tasks.md progress status
@@ -97,7 +99,7 @@ $MODIFIED_LIST
 $STAGED_LIST
 
 ## Pipeline Status
-- Active: $([ -f "$PIPELINE_FLAG" ] && echo "Yes ($PIPELINE_FEATURE)" || echo "No")
+- Active: $([ -n "$PIPELINE_FEATURE" ] && echo "Yes ($PIPELINE_FEATURE)" || echo "No")
 - Task progress: $TASKS_DONE/$TASKS_TOTAL
 
 ## Restore Command

package/scripts/session-start-context.sh

@@ -6,11 +6,14 @@ set -euo pipefail
 #
 # Gap fix: Enforces OMC session continuity via physical script
 
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
+
 # shellcheck disable=SC2329
 cleanup() {
   local exit_code=$?
   if [ "$exit_code" -ne 0 ]; then
-    echo "[all-for-claudecode] session-start-context.sh exited abnormally" >&2
+    echo "[afc:session] session-start-context.sh exited abnormally" >&2
   fi
   exit "$exit_code"
 }
@@ -26,13 +29,11 @@ PROJECT_PATH=$(cd "$PROJECT_DIR" 2>/dev/null && pwd || echo "$PROJECT_DIR")
 ENCODED_PATH="${PROJECT_PATH//\//-}"
 MEMORY_DIR="$HOME/.claude/projects/$ENCODED_PATH/memory"
 CHECKPOINT="$MEMORY_DIR/checkpoint.md"
-PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
-
 OUTPUT=""
 
 # 1. Check for active pipeline
-if [ -f "$PIPELINE_FLAG" ]; then
-  FEATURE=$(head -1 "$PIPELINE_FLAG" 2>/dev/null | tr -d '\n\r' || true)
+if afc_state_is_active; then
+  FEATURE=$(afc_state_read feature || true)
   OUTPUT="[AFC PIPELINE ACTIVE] Feature: $FEATURE"
 
   # tasks.md progress
@@ -44,9 +45,9 @@ if [ -f "$PIPELINE_FLAG" ]; then
   fi
 
   # CI pass status
-  CI_FLAG="$PROJECT_DIR/.claude/.afc-ci-passed"
-  if [ -f "$CI_FLAG" ]; then
-    OUTPUT="$OUTPUT | Last CI: PASSED ($(cat "$CI_FLAG" 2>/dev/null || true))"
+  CI_TIMESTAMP=$(afc_state_read ciPassedAt 2>/dev/null || true)
+  if [ -n "$CI_TIMESTAMP" ]; then
+    OUTPUT="$OUTPUT | Last CI: PASSED ($CI_TIMESTAMP)"
   fi
 fi
 

package/scripts/track-afc-changes.sh

@@ -4,10 +4,8 @@ set -euo pipefail
 # Record changed files after Edit/Write tool usage
 # Track which files have changed for the CI gate
 
-PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-PIPELINE_FLAG="$PROJECT_DIR/.claude/.afc-active"
-CHANGES_LOG="$PROJECT_DIR/.claude/.afc-changes.log"
-CI_FLAG="$PROJECT_DIR/.claude/.afc-ci-passed"
+# shellcheck source=afc-state.sh
+. "$(dirname "$0")/afc-state.sh"
 
 # shellcheck disable=SC2329
 cleanup() {
@@ -17,7 +15,7 @@ cleanup() {
 trap cleanup EXIT
 
 # If pipeline is inactive -> skip
-if [ ! -f "$PIPELINE_FLAG" ]; then
+if ! afc_state_is_active; then
   exit 0
 fi
 
@@ -37,12 +35,11 @@ else
 fi
 
 if [ -n "$FILE_PATH" ]; then
-  # Append to change log (deduplicate)
-  printf '%s\n' "$FILE_PATH" >> "$CHANGES_LOG"
-  sort -u -o "$CHANGES_LOG" "$CHANGES_LOG"
+  # Append to change log (deduplicate handled by afc_state_append_change)
+  afc_state_append_change "$FILE_PATH"
 
   # Invalidate CI results since a file was changed
-  rm -f "$CI_FLAG"
+  afc_state_invalidate_ci
 fi
 
 exit 0