xtrm-tools 2.1.6 → 2.1.8

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 "========================================="

package/skills/documenting/tests/test_changelog.py

@@ -1,201 +0,0 @@
-#!/usr/bin/env python3
-"""Tests for CHANGELOG management scripts."""
-
-import pytest
-from pathlib import Path
-from scripts.changelog.validate_changelog import validate_changelog
-from scripts.changelog.add_entry import add_entry, ChangeCategory
-from scripts.changelog.bump_release import bump_release
-from datetime import date
-import tempfile
-
-
-def test_valid_changelog_passes():
-    """Valid Keep a Changelog format should pass validation."""
-    valid_content = """# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-- New feature description
-
-## [1.0.0] - 2026-02-01
-
-### Added
-- Initial release
-"""
-    result = validate_changelog(valid_content)
-    assert result["valid"] is True
-    assert len(result["errors"]) == 0
-
-
-def test_missing_unreleased_section_fails():
-    """CHANGELOG without [Unreleased] section should fail."""
-    invalid_content = """# Changelog
-
-## [1.0.0] - 2026-02-01
-
-### Added
-- Initial release
-"""
-    result = validate_changelog(invalid_content)
-    assert result["valid"] is False
-    assert any("Unreleased" in err for err in result["errors"])
-
-
-def test_invalid_semver_fails():
-    """CHANGELOG with invalid semver should fail."""
-    invalid_content = """# Changelog
-
-## [Unreleased]
-
-## [1.0] - 2026-02-01
-
-### Added
-- Initial release
-"""
-    result = validate_changelog(invalid_content)
-    assert result["valid"] is False
-    assert any("semantic version" in err.lower() for err in result["errors"])
-
-
-def test_invalid_category_fails():
-    """CHANGELOG with invalid category should fail."""
-    invalid_content = """# Changelog
-
-## [Unreleased]
-
-### InvalidCategory
-- Some change
-
-## [1.0.0] - 2026-02-01
-
-### Added
-- Initial release
-"""
-    result = validate_changelog(invalid_content)
-    assert result["valid"] is False
-    assert any("category" in err.lower() for err in result["errors"])
-
-
-def test_add_entry_to_unreleased():
-    """Adding entry should place it under [Unreleased] in correct category."""
-    changelog_content = """# Changelog
-
-## [Unreleased]
-
-## [1.0.0] - 2026-02-01
-
-### Added
-- Initial release
-"""
-
-    result = add_entry(
-        changelog_content,
-        category=ChangeCategory.ADDED,
-        description="New feature X"
-    )
-
-    assert "### Added" in result
-    assert "- New feature X" in result
-    # Should be under [Unreleased], not under [1.0.0]
-    unreleased_section = result.split("## [1.0.0]")[0]
-    assert "- New feature X" in unreleased_section
-
-
-def test_add_entry_creates_category_if_missing():
-    """Adding entry should create category section if it doesn't exist."""
-    changelog_content = """# Changelog
-
-## [Unreleased]
-
-## [1.0.0] - 2026-02-01
-
-### Added
-- Initial release
-"""
-
-    result = add_entry(
-        changelog_content,
-        category=ChangeCategory.FIXED,
-        description="Bug fix Y"
-    )
-
-    assert "### Fixed" in result
-    assert "- Bug fix Y" in result
-
-
-def test_add_entry_maintains_category_order():
-    """Categories should be ordered: Added, Changed, Deprecated, Removed, Fixed, Security."""
-    changelog_content = """# Changelog
-
-## [Unreleased]
-
-### Added
-- Feature A
-
-### Fixed
-- Bug B
-
-## [1.0.0] - 2026-02-01
-"""
-
-    result = add_entry(
-        changelog_content,
-        category=ChangeCategory.CHANGED,
-        description="Change C"
-    )
-
-    # Changed should appear between Added and Fixed
-    lines = result.split('\n')
-    added_idx = next(i for i, line in enumerate(lines) if "### Added" in line)
-    changed_idx = next(i for i, line in enumerate(lines) if "### Changed" in line)
-    fixed_idx = next(i for i, line in enumerate(lines) if "### Fixed" in line)
-
-    assert added_idx < changed_idx < fixed_idx
-
-
-def test_bump_release_moves_unreleased():
-    """Bumping release should move [Unreleased] to [X.Y.Z] - DATE."""
-    changelog_content = """# Changelog
-
-## [Unreleased]
-
-### Added
-- New feature
-
-## [1.0.0] - 2026-01-01
-
-### Added
-- Initial release
-"""
-
-    result = bump_release(changelog_content, "1.1.0")
-
-    # Should have new version section
-    assert "## [1.1.0]" in result
-    assert f"## [1.1.0] - {date.today().strftime('%Y-%m-%d')}" in result
-
-    # New feature should be under 1.1.0 now
-    version_section = result.split("## [1.0.0]")[0]
-    assert "- New feature" in version_section
-
-    # [Unreleased] should be empty
-    unreleased_section = result.split("## [1.1.0]")[0]
-    assert "## [Unreleased]" in unreleased_section
-    # No ### categories under [Unreleased]
-    unreleased_lines = unreleased_section.split("## [Unreleased]")[1].split('\\n')
-    assert not any(line.startswith("###") for line in unreleased_lines)
-
-
-def test_bump_release_validates_semver():
-    """Bumping with invalid semver should raise error."""
-    changelog_content = "## [Unreleased]"
-
-    with pytest.raises(ValueError, match="semantic version"):
-        bump_release(changelog_content, "1.0")

package/skills/documenting/tests/test_drift_detector.py

@@ -1,80 +0,0 @@
-import pytest
-from pathlib import Path
-import sys
-sys.path.insert(0, str(Path(__file__).parent.parent / "scripts"))
-from drift_detector import extract_tracks, match_files_to_tracks, format_scan_report
-
-
-MEMORY_WITH_TRACKS = """---
-title: Test SSOT
-version: 1.0.0
-updated: 2026-02-01
-tracks:
-  - "cli/src/**/*.ts"
-  - "hooks/**/*.py"
----
-
-## Purpose
-Test memory.
-"""
-
-MEMORY_NO_TRACKS = """---
-title: No Tracks
-version: 1.0.0
-updated: 2026-02-01
----
-
-## Purpose
-No tracking.
-"""
-
-
-def test_extract_tracks_finds_globs():
-    tracks = extract_tracks(MEMORY_WITH_TRACKS)
-    assert tracks == ["cli/src/**/*.ts", "hooks/**/*.py"]
-
-
-def test_extract_tracks_empty_when_missing():
-    tracks = extract_tracks(MEMORY_NO_TRACKS)
-    assert tracks == []
-
-
-def test_match_files_to_tracks_hit():
-    files = ["cli/src/core/diff.ts", "hooks/skill-suggestion.py"]
-    tracks = ["cli/src/**/*.ts", "hooks/**/*.py"]
-    matched = match_files_to_tracks(files, tracks)
-    assert "cli/src/core/diff.ts" in matched
-    assert "hooks/skill-suggestion.py" in matched
-
-
-def test_match_files_to_tracks_miss():
-    files = ["docs/README.md"]
-    tracks = ["cli/src/**/*.ts"]
-    assert match_files_to_tracks(files, tracks) == []
-
-
-def test_format_scan_report_stale():
-    stale = {"my_memory": {"files": ["cli/src/core/diff.ts"], "updated": "2026-02-01"}}
-    report = format_scan_report(stale)
-    assert "my_memory" in report
-    assert "cli/src/core/diff.ts" in report
-
-
-def test_format_scan_report_clean():
-    report = format_scan_report({})
-    assert any(word in report.lower() for word in ["clean", "no stale", "up to date"])
-
-
-def test_match_files_to_tracks_no_false_positive():
-    """A .py file in an unrelated dir must NOT match hooks/**/*.py"""
-    files = ["cli/src/transform.py", "docs/something.py"]
-    tracks = ["hooks/**/*.py"]
-    assert match_files_to_tracks(files, tracks) == []
-
-
-def test_match_files_to_tracks_direct_child():
-    """hooks/**/*.py must match files directly under hooks/ (no subdir)"""
-    files = ["hooks/skill-suggestion.py"]
-    tracks = ["hooks/**/*.py"]
-    matched = match_files_to_tracks(files, tracks)
-    assert "hooks/skill-suggestion.py" in matched

package/skills/documenting/tests/test_orchestrator.py

@@ -1,52 +0,0 @@
-#!/usr/bin/env python3
-"""Tests for documentation orchestrator."""
-
-import pytest
-from pathlib import Path
-from scripts.orchestrator import DocumentingOrchestrator, ChangeType
-
-
-def test_orchestrator_routes_to_correct_docs(tmp_path):
-    """Orchestrator should update relevant docs based on change type."""
-    # Setup test project
-    project_root = tmp_path / "test_project"
-    project_root.mkdir()
-
-    changelog = project_root / "CHANGELOG.md"
-    changelog.write_text("""# Changelog
-
-## [Unreleased]
-
-## [0.1.0] - 2026-02-01
-
-### Added
-- Initial release
-""", encoding="utf-8")
-
-    serena_memories = project_root / ".serena" / "memories"
-    serena_memories.mkdir(parents=True)
-
-    orchestrator = DocumentingOrchestrator(project_root)
-
-    result = orchestrator.document_change(
-        change_type=ChangeType.FEATURE,
-        description="Add new API endpoint",
-        details={
-            "scope": "api-endpoints",
-            "category": "backend",
-            "files_changed": ["server.py", "routes/api.py"]
-        }
-    )
-
-    # Should update CHANGELOG
-    assert result["changelog_updated"] is True
-    # Should create/update SSOT
-    assert result["ssot_updated"] is False # Placeholder impl in plan returns False
-    # Should suggest README update
-    assert "readme_suggestions" in result
-
-
-def test_orchestrator_validates_all_docs():
-    """Orchestrator should validate all documentation after updates."""
-    # Test validation integration
-    pass