arkaos 2.7.0 → 2.9.0

package/VERSION

@@ -1 +1 @@
-2.7.0
+2.9.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/knowledge/ecosystems.json

@@ -1,20 +1,372 @@
 {
   "_meta": {
     "description": "ARKA OS — Project Ecosystem Registry",
-    "updated": "2026-04-06"
+    "updated": "2026-04-07"
   },
   "ecosystems": {
+    "edp": {
+      "name": "EDP",
+      "description": "Enterprise integration architecture platform for EDP (Energias de Portugal). Architect solutions, AI agents, and API governance for system analysts.",
+      "client": "EDP - Energias de Portugal",
+      "type": "client",
+      "status": "active",
+      "projects": [
+        "gba-web",
+        "gba-lurch-a2a",
+        "gba-zenodotus"
+      ],
+      "squad": {
+        "roles": [
+          "project-manager",
+          "backend-developer",
+          "frontend-developer",
+          "ai-specialist",
+          "context-analyst",
+          "security-engineer",
+          "qa-tester"
+        ],
+        "description": "Dedicated EDP squad for integration architecture platform"
+      },
+      "tech_stack": {
+        "frontend": ["Laravel 12", "Inertia.js 2", "Vue 3", "TypeScript", "Tailwind CSS 4"],
+        "backend": ["PHP 8.4", "Python 3.12+", "FastAPI"],
+        "databases": ["MySQL", "PostgreSQL", "SQLite (dev)", "Redis"],
+        "ai": ["Azure OpenAI (GPT-5-mini-gba)", "pydantic-ai", "FastA2A"],
+        "infra": ["Docker", "FrankenPHP", "Laravel Octane", "Uvicorn", "Kafka", "AWS RDS", "ELK Stack"],
+        "auth": ["Azure AD OAuth 2.0", "JWT", "Spatie Permissions"],
+        "protocols": ["REST", "SOAP", "A2A (JSON-RPC 2.0)", "MCP"]
+      },
+      "created_at": "2026-03-17"
+    },
+    "rockport": {
+      "name": "Rockport",
+      "description": "E-commerce marketplace platform for Rockport premium footwear. CRM, storefront, SAP ERP integration, and logistics microservice.",
+      "client": "Rockport",
+      "type": "client",
+      "status": "active",
+      "projects": [
+        "crm-rockport",
+        "rockport-ecommerce-v2",
+        "sap-erp-service",
+        "gologistic-ms"
+      ],
+      "squad": {
+        "roles": [
+          "project-manager",
+          "backend-developer",
+          "frontend-developer",
+          "ecommerce-specialist",
+          "integrations-specialist",
+          "security-engineer",
+          "qa-tester"
+        ],
+        "description": "Dedicated Rockport squad for e-commerce platform"
+      },
+      "tech_stack": {
+        "frontend": ["Nuxt 4", "Vue 3", "TypeScript", "Tailwind CSS 4", "Nuxt UI 4", "Pinia 3", "Vuetify 3"],
+        "backend": ["PHP 8.4", "Laravel 11/12", "Laravel Modules"],
+        "databases": ["PostgreSQL", "Redis", "Meilisearch", "SQLite (dev)"],
+        "payments": ["SIBS", "Klarna", "Adyen", "MBWay"],
+        "integrations": ["SAP Business One", "Kafka", "GoLogistic", "DPD", "Mirakl", "Actito", "SendGrid", "Infobip"],
+        "infra": ["Docker", "FrankenPHP", "Octane/Roadrunner", "Horizon", "DigitalOcean Spaces", "AWS S3"],
+        "auth": ["Sanctum", "Spatie Permissions", "Social Login (Google/Facebook/Apple)"],
+        "protocols": ["REST", "Kafka", "WebSocket (Reverb)"]
+      },
+      "created_at": "2026-03-17"
+    },
+    "clubefashion": {
+      "name": "ClubeFashion",
+      "description": "E-commerce marketplace platform for ClubeFashion. Complex ecosystem with CRM migration in progress, Mirakl marketplace, Primavera ERP, and AI-ready modernization.",
+      "client": "ClubeFashion",
+      "type": "client",
+      "status": "active",
+      "projects": [
+        "the-burrow-hub",
+        "marketplace-ms",
+        "goblinledger",
+        "crm-cf-v2",
+        "nuxt-boilerplate",
+        "crm-frontend-v2"
+      ],
+      "squad": {
+        "roles": [
+          "project-manager",
+          "backend-developer",
+          "frontend-developer",
+          "ecommerce-specialist",
+          "marketplace-specialist",
+          "erp-specialist",
+          "migration-architect",
+          "ai-specialist",
+          "security-engineer",
+          "qa-tester",
+          "devops"
+        ],
+        "description": "Dedicated ClubeFashion squad — largest team due to migration complexity"
+      },
+      "tech_stack": {
+        "frontend": ["Nuxt 4", "Vue 3", "Vuetify 3", "Nuxt UI 4", "TypeScript", "Tailwind CSS 4", "Pinia"],
+        "backend": ["PHP 8.4/8.5", "Laravel 11/12", "Laravel Modules (19)"],
+        "databases": ["PostgreSQL", "Redis", "Meilisearch", "SQLite (dev)"],
+        "payments": ["SIBS", "Klarna", "Adyen", "MBWay"],
+        "integrations": ["Mirakl (marketplace-ms)", "Primavera ERP (goblinledger)", "Kafka (30+ topics)", "Actito", "SendGrid", "Infobip", "Skeepers", "DPD", "Google Merchant"],
+        "infra": ["Docker", "FrankenPHP", "Octane/Roadrunner", "Horizon", "AWS S3", "DigitalOcean Spaces"],
+        "auth": ["Sanctum", "Spatie Permissions", "Social Login"],
+        "protocols": ["REST", "Kafka", "WebSocket (Reverb)"],
+        "project_management": ["ClickUp (Space: 90153217724)"]
+      },
+      "migration": {
+        "from": "the-burrow-hub (Laravel 11, 19 modules, 431 migrations, 163 models)",
+        "to": "crm-cf-v2 (Laravel 12, AI-ready, strict types) + crm-frontend-v2 (Vue 3 SPA)",
+        "status": "paused — foundation laid, 0% content migration",
+        "priority": "planning phase"
+      },
+      "created_at": "2026-03-17"
+    },
+    "fovory": {
+      "name": "Fovory",
+      "description": "Supplier-to-Shopify integration engine with custom Laravel codebase (fovory-supplier-sync) AND Shopify store operations/marketing. Dual nature: dev squad for code work, ops/marketing squad for store management.",
+      "client": "Fovory (internal business)",
+      "type": "internal",
+      "status": "active",
+      "projects": [
+        "fovory-supplier-sync"
+      ],
+      "platform": "Shopify + Custom Laravel App",
+      "squad": {
+        "roles": [
+          "tech-lead",
+          "backend-developer",
+          "frontend-developer",
+          "ai-specialist",
+          "security-engineer",
+          "qa-tester",
+          "operations-manager",
+          "ecommerce-manager",
+          "product-manager",
+          "marketing-strategist",
+          "content-creator",
+          "ads-specialist",
+          "email-marketing",
+          "seo-specialist",
+          "analytics-specialist",
+          "pricing-strategist"
+        ],
+        "description": "Dual squad: dev team (Laravel/Vue) + operations/marketing team (Shopify store)"
+      },
+      "tech_stack": {
+        "frontend": ["Vue 3.5", "Inertia.js 3", "TypeScript", "Tailwind CSS 4", "Nuxt UI 4", "TipTap 3", "TanStack Table", "Unovis"],
+        "backend": ["PHP 8.4", "Laravel 13", "Laravel Horizon", "Laravel Reverb", "Laravel Fortify", "Laravel Pennant"],
+        "databases": ["PostgreSQL", "Redis", "SQLite (dev)"],
+        "ai": ["Laravel AI SDK", "Claude/Anthropic", "OpenRouter", "OpenAI"],
+        "import": ["Maatwebsite Excel", "WebSocket progress"],
+        "testing": ["Pest 5", "Playwright", "Larastan", "Rector", "Pint"],
+        "build": ["Bun", "Vite"],
+        "shopify": ["Shopify GraphQL Admin API", "Shopify MCP"]
+      },
+      "codebase_stats": {
+        "models": 43,
+        "actions": 75,
+        "controllers": 42,
+        "vue_pages": 44,
+        "migrations": 72,
+        "tests": 943,
+        "assertions": 2997,
+        "updated": "2026-04-07"
+      },
+      "capabilities": {
+        "dev": ["Supplier integration (API + CSV)", "Product CRUD with variants/offers", "AI system (providers/agents/personas/triggers)", "Bulk import (Excel + WebSocket)", "E-commerce settings", "Multi-locale translations"],
+        "store": ["Shopify MCP", "Product management", "CSV bulk operations", "Pricing strategy (min 35% margin)", "Stock management (15min sync, 5% buffer)", "Translations"],
+        "marketing": ["Social media (Instagram, LinkedIn, TikTok, X)", "Email campaigns", "Google Ads", "Meta Ads", "Content calendars", "Reels/Shorts scripts"],
+        "analytics": ["Google Analytics 4", "Google Ads", "Shopify Analytics", "Meta Pixel"],
+        "knowledge": ["KB personas for content voice", "Market research", "Competitor analysis", "Trend analysis"],
+        "automation": ["Bulk product updates", "Price optimization", "Translation automation", "Ad creative generation"]
+      },
+      "created_at": "2026-03-17",
+      "updated_at": "2026-04-07"
+    },
     "wizardingcode": {
+      "name": "WizardingCode Internal",
+      "description": "Internal growth engine. Revenue target: 1M EUR by Dec 2026. Micro-SaaS, AI tools, content creation, financial management, trend scouting.",
+      "client": "WizardingCode (internal)",
+      "type": "internal",
+      "status": "active",
+      "projects": [
+        "lora-tester",
+        "purz-comfyui-workflows"
+      ],
+      "squad": {
+        "roles": [
+          "ceo-copilot",
+          "creative-director",
+          "marketing-lead",
+          "data-analyst",
+          "market-scout",
+          "content-creator",
+          "financial-controller",
+          "full-stack-builder",
+          "growth-hacker",
+          "community-manager"
+        ],
+        "description": "Growth team — strategy, content, finance, and product development"
+      },
+      "revenue_target": {
+        "amount": 1000000,
+        "currency": "EUR",
+        "deadline": "2026-12-31",
+        "monthly_target": 83333
+      },
+      "capabilities": {
+        "strategy": ["Idea evaluation", "OKRs", "Roadmap", "Market analysis"],
+        "product": ["Micro-SaaS", "AI tools", "ARKA OS Pro", "Landing pages"],
+        "content": ["AI articles", "Entrepreneurship", "YouTube", "LinkedIn", "Newsletter"],
+        "finance": ["Gmail accounting", "Revenue tracking", "Investment plans", "Invoicing"],
+        "marketing": ["Social media", "Email funnels", "Google Ads", "Growth hacking"]
+      },
+      "integrations": ["Gmail (accounting)", "Google Calendar", "ClickUp", "InvoiceExpress"],
+      "created_at": "2026-03-17"
+    },
+    "rothbard100": {
+      "name": "Rothbard 100",
+      "description": "Libertarian event platform celebrating the 100th anniversary of Murray Rothbard. Landing page, future registration app, and event CRM. Organized by Cataláxia EDITORA. Event: Porto, 27 Jun 2026.",
+      "client": "Cataláxia EDITORA",
+      "type": "internal",
+      "status": "active",
+      "projects": [
+        "rothbard100-landing"
+      ],
+      "squad": {
+        "roles": [
+          "project-manager",
+          "frontend-developer",
+          "content-creator",
+          "seo-marketing",
+          "security-engineer",
+          "qa-tester",
+          "devops"
+        ],
+        "description": "Dedicated Rothbard 100 squad for event platform — landing page focus"
+      },
+      "tech_stack": {
+        "frontend": ["Nuxt 4.4.2", "Vue 3", "TypeScript", "Tailwind CSS 4", "Nuxt UI v4.5.1"],
+        "i18n": ["@nuxtjs/i18n (pt, en, fr, es, de)"],
+        "content": ["@nuxt/content v3"],
+        "images": ["@nuxt/image v2"],
+        "icons": ["Iconify (lucide + simple-icons)"],
+        "infra": ["Cloudflare Pages", "pnpm"],
+        "build": ["SSG (Nitro prerender)"]
+      },
+      "brand": {
+        "primary_color": "#FFC939",
+        "secondary_color": "#000000",
+        "theme": "dark-premium-revolutionary",
+        "style": "Silicon Valley event level",
+        "font": "Inter (400-900)",
+        "mode": "light-only"
+      },
+      "created_at": "2026-03-26",
+      "updated_at": "2026-04-07"
+    },
+    "cascais24horas": {
+      "name": "Cascais 24 Horas",
+      "description": "Local news and events portal for Cascais, Portugal. Security-critical rebuild after WordPress hack. CMS backend with admin panel and public-facing Nuxt frontend.",
+      "client": "WizardingCode (internal project)",
+      "type": "internal",
+      "status": "active",
+      "projects": [
+        "cascais24horas-cms",
+        "cascais24horas-web"
+      ],
+      "squad": {
+        "roles": [
+          "project-manager",
+          "backend-developer",
+          "frontend-developer-cms",
+          "frontend-developer-web",
+          "content-creator",
+          "seo-marketing",
+          "security-engineer",
+          "qa-tester"
+        ],
+        "description": "Dedicated Cascais24Horas squad for news portal rebuild"
+      },
+      "tech_stack": {
+        "frontend_cms": ["Vue 3", "Inertia.js 3", "TypeScript", "Tailwind CSS 4", "TipTap"],
+        "frontend_web": ["Nuxt 4", "Nuxt UI 4", "Vue 3", "TypeScript", "Tailwind CSS 4"],
+        "backend": ["PHP 8.4", "Laravel 12"],
+        "databases": ["SQLite (dev)", "PostgreSQL (prod)", "Redis"],
+        "search": ["Laravel Scout"],
+        "media": ["Spatie MediaLibrary"],
+        "auth": ["Sanctum", "Spatie Permission"],
+        "seo": ["Spatie Sitemap", "Nuxt SEO", "Google News"],
+        "content": ["@nuxt/content v3", "TipTap", "HTML Purifier"]
+      },
+      "security_context": "Rebuilt after WordPress hack — security is first-class concern",
+      "created_at": "2026-03-31"
+    },
+    "marlon": {
+      "name": "Marlon",
+      "description": "Services and consulting client of WizardingCode. Web application ecosystem with Nuxt/Vue frontend. Dedicated squad and orchestrator.",
+      "client": "Marlon",
+      "type": "client",
+      "status": "active",
+      "projects": [],
+      "squad": {
+        "roles": [
+          "project-manager",
+          "backend-developer",
+          "frontend-developer",
+          "security-engineer",
+          "qa-tester",
+          "devops"
+        ],
+        "description": "Dedicated Marlon squad for services/consulting web platform"
+      },
+      "tech_stack": {
+        "frontend": ["Nuxt 4", "Vue 3", "TypeScript", "Tailwind CSS 4", "Nuxt UI 4"],
+        "backend": ["PHP 8.4", "Laravel 12"],
+        "databases": ["PostgreSQL", "SQLite (dev)", "Redis"],
+        "auth": ["Sanctum", "Spatie Permissions"],
+        "infra": ["Docker", "pnpm", "Vercel/Netlify"]
+      },
+      "created_at": "2026-04-06"
+    },
+    "zugatv": {
+      "name": "ZugaTV",
+      "description": "Portuguese content/media partner. Viral interactive content and audience growth funnels. First project: Raio-X Ideologico — political ideology quiz for follower growth.",
+      "client": "ZugaTV",
+      "type": "partner",
+      "status": "active",
       "projects": [
-        {
-          "name": "arka-os",
-          "role": "product",
-          "stack": "Python + Node.js + React",
-          "path": "/Users/andreagroferreira/AIProjects/arka-os",
-          "skill": "/platform-arka",
-          "description": "ArkaOS — The Operating System for AI Agent Teams"
-        }
-      ]
+        "raiox-ideologico"
+      ],
+      "squad": {
+        "roles": [
+          "project-manager",
+          "frontend-developer",
+          "content-creator",
+          "seo-marketing",
+          "security-engineer",
+          "qa-tester"
+        ],
+        "description": "Dedicated ZugaTV squad for viral content platforms"
+      },
+      "tech_stack": {
+        "frontend": ["Nuxt 4", "Vue 3", "TypeScript", "Tailwind CSS 4", "Nuxt UI 4", "Chart.js", "vue-chartjs"],
+        "content": ["@nuxt/content v3"],
+        "composables": ["@vueuse/nuxt"],
+        "seo": ["@nuxtjs/seo", "@nuxtjs/robots", "nuxt-og-image"],
+        "analytics": ["nuxt-plausible"],
+        "fonts": ["@nuxt/fonts (Inter)"],
+        "testing": ["Vitest", "@vue/test-utils", "happy-dom"],
+        "build": ["pnpm", "SSR/SPA hybrid", "Vercel or Cloudflare Pages"]
+      },
+      "constraints": {
+        "architecture": "100% client-side scoring — NO backend, NO database, NO auth",
+        "privacy": "RGPD by design — no personal data stored server-side",
+        "language": "Portuguese (pt-PT) only — no i18n"
+      },
+      "created_at": "2026-03-28"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "2.7.0",
+  "version": "2.9.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.9.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}