arkaos 2.7.0 → 2.8.0

package/VERSION

@@ -1 +1 @@
-2.7.0
+2.8.0

package/config/hooks/cwd-changed.sh

@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ArkaOS — CwdChanged Hook
+# Fires when the working directory changes. Detects ecosystem and injects
+# project context so Claude knows which squad and stack to use.
+# ============================================================================
+
+input=$(cat)
+NEW_CWD=$(echo "$input" | jq -r '.cwd // ""' 2>/dev/null)
+
+if [ -z "$NEW_CWD" ] || [ ! -d "$NEW_CWD" ]; then
+  exit 0
+fi
+
+# ─── Detect ecosystem from ecosystems.json ─────────────────────────────
+ECOSYSTEMS_FILE="$HOME/.claude/skills/arka/knowledge/ecosystems.json"
+ECOSYSTEM=""
+ECOSYSTEM_NAME=""
+
+if [ -f "$ECOSYSTEMS_FILE" ] && command -v python3 &>/dev/null; then
+  eval "$(python3 -c "
+import json, os, sys
+
+cwd = '$NEW_CWD'
+eco_file = os.path.expanduser('$ECOSYSTEMS_FILE')
+
+try:
+    data = json.load(open(eco_file))
+    ecosystems = data.get('ecosystems', {})
+
+    for eco_id, eco in ecosystems.items():
+        projects = eco.get('projects', [])
+        for proj in projects:
+            # Check if cwd contains the project name
+            if proj in cwd:
+                print(f'ECOSYSTEM=\"{eco_id}\"')
+                print(f'ECOSYSTEM_NAME=\"{eco.get(\"name\", eco_id)}\"')
+                sys.exit(0)
+
+    # No match by project name, try by path patterns
+    if '/herd/' in cwd or '/Herd/' in cwd:
+        dir_name = os.path.basename(cwd.rstrip('/'))
+        for eco_id, eco in ecosystems.items():
+            for proj in eco.get('projects', []):
+                if proj == dir_name:
+                    print(f'ECOSYSTEM=\"{eco_id}\"')
+                    print(f'ECOSYSTEM_NAME=\"{eco.get(\"name\", eco_id)}\"')
+                    sys.exit(0)
+except Exception:
+    pass
+
+print('ECOSYSTEM=\"\"')
+print('ECOSYSTEM_NAME=\"\"')
+" 2>/dev/null)"
+fi
+
+# ─── Detect stack ──────────────────────────────────────────────────────
+STACK="unknown"
+if [ -f "$NEW_CWD/composer.json" ]; then
+  STACK="laravel"
+elif [ -f "$NEW_CWD/package.json" ]; then
+  if grep -q '"nuxt"' "$NEW_CWD/package.json" 2>/dev/null; then
+    STACK="nuxt"
+  elif grep -q '"next"' "$NEW_CWD/package.json" 2>/dev/null; then
+    STACK="nextjs"
+  elif grep -q '"react"' "$NEW_CWD/package.json" 2>/dev/null; then
+    STACK="react"
+  elif grep -q '"vue"' "$NEW_CWD/package.json" 2>/dev/null; then
+    STACK="vue"
+  else
+    STACK="node"
+  fi
+elif [ -f "$NEW_CWD/pyproject.toml" ]; then
+  STACK="python"
+fi
+
+# ─── Check for project descriptor ─────────────────────────────────────
+DIR_NAME=$(basename "$NEW_CWD")
+DESCRIPTOR=""
+DESCRIPTOR_FILE="$HOME/.claude/skills/arka/projects/${DIR_NAME}.md"
+DESCRIPTOR_DIR="$HOME/.claude/skills/arka/projects/${DIR_NAME}/PROJECT.md"
+
+if [ -f "$DESCRIPTOR_FILE" ]; then
+  DESCRIPTOR="$DESCRIPTOR_FILE"
+elif [ -f "$DESCRIPTOR_DIR" ]; then
+  DESCRIPTOR="$DESCRIPTOR_DIR"
+fi
+
+# ─── Build context output ─────────────────────────────────────────────
+CONTEXT=""
+
+if [ -n "$ECOSYSTEM" ]; then
+  CONTEXT="[arka:project-context] Ecosystem: ${ECOSYSTEM_NAME} (${ECOSYSTEM}) | Stack: ${STACK} | Use /arka-${ECOSYSTEM} for dedicated squad routing."
+elif [ "$STACK" != "unknown" ]; then
+  CONTEXT="[arka:project-context] Stack: ${STACK} | No ecosystem assigned. Use /arka onboard to register this project."
+fi
+
+if [ -n "$DESCRIPTOR" ]; then
+  CONTEXT="${CONTEXT} Descriptor: ${DESCRIPTOR}"
+fi
+
+if [ -n "$CONTEXT" ]; then
+  echo "{\"additionalContext\": \"${CONTEXT}\"}"
+fi

package/config/hooks/session-start.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ArkaOS — SessionStart Hook
+# Uses systemMessage (same protocol as claude-mem) for guaranteed display.
+# ============================================================================
+
+# ─── Profile ───────────────────────────────────────────────────────────
+NAME="founder"
+COMPANY="WizardingCode"
+VERSION="2.x"
+
+if [ -f "$HOME/.arkaos/profile.json" ] && command -v python3 &>/dev/null; then
+  NAME=$(python3 -c "import json; p=json.load(open('$HOME/.arkaos/profile.json')); print(p.get('name', p.get('role', 'founder')))" 2>/dev/null || echo "founder")
+  COMPANY=$(python3 -c "import json; print(json.load(open('$HOME/.arkaos/profile.json')).get('company', 'WizardingCode'))" 2>/dev/null || echo "WizardingCode")
+fi
+
+if [ -f "$HOME/.arkaos/.repo-path" ]; then
+  REPO=$(cat "$HOME/.arkaos/.repo-path")
+  [ -f "$REPO/VERSION" ] && VERSION=$(cat "$REPO/VERSION" | tr -d '[:space:]')
+fi
+
+# ─── Time greeting ─────────────────────────────────────────────────────
+HOUR=$(date +%H)
+if [ "$HOUR" -ge 5 ] && [ "$HOUR" -lt 12 ]; then GREETING="Bom dia"
+elif [ "$HOUR" -ge 12 ] && [ "$HOUR" -lt 19 ]; then GREETING="Boa tarde"
+else GREETING="Boa noite"; fi
+
+# ─── Version drift ─────────────────────────────────────────────────────
+SYNC_STATE="$HOME/.arkaos/sync-state.json"
+DRIFT=""
+
+if [ -f "$SYNC_STATE" ]; then
+  SYNCED=$(python3 -c "import json; print(json.load(open('$SYNC_STATE'))['version'])" 2>/dev/null || echo "none")
+  if [ "$SYNCED" != "$VERSION" ]; then
+    DRIFT="\\n[arka:update-available] Core v${VERSION} != synced v${SYNCED}. Run /arka update."
+  fi
+else
+  DRIFT="\\n[arka:update-available] Never synced. Run /arka update."
+fi
+
+# ─── Build message ─────────────────────────────────────────────────────
+MSG="╔══════════════════════════════════════════════╗\\n"
+MSG+="║                                              ║\\n"
+MSG+="║              A R K A   O S                   ║\\n"
+MSG+="║                                              ║\\n"
+MSG+="║   The Operating System for AI Teams          ║\\n"
+MSG+="║                  by WizardingCode            ║\\n"
+MSG+="║                                              ║\\n"
+MSG+="╚══════════════════════════════════════════════╝\\n"
+MSG+="\\n"
+MSG+="${GREETING}, ${NAME} (${COMPANY})\\n"
+MSG+="ArkaOS v${VERSION} | 65 agents | 17 departments | 244+ skills"
+MSG+="${DRIFT}"
+
+# ─── Output as systemMessage (same protocol as claude-mem) ─────────────
+python3 -c "
+import json
+msg = '''$(echo -e "$MSG")'''
+print(json.dumps({'systemMessage': msg}))
+"

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/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.");
   },

package/installer/index.js

@@ -30,14 +30,14 @@ export async function install({ runtime, path, force }) {
   const installDir = userConfig.installDir;
 
   // ═══ Step 1: Create directories ═══
-  step(1, 12, "Creating directories...");
+  step(1, 13, "Creating directories...");
   ensureDir(installDir);
   const dirs = ["config", "config/hooks", "agents", "media", "session-digests", "vault"];
   for (const d of dirs) ensureDir(join(installDir, d));
   ok(`${dirs.length + 1} directories ready`);
 
   // ═══ Step 2: Detect v1 installation ═══
-  step(2, 12, "Checking for v1 installation...");
+  step(2, 13, "Checking for v1 installation...");
   const v1Paths = [
     join(homedir(), ".claude", "skills", "arka-os"),
     join(homedir(), ".claude", "skills", "arkaos"),
@@ -51,35 +51,56 @@ export async function install({ runtime, path, force }) {
   }
 
   // ═══ Step 3: Check Python ═══
-  step(3, 12, "Checking Python 3.11+...");
+  step(3, 13, "Checking Python 3.11+...");
   const pythonCmd = checkPython();
   ok(`Found: ${pythonCmd}`);
 
   // ═══ Step 4: Install Python core + dependencies based on user choices ═══
-  step(4, 12, "Installing Python dependencies (this may take a minute)...");
+  step(4, 13, "Installing Python dependencies (this may take a minute)...");
   installAllPythonDeps(pythonCmd, userConfig);
 
   // ═══ Step 5: Copy configuration files ═══
-  step(5, 12, "Copying configuration files...");
+  step(5, 13, "Copying configuration files...");
   copyConfigFiles(installDir);
   ok("Constitution, standards, and config copied");
 
   // ═══ Step 6: Install hooks with real paths ═══
-  step(6, 12, "Installing hooks...");
+  step(6, 13, "Installing hooks...");
   installHooks(installDir);
 
   // ═══ Step 7: Configure runtime ═══
-  step(7, 12, "Configuring runtime...");
+  step(7, 13, "Configuring runtime...");
   const adapter = await loadAdapter(runtime);
   adapter.configureHooks(config, installDir);
   ok(`${config.name} configured`);
 
   // ═══ Step 8: Install ArkaOS skill to Claude Code ═══
-  step(8, 12, "Installing /arka skill...");
+  step(8, 13, "Installing /arka skill...");
   installSkill(config, installDir);
 
-  // ═══ Step 9: Create references and profile ═══
-  step(9, 12, "Creating references...");
+  // ═══ Step 9: Install CLI wrapper and user instructions ═══
+  step(9, 13, "Installing CLI wrapper...");
+  const binDir = join(installDir, "bin");
+  ensureDir(binDir);
+  const wrapperSrc = join(ARKAOS_ROOT, "bin", "arka-claude");
+  if (existsSync(wrapperSrc)) {
+    copyFileSync(wrapperSrc, join(binDir, "arka-claude"));
+    try { chmodSync(join(binDir, "arka-claude"), 0o755); } catch {}
+    ok("arka-claude wrapper installed");
+    console.log(`         Add to PATH: export PATH="$HOME/.arkaos/bin:$PATH"`);
+    console.log(`         Optional alias: alias claude="arka-claude"`);
+  }
+  const claudeMdSrc = join(ARKAOS_ROOT, "config", "user-claude.md");
+  const userClaudeMd = join(homedir(), ".claude", "CLAUDE.md");
+  if (existsSync(claudeMdSrc) && !existsSync(userClaudeMd)) {
+    copyFileSync(claudeMdSrc, userClaudeMd);
+    ok("~/.claude/CLAUDE.md created (ArkaOS user instructions)");
+  } else if (existsSync(userClaudeMd)) {
+    ok("~/.claude/CLAUDE.md already exists (preserved)");
+  }
+
+  // ═══ Step 10: Create references and profile ═══
+  step(10, 13, "Creating references...");
   writeFileSync(join(installDir, ".repo-path"), ARKAOS_ROOT);
   const skillsDir = join(config.skillsDir || join(homedir(), ".claude", "skills"), "arkaos");
   ensureDir(skillsDir);
@@ -115,7 +136,7 @@ export async function install({ runtime, path, force }) {
   }
 
   // ═══ Step 10: Index knowledge base ═══
-  step(10, 12, "Setting up knowledge base...");
+  step(11, 13, "Setting up knowledge base...");
   if (userConfig.installKnowledge) {
     const kbDb = join(installDir, "knowledge.db");
     // Index ArkaOS skills first
@@ -143,7 +164,7 @@ export async function install({ runtime, path, force }) {
   }
 
   // ═══ Step 11: Verify installation ═══
-  step(11, 12, "Verifying installation...");
+  step(12, 13, "Verifying installation...");
   let checks = 0;
   if (existsSync(join(installDir, "config", "constitution.yaml"))) checks++;
   if (existsSync(join(installDir, "config", "hooks", "user-prompt-submit.sh"))) checks++;
@@ -158,7 +179,7 @@ export async function install({ runtime, path, force }) {
   ok(`${checks}/5 checks passed`);
 
   // ═══ Step 12: Finalize ═══
-  step(12, 12, "Finalizing...");
+  step(13, 13, "Finalizing...");
   const manifest = {
     version: VERSION,
     runtime,
@@ -358,9 +379,11 @@ function installHooks(installDir) {
   ensureDir(hooksDir);
 
   const hookMap = {
-    "user-prompt-submit-v2.sh": "user-prompt-submit.sh",
-    "post-tool-use-v2.sh": "post-tool-use.sh",
-    "pre-compact-v2.sh": "pre-compact.sh",
+    "session-start.sh": "session-start.sh",
+    "user-prompt-submit.sh": "user-prompt-submit.sh",
+    "post-tool-use.sh": "post-tool-use.sh",
+    "pre-compact.sh": "pre-compact.sh",
+    "cwd-changed.sh": "cwd-changed.sh",
   };
 
   const srcHooksDir = join(ARKAOS_ROOT, "config", "hooks");

package/installer/update.js

@@ -83,9 +83,11 @@ export async function update() {
   // ── 3. Update hooks ──
   console.log("  [3/6] Updating hooks...");
   const hookMap = {
-    "user-prompt-submit-v2.sh": "user-prompt-submit.sh",
-    "post-tool-use-v2.sh": "post-tool-use.sh",
-    "pre-compact-v2.sh": "pre-compact.sh",
+    "session-start.sh": "session-start.sh",
+    "user-prompt-submit.sh": "user-prompt-submit.sh",
+    "post-tool-use.sh": "post-tool-use.sh",
+    "pre-compact.sh": "pre-compact.sh",
+    "cwd-changed.sh": "cwd-changed.sh",
   };
   const srcHooksDir = join(ARKAOS_ROOT, "config", "hooks");
   const destHooksDir = join(installDir, "config", "hooks");
@@ -110,8 +112,26 @@ export async function update() {
   }
   console.log("         ✓ Hooks updated");
 
-  // ── 4. Update /arka skill ──
-  console.log("  [4/6] Updating /arka skill...");
+  // ── 4. Update CLI wrapper + user CLAUDE.md ──
+  console.log("  [4/7] Updating CLI wrapper and user instructions...");
+  const binDir = join(installDir, "bin");
+  mkdirSync(binDir, { recursive: true });
+  const wrapperSrc = join(ARKAOS_ROOT, "bin", "arka-claude");
+  if (existsSync(wrapperSrc)) {
+    copyFileSync(wrapperSrc, join(binDir, "arka-claude"));
+    try { chmodSync(join(binDir, "arka-claude"), 0o755); } catch {}
+    console.log("         ✓ arka-claude wrapper updated");
+  }
+  const userClaudeMd = join(homedir(), ".claude", "CLAUDE.md");
+  const claudeMdSrc = join(ARKAOS_ROOT, "config", "user-claude.md");
+  if (existsSync(claudeMdSrc)) {
+    mkdirSync(join(homedir(), ".claude"), { recursive: true });
+    copyFileSync(claudeMdSrc, userClaudeMd);
+    console.log("         ✓ ~/.claude/CLAUDE.md updated");
+  }
+
+  // ── 5. Update /arka skill ──
+  console.log("  [5/7] Updating /arka skill...");
   const skillSrc = join(ARKAOS_ROOT, "arka", "SKILL.md");
   const skillDest = join(homedir(), ".claude", "skills", "arka");
   mkdirSync(skillDest, { recursive: true });
@@ -122,13 +142,13 @@ export async function update() {
     console.log("         ✓ /arka skill updated");
   }
 
-  // ── 5. Update .repo-path ──
-  console.log("  [5/6] Updating references...");
+  // ── 6. Update .repo-path ──
+  console.log("  [6/7] Updating references...");
   writeFileSync(join(installDir, ".repo-path"), ARKAOS_ROOT);
   console.log("         ✓ Repo path updated");
 
-  // ── 6. Update manifest ──
-  console.log("  [6/6] Finalizing...");
+  // ── 7. Update manifest ──
+  console.log("  [7/7] Finalizing...");
   manifest.version = VERSION;
   manifest.repoRoot = ARKAOS_ROOT;
   manifest.updatedAt = new Date().toISOString();
@@ -147,7 +167,7 @@ export async function update() {
     core_updated_at: new Date().toISOString()
   };
   writeFileSync(syncStatePath, JSON.stringify(syncState, null, 2));
-  console.log("         ✓ Sync state reset (run /arka update to sync projects)");
+  console.log("         ✓ Sync state reset (auto-detected on next Claude session)");
 
   console.log(`
   ╔══════════════════════════════════════════╗
@@ -160,6 +180,7 @@ export async function update() {
     Projects:  ${profile.projectsDir || "not set"}
     Vault:     ${profile.vaultPath || "not set"}
 
-  ⚠ Run /arka update in Claude Code to sync all projects.
+  Next time you open Claude Code, ArkaOS will automatically
+  detect the update and sync all your projects.
   `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "2.7.0"
+version = "2.8.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}