jettypod 4.4.55 → 4.4.56

package/claude-hooks/global-guardrails.js

@@ -11,14 +11,40 @@
 const fs = require('fs');
 const path = require('path');
 
+// Debug mode: set GUARDRAILS_DEBUG=1 to enable verbose logging
+const DEBUG = process.env.GUARDRAILS_DEBUG === '1';
+
+/**
+ * Structured debug logger - outputs to stderr to not interfere with JSON response
+ */
+function debug(category, data) {
+  if (!DEBUG) return;
+  const timestamp = new Date().toISOString();
+  const logEntry = { timestamp, category, ...data };
+  console.error(`[guardrails] ${JSON.stringify(logEntry)}`);
+}
+
 // Read hook input from stdin
 let input = '';
 process.stdin.on('data', chunk => input += chunk);
 process.stdin.on('end', () => {
   try {
     const hookInput = JSON.parse(input);
+    debug('input', {
+      tool: hookInput.tool_name,
+      cwd: hookInput.cwd,
+      active_worktree: hookInput.active_worktree_path,
+      branch: hookInput.current_branch
+    });
+
     const result = evaluateRequest(hookInput);
 
+    debug('decision', {
+      tool: hookInput.tool_name,
+      allowed: result.allowed,
+      message: result.message || null
+    });
+
     if (result.allowed) {
       allow();
     } else {
@@ -26,6 +52,7 @@ process.stdin.on('end', () => {
     }
   } catch (err) {
     // On parse error, allow (fail open)
+    debug('error', { type: 'parse', message: err.message });
     console.error('Hook error:', err.message);
     allow();
   }
@@ -159,6 +186,7 @@ function findDatabasePath(cwd) {
 function getActiveWorktreePathFromDB(cwd) {
   const dbPath = findDatabasePath(cwd);
   if (!dbPath) {
+    debug('db_lookup', { status: 'no_db_found', cwd });
     return null;
   }
 
@@ -170,8 +198,11 @@ function getActiveWorktreePathFromDB(cwd) {
       `SELECT worktree_path FROM worktrees WHERE status = 'active' LIMIT 1`
     ).get();
     db.close();
-    return row ? row.worktree_path : null;
+    const result = row ? row.worktree_path : null;
+    debug('db_lookup', { status: 'success', method: 'better-sqlite3', worktree: result });
+    return result;
   } catch (err) {
+    debug('db_lookup', { status: 'fallback', reason: err.message });
     // Fall back to CLI
     const { spawnSync } = require('child_process');
     const result = spawnSync('sqlite3', [
@@ -180,9 +211,12 @@ function getActiveWorktreePathFromDB(cwd) {
     ], { encoding: 'utf-8' });
 
     if (result.error || result.status !== 0) {
+      debug('db_lookup', { status: 'cli_failed', error: result.error?.message || 'non-zero exit' });
       return null;
     }
-    return result.stdout.trim() || null;
+    const worktree = result.stdout.trim() || null;
+    debug('db_lookup', { status: 'success', method: 'sqlite3-cli', worktree });
+    return worktree;
   }
 }
 
@@ -197,6 +231,13 @@ function evaluateWriteOperation(filePath, inputWorktreePath, cwd) {
   const normalizedPath = path.resolve(cwd || '.', filePath);
   const normalizedWorktree = activeWorktreePath ? path.resolve(cwd || '.', activeWorktreePath) : null;
 
+  debug('write_eval', {
+    filePath,
+    normalizedPath,
+    activeWorktreePath,
+    normalizedWorktree
+  });
+
   // BLOCKED: Protected files (skills, hooks)
   const protectedPatterns = [
     /\.claude\/skills\//i,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jettypod",
-  "version": "4.4.55",
+  "version": "4.4.56",
   "description": "AI-powered development workflow manager with TDD, BDD, and automatic test generation",
   "main": "jettypod.js",
   "bin": {