anvil-dev-framework 0.1.6

package/global/hooks/statusline_agent_sync.py

@@ -0,0 +1,224 @@
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
+"""
+statusline_agent_sync.py - Sync statusline data to agent registry for HUD
+
+This script reads Claude Code JSON from stdin (same as statusline.sh) and
+updates the global agent registry with model, context, and cost information.
+
+Called by statusline.sh after processing its output.
+
+IMPORTANT (ANV-176): This script serves as a HEARTBEAT mechanism.
+Each call to update_agent() updates the agent's lastActivity timestamp,
+keeping the agent marked as "active" in the registry. Agents that don't
+call this regularly (within 5 minutes) are considered stale and filtered
+out of the agent count.
+
+ANV-176 FIX: Added ensure_agent_registered() as a self-healing mechanism.
+If SessionStart failed to register the agent, this will auto-register it
+on the first heartbeat, preventing orphaned agents.
+"""
+
+import json
+import os
+import sys
+from pathlib import Path
+
+# Add global lib to path for agent_registry
+_global_lib = Path(__file__).parent.parent / "lib"
+if _global_lib.exists():
+    sys.path.insert(0, str(_global_lib))
+
+try:
+    from agent_registry import update_agent, get_registry, register_agent
+    REGISTRY_AVAILABLE = True
+except ImportError:
+    REGISTRY_AVAILABLE = False
+
+
+def get_agent_id_from_state():
+    """Read agent ID from anvil-state.json."""
+    state_file = Path(".claude/anvil-state.json")
+    try:
+        if state_file.exists():
+            state = json.loads(state_file.read_text())
+            return state.get("session", {}).get("agentId")
+    except Exception:
+        pass
+    return None
+
+
+def get_phase_from_state():
+    """Read workflow phase from anvil-state.json."""
+    state_file = Path(".claude/anvil-state.json")
+    try:
+        if state_file.exists():
+            state = json.loads(state_file.read_text())
+            return state.get("session", {}).get("phase")
+    except Exception:
+        pass
+    return None
+
+
+def get_issue_from_state():
+    """Read active issue from anvil-state.json."""
+    state_file = Path(".claude/anvil-state.json")
+    try:
+        if state_file.exists():
+            state = json.loads(state_file.read_text())
+            return state.get("session", {}).get("activeIssue")
+    except Exception:
+        pass
+    return None
+
+
+def find_agent_by_project():
+    """Find agent ID by matching project path in registry."""
+    if not REGISTRY_AVAILABLE:
+        return None
+
+    try:
+        registry = get_registry()
+        agents = registry.get_all()
+        cwd = os.getcwd()
+
+        for agent_id, agent in agents.items():
+            if agent.get("project") == cwd:
+                return agent_id
+    except Exception:
+        pass
+    return None
+
+
+def ensure_agent_registered(agent_id: str, model: str = "Claude") -> bool:
+    """Ensure agent is registered in the global registry.
+
+    This is a self-healing mechanism (ANV-176 fix). If the SessionStart hook
+    failed to register the agent, this will auto-register it on the first
+    heartbeat, preventing the agent from being orphaned.
+
+    Args:
+        agent_id: The agent ID from anvil-state.json
+        model: The model name (Opus, Sonnet, Haiku)
+
+    Returns:
+        True if agent was registered (new or existing), False on error
+    """
+    if not REGISTRY_AVAILABLE:
+        return False
+
+    try:
+        registry = get_registry()
+        # Read raw registry without cleanup to check if agent exists
+        raw_registry = registry._read_registry()
+        agents = raw_registry.get("agents", {})
+
+        if agent_id in agents:
+            return True  # Already registered
+
+        # Agent not in registry - auto-register it
+        # This happens when SessionStart registration failed or after context compaction
+        project_path = os.getcwd()
+
+        register_agent(
+            agent_id=agent_id,
+            project=project_path,
+            model=model
+        )
+        return True
+
+    except Exception:
+        return False
+
+
+def main():
+    if not REGISTRY_AVAILABLE:
+        sys.exit(0)
+
+    try:
+        input_data = json.load(sys.stdin)
+
+        # Get agent ID (from state file or by matching project)
+        agent_id = get_agent_id_from_state() or find_agent_by_project()
+        if not agent_id:
+            sys.exit(0)
+
+        # Extract model name
+        model_info = input_data.get("model", {})
+        model_name = model_info.get("display_name", "Claude")
+        if "Opus" in model_name:
+            model_name = "Opus"
+        elif "Sonnet" in model_name:
+            model_name = "Sonnet"
+        elif "Haiku" in model_name:
+            model_name = "Haiku"
+
+        # Extract transcript path for tool activity (ANV-126)
+        transcript_path = input_data.get("transcript_path", "")
+
+        # Extract context info
+        context_window = input_data.get("context_window", {})
+        current_usage = context_window.get("current_usage", {})
+        context_limit = context_window.get("context_window_size", 200000)
+
+        # Extract detailed token breakdown (ANV-91)
+        tokens_input = current_usage.get("input_tokens", 0)
+        tokens_output = current_usage.get("output_tokens", 0)
+        tokens_cache_read = current_usage.get("cache_read_input_tokens", 0)
+        tokens_cache_write = current_usage.get("cache_creation_input_tokens", 0)
+
+        # Context usage = input + cache write (what counts toward limit)
+        context_usage = tokens_input + tokens_cache_write
+
+        # Extract legacy cost (for backward compat, will be replaced by token calc)
+        cost_info = input_data.get("cost", {})
+        session_cost = cost_info.get("total_cost_usd", 0.0)
+
+        # Check if we have token data for detailed tracking
+        has_token_data = any([tokens_input, tokens_output, tokens_cache_read, tokens_cache_write])
+
+        # Get phase and issue from local state for sync
+        phase = get_phase_from_state()
+        issue = get_issue_from_state()
+
+        # ANV-176 FIX: Ensure agent is registered before updating
+        # This is a self-healing mechanism - if SessionStart registration failed
+        # (e.g., after context compaction), auto-register on first heartbeat
+        ensure_agent_registered(agent_id, model_name)
+
+        # Update agent registry with token data for cost attribution (ANV-90/91)
+        update_kwargs = {
+            "agent_id": agent_id,
+            "model": model_name if model_name != "Claude" else None,
+            "context_usage": context_usage if context_usage > 0 else None,
+            "context_limit": context_limit if context_limit > 0 else None,
+            "transcript_path": transcript_path if transcript_path else None,
+            "phase": phase,
+            "issue": issue,
+        }
+
+        if has_token_data:
+            update_kwargs.update({
+                "tokens_input": tokens_input,
+                "tokens_output": tokens_output,
+                "tokens_cache_read": tokens_cache_read,
+                "tokens_cache_write": tokens_cache_write,
+            })
+        elif session_cost > 0:
+            update_kwargs["session_cost"] = session_cost
+
+        update_agent(**update_kwargs)
+
+    except json.JSONDecodeError:
+        pass
+    except Exception:
+        pass
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

package/global/hooks/stop_gate.sh

@@ -0,0 +1,250 @@
+#!/bin/bash
+# =============================================================================
+# stop_gate.sh - Verification Gate for Stop Hook (ANV-152)
+# =============================================================================
+#
+# Prevents Claude from exiting when verification fails. This ensures the AI
+# cannot prematurely complete tasks with broken code.
+#
+# Usage: Called automatically by Claude Code on stop events
+#
+# Environment Variables:
+#   ANVIL_REQUIRE_VERIFICATION - Set to "false" to disable gate (default: true)
+#   ANVIL_FORCE_EXIT          - Set to "true" to bypass gate
+#   ANVIL_STOP_GATE_LOG       - Set to "true" to enable logging
+#
+# Exit Codes:
+#   0 - Allow exit
+#   1 - Block exit (verification failed)
+#
+
+set -euo pipefail
+
+# =============================================================================
+# Configuration
+# =============================================================================
+
+REQUIRE_VERIFY="${ANVIL_REQUIRE_VERIFICATION:-true}"
+FORCE_EXIT="${ANVIL_FORCE_EXIT:-false}"
+ENABLE_LOGGING="${ANVIL_STOP_GATE_LOG:-false}"
+LOG_FILE=".claude/logs/stop_gate.log"
+
+# Get script directory for relative imports
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# =============================================================================
+# Logging
+# =============================================================================
+
+log_event() {
+    local level="$1"
+    local message="$2"
+    local timestamp
+    timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    if [[ "$ENABLE_LOGGING" == "true" ]]; then
+        mkdir -p "$(dirname "$LOG_FILE")"
+        echo "[$timestamp] [$level] $message" >> "$LOG_FILE"
+    fi
+
+    # Also output to stderr for visibility
+    case "$level" in
+        ERROR) echo "❌ $message" >&2 ;;
+        WARN)  echo "⚠️  $message" >&2 ;;
+        INFO)  echo "ℹ️  $message" >&2 ;;
+        OK)    echo "✅ $message" >&2 ;;
+    esac
+}
+
+# =============================================================================
+# Verification Functions
+# =============================================================================
+
+detect_project_type() {
+    if [[ -f "package.json" ]]; then
+        echo "nodejs"
+    elif [[ -f "pyproject.toml" ]] || [[ -f "setup.py" ]]; then
+        echo "python"
+    elif [[ -f "Cargo.toml" ]]; then
+        echo "rust"
+    elif [[ -f "go.mod" ]]; then
+        echo "go"
+    else
+        echo "unknown"
+    fi
+}
+
+run_tests() {
+    local project_type="$1"
+
+    case "$project_type" in
+        nodejs)
+            npm test --silent 2>/dev/null
+            ;;
+        python)
+            pytest --quiet 2>/dev/null || python -m pytest --quiet 2>/dev/null
+            ;;
+        rust)
+            cargo test --quiet 2>/dev/null
+            ;;
+        go)
+            go test ./... 2>/dev/null
+            ;;
+        *)
+            # Try common test commands
+            npm test --silent 2>/dev/null || pytest --quiet 2>/dev/null || true
+            ;;
+    esac
+}
+
+run_lint() {
+    local project_type="$1"
+
+    case "$project_type" in
+        nodejs)
+            npm run lint --silent 2>/dev/null
+            ;;
+        python)
+            ruff check . --quiet 2>/dev/null || true
+            ;;
+        rust)
+            cargo clippy --quiet 2>/dev/null || true
+            ;;
+        go)
+            golangci-lint run --quiet 2>/dev/null || true
+            ;;
+        *)
+            npm run lint --silent 2>/dev/null || true
+            ;;
+    esac
+}
+
+run_typecheck() {
+    local project_type="$1"
+
+    case "$project_type" in
+        nodejs)
+            npm run typecheck --silent 2>/dev/null || npm run type-check --silent 2>/dev/null || npm run tsc --silent 2>/dev/null
+            ;;
+        python)
+            mypy . --quiet 2>/dev/null || true
+            ;;
+        rust)
+            cargo check --quiet 2>/dev/null
+            ;;
+        *)
+            npm run typecheck --silent 2>/dev/null || true
+            ;;
+    esac
+}
+
+check_verification_state() {
+    # Check if verification state file exists and shows passing
+    local state_file=".claude/verification-state.json"
+
+    if [[ -f "$state_file" ]]; then
+        local status
+        status=$(python3 -c "import json; print(json.load(open('$state_file')).get('status', 'unknown'))" 2>/dev/null || echo "unknown")
+
+        if [[ "$status" == "passed" ]]; then
+            return 0
+        fi
+    fi
+
+    return 1
+}
+
+# =============================================================================
+# Main Gate Logic
+# =============================================================================
+
+main() {
+    log_event "INFO" "Stop gate triggered"
+
+    # Check if verification is required
+    if [[ "$REQUIRE_VERIFY" != "true" ]]; then
+        log_event "INFO" "Verification disabled (ANVIL_REQUIRE_VERIFICATION=$REQUIRE_VERIFY)"
+        exit 0
+    fi
+
+    # Check for explicit force exit override
+    if [[ "$FORCE_EXIT" == "true" ]]; then
+        log_event "WARN" "Force exit requested - bypassing verification gate"
+        exit 0
+    fi
+
+    # Check for recent passing verification state
+    if check_verification_state; then
+        log_event "OK" "Recent verification passed - allowing exit"
+        exit 0
+    fi
+
+    log_event "INFO" "Running verification gate checks..."
+
+    # Detect project type
+    local project_type
+    project_type=$(detect_project_type)
+    log_event "INFO" "Detected project type: $project_type"
+
+    local failed=false
+    local failure_reasons=()
+
+    # Run tests
+    log_event "INFO" "Running tests..."
+    if ! run_tests "$project_type"; then
+        failed=true
+        failure_reasons+=("tests")
+        log_event "ERROR" "Tests failed"
+    else
+        log_event "OK" "Tests passed"
+    fi
+
+    # Run lint (continue even if tests failed)
+    log_event "INFO" "Running lint..."
+    if ! run_lint "$project_type"; then
+        failed=true
+        failure_reasons+=("lint")
+        log_event "ERROR" "Lint failed"
+    else
+        log_event "OK" "Lint passed"
+    fi
+
+    # Run typecheck (continue even if others failed)
+    log_event "INFO" "Running type check..."
+    if ! run_typecheck "$project_type"; then
+        failed=true
+        failure_reasons+=("types")
+        log_event "ERROR" "Type check failed"
+    else
+        log_event "OK" "Type check passed"
+    fi
+
+    # Final decision
+    if [[ "$failed" == "true" ]]; then
+        local reasons
+        reasons=$(IFS=", "; echo "${failure_reasons[*]}")
+        log_event "ERROR" "Verification gate BLOCKED - failures: $reasons"
+
+        echo ""
+        echo "🚫 Cannot exit - verification failed"
+        echo "   Failing: $reasons"
+        echo ""
+        echo "Options:"
+        echo "  1. Fix the issues and try again"
+        echo "  2. Run /verify to see details"
+        echo "  3. Use /force-exit to bypass (not recommended)"
+        echo ""
+
+        exit 1
+    fi
+
+    log_event "OK" "Verification gate PASSED - allowing exit"
+    exit 0
+}
+
+# =============================================================================
+# Entry Point
+# =============================================================================
+
+main "$@"

package/global/lib/.claude/anvil-state.json

@@ -0,0 +1,21 @@
+{
+  "version": "1.0",
+  "session": {
+    "docCoverage": {
+      "percent": 81.0,
+      "total": 268,
+      "documented": 217,
+      "status": "healthy",
+      "timestamp": "2026-01-11T12:05:20.361234+00:00"
+    },
+    "lastCommand": "/doc-coverage",
+    "lastCommandAt": "2026-01-11T12:05:20.361235+00:00"
+  },
+  "cache": {
+    "git": {}
+  },
+  "meta": {
+    "createdAt": "2026-01-11T12:05:20.361088+00:00",
+    "updatedAt": "2026-01-11T12:05:20.361237+00:00"
+  }
+}