anchi-toolkit 1.2.0 → 1.2.2

package/dist/.cursor/hooks/scout-block.cjs

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+
+/**
+ * scout-block.js - Cross-platform hook dispatcher
+ *
+ * Blocks access to directories listed in .cursor/.ckignore
+ * (defaults: node_modules, __pycache__, .git, dist, build)
+ *
+ * Blocking Rules:
+ * - File paths: Blocks any file_path/path/pattern containing blocked directories
+ * - Bash commands: Blocks directory access (cd, ls, cat, etc.) but ALLOWS build commands
+ *   - Blocked: cd node_modules, ls build/, cat dist/file.js
+ *   - Allowed: npm build, pnpm build, yarn build, npm run build
+ *
+ * Configuration:
+ * - Edit .cursor/.ckignore to customize blocked patterns (one per line, # for comments)
+ *
+ * Platform Detection:
+ * - Windows (win32): Uses PowerShell via scout-block.ps1
+ * - Unix (linux/darwin): Uses Bash via scout-block.sh
+ * - WSL: Automatically detects and uses bash implementation
+ *
+ * Exit Codes:
+ * - 0: Command allowed
+ * - 2: Command blocked or error occurred
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+// __dirname and __filename are already available in CommonJS
+
+try {
+  // Read stdin synchronously
+  const hookInput = fs.readFileSync(0, 'utf-8');
+
+  // Validate input not empty
+  if (!hookInput || hookInput.trim().length === 0) {
+    console.error('ERROR: Empty input');
+    process.exit(2);
+  }
+
+  // Validate JSON structure (basic check)
+  try {
+    const data = JSON.parse(hookInput);
+    if (!data.tool_input || typeof data.tool_input !== 'object') {
+      console.error('ERROR: Invalid JSON structure');
+      process.exit(2);
+    }
+  } catch (parseError) {
+    console.error('ERROR: JSON parse failed:', parseError.message);
+    process.exit(2);
+  }
+
+  // Determine platform
+  const platform = process.platform;
+  const scriptDir = __dirname;
+
+  if (platform === 'win32') {
+    // Windows: Use PowerShell implementation
+    const psScript = path.join(scriptDir, 'scout-block.ps1');
+
+    // Check if PowerShell script exists
+    if (!fs.existsSync(psScript)) {
+      console.error(`ERROR: PowerShell script not found: ${psScript}`);
+      process.exit(2);
+    }
+
+    // Execute PowerShell script with stdin piped
+    execSync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${psScript}"`, {
+      input: hookInput,
+      stdio: ['pipe', 'inherit', 'inherit'],
+      encoding: 'utf-8'
+    });
+  } else {
+    // Unix (Linux, macOS, WSL): Use bash implementation
+    const bashScript = path.join(scriptDir, 'scout-block.sh');
+
+    // Check if bash script exists
+    if (!fs.existsSync(bashScript)) {
+      console.error(`ERROR: Bash script not found: ${bashScript}`);
+      process.exit(2);
+    }
+
+    // Execute bash script with stdin piped
+    execSync(`bash "${bashScript}"`, {
+      input: hookInput,
+      stdio: ['pipe', 'inherit', 'inherit'],
+      encoding: 'utf-8'
+    });
+  }
+} catch (error) {
+  // Log error details for debugging
+  if (error.message) {
+    console.error('ERROR:', error.message);
+  }
+
+  // Exit with error code from child process, or 2 if undefined
+  process.exit(error.status || 2);
+}

package/dist/.cursor/hooks/scout-block.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+/**
+ * scout-block.js - Cross-platform hook dispatcher
+ *
+ * Blocks access to directories listed in .cursor/.ckignore
+ * (defaults: node_modules, __pycache__, .git, dist, build)
+ *
+ * Blocking Rules:
+ * - File paths: Blocks any file_path/path/pattern containing blocked directories
+ * - Bash commands: Blocks directory access (cd, ls, cat, etc.) but ALLOWS build commands
+ *   - Blocked: cd node_modules, ls build/, cat dist/file.js
+ *   - Allowed: npm build, pnpm build, yarn build, npm run build
+ *
+ * Configuration:
+ * - Edit .cursor/.ckignore to customize blocked patterns (one per line, # for comments)
+ *
+ * Platform Detection:
+ * - Windows (win32): Uses PowerShell via scout-block.ps1
+ * - Unix (linux/darwin): Uses Bash via scout-block.sh
+ * - WSL: Automatically detects and uses bash implementation
+ *
+ * Exit Codes:
+ * - 0: Command allowed
+ * - 2: Command blocked or error occurred
+ */
+
+import { execSync } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+try {
+  // Read stdin synchronously
+  const hookInput = fs.readFileSync(0, 'utf-8');
+
+  // Validate input not empty
+  if (!hookInput || hookInput.trim().length === 0) {
+    console.error('ERROR: Empty input');
+    process.exit(2);
+  }
+
+  // Validate JSON structure (basic check)
+  try {
+    const data = JSON.parse(hookInput);
+    if (!data.tool_input || typeof data.tool_input !== 'object') {
+      console.error('ERROR: Invalid JSON structure');
+      process.exit(2);
+    }
+  } catch (parseError) {
+    console.error('ERROR: JSON parse failed:', parseError.message);
+    process.exit(2);
+  }
+
+  // Determine platform
+  const platform = process.platform;
+  const scriptDir = __dirname;
+
+  if (platform === 'win32') {
+    // Windows: Use PowerShell implementation
+    const psScript = path.join(scriptDir, 'scout-block.ps1');
+
+    // Check if PowerShell script exists
+    if (!fs.existsSync(psScript)) {
+      console.error(`ERROR: PowerShell script not found: ${psScript}`);
+      process.exit(2);
+    }
+
+    // Execute PowerShell script with stdin piped
+    execSync(`powershell -NoProfile -ExecutionPolicy Bypass -File "${psScript}"`, {
+      input: hookInput,
+      stdio: ['pipe', 'inherit', 'inherit'],
+      encoding: 'utf-8'
+    });
+  } else {
+    // Unix (Linux, macOS, WSL): Use bash implementation
+    const bashScript = path.join(scriptDir, 'scout-block.sh');
+
+    // Check if bash script exists
+    if (!fs.existsSync(bashScript)) {
+      console.error(`ERROR: Bash script not found: ${bashScript}`);
+      process.exit(2);
+    }
+
+    // Execute bash script with stdin piped
+    execSync(`bash "${bashScript}"`, {
+      input: hookInput,
+      stdio: ['pipe', 'inherit', 'inherit'],
+      encoding: 'utf-8'
+    });
+  }
+} catch (error) {
+  // Log error details for debugging
+  if (error.message) {
+    console.error('ERROR:', error.message);
+  }
+
+  // Exit with error code from child process, or 2 if undefined
+  process.exit(error.status || 2);
+}

package/dist/.cursor/hooks/scout-block.ps1

@@ -0,0 +1,92 @@
+# scout-block.ps1 - PowerShell implementation for blocking heavy directories
+# Reads patterns from .ckignore file (defaults: node_modules, __pycache__, .git, dist, build)
+#
+# Blocking Rules:
+# - File paths: Blocks any file_path/path/pattern containing blocked directories
+# - Bash commands: Blocks directory access (cd, ls, cat, etc.) but ALLOWS build commands
+#   - Blocked: cd node_modules, ls build/, cat dist/file.js
+#   - Allowed: npm build, pnpm build, yarn build, npm run build
+
+# Read JSON input from stdin
+$inputJson = $input | Out-String
+
+# Validate input not empty
+if ([string]::IsNullOrWhiteSpace($inputJson)) {
+    Write-Error "ERROR: Empty input"
+    exit 2
+}
+
+# Parse JSON (PowerShell 5.1+ compatible)
+try {
+    $hookData = $inputJson | ConvertFrom-Json
+} catch {
+    Write-Error "ERROR: Failed to parse JSON input"
+    exit 2
+}
+
+# Validate JSON structure
+if (-not $hookData.tool_input) {
+    Write-Error "ERROR: Invalid JSON structure - missing tool_input"
+    exit 2
+}
+
+# Extract tool input
+$toolInput = $hookData.tool_input
+
+# Determine script directory and .cursor folder for .ckignore lookup
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$claudeDir = Split-Path -Parent $scriptDir
+$ckignoreFile = Join-Path $claudeDir ".ckignore"
+
+# Default blocked patterns
+$blockedPatterns = @('node_modules', '__pycache__', '\.git', 'dist', 'build')
+
+# Read patterns from .ckignore if it exists
+if (Test-Path $ckignoreFile) {
+    $patterns = Get-Content $ckignoreFile |
+        ForEach-Object { $_.Trim() } |
+        Where-Object { $_ -and -not $_.StartsWith('#') }
+    if ($patterns.Count -gt 0) {
+        # Escape special regex characters
+        $blockedPatterns = $patterns | ForEach-Object { [regex]::Escape($_) }
+    }
+}
+
+# Build dynamic pattern group
+$patternGroup = $blockedPatterns -join '|'
+
+# Pattern for directory paths (used for file_path, path, pattern)
+# Handles both forward slashes (/) and backslashes (\) for cross-platform support
+$blockedDirPattern = "(^|[/\\]|\s)($patternGroup)([/\\]|`$|\s)"
+
+# Pattern for Bash commands - only block directory access, not build commands
+# Blocks: cd node_modules, ls build/, cat dist/file.js
+# Allows: npm build, pnpm build, yarn build, npm run build
+$blockedBashPattern = "(cd\s+|ls\s+|cat\s+|rm\s+|cp\s+|mv\s+|find\s+)($patternGroup)([/\\]|`$|\s)|(\s|^|[/\\])($patternGroup)[/\\]"
+
+# Check file path parameters (strict blocking)
+$fileParams = @(
+    $toolInput.file_path,    # Read, Edit, Write tools
+    $toolInput.path,         # Grep, Glob tools
+    $toolInput.pattern       # Glob, Grep tools
+)
+
+foreach ($param in $fileParams) {
+    if ($param -and ($param -is [string]) -and ($param -match $blockedDirPattern)) {
+        $patternList = ($blockedPatterns -replace '\\', '') -join ', '
+        Write-Error "ERROR: Blocked directory pattern ($patternList)"
+        exit 2
+    }
+}
+
+# Check Bash command (selective blocking - only directory access)
+if ($toolInput.command -and ($toolInput.command -is [string])) {
+    if ($toolInput.command -match $blockedBashPattern) {
+        $patternList = ($blockedPatterns -replace '\\', '') -join ', '
+        Write-Error "ERROR: Blocked directory pattern ($patternList)"
+        exit 2
+    }
+}
+
+# Allow command to proceed (exit 0)
+exit 0

package/dist/.cursor/hooks/scout-block.sh

@@ -0,0 +1,119 @@
+#!/bin/bash
+# scout-block.sh - Bash implementation for blocking heavy directories
+# Reads patterns from .ckignore file (defaults: node_modules, __pycache__, .git, dist, build)
+#
+# Blocking Rules:
+# - File paths: Blocks any file_path/path/pattern containing blocked directories
+# - Bash commands: Blocks directory access (cd, ls, cat, etc.) but ALLOWS build commands
+#   - Blocked: cd node_modules, ls build/, cat dist/file.js
+#   - Allowed: npm build, pnpm build, yarn build, npm run build
+
+# Read stdin
+INPUT=$(cat)
+
+# Validate input not empty
+if [ -z "$INPUT" ]; then
+  echo "ERROR: Empty input" >&2
+  exit 2
+fi
+
+# Determine script directory for .ckignore lookup
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Look for .ckignore in .cursor/ folder (1 level up from .cursor/hooks/)
+CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+CKIGNORE_FILE="$CLAUDE_DIR/.ckignore"
+
+# Parse JSON and extract all relevant parameters using Node.js
+CHECK_RESULT=$(echo "$INPUT" | CKIGNORE_FILE="$CKIGNORE_FILE" node -e "
+const fs = require('fs');
+const path = require('path');
+
+try {
+  const input = fs.readFileSync(0, 'utf-8');
+  const data = JSON.parse(input);
+
+  if (!data.tool_input || typeof data.tool_input !== 'object') {
+    // If JSON structure is invalid, allow operation with warning
+    console.error('WARN: Invalid JSON structure, allowing operation');
+    console.log('ALLOWED');
+    process.exit(0);
+  }
+
+  const toolInput = data.tool_input;
+
+  // Read patterns from .ckignore file
+  const ckignorePath = process.env.CKIGNORE_FILE;
+  let blockedPatterns = ['node_modules', '__pycache__', '.git', 'dist', 'build']; // defaults
+
+  if (ckignorePath && fs.existsSync(ckignorePath)) {
+    const content = fs.readFileSync(ckignorePath, 'utf-8');
+    const patterns = content
+      .split('\n')
+      .map(line => line.trim())
+      .filter(line => line && !line.startsWith('#'));
+    if (patterns.length > 0) {
+      blockedPatterns = patterns;
+    }
+  }
+
+  // Escape special regex characters and build dynamic patterns
+  const escapeRegex = (str) => str.replace(/[.*+?^\${}()|[\]\\\\]/g, '\\\\$&');
+  const escapedPatterns = blockedPatterns.map(escapeRegex);
+  const patternGroup = escapedPatterns.join('|');
+
+  // Pattern for directory paths (used for file_path, path, pattern)
+  const blockedDirPattern = new RegExp('(^|/|\\\\s)(' + patternGroup + ')(/|\$|\\\\s)');
+
+  // Pattern for Bash commands - only block directory access, not build commands
+  // Blocks: cd node_modules, ls build/, cat dist/file.js
+  // Allows: npm build, pnpm build, yarn build, npm run build
+  const blockedBashPattern = new RegExp(
+    '(cd\\\\s+|ls\\\\s+|cat\\\\s+|rm\\\\s+|cp\\\\s+|mv\\\\s+|find\\\\s+)(' + patternGroup + ')(/|\$|\\\\s)|' +
+    '(\\\\s|^|/)(' + patternGroup + ')/'
+  );
+
+  // Check file path parameters (strict blocking)
+  const fileParams = [
+    toolInput.file_path,    // Read, Edit, Write tools
+    toolInput.path,         // Grep, Glob tools
+    toolInput.pattern       // Glob, Grep tools
+  ];
+
+  for (const param of fileParams) {
+    if (param && typeof param === 'string' && blockedDirPattern.test(param)) {
+      console.log('BLOCKED');
+      process.exit(0);
+    }
+  }
+
+  // Check Bash command (selective blocking - only directory access)
+  if (toolInput.command && typeof toolInput.command === 'string') {
+    if (blockedBashPattern.test(toolInput.command)) {
+      console.log('BLOCKED');
+      process.exit(0);
+    }
+  }
+
+  console.log('ALLOWED');
+} catch (error) {
+  // If JSON parsing fails, allow operation with warning (fail-open approach)
+  // This prevents hook configuration issues from blocking all operations
+  console.error('WARN: JSON parse failed, allowing operation -', error.message);
+  console.log('ALLOWED');
+  process.exit(0);
+}
+")
+
+# Check if parsing failed
+if [ $? -ne 0 ]; then
+  exit 2
+fi
+
+# Check result
+if [ "$CHECK_RESULT" = "BLOCKED" ]; then
+  echo "ERROR: Blocked directory pattern (node_modules, __pycache__, .git/, dist/, build/)" >&2
+  exit 2
+fi
+
+# Allow command (exit 0)
+exit 0

package/dist/.cursor/hooks/send-discord.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+
+# Usage: ./send-discord.sh 'Your message here'
+# Note: Remember to escape the string
+
+# Load environment variables with priority: process.env > .cursor/.env > .cursor/hooks/.env
+load_env() {
+    # 1. Start with lowest priority: .cursor/hooks/.env
+    if [[ -f "$(dirname "$0")/.env" ]]; then
+        set -a
+        source "$(dirname "$0")/.env"
+        set +a
+    fi
+
+    # 2. Override with .cursor/.env
+    if [[ -f .cursor/.env ]]; then
+        set -a
+        source .cursor/.env
+        set +a
+    fi
+
+    # 3. Process env (already loaded) has highest priority - no action needed
+    # Variables already in process.env will not be overwritten by 'source'
+}
+
+load_env
+
+message="$1"
+    
+if [[ -z "$DISCORD_WEBHOOK_URL" ]]; then
+    echo "⚠️  Discord notification skipped: DISCORD_WEBHOOK_URL not set"
+    exit 1
+fi
+
+# Prepare message for Discord (Discord markdown supports \n)
+discord_message="$message"
+
+# Discord embeds for richer formatting
+payload=$(cat <<EOF
+{
+"embeds": [{
+    "title": "🤖 Claude Code Session Complete",
+    "description": "$discord_message",
+    "color": 5763719,
+    "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)",
+    "footer": {
+        "text": "DevPocket API • $(basename "$(pwd)")"
+    },
+    "fields": [
+        {
+            "name": "⏰ Session Time",
+            "value": "$(date '+%H:%M:%S')",
+            "inline": true
+        },
+        {
+            "name": "📂 Project",
+            "value": "$(basename "$(pwd)")",
+            "inline": true
+        }
+    ]
+}]
+}
+EOF
+)
+
+curl -s -X POST "$DISCORD_WEBHOOK_URL" \
+    -H "Content-Type: application/json" \
+    -d "$payload" >/dev/null 2>&1
+
+if [[ $? -eq 0 ]]; then
+    echo "✅ Discord notification sent"
+else
+    echo "❌ Failed to send Discord notification"
+    exit 1
+fi