xtrm-tools 2.1.16 → 2.1.17

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xtrm-cli",
-  "version": "2.1.16",
+  "version": "2.1.17",
   "description": "Claude Code tools installer (skills, hooks, MCP servers)",
   "main": "./dist/index.js",
   "type": "module",

package/config/hooks.json

@@ -1,16 +1,10 @@
 {
   "hooks": {
-    "UserPromptSubmit": [
+    "SessionStart": [
       {
-        "script": "skill-suggestion.py",
+        "script": "beads-compact-restore.mjs",
         "timeout": 5000
       },
-      {
-        "script": "gitnexus-impact-reminder.py",
-        "timeout": 5000
-      }
-    ],
-    "SessionStart": [
       {
         "script": "serena-workflow-reminder.py"
       }
@@ -30,15 +24,6 @@
         "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"
       },
-      {
-        "matcher": "Bash",
-        "script": "type-safety-enforcement.py",
-        "timeout": 30000
-      },
-      {
-        "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"
-      },
       {
         "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",
@@ -71,11 +56,14 @@
         "script": "beads-memory-gate.mjs",
         "timeout": 8000
       }
+    ],
+    "PreCompact": [
+      {
+        "script": "beads-compact-save.mjs",
+        "timeout": 5000
+      }
     ]
   },
-  "skillSuggestions": {
-    "enabled": true
-  },
   "statusLine": {
     "script": "statusline-starship.sh"
   }

package/hooks/beads-compact-restore.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+// Claude Code SessionStart hook — restore in_progress beads issues after context compaction.
+// Reads .beads/.last_active (written by beads-compact-save.mjs), reinstates statuses,
+// deletes the marker, and injects a brief agent context message.
+// Exit 0 in all paths (informational only).
+//
+// Installed by: xtrm install
+
+import { execSync } from 'node:child_process';
+import { readFileSync, existsSync, unlinkSync } from 'node:fs';
+import path from 'node:path';
+
+let input;
+try {
+  input = JSON.parse(readFileSync(0, 'utf8'));
+} catch {
+  process.exit(0);
+}
+
+const cwd = input.cwd ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
+const lastActivePath = path.join(cwd, '.beads', '.last_active');
+
+if (!existsSync(lastActivePath)) process.exit(0);
+
+const ids = readFileSync(lastActivePath, 'utf8').trim().split('\n').filter(Boolean);
+
+// Clean up regardless of whether restore succeeds
+unlinkSync(lastActivePath);
+
+if (ids.length === 0) process.exit(0);
+
+let restored = 0;
+for (const id of ids) {
+  try {
+    execSync(`bd update ${id} --status in_progress`, {
+      encoding: 'utf8',
+      cwd,
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 5000,
+    });
+    restored++;
+  } catch {
+    // ignore — issue may no longer exist
+  }
+}
+
+if (restored > 0) {
+  process.stdout.write(
+    JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalSystemPrompt:
+          `Restored ${restored} in_progress issue${restored === 1 ? '' : 's'} from last session before compaction. Check \`bd list\` for details.`,
+      },
+    }) + '\n',
+  );
+}
+
+process.exit(0);

package/hooks/beads-compact-save.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+// Claude Code PreCompact hook — save in_progress beads issues before context is compacted.
+// Writes issue IDs to .beads/.last_active so beads-compact-restore.mjs can reinstate them.
+// Exit 0 in all paths (informational only).
+//
+// Installed by: xtrm install
+
+import { execSync } from 'node:child_process';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+
+let input;
+try {
+  input = JSON.parse(readFileSync(0, 'utf8'));
+} catch {
+  process.exit(0);
+}
+
+const cwd = input.cwd ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
+const beadsDir = path.join(cwd, '.beads');
+
+if (!existsSync(beadsDir)) process.exit(0);
+
+let output = '';
+try {
+  output = execSync('bd list --status=in_progress', {
+    encoding: 'utf8',
+    cwd,
+    stdio: ['pipe', 'pipe', 'pipe'],
+    timeout: 8000,
+  }).trim();
+} catch {
+  process.exit(0);
+}
+
+// Parse issue IDs — lines like "◐ proj-abc123 ● P1 Title"
+const ids = [];
+for (const line of output.split('\n')) {
+  const match = line.trim().match(/^[○◐●✓❄]\s+([\w-]+)\s/u);
+  if (match) ids.push(match[1]);
+}
+
+if (ids.length === 0) process.exit(0);
+
+writeFileSync(path.join(beadsDir, '.last_active'), ids.join('\n') + '\n', 'utf8');
+process.exit(0);

package/hooks/main-guard-post-push.mjs

@@ -59,13 +59,11 @@ const explicitlyProtectedTarget = protectedBranches
   .some((b) => lastToken === b || lastToken.endsWith(`:${b}`));
 if (explicitlyProtectedTarget) process.exit(0);
 
-process.stdout.write(JSON.stringify({
-  systemMessage:
-    `✅ Pushed '${branch}'. Next workflow steps:\n\n` +
-    '  1. gh pr create --fill\n' +
-    '  2. gh pr merge --squash\n' +
-    '  3. git checkout main && git reset --hard origin/main\n\n' +
-    'Before/after merge, ensure beads state is updated (e.g. bd close <id>).',
-}));
-process.stdout.write('\n');
+process.stdout.write(
+  `✅ Pushed '${branch}'. Next workflow steps:\n\n` +
+  '  1. gh pr create --fill\n' +
+  '  2. gh pr merge --squash\n' +
+  '  3. git checkout main && git reset --hard origin/main\n\n' +
+  'Before/after merge, ensure beads state is updated (e.g. bd close <id>).\n',
+);
 process.exit(0);

package/hooks/main-guard.mjs

@@ -120,6 +120,7 @@ if (tool === 'Bash') {
     ...protectedBranches.map(b => new RegExp(`^git\\s+reset\\s+--hard\\s+origin/${b}\\b`)),
     /^gh\s+/,
     /^bd\s+/,
+    /^touch\s+\.beads\//,
   ];
 
   if (SAFE_BASH_PATTERNS.some(p => p.test(cmd))) {

package/package.json

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

package/project-skills/quality-gates/.claude/hooks/quality-check.py

@@ -140,7 +140,17 @@ def check_mypy(file_path: str, project_root: str) -> tuple[bool, list[str]]:
     
     log_info('Running Mypy type checking...')
     
-    cmd = ['mypy', '--pretty', file_path]
+    # Build mypy command with strictness flags
+    # Default: --disallow-untyped-defs catches untyped function parameters
+    # Opt-in: CLAUDE_HOOKS_MYPY_STRICT=true enables full --strict mode
+    mypy_strict = os.environ.get('CLAUDE_HOOKS_MYPY_STRICT', 'false').lower() == 'true'
+    
+    if mypy_strict:
+        cmd = ['mypy', '--strict', '--pretty', file_path]
+        log_debug('Running mypy with --strict (full strictness)')
+    else:
+        cmd = ['mypy', '--disallow-untyped-defs', '--pretty', file_path]
+        log_debug('Running mypy with --disallow-untyped-defs (baseline strictness)')
     try:
         result = subprocess.run(cmd, capture_output=True, text=True, cwd=project_root)
         

package/hooks/skill-discovery.py

@@ -1,90 +0,0 @@
-#!/usr/bin/env python3
-import json
-import sys
-import os
-import re
-
-# Add script directory to path to allow importing shared modules
-sys.path.append(os.path.dirname(os.path.abspath(__file__)))
-from agent_context import AgentContext
-
-def get_first_sentence(text):
-    if not text:
-        return ""
-    # Remove newlines and extra spaces
-    text = re.sub(r'\s+', ' ', text).strip()
-    # Find the first period followed by a space or end of string
-    match = re.search(r'^(.*?)[.!?](\s|$)', text)
-    if match:
-        return match.group(0).strip()
-    return text
-
-def parse_skill_md(file_path):
-    try:
-        with open(file_path, 'r') as f:
-            content = f.read()
-            
-        # Extract YAML frontmatter
-        match = re.search(r'^---\s*\n(.*?)\n---\s*\n', content, re.DOTALL)
-        if match:
-            frontmatter_raw = match.group(1)
-            # Basic YAML-like parsing using regex to avoid external dependency (PyYAML)
-            name_match = re.search(r'^name:\s*(.*)$', frontmatter_raw, re.MULTILINE)
-            desc_match = re.search(r'^description:\s*(?:>-\s*)?\n?\s*(.*)$', frontmatter_raw, re.MULTILINE | re.DOTALL)
-            
-            name = name_match.group(1).strip() if name_match else os.path.basename(os.path.dirname(file_path))
-            description = ""
-            
-            if desc_match:
-                desc_raw = desc_match.group(1).strip()
-                # If it was a folded scalar, it might have multiple lines
-                if '\n' in desc_raw:
-                    # Capture until next YAML key or end
-                    description = desc_raw.split('\n')[0].strip()
-                else:
-                    description = desc_raw
-            
-            return name, get_first_sentence(description)
-    except Exception as e:
-        print(f"Error parsing {file_path}: {e}", file=sys.stderr)
-    return None
-
-def main():
-    try:
-        ctx = AgentContext()
-        project_dir = os.environ.get('GEMINI_PROJECT_DIR', os.getcwd())
-        skills_root = os.path.join(project_dir, 'skills')
-        
-        if not os.path.exists(skills_root):
-            ctx.fail_open()
-
-        available_skills = []
-        for skill_dir in os.listdir(skills_root):
-            skill_path = os.path.join(skills_root, skill_dir)
-            if os.path.isdir(skill_path):
-                skill_md = os.path.join(skill_path, 'SKILL.md')
-                if os.path.exists(skill_md):
-                    result = parse_skill_md(skill_md)
-                    if result:
-                        name, desc = result
-                        available_skills.append(f"- {name}: {desc}")
-
-        if not available_skills:
-            ctx.fail_open()
-
-        context_msg = "## Available Local Agent Skills\n"
-        context_msg += "The following specialized skills are available in this repository. Use them when appropriate:\n"
-        context_msg += "\n".join(sorted(available_skills))
-        context_msg += "\n\nYou can activate a skill using `activate_skill(name='skill-name')`."
-
-        ctx.allow(
-            system_message="🚀 Loaded available local skills into context.",
-            additional_context=context_msg
-        )
-
-    except Exception as e:
-        print(f"Hook failed: {e}", file=sys.stderr)
-        sys.exit(0)
-
-if __name__ == "__main__":
-    main()

package/hooks/skill-suggestion.py

@@ -1,112 +0,0 @@
-#!/usr/bin/env python3
-import sys
-import os
-import re
-
-# Add script directory to path to allow importing shared modules
-sys.path.append(os.path.dirname(os.path.abspath(__file__)))
-from agent_context import AgentContext
-
-# Configuration
-ORCHESTRATION_PATTERNS = [
-    r"review.*(code|security|quality)|code.*(review|audit)",
-    r"security.*(audit|review|scan)",
-    r"implement.*(feature|endpoint|api)|build.*feature",
-    r"(debug|investigate|root.*cause|crash|fix.*unknown)",
-    r"(refactor.*sprint|major.*refactor|migration|technical.*debt)",
-    r"validate.*(commit|staged)|pre.*commit",
-]
-
-CCS_PATTERNS = [
-    r"(fix|correggi|risolvi).*typo",
-    r"(fix|correggi).*spelling",
-    r"(add|aggiungi|crea|create).*test",
-    r"(genera|generate).*(test|unit|case)",
-    r"(estrai|extract).*(function|method|funzione|metodo)",
-    r"rename.*variable|rinomina.*variabile",
-    r"(add|aggiungi).*(doc|docstring|comment)",
-    r"(aggiorna|update).*comment",
-    r"(format|formatta|lint|indenta|indent)",
-    r"(add|aggiungi).*(type|typing|hint)",
-    r"(rimuovi|remove|elimina|delete).*(import|unused)",
-    r"(modifica|modify|cambia|change).*(name|nome)"
-]
-
-P_PATTERNS = [
-    r"analiz|analyz|esamina|studia|review|rivedi",
-    r"implementa|implement|create|crea",
-    r"spiega|explain|descri|describe",
-    r"^(come|how|what|cosa|perch|why)"
-]
-
-EXCLUDE_PATTERNS = [
-    r"archit|design|progett",
-    r"(add|implement|fix|patch).*(security|auth|oauth)|security.*(vuln|fix|patch)",
-    r"bug|debug|investig|indaga",
-    r"performance|ottimizz|optim",
-    r"migra|breaking.*change",
-    r"complex|compless"
-]
-
-CONVERSATIONAL_PATTERNS = [
-    r"^(ciao|hi|hello|hey|buongiorno|buonasera|salve)([!.]|$)",
-    r"^(good morning|good afternoon|good evening)([!.]|$)",
-    r"^(grazie|thanks|thank you|merci|thx)([!.]|$)",
-    r"^(grazie mille|thanks a lot|many thanks)([!.]|$)",
-    r"^(ok|okay|va bene|perfetto|perfect|fine|d'accordo|agreed?)([!.]|$)",
-    r"^(si|sì|yes|no|nope|yeah|yep)([!.]|$)",
-    r"^(arrivederci|addio|ciao|bye|goodbye|see you|ci vediamo)([!.]|$)",
-    r"^come stai\?$|^how are you\?$|^come va\?$",
-    r"^tutto bene\?$|^all good\?$|^everything ok\?$"
-]
-
-def matches(text, patterns):
-    for pattern in patterns:
-        if re.search(pattern, text, re.IGNORECASE):
-            return True
-    return False
-
-try:
-    ctx = AgentContext()
-    prompt = ctx.prompt
-
-    if not prompt:
-        ctx.fail_open()
-
-    ccs_available = not bool(os.environ.get('CLAUDECODE'))
-    ccs_hint = "CCS backend" if ccs_available else "Gemini or Qwen directly (CCS unavailable inside Claude Code)"
-
-    # 1. Check Exclusions
-    if matches(prompt, EXCLUDE_PATTERNS) or matches(prompt, CONVERSATIONAL_PATTERNS):
-        ctx.fail_open()
-
-    agent_name = ctx.agent_type.capitalize()
-
-    # 2. Check Explicit Delegation
-    if re.search(r'delegate', prompt, re.IGNORECASE):
-        ctx.allow(system_message=f"💡 {agent_name} Internal Reminder: User mentioned 'delegate'. Consider using the /delegating skill to offload this task.")
-
-    # 3. Check CCS Delegation (Simple Tasks)
-    if matches(prompt, CCS_PATTERNS):
-        ctx.allow(system_message=f"💡 {agent_name} Internal Reminder: This appears to be a simple, deterministic task (typo/test/format/doc). Consider using the /delegating skill ({ccs_hint}) for cost-optimized execution.")
-
-    # 4. Check Orchestration (Complex Tasks)
-    elif matches(prompt, ORCHESTRATION_PATTERNS) and not matches(prompt, EXCLUDE_PATTERNS):
-        ctx.allow(system_message=f"💡 {agent_name} Internal Reminder: This looks like a multi-agent task (review/implement/debug). Consider using the /delegating skill (Gemini+Qwen orchestration) instead of handling in main session.")
-
-    # 5. Check Prompt Improving (/p)
-    word_count = len(prompt.split())
-    is_vague = matches(prompt, P_PATTERNS)
-    
-    # Heuristic for very short command-like prompts
-    if word_count < 6 and not is_vague:
-        if matches(prompt, [r"(creare|create|fare|do|aggiungere|add|modificare|modify|controllare|check|verificare|verify|testare|test)"]):
-            is_vague = True
-
-    if is_vague:
-        ctx.allow(system_message=f"💡 {agent_name} Internal Reminder: This prompt appears vague or could benefit from structure. Consider using the /prompt-improving skill to add XML structure, examples, and thinking space before proceeding.")
-
-    ctx.fail_open()
-
-except Exception:
-    sys.exit(0)

package/hooks/type-safety-enforcement.py

@@ -1,107 +0,0 @@
-#!/usr/bin/env python3
-import sys
-import os
-import subprocess
-
-# Add script directory to path to allow importing shared modules
-sys.path.append(os.path.dirname(os.path.abspath(__file__)))
-from agent_context import AgentContext
-
-# Configuration
-STRICT_DIRS = ["mcp_server"]
-WARN_DIRS = ["scripts"]
-PROJECT_ROOT = os.environ.get('GEMINI_PROJECT_DIR', os.environ.get('CLAUDE_PROJECT_DIR', os.getcwd()))
-VENV_PATH = os.path.join(PROJECT_ROOT, ".venv")
-
-# Colors
-RED = '\033[0;31m'
-YELLOW = '\033[1;33m'
-GREEN = '\033[0;32m'
-CYAN = '\033[0;36m'
-NC = '\033[0m'
-
-def is_strict_path(file_path):
-    rel_path = os.path.relpath(file_path, PROJECT_ROOT)
-    for d in STRICT_DIRS:
-        if rel_path.startswith(d):
-            return True
-    return False
-
-def run_mypy(target, is_strict):
-    if not os.path.exists(os.path.join(VENV_PATH, "bin", "activate")):
-        print(f"{YELLOW}⚠️  Venv not found at {VENV_PATH}, skipping check{NC}")
-        return True
-
-    cmd = f"source {VENV_PATH}/bin/activate && python -m mypy {target} --explicit-package-bases"
-    
-    try:
-        result = subprocess.run(cmd, shell=True, executable="/bin/bash", capture_output=True, text=True)
-        
-        if result.returncode != 0:
-            if is_strict:
-                print(f"{RED}❌ MYPY FAILED (STRICT MODE){NC}", file=sys.stderr)
-                print(result.stdout, file=sys.stderr)
-                print(f"\n{RED}🚫 COMMIT BLOCKED: Fix type errors in {target}{NC}", file=sys.stderr)
-                print(f"{CYAN}💡 Run: source .venv/bin/activate && python -m mypy {target}{NC}", file=sys.stderr)
-                return False
-            else:
-                print(f"{YELLOW}⚠️  MYPY WARNING (LENIENT MODE){NC}", file=sys.stderr)
-                print("\n".join(result.stdout.splitlines()[:20]), file=sys.stderr)
-                print(f"\n{YELLOW}⚡ Type errors exist in {target} (commit allowed){NC}", file=sys.stderr)
-                return True
-        else:
-            print(f"{GREEN}✅ MYPY PASSED: {target}{NC}", file=sys.stderr)
-            return True
-
-    except Exception as e:
-        print(f"Error running mypy: {e}", file=sys.stderr)
-        return True # Fail open
-
-try:
-    ctx = AgentContext()
-
-    # 1. Check Git Commits (Shell tools)
-    if ctx.is_shell_tool():
-        command = ctx.get_command()
-        if 'git commit' in command:
-            print(f"{CYAN}🔍 TYPE SAFETY CHECK: Validating staged Python files...{NC}", file=sys.stderr)
-            
-            # Get staged files
-            try:
-                staged = subprocess.check_output(
-                    "git diff --cached --name-only --diff-filter=ACM | grep '\.py$'", 
-                    shell=True, cwd=PROJECT_ROOT
-                ).decode().strip().splitlines()
-            except subprocess.CalledProcessError:
-                staged = []
-
-            if not staged:
-                print(f"{GREEN}✅ No Python files staged{NC}", file=sys.stderr)
-                ctx.allow()
-
-            failed = False
-            
-            # Check individual files
-            for f in staged:
-                full_path = os.path.join(PROJECT_ROOT, f)
-                if is_strict_path(full_path):
-                    if not run_mypy(full_path, True):
-                        failed = True
-
-            # If failed, block the tool
-            if failed:
-                ctx.block(reason="Type safety violations in strict directory.")
-            
-            ctx.allow()
-
-    # 2. Check Edits (Write/Edit tools)
-    elif ctx.is_write_tool() or ctx.is_edit_tool():
-        file_path = ctx.get_file_path()
-        if file_path.endswith('.py') and is_strict_path(file_path):
-            ctx.allow(system_message=f"""{YELLOW}⚠️  EDITING STRICT TYPE-SAFE FILE{NC}
-This file is in a STRICT zone ({', '.join(STRICT_DIRS)}).
-Any type errors will BLOCK commits.
-""")
-
-except Exception:
-    sys.exit(0)