mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios.git
synced 2026-10-16 01:37:05 +00:00
DonchitosandClaude Opus 5.5
b21fa0f7f2
Fix release for 1.1.1: the minimal path end to end, engine commands that run on Godot, Unity and Unreal, hook warnings you can see, and verdicts that say when they could not check. Details in CHANGELOG.md; upgrade steps in UPGRADING.md (v1.1.1 → v1.1.2). Fixes #67 Fixes #131 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WuJn2FdynEybfL5KC697nJ
90 lines
4.2 KiB
Bash
90 lines
4.2 KiB
Bash
#!/bin/bash
|
|
|
|
# --- work from the project root ----------------------------------------------
|
|
# Every path below is repo-relative, so a hook invoked with a working directory
|
|
# that is not the repo root would silently read and write the WRONG TREE --
|
|
# returning a near-empty result instead of the session-recovery block, and
|
|
# creating stray trees such as docs/production/session-logs/ on write.
|
|
#
|
|
# PRECEDENCE IS LOAD-BEARING. A cwd that IS a project root carries real
|
|
# information and must win: a caller sitting inside another project means that
|
|
# project, not this one. Resolving to the script's own location first would
|
|
# override them. So, in order:
|
|
# 1. cwd holds project.yaml -> cwd (a project root)
|
|
# 2. cwd holds .claude/ -> cwd (a project root not yet configured)
|
|
# 3. CLAUDE_PROJECT_DIR -> that (populated in the hook environment)
|
|
# 4. this script's location -> <root>/.claude/hooks/../.. by construction
|
|
# Rule 4 always works and needs no environment at all; rules 1-2 stop it from
|
|
# overriding a caller that legitimately means somewhere else.
|
|
#
|
|
# NOT an upward search: that resolves a nested project to its parent's config.
|
|
if [ -f "project.yaml" ] || [ -d ".claude" ]; then
|
|
CCGS_ROOT="$PWD"
|
|
elif [ -n "${CLAUDE_PROJECT_DIR:-}" ] && [ -d "${CLAUDE_PROJECT_DIR}" ]; then
|
|
CCGS_ROOT="$CLAUDE_PROJECT_DIR"
|
|
else
|
|
CCGS_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." 2>/dev/null && pwd)"
|
|
fi
|
|
[ -n "$CCGS_ROOT" ] && cd "$CCGS_ROOT" 2>/dev/null || true
|
|
|
|
# Claude Code SubagentStart hook: Log agent invocations for audit trail
|
|
# Tracks which agents are being used and when
|
|
#
|
|
# Input schema (SubagentStart) — per Claude Code hooks reference:
|
|
# { "session_id": "...", "agent_id": "agent-abc123", "agent_type": "Explore", ... }
|
|
#
|
|
# The agent name is in `agent_type`, NOT `agent_name`. Reading `.agent_name`
|
|
# returns null on every invocation, so the fallback "unknown" is always used
|
|
# and the audit trail captures nothing useful.
|
|
|
|
# features.session_state: off => no audit trail, no spawn tally. Default is
|
|
# `on`, so this changes nothing unless the user opted out. Checked before
|
|
# reading stdin: there is no point paying for the parse we are about to discard.
|
|
if [ -f .claude/hooks/yaml-helper.sh ]; then
|
|
. .claude/hooks/yaml-helper.sh
|
|
session_state_enabled || exit 0
|
|
fi
|
|
|
|
INPUT=$(cat)
|
|
|
|
# Claude Code's own internal agents (prompt suggestions, /btw side questions)
|
|
# report agent_type as an empty string -- not a CCGS spawn. log-agent-stop.sh
|
|
# skips them; so does this hook, or one would be logged as "unknown" and
|
|
# counted in session-stop.sh's spawn tally. A MISSING agent_type still logs.
|
|
if printf '%s' "$INPUT" | grep -qE '"agent_type"[[:space:]]*:[[:space:]]*""'; then
|
|
exit 0
|
|
fi
|
|
|
|
# Parse agent name -- use jq if available, fall back to grep
|
|
if command -v jq >/dev/null 2>&1; then
|
|
AGENT_NAME=$(echo "$INPUT" | jq -r '.agent_type // "unknown"' 2>/dev/null)
|
|
else
|
|
AGENT_NAME=$(echo "$INPUT" | grep -oE '"agent_type"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/"agent_type"[[:space:]]*:[[:space:]]*"//;s/"$//')
|
|
fi
|
|
# OUTSIDE the branch, like SESSION_ID below. jq's `// "unknown"` substitutes for
|
|
# null and false but NOT for an empty string, so the jq path could emit a record
|
|
# with no agent name at all while the grep path guarded against it. One guard,
|
|
# both paths.
|
|
[ -z "$AGENT_NAME" ] && AGENT_NAME="unknown"
|
|
|
|
# Parse session id -- session-stop.sh tallies spawns per session, so the record
|
|
# is useless without it. Same jq/grep fallback pattern as the agent name.
|
|
if command -v jq >/dev/null 2>&1; then
|
|
SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"' 2>/dev/null)
|
|
else
|
|
SESSION_ID=$(echo "$INPUT" | grep -oE '"session_id"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/"session_id"[[:space:]]*:[[:space:]]*"//;s/"$//')
|
|
fi
|
|
[ -z "$SESSION_ID" ] && SESSION_ID="unknown"
|
|
|
|
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
|
|
SESSION_LOG_DIR="production/session-logs"
|
|
|
|
mkdir -p "$SESSION_LOG_DIR" 2>/dev/null
|
|
|
|
# Field order is timestamp | session | event -- session-stop.sh greps the
|
|
# fixed string " | $SESSION_ID | Agent invoked: " to tally the current session.
|
|
# Changing this format silently breaks the spawn count (nothing else reads it).
|
|
echo "$TIMESTAMP | $SESSION_ID | Agent invoked: $AGENT_NAME" >> "$SESSION_LOG_DIR/agent-audit.log" 2>/dev/null
|
|
|
|
exit 0
|