timsquad 3.5.0 → 3.6.0

package/templates/platforms/claude-code/scripts/skill-inject.sh

@@ -0,0 +1,216 @@
+#!/bin/bash
+# Skill Inject — UserPromptSubmit Hook
+# 사용자 프롬프트를 분석하여 매칭 스킬의 Contract/Protocol/Verification을
+# systemMessage로 강제 주입한다 (advisory → mandatory 전환).
+#
+# 기존 skill-suggest.sh를 대체 (상위 호환).
+# Input: JSON via stdin (Claude Code hook protocol, .prompt 필드 포함)
+# Output: JSON with systemMessage (스킬 강제 주입)
+
+set -e
+
+# Read hook input
+INPUT=$(cat 2>/dev/null || echo "")
+if [ -z "$INPUT" ]; then
+  exit 0
+fi
+
+PROMPT=$(echo "$INPUT" | jq -r '.prompt // ""' 2>/dev/null || echo "")
+if [ -z "$PROMPT" ] || [ "$PROMPT" = "null" ]; then
+  exit 0
+fi
+
+# 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
+
+# Load skill rules
+RULES_FILE="$PROJECT_ROOT/.claude/scripts/skill-rules.json"
+if [ ! -f "$RULES_FILE" ]; then
+  exit 0
+fi
+
+THRESHOLD=$(jq -r '.threshold // 2' "$RULES_FILE" 2>/dev/null || echo "2")
+PROMPT_LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
+
+# Match skills and collect top matches with scores
+declare -a MATCH_SKILLS=()
+declare -a MATCH_SCORES=()
+
+RULE_COUNT=$(jq '.rules | length' "$RULES_FILE" 2>/dev/null || echo "0")
+
+i=0
+while [ "$i" -lt "$RULE_COUNT" ]; do
+  SKILL=$(jq -r ".rules[$i].skill" "$RULES_FILE" 2>/dev/null)
+  SCORE=0
+
+  # Check if skill is deployed
+  SKILL_DIR="$PROJECT_ROOT/.claude/skills/$SKILL"
+  if [ ! -d "$SKILL_DIR" ]; then
+    i=$((i + 1))
+    continue
+  fi
+
+  # Keyword matching (3 points each)
+  KW_COUNT=$(jq ".rules[$i].keywords | length" "$RULES_FILE" 2>/dev/null || echo "0")
+  j=0
+  while [ "$j" -lt "$KW_COUNT" ]; do
+    KW=$(jq -r ".rules[$i].keywords[$j]" "$RULES_FILE" 2>/dev/null)
+    if echo "$PROMPT_LOWER" | grep -qi -- "$KW" 2>/dev/null; then
+      SCORE=$((SCORE + 3))
+    fi
+    j=$((j + 1))
+  done
+
+  # Pattern matching (5 points each)
+  PAT_COUNT=$(jq ".rules[$i].patterns | length" "$RULES_FILE" 2>/dev/null || echo "0")
+  k=0
+  while [ "$k" -lt "$PAT_COUNT" ]; do
+    PAT=$(jq -r ".rules[$i].patterns[$k]" "$RULES_FILE" 2>/dev/null)
+    if [ -n "$PAT" ] && echo "$PROMPT_LOWER" | grep -qiE -- "$PAT" 2>/dev/null; then
+      SCORE=$((SCORE + 5))
+    fi
+    k=$((k + 1))
+  done
+
+  # Threshold check
+  if [ "$SCORE" -ge "$THRESHOLD" ]; then
+    MATCH_SKILLS+=("$SKILL")
+    MATCH_SCORES+=("$SCORE")
+  fi
+
+  i=$((i + 1))
+done
+
+# Sort by score descending and take top 3
+SORTED_INDICES=""
+if [ ${#MATCH_SKILLS[@]} -gt 0 ]; then
+  SORTED_INDICES=$(
+    for idx in "${!MATCH_SCORES[@]}"; do
+      echo "${MATCH_SCORES[$idx]} $idx"
+    done | sort -rn | head -3 | awk '{print $2}'
+  )
+fi
+
+# Extract Contract + Protocol + Verification sections from matched skills
+INJECTION=""
+CHAR_COUNT=0
+MAX_CHARS=1500
+
+for idx in $SORTED_INDICES; do
+  SKILL="${MATCH_SKILLS[$idx]}"
+  SKILL_FILE="$PROJECT_ROOT/.claude/skills/$SKILL/SKILL.md"
+
+  if [ ! -f "$SKILL_FILE" ]; then
+    continue
+  fi
+
+  # Extract key sections (Contract + Protocol + Verification)
+  SECTIONS=$(awk '
+    /^## Contract/ { capture=1; next }
+    /^## Protocol/ { capture=1; next }
+    /^## Verification/ { capture=1; next }
+    /^## / { capture=0 }
+    capture { print }
+  ' "$SKILL_FILE" 2>/dev/null | head -20)
+
+  if [ -z "$SECTIONS" ]; then
+    continue
+  fi
+
+  # Append memory/ contents if exists (project-specific decisions)
+  MEMORY_DIR="$PROJECT_ROOT/.claude/skills/$SKILL/memory"
+  MEMORY_CONTENT=""
+  if [ -d "$MEMORY_DIR" ]; then
+    for MEM_FILE in "$MEMORY_DIR"/*.md; do
+      [ ! -f "$MEM_FILE" ] && continue
+      MEM_TEXT=$(head -10 "$MEM_FILE" 2>/dev/null || echo "")
+      if [ -n "$MEM_TEXT" ]; then
+        MEMORY_CONTENT="$MEMORY_CONTENT
+$MEM_TEXT"
+      fi
+    done
+  fi
+
+  ENTRY="[Skill: $SKILL] $SECTIONS"
+  if [ -n "$MEMORY_CONTENT" ]; then
+    ENTRY="$ENTRY
+[Memory] $MEMORY_CONTENT"
+  fi
+  ENTRY_LEN=${#ENTRY}
+
+  if [ $((CHAR_COUNT + ENTRY_LEN)) -gt "$MAX_CHARS" ]; then
+    break
+  fi
+
+  if [ -n "$INJECTION" ]; then
+    INJECTION="$INJECTION
+---
+$ENTRY"
+  else
+    INJECTION="$ENTRY"
+  fi
+  CHAR_COUNT=$((CHAR_COUNT + ENTRY_LEN))
+done
+
+# SSOT Map Tier 0 injection (always injected regardless of skill match)
+SSOT_MAP="$PROJECT_ROOT/.timsquad/ssot-map.yaml"
+if [ -f "$SSOT_MAP" ]; then
+  # Parse tier-0-always compiled paths from YAML
+  TIER0_PATHS=$(awk '
+    /^tier-0-always:/ { in_tier0=1; next }
+    /^tier-[0-9]/ { in_tier0=0 }
+    in_tier0 && /compiled:/ { gsub(/.*compiled: */, ""); gsub(/^ *| *$/, ""); print }
+  ' "$SSOT_MAP" 2>/dev/null)
+
+  TIER0_CONTENT=""
+  while IFS= read -r REL_PATH; do
+    [ -z "$REL_PATH" ] && continue
+    COMPILED_FILE="$PROJECT_ROOT/.claude/skills/controller/$REL_PATH"
+    if [ -f "$COMPILED_FILE" ]; then
+      FILE_CONTENT=$(cat "$COMPILED_FILE" 2>/dev/null || echo "")
+      if [ -n "$FILE_CONTENT" ]; then
+        if [ -n "$TIER0_CONTENT" ]; then
+          TIER0_CONTENT="$TIER0_CONTENT
+---
+$FILE_CONTENT"
+        else
+          TIER0_CONTENT="$FILE_CONTENT"
+        fi
+      fi
+    fi
+  done <<< "$TIER0_PATHS"
+
+  if [ -n "$TIER0_CONTENT" ]; then
+    if [ -n "$INJECTION" ]; then
+      INJECTION="[SSOT Tier-0 Constraints]
+$TIER0_CONTENT
+---
+$INJECTION"
+    else
+      INJECTION="[SSOT Tier-0 Constraints]
+$TIER0_CONTENT"
+    fi
+  fi
+fi
+
+# Output as systemMessage (mandatory injection)
+if [ -n "$INJECTION" ]; then
+  jq -n --arg msg "$INJECTION" '{
+    hookSpecificOutput: {
+      hookEventName: "UserPromptSubmit",
+      systemMessage: $msg
+    }
+  }'
+fi
+
+exit 0

package/templates/platforms/claude-code/scripts/skill-rules.json

@@ -1,6 +1,11 @@
 {
-  "threshold": 4,
+  "threshold": 2,
   "rules": [
+    {
+      "skill": "main-session-constraints",
+      "keywords": ["요구사항", "분석", "계획", "위임", "스프린트", "pm", "관리"],
+      "patterns": ["(plan|analyze|delegate|manage).*?(task|project|sprint)"]
+    },
     {
       "skill": "mobile/flutter",
       "keywords": ["flutter", "widget", "riverpod", "stateless", "stateful", "플러터"],
@@ -80,6 +85,11 @@
       "skill": "planning",
       "keywords": ["prd", "requirements", "specification", "기획", "요구사항"],
       "patterns": ["(write|create|draft).*?(prd|spec|requirement)"]
+    },
+    {
+      "skill": "tsq-cli",
+      "keywords": ["tsq", "cli", "커맨드", "init", "status"],
+      "patterns": ["tsq\\s+(init|status|log|wf|mi|audit|knowledge)"]
     }
   ]
 }

package/templates/platforms/claude-code/scripts/subagent-inject.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Subagent Inject — SubagentStart Hook
+# 서브에이전트 시작 시 tsq-protocol 핵심 내용을 자동 주입한다.
+#
+# 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
+
+# Load tsq-protocol Contract + Protocol sections
+PROTOCOL_FILE="$PROJECT_ROOT/.claude/skills/tsq-protocol/SKILL.md"
+if [ ! -f "$PROTOCOL_FILE" ]; then
+  exit 0
+fi
+
+# Extract Contract + Quick Rules (compact, max 1000 chars)
+SECTIONS=$(awk '
+  /^## Contract/ { capture=1; next }
+  /^## Quick Rules/ { capture=1; next }
+  /^## / { capture=0 }
+  capture { print }
+' "$PROTOCOL_FILE" 2>/dev/null | head -30)
+
+if [ -z "$SECTIONS" ]; then
+  exit 0
+fi
+
+INJECTION="[TSQ Protocol - Subagent] $SECTIONS"
+
+# Trim to 1000 chars max
+INJECTION="${INJECTION:0:1000}"
+
+jq -n --arg msg "$INJECTION" '{
+  hookSpecificOutput: {
+    hookEventName: "SubagentStart",
+    systemMessage: $msg
+  }
+}'
+
+exit 0

package/templates/platforms/claude-code/settings.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/scripts/skill-suggest.sh",
+            "command": "bash .claude/scripts/skill-inject.sh",
             "timeout": 5
           }
         ]
@@ -50,6 +50,11 @@
             "type": "command",
             "command": "tsq daemon notify subagent-start 2>/dev/null || true",
             "timeout": 3
+          },
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/subagent-inject.sh",
+            "timeout": 5
           }
         ]
       }
@@ -74,6 +79,16 @@
             "timeout": 5
           }
         ]
+      },
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/context-restore.sh",
+            "timeout": 5
+          }
+        ]
       }
     ],
     "PostToolUse": [
@@ -119,6 +134,17 @@
         ]
       }
     ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/pre-compact.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "SessionEnd": [
       {
         "hooks": [