@etus/bhono-app 0.1.1

package/templates/base/.claude/hooks/skill-activation-prompt.ts

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+interface HookInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode: string;
+    prompt: string;
+}
+
+interface PromptTriggers {
+    keywords?: string[];
+    intentPatterns?: string[];
+}
+
+interface SkillRule {
+    type: 'guardrail' | 'domain';
+    enforcement: 'block' | 'suggest' | 'warn';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    promptTriggers?: PromptTriggers;
+}
+
+interface SkillRules {
+    version: string;
+    skills: Record<string, SkillRule>;
+}
+
+interface MatchedSkill {
+    name: string;
+    matchType: 'keyword' | 'intent';
+    config: SkillRule;
+}
+
+async function main() {
+    try {
+        // Read input from stdin
+        const input = readFileSync(0, 'utf-8');
+        const data: HookInput = JSON.parse(input);
+
+        // Handle missing or empty prompt
+        if (!data.prompt) {
+            process.exit(0);
+        }
+
+        const prompt = data.prompt.toLowerCase();
+
+        // Load skill rules
+        // From .claude/hooks, go up one level to .claude, then to skills
+        const rulesPath = join(__dirname, '..', 'skills', 'skill-rules.json');
+        const rules: SkillRules = JSON.parse(readFileSync(rulesPath, 'utf-8'));
+
+        const matchedSkills: MatchedSkill[] = [];
+
+        // Check each skill for matches
+        for (const [skillName, config] of Object.entries(rules.skills)) {
+            const triggers = config.promptTriggers;
+            if (!triggers) {
+                continue;
+            }
+
+            // Keyword matching
+            if (triggers.keywords) {
+                const keywordMatch = triggers.keywords.some(kw =>
+                    prompt.includes(kw.toLowerCase())
+                );
+                if (keywordMatch) {
+                    matchedSkills.push({ name: skillName, matchType: 'keyword', config });
+                    continue;
+                }
+            }
+
+            // Intent pattern matching
+            if (triggers.intentPatterns) {
+                const intentMatch = triggers.intentPatterns.some(pattern => {
+                    const regex = new RegExp(pattern, 'i');
+                    return regex.test(prompt);
+                });
+                if (intentMatch) {
+                    matchedSkills.push({ name: skillName, matchType: 'intent', config });
+                }
+            }
+        }
+
+        // Generate output if matches found
+        if (matchedSkills.length > 0) {
+            let output = '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
+            output += '🎯 SKILL ACTIVATION CHECK\n';
+            output += '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n';
+
+            // Group by priority
+            const critical = matchedSkills.filter(s => s.config.priority === 'critical');
+            const high = matchedSkills.filter(s => s.config.priority === 'high');
+            const medium = matchedSkills.filter(s => s.config.priority === 'medium');
+            const low = matchedSkills.filter(s => s.config.priority === 'low');
+
+            if (critical.length > 0) {
+                output += '⚠️ CRITICAL SKILLS (REQUIRED):\n';
+                critical.forEach(s => output += `  → ${s.name}\n`);
+                output += '\n';
+            }
+
+            if (high.length > 0) {
+                output += '📚 RECOMMENDED SKILLS:\n';
+                high.forEach(s => output += `  → ${s.name}\n`);
+                output += '\n';
+            }
+
+            if (medium.length > 0) {
+                output += '💡 SUGGESTED SKILLS:\n';
+                medium.forEach(s => output += `  → ${s.name}\n`);
+                output += '\n';
+            }
+
+            if (low.length > 0) {
+                output += '📌 OPTIONAL SKILLS:\n';
+                low.forEach(s => output += `  → ${s.name}\n`);
+                output += '\n';
+            }
+
+            output += 'ACTION: Use Skill tool BEFORE responding\n';
+            output += '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n';
+
+            console.log(output);
+        }
+
+        process.exit(0);
+    } catch (err) {
+        console.error('Error in skill-activation-prompt hook:', err);
+        process.exit(1);
+    }
+}
+
+main().catch(err => {
+    console.error('Uncaught error:', err);
+    process.exit(1);
+});

package/templates/base/.claude/hooks/tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "lib": ["ES2022"],
+        "outDir": "./dist",
+        "rootDir": ".",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "allowSyntheticDefaultImports": true,
+        "types": ["node"]
+    },
+    "include": ["*.ts"],
+    "exclude": ["node_modules", "dist"]
+}

package/templates/base/.claude/scripts/check-updates.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+# Check for project updates from GitHub
+# Runs on SessionStart with 24-hour caching to avoid network overhead
+
+set -e
+
+# Get project root from script location
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+VERSION_FILE="$PROJECT_ROOT/VERSION"
+CACHE_FILE="$PROJECT_ROOT/.claude/.update-check-cache"
+CACHE_TTL=86400  # 24 hours in seconds
+
+# GitHub repository details
+REPO_OWNER="etusdigital"
+REPO_NAME="ia-setup"
+REMOTE_VERSION_URL="https://raw.githubusercontent.com/$REPO_OWNER/$REPO_NAME/main/VERSION"
+
+# Exit silently if VERSION file doesn't exist
+if [ ! -f "$VERSION_FILE" ]; then
+  exit 0
+fi
+
+# Read local version
+LOCAL_VERSION=$(cat "$VERSION_FILE" | tr -d '[:space:]')
+
+# Check cache validity
+if [ -f "$CACHE_FILE" ]; then
+  CACHE_TIME=$(stat -f %m "$CACHE_FILE" 2>/dev/null || stat -c %Y "$CACHE_FILE" 2>/dev/null || echo 0)
+  CURRENT_TIME=$(date +%s)
+  CACHE_AGE=$((CURRENT_TIME - CACHE_TIME))
+
+  if [ $CACHE_AGE -lt $CACHE_TTL ]; then
+    # Cache is valid, read cached result
+    if [ -s "$CACHE_FILE" ]; then
+      CACHED_REMOTE=$(cat "$CACHE_FILE")
+      if [ "$CACHED_REMOTE" != "$LOCAL_VERSION" ]; then
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo "🔄 UPDATE AVAILABLE"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo ""
+        echo "Current version: $LOCAL_VERSION"
+        echo "Latest version:  $CACHED_REMOTE"
+        echo ""
+        echo "To update, run:"
+        echo "  git pull origin main"
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+      fi
+    fi
+    exit 0
+  fi
+fi
+
+# Cache is stale or doesn't exist, fetch remote version
+# Use timeout to prevent hanging (5 second timeout)
+REMOTE_VERSION=$(curl -sf --max-time 5 "$REMOTE_VERSION_URL" 2>/dev/null | tr -d '[:space:]' || echo "")
+
+# If fetch failed, exit silently (network might be down)
+if [ -z "$REMOTE_VERSION" ]; then
+  exit 0
+fi
+
+# Cache the remote version
+echo "$REMOTE_VERSION" > "$CACHE_FILE"
+
+# Compare versions
+if [ "$REMOTE_VERSION" != "$LOCAL_VERSION" ]; then
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "🔄 UPDATE AVAILABLE"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "Current version: $LOCAL_VERSION"
+  echo "Latest version:  $REMOTE_VERSION"
+  echo ""
+  echo "To update, run:"
+  echo "  git pull origin main"
+  echo ""
+  echo "Changelog: https://github.com/$REPO_OWNER/$REPO_NAME/blob/main/CHANGELOG.md"
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+fi
+
+exit 0

package/templates/base/.claude/scripts/install_pkgs.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+
+# Collect output messages
+OUTPUT=""
+
+OUTPUT+="📦 Installing dependencies...\n"
+
+# Install jq if not present (required for statusline setup)
+if ! command -v jq >/dev/null 2>&1; then
+  OUTPUT+="Installing jq (required for configuration)...\n"
+
+  # Detect OS and install accordingly
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS - use Homebrew
+    if command -v brew >/dev/null 2>&1; then
+      if brew install jq >/dev/null 2>&1; then
+        OUTPUT+="✅ jq installed via Homebrew\n"
+      fi
+    else
+      OUTPUT+="⚠️  Homebrew not found. Please install jq manually: brew install jq\n"
+    fi
+  elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    # Linux - try apt-get first, then yum
+    if command -v apt-get >/dev/null 2>&1; then
+      sudo apt-get update >/dev/null 2>&1
+      if sudo apt-get install -y jq >/dev/null 2>&1; then
+        OUTPUT+="✅ jq installed via apt-get\n"
+      fi
+    elif command -v yum >/dev/null 2>&1; then
+      if sudo yum install -y jq >/dev/null 2>&1; then
+        OUTPUT+="✅ jq installed via yum\n"
+      fi
+    else
+      OUTPUT+="⚠️  Package manager not found. Please install jq manually.\n"
+    fi
+  else
+    OUTPUT+="⚠️  Unsupported OS. Please install jq manually.\n"
+  fi
+else
+  OUTPUT+="✅ jq already installed\n"
+fi
+
+# Install npm dependencies if package.json exists
+if [ -f "package.json" ]; then
+  OUTPUT+="Installing npm packages...\n"
+  npm install >/dev/null 2>&1
+fi
+
+# Install Python dependencies with uv if pyproject.toml exists
+if [ -f "pyproject.toml" ]; then
+  OUTPUT+="Installing Python packages with uv...\n"
+  uv sync >/dev/null 2>&1
+fi
+
+OUTPUT+="✅ Dependencies installed"
+
+# Output in Claude Code hook format with visual reminder
+# Use jq to properly escape the output for JSON
+jq -n --arg msg "<important-reminder>IN YOUR FIRST REPLY AFTER SEEING THIS MESSAGE YOU MUST TELL THE USER:\n$(echo -e "$OUTPUT")</important-reminder>" '{
+  hookSpecificOutput: {
+    hookEventName: "SessionStart",
+    additionalContext: $msg
+  }
+}'
+
+exit 0

package/templates/base/.claude/scripts/setup-project.sh

@@ -0,0 +1,177 @@
+#!/bin/bash
+# One-time setup for Claude Code project configuration
+# Sets up statusline and settings.json with required hooks
+
+set -e
+
+# Get directories from script location
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+PROJECT_ROOT="$(cd "$CLAUDE_DIR/.." && pwd)"
+
+SETTINGS_FILE="$CLAUDE_DIR/settings.json"
+STATUSLINE_DIR="$CLAUDE_DIR/statusline"
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔧 CLAUDE CODE PROJECT SETUP"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Setup settings.json
+echo "⚙️  Configuring settings.json..."
+if [ ! -f "$SETTINGS_FILE" ]; then
+  echo "✅ Creating new settings.json..."
+  cat > "$SETTINGS_FILE" << 'EOF'
+{
+  "includeCoAuthoredBy": false,
+  "env": {
+    "BASH_DEFAULT_TIMEOUT_MS": "30000",
+    "BASH_MAX_TIMEOUT_MS": "40000",
+    "BASH_MAX_OUTPUT_LENGTH": "500000",
+    "CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR": "1",
+    "ENABLE_BACKGROUND_TASKS": "1",
+    "MAX_THINKING_TOKENS": "64000",
+    "MCP_TIMEOUT": "30000",
+    "MCP_TOOL_TIMEOUT": "60000",
+    "MAX_MCP_OUTPUT_TOKENS": "50000",
+    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1",
+    "CLAUDE_CODE_ENABLE_UNIFIED_READ_TOOL": "true",
+    "USE_BUILTIN_RIPGREP": "0"
+  },
+  "enabledMcpjsonServers": [
+    "sequential-thinking"
+  ],
+  "permissions": {
+    "allow": [
+      "Edit:*",
+      "Write:*",
+      "MultiEdit:*",
+      "NotebookEdit:*",
+      "Bash:*",
+      "WebSearch:*",
+      "WebFetch:*",
+      "Bash(grep:*)",
+      "Bash(diff:*)",
+      "Bash(echo:*)",
+      "Bash(tree:*)",
+      "Bash(npm:*)",
+      "Bash(npx:*)",
+      "Bash(pnpm:*)",
+      "Bash(python:*)",
+      "Bash(python3:*)",
+      "Bash(uv:*)",
+      "Bash(uvx:*)",
+      "Bash(psql:*)",
+      "Bash(createdb:*)",
+      "Bash(curl:*)",
+      "Bash(wrangler:*)",
+      "Bash(ls:*)",
+      "Bash(mkdir:*)",
+      "Bash(cp:*)",
+      "Bash(mv:*)",
+      "Bash(node:*)",
+      "Bash(find:*)",
+      "Bash(wait)",
+      "Bash(git:*)",
+      "Bash(gh:*)",
+      "Bash(touch:*)",
+      "Bash(chmod:*)",
+      "Bash(openssl:*)",
+      "Bash(sed:*)",
+      "Bash(awk:*)",
+      "Bash(head:*)",
+      "Bash(cat:*)",
+      "Bash(tail:*)",
+      "Bash(vercel:*)",
+      "mcp__sequential-thinking__sequentialthinking"
+    ],
+    "deny": [],
+    "defaultMode": "acceptEdits"
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/skill-activation-prompt.sh"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/scripts/install_pkgs.sh"
+          }
+        ]
+      }
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "bash -c 'input=$(cat); MODEL=$(echo \"$input\" | jq -r \".model.display_name\"); DIR=$(echo \"$input\" | jq -r \".workspace.current_dir\"); BRANCH=\"\"; if git rev-parse --git-dir >/dev/null 2>&1; then BRANCH=\" | 🌿 $(git branch --show-current 2>/dev/null)\"; CHANGES=$(git status --porcelain 2>/dev/null | wc -l); if [ $CHANGES -gt 0 ]; then BRANCH=\"$BRANCH ($CHANGES)\"; fi; fi; echo \"[$MODEL] 📁 ${DIR##*/}$BRANCH\"'"
+  }
+}
+EOF
+  echo "✅ settings.json created with all required configuration"
+  echo "✅ Statusline configured (git branch + model info)"
+else
+  # Backup existing settings
+  BACKUP_FILE="$SETTINGS_FILE.backup.$(date +%s)"
+  cp "$SETTINGS_FILE" "$BACKUP_FILE"
+  echo "📦 Existing settings backed up to: ${BACKUP_FILE##*/}"
+  echo ""
+
+  # Check if jq is available for statusLine merging
+  if command -v jq >/dev/null 2>&1; then
+    # Check if statusLine already exists
+    HAS_STATUSLINE=$(jq 'has("statusLine")' "$SETTINGS_FILE")
+
+    if [ "$HAS_STATUSLINE" = "false" ]; then
+      echo "📊 Adding statusLine configuration..."
+      STATUSLINE_CMD='bash -c '\''input=$(cat); MODEL=$(echo "$input" | jq -r ".model.display_name"); DIR=$(echo "$input" | jq -r ".workspace.current_dir"); BRANCH=""; if git rev-parse --git-dir >/dev/null 2>&1; then BRANCH=" | 🌿 $(git branch --show-current 2>/dev/null)"; CHANGES=$(git status --porcelain 2>/dev/null | wc -l); if [ $CHANGES -gt 0 ]; then BRANCH="$BRANCH ($CHANGES)"; fi; fi; echo "[$MODEL] 📁 ${DIR##*/}$BRANCH"'\'''
+      jq --arg cmd "$STATUSLINE_CMD" '. + {statusLine: {type: "command", command: $cmd}}' "$SETTINGS_FILE" > "$SETTINGS_FILE.tmp"
+      mv "$SETTINGS_FILE.tmp" "$SETTINGS_FILE"
+      echo "✅ Statusline configured (git branch + model info)"
+      echo ""
+    else
+      echo "ℹ️  Statusline already configured (skipping)"
+      echo ""
+    fi
+  else
+    echo "⚠️  jq not found - skipping statusLine auto-configuration"
+    echo "   jq is required for automatic statusLine setup"
+    echo ""
+    echo "   To install jq:"
+    echo "     macOS: brew install jq"
+    echo "     Linux: sudo apt-get install jq"
+    echo ""
+  fi
+
+  echo "⚠️  settings.json already exists"
+  echo ""
+  echo "📋 Please manually verify these hooks are configured:"
+  echo ""
+  echo "   UserPromptSubmit hook:"
+  echo '     $CLAUDE_PROJECT_DIR/.claude/hooks/skill-activation-prompt.sh'
+  echo ""
+  echo "   SessionStart hooks:"
+  echo '     $CLAUDE_PROJECT_DIR/.claude/scripts/install_pkgs.sh'
+  echo ""
+  echo "💡 Settings backed up before modifications"
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "✅ SETUP COMPLETE"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Next steps:"
+echo "  1. Review .claude/settings.json"
+echo "  2. Start a new Claude Code session"
+echo "  3. Verify skill activation works"
+echo ""

package/templates/base/.claude/scripts/validate-skill-rules.sh

@@ -0,0 +1,94 @@
+#!/bin/bash
+# Validates skill-rules.json structure and activation system
+# Runs on SessionStart to ensure the skill-rules activation works
+
+set -e
+
+# Get .claude directory from script location
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+HOOKS_DIR="$CLAUDE_DIR/hooks"
+RULES_FILE="$CLAUDE_DIR/skills/skill-rules.json"
+
+# Collect messages
+MESSAGES=""
+
+# Install dependencies if needed (silent)
+if [ -f "$HOOKS_DIR/package.json" ] && [ ! -d "$HOOKS_DIR/node_modules" ]; then
+  cd "$HOOKS_DIR" && npm install --silent >/dev/null 2>&1
+fi
+
+# Make hook executable
+if [ -f "$HOOKS_DIR/skill-activation-prompt.sh" ]; then
+  chmod +x "$HOOKS_DIR/skill-activation-prompt.sh" 2>/dev/null || true
+fi
+
+# Validate skill-rules.json exists
+if [ ! -f "$RULES_FILE" ]; then
+  MESSAGES+="❌ skill-rules.json not found\n"
+  MESSAGES+="   Skill activation will not work properly.\n"
+
+  jq -n --arg msg "$(echo -e "$MESSAGES")" '{
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: $msg
+    }
+  }'
+  exit 1
+fi
+
+# Validate skill-rules.json is valid JSON
+if ! command -v jq >/dev/null 2>&1; then
+  # jq not available, skip JSON validation
+  MESSAGES+="⚠️  jq not found, skipping JSON validation\n"
+elif ! jq empty "$RULES_FILE" 2>/dev/null; then
+  MESSAGES+="❌ skill-rules.json is not valid JSON\n"
+
+  jq -n --arg msg "$(echo -e "$MESSAGES")" '{
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: $msg
+    }
+  }'
+  exit 1
+fi
+
+# Quick test: Run hook with mock data
+TEST_INPUT='{"session_id":"test","transcript_path":"/tmp","cwd":".","permission_mode":"auto","prompt":"test fastapi endpoint"}'
+if [ -x "$HOOKS_DIR/skill-activation-prompt.sh" ]; then
+  if echo "$TEST_INPUT" | "$HOOKS_DIR/skill-activation-prompt.sh" >/dev/null 2>&1; then
+    MESSAGES+="✅ Skill-rules system validated"
+  else
+    MESSAGES+="⚠️  Skill activation hook test failed\n"
+    MESSAGES+="   Check that dependencies are installed in $HOOKS_DIR\n"
+
+    jq -n --arg msg "$(echo -e "$MESSAGES")" '{
+      hookSpecificOutput: {
+        hookEventName: "SessionStart",
+        additionalContext: $msg
+      }
+    }'
+    exit 1
+  fi
+else
+  MESSAGES+="⚠️  skill-activation-prompt.sh not found or not executable\n"
+
+  jq -n --arg msg "$(echo -e "$MESSAGES")" '{
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: $msg
+    }
+  }'
+  exit 1
+fi
+
+# Output success message in Claude Code format with visual reminder
+jq -n --arg msg "<important-reminder>IN YOUR FIRST REPLY AFTER SEEING THIS MESSAGE YOU MUST TELL THE USER:\n$(echo -e "$MESSAGES")</important-reminder>" '{
+  hookSpecificOutput: {
+    hookEventName: "SessionStart",
+    additionalContext: $msg
+  }
+}'
+
+exit 0