xtrm-tools 2.1.4 → 2.1.5

package/config/hooks.json

@@ -13,12 +13,12 @@
     ],
     "PreToolUse": [
       {
-        "matcher": "Write|Edit|MultiEdit",
+        "matcher": "Write|Edit|MultiEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "script": "main-guard.mjs",
         "timeout": 5000
       },
       {
-        "matcher": "Read|Edit",
+        "matcher": "Read|Edit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "script": "serena-workflow-reminder.py"
       },
       {
@@ -27,7 +27,7 @@
         "timeout": 30000
       },
       {
-        "matcher": "Edit|Write",
+        "matcher": "Edit|Write|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "script": "type-safety-enforcement.py"
       },
       {
@@ -36,7 +36,7 @@
         "timeout": 8000
       },
       {
-        "matcher": "Edit|Write|MultiEdit|NotebookEdit|mcp__serena__*",
+        "matcher": "Edit|Write|MultiEdit|NotebookEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "script": "beads-edit-gate.mjs",
         "timeout": 5000
       },

package/hooks/README.md

@@ -147,7 +147,7 @@ Installed globally to `~/.claude/hooks/` by `xtrm install`. Require Node.js.
 
 **Purpose**: Blocks direct file edits and dangerous git operations on protected branches (`main`/`master`). Enforces the feature-branch → PR workflow.
 
-**Trigger**: PreToolUse (`Edit|Write|MultiEdit|NotebookEdit|Bash`)
+**Trigger**: PreToolUse (`Edit|Write|MultiEdit|NotebookEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol|Bash`)
 
 **Blocks**:
 - Write/Edit/MultiEdit/NotebookEdit on protected branches
@@ -159,7 +159,7 @@ Installed globally to `~/.claude/hooks/` by `xtrm install`. Require Node.js.
 {
   "hooks": {
     "PreToolUse": [{
-      "matcher": "Edit|Write|MultiEdit|NotebookEdit|Bash",
+      "matcher": "Edit|Write|MultiEdit|NotebookEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol|Bash",
       "hooks": [{ "type": "command", "command": "node \"~/.claude/hooks/main-guard.mjs\"", "timeout": 5000 }]
     }]
   }
@@ -182,7 +182,7 @@ Installed globally to `~/.claude/hooks/` by `xtrm install`. Require Node.js.
 
 **Purpose**: Blocks file edits when the current session has not claimed a beads issue via `bd kv`. Prevents free-riding in multi-agent and multi-session scenarios.
 
-**Trigger**: PreToolUse (`Edit|Write|MultiEdit|NotebookEdit|mcp__serena__*`)
+**Trigger**: PreToolUse (`Edit|Write|MultiEdit|NotebookEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol`)
 
 **Behavior**:
 - Session has claim (`bd kv get "claimed:<session_id>"`) → allow

package/package.json

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

package/project-skills/py-quality-gate/.claude/settings.json

@@ -2,7 +2,7 @@
   "hooks": {
     "PostToolUse": [
       {
-        "matcher": "Write|Edit|MultiEdit",
+        "matcher": "Write|Edit|MultiEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "hooks": [
           {
             "type": "command",

package/project-skills/service-skills-set/.claude/settings.json

@@ -12,7 +12,7 @@
     ],
         "PreToolUse": [
       {
-        "matcher": "Read|Write|Edit|Glob|Grep|Bash",
+        "matcher": "Read|Write|Edit|Glob|Grep|Bash|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "hooks": [
           {
             "type": "command",
@@ -23,7 +23,7 @@
     ],
     "PostToolUse": [
       {
-        "matcher": "Write|Edit",
+        "matcher": "Write|Edit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "hooks": [
           {
             "type": "command",

package/project-skills/service-skills-set/install-service-skills.py

@@ -41,12 +41,12 @@ SETTINGS_HOOKS = {
             "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/skills/using-service-skills/scripts/cataloger.py\""}]}
     ],
     "PreToolUse": [
-        {"matcher": "Read|Write|Edit|Glob|Grep|Bash",
+        {"matcher": "Read|Write|Edit|Glob|Grep|Bash|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
          "hooks": [{"type": "command",
              "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/skills/using-service-skills/scripts/skill_activator.py\""}]}
     ],
     "PostToolUse": [
-        {"matcher": "Write|Edit",
+        {"matcher": "Write|Edit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
          "hooks": [{"type": "command",
              "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/skills/updating-service-skills/scripts/drift_detector.py\" check-hook",
              "timeout": 10}]}

package/project-skills/tdd-guard/.claude/hooks/tdd-guard-pretool-bridge.cjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+const { readFileSync } = require('node:fs');
+const { spawnSync } = require('node:child_process');
+const path = require('node:path');
+
+const CODE_EXTENSIONS = new Set([
+  '.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs',
+  '.py', '.php', '.go', '.rs', '.java', '.kt', '.kts',
+  '.c', '.cc', '.cpp', '.cxx', '.h', '.hh', '.hpp',
+  '.cs', '.rb', '.swift', '.scala', '.lua', '.sh', '.zsh', '.bash',
+]);
+
+const SERENA_EDIT_TOOLS = new Set([
+  'mcp__serena__rename_symbol',
+  'mcp__serena__replace_symbol_body',
+  'mcp__serena__insert_after_symbol',
+  'mcp__serena__insert_before_symbol',
+]);
+
+function isEditLikeTool(toolName) {
+  if (!toolName) return false;
+  if (toolName === 'Edit' || toolName === 'Write' || toolName === 'MultiEdit' || toolName === 'TodoWrite') {
+    return true;
+  }
+  return SERENA_EDIT_TOOLS.has(toolName);
+}
+
+function pickFilePath(toolInput) {
+  if (!toolInput || typeof toolInput !== 'object') return null;
+
+  const direct = toolInput.file_path || toolInput.filePath || toolInput.path ||
+    toolInput.relative_path || toolInput.relativePath;
+  if (typeof direct === 'string' && direct.trim()) return direct;
+
+  if (Array.isArray(toolInput.edits)) {
+    for (const edit of toolInput.edits) {
+      const p = edit?.file_path || edit?.filePath || edit?.path || edit?.relative_path || edit?.relativePath;
+      if (typeof p === 'string' && p.trim()) return p;
+    }
+  }
+
+  return null;
+}
+
+function isCodeFile(filePath) {
+  if (!filePath) return true; // fail-open when no path is available
+  return CODE_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
+
+let payloadText = '';
+try {
+  payloadText = readFileSync(0, 'utf8');
+} catch {
+  process.exit(0);
+}
+
+let payload;
+try {
+  payload = JSON.parse(payloadText);
+} catch {
+  process.exit(0);
+}
+
+const toolName = payload.tool_name || '';
+if (!isEditLikeTool(toolName)) {
+  process.exit(0);
+}
+
+const filePath = pickFilePath(payload.tool_input);
+if (!isCodeFile(filePath)) {
+  process.exit(0);
+}
+
+const result = spawnSync('tdd-guard', {
+  input: payloadText,
+  encoding: 'utf8',
+  stdio: ['pipe', 'pipe', 'pipe'],
+});
+
+if (result.stdout) process.stdout.write(result.stdout);
+if (result.stderr) process.stderr.write(result.stderr);
+
+if (result.error) {
+  process.exit(0);
+}
+
+process.exit(result.status ?? 0);

package/project-skills/tdd-guard/.claude/settings.json

@@ -2,11 +2,11 @@
   "hooks": {
     "PreToolUse": [
       {
-        "matcher": "Write|Edit|MultiEdit|TodoWrite",
+        "matcher": "Write|Edit|MultiEdit|TodoWrite|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "hooks": [
           {
             "type": "command",
-            "command": "tdd-guard",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/tdd-guard-pretool-bridge.cjs\"",
             "timeout": 30
           }
         ]

package/project-skills/tdd-guard/README.md

@@ -276,8 +276,8 @@ Type `/hooks` in Claude Code to open the hooks menu, then configure each hook. U
 **PreToolUse Hook**
 
 1. Select `PreToolUse - Before tool execution`
-2. Choose `+ Add new matcher...` and enter: `Write|Edit|MultiEdit|TodoWrite`
-3. Select `+ Add new hook...` and enter: `tdd-guard`
+2. Choose `+ Add new matcher...` and enter: `Write|Edit|MultiEdit|TodoWrite|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol`
+3. Select `+ Add new hook...` and enter: `node "$CLAUDE_PROJECT_DIR/.claude/hooks/tdd-guard-pretool-bridge.cjs"`
 4. Choose where to save
 
 **UserPromptSubmit Hook**
@@ -305,11 +305,11 @@ If you prefer to edit settings files directly, add all three hooks to your chose
   "hooks": {
     "PreToolUse": [
       {
-        "matcher": "Write|Edit|MultiEdit|TodoWrite",
+        "matcher": "Write|Edit|MultiEdit|TodoWrite|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "hooks": [
           {
             "type": "command",
-            "command": "tdd-guard"
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/tdd-guard-pretool-bridge.cjs\""
           }
         ]
       }
@@ -341,6 +341,8 @@ If you prefer to edit settings files directly, add all three hooks to your chose
 
 </details>
 
+**Note**: The pretool bridge skips non-code files (for example `.md`) and forwards code edits to `tdd-guard`, which avoids false positives on documentation-only changes.
+
 ## Additional Configuration
 
 - [Custom instructions](docs/custom-instructions.md) - Customize TDD validation rules

package/project-skills/tdd-guard/docs/linting.md

@@ -42,7 +42,7 @@ The refactoring support helps by:
    1. Type `/hooks` in Claude Code
    2. Select `PostToolUse - After tool execution`
    3. Choose `+ Add new matcher...`
-   4. Enter: `Write|Edit|MultiEdit`
+   4. Enter: `Write|Edit|MultiEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol`
    5. Select `+ Add new hook...`
    6. Enter command: `tdd-guard`
    7. Choose where to save
@@ -56,7 +56,7 @@ The refactoring support helps by:
      "hooks": {
        "PostToolUse": [
          {
-           "matcher": "Write|Edit|MultiEdit",
+           "matcher": "Write|Edit|MultiEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
            "hooks": [
              {
                "type": "command",

package/project-skills/ts-quality-gate/.claude/settings.json

@@ -2,7 +2,7 @@
   "hooks": {
     "PostToolUse": [
       {
-        "matcher": "Write|Edit|MultiEdit",
+        "matcher": "Write|Edit|MultiEdit|mcp__serena__rename_symbol|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol",
         "hooks": [
           {
             "type": "command",