xtrm-tools 0.5.21 → 0.5.23

package/hooks/quality-check.py

@@ -26,20 +26,20 @@ class Colors:
     RESET = '\x1b[0m'
 
 def log_info(msg: str):
-    print(f"{Colors.BLUE}[INFO]{Colors.RESET} {msg}", file=sys.stderr)
+    print(f"{Colors.BLUE}[INFO]{Colors.RESET} {msg}")
 
 def log_error(msg: str):
-    print(f"{Colors.RED}[ERROR]{Colors.RESET} {msg}", file=sys.stderr)
+    print(f"{Colors.RED}[ERROR]{Colors.RESET} {msg}")
 
 def log_success(msg: str):
-    print(f"{Colors.GREEN}[OK]{Colors.RESET} {msg}", file=sys.stderr)
+    print(f"{Colors.GREEN}[OK]{Colors.RESET} {msg}")
 
 def log_warning(msg: str):
-    print(f"{Colors.YELLOW}[WARN]{Colors.RESET} {msg}", file=sys.stderr)
+    print(f"{Colors.YELLOW}[WARN]{Colors.RESET} {msg}")
 
 def log_debug(msg: str):
     if os.environ.get('CLAUDE_HOOKS_DEBUG', 'false').lower() == 'true':
-        print(f"{Colors.CYAN}[DEBUG]{Colors.RESET} {msg}", file=sys.stderr)
+        print(f"{Colors.CYAN}[DEBUG]{Colors.RESET} {msg}")
 
 def find_project_root(file_path: str) -> str:
     """Find project root by looking for pyproject.toml, setup.py, or .git"""
@@ -203,20 +203,20 @@ def check_pytest_suggestions(file_path: str, project_root: str):
 def print_summary(errors: list[str], autofixes: list[str]):
     """Print summary of errors and autofixes"""
     if autofixes:
-        print(f'\n{Colors.BLUE}═══ Auto-fixes Applied ═══{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.BLUE}═══ Auto-fixes Applied ═══{Colors.RESET}')
         for fix in autofixes:
-            print(f'{Colors.GREEN}✨{Colors.RESET} {fix}', file=sys.stderr)
-        print(f'{Colors.GREEN}Automatically fixed {len(autofixes)} issue(s)!{Colors.RESET}', file=sys.stderr)
+            print(f'{Colors.GREEN}✨{Colors.RESET} {fix}')
+        print(f'{Colors.GREEN}Automatically fixed {len(autofixes)} issue(s)!{Colors.RESET}')
     
     if errors:
-        print(f'\n{Colors.BLUE}═══ Quality Check Summary ═══{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.BLUE}═══ Quality Check Summary ═══{Colors.RESET}')
         for error in errors:
-            print(f'{Colors.RED}❌{Colors.RESET} {error}', file=sys.stderr)
-        print(f'\n{Colors.RED}Found {len(errors)} issue(s) that MUST be fixed!{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.RED}══════════════════════════════════════{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.RED}❌ ALL ISSUES ARE BLOCKING ❌{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.RED}══════════════════════════════════════{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.RED}Fix EVERYTHING above until all checks are ✅ GREEN{Colors.RESET}', file=sys.stderr)
+            print(f'{Colors.RED}❌{Colors.RESET} {error}')
+        print(f'\n{Colors.RED}Found {len(errors)} issue(s) that MUST be fixed!{Colors.RESET}')
+        print(f'{Colors.RED}══════════════════════════════════════{Colors.RESET}')
+        print(f'{Colors.RED}❌ ALL ISSUES ARE BLOCKING ❌{Colors.RESET}')
+        print(f'{Colors.RED}══════════════════════════════════════{Colors.RESET}')
+        print(f'{Colors.RED}Fix EVERYTHING above until all checks are ✅ GREEN{Colors.RESET}')
 
 def parse_json_input() -> dict:
     """Parse JSON input from stdin"""
@@ -224,7 +224,7 @@ def parse_json_input() -> dict:
     
     if not input_data:
         log_warning('No JSON input provided.')
-        print(f'\n{Colors.YELLOW}👉 Hook executed but no input to process.{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.YELLOW}👉 Hook executed but no input to process.{Colors.RESET}')
         sys.exit(0)
     
     try:
@@ -253,9 +253,9 @@ def extract_file_path(input_data: dict) -> str | None:
 
 def main():
     """Main entry point"""
-    print('', file=sys.stderr)
-    print(f'📦 Python Quality Check - Starting...', file=sys.stderr)
-    print('─────────────────────────────────────', file=sys.stderr)
+    print('')
+    print(f'📦 Python Quality Check - Starting...')
+    print('─────────────────────────────────────')
     
     # Parse input
     input_data = parse_json_input()
@@ -263,25 +263,25 @@ def main():
     
     if not file_path:
         log_warning('No file path found in JSON input.')
-        print(f'\n{Colors.YELLOW}👉 No file to check - tool may not be file-related.{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.YELLOW}👉 No file to check - tool may not be file-related.{Colors.RESET}')
         sys.exit(0)
     
     # Check if file exists
     if not Path(file_path).exists():
         log_info(f'File does not exist: {file_path}')
-        print(f'\n{Colors.YELLOW}👉 File skipped - doesn\'t exist.{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.YELLOW}👉 File skipped - doesn\'t exist.{Colors.RESET}')
         sys.exit(0)
     
     # Skip non-Python files
     if not is_python_file(file_path):
         log_info(f'Skipping non-Python file: {file_path}')
-        print(f'\n{Colors.GREEN}✅ No checks needed for {os.path.basename(file_path)}{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.GREEN}✅ No checks needed for {os.path.basename(file_path)}{Colors.RESET}')
         sys.exit(0)
     
     # Update header
-    print('', file=sys.stderr)
-    print(f'🔍 Validating: {os.path.basename(file_path)}', file=sys.stderr)
-    print('─────────────────────────────────────', file=sys.stderr)
+    print('')
+    print(f'🔍 Validating: {os.path.basename(file_path)}')
+    print('─────────────────────────────────────')
     log_info(f'Checking: {file_path}')
     
     # Find project root
@@ -290,7 +290,7 @@ def main():
 
     if not has_python_project_config(project_root):
         log_info('No pyproject.toml or .python-version found - skipping Python quality checks')
-        print(f'\n{Colors.GREEN}✅ No Python project config detected; skipping checks for {os.path.basename(file_path)}{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.GREEN}✅ No Python project config detected; skipping checks for {os.path.basename(file_path)}{Colors.RESET}')
         sys.exit(0)
     
     # Get config from environment
@@ -317,20 +317,20 @@ def main():
     
     # Exit with appropriate code
     if all_errors:
-        print(f'\n{Colors.RED}🛑 FAILED - Fix issues in your edited file! 🛑{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.CYAN}💡 CLAUDE.md CHECK:{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.CYAN}  → What CLAUDE.md pattern would have prevented this?{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.YELLOW}📋 NEXT STEPS:{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.YELLOW}  1. Fix the issues listed above{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.YELLOW}  2. The hook will run again automatically{Colors.RESET}', file=sys.stderr)
-        print(f'{Colors.YELLOW}  3. Continue once all checks pass{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.RED}🛑 FAILED - Fix issues in your edited file! 🛑{Colors.RESET}')
+        print(f'{Colors.CYAN}💡 CLAUDE.md CHECK:{Colors.RESET}')
+        print(f'{Colors.CYAN}  → What CLAUDE.md pattern would have prevented this?{Colors.RESET}')
+        print(f'{Colors.YELLOW}📋 NEXT STEPS:{Colors.RESET}')
+        print(f'{Colors.YELLOW}  1. Fix the issues listed above{Colors.RESET}')
+        print(f'{Colors.YELLOW}  2. The hook will run again automatically{Colors.RESET}')
+        print(f'{Colors.YELLOW}  3. Continue once all checks pass{Colors.RESET}')
         sys.exit(2)
     else:
-        print(f'\n{Colors.GREEN}✅ Quality check passed for {os.path.basename(file_path)}{Colors.RESET}', file=sys.stderr)
+        print(f'\n{Colors.GREEN}✅ Quality check passed for {os.path.basename(file_path)}{Colors.RESET}')
         if all_autofixes:
-            print(f'\n{Colors.YELLOW}👉 File quality verified. Auto-fixes applied. Continue with your task.{Colors.RESET}', file=sys.stderr)
+            print(f'\n{Colors.YELLOW}👉 File quality verified. Auto-fixes applied. Continue with your task.{Colors.RESET}')
         else:
-            print(f'\n{Colors.YELLOW}👉 File quality verified. Continue with your task.{Colors.RESET}', file=sys.stderr)
+            print(f'\n{Colors.YELLOW}👉 File quality verified. Continue with your task.{Colors.RESET}')
         
         # Suggest tests
         check_pytest_suggestions(file_path, project_root)

package/hooks/xtrm-logger.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+// xtrm-logger.mjs — shared event logger for xtrm hook and bd lifecycle events
+//
+// Writes to the xtrm_events table in the project's beads Dolt DB.
+// Self-initializing: creates the table on first write if it doesn't exist.
+// Fails completely silently — logging NEVER affects hook behavior.
+//
+// Usage (from any hook):
+//   import { logEvent } from './xtrm-logger.mjs';
+//   logEvent({ cwd, runtime: 'claude', sessionId, layer: 'gate', kind: 'hook.edit_gate.block',
+//              outcome: 'block', toolName, issueId, message, extra });
+
+import { spawnSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+
+// ── Schema ────────────────────────────────────────────────────────────────────
+
+const CREATE_SQL = `CREATE TABLE IF NOT EXISTS xtrm_events (
+  id          VARCHAR(36)   NOT NULL,
+  created_at  DATETIME      NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  runtime     VARCHAR(16)   NOT NULL,
+  session_id  VARCHAR(255)  NOT NULL,
+  worktree    VARCHAR(255)  DEFAULT NULL,
+  layer       VARCHAR(16)   NOT NULL,
+  kind        VARCHAR(64)   NOT NULL,
+  outcome     VARCHAR(8)    NOT NULL,
+  tool_name   VARCHAR(255)  DEFAULT NULL,
+  issue_id    VARCHAR(255)  DEFAULT NULL,
+  message     TEXT          DEFAULT NULL,
+  extra       JSON          DEFAULT NULL,
+  PRIMARY KEY (id),
+  INDEX idx_session (session_id(64)),
+  INDEX idx_kind (kind),
+  INDEX idx_created (created_at)
+)`;
+
+// ── SQL helpers ───────────────────────────────────────────────────────────────
+
+/**
+ * Escape a value for use in a MySQL single-quoted string literal.
+ * Returns the quoted string, or NULL for null/undefined.
+ */
+function sqlEscape(val) {
+  if (val === null || val === undefined) return 'NULL';
+  const str = String(val)
+    .replace(/\\/g, '\\\\')   // backslash first
+    .replace(/'/g, "''")      // single-quote → doubled
+    .replace(/\0/g, '');      // strip null bytes (invalid in utf8 strings)
+  return `'${str}'`;
+}
+
+function bdSql(sql, cwd) {
+  return spawnSync('bd', ['sql', sql], {
+    cwd,
+    stdio: ['pipe', 'pipe', 'pipe'],
+    encoding: 'utf8',
+    timeout: 5000,
+  });
+}
+
+// ── Public API ────────────────────────────────────────────────────────────────
+
+/**
+ * Log an xtrm event to the beads xtrm_events table.
+ *
+ * @param {object}  params
+ * @param {string}  params.cwd         Project working directory (required)
+ * @param {string}  params.runtime     'claude' | 'pi'
+ * @param {string}  params.sessionId   Claude session UUID or Pi PID string
+ * @param {string}  params.layer       'gate' | 'bd'
+ * @param {string}  params.kind        e.g. 'hook.edit_gate.block', 'bd.claimed'
+ * @param {string}  params.outcome     'allow' | 'block'
+ * @param {string}  [params.toolName]  Tool intercepted (gates)
+ * @param {string}  [params.issueId]   Linked beads issue ID
+ * @param {string}  [params.message]   Full message sent to agent (blocks)
+ * @param {object}  [params.extra]     Additional structured data {file, cwd, reason_code, ...}
+ *
+ * @returns {string|null} The event UUID, or null if logging failed
+ */
+export function logEvent(params) {
+  try {
+    const { cwd, runtime, sessionId, layer, kind, outcome } = params;
+    if (!cwd || !runtime || !sessionId || !layer || !kind || !outcome) return null;
+
+    const { toolName, issueId, message, extra } = params;
+
+    // Derive worktree name if cwd is inside .xtrm/worktrees/<name>
+    const worktreeMatch = cwd.match(/\.xtrm\/worktrees\/([^/]+)/);
+    const worktree = worktreeMatch ? worktreeMatch[1] : null;
+
+    const id = randomUUID();
+    const extraJson = extra ? JSON.stringify(extra) : null;
+
+    const cols = 'id, runtime, session_id, worktree, layer, kind, outcome, tool_name, issue_id, message, extra';
+    const vals = [
+      sqlEscape(id),
+      sqlEscape(runtime),
+      sqlEscape(sessionId),
+      sqlEscape(worktree),
+      sqlEscape(layer),
+      sqlEscape(kind),
+      sqlEscape(outcome),
+      sqlEscape(toolName ?? null),
+      sqlEscape(issueId ?? null),
+      sqlEscape(message ?? null),
+      sqlEscape(extraJson),
+    ].join(', ');
+
+    const insertSql = `INSERT INTO xtrm_events (${cols}) VALUES (${vals})`;
+
+    let result = bdSql(insertSql, cwd);
+    if (result.status !== 0) {
+      // Table may not exist yet — create it and retry once (self-initializing)
+      bdSql(CREATE_SQL, cwd);
+      result = bdSql(insertSql, cwd);
+    }
+
+    return result.status === 0 ? id : null;
+  } catch {
+    // Silently swallow all errors — logging never affects hook behavior
+    return null;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xtrm-tools",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "description": "Claude Code tools installer (skills, hooks, MCP servers)",
   "license": "MIT",
   "type": "module",