codecruise 0.1.0

package/config/hooks/load-context-skills.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+# SessionStart hook - Loads relevant skills based on current TODO context
+#
+# P2: Context-aware skill loading
+#
+# Reads current TODO from progress.yaml, checks file patterns,
+# and outputs relevant skill content to inject into Claude's context.
+#
+# Skill triggers:
+# - .ts/.tsx files → TypeScript skill
+# - React/Next.js patterns → Frontend skill
+# - API/route files → Backend skill
+# - Prisma/database files → Database skill
+# - Test files → Testing skill
+
+# Check if we're in a codecruise project
+if [[ ! -f "progress.yaml" ]]; then
+  exit 0
+fi
+
+# Get current TODO
+CURRENT_TODO=$(grep -A5 "current:" progress.yaml 2>/dev/null | grep "todo:" | sed 's/.*todo: //' | tr -d ' "' || echo "")
+
+if [[ -z "$CURRENT_TODO" || "$CURRENT_TODO" == "null" ]]; then
+  exit 0
+fi
+
+# Find the roadmap file containing this TODO
+ROADMAP_FILE=$(grep -rl "id: $CURRENT_TODO" roadmap/ 2>/dev/null | head -1 || echo "")
+
+if [[ -z "$ROADMAP_FILE" ]]; then
+  exit 0
+fi
+
+# Extract files from TODO
+TODO_FILES=$(awk "/id: $CURRENT_TODO/,/^[[:space:]]*- id:/" "$ROADMAP_FILE" | grep -E "^\s+-\s+" | grep -v "id:" | sed 's/.*- //' || echo "")
+
+# Determine which skills to load based on file patterns
+SKILLS_TO_LOAD=""
+
+# Check file patterns
+for file in $TODO_FILES; do
+  # TypeScript
+  if [[ "$file" == *.ts || "$file" == *.tsx ]]; then
+    SKILLS_TO_LOAD="$SKILLS_TO_LOAD typescript"
+  fi
+
+  # Frontend (React/Next.js)
+  if [[ "$file" == *"/components/"* || "$file" == *"/app/"* || "$file" == *"/pages/"* || "$file" == *.tsx ]]; then
+    SKILLS_TO_LOAD="$SKILLS_TO_LOAD frontend"
+  fi
+
+  # Backend (API routes)
+  if [[ "$file" == *"/api/"* || "$file" == *"/routes/"* || "$file" == *"/server/"* || "$file" == *"/services/"* ]]; then
+    SKILLS_TO_LOAD="$SKILLS_TO_LOAD backend"
+  fi
+
+  # Database
+  if [[ "$file" == *"prisma"* || "$file" == *"/db/"* || "$file" == *"/database/"* || "$file" == *"/models/"* ]]; then
+    SKILLS_TO_LOAD="$SKILLS_TO_LOAD database"
+  fi
+
+  # Testing
+  if [[ "$file" == *.test.* || "$file" == *.spec.* || "$file" == *"__tests__"* ]]; then
+    SKILLS_TO_LOAD="$SKILLS_TO_LOAD testing"
+  fi
+done
+
+# Remove duplicates
+SKILLS_TO_LOAD=$(echo "$SKILLS_TO_LOAD" | tr ' ' '\n' | sort -u | tr '\n' ' ')
+
+# Output loaded skills (this gets injected into Claude's context)
+if [[ -n "$SKILLS_TO_LOAD" ]]; then
+  echo "=== Context Skills Loaded for TODO: $CURRENT_TODO ==="
+  echo ""
+
+  for skill in $SKILLS_TO_LOAD; do
+    SKILL_FILE="$HOME/.claude/skills/${skill}/patterns.md"
+    SKILL_FILE_ALT="$HOME/.claude/skills/${skill}.md"
+
+    if [[ -f "$SKILL_FILE" ]]; then
+      echo "--- $skill patterns ---"
+      head -100 "$SKILL_FILE"  # First 100 lines to avoid context bloat
+      echo ""
+    elif [[ -f "$SKILL_FILE_ALT" ]]; then
+      echo "--- $skill patterns ---"
+      head -100 "$SKILL_FILE_ALT"
+      echo ""
+    fi
+  done
+
+  echo "=== End Context Skills ==="
+fi
+
+exit 0

package/config/hooks/notify.sh

@@ -0,0 +1,81 @@
+#!/bin/bash
+# Sends notifications to configured channel
+# Used by autonomous mode for blockers, completions, and alerts
+
+INPUT=$(cat)
+EVENT_TYPE=$(echo "$INPUT" | jq -r '.event // "info"')
+MESSAGE=$(echo "$INPUT" | jq -r '.message // "Notification from codecruise"')
+TODO_ID=$(echo "$INPUT" | jq -r '.todo_id // empty')
+CHANNEL=${PILOT_NOTIFY_CHANNEL:-none}
+
+# Skip if no channel configured
+if [[ "$CHANNEL" == "none" || -z "$CHANNEL" ]]; then
+  exit 0
+fi
+
+# Build notification payload
+EMOJI="ℹ️"
+case "$EVENT_TYPE" in
+  blocker)
+    EMOJI="🚨"
+    ;;
+  complete)
+    EMOJI="✅"
+    ;;
+  error)
+    EMOJI="❌"
+    ;;
+  warning)
+    EMOJI="⚠️"
+    ;;
+esac
+
+PAYLOAD="$EMOJI PILOT: $MESSAGE"
+if [[ -n "$TODO_ID" ]]; then
+  PAYLOAD="$PAYLOAD\n📍 TODO: $TODO_ID"
+fi
+
+case "$CHANNEL" in
+  slack)
+    if [[ -z "$SLACK_WEBHOOK_URL" ]]; then
+      echo "Error: SLACK_WEBHOOK_URL not set" >&2
+      exit 1
+    fi
+
+    curl -s -X POST "$SLACK_WEBHOOK_URL" \
+      -H "Content-Type: application/json" \
+      -d "{\"text\": \"$PAYLOAD\"}" \
+      > /dev/null 2>&1
+    ;;
+
+  webhook)
+    if [[ -z "$PILOT_WEBHOOK_URL" ]]; then
+      echo "Error: PILOT_WEBHOOK_URL not set" >&2
+      exit 1
+    fi
+
+    curl -s -X POST "$PILOT_WEBHOOK_URL" \
+      -H "Content-Type: application/json" \
+      -d "{\"event\": \"$EVENT_TYPE\", \"message\": \"$MESSAGE\", \"todo_id\": \"$TODO_ID\", \"timestamp\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}" \
+      > /dev/null 2>&1
+    ;;
+
+  telegram)
+    if [[ -z "$TELEGRAM_BOT_TOKEN" || -z "$TELEGRAM_CHAT_ID" ]]; then
+      echo "Error: TELEGRAM_BOT_TOKEN or TELEGRAM_CHAT_ID not set" >&2
+      exit 1
+    fi
+
+    curl -s -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage" \
+      -H "Content-Type: application/json" \
+      -d "{\"chat_id\": \"$TELEGRAM_CHAT_ID\", \"text\": \"$PAYLOAD\", \"parse_mode\": \"HTML\"}" \
+      > /dev/null 2>&1
+    ;;
+
+  *)
+    echo "Unknown notification channel: $CHANNEL" >&2
+    exit 1
+    ;;
+esac
+
+exit 0

package/config/hooks/pre-commit.sample

@@ -0,0 +1,35 @@
+#!/bin/sh
+# Pre-commit hook - runs quality checks before allowing commit
+#
+# Installation:
+#   cp ~/.claude/hooks/pre-commit.sample .git/hooks/pre-commit
+#   chmod +x .git/hooks/pre-commit
+#
+# Or with Husky:
+#   npx husky add .husky/pre-commit "npm run check"
+
+# Detect package manager and run quality command
+if [ -f "package.json" ]; then
+    if [ -f "pnpm-lock.yaml" ]; then
+        pnpm run check || exit 1
+    elif [ -f "yarn.lock" ]; then
+        yarn check || exit 1
+    elif [ -f "bun.lockb" ]; then
+        bun run check || exit 1
+    else
+        npm run check || exit 1
+    fi
+elif [ -f "pyproject.toml" ]; then
+    # Python projects
+    if command -v ruff &> /dev/null; then
+        ruff check . || exit 1
+    fi
+    if command -v mypy &> /dev/null; then
+        mypy . || exit 1
+    fi
+    if command -v pytest &> /dev/null; then
+        pytest --tb=short || exit 1
+    fi
+fi
+
+echo "✓ Pre-commit checks passed"

package/config/hooks/protect-files.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# PreToolUse hook - blocks modification of critical files
+# Prevents accidental corruption of state, secrets, and lock files
+
+INPUT=$(cat)
+TOOL=$(echo "$INPUT" | jq -r '.tool_name // empty')
+FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+# Skip if not a write operation
+if [[ "$TOOL" != "Edit" && "$TOOL" != "Write" ]]; then
+  exit 0
+fi
+
+# Skip if no file path
+if [[ -z "$FILE" ]]; then
+  exit 0
+fi
+
+# Default protected patterns
+PROTECTED=(
+  "progress.yaml"
+  "roadmap/"
+  ".env"
+  ".env.*"
+  "package-lock.json"
+  "pnpm-lock.yaml"
+  "yarn.lock"
+  "Gemfile.lock"
+  "poetry.lock"
+  "Cargo.lock"
+  ".git/"
+  ".ssh/"
+  ".aws/"
+  ".gnupg/"
+  "credentials"
+  "secrets"
+)
+
+# Add custom patterns from environment
+if [[ -n "$PILOT_PROTECTED_FILES" ]]; then
+  IFS=',' read -ra CUSTOM <<< "$PILOT_PROTECTED_FILES"
+  PROTECTED+=("${CUSTOM[@]}")
+fi
+
+# Check if file matches any protected pattern
+for pattern in "${PROTECTED[@]}"; do
+  # Handle glob patterns
+  if [[ "$FILE" == *"$pattern"* ]]; then
+    cat <<EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "permissionDecision": "deny",
+    "permissionDecisionReason": "Cannot modify protected file matching pattern: $pattern. Use dedicated commands (/run, /found) or edit config/hooks/protect-files.sh to adjust."
+  }
+}
+EOF
+    exit 0
+  fi
+done
+
+# Allow the operation
+exit 0

package/config/hooks/track-agents.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# track-agents.sh — PostToolUse hook for tracking agent delegations
+#
+# Logs when Task tool is used to spawn subagents
+# Answers: "Which of the 12 agents actually get used?"
+#
+# Writes to .codecruise/metrics/agents.jsonl
+
+AGENTS_LOG="${CODECRUISE_AGENTS_LOG:-.codecruise/metrics/agents.jsonl}"
+
+mkdir -p "$(dirname "$AGENTS_LOG")"
+
+INPUT=$(cat)
+
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Only track Task tool usage (agent delegation)
+if [[ "$TOOL_NAME" != "Task" ]]; then
+  exit 0
+fi
+
+TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+PROJECT=$(basename "$PWD")
+
+# Extract agent info from tool input
+SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // "unknown"')
+DESCRIPTION=$(echo "$INPUT" | jq -r '.tool_input.description // ""' | cut -c1-100)
+MODEL=$(echo "$INPUT" | jq -r '.tool_input.model // "default"')
+
+# Get current TODO if available
+CURRENT_TODO=""
+if [[ -f "progress.yaml" ]]; then
+  CURRENT_TODO=$(grep -oE "todo-[0-9]+\.[0-9]+[a-z]?-[0-9]+" progress.yaml 2>/dev/null | head -1 || echo "")
+fi
+
+# Escape description for JSON
+ESCAPED_DESC=$(echo "$DESCRIPTION" | sed 's/"/\\"/g')
+
+echo "{\"timestamp\":\"$TIMESTAMP\",\"project\":\"$PROJECT\",\"agent\":\"$SUBAGENT_TYPE\",\"model\":\"$MODEL\",\"todo\":\"$CURRENT_TODO\",\"description\":\"$ESCAPED_DESC\"}" >> "$AGENTS_LOG"
+
+exit 0

package/config/hooks/track-commands.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# track-commands.sh — Tracks which codecruise commands are actually used
+#
+# PostToolUse hook that detects Skill tool invocations
+# Answers: "Which of the 34 commands actually get used?"
+#
+# Writes to .codecruise/metrics/commands.jsonl
+
+COMMANDS_LOG="${CODECRUISE_COMMANDS_LOG:-.codecruise/metrics/commands.jsonl}"
+
+mkdir -p "$(dirname "$COMMANDS_LOG")"
+
+INPUT=$(cat)
+
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Only track Skill tool usage (command invocation)
+if [[ "$TOOL_NAME" != "Skill" ]]; then
+  exit 0
+fi
+
+TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+PROJECT=$(basename "$PWD")
+
+# Extract command info
+SKILL_NAME=$(echo "$INPUT" | jq -r '.tool_input.skill // "unknown"')
+ARGS=$(echo "$INPUT" | jq -r '.tool_input.args // ""' | cut -c1-50)
+
+# Get current TODO if available
+CURRENT_TODO=""
+if [[ -f "progress.yaml" ]]; then
+  CURRENT_TODO=$(grep -oE "todo-[0-9]+\.[0-9]+[a-z]?-[0-9]+" progress.yaml 2>/dev/null | head -1 || echo "")
+fi
+
+echo "{\"timestamp\":\"$TIMESTAMP\",\"project\":\"$PROJECT\",\"command\":\"$SKILL_NAME\",\"args\":\"$ARGS\",\"todo\":\"$CURRENT_TODO\"}" >> "$COMMANDS_LOG"
+
+exit 0

package/config/hooks/track-enforcement.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# track-enforcement.sh — Logs enforcement events for dogfooding analysis
+#
+# Called by other hooks when they block or warn
+# Writes to .codecruise/metrics/enforcement.jsonl
+#
+# Usage (from other hooks):
+#   source "$(dirname "$0")/track-enforcement.sh"
+#   track_enforcement "tdd_block" "No test file for src/auth.ts"
+#   track_enforcement "rationalization_caught" "detected: 'good enough for now'"
+#   track_enforcement "state_invalid" "pending -> done not allowed"
+#   track_enforcement "quality_block" "tests failed, cannot mark done"
+
+ENFORCEMENT_LOG="${CODECRUISE_ENFORCEMENT_LOG:-.codecruise/metrics/enforcement.jsonl}"
+
+track_enforcement() {
+  local event_type="$1"
+  local detail="$2"
+  local hook_name="${3:-unknown}"
+
+  mkdir -p "$(dirname "$ENFORCEMENT_LOG")"
+
+  local timestamp
+  timestamp=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+  # Get current TODO if available
+  local current_todo=""
+  if [[ -f "progress.yaml" ]]; then
+    current_todo=$(grep -oE "todo-[0-9]+\.[0-9]+[a-z]?-[0-9]+" progress.yaml 2>/dev/null | head -1 || echo "")
+  fi
+
+  # Get project name from directory
+  local project
+  project=$(basename "$PWD")
+
+  # Escape detail for JSON
+  local escaped_detail
+  escaped_detail=$(echo "$detail" | sed 's/"/\\"/g' | tr '\n' ' ')
+
+  echo "{\"timestamp\":\"$timestamp\",\"project\":\"$project\",\"event\":\"$event_type\",\"hook\":\"$hook_name\",\"todo\":\"$current_todo\",\"detail\":\"$escaped_detail\"}" >> "$ENFORCEMENT_LOG"
+}
+
+# Export function for sourcing
+export -f track_enforcement 2>/dev/null || true

package/config/hooks/track-ooda.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+# track-ooda.sh — Tracks OODA loop phases and decisions
+#
+# PostToolUse hook that detects OODA-related patterns in tool results
+# Answers: "Is OODA's ORIENT phase actually calculating meaningful confidence?"
+#
+# Detects patterns like:
+#   - "OBSERVE:" / "ORIENT:" / "DECIDE:" / "ACT:" in outputs
+#   - Confidence levels mentioned
+#   - Decisions made (execute, skip, replan, escalate)
+#
+# Writes to .codecruise/metrics/ooda.jsonl
+
+OODA_LOG="${CODECRUISE_OODA_LOG:-.codecruise/metrics/ooda.jsonl}"
+
+mkdir -p "$(dirname "$OODA_LOG")"
+
+INPUT=$(cat)
+
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+TOOL_RESULT=$(echo "$INPUT" | jq -r '.tool_result // empty' 2>/dev/null || echo "")
+
+# Skip if no result to analyze
+if [[ -z "$TOOL_RESULT" ]]; then
+  exit 0
+fi
+
+TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+PROJECT=$(basename "$PWD")
+
+# Get current TODO
+CURRENT_TODO=""
+if [[ -f "progress.yaml" ]]; then
+  CURRENT_TODO=$(grep -oE "todo-[0-9]+\.[0-9]+[a-z]?-[0-9]+" progress.yaml 2>/dev/null | head -1 || echo "")
+fi
+
+# Detect OODA phases in output
+PHASE=""
+if echo "$TOOL_RESULT" | grep -qiE "OBSERVE:"; then
+  PHASE="observe"
+elif echo "$TOOL_RESULT" | grep -qiE "ORIENT:"; then
+  PHASE="orient"
+elif echo "$TOOL_RESULT" | grep -qiE "DECIDE:"; then
+  PHASE="decide"
+elif echo "$TOOL_RESULT" | grep -qiE "ACT:"; then
+  PHASE="act"
+fi
+
+# Skip if no OODA phase detected
+if [[ -z "$PHASE" ]]; then
+  exit 0
+fi
+
+# Extract confidence if in ORIENT phase
+CONFIDENCE=""
+if [[ "$PHASE" == "orient" ]]; then
+  CONFIDENCE=$(echo "$TOOL_RESULT" | grep -oiE "confidence[=: ]*(high|medium|low|[0-9.]+)" | head -1 | sed 's/.*[=: ]//')
+fi
+
+# Extract decision if in DECIDE phase
+DECISION=""
+if [[ "$PHASE" == "decide" ]]; then
+  if echo "$TOOL_RESULT" | grep -qiE "execute"; then
+    DECISION="execute"
+  elif echo "$TOOL_RESULT" | grep -qiE "skip"; then
+    DECISION="skip"
+  elif echo "$TOOL_RESULT" | grep -qiE "replan"; then
+    DECISION="replan"
+  elif echo "$TOOL_RESULT" | grep -qiE "escalate"; then
+    DECISION="escalate"
+  fi
+fi
+
+# Log the event
+echo "{\"timestamp\":\"$TIMESTAMP\",\"project\":\"$PROJECT\",\"todo\":\"$CURRENT_TODO\",\"phase\":\"$PHASE\",\"confidence\":\"$CONFIDENCE\",\"decision\":\"$DECISION\"}" >> "$OODA_LOG"
+
+exit 0

package/config/hooks/validate-commit-msg.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# Validates commit message follows conventional commit format
+# Used by PreToolUse hook for git commit commands
+#
+# Format: type(scope): description
+# Types: feat, fix, docs, style, refactor, test, chore
+#
+# Exit codes:
+#   0 - Valid commit message
+#   2 - Invalid (blocks the tool)
+
+MSG="$1"
+
+# Pattern: type(optional-scope): description (max 50 chars for description)
+PATTERN='^(feat|fix|docs|style|refactor|test|chore)(\([a-z0-9_-]+\))?: .{1,50}$'
+
+if [[ -z "$MSG" ]]; then
+  # No message provided, let git handle it
+  exit 0
+fi
+
+if [[ ! "$MSG" =~ $PATTERN ]]; then
+  echo "Blocked: Commit message must follow conventional format" >&2
+  echo "" >&2
+  echo "Format: type(scope): description" >&2
+  echo "Types: feat, fix, docs, style, refactor, test, chore" >&2
+  echo "" >&2
+  echo "Examples:" >&2
+  echo "  feat(auth): add password reset flow" >&2
+  echo "  fix(cart): resolve quantity update bug" >&2
+  echo "  docs: update README installation steps" >&2
+  exit 2
+fi
+
+exit 0