create-egregore 0.19.3 → 0.19.6

package/runtime/codex/bin/lib/greeting.sh

@@ -4,9 +4,8 @@
 # Renders the full session greeting:
 #   - ASCII art banner
 #   - Identity line (org/repo + user + branch)
-#   - "For you" section (handoffs, last activity)
-#   - "Around" section (team presence)
-#   - "Merged" section (PRs, implemented handoffs)
+#   - Momentum board (sessions, commits, handoffs, knowledge)
+#   - Pending questions signal
 #   - Health footer
 #   - Alias migration
 #   - Session context JSON (hidden, for Claude)
@@ -64,108 +63,24 @@ if [ "$ID_PADDING" -lt 1 ]; then ID_PADDING=1; fi
 printf "\n%s%*s%s\n" "$IDENTITY_LEFT" "$ID_PADDING" "" "$IDENTITY_RIGHT"
 echo "$SEPARATOR"
 
-# --- Shared rendering state ---
-TEAM_DATA=$(cat "$CTX_DIR/team" 2>/dev/null || echo "[]")
-TEAM_DATA_COUNT=$(echo "$TEAM_DATA" | jq 'length' 2>/dev/null || echo "0")
-NOW_RENDER=$(date +%s)
-ONLINE_THRESHOLD=7200  # 2 hours — considered "online"
-RECENCY_DAYS=3
-RECENCY_THRESHOLD=$((RECENCY_DAYS * 86400))
-TODAY_DATE=$(date +%Y-%m-%d)
-TODAY_MIDNIGHT=$(date -j -f "%Y-%m-%d" "$TODAY_DATE" +%s 2>/dev/null || \
-                 date -d "$TODAY_DATE" +%s 2>/dev/null || echo "$NOW_RENDER")
-# Column layout: 2(indent) + 2(dot+space) + 9(name) + 12(time) + 40(info) = 65
-MAX_INFO=40
-
-# --- Section 1: For you (always present) ---
-echo "  ◦ for you"
-ADDRESSED_RICH=$(cat "$CTX_DIR/addressed_rich" 2>/dev/null || echo "[]")
-ADDRESSED_COUNT=$(echo "$ADDRESSED_RICH" | jq 'length' 2>/dev/null || echo "0")
-
-# Handoffs addressed to you
-if [ "$ADDRESSED_COUNT" -gt 0 ] 2>/dev/null && [ "$ADDRESSED_COUNT" != "0" ]; then
-  echo "$ADDRESSED_RICH" | jq -r '.[] | "\(.author)\t\(.date)\t\(.topic)"' 2>/dev/null | while IFS=$'\t' read -r H_AUTHOR H_DATE H_TOPIC; do
-    [ -z "$H_AUTHOR" ] && continue
-    # Convert date to epoch (UTC) and compute calendar-day diff
-    H_DATE_ONLY="${H_DATE%%T*}"
-    H_EVENT_MIDNIGHT=$(date -j -f "%Y-%m-%d" "$H_DATE_ONLY" +%s 2>/dev/null || \
-                       date -d "$H_DATE_ONLY" +%s 2>/dev/null || echo "0")
-    H_CAL_DAYS=$(( (TODAY_MIDNIGHT - H_EVENT_MIDNIGHT) / 86400 ))
-    # Skip if older than recency threshold
-    [ "$H_CAL_DAYS" -gt "$RECENCY_DAYS" ] 2>/dev/null && continue
-    H_NAME=$(echo "$H_AUTHOR" | awk '{print tolower($1)}')
-    if [ ${#H_NAME} -gt 8 ]; then H_NAME="${H_NAME:0:8}"; fi
-    # Online status from team presence data
-    H_SEEN_EPOCH=$(echo "$TEAM_DATA" | jq -r --arg n "$H_NAME" '[.[] | select((.name | ascii_downcase) == $n) | .last_seen_sort] | .[0] // 0' 2>/dev/null || echo "0")
-    if [ "$H_SEEN_EPOCH" -gt 0 ] 2>/dev/null && [ $(( NOW_RENDER - H_SEEN_EPOCH )) -lt $ONLINE_THRESHOLD ] 2>/dev/null; then
-      DOT="●"
-    else
-      DOT="○"
-    fi
-    # Calendar-day relative label
-    if [ "$H_CAL_DAYS" -le 0 ] 2>/dev/null; then H_AGO="today"
-    elif [ "$H_CAL_DAYS" -eq 1 ] 2>/dev/null; then H_AGO="yesterday"
-    else H_AGO="${H_CAL_DAYS}d ago"
-    fi
-    if [ ${#H_TOPIC} -gt $MAX_INFO ]; then H_TOPIC="${H_TOPIC:0:$((MAX_INFO - 1))}…"; fi
-    printf "  %s %-9s%-12s%s\n" "$DOT" "$H_NAME" "$H_AGO" "$H_TOPIC"
-  done
-fi
-
-# Fallback: last activity if no handoffs
-if [ "$ADDRESSED_COUNT" = "0" ] || [ -z "$ADDRESSED_COUNT" ]; then
-  LAST_ACTIVITY=$(cat "$CTX_DIR/activity" 2>/dev/null || echo "")
-  if [ -n "$LAST_ACTIVITY" ]; then
-    LA_TIME=$(echo "$LAST_ACTIVITY" | cut -d'|' -f1)
-    # Compact relative time: "20 hours ago" → "20h ago", "3 days ago" → "3d ago"
-    LA_TIME=$(echo "$LA_TIME" | sed 's/ hours\{0,1\} ago/h ago/; s/ days\{0,1\} ago/d ago/; s/ minutes\{0,1\} ago/m ago/; s/ weeks\{0,1\} ago/w ago/; s/ months\{0,1\} ago/mo ago/')
-    LA_MSG=$(echo "$LAST_ACTIVITY" | cut -d'|' -f2-)
-    if [ ${#LA_MSG} -gt $MAX_INFO ]; then LA_MSG="${LA_MSG:0:$((MAX_INFO - 1))}…"; fi
-    printf "  ◇ %-9s%-12s%s\n" "you" "$LA_TIME" "$LA_MSG"
-  fi
-fi
-
-echo ""
-# --- Section 2: Around (team presence with online status) ---
-if [ "$TEAM_DATA_COUNT" -gt 0 ] 2>/dev/null && [ "$TEAM_DATA_COUNT" != "0" ]; then
-  echo "  ◦ around"
-  # Presence roster with online/offline dots (hide inactive >3 days)
-  STALE_THRESHOLD=$((RECENCY_DAYS * 86400))
-  echo "$TEAM_DATA" | jq -r '.[] | "\(.name)\t\(.last_seen_sort)\t\(.last_seen)\t\(.branches | join(", "))"' 2>/dev/null | while IFS=$'\t' read -r P_NAME P_EPOCH P_SEEN P_BRANCHES; do
-    [ -z "$P_NAME" ] && continue
-    # Skip if no recent activity (within recency window)
-    if [ "$P_EPOCH" -le 0 ] 2>/dev/null; then
-      continue
-    elif [ $(( NOW_RENDER - P_EPOCH )) -ge $STALE_THRESHOLD ] 2>/dev/null; then
-      continue
-    fi
-    if [ ${#P_NAME} -gt 8 ]; then P_NAME="${P_NAME:0:8}"; fi
-    # Online: last seen within threshold
-    if [ $(( NOW_RENDER - P_EPOCH )) -lt $ONLINE_THRESHOLD ] 2>/dev/null; then
-      DOT="●"
-    else
-      DOT="○"
-    fi
-    if [ ${#P_BRANCHES} -gt $MAX_INFO ]; then
-      P_BRANCHES="${P_BRANCHES:0:$((MAX_INFO - 9))}... +more"
-    fi
-    printf "  %s %-9s%-12s%s\n" "$DOT" "$P_NAME" "$P_SEEN" "$P_BRANCHES"
-  done
-fi
-
-# --- Section 3: Recently merged PRs + implemented handoffs ---
-LIFECYCLE_JSON=$(cat "$CTX_DIR/lifecycle" 2>/dev/null || echo '{}')
-MERGED_COUNT=$(echo "$LIFECYCLE_JSON" | jq '.merged_prs.values // [] | length' 2>/dev/null || echo "0")
-IMPL_COUNT=$(echo "$LIFECYCLE_JSON" | jq '.implemented_handoffs.values // [] | length' 2>/dev/null || echo "0")
-
-if [ "$MERGED_COUNT" -gt 0 ] 2>/dev/null || [ "$IMPL_COUNT" -gt 0 ] 2>/dev/null; then
-  echo ""
-  echo "  ◦ merged"
-  if [ "$MERGED_COUNT" -gt 0 ] 2>/dev/null; then
-    echo "$LIFECYCLE_JSON" | jq -r '.merged_prs.values[]? // empty | "  ✓ PR #\(.[0]) \(.[1])"' 2>/dev/null || true
+# --- Momentum board ---
+source "$SCRIPT_DIR/bin/lib/metrics.sh"
+_render_momentum_board
+
+# Pending questions addressed to you (one summary line — /answer to engage)
+PENDING_Q=$(cat "$CTX_DIR/pending_questions" 2>/dev/null || echo "[]")
+PENDING_Q_COUNT=$(echo "$PENDING_Q" | jq 'length' 2>/dev/null || echo "0")
+if [ "$PENDING_Q_COUNT" -gt 0 ] 2>/dev/null && [ "$PENDING_Q_COUNT" != "0" ]; then
+  PQ_SENDERS=$(echo "$PENDING_Q" | jq -r '[.[].from] | unique | join(", ")' 2>/dev/null)
+  if [ "$PENDING_Q_COUNT" = "1" ]; then
+    PQ_NOUN="question"
+  else
+    PQ_NOUN="questions"
   fi
-  if [ "$IMPL_COUNT" -gt 0 ] 2>/dev/null; then
-    echo "$LIFECYCLE_JSON" | jq -r '.implemented_handoffs.values[]? // empty | "  ✓ \(.[1]) worked on your handoff"' 2>/dev/null || true
+  if [ -n "$PQ_SENDERS" ]; then
+    printf "  ◐ %s pending %s from %s — /answer to engage\n" "$PENDING_Q_COUNT" "$PQ_NOUN" "$PQ_SENDERS"
+  else
+    printf "  ◐ %s pending %s — /answer to engage\n" "$PENDING_Q_COUNT" "$PQ_NOUN"
   fi
 fi
 
@@ -256,6 +171,10 @@ if [ -n "${BOARD_URL:-}" ]; then
   printf "  ◆ %s (board)\n" "$BOARD_URL"
 fi
 
+if [ -n "${LOOM_DOCTOR_BRIEF:-}" ]; then
+  printf "  %s\n" "$LOOM_DOCTOR_BRIEF"
+fi
+
 # Framework updates come through PRs to develop — no separate auto-update channel.
 # The develop sync above already keeps framework files current.
 # Use /update for manual upstream pulls when needed.
@@ -288,6 +207,12 @@ CONTEXT_TEAM=$(cat "$CTX_DIR/team" 2>/dev/null || echo "[]")
 CONTEXT_SOUL=$(cat "$CTX_DIR/soul_summary" 2>/dev/null || echo "")
 CONTEXT_LIFECYCLE=$(cat "$CTX_DIR/lifecycle" 2>/dev/null || echo '{"merged_prs":[],"implemented_handoffs":[]}')
 CONTEXT_PULSE=$(cat "$CTX_DIR/pulse_brief" 2>/dev/null || echo '{}')
+if [ -f "$CTX_DIR/metrics" ]; then
+  CONTEXT_METRICS=$(jq -c . "$CTX_DIR/metrics" 2>/dev/null || echo "{}")
+  [ -n "$CONTEXT_METRICS" ] || CONTEXT_METRICS="{}"
+else
+  CONTEXT_METRICS="{}"
+fi
 
 # --- Write compact subagent context cache (reuses already-gathered data) ---
 SUBAGENT_CTX="/tmp/egregore-subagent-ctx-${EGREGORE_SESSION_ID}.txt"
@@ -332,6 +257,7 @@ cat << CTXEOF
   "team_recent_memory": $CONTEXT_TEAM,
   "soul_self_summary": "$CONTEXT_SOUL",
   "lifecycle": $CONTEXT_LIFECYCLE,
+  "momentum": $CONTEXT_METRICS,
   "pulse": $CONTEXT_PULSE
 }
 -->

package/runtime/codex/bin/lib/metrics.sh

@@ -0,0 +1,374 @@
+# shellcheck shell=bash
+# metrics.sh — Momentum metrics gathering and rendering for startup greetings.
+#
+# Function-only library. Safe to source from bash or zsh.
+
+_metrics_zero_json() {
+  printf '%s\n' '{"source":"local","sessions":{"buckets":[0,0,0,0,0],"week":0,"prev":0,"all":0},"commits":{"buckets":[0,0,0,0,0],"week":0,"prev":0,"authors":0,"all":0},"handoffs":{"buckets":[0,0,0,0,0],"week":0,"prev":0,"avg_resolution_days":null,"all":0},"knowledge":{"buckets":[0,0,0,0,0],"week":0,"prev":0,"all":0},"members":{"active":0,"total":0}}'
+}
+
+_num() {
+  awk '{n=$1+0; if (n < 0) n=0; printf "%d\n", n}' 2>/dev/null <<EOF
+$1
+EOF
+}
+
+_num_float() {
+  awk '{n=$1+0; if (n < 0) n=0; printf "%.1f\n", n}' 2>/dev/null <<EOF
+$1
+EOF
+}
+
+_normalize_buckets() {
+  set -- $(printf '%s' "$1")
+  printf '%d %d %d %d %d\n' "$(_num "${1:-0}")" "$(_num "${2:-0}")" "$(_num "${3:-0}")" "$(_num "${4:-0}")" "$(_num "${5:-0}")"
+}
+
+_buckets_json() {
+  set -- $(printf '%s' "$(_normalize_buckets "$1")")
+  jq -n --argjson a "$(_num "${1:-0}")" --argjson b "$(_num "${2:-0}")" \
+    --argjson c "$(_num "${3:-0}")" --argjson d "$(_num "${4:-0}")" \
+    --argjson e "$(_num "${5:-0}")" '[$a,$b,$c,$d,$e]' 2>/dev/null || echo '[0,0,0,0,0]'
+}
+
+_bucket_week() {
+  set -- $(printf '%s' "$(_normalize_buckets "$1")")
+  _num "${5:-0}"
+}
+
+_bucket_prev() {
+  set -- $(printf '%s' "$(_normalize_buckets "$1")")
+  _num "${4:-0}"
+}
+
+_spark() {
+  local values max out v idx glyph
+  values="${1:-0 0 0 0 0}"
+  max=0
+  set -- $(printf '%s' "$values")
+  [ "$#" -eq 0 ] && set -- 0 0 0 0 0
+  for v in "$@"; do
+    v=$(_num "$v")
+    [ "$v" -gt "$max" ] 2>/dev/null && max="$v"
+  done
+  out=""
+  for v in "$@"; do
+    v=$(_num "$v")
+    if [ "$max" -le 0 ] 2>/dev/null; then
+      idx=0
+    else
+      idx=$(( (v * 7) / max ))
+    fi
+    # Select glyphs explicitly: substring slicing can split UTF-8 characters
+    # under Bash 3.2 or a C locale.
+    case "$idx" in
+      0) glyph="▁" ;;
+      1) glyph="▂" ;;
+      2) glyph="▃" ;;
+      3) glyph="▄" ;;
+      4) glyph="▅" ;;
+      5) glyph="▆" ;;
+      6) glyph="▇" ;;
+      *) glyph="█" ;;
+    esac
+    out="${out}${glyph}"
+  done
+  printf '%s\n' "$out"
+}
+
+_pct_delta() {
+  local cur prev pct
+  cur=$(_num "${1:-0}")
+  prev=$(_num "${2:-0}")
+  [ "$prev" -le 0 ] 2>/dev/null && return 0
+  pct=$(( ((cur - prev) * 100) / prev ))
+  if [ "$pct" -gt 0 ] 2>/dev/null; then
+    printf '↑ %d%%\n' "$pct"
+  elif [ "$pct" -lt 0 ] 2>/dev/null; then
+    printf '↓ %d%%\n' "$(( -pct ))"
+  else
+    printf '→ 0%%\n'
+  fi
+}
+
+_commafy() {
+  awk '
+    function comma(s, out, sign) {
+      s = int(s + 0)
+      if (s < 0) { sign = "-"; s = -s } else { sign = "" }
+      s = sprintf("%d", s)
+      out = ""
+      while (length(s) > 3) {
+        out = "," substr(s, length(s) - 2, 3) out
+        s = substr(s, 1, length(s) - 3)
+      }
+      return sign s out
+    }
+    { print comma($1) }
+  ' 2>/dev/null <<EOF
+${1:-0}
+EOF
+}
+
+_git_added_buckets() {
+  local repo now paths
+  repo="$1"
+  shift
+  now=$(date +%s)
+  if [ -d "$repo" ] || [ -f "$repo" ]; then
+    git -C "$repo" log --diff-filter=A --since="35 days ago" --format='%ct' -- "$@" 2>/dev/null | \
+      awk -v now="$now" '
+        BEGIN { for (i=0;i<5;i++) b[i]=0 }
+        /^[0-9]+$/ {
+          days = int((now - $1) / 86400)
+          idx = 4 - int(days / 7)
+          if (idx >= 0 && idx < 5) b[idx]++
+        }
+        END { printf "%d %d %d %d %d\n", b[0], b[1], b[2], b[3], b[4] }
+      ' 2>/dev/null || echo "0 0 0 0 0"
+  else
+    echo "0 0 0 0 0"
+  fi
+}
+
+_find_count_md() {
+  find -L "$@" -name '*.md' ! -name 'index*' 2>/dev/null | wc -l | awk '{print $1+0}' 2>/dev/null || echo 0
+}
+
+_metrics_gather() {
+  local _root _mem _scratch _API_URL _API_KEY _connected
+  _root="${SCRIPT_DIR:-$PWD}"
+  _mem="$_root/memory"
+  _scratch=$(mktemp -d 2>/dev/null || mktemp -d -t egregore-metrics)
+  _API_URL=$(jq -r '.api_url // empty' "$_root/egregore.json" 2>/dev/null || echo "")
+  _API_KEY=$(grep '^EGREGORE_API_KEY=' "${ENV_FILE:-$_root/.env}" 2>/dev/null | cut -d'=' -f2- || true)
+  _connected=false
+  [ -n "$_API_URL" ] && [ -n "$_API_KEY" ] && _connected=true
+
+  (
+    if [ "$_connected" = true ]; then
+      raw=$(bash "$_root/bin/graph.sh" query "MATCH (s:Session) WHERE date(s.date) >= date() - duration('P35D')
+OPTIONAL MATCH (s)-[:BY]->(p:Person)
+WITH duration.inDays(date(s.date), date()).days / 7 AS weeksAgo,
+     count(s) AS sessions, count(DISTINCT p) AS people
+RETURN weeksAgo, sessions, people ORDER BY weeksAgo" 2>/dev/null || echo "")
+      printf '%s' "$raw" | jq -r '
+        (.values // []) as $v
+        | if ($v|length) == 0 then empty else
+          reduce $v[] as $r ({b:[0,0,0,0,0], a:0, ok:0};
+            ($r[0] // 99 | tonumber? // 99) as $w
+            | if $w >= 0 and $w <= 4 then
+                .b[4 - $w] = (($r[1] // 0 | tonumber? // 0) | floor)
+                | .ok = 1
+                | if $w == 0 then .a = (($r[2] // 0 | tonumber? // 0) | floor) else . end
+              else . end)
+          | "\(.b|join(" "))|\(.a)|\(.ok)"
+          end
+      ' 2>/dev/null || echo "0 0 0 0 0|0|0"
+    else
+      echo "0 0 0 0 0|0|0"
+    fi
+  ) > "$_scratch/graph_sessions" 2>/dev/null &
+
+  (
+    if [ "$_connected" = true ]; then
+      raw=$(bash "$_root/bin/graph.sh" query "MATCH (s:Session) WITH count(s) AS totalSessions MATCH (p:Person)-[:MEMBER_OF]->(:Org) RETURN totalSessions, count(DISTINCT p) AS members" 2>/dev/null || echo "")
+      total=$(printf '%s' "$raw" | jq -r '.values[0][0] // 0' 2>/dev/null || echo 0)
+      members=$(printf '%s' "$raw" | jq -r '.values[0][1] // 0' 2>/dev/null || echo 0)
+      if [ "$(_num "$members")" -eq 0 ] 2>/dev/null; then
+        raw2=$(bash "$_root/bin/graph.sh" query "MATCH (p:Person) RETURN count(p)" 2>/dev/null || echo "")
+        members=$(printf '%s' "$raw2" | jq -r '.values[0][0] // 0' 2>/dev/null || echo 0)
+      fi
+      printf '%s|%s\n' "$(_num "$total")" "$(_num "$members")"
+    else
+      echo "0|0"
+    fi
+  ) > "$_scratch/graph_totals" 2>/dev/null &
+
+  (
+    if [ "$_connected" = true ]; then
+      raw=$(bash "$_root/bin/graph.sh" query "MATCH (s:Session)-[:HANDED_TO]->(:Person)
+WHERE s.handoffStatus = 'done' AND date(s.date) >= date() - duration('P30D')
+  AND s.handoffReadDate IS NOT NULL
+WITH duration.inDays(date(s.date), date(s.handoffReadDate)).days AS d
+RETURN avg(d) AS avgDays, count(*) AS n" 2>/dev/null || echo "")
+      avg=$(printf '%s' "$raw" | jq -r '.values[0][0] // empty' 2>/dev/null || echo "")
+      n=$(printf '%s' "$raw" | jq -r '.values[0][1] // 0' 2>/dev/null || echo 0)
+      if [ "$(_num "$n")" -gt 0 ] 2>/dev/null && [ -n "$avg" ]; then _num_float "$avg"; else echo ""; fi
+    else
+      echo ""
+    fi
+  ) > "$_scratch/handoff_resolution" 2>/dev/null &
+
+  (
+    buckets=$(_git_added_buckets "$_mem" sessions wraps)
+    all=$(_find_count_md "$_root/memory/sessions" "$_root/memory/wraps")
+    printf '%s|%s\n' "$buckets" "$all"
+  ) > "$_scratch/local_sessions" 2>/dev/null &
+
+  (
+    now=$(date +%s)
+    if [ -d "$_mem" ] || [ -f "$_mem" ]; then
+      git -C "$_mem" log --since="35 days ago" --format='%ct|%ae' 2>/dev/null | \
+        awk -F'|' -v now="$now" '
+          BEGIN { for (i=0;i<5;i++) b[i]=0 }
+          {
+            days = int((now - $1) / 86400)
+            idx = 4 - int(days / 7)
+            if (idx >= 0 && idx < 5) {
+              b[idx]++
+              if (idx == 4 && $2 != "") a[$2]=1
+            }
+          }
+          END {
+            n=0; for (k in a) n++
+            printf "%d %d %d %d %d|%d\n", b[0], b[1], b[2], b[3], b[4], n
+          }
+        ' 2>/dev/null || echo "0 0 0 0 0|0"
+    else
+      echo "0 0 0 0 0|0"
+    fi
+  ) > "$_scratch/commits" 2>/dev/null &
+
+  (
+    if [ -d "$_mem" ] || [ -f "$_mem" ]; then git -C "$_mem" rev-list --count HEAD 2>/dev/null || echo 0; else echo 0; fi
+  ) > "$_scratch/commits_all" 2>/dev/null &
+
+  (
+    buckets=$(_git_added_buckets "$_mem" handoffs)
+    all=$(_find_count_md "$_root/memory/handoffs")
+    printf '%s|%s\n' "$buckets" "$all"
+  ) > "$_scratch/handoffs" 2>/dev/null &
+
+  (
+    buckets=$(_git_added_buckets "$_mem" knowledge/decisions knowledge/findings knowledge/patterns)
+    all=$(_find_count_md "$_root/memory/knowledge/decisions" "$_root/memory/knowledge/findings" "$_root/memory/knowledge/patterns")
+    printf '%s|%s\n' "$buckets" "$all"
+  ) > "$_scratch/knowledge" 2>/dev/null &
+
+  (
+    _find_count_md "$_root/memory/people"
+  ) > "$_scratch/members_total_local" 2>/dev/null &
+
+  wait
+
+  gs=$(cat "$_scratch/graph_sessions" 2>/dev/null || echo "0 0 0 0 0|0|0")
+  gt=$(cat "$_scratch/graph_totals" 2>/dev/null || echo "0|0")
+  lsess=$(cat "$_scratch/local_sessions" 2>/dev/null || echo "0 0 0 0 0|0")
+  commits=$(cat "$_scratch/commits" 2>/dev/null || echo "0 0 0 0 0|0")
+  handoffs=$(cat "$_scratch/handoffs" 2>/dev/null || echo "0 0 0 0 0|0")
+  knowledge=$(cat "$_scratch/knowledge" 2>/dev/null || echo "0 0 0 0 0|0")
+
+  graph_valid=$(_num "$(printf '%s' "$gs" | awk -F'|' '{print $3}')")
+  if [ "$graph_valid" -gt 0 ] 2>/dev/null; then
+    source_name="graph"
+    session_buckets=$(_normalize_buckets "$(printf '%s' "$gs" | awk -F'|' '{print $1}')")
+    session_all=$(_num "$(printf '%s' "$gt" | awk -F'|' '{print $1}')")
+    members_active=$(_num "$(printf '%s' "$gs" | awk -F'|' '{print $2}')")
+    members_total=$(_num "$(printf '%s' "$gt" | awk -F'|' '{print $2}')")
+    if [ "$session_all" -le 0 ] 2>/dev/null; then
+      session_all=$(_num "$(printf '%s' "$lsess" | awk -F'|' '{print $2}')")
+    fi
+    if [ "$members_total" -le 0 ] 2>/dev/null; then
+      members_total=$(_num "$(cat "$_scratch/members_total_local" 2>/dev/null || echo 0)")
+    fi
+  else
+    source_name="local"
+    session_buckets=$(_normalize_buckets "$(printf '%s' "$lsess" | awk -F'|' '{print $1}')")
+    session_all=$(_num "$(printf '%s' "$lsess" | awk -F'|' '{print $2}')")
+    members_active=$(_num "$(printf '%s' "$commits" | awk -F'|' '{print $2}')")
+    members_total=$(_num "$(cat "$_scratch/members_total_local" 2>/dev/null || echo 0)")
+  fi
+
+  commit_buckets=$(_normalize_buckets "$(printf '%s' "$commits" | awk -F'|' '{print $1}')")
+  handoff_buckets=$(_normalize_buckets "$(printf '%s' "$handoffs" | awk -F'|' '{print $1}')")
+  knowledge_buckets=$(_normalize_buckets "$(printf '%s' "$knowledge" | awk -F'|' '{print $1}')")
+  avg_res=$(cat "$_scratch/handoff_resolution" 2>/dev/null || echo "")
+
+  session_buckets_json=$(_buckets_json "$session_buckets")
+  commit_buckets_json=$(_buckets_json "$commit_buckets")
+  handoff_buckets_json=$(_buckets_json "$handoff_buckets")
+  knowledge_buckets_json=$(_buckets_json "$knowledge_buckets")
+
+  if [ -n "$avg_res" ]; then
+    jq -n --arg source "$source_name" \
+      --argjson sb "$session_buckets_json" --argjson sw "$(_bucket_week "$session_buckets")" --argjson sp "$(_bucket_prev "$session_buckets")" --argjson sall "$session_all" \
+      --argjson cb "$commit_buckets_json" --argjson cw "$(_bucket_week "$commit_buckets")" --argjson cp "$(_bucket_prev "$commit_buckets")" --argjson ca "$(_num "$(printf '%s' "$commits" | awk -F'|' '{print $2}')")" --argjson call "$(_num "$(cat "$_scratch/commits_all" 2>/dev/null || echo 0)")" \
+      --argjson hb "$handoff_buckets_json" --argjson hw "$(_bucket_week "$handoff_buckets")" --argjson hp "$(_bucket_prev "$handoff_buckets")" --argjson havg "$avg_res" --argjson hall "$(_num "$(printf '%s' "$handoffs" | awk -F'|' '{print $2}')")" \
+      --argjson kb "$knowledge_buckets_json" --argjson kw "$(_bucket_week "$knowledge_buckets")" --argjson kp "$(_bucket_prev "$knowledge_buckets")" --argjson kall "$(_num "$(printf '%s' "$knowledge" | awk -F'|' '{print $2}')")" \
+      --argjson ma "$members_active" --argjson mt "$members_total" \
+      '{source:$source,sessions:{buckets:$sb,week:$sw,prev:$sp,all:$sall},commits:{buckets:$cb,week:$cw,prev:$cp,authors:$ca,all:$call},handoffs:{buckets:$hb,week:$hw,prev:$hp,avg_resolution_days:$havg,all:$hall},knowledge:{buckets:$kb,week:$kw,prev:$kp,all:$kall},members:{active:$ma,total:$mt}}' 2>/dev/null || _metrics_zero_json
+  else
+    jq -n --arg source "$source_name" \
+      --argjson sb "$session_buckets_json" --argjson sw "$(_bucket_week "$session_buckets")" --argjson sp "$(_bucket_prev "$session_buckets")" --argjson sall "$session_all" \
+      --argjson cb "$commit_buckets_json" --argjson cw "$(_bucket_week "$commit_buckets")" --argjson cp "$(_bucket_prev "$commit_buckets")" --argjson ca "$(_num "$(printf '%s' "$commits" | awk -F'|' '{print $2}')")" --argjson call "$(_num "$(cat "$_scratch/commits_all" 2>/dev/null || echo 0)")" \
+      --argjson hb "$handoff_buckets_json" --argjson hw "$(_bucket_week "$handoff_buckets")" --argjson hp "$(_bucket_prev "$handoff_buckets")" --argjson hall "$(_num "$(printf '%s' "$handoffs" | awk -F'|' '{print $2}')")" \
+      --argjson kb "$knowledge_buckets_json" --argjson kw "$(_bucket_week "$knowledge_buckets")" --argjson kp "$(_bucket_prev "$knowledge_buckets")" --argjson kall "$(_num "$(printf '%s' "$knowledge" | awk -F'|' '{print $2}')")" \
+      --argjson ma "$members_active" --argjson mt "$members_total" \
+      '{source:$source,sessions:{buckets:$sb,week:$sw,prev:$sp,all:$sall},commits:{buckets:$cb,week:$cw,prev:$cp,authors:$ca,all:$call},handoffs:{buckets:$hb,week:$hw,prev:$hp,avg_resolution_days:null,all:$hall},knowledge:{buckets:$kb,week:$kw,prev:$kp,all:$kall},members:{active:$ma,total:$mt}}' 2>/dev/null || _metrics_zero_json
+  fi
+  rm -rf "$_scratch" 2>/dev/null || true
+}
+
+_metrics_read() {
+  local file filter fallback
+  file="${CTX_DIR:-}/metrics"
+  filter="$1"
+  fallback="$2"
+  if [ -f "$file" ]; then
+    jq -r "$filter" "$file" 2>/dev/null || echo "$fallback"
+  else
+    echo "$fallback"
+  fi
+}
+
+_render_momentum_board() {
+  local separator line_width header_left header_right pad
+  local sb sw sp sall cb cw ca call hb hw havg hall kb kw kall active total
+  local sdelta sann cann hann kann know_week
+  separator="${SEPARATOR:-  ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄}"
+  line_width="${LINE_WIDTH:-67}"
+
+  sb=$(_metrics_read '(.sessions.buckets // [0,0,0,0,0]) | .[0:5] | map(. // 0) | join(" ")' "0 0 0 0 0")
+  sw=$(_num "$(_metrics_read '.sessions.week // 0' "0")")
+  sp=$(_num "$(_metrics_read '.sessions.prev // 0' "0")")
+  sall=$(_num "$(_metrics_read '.sessions.all // 0' "0")")
+  cb=$(_metrics_read '(.commits.buckets // [0,0,0,0,0]) | .[0:5] | map(. // 0) | join(" ")' "0 0 0 0 0")
+  cw=$(_num "$(_metrics_read '.commits.week // 0' "0")")
+  ca=$(_num "$(_metrics_read '.commits.authors // 0' "0")")
+  call=$(_num "$(_metrics_read '.commits.all // 0' "0")")
+  hb=$(_metrics_read '(.handoffs.buckets // [0,0,0,0,0]) | .[0:5] | map(. // 0) | join(" ")' "0 0 0 0 0")
+  hw=$(_num "$(_metrics_read '.handoffs.week // 0' "0")")
+  havg=$(_metrics_read '.handoffs.avg_resolution_days // empty' "")
+  hall=$(_num "$(_metrics_read '.handoffs.all // 0' "0")")
+  kb=$(_metrics_read '(.knowledge.buckets // [0,0,0,0,0]) | .[0:5] | map(. // 0) | join(" ")' "0 0 0 0 0")
+  kw=$(_num "$(_metrics_read '.knowledge.week // 0' "0")")
+  kall=$(_num "$(_metrics_read '.knowledge.all // 0' "0")")
+  active=$(_num "$(_metrics_read '.members.active // 0' "0")")
+  total=$(_num "$(_metrics_read '.members.total // 0' "0")")
+
+  header_left="  ◦ momentum · this week"
+  header_right="${active} of ${total} active"
+  pad=$((line_width - ${#header_left} - ${#header_right}))
+  [ "$pad" -lt 1 ] && pad=1
+  printf "%s%*s%s\n" "$header_left" "$pad" "" "$header_right"
+
+  sdelta=$(_pct_delta "$sw" "$sp")
+  sann=""
+  [ -n "$sdelta" ] && sann="${sdelta} vs last week"
+  cann=""
+  if [ "$ca" -gt 0 ] 2>/dev/null; then
+    if [ "$ca" -eq 1 ] 2>/dev/null; then cann="1 author"; else cann="${ca} authors"; fi
+  fi
+  hann=""
+  if [ -n "$havg" ]; then hann="$(_num_float "$havg")d avg resolution"; fi
+  kann="$(_commafy "$kall") artifacts total"
+  know_week="+${kw}"
+
+  printf "  %-11s%5s   5-week %s   %s\n\n" "sessions" "$sw" "$(_spark "$sb")" "$sann"
+  printf "  %-11s%5s   5-week %s   %s\n\n" "commits" "$cw" "$(_spark "$cb")" "$cann"
+  printf "  %-11s%5s   5-week %s   %s\n\n" "handoffs" "$hw" "$(_spark "$hb")" "$hann"
+  printf "  %-11s%5s   5-week %s   %s\n" "knowledge" "$know_week" "$(_spark "$kb")" "$kann"
+  echo "$separator"
+  printf "  %s sessions · %s commits · %s handoffs all-time\n" "$(_commafy "$sall")" "$(_commafy "$call")" "$(_commafy "$hall")"
+}

package/runtime/codex/bin/publish-artifact.sh

@@ -33,6 +33,7 @@ DESCRIPTION=""
 ARTIFACT_ID=""
 RAW_HTML=0
 SKIP_REFERENCES=0
+PAIR=""
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -40,6 +41,7 @@ while [[ $# -gt 0 ]]; do
     --author) AUTHOR="$2"; shift 2 ;;
     --description) DESCRIPTION="$2"; shift 2 ;;
     --id) ARTIFACT_ID="$2"; shift 2 ;;
+    --pair) PAIR="$2"; shift 2 ;;
     --raw-html) RAW_HTML=1; shift ;;
     --no-references) SKIP_REFERENCES=1; shift ;;
     *)
@@ -72,6 +74,7 @@ fi
 if [ -f "$SCRIPT_DIR/.env" ]; then
   EGREGORE_API_URL="${EGREGORE_API_URL:-$(grep '^EGREGORE_API_URL=' "$SCRIPT_DIR/.env" 2>/dev/null | cut -d'=' -f2- || true)}"
   EGREGORE_API_KEY="${EGREGORE_API_KEY:-$(grep '^EGREGORE_API_KEY=' "$SCRIPT_DIR/.env" 2>/dev/null | cut -d'=' -f2- || true)}"
+  EGREGORE_USE_PUBLISHED="${EGREGORE_USE_PUBLISHED:-$(grep '^EGREGORE_USE_PUBLISHED=' "$SCRIPT_DIR/.env" 2>/dev/null | cut -d'=' -f2- || true)}"
 fi
 
 API_URL="${EGREGORE_API_URL:-$(jq -r '.api_url // empty' "$CONFIG" 2>/dev/null)}"
@@ -79,9 +82,33 @@ API_KEY="${EGREGORE_API_KEY:-}"
 ORG_SLUG="$(jq -r '.slug // empty' "$CONFIG" 2>/dev/null)"
 VIEW_BASE="https://egregore.xyz/view"
 
+# Resolve "use published renderer" from env first, then egregore.json. The
+# env var lets individuals override per-shell; egregore.json lets an
+# instance (e.g. the upstream dev repo) opt in for every teammate.
+if [ -z "${EGREGORE_USE_PUBLISHED:-}" ]; then
+  CONFIG_USE_PUBLISHED="$(jq -r '.prefer_published_artifacts // empty' "$CONFIG" 2>/dev/null)"
+  if [ "$CONFIG_USE_PUBLISHED" = "true" ]; then
+    EGREGORE_USE_PUBLISHED=1
+  fi
+fi
+
 # Public relay for OSS share endpoint
 RELAY_URL="https://egregore-production-55f2.up.railway.app"
 
+# --- Artifact hosting off-switch (compliance / privacy) ---
+# An instance can disable ALL egregore.xyz publishing via `bin/settings.sh hosting off`
+# (sets features.publishing=false). Absent/true means ON, so existing instances are
+# unaffected. We bail BEFORE any render or upload so "off" truly does nothing and costs
+# nothing. Exit 3 is distinct from usage errors; fire-and-forget callers ignore it.
+# NOTE: test `!= false`, not jq's `// "true"` — `//` treats an explicit `false` as empty
+# and would return the default, silently defeating the off-switch.
+PUBLISHING_ENABLED="$(jq -r 'if .features.publishing == false then "false" else "true" end' "$CONFIG" 2>/dev/null || echo "true")"
+if [ "$PUBLISHING_ENABLED" = "false" ]; then
+  echo "Artifact hosting is off for this egregore (features.publishing=false); nothing uploaded." >&2
+  echo "Turn it on with: bin/settings.sh hosting on   (or: egregore settings → Hosting)." >&2
+  exit 3
+fi
+
 # --- Prepare HTML ---
 TMP_HTML="/tmp/egregore-artifacts/publish-$$.html"
 mkdir -p /tmp/egregore-artifacts
@@ -98,13 +125,21 @@ else
   if [ -n "$API_KEY" ] && [ -n "$ORG_SLUG" ]; then
     RENDER_ARGS+=(--org-slug "$ORG_SLUG" --view-base "$VIEW_BASE")
   fi
+  # Palette family (meridian default | agronomic | sovereign). Role-token driven,
+  # so it themes any composed artifact with no extra CSS.
+  if [ -n "$PAIR" ]; then
+    RENDER_ARGS+=(--pair "$PAIR")
+  fi
 
   # Prefer the in-repo package copy when it's present AND its dependencies
   # have been installed — that way local edits to packages/egregore-artifacts
   # are exercised without waiting for an npm release. Fall back to the
   # published `npx egregore-artifacts` otherwise.
+  # Set EGREGORE_USE_PUBLISHED=1 to force the npm-published renderer even
+  # when a local install is present — useful in the upstream dev repo to
+  # dogfood what teammates and OSS users actually run.
   LOCAL_CLI="$SCRIPT_DIR/packages/egregore-artifacts/bin/cli.js"
-  if [ -f "$LOCAL_CLI" ] && [ -d "$SCRIPT_DIR/packages/egregore-artifacts/node_modules/react" ]; then
+  if [ "${EGREGORE_USE_PUBLISHED:-0}" != "1" ] && [ -f "$LOCAL_CLI" ] && [ -d "$SCRIPT_DIR/packages/egregore-artifacts/node_modules/react" ]; then
     if ! node "$LOCAL_CLI" "${RENDER_ARGS[@]}" >/dev/null 2>&1; then
       exit 0
     fi
@@ -158,6 +193,13 @@ if [ -n "$RESPONSE" ]; then
   URL=$(echo "$RESPONSE" | jq -r '.url // empty' 2>/dev/null)
   if [ -n "$URL" ]; then
     echo "$URL"
+    # Register in the local artifact registry (memory/artifacts/) so this hosted
+    # artifact is findable by CONTENT, not just name — grep/ls (Claude Code /
+    # Codex, OSS), and search + graph (paid). Never fatal to the publish.
+    bash "$SCRIPT_DIR/bin/artifact-register.sh" \
+      --id "$ARTIFACT_ID" --url "$URL" --type "$TYPE" --title "$TITLE" \
+      --author "$AUTHOR" --source "$FILE" --description "$DESCRIPTION" \
+      >/dev/null 2>&1 || true
   fi
 fi