xtrm-tools 2.1.5 → 2.1.7

package/project-skills/py-quality-gate/.claude/skills/using-py-quality-gate/SKILL.md

@@ -1,112 +0,0 @@
-# Using PY Quality Gate
-
-**PY Quality Gate** enforces Python code quality with ruff (linting/formatting) and mypy (type checking). Runs automatically on every file edit.
-
-## What It Does
-
-- **Ruff linting** - Fast Python linting (10-100x faster than flake8)
-- **Ruff formatting** - Code formatting (Black-compatible)
-- **Mypy type checking** - Static type validation
-- **Auto-fix** - Automatically fixes issues when possible
-- **Fast feedback** - Runs in <1s for most files
-
-## How It Works
-
-When you edit a Python file:
-
-1. PostToolUse hook fires after Write/Edit
-2. Runs `quality-check.py` with the file path
-3. Checks ruff lint, ruff format, mypy types
-4. Auto-fixes issues if configured
-5. Returns exit code 2 if blocking errors found
-
-## Requirements
-
-- Python 3.8+
-- ruff installed (`pip install ruff`)
-- mypy installed (`pip install mypy`) - optional
-
-## Installation
-
-```bash
-# Install project skill
-xtrm install project py-quality-gate
-
-# Install dependencies
-pip install ruff mypy
-```
-
-## Configuration
-
-Configure via environment variables in your shell or `.env`:
-
-```bash
-# Enable/disable checks
-export CLAUDE_HOOKS_RUFF_ENABLED=true
-export CLAUDE_HOOKS_MYPY_ENABLED=true
-
-# Auto-fix settings
-export CLAUDE_HOOKS_AUTOFIX=true
-
-# Debug mode
-export CLAUDE_HOOKS_DEBUG=true
-```
-
-## Ruff Configuration
-
-Create `pyproject.toml` or `ruff.toml` in your project:
-
-```toml
-[tool.ruff]
-line-length = 88
-target-version = "py38"
-
-[tool.ruff.lint]
-select = ["E", "F", "W", "I", "N", "UP", "B", "C4"]
-```
-
-## Mypy Configuration
-
-Create `mypy.ini` or `pyproject.toml`:
-
-```ini
-[mypy]
-python_version = 3.8
-warn_return_any = True
-warn_unused_configs = True
-disallow_untyped_defs = False
-```
-
-## Exit Codes
-
-| Code | Meaning |
-|------|---------|
-| 0 | All checks passed |
-| 1 | Fatal error (hook crashed) |
-| 2 | Blocking errors found (Claude must fix) |
-
-## Troubleshooting
-
-**"ruff: command not found"**
-- Install: `pip install ruff` or `pipx install ruff`
-
-**"mypy: command not found"**
-- Install: `pip install mypy`
-- Or set `CLAUDE_HOOKS_MYPY_ENABLED=false`
-
-**Hook not running**
-- Verify PostToolUse hook in `.claude/settings.json`
-- Check Python path is correct
-
-## Test Suggestions
-
-The hook automatically suggests running pytest if related test files exist:
-- `test_<filename>.py`
-- `<filename>_test.py`
-- `__tests__/test_<filename>.py`
-
-## See Also
-
-- Full documentation: `.claude/docs/py-quality-gate-readme.md`
-- Ruff docs: https://docs.astral.sh/ruff/
-- Mypy docs: https://mypy.readthedocs.io/

package/project-skills/py-quality-gate/README.md

@@ -1,147 +0,0 @@
-# PY Quality Gate
-
-**Python quality gate** for Claude Code. Runs ruff (linting/formatting) and mypy (type checking) automatically on every file edit.
-
-## What It Does
-
-PY Quality Gate enforces Python code quality standards in real-time:
-
-| Check | Description | Auto-fix |
-|-------|-------------|----------|
-| **Ruff lint** | Code style, best practices, errors | Yes |
-| **Ruff format** | Black-compatible formatting | Yes |
-| **Mypy types** | Static type checking | No |
-
-## Installation
-
-```bash
-# Install project skill
-xtrm install project py-quality-gate
-
-# Install Python dependencies
-pip install ruff mypy
-```
-
-## How It Works
-
-The quality gate runs as a `PostToolUse` hook:
-
-1. You edit a Python file
-2. After the edit completes, the hook fires
-3. `quality-check.py` validates the file
-4. Issues are reported with auto-fix when possible
-5. Exit code 2 blocks if critical errors found
-
-## Configuration
-
-### Environment Variables
-
-```bash
-# Enable/disable checks
-export CLAUDE_HOOKS_RUFF_ENABLED=true
-export CLAUDE_HOOKS_MYPY_ENABLED=true
-
-# Auto-fix settings
-export CLAUDE_HOOKS_AUTOFIX=true
-
-# Debug mode
-export CLAUDE_HOOKS_DEBUG=true
-```
-
-### Ruff Configuration
-
-Create `pyproject.toml` in your project:
-
-```toml
-[tool.ruff]
-line-length = 88
-target-version = "py38"
-
-[tool.ruff.lint]
-select = ["E", "F", "W", "I", "N", "UP", "B", "C4"]
-ignore = ["E501"]  # Line length (handled by formatter)
-```
-
-### Mypy Configuration
-
-Create `mypy.ini` in your project:
-
-```ini
-[mypy]
-python_version = 3.8
-warn_return_any = True
-warn_unused_configs = True
-disallow_untyped_defs = False
-ignore_missing_imports = True
-```
-
-## Features
-
-### Ruff Linting
-- 10-100x faster than flake8
-- Auto-fixes supported
-- 500+ built-in rules
-- Compatible with Black
-
-### Ruff Formatting
-- Black-compatible formatter
-- Fast and consistent
-- Auto-fixes formatting issues
-
-### Mypy Type Checking
-- Static type validation
-- Catches type errors before runtime
-- Configurable strictness
-
-### Smart Test Suggestions
-- Detects related test files
-- Suggests running pytest
-- Supports multiple test naming conventions
-
-## Exit Codes
-
-| Code | Meaning |
-|------|---------|
-| 0 | All checks passed |
-| 1 | Fatal error (hook crashed) |
-| 2 | Blocking errors found |
-
-## Troubleshooting
-
-**Ruff not found**
-```bash
-pip install ruff
-# or
-pipx install ruff
-```
-
-**Mypy not found**
-```bash
-pip install mypy
-```
-
-**Hook not running**
-- Verify PostToolUse hook in `.claude/settings.json`
-- Check Python path: `which python3`
-
-**False positives from dependencies**
-- Add to `mypy.ini`: `ignore_missing_imports = True`
-- Add to `pyproject.toml`: exclude patterns
-
-## Quick Commands
-
-```bash
-# Run ruff manually
-ruff check .
-ruff format .
-
-# Run mypy manually
-mypy .
-
-# Run pytest
-pytest
-```
-
-## Reference
-
-Inspired by: https://github.com/bartolli/claude-code-typescript-hooks

package/project-skills/service-skills-set/.claude/skills/using-service-skills/scripts/test_skill_activator.py

@@ -1,58 +0,0 @@
-"""Tests for skill_activator.py — load_registry integration."""
-import io
-import json
-import sys
-import unittest
-from pathlib import Path
-from unittest.mock import patch
-
-scripts_dir = Path(__file__).parent
-sys.path.insert(0, str(scripts_dir))
-sys.path.insert(0, str(scripts_dir.parent.parent / "creating-service-skills" / "scripts"))
-
-import skill_activator
-
-
-REGISTRY_WITH_VERSION = {
-    "version": "1.0",
-    "services": {
-        "my-service": {
-            "territory": ["src/my-service/**"],
-            "name": "My Service",
-            "skill_path": ".claude/skills/my-service/SKILL.md",
-        }
-    },
-}
-
-HOOK_INPUT = json.dumps({
-    "tool_name": "Write",
-    "tool_input": {"file_path": "src/my-service/foo.py"},
-    "hook_event_name": "PreToolUse",
-    "session_id": "test",
-    "cwd": "/fake/project",
-})
-
-
-class TestMainWithVersionedRegistry(unittest.TestCase):
-    def test_main_does_not_crash_when_registry_has_version_key(self):
-        """main() must not crash with AttributeError when load_registry returns
-        {"version": ..., "services": {...}} — the full registry dict.
-        It should output valid JSON context for the matched service.
-        """
-        with patch("skill_activator.load_registry", return_value=REGISTRY_WITH_VERSION), \
-             patch("skill_activator.get_project_root", return_value="/fake/project"), \
-             patch("sys.stdin", io.StringIO(HOOK_INPUT)), \
-             patch("sys.stdout", new_callable=io.StringIO) as mock_stdout:
-            try:
-                skill_activator.main()
-            except SystemExit:
-                pass
-            output = mock_stdout.getvalue()
-
-        self.assertTrue(output, "Expected JSON output but got nothing")
-        result = json.loads(output)
-        self.assertIn("hookSpecificOutput", result)
-
-
-if __name__ == "__main__":
-    unittest.main()

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

@@ -1,16 +0,0 @@
-{
-  "hooks": {
-    "PostToolUse": [
-      {
-        "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",
-            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/quality-check.cjs\"",
-            "timeout": 30
-          }
-        ]
-      }
-    ]
-  }
-}

package/project-skills/ts-quality-gate/.claude/skills/using-ts-quality-gate/SKILL.md

@@ -1,81 +0,0 @@
-# Using TS Quality Gate
-
-**TS Quality Gate** enforces TypeScript, ESLint, and Prettier quality checks on every file edit. It provides immediate feedback and auto-fixes issues when possible.
-
-## What It Does
-
-- **TypeScript compilation check** - Catches type errors immediately
-- **ESLint validation** - Enforces code style and best practices
-- **Prettier formatting** - Ensures consistent code formatting
-- **Auto-fix** - Automatically fixes issues when possible
-- **Fast feedback** - Runs in <1s for most files
-
-## How It Works
-
-When you edit a TypeScript/JavaScript file:
-
-1. PostToolUse hook fires after Write/Edit
-2. Runs `quality-check.js` with the file path
-3. Checks TypeScript compilation, ESLint, Prettier
-4. Auto-fixes issues if configured
-5. Returns exit code 2 if blocking errors found
-
-## Configuration
-
-The quality gate is configured via `.claude/hooks/hook-config.json`:
-
-```json
-{
-  "typescript": {
-    "enabled": true,
-    "showDependencyErrors": false
-  },
-  "eslint": {
-    "enabled": true,
-    "autofix": true
-  },
-  "prettier": {
-    "enabled": true,
-    "autofix": true
-  },
-  "general": {
-    "autofixSilent": true,
-    "debug": false
-  }
-}
-```
-
-## Requirements
-
-- Node.js 18+
-- TypeScript installed in project
-- ESLint installed in project (optional)
-- Prettier installed in project (optional)
-
-## Installation
-
-```bash
-# Install project skill
-xtrm install project ts-quality-gate
-
-# Ensure dependencies are installed in your project
-npm install --save-dev typescript eslint prettier
-```
-
-## Troubleshooting
-
-**"ESLint not found"**
-- Install ESLint: `npm install --save-dev eslint`
-- Or disable in hook-config.json: `"eslint": { "enabled": false }`
-
-**"Prettier not found"**
-- Install Prettier: `npm install --save-dev prettier`
-- Or disable in hook-config.json: `"prettier": { "enabled": false }`
-
-**TypeScript errors from dependencies**
-- Set `"showDependencyErrors": false` in hook-config.json
-
-## See Also
-
-- Full documentation: `.claude/docs/ts-quality-gate-readme.md`
-- Reference: https://github.com/bartolli/claude-code-typescript-hooks

package/project-skills/ts-quality-gate/README.md

@@ -1,115 +0,0 @@
-# TS Quality Gate
-
-**TypeScript/ESLint/Prettier quality gate** for Claude Code. Runs automatically on every file edit to ensure code quality.
-
-## What It Does
-
-TS Quality Gate enforces code quality standards in real-time:
-
-| Check | Description | Auto-fix |
-|-------|-------------|----------|
-| **TypeScript** | Compilation errors, type safety | No |
-| **ESLint** | Code style, best practices, rules | Yes (if enabled) |
-| **Prettier** | Code formatting consistency | Yes (if enabled) |
-
-## Installation
-
-```bash
-# Install project skill
-xtrm install project ts-quality-gate
-```
-
-**Post-install:** Ensure your project has the required dependencies:
-
-```bash
-npm install --save-dev typescript eslint prettier
-```
-
-## How It Works
-
-The quality gate runs as a `PostToolUse` hook:
-
-1. You edit a TypeScript/JavaScript file
-2. After the edit completes, the hook fires
-3. `quality-check.cjs` validates the file
-4. Issues are reported with auto-fix when possible
-5. Exit code 2 blocks if critical errors found
-
-## Configuration
-
-Edit `.claude/hooks/hook-config.json` to customize:
-
-```json
-{
-  "typescript": {
-    "enabled": true,
-    "showDependencyErrors": false
-  },
-  "eslint": {
-    "enabled": true,
-    "autofix": true
-  },
-  "prettier": {
-    "enabled": true,
-    "autofix": true
-  },
-  "general": {
-    "autofixSilent": true
-  }
-}
-```
-
-### Environment Variable Overrides
-
-```bash
-export CLAUDE_HOOKS_TYPESCRIPT_ENABLED=false
-export CLAUDE_HOOKS_ESLINT_AUTOFIX=true
-export CLAUDE_HOOKS_PRETTIER_ENABLED=false
-```
-
-## Features
-
-### TypeScript Checking
-- Uses project's tsconfig.json
-- Checks only edited file (fast)
-- Optionally shows dependency errors
-
-### ESLint Integration
-- Auto-discovers .eslintrc or eslint.config.js
-- Auto-fixes when `autofix: true`
-- Reports errors and warnings
-
-### Prettier Formatting
-- Auto-discovers .prettierrc
-- Auto-formats when `autofix: true`
-- Supports all Prettier options
-
-### Smart File Detection
-- Skips non-source files
-- Detects test files, CLI files, services
-- Applies file-type-specific rules
-
-## Exit Codes
-
-| Code | Meaning |
-|------|---------|
-| 0 | All checks passed |
-| 1 | Fatal error (hook crashed) |
-| 2 | Blocking errors found (Claude must fix) |
-
-## Troubleshooting
-
-**Hook not running**
-- Verify PostToolUse hook in `.claude/settings.json`
-- Check hook path is correct
-
-**TypeScript errors from node_modules**
-- Set `showDependencyErrors: false`
-
-**ESLint/Prettier not found**
-- Install in project: `npm install --save-dev eslint prettier`
-- Or disable in config
-
-## Reference
-
-Based on: https://github.com/bartolli/claude-code-typescript-hooks

package/skills/documenting/tests/integration_test.sh

@@ -1,70 +0,0 @@
-#!/usr/bin/env bash
-# Integration test for documenting skill workflows
-
-set -e  # Exit on error
-
-TEST_DIR=$(mktemp -d)
-echo "Test directory: $TEST_DIR"
-
-# Ensure we are in the skill root (skills/documenting)
-cd "$(dirname "$0")/.."
-SKILL_ROOT=$(pwd)
-echo "Skill root: $SKILL_ROOT"
-
-# Test 1: Initialize CHANGELOG
-echo "Test 1: Initialize CHANGELOG"
-python3 -m scripts.changelog.init_changelog "$TEST_DIR/CHANGELOG.md"
-python3 -m scripts.changelog.validate_changelog "$TEST_DIR/CHANGELOG.md"
-echo "✅ CHANGELOG initialization passed"
-
-# Test 2: Add entries
-echo ""
-echo "Test 2: Add entries to CHANGELOG"
-python3 -m scripts.changelog.add_entry "$TEST_DIR/CHANGELOG.md" Added "Feature A"
-python3 -m scripts.changelog.add_entry "$TEST_DIR/CHANGELOG.md" Fixed "Bug B"
-python3 -m scripts.changelog.add_entry "$TEST_DIR/CHANGELOG.md" Changed "Refactor C"
-python3 -m scripts.changelog.validate_changelog "$TEST_DIR/CHANGELOG.md"
-echo "✅ Entry addition passed"
-
-# Test 3: Bump release
-echo ""
-echo "Test 3: Bump release version"
-python3 -m scripts.changelog.bump_release "$TEST_DIR/CHANGELOG.md" "1.0.0"
-python3 -m scripts.changelog.validate_changelog "$TEST_DIR/CHANGELOG.md"
-
-# Verify [Unreleased] is empty and [1.0.0] has entries
-# Check 3 lines after Unreleased (header, empty line, next header)
-if grep -A 2 "\[Unreleased\]" "$TEST_DIR/CHANGELOG.md" | grep -q "^- "; then
-    echo "❌ [Unreleased] should be empty after bump"
-    cat "$TEST_DIR/CHANGELOG.md"
-    exit 1
-fi
-
-if ! grep -A 10 "\[1.0.0\]" "$TEST_DIR/CHANGELOG.md" | grep -q "Feature A"; then
-    echo "❌ [1.0.0] should contain Feature A"
-    exit 1
-fi
-echo "✅ Release bump passed"
-
-# Test 4: Orchestrator
-echo ""
-echo "Test 4: Orchestrator workflow"
-mkdir -p "$TEST_DIR/.serena/memories"
-cp "$TEST_DIR/CHANGELOG.md" "$TEST_DIR/CHANGELOG.md.backup"
-
-python3 -m scripts.orchestrator "$TEST_DIR" feature "Orchestrator test feature" --scope=test --category=testing
-
-# Verify CHANGELOG updated
-if ! grep -q "Orchestrator test feature" "$TEST_DIR/CHANGELOG.md"; then
-    echo "❌ Orchestrator should have updated CHANGELOG"
-    exit 1
-fi
-echo "✅ Orchestrator passed"
-
-# Cleanup
-rm -rf "$TEST_DIR"
-
-echo ""
-echo "========================================="
-echo "✅ All integration tests passed!"
-echo "========================================="