timsquad 3.5.0 → 3.6.0

package/templates/base/timsquad/ssot-map.template.yaml

@@ -0,0 +1,41 @@
+# SSOT Map — 티어별 문서 주입 기준
+# Tier 0: 모든 작업에 항상 주입 (Hook → systemMessage)
+# Tier 1: Phase 시작 시 Controller가 주입
+# Tier 2: Sequence 범위 문서 (Controller가 선택 주입)
+# Tier 3: 개별 Task에 필요한 구체 spec (Controller가 선택 주입)
+
+tier-0-always:
+  description: "모든 작업에 항상 주입되는 제약 문서"
+  inject_via: hook
+  documents:
+    - compiled: rules/security-constraints.md
+      source: security-spec.md
+    - compiled: rules/completion-criteria.md
+      source: requirements.md
+
+tier-1-phase:
+  description: "Phase 시작 시 controller가 주입하는 방향성 문서"
+  inject_via: controller
+  documents:
+    - compiled: references/prd-summary.spec.md
+      source: prd.md
+    - compiled: references/architecture.spec.md
+      source: planning.md
+
+tier-2-sequence:
+  description: "Sequence 범위의 기능별 문서"
+  inject_via: controller
+  documents:
+    - compiled: references/service.spec.md
+      source: service-spec.md
+    - compiled: references/data-design.spec.md
+      source: data-design.md
+
+tier-3-task:
+  description: "개별 Task에 필요한 구체 spec"
+  inject_via: controller
+  documents:
+    - compiled: references/error-codes.spec.md
+      source: error-codes.md
+    - compiled: references/functional.spec.md
+      source: functional-spec.md

package/templates/platforms/claude-code/rules/api-conventions.md

@@ -0,0 +1,12 @@
+---
+paths:
+  - "src/api/**/*.ts"
+  - "src/routes/**/*.ts"
+  - "src/controllers/**/*.ts"
+---
+
+- RESTful 네이밍 사용 (복수형 리소스, kebab-case)
+- 에러 응답 표준 형식: `{ code: string, message: string, details?: unknown }`
+- HTTP 상태 코드 정확히 매핑 (200/201/400/401/403/404/500)
+- 요청 validation은 엔드포인트 진입 시점에서 수행
+- 비즈니스 로직은 서비스 레이어에 위치 (컨트롤러에 직접 작성 금지)

package/templates/platforms/claude-code/rules/librarian-constraints.md

@@ -0,0 +1,11 @@
+---
+paths:
+  - ".timsquad/**"
+  - "docs/**"
+---
+
+Librarian 에이전트가 이 경로에서 작업할 때:
+- 문서 작성/갱신 허용
+- 소스 코드(src/, lib/, app/) 수정 절대 금지
+- 기록, 분석, 리포트 작성만 수행
+- 코드 변경이 필요한 사항은 피드백으로 라우팅

package/templates/platforms/claude-code/rules/test-conventions.md

@@ -0,0 +1,13 @@
+---
+paths:
+  - "tests/**/*.test.ts"
+  - "tests/**/*.spec.ts"
+  - "**/*.test.ts"
+  - "**/*.spec.ts"
+---
+
+- describe/it 중첩 3단계 이하 유지
+- 테스트 데이터는 인라인 또는 fixtures/ 디렉토리 사용
+- 각 테스트는 독립적 (공유 상태 금지, beforeEach에서 초기화)
+- 테스트 이름은 "should + 기대 동작" 형식
+- mock은 최소 범위로 사용 (외부 의존성만 mock)

package/templates/platforms/claude-code/scripts/change-scope-guard.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# change-scope-guard.sh — PreToolUse Hook (Edit/Write)
+# Tracks cumulative file changes and enforces SCR (Single Change Rule).
+# 3 files: warning, 6 files: block, >100 lines total: warning
+#
+# Input: JSON via stdin (Claude Code hook protocol)
+# Output: JSON with permissionDecision (allow/deny/ask)
+#
+# State file: /tmp/tsq-scope-guard-${SESSION_ID:-default}.json
+
+set -euo pipefail
+
+WARN_FILES=3
+BLOCK_FILES=6
+WARN_LINES=100
+
+# Session-scoped state file
+SESSION_ID="${CLAUDE_SESSION_ID:-default}"
+STATE_FILE="/tmp/tsq-scope-guard-${SESSION_ID}.json"
+
+# Read hook input from stdin
+INPUT=""
+if read -t 1 -r line; then
+  INPUT="$line"
+fi
+
+# Fail-open: no input → allow
+if [ -z "$INPUT" ]; then
+  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  exit 0
+fi
+
+# Extract tool name
+TOOL_NAME=""
+if command -v jq >/dev/null 2>&1; then
+  TOOL_NAME=$(echo "$INPUT" | jq -r '.toolName // empty' 2>/dev/null || true)
+fi
+
+# Only track Edit and Write tools
+if [ "$TOOL_NAME" != "Edit" ] && [ "$TOOL_NAME" != "Write" ]; then
+  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  exit 0
+fi
+
+# Extract file path from tool input
+FILE_PATH=""
+if command -v jq >/dev/null 2>&1; then
+  FILE_PATH=$(echo "$INPUT" | jq -r '.toolInput.file_path // empty' 2>/dev/null || true)
+fi
+
+if [ -z "$FILE_PATH" ]; then
+  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  exit 0
+fi
+
+# Initialize state file if needed
+if [ ! -f "$STATE_FILE" ]; then
+  echo '{"files":[],"total_lines":0}' > "$STATE_FILE"
+fi
+
+# Read current state
+if command -v jq >/dev/null 2>&1; then
+  CURRENT_FILES=$(jq -r '.files[]' "$STATE_FILE" 2>/dev/null || true)
+  TOTAL_LINES=$(jq -r '.total_lines // 0' "$STATE_FILE" 2>/dev/null || echo "0")
+else
+  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  exit 0
+fi
+
+# Check if file is already tracked
+ALREADY_TRACKED=false
+while IFS= read -r f; do
+  if [ "$f" = "$FILE_PATH" ]; then
+    ALREADY_TRACKED=true
+    break
+  fi
+done <<< "$CURRENT_FILES"
+
+# Add new file if not tracked
+if [ "$ALREADY_TRACKED" = false ]; then
+  jq --arg fp "$FILE_PATH" '.files += [$fp]' "$STATE_FILE" > "${STATE_FILE}.tmp" && mv "${STATE_FILE}.tmp" "$STATE_FILE"
+fi
+
+# Estimate line changes (for Edit: old_string length approximation)
+if [ "$TOOL_NAME" = "Edit" ]; then
+  NEW_LINES=$(echo "$INPUT" | jq -r '.toolInput.new_string // ""' 2>/dev/null | wc -l || echo "0")
+  TOTAL_LINES=$((TOTAL_LINES + NEW_LINES))
+  jq --argjson tl "$TOTAL_LINES" '.total_lines = $tl' "$STATE_FILE" > "${STATE_FILE}.tmp" && mv "${STATE_FILE}.tmp" "$STATE_FILE"
+fi
+
+# Count unique files
+FILE_COUNT=$(jq '.files | length' "$STATE_FILE" 2>/dev/null || echo "0")
+
+# Decision logic
+if [ "$FILE_COUNT" -ge "$BLOCK_FILES" ]; then
+  MSG="SCR violation: ${FILE_COUNT} files modified (limit: ${BLOCK_FILES}). Split into smaller tasks."
+  echo "{\"hookSpecificOutput\":{\"permissionDecision\":\"deny\",\"message\":\"${MSG}\"}}"
+  exit 0
+fi
+
+if [ "$FILE_COUNT" -ge "$WARN_FILES" ]; then
+  MSG="SCR warning: ${FILE_COUNT} files modified. Consider splitting this task."
+  echo "{\"hookSpecificOutput\":{\"permissionDecision\":\"allow\",\"message\":\"${MSG}\"}}"
+  exit 0
+fi
+
+if [ "$TOTAL_LINES" -ge "$WARN_LINES" ]; then
+  MSG="Large change: ~${TOTAL_LINES} lines modified across ${FILE_COUNT} files."
+  echo "{\"hookSpecificOutput\":{\"permissionDecision\":\"allow\",\"message\":\"${MSG}\"}}"
+  exit 0
+fi
+
+echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'

package/templates/platforms/claude-code/scripts/completion-guard.sh

@@ -34,18 +34,44 @@ fi
 
 BLOCK_REASON=""
 
-# ── 1. Test execution gate (implementation phase only) ──
-# 자기 보고 금지: 테스트 exit code로 완료를 판정한다.
-# stop_hook_active=false일 때만 블로킹 (1회 기회 부여, 루프 방지는 섹션 0에서 처리)
+# ── 1. Test execution gate ──
+# 변경된 소스 파일에 대한 테스트 실행 여부 확인
+# implementation phase에서만 block, 그 외에는 warning
 PHASE_FILE="$PROJECT_ROOT/.timsquad/state/current-phase.json"
+PHASE="unknown"
 if [ -f "$PHASE_FILE" ]; then
   PHASE=$(jq -r '.current // .current_phase // .phase // "unknown"' "$PHASE_FILE" 2>/dev/null || echo "unknown")
-  if [ "$PHASE" = "implementation" ]; then
-    SESSION_STATE="$PROJECT_ROOT/.timsquad/.daemon/session-state.json"
-    if [ -f "$SESSION_STATE" ]; then
-      BASH_COMMANDS=$(jq -r '.metrics.bashCommands // 0' "$SESSION_STATE" 2>/dev/null || echo "0")
-      if [ "$BASH_COMMANDS" -eq 0 ] 2>/dev/null; then
-        BLOCK_REASON="[Completion Guard] 이번 세션에서 테스트가 실행되지 않았습니다. 프로젝트의 테스트를 실행하여 변경사항을 검증한 후 완료하세요."
+fi
+
+TEST_WARNING=""
+SESSION_STATE="$PROJECT_ROOT/.timsquad/.daemon/session-state.json"
+if [ -f "$SESSION_STATE" ]; then
+  # Check if any bash commands were executed (tests run via bash)
+  BASH_COMMANDS=$(jq -r '.metrics.bashCommands // 0' "$SESSION_STATE" 2>/dev/null || echo "0")
+
+  if [ "$BASH_COMMANDS" -eq 0 ] 2>/dev/null; then
+    # No tests or bash at all — check for changed source files
+    CHANGED_SRC=$(cd "$PROJECT_ROOT" && git diff --name-only --diff-filter=ACMR HEAD 2>/dev/null | grep -E '\.(ts|tsx|js|jsx)$' | grep -vE '\.(test|spec)\.' | head -5)
+    if [ -n "$CHANGED_SRC" ]; then
+      # List related test files that should have been run
+      RELATED_TESTS=""
+      while IFS= read -r SRC_FILE; do
+        [ -z "$SRC_FILE" ] && continue
+        BASE_NAME=$(basename "$SRC_FILE" | sed 's/\.[^.]*$//')
+        POTENTIAL=$(cd "$PROJECT_ROOT" && find . -name "${BASE_NAME}.test.*" -o -name "${BASE_NAME}.spec.*" 2>/dev/null | head -1)
+        if [ -n "$POTENTIAL" ]; then
+          RELATED_TESTS="$RELATED_TESTS $POTENTIAL"
+        fi
+      done <<< "$CHANGED_SRC"
+
+      if [ -n "$RELATED_TESTS" ]; then
+        TEST_WARNING="[Test Gate] 변경된 파일에 대한 테스트가 실행되지 않았습니다. 관련 테스트:$RELATED_TESTS"
+      else
+        TEST_WARNING="[Test Gate] 변경된 소스 파일이 있으나 테스트가 실행되지 않았습니다."
+      fi
+
+      if [ "$PHASE" = "implementation" ]; then
+        BLOCK_REASON="$TEST_WARNING 테스트를 실행한 후 완료하세요."
       fi
     fi
   fi
@@ -79,15 +105,51 @@ if [ -f "$NOTES_FILE" ]; then
   fi
 fi
 
-# ── 4. Combine and output ──
+# ── 4. Skill Verification reminder (max 3 skills) ──
+VERIFICATION=""
+SKILLS_DIR="$PROJECT_ROOT/.claude/skills"
+if [ -d "$SKILLS_DIR" ]; then
+  SKILL_COUNT=0
+  for SKILL_DIR in "$SKILLS_DIR"/*/; do
+    [ "$SKILL_COUNT" -ge 3 ] && break
+    SKILL_FILE="$SKILL_DIR/SKILL.md"
+    [ ! -f "$SKILL_FILE" ] && continue
+
+    SKILL_NAME=$(basename "$SKILL_DIR")
+    # Skip non-active/template skills
+    case "$SKILL_NAME" in _template|tsq-cli|main-session-constraints) continue ;; esac
+
+    # Extract Verification section (2 lines max)
+    CHECKS=$(awk '/^## Verification/{capture=1; next} /^## /{capture=0} capture && /\|.*\|.*\|/ && !/Check.*Command/' "$SKILL_FILE" 2>/dev/null | head -2)
+    if [ -n "$CHECKS" ]; then
+      VERIFICATION="$VERIFICATION
+[Skill Verification] $SKILL_NAME: $CHECKS"
+      SKILL_COUNT=$((SKILL_COUNT + 1))
+    fi
+  done
+fi
+
+# ── 5. Combine and output ──
 # BLOCK_REASON이 있으면 decision:block으로 강제 속행 (세션 컨텍스트 포함)
 if [ -n "$BLOCK_REASON" ]; then
   FULL_REASON="$BLOCK_REASON"
-  [ -n "$SESSION_CTX" ] && FULL_REASON="$BLOCK_REASON
+  [ -n "$SESSION_CTX" ] && FULL_REASON="$FULL_REASON
 $SESSION_CTX"
+  [ -n "$VERIFICATION" ] && FULL_REASON="$FULL_REASON
+$VERIFICATION"
   jq -n --arg reason "$FULL_REASON" '{"decision": "block", "reason": $reason}'
-elif [ -n "$SESSION_CTX" ]; then
-  jq -n --arg msg "$SESSION_CTX" '{"systemMessage": $msg}'
+elif [ -n "$SESSION_CTX" ] || [ -n "$VERIFICATION" ] || [ -n "$TEST_WARNING" ]; then
+  FULL_MSG=""
+  [ -n "$SESSION_CTX" ] && FULL_MSG="$SESSION_CTX"
+  if [ -n "$TEST_WARNING" ]; then
+    [ -n "$FULL_MSG" ] && FULL_MSG="$FULL_MSG
+$TEST_WARNING" || FULL_MSG="$TEST_WARNING"
+  fi
+  if [ -n "$VERIFICATION" ]; then
+    [ -n "$FULL_MSG" ] && FULL_MSG="$FULL_MSG
+$VERIFICATION" || FULL_MSG="$VERIFICATION"
+  fi
+  jq -n --arg msg "$FULL_MSG" '{"systemMessage": $msg}'
 else
   echo '{}'
 fi

package/templates/platforms/claude-code/scripts/context-restore.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# Context Restore — SessionStart (compact) Hook
+# 컴팩션 후 핵심 컨텍스트를 재주입하여 에이전트 맥락 유실을 방지한다.
+#
+# Input: JSON via stdin (Claude Code hook protocol)
+# Output: JSON with systemMessage (컨텍스트 재주입)
+
+set -e
+
+# Find project root
+PROJECT_ROOT="$(pwd)"
+while [ "$PROJECT_ROOT" != "/" ]; do
+  if [ -d "$PROJECT_ROOT/.timsquad" ]; then
+    break
+  fi
+  PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+
+if [ ! -d "$PROJECT_ROOT/.timsquad" ]; then
+  exit 0
+fi
+
+# Build context summary
+CONTEXT=""
+
+# 1. Project name from config
+PROJECT_NAME=""
+CONFIG_FILE="$PROJECT_ROOT/.timsquad/config.yaml"
+if [ -f "$CONFIG_FILE" ]; then
+  PROJECT_NAME=$(grep -m1 'name:' "$CONFIG_FILE" 2>/dev/null | awk '{print $2}' || echo "")
+fi
+
+if [ -n "$PROJECT_NAME" ]; then
+  CONTEXT="[Context Restore] Project: $PROJECT_NAME"
+else
+  CONTEXT="[Context Restore] TimSquad project"
+fi
+
+# 2. Current phase from workflow
+WORKFLOW_FILE="$PROJECT_ROOT/.timsquad/workflow.json"
+if [ -f "$WORKFLOW_FILE" ]; then
+  CURRENT_PHASE=$(jq -r '.currentPhase // "unknown"' "$WORKFLOW_FILE" 2>/dev/null || echo "unknown")
+  CONTEXT="$CONTEXT | Phase: $CURRENT_PHASE"
+fi
+
+# 3. Read compact summary if exists (saved by pre-compact.sh)
+COMPACT_SUMMARY="$PROJECT_ROOT/.timsquad/.daemon/compact-summary.md"
+if [ -f "$COMPACT_SUMMARY" ]; then
+  SUMMARY_CONTENT=$(head -10 "$COMPACT_SUMMARY" 2>/dev/null || echo "")
+  if [ -n "$SUMMARY_CONTENT" ]; then
+    CONTEXT="$CONTEXT
+$SUMMARY_CONTENT"
+  fi
+fi
+
+# 4. Key constraints (3 lines max)
+CONTEXT="$CONTEXT
+[Key Constraints] TSQ CLI 사용 필수 (tsq log/feedback/commit). 직접 파일 조작 금지. 구현 전 검증 기준 명시."
+
+# Output as systemMessage
+jq -n --arg msg "$CONTEXT" '{
+  hookSpecificOutput: {
+    hookEventName: "SessionStart",
+    systemMessage: $msg
+  }
+}'
+
+exit 0

package/templates/platforms/claude-code/scripts/e2e-commit-gate.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# e2e-commit-gate.sh — Pre-commit hook: validates E2E marker before allowing commit
+# Checks: JSON marker exists, valid format, source_hash matches, not expired
+#
+# Exit 0 = allow commit, Exit 1 = block commit
+
+set -euo pipefail
+
+MARKER_FILE=".e2e-passed"
+
+# No marker = no E2E tests configured, allow
+if [ ! -f "$MARKER_FILE" ]; then
+  exit 0
+fi
+
+# Try to parse as JSON; if not JSON, treat as bare touch (legacy fallback)
+if ! command -v jq >/dev/null 2>&1; then
+  echo "Warning: jq not installed, skipping E2E marker validation"
+  exit 0
+fi
+
+# Attempt JSON parse
+if ! jq empty "$MARKER_FILE" 2>/dev/null; then
+  # Bare touch file (legacy) — allow with warning
+  echo "Warning: .e2e-passed is not JSON format. Consider running E2E tests with e2e-marker.sh"
+  exit 0
+fi
+
+# Validate required fields
+EXIT_CODE=$(jq -r '.exit_code // empty' "$MARKER_FILE")
+SOURCE_HASH=$(jq -r '.source_hash // empty' "$MARKER_FILE")
+EXPIRES_AT=$(jq -r '.expires_at // empty' "$MARKER_FILE")
+
+# exit_code must be 0
+if [ -n "$EXIT_CODE" ] && [ "$EXIT_CODE" -ne 0 ]; then
+  echo "E2E commit gate: BLOCKED — marker shows exit_code=$EXIT_CODE (tests failed)"
+  exit 1
+fi
+
+# source_hash check
+if [ -n "$SOURCE_HASH" ] && [ "$SOURCE_HASH" != "unknown" ]; then
+  CURRENT_HASH=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+  if [ "$SOURCE_HASH" != "$CURRENT_HASH" ]; then
+    echo "E2E commit gate: WARNING — marker source_hash ($SOURCE_HASH) != current HEAD ($CURRENT_HASH)"
+    echo "  E2E tests may be stale. Consider re-running."
+  fi
+fi
+
+# Expiry check
+if [ -n "$EXPIRES_AT" ]; then
+  EXPIRES_EPOCH=$(date -u -j -f "%Y-%m-%dT%H:%M:%SZ" "$EXPIRES_AT" +%s 2>/dev/null || \
+                  date -u -d "$EXPIRES_AT" +%s 2>/dev/null || echo "0")
+  NOW_EPOCH=$(date -u +%s)
+  if [ "$EXPIRES_EPOCH" -gt 0 ] && [ "$NOW_EPOCH" -gt "$EXPIRES_EPOCH" ]; then
+    echo "E2E commit gate: BLOCKED — marker expired at $EXPIRES_AT"
+    echo "  Re-run E2E tests to refresh the marker."
+    exit 1
+  fi
+fi
+
+# All checks passed
+PASSED=$(jq -r '.passed // 0' "$MARKER_FILE")
+FLAKY=$(jq -r '.flaky // 0' "$MARKER_FILE")
+if [ "$FLAKY" -gt 0 ]; then
+  echo "E2E commit gate: PASSED ($PASSED tests, $FLAKY flaky — investigate flaky tests)"
+else
+  echo "E2E commit gate: PASSED ($PASSED tests)"
+fi
+
+exit 0

package/templates/platforms/claude-code/scripts/e2e-marker.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# e2e-marker.sh — E2E 테스트 결과를 JSON 마커로 기록
+# 용도: PostToolUse 훅에서 E2E 테스트 완료 후 호출
+# 출력: .e2e-passed (JSON)
+
+set -euo pipefail
+
+MARKER_FILE=".e2e-passed"
+EXPIRY_HOURS="${E2E_MARKER_EXPIRY_HOURS:-24}"
+
+# 인자: exit_code passed failed flaky
+EXIT_CODE="${1:-0}"
+PASSED="${2:-0}"
+FAILED="${3:-0}"
+FLAKY="${4:-0}"
+
+# exit_code != 0 이면 마커 미생성
+if [ "$EXIT_CODE" -ne 0 ]; then
+  rm -f "$MARKER_FILE"
+  echo "E2E failed (exit_code=$EXIT_CODE) — marker removed"
+  exit 0
+fi
+
+# source_hash: 현재 소스의 git short hash
+SOURCE_HASH=""
+if command -v git >/dev/null 2>&1; then
+  SOURCE_HASH=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+fi
+
+# timestamp & expiry
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  EXPIRES_AT=$(date -u -v+"${EXPIRY_HOURS}"H +"%Y-%m-%dT%H:%M:%SZ")
+else
+  EXPIRES_AT=$(date -u -d "+${EXPIRY_HOURS} hours" +"%Y-%m-%dT%H:%M:%SZ")
+fi
+
+# JSON 마커 생성
+cat > "$MARKER_FILE" <<MARKER
+{
+  "timestamp": "$TIMESTAMP",
+  "exit_code": $EXIT_CODE,
+  "passed": $PASSED,
+  "failed": $FAILED,
+  "flaky": $FLAKY,
+  "source_hash": "$SOURCE_HASH",
+  "expires_at": "$EXPIRES_AT"
+}
+MARKER
+
+echo "E2E marker created: $PASSED passed, $FAILED failed, $FLAKY flaky"

package/templates/platforms/claude-code/scripts/phase-guard.sh

@@ -55,7 +55,7 @@ fi
 PHASE=$(jq -r '.current // .current_phase // .phase // "unknown"' "$PHASE_FILE" 2>/dev/null)
 
 # Normalize file path (make relative to project root)
-REL_PATH="${FILE_PATH#$PROJECT_ROOT/}"
+REL_PATH="${FILE_PATH#"$PROJECT_ROOT"/}"
 
 # Phase enforcement rules
 case "$PHASE" in

package/templates/platforms/claude-code/scripts/pre-compact.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+# Pre-Compact — PreCompact Hook
+# 컴팩션 직전 현재 상태 요약을 compact-summary.md에 저장한다.
+# context-restore.sh가 이 파일을 읽어 compact 후 재주입.
+#
+# Input: JSON via stdin (Claude Code hook protocol)
+# Output: none (파일 생성만)
+
+set -e
+
+# Find project root
+PROJECT_ROOT="$(pwd)"
+while [ "$PROJECT_ROOT" != "/" ]; do
+  if [ -d "$PROJECT_ROOT/.timsquad" ]; then
+    break
+  fi
+  PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+
+if [ ! -d "$PROJECT_ROOT/.timsquad" ]; then
+  exit 0
+fi
+
+DAEMON_DIR="$PROJECT_ROOT/.timsquad/.daemon"
+mkdir -p "$DAEMON_DIR"
+
+SUMMARY_FILE="$DAEMON_DIR/compact-summary.md"
+
+# Collect summary data
+SUMMARY="# Compact Summary (auto-generated)"
+SUMMARY="$SUMMARY
+Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
+
+# Current phase
+WORKFLOW_FILE="$PROJECT_ROOT/.timsquad/workflow.json"
+if [ -f "$WORKFLOW_FILE" ]; then
+  PHASE=$(jq -r '.currentPhase // "unknown"' "$WORKFLOW_FILE" 2>/dev/null || echo "unknown")
+  SUMMARY="$SUMMARY
+Phase: $PHASE"
+fi
+
+# Recent changed files (top 5)
+RECENT_FILES=$(git -C "$PROJECT_ROOT" diff --name-only HEAD 2>/dev/null | head -5 || echo "")
+if [ -n "$RECENT_FILES" ]; then
+  SUMMARY="$SUMMARY
+Recent changes: $RECENT_FILES"
+fi
+
+# Active tasks from session state
+SESSION_STATE="$DAEMON_DIR/session-state.json"
+if [ -f "$SESSION_STATE" ]; then
+  TASK_INFO=$(jq -r '.currentTask // "none"' "$SESSION_STATE" 2>/dev/null || echo "none")
+  SUMMARY="$SUMMARY
+Active task: $TASK_INFO"
+fi
+
+# Session notes (last entry)
+NOTES_FILE="$DAEMON_DIR/session-notes.jsonl"
+if [ -f "$NOTES_FILE" ]; then
+  LAST_NOTE=$(tail -1 "$NOTES_FILE" 2>/dev/null | jq -r '.summary // ""' 2>/dev/null || echo "")
+  if [ -n "$LAST_NOTE" ] && [ "$LAST_NOTE" != "null" ]; then
+    SUMMARY="$SUMMARY
+Last note: $LAST_NOTE"
+  fi
+fi
+
+# Write summary (fail-open: if write fails, don't block compact)
+echo "$SUMMARY" > "$SUMMARY_FILE" 2>/dev/null || true
+
+exit 0