arkaos 2.6.0 → 2.8.0

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

@@ -1,312 +1,140 @@
 #!/usr/bin/env bash
 # ============================================================================
-# ARKA OS — UserPromptSubmit Hook (5-Layer Context Injection)
-# Injects contextual rules per prompt with caching for performance
-# Timeout: 10s | Output: JSON to stdout | Target: <200ms
+# 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=$(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
-}
+# ─── V1 Migration Detection ─────────────────────────────────────────────
+V1_PATHS=("$HOME/.claude/skills/arka-os" "$HOME/.claude/skills/arkaos")
+MIGRATION_MARKER="$HOME/.arkaos/migrated-from-v1"
 
-# Extract fields
-PROMPT=$(echo "$input" | jq -r '.prompt // ""' 2>/dev/null)
-CWD=$(echo "$input" | jq -r '.cwd // ""' 2>/dev/null)
-SESSION_ID=$(echo "$input" | jq -r '.session_id // ""' 2>/dev/null)
+for v1_path in "${V1_PATHS[@]}"; do
+  if [ -d "$v1_path" ] && [ ! -f "$MIGRATION_MARKER" ]; then
+    echo "{\"additionalContext\": \"[MIGRATION] ArkaOS v1 detected at $v1_path. Run: npx arkaos migrate — This will backup v1, preserve your data, and install v2. See: https://github.com/andreagroferreira/arka-os#install\"}"
+    exit 0
+  fi
+done
+
+# ─── Sync Version Detection ────────────────────────────────────────────
+SYNC_STATE="$HOME/.arkaos/sync-state.json"
+ARKAOS_VERSION_FILE="$HOME/.arkaos/.repo-path"
+
+if [ -f "$ARKAOS_VERSION_FILE" ]; then
+  _REPO_PATH=$(cat "$ARKAOS_VERSION_FILE")
+  if [ -f "$_REPO_PATH/VERSION" ]; then
+    _CURRENT_VERSION=$(cat "$_REPO_PATH/VERSION")
+  elif [ -f "$_REPO_PATH/package.json" ]; then
+    _CURRENT_VERSION=$(python3 -c "import json; print(json.load(open('$_REPO_PATH/package.json'))['version'])" 2>/dev/null || echo "")
+  fi
 
-CONTEXT_PARTS=()
-ARKA_OS="${ARKA_OS:-$HOME/.claude/skills/arka}"
-CACHE_DIR="/tmp/arka-context-cache"
-mkdir -p "$CACHE_DIR"
+  if [ -n "${_CURRENT_VERSION:-}" ]; then
+    if [ -f "$SYNC_STATE" ]; then
+      _SYNCED_VERSION=$(python3 -c "import json; print(json.load(open('$SYNC_STATE'))['version'])" 2>/dev/null || echo "none")
+    else
+      _SYNCED_VERSION="none"
+    fi
 
-# ─── Cache Helper ─────────────────────────────────────────────────────────
-# cache_get <key> <ttl_seconds> — returns cached value or empty
-cache_get() {
-  local file="$CACHE_DIR/$1"
-  local ttl="$2"
-  if [ -f "$file" ]; then
-    local age=$(( $(date +%s) - $(stat -f%m "$file" 2>/dev/null || stat -c%Y "$file" 2>/dev/null || echo 0) ))
-    if [ "$age" -lt "$ttl" ]; then
-      cat "$file"
-      return 0
+    if [ "$_CURRENT_VERSION" != "$_SYNCED_VERSION" ]; then
+      _SYNC_NOTICE="[arka:update-available] ArkaOS v${_CURRENT_VERSION} installed (synced: ${_SYNCED_VERSION}). Run /arka update to sync all projects. "
     fi
   fi
-  return 1
-}
+fi
 
-cache_set() {
-  echo "$2" > "$CACHE_DIR/$1"
-}
+# ─── Session Greeting (now handled by SessionStart hook via systemMessage) ──
+_ARKA_GREETING=""
 
-# ─── L0: Constitution (compressed, 300s cache) ───────────────────────────
-L0=$(cache_get "constitution" 300) || {
-  REPO_PATH=$(cat "$ARKA_OS/.repo-path" 2>/dev/null || echo "")
-  CONSTITUTION_FILE=""
-  [ -f "$REPO_PATH/CONSTITUTION.md" ] && CONSTITUTION_FILE="$REPO_PATH/CONSTITUTION.md"
-  if [ -n "$CONSTITUTION_FILE" ]; then
-    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"
-    cache_set "constitution" "$L0"
+# ─── 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
-    L0=""
+    echo "0"
   fi
 }
-[ -n "$L0" ] && CONTEXT_PARTS+=("$L0")
-_L0_MS=$(_hook_ms)
-
-# ─── L1: Department Routing (no cache — fast string match) ───────────────
-PROMPT_LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
-DETECTED_DEPT=""
 
-if echo "$PROMPT_LOWER" | grep -qE '\b(build|code|feature|deploy|test|review|scaffold|debug|refactor|api|migration|stack)\b'; then
-  DETECTED_DEPT="dev"
-elif echo "$PROMPT_LOWER" | grep -qE '\b(budget|invoice|revenue|forecast|profit|loss|roi|margin|cash.?flow|financial|invest)\b'; then
-  DETECTED_DEPT="finance"
-elif echo "$PROMPT_LOWER" | grep -qE '\b(social|content|campaign|post|instagram|linkedin|twitter|tiktok|seo|marketing|ads|email.?campaign)\b'; then
-  DETECTED_DEPT="marketing"
-elif echo "$PROMPT_LOWER" | grep -qE '\b(store|product|shop|shopify|ecommerce|catalog|inventory|cart|checkout|pricing)\b'; then
-  DETECTED_DEPT="ecommerce"
-elif echo "$PROMPT_LOWER" | grep -qE '\b(strategy|brainstorm|market|swot|competitor|roadmap|pivot|growth)\b'; then
-  DETECTED_DEPT="strategy"
-elif echo "$PROMPT_LOWER" | grep -qE '\b(task|email|calendar|automate|meeting|workflow|process|schedule|slack|discord|notify)\b'; then
-  DETECTED_DEPT="operations"
-elif echo "$PROMPT_LOWER" | grep -qE '\b(learn|persona|knowledge|youtube|transcribe|article|research)\b'; then
-  DETECTED_DEPT="knowledge"
-elif echo "$PROMPT_LOWER" | grep -qE '\b(brand|logo|colors|palette|mockup|photoshoot|brand.?identity|brand.?guide|mood.?board|naming|positioning|visual.?design|motion.?design|brand.?video|social.?kit)\b'; then
-  DETECTED_DEPT="brand"
-fi
-[ -n "$DETECTED_DEPT" ] && CONTEXT_PARTS+=("[dept:$DETECTED_DEPT]")
-_L1_MS=$(( $(_hook_ms) - ${_L0_MS:-0} ))
-
-# ─── L2: Agent Memory (30s cache) ────────────────────────────────────────
-# Detect agent name from prompt
-DETECTED_AGENT=""
-if echo "$PROMPT_LOWER" | grep -qE '\bmarco\b|/.*cto\b'; then
-  DETECTED_AGENT="cto"
-elif echo "$PROMPT_LOWER" | grep -qE '\bpaulo\b|tech.?lead'; then
-  DETECTED_AGENT="tech-lead"
-elif echo "$PROMPT_LOWER" | grep -qE '\bgabriel\b|architect'; then
-  DETECTED_AGENT="architect"
-elif echo "$PROMPT_LOWER" | grep -qE '\bandre\b|senior.?dev|backend'; then
-  DETECTED_AGENT="senior-dev"
-elif echo "$PROMPT_LOWER" | grep -qE '\bdiana\b|frontend.?dev'; then
-  DETECTED_AGENT="frontend-dev"
-elif echo "$PROMPT_LOWER" | grep -qE '\bbruno\b|security'; then
-  DETECTED_AGENT="security"
-elif echo "$PROMPT_LOWER" | grep -qE '\bcarlos\b|devops'; then
-  DETECTED_AGENT="devops"
-elif echo "$PROMPT_LOWER" | grep -qE '\brita\b|\bqa\b'; then
-  DETECTED_AGENT="qa"
-elif echo "$PROMPT_LOWER" | grep -qE '\blucas\b|analyst'; then
-  DETECTED_AGENT="analyst"
-elif echo "$PROMPT_LOWER" | grep -qE '\bhelena\b|cfo'; then
-  DETECTED_AGENT="cfo"
-elif echo "$PROMPT_LOWER" | grep -qE '\bsofia\b|coo'; then
-  DETECTED_AGENT="coo"
-elif echo "$PROMPT_LOWER" | grep -qE '\bluna\b|content.?creator'; then
-  DETECTED_AGENT="content-creator"
-elif echo "$PROMPT_LOWER" | grep -qE '\bricardo\b|ecommerce.?manager'; then
-  DETECTED_AGENT="ecommerce-manager"
-elif echo "$PROMPT_LOWER" | grep -qE '\btomas\b|strategist'; then
-  DETECTED_AGENT="strategist"
-elif echo "$PROMPT_LOWER" | grep -qE '\bclara\b|knowledge.?curator'; then
-  DETECTED_AGENT="knowledge-curator"
-elif echo "$PROMPT_LOWER" | grep -qE '\bvalentina\b|creative.?director'; then
-  DETECTED_AGENT="creative-director"
-elif echo "$PROMPT_LOWER" | grep -qE '\bmateus\b|brand.?strategist'; then
-  DETECTED_AGENT="brand-strategist"
-elif echo "$PROMPT_LOWER" | grep -qE '\bisabel\b|visual.?designer'; then
-  DETECTED_AGENT="visual-designer"
-elif echo "$PROMPT_LOWER" | grep -qE '\brafael\b|motion.?designer'; then
-  DETECTED_AGENT="motion-designer"
+# ─── Paths ───────────────────────────────────────────────────────────────
+# Resolve ARKAOS_ROOT: env var → .repo-path → npm package → fallback
+if [ -n "${ARKAOS_ROOT:-}" ]; then
+  : # already set
+elif [ -f "$HOME/.arkaos/.repo-path" ]; then
+  ARKAOS_ROOT=$(cat "$HOME/.arkaos/.repo-path")
+elif [ -d "$HOME/.arkaos" ]; then
+  ARKAOS_ROOT="$HOME/.arkaos"
+else
+  ARKAOS_ROOT="/Users/andreagroferreira/.npm/_npx/67d92defd11b9985/node_modules/arkaos"
 fi
+export ARKAOS_ROOT
 
-if [ -n "$DETECTED_AGENT" ]; then
-  AGENT_CACHE_KEY="agent-${DETECTED_AGENT}"
-  AGENT_CTX=$(cache_get "$AGENT_CACHE_KEY" 30) || {
-    AGENT_MEM="$HOME/.claude/agent-memory/arka-${DETECTED_AGENT}/MEMORY.md"
-    AGENT_CTX="[agent:$DETECTED_AGENT"
+CACHE_DIR="/tmp/arkaos-context-cache"
+CACHE_TTL=300  # Constitution cache: 5 minutes
 
-    # Inject DISC profile from agents-registry.json (fast jq lookup)
-    REPO_PATH=$(cat "$ARKA_OS/.repo-path" 2>/dev/null || echo "")
-    REGISTRY_FILE="$REPO_PATH/knowledge/agents-registry.json"
-    if [ -f "$REGISTRY_FILE" ] && command -v jq &>/dev/null; then
-      DISC_COMBO=$(jq -r --arg id "$DETECTED_AGENT" '.agents[] | select(.id == $id) | .disc.combination // ""' "$REGISTRY_FILE" 2>/dev/null)
-      [ -n "$DISC_COMBO" ] && AGENT_CTX+=" disc:$DISC_COMBO"
-    fi
-
-    if [ -f "$AGENT_MEM" ]; then
-      # Extract last 3 gotchas from agent memory
-      GOTCHAS=$(sed -n '/^## Gotchas/,/^## /{ /^## Gotchas/d; /^## /d; /^$/d; p; }' "$AGENT_MEM" 2>/dev/null | head -3)
-      if [ -n "$GOTCHAS" ]; then
-        AGENT_CTX+=" gotchas: $(echo "$GOTCHAS" | tr '\n' '; ' | head -c 200)"
-      fi
-    fi
+mkdir -p "$CACHE_DIR" 2>/dev/null
 
-    AGENT_CTX+="]"
-    cache_set "$AGENT_CACHE_KEY" "$AGENT_CTX"
-  }
-  CONTEXT_PARTS+=("$AGENT_CTX")
+# ─── 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
-_L2_MS=$(( $(_hook_ms) - ${_L0_MS:-0} - ${_L1_MS:-0} ))
 
-# ─── L3: Active Project (30s cache) ──────────────────────────────────────
-if [ -n "$CWD" ]; then
-  PROJECT_CACHE_KEY="project-$(echo "$CWD" | md5 2>/dev/null || echo "$CWD" | md5sum 2>/dev/null | cut -d' ' -f1 || echo "nocache")"
-  PROJECT_CTX=$(cache_get "$PROJECT_CACHE_KEY" 30) || {
-    PROJECT_CTX=""
-    # Check ARKA OS projects/ directory
-    REPO_PATH=$(cat "$ARKA_OS/.repo-path" 2>/dev/null || echo "")
-    if [ -n "$REPO_PATH" ] && [ -d "$REPO_PATH/projects" ]; then
-      for proj_md in "$REPO_PATH/projects"/*/PROJECT.md; do
-        [ -f "$proj_md" ] || continue
-        PROJ_DIR=$(dirname "$proj_md")
-        if [ -f "$PROJ_DIR/.project-path" ]; then
-          PROJ_PATH=$(cat "$PROJ_DIR/.project-path" 2>/dev/null)
-          if [ -n "$PROJ_PATH" ] && [[ "$CWD" == "$PROJ_PATH"* ]]; then
-            PROJ_NAME=$(basename "$PROJ_DIR")
-            # Try to extract stack from PROJECT.md
-            PROJ_STACK=$(grep -i 'stack\|framework' "$proj_md" 2>/dev/null | head -1 | sed 's/.*: *//' | head -c 50)
-            PROJECT_CTX="[project:$PROJ_NAME"
-            [ -n "$PROJ_STACK" ] && PROJECT_CTX+=" stack:$PROJ_STACK"
-            PROJECT_CTX+="]"
-            break
-          fi
-        fi
-      done
-    fi
+# ─── Try Python Synapse bridge first ────────────────────────────────────
+python_result=""
+BRIDGE_SCRIPT="${ARKAOS_ROOT}/scripts/synapse-bridge.py"
 
-    # Also check installed skills for project paths
-    if [ -z "$PROJECT_CTX" ]; then
-      for proj_dir in "$HOME/.claude/skills"/arka-*/; do
-        [ -d "$proj_dir" ] || continue
-        if [ -f "$proj_dir/.project-path" ]; then
-          PROJ_PATH=$(cat "$proj_dir/.project-path" 2>/dev/null)
-          if [ -n "$PROJ_PATH" ] && [[ "$CWD" == "$PROJ_PATH"* ]]; then
-            PROJ_NAME=$(basename "$proj_dir" | sed 's/^arka-//')
-            PROJECT_CTX="[project:$PROJ_NAME]"
-            break
-          fi
-        fi
-      done
-    fi
+if command -v python3 &>/dev/null && [ -f "$BRIDGE_SCRIPT" ]; then
+  bridge_output=$(echo "{\"user_input\":$(echo "$user_input" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))" 2>/dev/null || echo '""')}" \
+    | ARKAOS_ROOT="$ARKAOS_ROOT" python3 "$BRIDGE_SCRIPT" --root "$ARKAOS_ROOT" 2>/dev/null)
 
-    cache_set "$PROJECT_CACHE_KEY" "$PROJECT_CTX"
-  }
-  [ -n "$PROJECT_CTX" ] && CONTEXT_PARTS+=("$PROJECT_CTX")
+  if [ -n "$bridge_output" ]; then
+    python_result=$(echo "$bridge_output" | python3 -c "import sys,json; print(json.loads(sys.stdin.read()).get('context_string',''))" 2>/dev/null)
+  fi
 fi
-_L3_MS=$(( $(_hook_ms) - ${_L0_MS:-0} - ${_L1_MS:-0} - ${_L2_MS:-0} ))
 
-# ─── L4: Git Branch Detection (no cache — fast check) ────────────────────
-if [ -n "$CWD" ]; then
-  CURRENT_BRANCH=$(git -C "$CWD" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
-  if [ -n "$CURRENT_BRANCH" ] && [ "$CURRENT_BRANCH" != "main" ] && [ "$CURRENT_BRANCH" != "master" ] && [ "$CURRENT_BRANCH" != "dev" ]; then
-    CONTEXT_PARTS+=("[branch:$CURRENT_BRANCH]")
+# ─── 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
-fi
-_L4_MS=$(( $(_hook_ms) - ${_L0_MS:-0} - ${_L1_MS:-0} - ${_L2_MS:-0} - ${_L3_MS:-0} ))
 
-# ─── Gotchas Injection (30s cache) ───────────────────────────────────────
-if [ -n "$DETECTED_DEPT" ]; then
-  GOTCHA_CACHE_KEY="gotchas-${DETECTED_DEPT}"
-  GOTCHA_CTX=$(cache_get "$GOTCHA_CACHE_KEY" 30) || {
-    GOTCHA_CTX=""
-    GOTCHAS_FILE="$HOME/.arka-os/gotchas.json"
-    if [ -f "$GOTCHAS_FILE" ] && command -v jq &>/dev/null; then
-      # Get top 2 recurring errors for this department with count >= 3 (include suggestions)
-      TOP_GOTCHAS=$(jq -r --arg cat "$DETECTED_DEPT" \
-        '[.[] | select(.category == $cat and .count >= 3)] | sort_by(-.count) | .[0:2] | .[] |
-         if .suggestion then "\(.pattern) (x\(.count)) \u2192 \(.suggestion)" else "\(.pattern) (x\(.count))" end' \
-        "$GOTCHAS_FILE" 2>/dev/null)
-      if [ -n "$TOP_GOTCHAS" ]; then
-        GOTCHA_CTX="[gotchas:$DETECTED_DEPT $(echo "$TOP_GOTCHAS" | tr '\n' '; ' | head -c 300)]"
-      fi
-    fi
-    cache_set "$GOTCHA_CACHE_KEY" "$GOTCHA_CTX"
-  }
-  [ -n "$GOTCHA_CTX" ] && CONTEXT_PARTS+=("$GOTCHA_CTX")
-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
 
-# ─── L5: Command Hint (30s cache) ────────────────────────────────────────
-# Fast keyword lookup against commands-registry for non-explicit prompts
-if [ -n "$PROMPT" ] && ! echo "$PROMPT" | grep -qE '^/(dev|mkt|ecom|fin|ops|strat|kb|arka|do) '; then
-  CMD_CACHE_KEY="cmdhint-$(echo "$PROMPT_LOWER" | md5 2>/dev/null || echo "$PROMPT_LOWER" | md5sum 2>/dev/null | cut -d' ' -f1)"
-  CMD_HINT=$(cache_get "$CMD_CACHE_KEY" 30) || {
-    CMD_HINT=""
-    REPO_PATH=$(cat "$ARKA_OS/.repo-path" 2>/dev/null || echo "")
-    REGISTRY="$REPO_PATH/knowledge/commands-registry.json"
-    if [ -f "$REGISTRY" ] && command -v jq &>/dev/null; then
-      # Extract words from prompt and match against registry keywords
-      CMD_HINT=$(jq -r --arg prompt "$PROMPT_LOWER" '
-        ($prompt | split(" ") | map(select(length > 2))) as $words |
-        [.commands[] |
-          {id, command, department,
-           score: ([.keywords[] | . as $kw |
-             if ($words | any(. == $kw)) then 2
-             elif ($words | join(" ") | test($kw)) then 3
-             else 0 end
-           ] | add // 0)}
-        ] | sort_by(-.score) | [.[:2][] | select(.score > 0)] |
-        if length > 0 then
-          map("[hint:\(.command)]") | join(" ")
-        else "" end
-      ' "$REGISTRY" 2>/dev/null)
-    fi
-    cache_set "$CMD_CACHE_KEY" "$CMD_HINT"
-  }
-  [ -n "$CMD_HINT" ] && CONTEXT_PARTS+=("$CMD_HINT")
-fi
-_L5_MS=$(( $(_hook_ms) - ${_L0_MS:-0} - ${_L1_MS:-0} - ${_L2_MS:-0} - ${_L3_MS:-0} - ${_L4_MS:-0} ))
+  # 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
 
-# ─── Time of Day (no cache) ──────────────────────────────────────────────
-HOUR=$(date +%H)
-if [ "$HOUR" -lt 12 ]; then
-  CONTEXT_PARTS+=("[time:morning]")
-elif [ "$HOUR" -lt 18 ]; then
-  CONTEXT_PARTS+=("[time:afternoon]")
-else
-  CONTEXT_PARTS+=("[time:evening]")
+  python_result="$L0 $L4 $L7"
 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 "user-prompt-submit" \
-    --argjson l0 "${_L0_MS:-0}" --argjson l1 "${_L1_MS:-0}" --argjson l2 "${_L2_MS:-0}" \
-    --argjson l3 "${_L3_MS:-0}" --argjson l4 "${_L4_MS:-0}" --argjson l5 "${_L5_MS:-0}" \
-    '. += [{"hook": $hook, "duration_ms": $dur, "timestamp": $ts, "layers": {"L0": $l0, "L1": $l1, "L2": $l2, "L3": $l3, "L4": $l4, "L5": $l5}}] | .[-500:]' \
-    "$METRICS_FILE" > "$METRICS_FILE.tmp" 2>/dev/null && mv "$METRICS_FILE.tmp" "$METRICS_FILE"
-) 200>"$METRICS_LOCK" 2>/dev/null
+# ─── Output ──────────────────────────────────────────────────────────────
+echo "{\"additionalContext\": \"${_ARKA_GREETING:-}${_SYNC_NOTICE:-}$python_result\"}"
 
-# ─── Output ───────────────────────────────────────────────────────────────
-if [ ${#CONTEXT_PARTS[@]} -gt 0 ]; then
-  CONTEXT=""
-  for part in "${CONTEXT_PARTS[@]}"; do
-    CONTEXT+="$part "
-  done
-  CONTEXT="${CONTEXT% }"
-
-  jq -n --arg ctx "$CONTEXT" '{
-    "hookSpecificOutput": {
-      "hookEventName": "UserPromptSubmit",
-      "additionalContext": $ctx
-    }
-  }'
-else
-  echo '{}'
+# ─── 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

package/config/settings-template.json

@@ -5,6 +5,17 @@
     "padding": 2
   },
   "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{HOOKS_DIR}}/session-start.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "UserPromptSubmit": [
       {
         "hooks": [
@@ -37,6 +48,17 @@
           }
         ]
       }
+    ],
+    "CwdChanged": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{HOOKS_DIR}}/cwd-changed.sh",
+            "timeout": 5
+          }
+        ]
+      }
     ]
   }
 }

package/config/standards/ecosystem-workflow.md

@@ -0,0 +1,60 @@
+# ArkaOS -- Standard Ecosystem Workflow
+
+> All ecosystem skills MUST follow this workflow. No exceptions.
+> This is referenced by all ecosystem SKILL.md files.
+
+## Phase 1: Context Loading
+
+- Read ecosystem registry (`~/.claude/skills/arka/knowledge/ecosystems.json`)
+- Read project descriptor(s) for affected project(s)
+- Read project CLAUDE.md if it exists
+- Check git status and current branch
+- Load relevant memory from claude-mem
+
+## Phase 2: Context Verification (NON-NEGOTIABLE)
+
+- Restate the request to confirm understanding
+- Ask at least 1 clarifying question about scope or intent
+- Challenge at least 1 assumption (devil's advocate)
+- Search memory/knowledge base for prior related work
+- Only proceed after user confirms understanding
+
+## Phase 3: Analysis & Planning
+
+- Identify affected projects within the ecosystem
+- Determine which squad roles are needed
+- Assess complexity (simple/medium/complex)
+- Create execution plan with specific steps
+
+## Phase 4: Plan Presentation & Approval
+
+- Present the plan to the user with:
+  - Affected files/projects
+  - Squad roles assigned
+  - Estimated scope (small/medium/large)
+  - Risks or concerns
+- Wait for explicit user approval
+- Options: Approve / Modify / Cancel
+
+## Phase 5: Execution
+
+- Create feature branch (NON-NEGOTIABLE for code changes)
+- Use worktree isolation for multi-file changes
+- Squad agents execute in their domain
+- Follow TDD where applicable
+- Commit frequently with conventional commit messages
+
+## Phase 6: Quality Gate (NON-NEGOTIABLE)
+
+- **Marta** (CQO) orchestrates the review
+- **Eduardo** (Copy Director) reviews all text output
+- **Francisca** (Tech/UX Director) reviews all code and technical output
+- Verdict: APPROVED or REJECTED
+- REJECTED -> return to Phase 5 with specific feedback
+- APPROVED -> proceed to Phase 7
+
+## Phase 7: Documentation & Report
+
+- Update Obsidian vault with deliverables
+- Present final report to user
+- Include: what was done, files changed, tests run, next steps

package/config/user-claude.md

@@ -0,0 +1,15 @@
+# ArkaOS — User Instructions
+
+## Version Drift Warning
+
+When your context contains `[arka:update-available]`, show this warning before your response:
+
+> ArkaOS update available. Run `/arka update` to sync all projects.
+
+## Squad Routing
+
+You are operating within ArkaOS. Every request routes through the appropriate department squad. Never respond as a generic assistant.
+
+## Language
+
+Match the user's language. When writing in Portuguese, use European Portuguese (pt-PT).

package/installer/adapters/claude-code.js

@@ -28,6 +28,19 @@ export default {
       settings.hooks = {};
     }
 
+    // SessionStart — Branded greeting + version drift detection
+    settings.hooks.SessionStart = [
+      {
+        hooks: [
+          {
+            type: "command",
+            command: join(hooksDir, "session-start.sh"),
+            timeout: 5,
+          },
+        ],
+      },
+    ];
+
     // UserPromptSubmit — Synapse v2 context injection
     settings.hooks.UserPromptSubmit = [
       {
@@ -67,6 +80,19 @@ export default {
       },
     ];
 
+    // CwdChanged — Project/ecosystem auto-detection
+    settings.hooks.CwdChanged = [
+      {
+        hooks: [
+          {
+            type: "command",
+            command: join(hooksDir, "cwd-changed.sh"),
+            timeout: 5,
+          },
+        ],
+      },
+    ];
+
     writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
     console.log("         Claude Code hooks configured.");
   },