From b4b7316d5202c00be18afe089064152d5fcdf5fc Mon Sep 17 00:00:00 2001
From: "s0wlz (Matthias Puchstein)" <matthias@puchstein.lu>
Date: Tue, 30 Dec 2025 04:39:26 +0100
Subject: [PATCH] feat: add templates for Zsh, Kitty, and Alacritty

- Integrated Zsh cockpit theme with radar/AAR logic.
- Added Kitty terminal configuration mirroring system DNA.
- Added Alacritty TOML template for semantic color mapping.
- Updated GEMINI.md repository map.
---
 GEMINI.md                        |   2 +
 templates/alacritty/apex.toml.j2 |  63 ++++
 templates/kitty/apex.conf.j2     |  66 +++++
 templates/zsh/apex.zsh-theme.j2  | 486 +++++++++++++++++++++++++++++++
 4 files changed, 617 insertions(+)
 create mode 100644 templates/alacritty/apex.toml.j2
 create mode 100644 templates/kitty/apex.conf.j2
 create mode 100644 templates/zsh/apex.zsh-theme.j2

diff --git a/GEMINI.md b/GEMINI.md
index df4a9f9..a848b69 100644
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -75,5 +75,7 @@ Apex is not about pretty colors; it is about signal clarity.
 ├── templates/ # Jinja2 templates for build targets
 │ ├── nvim/
 │ ├── zed/
+│ ├── zsh/
+│ ├── kitty/
 │ └── alacritty/
 └── dist/ # Compiled theme files (gitignore this)
diff --git a/templates/alacritty/apex.toml.j2 b/templates/alacritty/apex.toml.j2
new file mode 100644
index 0000000..6bf1727
--- /dev/null
+++ b/templates/alacritty/apex.toml.j2
@@ -0,0 +1,63 @@
+# {{ scheme | upper }} — Alacritty theme (colors only)
+
+[colors.primary]
+background = "{{ palette.background }}"
+foreground = "{{ palette.foreground }}"
+dim_foreground = "{{ ui.dim }}"
+bright_foreground = "{{ ansi.bright.white }}"
+
+[colors.cursor]
+text = "{{ palette.selection_fg }}"
+cursor = "{{ palette.cursor }}"
+
+[colors.vi_mode_cursor]
+text = "{{ palette.selection_fg }}"
+cursor = "{{ palette.info }}"
+
+[colors.selection]
+text = "{{ palette.selection_fg }}"
+background = "{{ palette.selection }}"
+
+[colors.search.matches]
+foreground = "{{ palette.selection_fg }}"
+background = "{{ palette.selection }}"
+
+[colors.search.focused_match]
+foreground = "{{ palette.selection_fg }}"
+background = "{{ palette.warning }}"
+
+[colors.hints.start]
+foreground = "{{ palette.selection_fg }}"
+background = "{{ palette.warning }}"
+
+[colors.hints.end]
+foreground = "{{ palette.selection_fg }}"
+background = "{{ palette.info }}"
+
+[colors.line_indicator]
+foreground = "None"
+background = "None"
+
+[colors.footer_bar]
+foreground = "{{ palette.foreground }}"
+background = "{{ ui.panel }}"
+
+[colors.normal]
+black   = "{{ ansi.normal.black }}"
+red     = "{{ ansi.normal.red }}"
+green   = "{{ ansi.normal.green }}"
+yellow  = "{{ ansi.normal.yellow }}"
+blue    = "{{ ansi.normal.blue }}"
+magenta = "{{ ansi.normal.magenta }}"
+cyan    = "{{ ansi.normal.cyan }}"
+white   = "{{ ansi.normal.white }}"
+
+[colors.bright]
+black   = "{{ ansi.bright.black }}"
+red     = "{{ ansi.bright.red }}"
+green   = "{{ ansi.bright.green }}"
+yellow  = "{{ ansi.bright.yellow }}"
+blue    = "{{ ansi.bright.blue }}"
+magenta = "{{ ansi.bright.magenta }}"
+cyan    = "{{ ansi.bright.cyan }}"
+white   = "{{ ansi.bright.white }}"
diff --git a/templates/kitty/apex.conf.j2 b/templates/kitty/apex.conf.j2
new file mode 100644
index 0000000..10d2365
--- /dev/null
+++ b/templates/kitty/apex.conf.j2
@@ -0,0 +1,66 @@
+## {{ scheme | upper }} - KITTY THEME ##
+## Spec-accurate: color = state, not decoration
+
+# --- Core ---
+foreground            {{ palette.foreground }}
+background            {{ palette.background }}
+
+# Selection: "target locked"
+selection_background  {{ palette.selection }}
+selection_foreground  {{ palette.selection_fg }}
+
+# Cursor: Razor Red beam
+cursor                {{ palette.cursor }}
+cursor_text_color     {{ palette.selection_fg }}
+cursor_shape          beam
+
+# URLs: informational cyan
+url_color             {{ palette.info }}
+
+# Borders (optional)
+active_border_color   {{ palette.cursor }}
+inactive_border_color {{ ui.border }}
+
+# Optional: subtle UI hint for visual bell
+visual_bell_color     {{ ansi.bright.red }}
+
+# Spacing
+window_padding_width  4
+
+# --- 16-COLOR ANSI TABLE ({{ scheme }} spec) ---
+
+# Normal bank (0–7)
+# color0: Black (Void)
+color0   {{ ansi.normal.black }}
+# color1: Red (Razor)
+color1   {{ ansi.normal.red }}
+# color2: Green (OK)
+color2   {{ ansi.normal.green }}
+# color3: Yellow (Gold)
+color3   {{ ansi.normal.yellow }}
+# color4: Blue (Info)
+color4   {{ ansi.normal.blue }}
+# color5: Magenta (Purple)
+color5   {{ ansi.normal.magenta }}
+# color6: Cyan (Info mapped)
+color6   {{ ansi.normal.cyan }}
+# color7: White (Stark)
+color7   {{ ansi.normal.white }}
+
+# Bright bank (8–15)
+# color8: Bright black (UI separators)
+color8   {{ ansi.bright.black }}
+# color9: Bright red (Alerts)
+color9   {{ ansi.bright.red }}
+# color10: Bright green (Active success)
+color10  {{ ansi.bright.green }}
+# color11: Bright yellow (Urgent warning)
+color11  {{ ansi.bright.yellow }}
+# color12: Bright blue (Active info)
+color12  {{ ansi.bright.blue }}
+# color13: Bright magenta (Elevated special)
+color13  {{ ansi.bright.magenta }}
+# color14: Bright cyan (Active tech signal)
+color14  {{ ansi.bright.cyan }}
+# color15: Bright white (Extreme highlight)
+color15  {{ ansi.bright.white }}
diff --git a/templates/zsh/apex.zsh-theme.j2 b/templates/zsh/apex.zsh-theme.j2
new file mode 100644
index 0000000..fa967ca
--- /dev/null
+++ b/templates/zsh/apex.zsh-theme.j2
@@ -0,0 +1,486 @@
+# {{ scheme }} — Predator Cockpit (Zsh) — v1
+# Two-bus design:
+#   [precmd radar]  -> after-action + context bursts (event-driven)
+#   [promptline]    -> LEFT: identity + territory
+#                      RIGHT: intel + vcs + friction (stable)
+
+setopt prompt_subst
+setopt no_beep
+
+zmodload zsh/datetime 2>/dev/null
+
+# -----------------------------------------------------------------------------
+# 1) PALETTE ({{ scheme }} DNA)
+# -----------------------------------------------------------------------------
+typeset -gA C
+C[VOID]="{{ palette.background }}"
+C[WHITE]="{{ palette.foreground }}"
+C[MUTED]="{{ ui.dim }}"
+C[RAZOR]="{{ palette.cursor }}"
+C[CYAN]="{{ palette.info }}"
+C[GOLD]="{{ palette.warning }}"
+C[OK]="{{ palette.success }}"
+C[PURPLE]="{{ palette.special }}"
+C[ALERT]="{{ ansi.bright.red }}"
+
+# -----------------------------------------------------------------------------
+# 2) ICONS / GLYPHS (Nerd Font optional)
+# -----------------------------------------------------------------------------
+typeset -gA I
+I[OS]=""
+I[SSH]=""
+I[ROOT]=""
+I[GIT]=""
+I[JOBS]=""
+I[RADAR]="⌁"
+I[RET]="↩"
+
+typeset -gA S
+S[PL_L]=""
+S[PL_R]=""
+S[DOT]="·"
+
+# -----------------------------------------------------------------------------
+# 3) CONFIG
+# -----------------------------------------------------------------------------
+typeset -gA APEX
+APEX[SLOW_SOFT_MS]=750
+APEX[SLOW_HARD_MS]=2000
+
+APEX[STARTUP_BURST]=1
+APEX[SHOW_AAR]=1
+APEX[SHOW_CONTEXT_BURST]=1
+APEX[SHOW_VCS]=1
+APEX[SHOW_INTEL]=1
+APEX[SHOW_JOBS]=1
+APEX[SHOW_RO]=1
+APEX[GIT_AHEAD_BEHIND]=0
+
+# Ops commands (also match wrappers like sudo/doas/command)
+APEX[OPS_RE]='^((sudo|doas|command)[[:space:]]+)*((pacman|yay|paru|apt|dnf|brew|systemctl|docker|kubectl|helm|git))([[:space:]]|$)'
+
+# Session-ish commands (spawn a subshell; exit codes are often “not a failure”)
+APEX[SESSION_RE]='^((sudo|doas|command)[[:space:]]+)*chezmoi[[:space:]]+cd([[:space:]]|$)'
+
+# -----------------------------------------------------------------------------
+# 4) STATE
+# -----------------------------------------------------------------------------
+typeset -gF apex_cmd_start=0.0
+typeset -g  apex_last_cmd=""
+typeset -g  apex_has_run_cmd=0
+
+typeset -g  apex_startup_done=0
+typeset -g  apex_pwd_changed=1
+
+# Sticky intel
+typeset -g  apex_venv_name=""
+typeset -g  apex_target_sig=""
+typeset -g  apex_mode_sig=""
+
+# Git state
+typeset -g  apex_in_git=0
+typeset -g  apex_git_branch=""
+typeset -g  apex_git_dirty_wt=0
+typeset -g  apex_git_dirty_ix=0
+typeset -g  apex_git_op=""
+typeset -g  apex_git_up_ok=0
+typeset -g  apex_git_ahead=0
+typeset -g  apex_git_behind=0
+
+# Radar previous snapshots (transition detection)
+typeset -g  apex_prev_in_git=-1
+typeset -g  apex_prev_git_branch=""
+typeset -g  apex_prev_git_op=""
+typeset -g  apex_prev_venv_name=""
+typeset -g  apex_prev_target_sig=""
+typeset -g  apex_prev_proj_sig=""
+
+# -----------------------------------------------------------------------------
+# 5) UTILITIES
+# -----------------------------------------------------------------------------
+apex__short_cmd() {
+  local s="$1"
+  s="${s//$'
+'/ }"
+  s="${s#"${s%%[![:space:]]*}"}"   # ltrim
+  s="${s%"${s##*[![:space:]]}"}"   # rtrim
+  print -r -- "${s[1,90]}"
+}
+
+apex__project_sig() {
+  local s=""
+  [[ -f package.json ]] && s+="node"
+  [[ -f pnpm-lock.yaml ]] && s+="+pnpm"
+  [[ -f bun.lockb ]] && s+="+bun"
+  [[ -f yarn.lock ]] && s+="+yarn"
+
+  [[ -f pyproject.toml || -f requirements.txt ]] && s+="${s:+ }py"
+  [[ -f uv.lock ]] && s+="+uv"
+
+  [[ -f Cargo.toml ]] && s+="${s:+ }rust"
+  [[ -f go.mod ]] && s+="${s:+ }go"
+
+  [[ -n "$s" ]] && print -r -- "$s"
+}
+
+# -----------------------------------------------------------------------------
+# 6) INTEL (sticky; updated each prompt)
+# -----------------------------------------------------------------------------
+apex_update_intel() {
+  # Target (cheap env-based; no kubectl calls)
+  if [[ -n "$AWS_PROFILE" ]]; then
+    apex_target_sig="aws:${AWS_PROFILE}"
+  elif [[ -n "$GOOGLE_CLOUD_PROJECT" ]]; then
+    apex_target_sig="gcp:${GOOGLE_CLOUD_PROJECT}"
+  elif [[ -n "$KUBE_CONTEXT" ]]; then
+    apex_target_sig="kube:${KUBE_CONTEXT}"
+  else
+    apex_target_sig=""
+  fi
+
+  # Mode
+  if [[ -n "$IN_NIX_SHELL" ]]; then
+    apex_mode_sig="nix"
+  elif [[ -n "$DIRENV_DIR" ]]; then
+    apex_mode_sig="direnv"
+  else
+    apex_mode_sig=""
+  fi
+
+  # Venv
+  apex_venv_name=""
+  if [[ -n "$VIRTUAL_ENV" ]]; then
+    apex_venv_name="$(basename "$VIRTUAL_ENV")"
+  elif [[ -n "$CONDA_DEFAULT_ENV" ]]; then
+    apex_venv_name="$CONDA_DEFAULT_ENV"
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# 7) GIT
+# -----------------------------------------------------------------------------
+apex_git_update() {
+  apex_in_git=0
+  apex_git_branch=""
+  apex_git_dirty_wt=0
+  apex_git_dirty_ix=0
+  apex_git_op=""
+  apex_git_up_ok=0
+  apex_git_ahead=0
+  apex_git_behind=0
+
+  command git rev-parse --is-inside-work-tree &>/dev/null || return
+  apex_in_git=1
+
+  apex_git_branch="$(
+    command git symbolic-ref --quiet --short HEAD 2>/dev/null \
+      || command git rev-parse --short HEAD 2>/dev/null
+  )"
+
+  local gd; gd="$(command git rev-parse --git-dir 2>/dev/null)" || return
+  [[ -d "$gd/rebase-apply" || -d "$gd/rebase-merge" ]] && apex_git_op="rebase"
+  [[ -f "$gd/MERGE_HEAD" ]] && apex_git_op="merge"
+  [[ -f "$gd/CHERRY_PICK_HEAD" ]] && apex_git_op="cherry-pick"
+  [[ -f "$gd/BISECT_LOG" ]] && apex_git_op="bisect"
+
+  # Dirty markers
+  command git diff --quiet --ignore-submodules -- 2>/dev/null || apex_git_dirty_wt=1
+  command git diff --cached --quiet --ignore-submodules -- 2>/dev/null || apex_git_dirty_ix=1
+
+  # Upstream (earned ✓)
+  if command git rev-parse --abbrev-ref --symbolic-full-name @{u} &>/dev/null; then
+    local counts
+    counts="$(command git rev-list --left-right --count @{u}...HEAD 2>/dev/null)" || return
+    apex_git_behind="${counts%% *}"
+    apex_git_ahead="${counts##* }"
+
+    if (( apex_git_dirty_wt == 0 && apex_git_dirty_ix == 0 )) && [[ -z "$apex_git_op" ]]; then
+      [[ "$apex_git_behind" == "0" && "$apex_git_ahead" == "0" ]] && apex_git_up_ok=1
+    fi
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# 8) LEFT PROMPTLINE: IDENTITY + TERRITORY
+# -----------------------------------------------------------------------------
+apex_identity() {
+  local is_root=0 is_ssh=0 color label
+  (( EUID == 0 )) && is_root=1
+  [[ -n "$SSH_CONNECTION$SSH_TTY" ]] && is_ssh=1
+
+  if (( is_root )); then
+    color="${C[PURPLE]}"
+    if (( is_ssh )); then
+      label="${I[ROOT]} @%m"
+    else
+      label="${I[ROOT]} root"
+    fi
+  elif (( is_ssh )); then
+    color="${C[CYAN]}"
+    label="${I[SSH]} %n @%m"
+  else
+    return 0
+  fi
+
+  print -n "%F{${color}}${S[PL_L]}%f%K{${color}}%F{${C[VOID]}}%B ${label} %b%f%k%F{${color}}${S[PL_R]}%f "
+}
+
+apex_territory() {
+  print -n "%F{${C[RAZOR]}}${S[PL_L]}%f%K{${C[RAZOR]}}%F{${C[VOID]}}%B ${I[OS]}%b %F{${C[WHITE]}}%B%~%b %f%k%F{${C[RAZOR]}}${S[PL_R]}%f"
+}
+
+# -----------------------------------------------------------------------------
+# 9) RIGHT PROMPT (RPROMPT): INTEL + VCS + FRICTION
+# -----------------------------------------------------------------------------
+apex_intel_r() {
+  (( APEX[SHOW_INTEL] )) || return 0
+  if [[ -n "$apex_target_sig" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_target_sig})%f"
+  elif [[ -n "$apex_mode_sig" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_mode_sig})%f"
+  elif [[ -n "$apex_venv_name" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_venv_name})%f"
+  fi
+}
+
+apex_vcs_r() {
+  (( APEX[SHOW_VCS] )) || return 0
+  (( apex_in_git )) || return 0
+
+  if [[ -n "$apex_git_op" ]]; then
+    print -n "%F{${C[ALERT]}}${I[GIT]} ${apex_git_branch} ${apex_git_op}%f"
+    return 0
+  fi
+
+  print -n "%F{${C[CYAN]}}${I[GIT]} ${apex_git_branch}%f"
+
+  local mark=""
+  (( apex_git_dirty_ix )) && mark+="+"
+  (( apex_git_dirty_wt )) && mark+="!"
+  [[ -n "$mark" ]] && print -n "%F{${C[GOLD]}} ${mark}%f"
+
+  (( apex_git_up_ok )) && print -n "%F{${C[OK]}} ✓%f"
+
+  if (( APEX[GIT_AHEAD_BEHIND] )); then
+    (( apex_git_ahead > 0 )) && print -n "%F{${C[MUTED]}} ⇡${apex_git_ahead}%f"
+    (( apex_git_behind > 0 )) && print -n "%F{${C[MUTED]}} ⇣${apex_git_behind}%f"
+  fi
+}
+
+apex_friction_r() {
+  if (( APEX[SHOW_RO] )) && [[ ! -w . ]]; then
+    print -n "%F{${C[GOLD]}}${I[ROOT]} ro%f"
+    return 0
+  fi
+
+  if (( APEX[SHOW_JOBS] )); then
+    local jc
+    jc=$(jobs -p 2>/dev/null | wc -l | tr -d ' ')
+    if [[ -n "$jc" && "$jc" != "0" ]]; then
+      print -n "%F{${C[MUTED]}}${I[JOBS]} ${jc}%f"
+      return 0
+    fi
+  fi
+}
+
+build_rprompt() {
+  local s out=""
+  local sep="%F{${C[MUTED]}} ${S[DOT]} %f"
+
+  s="$(apex_intel_r)";    [[ -n "$s" ]] && out+="$s"
+  s="$(apex_vcs_r)";      [[ -n "$s" ]] && out+="${out:+$sep}$s"
+  s="$(apex_friction_r)"; [[ -n "$s" ]] && out+="${out:+$sep}$s"
+
+  [[ -n "$out" ]] && out="%F{${C[MUTED]}}[%f${out}%F{${C[MUTED]}}]%f"
+  print -n "$out"
+}
+
+# -----------------------------------------------------------------------------
+# 10) RADAR (precmd)
+# -----------------------------------------------------------------------------
+apex_radar_aar() {
+  (( APEX[SHOW_AAR] )) || return 0
+
+  local ec=$1 cmd="$2" dur="$3"
+  local -i ms=${4:-0}
+
+  local show=0
+  (( ec != 0 )) && show=1
+  [[ -n "$dur" ]] && show=1
+  [[ "$cmd" =~ ${APEX[OPS_RE]} ]] && show=1
+  (( show )) || return 0
+
+  local short; short="$(apex__short_cmd "$cmd")"
+
+  local dur_color="${C[MUTED]}"
+  (( ms >= ${APEX[SLOW_HARD_MS]} )) && dur_color="${C[GOLD]}"
+
+  local dur_chunk=""
+  if [[ -n "$dur" ]]; then
+    if (( ms >= ${APEX[SLOW_HARD_MS]} )); then
+      dur_chunk=" %F{${dur_color}}%B${dur}%b%f"
+    else
+      dur_chunk=" %F{${dur_color}}${dur}%f"
+    fi
+  fi
+
+  # Session commands: don't scream in red for “rc:1”
+  if [[ "$cmd" =~ ${APEX[SESSION_RE]} ]]; then
+    if (( ec == 0 )); then
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[OK]}}${I[RET]}%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+    else
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[GOLD]}}${I[RET]}%f %F{${C[WHITE]}}${short}%f %F{${C[MUTED]}}rc:${ec}%f${dur_chunk}"
+    fi
+    return 0
+  fi
+
+  if (( ec == 0 )); then
+    print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[OK]}}✓%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+    return 0
+  fi
+
+  # Signals: 128 + signal number
+  case $ec in
+    130) # SIGINT (Ctrl+C)
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[CYAN]}}^C%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    141) # SIGPIPE
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[MUTED]}}PIPE%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    143) # SIGTERM
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[GOLD]}}TERM%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    *) 
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[ALERT]}}✘ ${ec}%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+  esac
+}
+
+apex_radar_context_burst() {
+  (( APEX[SHOW_CONTEXT_BURST] )) || return 0
+
+  local proj_sig; proj_sig="$(apex__project_sig 2>/dev/null || print -r -- "")"
+
+  local emit=0
+  if (( apex_startup_done == 0 )); then
+    (( APEX[STARTUP_BURST] )) && emit=1
+  fi
+  (( apex_pwd_changed )) && emit=1
+  [[ "$apex_venv_name" != "$apex_prev_venv_name" ]] && emit=1
+  [[ "$apex_target_sig" != "$apex_prev_target_sig" ]] && emit=1
+  (( apex_in_git != apex_prev_in_git )) && emit=1
+  [[ "$apex_git_branch" != "$apex_prev_git_branch" ]] && emit=1
+  [[ "$apex_git_op" != "$apex_prev_git_op" ]] && emit=1
+  [[ "$proj_sig" != "$apex_prev_proj_sig" ]] && emit=1
+
+  (( emit )) || return 0
+
+  # If nothing to say, say nothing.
+  if [[ -z "$proj_sig" && -z "$apex_venv_name" && -z "$apex_target_sig" ]] && (( apex_in_git == 0 )); then
+    apex_pwd_changed=0
+    apex_startup_done=1
+    return 0
+  fi
+
+  local out="%F{${C[MUTED]}}${I[RADAR]}%f "
+
+  # Git first
+  if (( apex_in_git )); then
+    if [[ -n "$apex_git_op" ]]; then
+      out+="%F{${C[ALERT]}}${I[GIT]} ${apex_git_branch} ${apex_git_op}%f"
+    else
+      out+="%F{${C[CYAN]}}${I[GIT]} ${apex_git_branch}%f"
+    fi
+  fi
+
+  [[ -n "$proj_sig" ]]        && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[MUTED]}}${proj_sig}%f"
+  [[ -n "$apex_venv_name" ]]  && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[CYAN]}}(${apex_venv_name})%f"
+  [[ -n "$apex_target_sig" ]] && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[CYAN]}}(${apex_target_sig})%f"
+
+  print -P "$out"
+
+  apex_prev_venv_name="$apex_venv_name"
+  apex_prev_target_sig="$apex_target_sig"
+  apex_prev_in_git="$apex_in_git"
+  apex_prev_git_branch="$apex_git_branch"
+  apex_prev_git_op="$apex_git_op"
+  apex_prev_proj_sig="$proj_sig"
+
+  apex_pwd_changed=0
+  apex_startup_done=1
+}
+
+# -----------------------------------------------------------------------------
+# 11) HOOKS
+# -----------------------------------------------------------------------------
+apex_preexec_hook() {
+  apex_has_run_cmd=1
+  apex_cmd_start=${EPOCHREALTIME:-$EPOCHSECONDS}
+  apex_last_cmd="$1"
+}
+
+apex_chpwd_hook() {
+  apex_pwd_changed=1
+}
+
+apex_precmd_hook() {
+  local ec=$?
+
+  apex_update_intel
+  apex_git_update
+
+  # Did a command actually run since the last prompt?
+  local ran=0
+  (( apex_has_run_cmd )) && ran=1
+
+  if (( ran )); then
+    local now=${EPOCHREALTIME:-$EPOCHSECONDS}
+    local -i ms
+    ms=$(( (now - apex_cmd_start) * 1000 ))
+
+    # Show time if: slow OR ops OR failed.
+    local dur=""
+    if (( ms >= ${APEX[SLOW_SOFT_MS]} )) || [[ "$apex_last_cmd" =~ ${APEX[OPS_RE]} ]] || (( ec != 0 )); then
+      dur="$(printf "%.2fs" $(( ms / 1000.0 )))"
+    fi
+
+    apex_radar_aar $ec "$apex_last_cmd" "$dur" $ms
+
+    apex_has_run_cmd=0
+
+    # Spacer between AAR and context burst / prompt.
+    print -r -- ""
+  fi
+
+  apex_radar_context_burst
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec apex_preexec_hook
+add-zsh-hook precmd  apex_precmd_hook
+add-zsh-hook chpwd   apex_chpwd_hook
+
+# -----------------------------------------------------------------------------
+# 12) PROMPT BUILD
+# -----------------------------------------------------------------------------
+build_prompt() {
+  local ec=$?
+
+  # Line 1: identity + territory (left)
+  print -n "$(apex_identity)"
+  print -n "$(apex_territory)"
+  print -n $'
+'
+
+  # Line 2: trigger posture
+  if (( EUID == 0 )); then
+    print -n "%F{${C[PURPLE]}}❯%f "
+  elif (( ec != 0 )); then
+    print -n "%F{${C[ALERT]}}❯%f "
+  else
+    print -n "%F{${C[CYAN]}}❯%f "
+  fi
+}
+
+PROMPT='$(build_prompt)'
+RPROMPT='$(build_rprompt)'