xtrm-tools 0.7.0 → 0.7.2

package/plugins/xtrm-tools/hooks/beads-gate-utils.mjs

@@ -1,176 +0,0 @@
-#!/usr/bin/env node
-// beads-gate-utils.mjs — shared infrastructure for beads gate hooks
-// Import from sibling hooks using: import { ... } from './beads-gate-utils.mjs';
-// Static ES module imports resolve relative to the importing file's location,
-// not CWD, so this works regardless of the project directory.
-
-import { execSync } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-
-/** Resolve project cwd from hook input JSON. */
-export function resolveCwd(input) {
-  return input.cwd ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
-}
-
-/**
- * Resolve a stable session key for beads hooks.
- * Priority: explicit hook session id -> cwd fallback.
- */
-export function resolveSessionId(input) {
-  return input?.session_id ?? input?.sessionId ?? resolveCwd(input);
-}
-
-/** Return true if the directory contains a .beads project. */
-export function isBeadsProject(cwd) {
-  return existsSync(join(cwd, '.beads'));
-}
-
-/**
- * Get the claimed issue ID for a session from bd kv.
- * Returns: issue ID string if claimed, '' if not set, null if bd kv unavailable.
- * Note: bd kv get exits 1 for missing keys — execSync throws, so we check err.status.
- */
-export function getSessionClaim(sessionId, cwd) {
-  try {
-    return execSync(`bd kv get "claimed:${sessionId}"`, {
-      encoding: 'utf8',
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 5000,
-    }).trim();
-  } catch (err) {
-    if (err.status === 1) return ''; // key not found — no claim
-    return null;                     // command failed — bd kv unavailable
-  }
-}
-
-/**
- * Parse work counts from a bd list output string.
- * Reads the "Total: N issues (X open, Y in progress)" summary line.
- * Returns { open, inProgress } or null if the line is absent.
- *
- * This is more reliable than counting symbols or tokens: the Total line is
- * a structured summary that doesn't depend on status-legend text or box-drawing
- * characters, and it's present in all non-empty bd list outputs.
- */
-function parseCounts(output) {
-  const m = output.match(/Total:\s*\d+\s+issues?\s*\((\d+)\s+open,\s*(\d+)\s+in progress\)/);
-  if (!m) return null;
-  return { open: parseInt(m[1], 10), inProgress: parseInt(m[2], 10) };
-}
-
-/**
- * Get in_progress issues as { count, summary }.
- * Returns null if bd is unavailable.
- */
-export function getInProgress(cwd) {
-  try {
-    const output = execSync('bd list --status=in_progress', {
-      encoding: 'utf8', cwd, stdio: ['pipe', 'pipe', 'pipe'], timeout: 8000,
-    });
-    const counts = parseCounts(output);
-    return {
-      count: counts?.inProgress ?? 0,
-      summary: output.trim(),
-    };
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Return true if a specific issue ID is currently in in_progress status.
- * Used by commit/stop gates to scope the check to the session's own claimed issue.
- * Returns false (fail open) if bd is unavailable.
- */
-export function isIssueInProgress(issueId, cwd) {
-  if (!issueId) return false;
-  try {
-    const output = execSync('bd list --status=in_progress', {
-      encoding: 'utf8', cwd, stdio: ['pipe', 'pipe', 'pipe'], timeout: 8000,
-    });
-    return output.includes(issueId);
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Count total trackable work (open + in_progress issues) using a single bd list call.
- * Returns the count, or null if bd is unavailable.
- */
-export function getTotalWork(cwd) {
-  try {
-    // Use default status filter (non-closed) and parse Total summary.
-    // Repeating --status is not additive in bd CLI and can collapse to one status.
-    const output = execSync('bd list', {
-      encoding: 'utf8', cwd, stdio: ['pipe', 'pipe', 'pipe'], timeout: 8000,
-    });
-    const counts = parseCounts(output);
-    if (!counts) return 0; // "No issues found." — nothing to track
-    return counts.open + counts.inProgress;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Get the closed-this-session issue ID for a session from bd kv.
- * Returns: issue ID string if set, '' if not set, null if bd kv unavailable.
- */
-export function getClosedThisSession(sessionId, cwd) {
-  try {
-    return execSync(`bd kv get "closed-this-session:${sessionId}"`, {
-      encoding: 'utf8',
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 5000,
-    }).trim();
-  } catch (err) {
-    if (err.status === 1) return ''; // key not found
-    return null;                     // bd kv unavailable
-  }
-}
-
-/**
- * If cwd is inside a .xtrm/worktrees/<name> directory, return the worktree root path.
- * Returns null if not in a worktree.
- */
-export function resolveWorktreeRoot(cwd) {
-  const m = cwd.match(/^(.+\/\.xtrm\/worktrees\/[^/]+)/);
-  return m ? m[1] : null;
-}
-
-/**
- * Clear the session claim key from bd kv. Non-fatal — best-effort cleanup.
- */
-export function clearSessionClaim(sessionId, cwd) {
-  try {
-    execSync(`bd kv clear "claimed:${sessionId}"`, {
-      encoding: 'utf8', cwd, stdio: ['pipe', 'pipe', 'pipe'], timeout: 5000,
-    });
-  } catch {
-    // non-fatal
-  }
-}
-
-/**
- * Option C: wrap hook body with uniform fail-open error handling.
- * Any unexpected top-level throw exits 0 (allow) rather than crashing visibly.
- *
- * Usage:
- *   withSafeBdContext(() => {
- *     // hook logic here — call process.exit() to set exit code
- *   });
- */
-export function withSafeBdContext(fn) {
-  try {
-    fn();
-  } catch (err) {
-    if (err instanceof TypeError || err instanceof ReferenceError || err instanceof SyntaxError) {
-      throw err;
-    }
-    process.exit(0);
-  }
-}

package/plugins/xtrm-tools/hooks/beads-memory-gate.mjs

@@ -1,94 +0,0 @@
-#!/usr/bin/env node
-// beads-memory-gate — Claude Code Stop hook
-// At session end, forces the agent to evaluate whether this session's work
-// produced insights worth persisting via `bd remember`.
-// Runs after beads-stop-gate (all issues already closed by that point).
-// Exit 0: allow stop  |  Exit 2: block stop (stderr shown to Claude)
-//
-// Installed by: xtrm install
-
-import { execSync } from 'node:child_process';
-import { readHookInput } from './beads-gate-core.mjs';
-import { resolveCwd, resolveSessionId, isBeadsProject, getSessionClaim, clearSessionClaim } from './beads-gate-utils.mjs';
-import { memoryPromptMessage } from './beads-gate-messages.mjs';
-import { logEvent } from './xtrm-logger.mjs';
-
-const input = readHookInput();
-if (!input) process.exit(0);
-
-const cwd = resolveCwd(input);
-if (!cwd || !isBeadsProject(cwd)) process.exit(0);
-
-const sessionId = resolveSessionId(input);
-
-// Agent signals evaluation complete via bd kv (works across worktree redirects)
-let memoryGateDone = false;
-try {
-  execSync(`bd kv get "memory-gate-done:${sessionId}"`, {
-    cwd,
-    stdio: ['pipe', 'pipe', 'pipe'],
-    timeout: 5000,
-  });
-  memoryGateDone = true;
-} catch { /* key not set → not done */ }
-
-if (memoryGateDone) {
-  try {
-    execSync(`bd kv clear "memory-gate-done:${sessionId}"`, {
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 5000,
-    });
-  } catch { /* ignore */ }
-  // Clear the claim and closed-this-session marker
-  clearSessionClaim(sessionId, cwd);
-  try {
-    execSync(`bd kv clear "closed-this-session:${sessionId}"`, {
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 5000,
-    });
-  } catch { /* ignore */ }
-  logEvent({
-    cwd,
-    runtime: 'claude',
-    sessionId,
-    layer: 'gate',
-    kind: 'gate.memory.acked',
-    outcome: 'allow',
-  });
-  process.exit(0);
-}
-
-// Check if an issue was closed this session (set by beads-claim-sync on bd close)
-let closedIssueId = null;
-try {
-  closedIssueId = execSync(`bd kv get "closed-this-session:${sessionId}"`, {
-    encoding: 'utf8',
-    cwd,
-    stdio: ['pipe', 'pipe', 'pipe'],
-    timeout: 5000,
-  }).trim();
-} catch (err) {
-  if (err.status === 1) {
-    // No closed-this-session marker → nothing to prompt about
-    process.exit(0);
-  }
-  process.exit(0); // fail open
-}
-
-if (!closedIssueId) process.exit(0);
-
-const memoryMessage = memoryPromptMessage(closedIssueId, sessionId);
-logEvent({
-  cwd,
-  runtime: 'claude',
-  sessionId,
-  layer: 'gate',
-  kind: 'gate.memory.triggered',
-  outcome: 'nudge',
-  issueId: closedIssueId,
-  message: memoryMessage,
-});
-process.stdout.write(JSON.stringify({ additionalContext: memoryMessage }) + '\n');
-process.exit(0);

package/plugins/xtrm-tools/hooks/beads-stop-gate.mjs

@@ -1,53 +0,0 @@
-#!/usr/bin/env node
-// beads-stop-gate — Claude Code Stop hook
-// Blocks the agent from stopping when this session has an unclosed claim in bd kv.
-// Also blocks when xtrm session state indicates unfinished closure phases.
-// Exit 0: allow stop  |  Exit 2: block stop (stderr shown to Claude)
-
-import {
-  readHookInput,
-  resolveSessionContext,
-  resolveClaimAndWorkState,
-  decideStopGate,
-} from './beads-gate-core.mjs';
-import { withSafeBdContext } from './beads-gate-utils.mjs';
-import { stopBlockMessage } from './beads-gate-messages.mjs';
-import { logEvent } from './xtrm-logger.mjs';
-
-const input = readHookInput();
-if (!input) process.exit(0);
-
-withSafeBdContext(() => {
-  const ctx = resolveSessionContext(input);
-  if (!ctx || !ctx.isBeadsProject) process.exit(0);
-
-  const state = resolveClaimAndWorkState(ctx);
-  const decision = decideStopGate(ctx, state);
-
-  if (!decision.allow) {
-    const message = stopBlockMessage(decision.summary, decision.claimed);
-    logEvent({
-      cwd: ctx.cwd,
-      runtime: 'claude',
-      sessionId: ctx.sessionId,
-      layer: 'gate',
-      kind: 'gate.stop.nudge',
-      outcome: 'nudge',
-      issueId: decision.claimed ?? null,
-      message,
-      extra: { reason_code: decision.reason },
-    });
-    process.stdout.write(JSON.stringify({ additionalContext: message }) + '\n');
-    process.exit(0);
-  }
-
-  logEvent({
-    cwd: ctx.cwd,
-    runtime: 'claude',
-    sessionId: ctx.sessionId,
-    layer: 'gate',
-    kind: 'session.end',
-    outcome: 'allow',
-  });
-  process.exit(0);
-});

package/plugins/xtrm-tools/hooks/gitnexus/gitnexus-hook.cjs

@@ -1,222 +0,0 @@
-#!/usr/bin/env node
-/**
- * GitNexus Claude Code Hook — PostToolUse enrichment
- *
- * Fires AFTER Bash/Grep/Read/Glob/Serena tools complete.
- * Extracts patterns from both tool input AND output, runs
- * `gitnexus augment <pattern>`, and injects a [GitNexus: ...]
- * block into Claude's context — mirroring pi-gitnexus behavior.
- *
- * Features:
- *  - PostToolUse (vs old PreToolUse) — enriches actual result
- *  - Session-keyed dedup cache (/tmp) — no redundant lookups
- *  - Pattern extraction from output content (grep-style scanning)
- *  - Serena tool support — extracts symbol names from name_path
- *  - Graceful failure — always exits 0
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { spawnSync } = require('child_process');
-
-const CODE_EXTS = new Set([
-  '.ts', '.tsx', '.js', '.mjs', '.cjs', '.py', '.go', '.rs',
-  '.java', '.kt', '.cpp', '.c', '.h', '.rb', '.php', '.cs',
-]);
-
-const SERENA_SYMBOL_TOOLS = new Set([
-  'mcp__serena__find_symbol',
-  'mcp__serena__find_referencing_symbols',
-  'mcp__serena__replace_symbol_body',
-  'mcp__serena__insert_after_symbol',
-  'mcp__serena__insert_before_symbol',
-]);
-
-const SERENA_FILE_TOOLS = new Set([
-  'mcp__serena__get_symbols_overview',
-  'mcp__serena__search_for_pattern',
-]);
-
-const SERENA_RENAME = 'mcp__serena__rename_symbol';
-
-function readInput() {
-  try {
-    return JSON.parse(fs.readFileSync(0, 'utf-8'));
-  } catch {
-    return {};
-  }
-}
-
-function findGitNexusIndex(startDir) {
-  let dir = startDir || process.cwd();
-  for (let i = 0; i < 6; i++) {
-    if (fs.existsSync(path.join(dir, '.gitnexus'))) return true;
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return false;
-}
-
-function getCacheFile(sessionId) {
-  const id = sessionId ? sessionId.replace(/[^a-zA-Z0-9_-]/g, '_') : 'default';
-  return path.join(os.tmpdir(), `gitnexus-aug-${id}`);
-}
-
-function loadCache(cacheFile) {
-  try {
-    return new Set(fs.readFileSync(cacheFile, 'utf-8').split('\n').filter(Boolean));
-  } catch {
-    return new Set();
-  }
-}
-
-function saveToCache(cacheFile, pattern) {
-  try {
-    fs.appendFileSync(cacheFile, pattern + '\n');
-  } catch { /* graceful */ }
-}
-
-function symbolFromNamePath(namePath) {
-  if (!namePath) return null;
-  const parts = namePath.split('/').filter(Boolean);
-  const last = parts[parts.length - 1];
-  return last ? last.replace(/\[\d+\]$/, '') : null;
-}
-
-function symbolFromFilePath(filePath) {
-  if (!filePath) return null;
-  const ext = path.extname(filePath);
-  if (!CODE_EXTS.has(ext)) return null;
-  return path.basename(filePath, ext);
-}
-
-function extractFilePatternsFromOutput(content) {
-  if (!content || typeof content !== 'string') return [];
-  const patterns = new Set();
-  const lines = content.split('\n').slice(0, 50);
-  for (const line of lines) {
-    const m = line.match(/^([^\s:]+\.[a-z]{1,5}):\d+:/);
-    if (m) {
-      const ext = path.extname(m[1]);
-      if (CODE_EXTS.has(ext)) patterns.add(path.basename(m[1], ext));
-    }
-  }
-  return [...patterns];
-}
-
-function extractPatterns(toolName, toolInput, toolResponse) {
-  const patterns = [];
-  const content = typeof toolResponse === 'string'
-    ? toolResponse
-    : (toolResponse?.content ?? toolResponse?.output ?? '');
-
-  if (toolName === 'Read') {
-    const sym = symbolFromFilePath(toolInput.file_path);
-    if (sym) patterns.push(sym);
-  }
-
-  if (toolName === 'Grep') {
-    const raw = toolInput.pattern || '';
-    const cleaned = raw.replace(/[.*+?^${}()|[\]\\]/g, '').trim();
-    if (cleaned.length >= 3) patterns.push(cleaned);
-    patterns.push(...extractFilePatternsFromOutput(content));
-  }
-
-  if (toolName === 'Glob') {
-    const raw = toolInput.pattern || '';
-    const m = raw.match(/([a-zA-Z][a-zA-Z0-9_-]{2,})/);
-    if (m) patterns.push(m[1]);
-    patterns.push(...extractFilePatternsFromOutput(
-      Array.isArray(toolResponse) ? toolResponse.join('\n') : String(toolResponse || '')
-    ));
-  }
-
-  if (toolName === 'Bash') {
-    const cmd = toolInput.command || '';
-    if (!/\brg\b|\bgrep\b/.test(cmd)) return [];
-    const tokens = cmd.split(/\s+/);
-    let foundCmd = false, skipNext = false;
-    const flagsWithValues = new Set(['-e','-f','-m','-A','-B','-C','-g','--glob','-t','--type','--include','--exclude']);
-    for (const token of tokens) {
-      if (skipNext) { skipNext = false; continue; }
-      if (!foundCmd) { if (/\brg$|\bgrep$/.test(token)) foundCmd = true; continue; }
-      if (token.startsWith('-')) { if (flagsWithValues.has(token)) skipNext = true; continue; }
-      const cleaned = token.replace(/['"]/g, '').replace(/[.*+?^${}()|[\]\\]/g, '').trim();
-      if (cleaned.length >= 3) { patterns.push(cleaned); break; }
-    }
-    patterns.push(...extractFilePatternsFromOutput(content));
-  }
-
-  if (SERENA_SYMBOL_TOOLS.has(toolName)) {
-    const sym = symbolFromNamePath(toolInput.name_path_pattern || toolInput.name_path);
-    if (sym) patterns.push(sym);
-  }
-
-  if (toolName === SERENA_RENAME) {
-    if (toolInput.symbol_name) patterns.push(toolInput.symbol_name);
-  }
-
-  if (SERENA_FILE_TOOLS.has(toolName)) {
-    const sym = symbolFromFilePath(toolInput.relative_path || toolInput.file_path);
-    if (sym) patterns.push(sym);
-    const sub = toolInput.substring || toolInput.pattern || '';
-    const cleaned = sub.replace(/[.*+?^${}()|[\]\\]/g, '').trim();
-    if (cleaned.length >= 3) patterns.push(cleaned);
-  }
-
-  return [...new Set(patterns.filter(p => p && p.length >= 3))];
-}
-
-function runAugment(pattern, cwd) {
-  try {
-    const child = spawnSync('gitnexus', ['augment', pattern], {
-      encoding: 'utf-8',
-      timeout: 8000,
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-    return (child.stderr || '').trim();
-  } catch {
-    return '';
-  }
-}
-
-function main() {
-  try {
-    const input = readInput();
-    if (input.hook_event_name !== 'PostToolUse') return;
-
-    const cwd = input.cwd || process.cwd();
-    if (!findGitNexusIndex(cwd)) return;
-
-    const toolName = input.tool_name || '';
-    const toolInput = input.tool_input || {};
-    const toolResponse = input.tool_response ?? input.tool_result ?? '';
-
-    const patterns = extractPatterns(toolName, toolInput, toolResponse);
-    if (patterns.length === 0) return;
-
-    const cacheFile = getCacheFile(input.session_id);
-    const cache = loadCache(cacheFile);
-
-    const results = [];
-    for (const pattern of patterns) {
-      if (cache.has(pattern)) continue;
-      const out = runAugment(pattern, cwd);
-      saveToCache(cacheFile, pattern);
-      if (out) results.push(out);
-    }
-
-    if (results.length > 0) {
-      process.stdout.write('[GitNexus]\n' + results.join('\n\n') + '\n');
-    }
-  } catch (err) {
-    process.stderr.write('GitNexus hook error: ' + err.message + '\n');
-  }
-}
-
-main();

package/plugins/xtrm-tools/hooks/hooks.json

@@ -1,129 +0,0 @@
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/using-xtrm-reminder.mjs"
-          },
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/beads-compact-restore.mjs",
-            "timeout": 5000
-          },
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/quality-check-env.mjs",
-            "timeout": 5000
-          },
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/xtrm-session-logger.mjs",
-            "timeout": 3000
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Edit|Write|MultiEdit|NotebookEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/worktree-boundary.mjs",
-            "timeout": 2000
-          },
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/beads-edit-gate.mjs",
-            "timeout": 5000
-          }
-        ]
-      },
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/beads-commit-gate.mjs",
-            "timeout": 5000
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Bash|execute_shell_command|bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/beads-claim-sync.mjs",
-            "timeout": 5000
-          }
-        ]
-      },
-      {
-        "matcher": "Edit|Write|MultiEdit|NotebookEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/quality-check.cjs",
-            "timeout": 30000
-          },
-          {
-            "type": "command",
-            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/quality-check.py",
-            "timeout": 30000
-          }
-        ]
-      },
-      {
-        "matcher": "Bash|Grep|Read|Glob|mcp__serena__find_symbol|mcp__serena__get_symbols_overview|mcp__serena__search_for_pattern|mcp__serena__find_referencing_symbols|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol|mcp__serena__rename_symbol",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/gitnexus/gitnexus-hook.cjs",
-            "timeout": 10000
-          }
-        ]
-      },
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/xtrm-tool-logger.mjs",
-            "timeout": 3000
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/beads-stop-gate.mjs",
-            "timeout": 5000
-          },
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/beads-memory-gate.mjs",
-            "timeout": 8000
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/beads-compact-save.mjs",
-            "timeout": 5000
-          }
-        ]
-      }
-    ]
-  }
-}