arkaos 2.0.0-alpha.1

package/config/hooks/post-tool-use-v2.sh

@@ -0,0 +1,116 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ArkaOS v2 — PostToolUse Hook (Error Pattern Tracking)
+# Tracks recurring errors from tool output for gotchas system
+# Timeout: 5s
+# ============================================================================
+
+input=$(cat)
+
+ARKAOS_HOME="${HOME}/.arkaos"
+GOTCHAS_FILE="$ARKAOS_HOME/gotchas.json"
+
+mkdir -p "$ARKAOS_HOME" 2>/dev/null
+
+# ─── Check for errors ────────────────────────────────────────────────────
+exit_code=""
+tool_output=""
+
+if command -v jq &>/dev/null; then
+  exit_code=$(echo "$input" | jq -r '.exitCode // ""' 2>/dev/null)
+  tool_output=$(echo "$input" | jq -r '.output // ""' 2>/dev/null | head -c 2000)
+fi
+
+# Only track if there's an error
+if [ "$exit_code" = "0" ] || [ -z "$exit_code" ]; then
+  # Check for error patterns in output
+  if ! echo "$tool_output" | grep -qiE '(error|exception|fatal|failed|denied|not found)'; then
+    exit 0
+  fi
+fi
+
+# ─── Extract and normalize error pattern ─────────────────────────────────
+error_line=$(echo "$tool_output" | grep -iE '(error|exception|fatal|failed)' | head -1 | head -c 200)
+
+if [ -z "$error_line" ]; then
+  exit 0
+fi
+
+# Normalize: remove timestamps, hashes, line numbers
+pattern=$(echo "$error_line" | sed -E \
+  -e 's/[0-9]{4}-[0-9]{2}-[0-9]{2}[T ][0-9:.]+//g' \
+  -e 's/[a-f0-9]{7,40}//g' \
+  -e 's/line [0-9]+/line N/g' \
+  -e 's/[0-9]+ms/Nms/g' \
+  -e 's/\s+/ /g' \
+  | head -c 150)
+
+# ─── Categorize ──────────────────────────────────────────────────────────
+category="general"
+if echo "$error_line" | grep -qiE '(laravel|artisan|eloquent|migration|php)'; then
+  category="laravel"
+elif echo "$error_line" | grep -qiE '(vue|nuxt|react|next|npm|node|webpack|vite)'; then
+  category="frontend"
+elif echo "$error_line" | grep -qiE '(git|merge|rebase|checkout|branch)'; then
+  category="git"
+elif echo "$error_line" | grep -qiE '(postgres|mysql|sqlite|database|query|migration)'; then
+  category="database"
+elif echo "$error_line" | grep -qiE '(permission|denied|access|chmod|chown)'; then
+  category="permissions"
+elif echo "$error_line" | grep -qiE '(test|assert|expect|jest|phpunit|pytest)'; then
+  category="testing"
+fi
+
+# ─── Store gotcha (concurrent-safe with flock) ───────────────────────────
+timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+cwd=$(pwd)
+project=$(basename "$cwd")
+
+(
+  flock -w 2 200 || exit 0
+
+  # Initialize if empty
+  if [ ! -f "$GOTCHAS_FILE" ] || [ ! -s "$GOTCHAS_FILE" ]; then
+    echo "[]" > "$GOTCHAS_FILE"
+  fi
+
+  if command -v python3 &>/dev/null; then
+    python3 -c "
+import json, sys
+try:
+    with open('$GOTCHAS_FILE') as f:
+        gotchas = json.load(f)
+except:
+    gotchas = []
+
+pattern = '''$pattern'''
+found = False
+for g in gotchas:
+    if g.get('pattern') == pattern:
+        g['count'] = g.get('count', 1) + 1
+        g['last_seen'] = '$timestamp'
+        if '$project' not in g.get('projects', []):
+            g.setdefault('projects', []).append('$project')
+        found = True
+        break
+
+if not found:
+    gotchas.append({
+        'pattern': pattern,
+        'category': '$category',
+        'count': 1,
+        'first_seen': '$timestamp',
+        'last_seen': '$timestamp',
+        'projects': ['$project'],
+    })
+
+# Keep top 100
+gotchas.sort(key=lambda g: g.get('count', 0), reverse=True)
+gotchas = gotchas[:100]
+
+with open('$GOTCHAS_FILE', 'w') as f:
+    json.dump(gotchas, f, indent=2)
+" 2>/dev/null
+  fi
+
+) 200>"$GOTCHAS_FILE.lock"

package/config/hooks/post-tool-use.sh

@@ -0,0 +1,188 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ARKA OS — PostToolUse Hook (Gotchas Memory)
+# Detects errors from tool output and tracks recurring patterns
+# Timeout: 5s | Output: JSON to stdout
+# ============================================================================
+
+input=$(cat)
+
+# ─── Performance Timing ──────────────────────────────────────────────────
+_HOOK_START=$(date +%s 2>/dev/null)
+_HOOK_START_NS=$(date +%s%N 2>/dev/null || echo "0")
+_hook_ms() {
+  local end_ns=$(date +%s%N 2>/dev/null || echo "0")
+  if [ "$_HOOK_START_NS" != "0" ] && [ "$end_ns" != "0" ] && [ ${#end_ns} -gt 10 ]; then
+    echo $(( (end_ns - _HOOK_START_NS) / 1000000 ))
+  else
+    echo $(( ($(date +%s) - _HOOK_START) * 1000 ))
+  fi
+}
+
+# Extract fields
+TOOL_NAME=$(echo "$input" | jq -r '.tool_name // ""' 2>/dev/null)
+TOOL_OUTPUT=$(echo "$input" | jq -r '.tool_output // ""' 2>/dev/null)
+EXIT_CODE=$(echo "$input" | jq -r '.exit_code // "0"' 2>/dev/null)
+CWD=$(echo "$input" | jq -r '.cwd // ""' 2>/dev/null)
+
+# Only process if there was an error
+if [ "$EXIT_CODE" = "0" ] || [ -z "$EXIT_CODE" ]; then
+  # Also check for error patterns in output even with exit code 0
+  if ! echo "$TOOL_OUTPUT" | grep -qiE '(error:|fatal:|exception:|failed|ENOENT|EACCES|EPERM|panic:)'; then
+    echo '{}'
+    exit 0
+  fi
+fi
+
+# ─── Extract Error Pattern ────────────────────────────────────────────────
+# Get first meaningful error line (skip blank lines, timestamps)
+ERROR_LINE=$(echo "$TOOL_OUTPUT" | grep -iE '(error|fatal|exception|failed|ENOENT|EACCES|EPERM|panic|cannot|not found|permission denied)' | head -1)
+
+if [ -z "$ERROR_LINE" ]; then
+  # Fallback: first non-empty line of output for non-zero exit
+  ERROR_LINE=$(echo "$TOOL_OUTPUT" | head -5 | tail -1)
+fi
+
+[ -z "$ERROR_LINE" ] && { echo '{}'; exit 0; }
+
+# Normalize: remove timestamps, hashes, paths with unique segments, line numbers
+PATTERN=$(echo "$ERROR_LINE" | \
+  sed -E 's/[0-9]{4}-[0-9]{2}-[0-9]{2}[T ][0-9]{2}:[0-9]{2}:[0-9]{2}[^ ]*/TIMESTAMP/g' | \
+  sed -E 's/[0-9a-f]{7,40}/HASH/g' | \
+  sed -E 's/line [0-9]+/line N/g' | \
+  sed -E 's/:[0-9]+:/:N:/g' | \
+  head -c 200)
+
+[ -z "$PATTERN" ] && { echo '{}'; exit 0; }
+
+# ─── Categorize ──────────────────────────────────────────────────────────
+CATEGORY="general"
+if echo "$ERROR_LINE" | grep -qiE '(artisan|eloquent|laravel|blade|migration|composer|php )'; then
+  CATEGORY="laravel"
+elif echo "$ERROR_LINE" | grep -qiE '(npm|node|vue|react|nuxt|next|vite|webpack|typescript|tsx|jsx)'; then
+  CATEGORY="frontend"
+elif echo "$ERROR_LINE" | grep -qiE '(git |merge|rebase|checkout|branch|commit|push|pull)'; then
+  CATEGORY="git"
+elif echo "$ERROR_LINE" | grep -qiE '(sql|postgres|mysql|database|migration|table|column|constraint)'; then
+  CATEGORY="database"
+elif echo "$ERROR_LINE" | grep -qiE '(permission|denied|EACCES|EPERM|chmod|chown|sudo)'; then
+  CATEGORY="permissions"
+elif echo "$ERROR_LINE" | grep -qiE '(test|assert|expect|jest|phpunit|bats|coverage)'; then
+  CATEGORY="testing"
+fi
+
+# ─── Match Fix Suggestion ────────────────────────────────────────────────
+SUGGESTION=""
+FIXES_FILE="${ARKA_OS:-$HOME/.claude/skills/arka}/config/gotchas-fixes.json"
+# Also check repo path
+if [ ! -f "$FIXES_FILE" ]; then
+  REPO_PATH=$(cat "${ARKA_OS:-$HOME/.claude/skills/arka}/.repo-path" 2>/dev/null || echo "")
+  [ -n "$REPO_PATH" ] && FIXES_FILE="$REPO_PATH/config/gotchas-fixes.json"
+fi
+if [ -f "$FIXES_FILE" ] && command -v jq &>/dev/null; then
+  SUGGESTION=$(jq -r --arg err "$ERROR_LINE" '
+    .fixes[] | select(.pattern_match as $p | $err | test($p; "i")) | .suggestion
+  ' "$FIXES_FILE" 2>/dev/null | head -1)
+fi
+
+# ─── Detect Active Project ───────────────────────────────────────────────
+PROJECT=""
+if [ -n "$CWD" ]; then
+  # Try to extract project name from CWD
+  REPO_PATH=$(cat "${ARKA_OS:-$HOME/.claude/skills/arka}/.repo-path" 2>/dev/null || echo "")
+  if [ -n "$REPO_PATH" ] && [ -d "$REPO_PATH/projects" ]; then
+    for proj_dir in "$REPO_PATH/projects"/*/; do
+      [ -f "$proj_dir/.project-path" ] || continue
+      PROJ_PATH=$(cat "$proj_dir/.project-path" 2>/dev/null)
+      if [ -n "$PROJ_PATH" ] && [[ "$CWD" == "$PROJ_PATH"* ]]; then
+        PROJECT=$(basename "$proj_dir")
+        break
+      fi
+    done
+  fi
+  # Fallback: use directory name
+  [ -z "$PROJECT" ] && PROJECT=$(basename "$CWD")
+fi
+
+# ─── Store in gotchas.json ────────────────────────────────────────────────
+GOTCHAS_FILE="$HOME/.arka-os/gotchas.json"
+mkdir -p "$HOME/.arka-os"
+
+# Use flock for concurrent safety (fallback if flock not available on macOS)
+LOCK_FILE="$HOME/.arka-os/gotchas.lock"
+if command -v flock &>/dev/null; then
+  LOCK_CMD="flock -w 3 200"
+else
+  LOCK_CMD="true"
+fi
+(
+  eval "$LOCK_CMD" || { echo '{}'; exit 0; }
+
+  NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+  # Initialize if missing or invalid
+  if [ ! -f "$GOTCHAS_FILE" ] || ! jq empty "$GOTCHAS_FILE" 2>/dev/null; then
+    echo '[]' > "$GOTCHAS_FILE"
+  fi
+
+  # Check if pattern already exists
+  EXISTING_IDX=$(jq -r --arg pat "$PATTERN" \
+    'to_entries[] | select(.value.pattern == $pat) | .key' \
+    "$GOTCHAS_FILE" 2>/dev/null | head -1)
+
+  if [ -n "$EXISTING_IDX" ] && [ "$EXISTING_IDX" -ge 0 ] 2>/dev/null; then
+    # Increment count, update last_seen, add project if new, add suggestion if missing
+    jq --argjson idx "$EXISTING_IDX" \
+       --arg now "$NOW" \
+       --arg proj "$PROJECT" \
+       --arg sug "$SUGGESTION" \
+       '.[$idx].count += 1 |
+        .[$idx].last_seen = $now |
+        (if $proj != "" and ($proj | IN(.[$idx].projects[]?) | not) then .[$idx].projects += [$proj] else . end) |
+        (if $sug != "" and ((.[$idx].suggestion // "") == "") then .[$idx].suggestion = $sug else . end)' \
+       "$GOTCHAS_FILE" > "$GOTCHAS_FILE.tmp" 2>/dev/null && mv "$GOTCHAS_FILE.tmp" "$GOTCHAS_FILE"
+  else
+    # Add new entry
+    jq --arg pat "$PATTERN" \
+       --arg full "$ERROR_LINE" \
+       --arg cat "$CATEGORY" \
+       --arg tool "$TOOL_NAME" \
+       --arg now "$NOW" \
+       --arg proj "$PROJECT" \
+       --arg sug "$SUGGESTION" \
+       '. += [{
+         "pattern": $pat,
+         "full_pattern": ($full | .[0:500]),
+         "category": $cat,
+         "tool": $tool,
+         "count": 1,
+         "first_seen": $now,
+         "last_seen": $now,
+         "projects": (if $proj != "" then [$proj] else [] end),
+         "suggestion": (if $sug != "" then $sug else null end)
+       }]' \
+       "$GOTCHAS_FILE" > "$GOTCHAS_FILE.tmp" 2>/dev/null && mv "$GOTCHAS_FILE.tmp" "$GOTCHAS_FILE"
+  fi
+
+  # Keep top 100 sorted by count
+  jq 'sort_by(-.count) | .[0:100]' "$GOTCHAS_FILE" > "$GOTCHAS_FILE.tmp" 2>/dev/null && \
+    mv "$GOTCHAS_FILE.tmp" "$GOTCHAS_FILE"
+
+) 200>"$LOCK_FILE"
+
+# ─── Log Metrics ─────────────────────────────────────────────────────────
+_DURATION_MS=$(_hook_ms)
+METRICS_FILE="$HOME/.arka-os/hook-metrics.json"
+METRICS_LOCK="$HOME/.arka-os/hook-metrics.lock"
+mkdir -p "$HOME/.arka-os"
+(
+  if command -v flock &>/dev/null; then flock -w 2 200; else true; fi
+  [ ! -f "$METRICS_FILE" ] && echo '[]' > "$METRICS_FILE"
+  NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+  jq --argjson dur "$_DURATION_MS" --arg ts "$NOW" --arg hook "post-tool-use" \
+    '. += [{"hook": $hook, "duration_ms": $dur, "timestamp": $ts}] | .[-500:]' \
+    "$METRICS_FILE" > "$METRICS_FILE.tmp" 2>/dev/null && mv "$METRICS_FILE.tmp" "$METRICS_FILE"
+) 200>"$METRICS_LOCK" 2>/dev/null
+
+# Silent output — no context injection needed from PostToolUse
+echo '{}'

package/config/hooks/pre-compact-v2.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ArkaOS v2 — PreCompact Hook (Session Digest Preservation)
+# Saves session context before compaction to prevent loss
+# Timeout: 30s
+# ============================================================================
+
+input=$(cat)
+
+ARKAOS_HOME="${HOME}/.arkaos"
+DIGEST_DIR="$ARKAOS_HOME/session-digests"
+
+mkdir -p "$DIGEST_DIR" 2>/dev/null
+
+# ─── Extract session data ────────────────────────────────────────────────
+timestamp=$(date +"%Y%m%d-%H%M%S")
+short_id=$(echo "$timestamp" | md5sum 2>/dev/null | head -c 8 || echo "$RANDOM")
+digest_file="$DIGEST_DIR/${timestamp}-${short_id}.md"
+
+# ─── Save digest ─────────────────────────────────────────────────────────
+{
+  echo "# Session Digest — $timestamp"
+  echo ""
+  echo "## Last Context (before compaction)"
+  echo ""
+
+  if command -v jq &>/dev/null; then
+    # Extract transcript lines
+    echo "$input" | jq -r '.transcript // ""' 2>/dev/null | tail -50
+    echo ""
+    echo "## Last Assistant Messages"
+    echo ""
+    echo "$input" | jq -r '.messages[]? | select(.role == "assistant") | .content' 2>/dev/null | tail -c 5000
+  else
+    echo "$input" | tail -100
+  fi
+} > "$digest_file" 2>/dev/null
+
+# ─── Cleanup: keep only last 50 digests ──────────────────────────────────
+digest_count=$(ls -1 "$DIGEST_DIR"/*.md 2>/dev/null | wc -l)
+if [ "$digest_count" -gt 50 ]; then
+  ls -1t "$DIGEST_DIR"/*.md | tail -n +51 | xargs rm -f 2>/dev/null
+fi

package/config/hooks/pre-compact.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ARKA OS — PreCompact Hook
+# Saves session digest before context compaction
+# Timeout: 30s | No LLM analysis — raw context preservation
+# ============================================================================
+
+input=$(cat)
+
+# ─── Performance Timing ──────────────────────────────────────────────────
+_HOOK_START=$(date +%s 2>/dev/null)
+_HOOK_START_NS=$(date +%s%N 2>/dev/null || echo "0")
+_hook_ms() {
+  local end_ns=$(date +%s%N 2>/dev/null || echo "0")
+  if [ "$_HOOK_START_NS" != "0" ] && [ "$end_ns" != "0" ] && [ ${#end_ns} -gt 10 ]; then
+    echo $(( (end_ns - _HOOK_START_NS) / 1000000 ))
+  else
+    echo $(( ($(date +%s) - _HOOK_START) * 1000 ))
+  fi
+}
+
+# Extract fields
+SESSION_ID=$(echo "$input" | jq -r '.session_id // "unknown"' 2>/dev/null)
+TRANSCRIPT=$(echo "$input" | jq -r '.transcript // ""' 2>/dev/null)
+
+# ─── Setup ────────────────────────────────────────────────────────────────
+DIGEST_DIR="$HOME/.arka-os/session-digests"
+mkdir -p "$DIGEST_DIR"
+
+TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+SHORT_ID=$(echo "$SESSION_ID" | head -c 8)
+DIGEST_FILE="${DIGEST_DIR}/${TIMESTAMP}-${SHORT_ID}.md"
+
+# ─── Extract Context ──────────────────────────────────────────────────────
+# Get last 50 lines of transcript
+if [ -n "$TRANSCRIPT" ]; then
+  TAIL_LINES=$(echo "$TRANSCRIPT" | tail -50)
+else
+  TAIL_LINES="(no transcript available)"
+fi
+
+# Extract last 5 assistant messages from JSON if available
+ASSISTANT_MSGS=""
+if echo "$input" | jq -e '.messages' &>/dev/null; then
+  ASSISTANT_MSGS=$(echo "$input" | jq -r '
+    [.messages[] | select(.role == "assistant") | .content] | last(5) | .[] // empty
+  ' 2>/dev/null)
+fi
+
+# ─── Write Digest ─────────────────────────────────────────────────────────
+cat > "$DIGEST_FILE" << DIGEST_EOF
+---
+type: session-digest
+session_id: ${SESSION_ID}
+timestamp: ${TIMESTAMP}
+trigger: pre-compact
+---
+
+# Session Digest — ${TIMESTAMP}
+
+**Session:** \`${SESSION_ID}\`
+**Saved at:** $(date '+%Y-%m-%d %H:%M:%S')
+**Trigger:** Context compaction
+
+## Last Assistant Messages
+
+${ASSISTANT_MSGS:-_(none captured)_}
+
+## Transcript Tail (last 50 lines)
+
+\`\`\`
+${TAIL_LINES}
+\`\`\`
+DIGEST_EOF
+
+# ─── Auto-Cleanup: Keep Only Last 50 Digests ─────────────────────────────
+DIGEST_COUNT=$(ls -1 "$DIGEST_DIR"/*.md 2>/dev/null | wc -l | tr -d ' ')
+if [ "$DIGEST_COUNT" -gt 50 ]; then
+  REMOVE_COUNT=$((DIGEST_COUNT - 50))
+  ls -1t "$DIGEST_DIR"/*.md | tail -"$REMOVE_COUNT" | xargs rm -f 2>/dev/null
+fi
+
+# ─── Log Metrics ─────────────────────────────────────────────────────────
+_DURATION_MS=$(_hook_ms)
+METRICS_FILE="$HOME/.arka-os/hook-metrics.json"
+METRICS_LOCK="$HOME/.arka-os/hook-metrics.lock"
+mkdir -p "$HOME/.arka-os"
+(
+  if command -v flock &>/dev/null; then flock -w 2 200; else true; fi
+  [ ! -f "$METRICS_FILE" ] && echo '[]' > "$METRICS_FILE"
+  NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+  jq --argjson dur "$_DURATION_MS" --arg ts "$NOW" --arg hook "pre-compact" \
+    '. += [{"hook": $hook, "duration_ms": $dur, "timestamp": $ts}] | .[-500:]' \
+    "$METRICS_FILE" > "$METRICS_FILE.tmp" 2>/dev/null && mv "$METRICS_FILE.tmp" "$METRICS_FILE"
+) 200>"$METRICS_LOCK" 2>/dev/null
+
+# ─── Output ───────────────────────────────────────────────────────────────
+# Silent — no output needed for PreCompact hook
+echo '{}'

package/config/hooks/user-prompt-submit-v2.sh

@@ -0,0 +1,119 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ArkaOS v2 — UserPromptSubmit Hook (Synapse v2 Bridge)
+# Calls Python Synapse engine for 8-layer context injection
+# Timeout: 10s | Output: JSON to stdout | Target: <100ms
+# ============================================================================
+
+input=$(cat)
+
+# ─── Performance Timing ──────────────────────────────────────────────────
+_HOOK_START_NS=$(date +%s%N 2>/dev/null || echo "0")
+_hook_ms() {
+  local end_ns=$(date +%s%N 2>/dev/null || echo "0")
+  if [ "$_HOOK_START_NS" != "0" ] && [ "$end_ns" != "0" ] && [ ${#end_ns} -gt 10 ]; then
+    echo $(( (end_ns - _HOOK_START_NS) / 1000000 ))
+  else
+    echo "0"
+  fi
+}
+
+# ─── Paths ───────────────────────────────────────────────────────────────
+ARKAOS_ROOT="${ARKA_OS:-$HOME/.claude/skills/arkaos}"
+CACHE_DIR="/tmp/arkaos-context-cache"
+CACHE_TTL=300  # Constitution cache: 5 minutes
+
+mkdir -p "$CACHE_DIR" 2>/dev/null
+
+# ─── Extract user input from hook JSON ───────────────────────────────────
+user_input=""
+if command -v jq &>/dev/null; then
+  user_input=$(echo "$input" | jq -r '.userInput // .message // ""' 2>/dev/null)
+fi
+# Fallback: try to get the raw text
+if [ -z "$user_input" ]; then
+  user_input=$(echo "$input" | head -c 2000)
+fi
+
+# ─── Try Python Synapse engine first ─────────────────────────────────────
+python_result=""
+if command -v python3 &>/dev/null; then
+  python_result=$(python3 -c "
+import sys, os
+sys.path.insert(0, '${ARKAOS_ROOT}')
+try:
+    from core.synapse.engine import create_default_engine
+    from core.synapse.layers import PromptContext
+    from core.governance.constitution import load_constitution
+    import subprocess
+
+    # Load constitution for L0
+    const_path = '${ARKAOS_ROOT}/config/constitution.yaml'
+    compressed = ''
+    if os.path.exists(const_path):
+        c = load_constitution(const_path)
+        compressed = c.compress_for_context()
+
+    # Detect git branch
+    branch = ''
+    try:
+        branch = subprocess.run(['git', 'rev-parse', '--abbrev-ref', 'HEAD'],
+                                capture_output=True, text=True, timeout=2).stdout.strip()
+    except Exception:
+        pass
+
+    # Create engine and inject
+    engine = create_default_engine(constitution_compressed=compressed)
+    ctx = PromptContext(
+        user_input='''${user_input}''',
+        cwd=os.getcwd(),
+        git_branch=branch,
+    )
+    result = engine.inject(ctx)
+    print(result.context_string)
+except Exception as e:
+    print(f'[arkaos:error] {e}', file=sys.stderr)
+    print('')
+" 2>/dev/null)
+fi
+
+# ─── Fallback: Bash-only context (if Python unavailable) ────────────────
+if [ -z "$python_result" ]; then
+  # L0: Constitution (cached)
+  L0=""
+  L0_CACHE="$CACHE_DIR/l0-constitution"
+  if [ -f "$L0_CACHE" ] && [ $(($(date +%s) - $(stat -f%m "$L0_CACHE" 2>/dev/null || stat -c%Y "$L0_CACHE" 2>/dev/null || echo 0))) -lt $CACHE_TTL ]; then
+    L0=$(cat "$L0_CACHE")
+  else
+    L0="[Constitution] NON-NEGOTIABLE: branch-isolation, obsidian-output, authority-boundaries, security-gate, context-first, solid-clean-code, spec-driven, human-writing, squad-routing, full-visibility, sequential-validation, mandatory-qa, arka-supremacy | QUALITY-GATE: marta-cqo, eduardo-copy, francisca-tech-ux | MUST: conventional-commits, test-coverage, pattern-matching, actionable-output, memory-persistence"
+    echo "$L0" > "$L0_CACHE" 2>/dev/null
+  fi
+
+  # L4: Git branch
+  L4=""
+  branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
+  if [ -n "$branch" ] && [ "$branch" != "main" ] && [ "$branch" != "master" ] && [ "$branch" != "dev" ]; then
+    L4="[branch:$branch]"
+  fi
+
+  # L7: Time
+  hour=$(date +%H)
+  if [ "$hour" -ge 5 ] && [ "$hour" -lt 12 ]; then
+    L7="[time:morning]"
+  elif [ "$hour" -ge 12 ] && [ "$hour" -lt 18 ]; then
+    L7="[time:afternoon]"
+  else
+    L7="[time:evening]"
+  fi
+
+  python_result="$L0 $L4 $L7"
+fi
+
+# ─── Output ──────────────────────────────────────────────────────────────
+echo "{\"additionalContext\": \"$python_result\"}"
+
+# ─── Metrics ─────────────────────────────────────────────────────────────
+elapsed=$(_hook_ms)
+if [ "$elapsed" -gt 0 ] 2>/dev/null; then
+  echo "{\"hook\":\"user-prompt-submit-v2\",\"ms\":$elapsed}" >> "$CACHE_DIR/hook-metrics.jsonl" 2>/dev/null
+fi