@orchestrator-claude/definitions 3.5.0

package/hooks/pre-phase-advance.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# Pre-Phase Advance Hook
+# Executado antes de avancar para proxima fase
+# Avalia gate e cria checkpoint
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Recebe evento via stdin ou argumento
+if [ -n "$1" ]; then
+    EVENT="$1"
+else
+    EVENT=$(cat)
+fi
+
+# Verifica se temos o handler compilado
+HANDLER="$PROJECT_ROOT/dist/hook.js"
+
+if [ ! -f "$HANDLER" ]; then
+    echo '{"success": false, "error": "Hook handler not compiled. Run npm run build first."}' >&2
+    exit 1
+fi
+
+# Executa o handler TypeScript
+echo "$EVENT" | node "$HANDLER" pre-phase-advance
+
+EXIT_CODE=$?
+
+# Exit code determina se fase pode avancar
+# 0 = gate passou, pode avancar
+# 1 = gate falhou, bloqueado
+if [ $EXIT_CODE -eq 0 ]; then
+    echo "[pre-phase-advance] Gate passed, advancing phase" >&2
+else
+    echo "[pre-phase-advance] Gate failed, phase advance blocked" >&2
+fi
+
+exit $EXIT_CODE

package/hooks/track-agent-invocation.sh

@@ -0,0 +1,241 @@
+#!/bin/bash
+# Track Agent Invocation Hook
+# Registers agent invocations in orchestrator-index.json
+#
+# Usage (called by Claude Code hooks):
+#   track-agent-invocation.sh start    (reads stdin JSON)
+#   track-agent-invocation.sh complete (reads stdin JSON)
+#
+# Claude Code passes JSON via stdin with structure:
+#   { "tool_name": "Task", "tool_input": { "subagent_type": "...", ... } }
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+INDEX_FILE="$PROJECT_ROOT/.orchestrator/orchestrator-index.json"
+STATE_DIR="$PROJECT_ROOT/.orchestrator/.state"
+INVOCATION_FILE="$STATE_DIR/current-invocation"
+DEBUG_LOG="$STATE_DIR/hook-debug.log"
+
+# Ensure state directory exists
+mkdir -p "$STATE_DIR"
+
+# Log rotation: max 1MB, keep 3 rotated copies
+MAX_LOG_SIZE=1048576  # 1MB in bytes
+if [ -f "$DEBUG_LOG" ]; then
+  LOG_SIZE=$(stat -f%z "$DEBUG_LOG" 2>/dev/null || stat -c%s "$DEBUG_LOG" 2>/dev/null || echo 0)
+  if [ "$LOG_SIZE" -gt "$MAX_LOG_SIZE" ]; then
+    [ -f "${DEBUG_LOG}.2" ] && mv "${DEBUG_LOG}.2" "${DEBUG_LOG}.3"
+    [ -f "${DEBUG_LOG}.1" ] && mv "${DEBUG_LOG}.1" "${DEBUG_LOG}.2"
+    mv "$DEBUG_LOG" "${DEBUG_LOG}.1"
+  fi
+fi
+
+ACTION="${1:-}"
+
+# Read stdin into variable (Claude Code passes JSON via stdin)
+STDIN_DATA=""
+if [ ! -t 0 ]; then
+  STDIN_DATA=$(cat)
+fi
+
+case "$ACTION" in
+  start)
+    # Extract agent info from stdin JSON
+    # Structure: { "tool_name": "Task", "tool_input": { "subagent_type": "...", ... } }
+    if [ -n "$STDIN_DATA" ]; then
+      # Debug: log received data
+      echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] START stdin: $STDIN_DATA" >> "$DEBUG_LOG"
+
+      AGENT_NAME=$(echo "$STDIN_DATA" | node -e "
+        let data = '';
+        process.stdin.on('data', chunk => data += chunk);
+        process.stdin.on('end', () => {
+          try {
+            const json = JSON.parse(data);
+            // Try different structures
+            const type = json.tool_input?.subagent_type
+                      || json.subagent_type
+                      || json.tool_input?.type
+                      || 'unknown';
+            console.log(type);
+          } catch { console.log('unknown'); }
+        });
+      ")
+      PHASE=$(echo "$STDIN_DATA" | node -e "
+        let data = '';
+        process.stdin.on('data', chunk => data += chunk);
+        process.stdin.on('end', () => {
+          try {
+            const json = JSON.parse(data);
+            const type = json.tool_input?.subagent_type
+                      || json.subagent_type
+                      || json.tool_input?.type
+                      || 'unknown';
+            const phaseMap = {
+              'specifier': 'specify',
+              'planner': 'plan',
+              'task-generator': 'tasks',
+              'implementer': 'implement',
+              'researcher': 'research',
+              'reviewer': 'review',
+              'orchestrator': 'orchestrate'
+            };
+            console.log(phaseMap[type] || type);
+          } catch { console.log('unknown'); }
+        });
+      ")
+    elif [ -n "$CLAUDE_TOOL_INPUT" ]; then
+      # Fallback to environment variable
+      echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] START env: $CLAUDE_TOOL_INPUT" >> "$DEBUG_LOG"
+
+      AGENT_NAME=$(echo "$CLAUDE_TOOL_INPUT" | node -e "
+        let data = '';
+        process.stdin.on('data', chunk => data += chunk);
+        process.stdin.on('end', () => {
+          try {
+            const json = JSON.parse(data);
+            const type = json.subagent_type || json.tool_input?.subagent_type || 'unknown';
+            console.log(type);
+          } catch { console.log('unknown'); }
+        });
+      ")
+      PHASE="unknown"
+    else
+      echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] START no input received" >> "$DEBUG_LOG"
+      AGENT_NAME="unknown"
+      PHASE="unknown"
+    fi
+
+    # Generate invocation ID
+    INVOCATION_ID="inv-$(date +%s)-$(head -c 4 /dev/urandom | xxd -p)"
+    STARTED_AT=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    # Get workflow ID from index
+    WORKFLOW_ID=""
+    if [ -f "$INDEX_FILE" ]; then
+      WORKFLOW_ID=$(node -e "
+        const fs = require('fs');
+        try {
+          const idx = JSON.parse(fs.readFileSync('$INDEX_FILE', 'utf8'));
+          console.log(idx.activeWorkflow?.id || 'wf-standalone-' + Date.now());
+        } catch { console.log('wf-standalone-' + Date.now()); }
+      ")
+    fi
+
+    # Save invocation state
+    echo "$INVOCATION_ID" > "$INVOCATION_FILE"
+
+    # Update orchestrator-index.json
+    if [ -f "$INDEX_FILE" ]; then
+      node -e "
+        const fs = require('fs');
+        const indexPath = '$INDEX_FILE';
+        const idx = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+
+        if (!idx.agentInvocations) idx.agentInvocations = [];
+
+        idx.agentInvocations.push({
+          id: '$INVOCATION_ID',
+          agentName: '$AGENT_NAME',
+          phase: '$PHASE',
+          workflowId: '$WORKFLOW_ID',
+          startedAt: '$STARTED_AT',
+          completedAt: null,
+          status: 'running',
+          durationMs: 0
+        });
+
+        fs.writeFileSync(indexPath, JSON.stringify(idx, null, 2));
+        console.log(JSON.stringify({ invocationId: '$INVOCATION_ID', startedAt: '$STARTED_AT' }));
+      "
+    else
+      echo '{"invocationId": "'$INVOCATION_ID'", "startedAt": "'$STARTED_AT'", "warning": "No index file found"}'
+    fi
+    ;;
+
+  complete)
+    # Get invocation ID from state file
+    INVOCATION_ID=""
+    if [ -f "$INVOCATION_FILE" ]; then
+      INVOCATION_ID=$(cat "$INVOCATION_FILE")
+    fi
+
+    if [ -z "$INVOCATION_ID" ]; then
+      echo '{"success": false, "error": "No invocation ID found"}'
+      exit 0  # Don't fail the hook
+    fi
+
+    # Debug log
+    if [ -n "$STDIN_DATA" ]; then
+      echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] COMPLETE stdin: $STDIN_DATA" >> "$DEBUG_LOG"
+    fi
+
+    # Determine status - default to success
+    STATUS="success"
+    SUMMARY="Completed"
+
+    COMPLETED_AT=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    # Update orchestrator-index.json
+    if [ -f "$INDEX_FILE" ]; then
+      node -e "
+        const fs = require('fs');
+        const indexPath = '$INDEX_FILE';
+        const idx = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+
+        const invocations = idx.agentInvocations || [];
+        const invIdx = invocations.findIndex(i => i.id === '$INVOCATION_ID');
+
+        if (invIdx === -1) {
+          console.log(JSON.stringify({ success: false, error: 'Invocation not found' }));
+          process.exit(0);
+        }
+
+        const inv = invocations[invIdx];
+        const startTime = new Date(inv.startedAt).getTime();
+        const endTime = new Date('$COMPLETED_AT').getTime();
+        const durationMs = endTime - startTime;
+
+        invocations[invIdx] = {
+          ...inv,
+          completedAt: '$COMPLETED_AT',
+          status: '$STATUS' === 'success' ? 'completed' : 'failed',
+          durationMs,
+          result: {
+            status: '$STATUS',
+            summary: '$SUMMARY'
+          }
+        };
+
+        idx.agentInvocations = invocations;
+
+        // Update statistics
+        if (idx.statistics) {
+          idx.statistics.totalInvocations = invocations.length;
+          idx.statistics.lastActivity = '$COMPLETED_AT';
+        }
+
+        fs.writeFileSync(indexPath, JSON.stringify(idx, null, 2));
+        console.log(JSON.stringify({ success: true, durationMs }));
+      "
+    else
+      echo '{"success": false, "error": "No index file found"}'
+    fi
+
+    # Clean up state file
+    rm -f "$INVOCATION_FILE"
+    ;;
+
+  *)
+    echo "Usage: $0 {start|complete}"
+    echo ""
+    echo "This script is called by Claude Code hooks."
+    echo "It reads JSON from stdin with structure:"
+    echo '  { "tool_name": "Task", "tool_input": { "subagent_type": "...", ... } }'
+    echo ""
+    echo "Debug log: $DEBUG_LOG"
+    exit 0
+    ;;
+esac