create-egregore 0.17.3 → 0.18.0

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

@@ -0,0 +1,144 @@
+#!/bin/bash
+set -uo pipefail
+
+# publish-references.sh — Depth-1 auto-publish for referenced memory files.
+#
+# Usage: publish-references.sh <source-markdown-file>
+#
+# Reads the source markdown, extracts backtick-wrapped references to
+# `memory/**/*.{md,html}` paths, and publishes each one in parallel with a
+# deterministic artifact id (see bin/lib/artifact-id.sh). The deterministic id
+# means the rendered parent view can construct a predictable link to each
+# referenced file *before* this script finishes — so even a slight delay
+# produces clickable links that resolve once the referenced publish completes.
+#
+# Connected mode only. Skips silently if EGREGORE_API_KEY is missing, because
+# the OSS relay ignores artifact ids and would assign random slugs.
+#
+# Fire-and-forget: silent on errors, does not block the caller, bounded
+# parallelism via EGREGORE_REF_PUBLISH_PARALLELISM (default 8).
+
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+SOURCE_FILE="${1:-}"
+
+[ -n "$SOURCE_FILE" ] || exit 0
+[ -f "$SOURCE_FILE" ] || exit 0
+
+# --- Connected-mode check ---
+API_KEY="${EGREGORE_API_KEY:-}"
+if [ -z "$API_KEY" ] && [ -f "$SCRIPT_DIR/.env" ]; then
+  API_KEY="$(grep '^EGREGORE_API_KEY=' "$SCRIPT_DIR/.env" 2>/dev/null | cut -d'=' -f2- || true)"
+fi
+[ -n "$API_KEY" ] || exit 0
+
+# --- Helpers ---
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/bin/lib/artifact-id.sh"
+
+PARALLELISM="${EGREGORE_REF_PUBLISH_PARALLELISM:-8}"
+
+GIT_ROOT="$(git -C "$(dirname "$SOURCE_FILE")" rev-parse --show-toplevel 2>/dev/null || echo "$SCRIPT_DIR")"
+
+# Absolute, symlink-resolved path of the source file. Used below to compare
+# each resolved ref against the source and skip self-references. Using
+# symlink-resolved absolute paths means `memory/` as a symlink into a sibling
+# repo (and macOS's `/var` → `/private/var`) compare correctly — basename
+# comparison alone would falsely skip unrelated files that happen to share
+# a filename (e.g. date-prefixed handoffs, README.md, index.md).
+SOURCE_ABS="$(cd "$(dirname "$SOURCE_FILE")" 2>/dev/null && pwd -P)/$(basename "$SOURCE_FILE")"
+
+# Infer artifact type from path — mirrors egregore-artifacts/bin/cli.js inferType.
+infer_type() {
+  local fp="$1"
+  case "$fp" in
+    */quests/*)   echo "quest" ;;
+    */handoffs/*) echo "handoff" ;;
+    *)            echo "document" ;;
+  esac
+}
+
+# Resolve a backtick-referenced path to a real file on disk.
+resolve_ref() {
+  local ref="$1"
+  local src_dir
+  src_dir="$(dirname "$SOURCE_FILE")"
+  # Candidates: source file's repo-root resolution, then git root, then cwd.
+  local candidates=(
+    "$src_dir/../../$ref"
+    "$GIT_ROOT/$ref"
+    "$ref"
+  )
+  local c
+  for c in "${candidates[@]}"; do
+    if [ -f "$c" ]; then
+      printf '%s' "$c"
+      return 0
+    fi
+  done
+  return 1
+}
+
+publish_one() {
+  local ref="$1"
+  local resolved
+  resolved="$(resolve_ref "$ref")" || return 0
+  [ -n "$resolved" ] || return 0
+
+  # Self-ref guard: skip refs that resolve to the source file itself.
+  # Compared as symlink-resolved absolute paths so symlinked memory layouts
+  # (and unrelated files with the same basename) are handled correctly.
+  local resolved_abs
+  resolved_abs="$(cd "$(dirname "$resolved")" 2>/dev/null && pwd -P)/$(basename "$resolved")"
+  if [ "$resolved_abs" = "$SOURCE_ABS" ]; then
+    return 0
+  fi
+
+  local id
+  id="$(artifact_id_from_path "$ref")" || return 0
+  [ -n "$id" ] || return 0
+
+  case "$ref" in
+    *.md)
+      local type
+      type="$(infer_type "$ref")"
+      bash "$SCRIPT_DIR/bin/publish-artifact.sh" "$type" "$resolved" --id "$id" --no-references >/dev/null 2>&1 || true
+      ;;
+    *.html)
+      bash "$SCRIPT_DIR/bin/publish-artifact.sh" document "$resolved" --id "$id" --raw-html --no-references >/dev/null 2>&1 || true
+      ;;
+  esac
+}
+
+# --- Extract refs, dedupe, publish in parallel ---
+# grep -Eo prints each match on its own line; sed strips the surrounding
+# backticks; sort -u dedupes. No dependency on GNU grep -P.
+REFS="$(grep -Eo '`memory/[^`[:space:]]+\.(md|html)`' "$SOURCE_FILE" 2>/dev/null \
+  | sed 's/^`//; s/`$//' \
+  | sort -u)"
+
+[ -n "$REFS" ] || exit 0
+
+# Bounded parallelism — cap concurrent jobs at PARALLELISM.
+# On bash ≥ 4 (`wait -n`) this is rolling parallelism. On bash 3.2 (macOS
+# default /bin/bash), `wait -n` is unsupported and the `|| wait` fallback
+# drains the whole batch before spawning the next — effectively batch-parallel
+# of size PARALLELISM. Correct in both cases, just slower on bash 3.2.
+active=0
+while IFS= read -r ref; do
+  [ -n "$ref" ] || continue
+  # Self-reference filtering happens inside publish_one, after the ref is
+  # resolved to an absolute path — see the SOURCE_ABS check there.
+  publish_one "$ref" &
+  active=$((active + 1))
+  if [ "$active" -ge "$PARALLELISM" ]; then
+    if wait -n 2>/dev/null; then
+      active=$((active - 1))
+    else
+      wait
+      active=0
+    fi
+  fi
+done <<< "$REFS"
+
+wait 2>/dev/null || true
+exit 0

package/runtime/codex/bin/repo-state.sh

@@ -0,0 +1,99 @@
+#!/bin/bash
+# repo-state.sh — Capture current branch state across all repos.
+# Outputs a markdown table (## Repo State) for handoff files.
+# Only includes repos on non-base branches or with uncommitted changes.
+#
+# Usage: bash bin/repo-state.sh [--no-pr]
+#   --no-pr    Skip the `gh pr list` lookup per repo (~400–600ms each).
+#              PR column will be `—`. Useful on the hot path where a detached
+#              backfill will fill PR numbers in later.
+#   Outputs the markdown section to stdout. Empty output = nothing to report.
+set -euo pipefail
+
+NO_PR=0
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --no-pr) NO_PR=1; shift ;;
+    *) shift ;;
+  esac
+done
+
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+CONFIG="$SCRIPT_DIR/egregore.json"
+PARENT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Source config helpers for _get_base_branch
+source "$SCRIPT_DIR/bin/lib/config.sh" 2>/dev/null || true
+
+CORE_REPO=$(jq -r '.repo_name // "egregore"' "$CONFIG" 2>/dev/null)
+GITHUB_ORG=$(jq -r '.github_org // empty' "$CONFIG" 2>/dev/null)
+MANAGED_REPOS=$(jq -r '(.repos[]? // empty) | if type == "object" then .name else . end' "$CONFIG" 2>/dev/null)
+
+ROWS=""
+
+check_repo() {
+  local repo_name="$1"
+  local repo_dir="$2"
+  local base_branch="$3"
+
+  [ -d "$repo_dir/.git" ] || [ -f "$repo_dir/.git" ] || return 0
+
+  local branch
+  branch=$(git -C "$repo_dir" branch --show-current 2>/dev/null || echo "")
+  [ -z "$branch" ] && return 0
+
+  local dirty=""
+  [ -n "$(git -C "$repo_dir" status --porcelain 2>/dev/null | head -1)" ] && dirty="yes"
+
+  # Skip if on base branch with no changes
+  if [ "$branch" = "$base_branch" ] && [ -z "$dirty" ]; then
+    return 0
+  fi
+
+  # Count commits ahead of base
+  local ahead=0
+  ahead=$(git -C "$repo_dir" rev-list "origin/${base_branch}..HEAD" --count 2>/dev/null || echo "0")
+
+  # Skip if on base branch, no dirty files, no commits ahead
+  if [ "$branch" = "$base_branch" ] && [ -z "$dirty" ] && [ "$ahead" = "0" ]; then
+    return 0
+  fi
+
+  # Check for open PR (skipped with --no-pr; a detached backfill fills it in)
+  local pr="—"
+  if [ "$NO_PR" = "0" ] && command -v gh &>/dev/null && [ -n "$GITHUB_ORG" ]; then
+    local pr_num
+    pr_num=$(gh pr list --repo "$GITHUB_ORG/$repo_name" --head "$branch" --json number -q '.[0].number' 2>/dev/null || true)
+    [ -n "$pr_num" ] && pr="#$pr_num"
+  fi
+
+  ROWS="${ROWS}| ${repo_name} | ${branch} | ${pr} | ${base_branch} |\n"
+}
+
+# Check core repo
+CORE_BASE="develop"
+if [ -f "$CONFIG" ]; then
+  # Core repo base: check if develop exists, otherwise main
+  if git -C "$SCRIPT_DIR" show-ref --verify --quiet refs/remotes/origin/develop 2>/dev/null; then
+    CORE_BASE="develop"
+  else
+    CORE_BASE="main"
+  fi
+fi
+check_repo "$CORE_REPO" "$SCRIPT_DIR" "$CORE_BASE"
+
+# Check managed repos
+for REPO in $MANAGED_REPOS; do
+  REPO_DIR="$PARENT_DIR/$REPO"
+  BASE=$(_get_base_branch "$REPO" 2>/dev/null || echo "develop")
+  check_repo "$REPO" "$REPO_DIR" "$BASE"
+done
+
+# Output
+if [ -n "$ROWS" ]; then
+  echo "## Repo State"
+  echo ""
+  echo "| Repo | Branch | PR | Base |"
+  echo "|------|--------|----|------|"
+  printf '%b' "$ROWS"
+fi

package/runtime/codex/bin/telemetry.sh

@@ -0,0 +1,350 @@
+#!/bin/bash
+# Egregore telemetry — privacy-respecting product analytics.
+# Mirrors bin/graph.sh and bin/notify.sh patterns.
+#
+# Subcommands:
+#   emit <type> <json>   Append event to local JSONL buffer (no network)
+#   flush                Send buffered events to API and clear buffer
+#   status               Show telemetry status (enabled/disabled, buffer size)
+#   enable               Enable telemetry
+#   disable              Disable telemetry
+#   clear                Clear local buffer
+#   show [n]             Show last N events from buffer (default 10)
+#
+# Consent: opt-out via EGREGORE_NO_TELEMETRY=1, DO_NOT_TRACK=1,
+#          or .egregore-state.json → "telemetry": false
+#
+# Never collected: file paths, file contents, code, env var values,
+#                  conversation content, command arguments with user content.
+# Only collected: command names, timestamps, durations, error codes, branch names.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+BUFFER_DIR="$HOME/.egregore"
+BUFFER_FILE="$BUFFER_DIR/telemetry.jsonl"
+STATE_FILE="$SCRIPT_DIR/.egregore-state.json"
+CONFIG="$SCRIPT_DIR/egregore.json"
+ENV_FILE="$SCRIPT_DIR/.env"
+MAX_BUFFER_BYTES=1048576  # 1MB
+MAX_EVENTS_AFTER_TRUNCATE=500
+LOCK_DIR="$BUFFER_DIR/telemetry.lock"
+# Public relay for local/OSS egregores without API keys
+TELEMETRY_RELAY_URL="https://egregore-production-55f2.up.railway.app"
+
+# --- Cross-platform file locking via mkdir (atomic on all POSIX systems) ---
+_lock() {
+  local attempts=0
+  while ! mkdir "$LOCK_DIR" 2>/dev/null; do
+    attempts=$((attempts + 1))
+    if [ "$attempts" -gt 50 ]; then
+      local holder_pid
+      holder_pid=$(cat "$LOCK_DIR/pid" 2>/dev/null || echo "")
+      if [ -n "$holder_pid" ] && ! kill -0 "$holder_pid" 2>/dev/null; then
+        rm -rf "$LOCK_DIR" 2>/dev/null
+        continue
+      fi
+      return 1
+    fi
+    sleep 0.1
+  done
+  echo $$ > "$LOCK_DIR/pid" 2>/dev/null
+}
+
+_unlock() {
+  rm -rf "$LOCK_DIR" 2>/dev/null
+}
+
+trap '_unlock' EXIT
+
+# --- Consent check (fast path) ---
+_check_consent() {
+  # Environment variable opt-outs (fastest check)
+  [ "${EGREGORE_NO_TELEMETRY:-}" = "1" ] && return 1
+  [ "${DO_NOT_TRACK:-}" = "1" ] && return 1
+
+  # State file opt-out
+  if [ -f "$STATE_FILE" ]; then
+    local val
+    val=$(jq -r '.telemetry // "true"' "$STATE_FILE" 2>/dev/null || echo "true")
+    [ "$val" = "false" ] && return 1
+  fi
+
+  return 0
+}
+
+# --- Debug mode ---
+_is_debug() {
+  [ "${EGREGORE_TELEMETRY_DEBUG:-}" = "1" ]
+}
+
+# --- Resolve identity (from env vars first, fallback to config files) ---
+_resolve_user() {
+  if [ -n "${EGREGORE_USER:-}" ]; then
+    echo "$EGREGORE_USER"
+  elif [ -f "$STATE_FILE" ]; then
+    jq -r '.github_username // .name // "unknown"' "$STATE_FILE" 2>/dev/null || echo "unknown"
+  else
+    echo "unknown"
+  fi
+}
+
+_resolve_org() {
+  if [ -n "${EGREGORE_ORG:-}" ]; then
+    echo "$EGREGORE_ORG"
+  elif [ -f "$CONFIG" ]; then
+    jq -r '.slug // .github_org // "unknown"' "$CONFIG" 2>/dev/null || echo "unknown"
+  else
+    echo "unknown"
+  fi
+}
+
+_resolve_session_id() {
+  if [ -n "${EGREGORE_SESSION_ID:-}" ]; then
+    echo "$EGREGORE_SESSION_ID"
+    return
+  fi
+
+  # Fallback: read from file written by session-start.sh
+  # (env vars from hooks don't propagate into the Claude Code agent)
+  # Use git common dir so worktrees hash to the same path as the main checkout
+  local repo_root
+  repo_root=$(git -C "$SCRIPT_DIR" rev-parse --path-format=absolute --git-common-dir 2>/dev/null | sed 's|/\.git$||') || repo_root="$SCRIPT_DIR"
+  local proj_hash
+  proj_hash=$(echo -n "$repo_root" | md5 2>/dev/null || echo -n "$repo_root" | md5sum 2>/dev/null | cut -d' ' -f1)
+  local sid_file="$HOME/.egregore/session-${proj_hash}.id"
+  if [ -f "$sid_file" ]; then
+    cat "$sid_file" 2>/dev/null || echo "unknown"
+  else
+    echo "unknown"
+  fi
+}
+
+# --- emit: append event to local JSONL buffer ---
+cmd_emit() {
+  local event_type="${1:?Usage: telemetry.sh emit <type> <json>}"
+  local data="${2:-"{}"}"
+
+  # Consent gate
+  if ! _check_consent; then
+    return 0
+  fi
+
+  # Debug mode: print to stderr instead of writing
+  if _is_debug; then
+    local ts
+    ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+    local compact_data
+    compact_data=$(printf '%s' "$data" | tr -d '\n' | tr -s ' ')
+    printf '{"ts":"%s","type":"%s","sid":"%s","org":"%s","user":"%s","data":%s}\n' \
+      "$ts" "$event_type" "$(_resolve_session_id)" "$(_resolve_org)" "$(_resolve_user)" "$compact_data" >&2
+    return 0
+  fi
+
+  # Ensure buffer directory exists
+  mkdir -p "$BUFFER_DIR"
+
+  # Build event line (outside lock for minimal hold time)
+  local ts
+  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+  # Compact data to single line — callers may pass pretty-printed JSON
+  local compact_data
+  compact_data=$(printf '%s' "$data" | tr -d '\n' | tr -s ' ')
+  local line
+  line=$(printf '{"ts":"%s","type":"%s","sid":"%s","org":"%s","user":"%s","data":%s}' \
+    "$ts" "$event_type" "$(_resolve_session_id)" "$(_resolve_org)" "$(_resolve_user)" "$compact_data")
+
+  # Append under lock
+  _lock || { echo "$line" >> "$BUFFER_FILE" 2>/dev/null; return 0; }
+  echo "$line" >> "$BUFFER_FILE"
+
+  # Buffer guard: if file exceeds max size, truncate to last N events
+  if [ -f "$BUFFER_FILE" ]; then
+    local size
+    size=$(wc -c < "$BUFFER_FILE" 2>/dev/null | tr -d ' ')
+    if [ "$size" -gt "$MAX_BUFFER_BYTES" ] 2>/dev/null; then
+      local tmp="$BUFFER_FILE.truncate.$$"
+      tail -n "$MAX_EVENTS_AFTER_TRUNCATE" "$BUFFER_FILE" > "$tmp" 2>/dev/null \
+        && mv "$tmp" "$BUFFER_FILE" \
+        || rm -f "$tmp"
+    fi
+  fi
+  _unlock
+}
+
+# --- flush: send buffered events to API ---
+cmd_flush() {
+  if [ ! -f "$BUFFER_FILE" ] || [ ! -s "$BUFFER_FILE" ]; then
+    return 0
+  fi
+
+  # Read API config
+  local api_url=""
+  local api_key=""
+  local endpoint=""
+  local auth_header=""
+  if [ -f "$CONFIG" ]; then
+    api_url=$(jq -r '.api_url // empty' "$CONFIG" 2>/dev/null || true)
+  fi
+  if [ -f "$ENV_FILE" ]; then
+    api_key=$(grep '^EGREGORE_API_KEY=' "$ENV_FILE" 2>/dev/null | cut -d'=' -f2- || true)
+  fi
+
+  if [ -n "$api_url" ] && [ -n "$api_key" ]; then
+    # Connected mode: authenticated ingest
+    endpoint="${api_url}/api/telemetry/ingest"
+    auth_header="Authorization: Bearer $api_key"
+  else
+    # Local/OSS mode: public relay (no auth needed)
+    endpoint="${TELEMETRY_RELAY_URL}/api/telemetry/relay"
+    auth_header=""
+  fi
+
+  # Atomic rotate under lock: move buffer so new events can keep writing
+  _lock || return 0
+  local flush_file="$BUFFER_FILE.flush.$$"
+  mv "$BUFFER_FILE" "$flush_file" 2>/dev/null || { _unlock; return 0; }
+  _unlock
+
+  # POST to API
+  local response
+  local http_code
+  local curl_args=(-s -o /dev/null -w '%{http_code}' -X POST "$endpoint"
+    -H "Content-Type: application/x-ndjson"
+    --data-binary "@$flush_file"
+    --max-time 15)
+  if [ -n "$auth_header" ]; then
+    curl_args+=(-H "$auth_header")
+  fi
+  http_code=$(curl "${curl_args[@]}" 2>/dev/null || echo "000")
+
+  if [ "$http_code" -ge 200 ] 2>/dev/null && [ "$http_code" -lt 300 ] 2>/dev/null; then
+    # Success — remove flush file
+    rm -f "$flush_file"
+  else
+    # Failure — move events back so they aren't lost (under lock to prevent races)
+    _lock || { mv "$flush_file" "$BUFFER_FILE" 2>/dev/null || true; return 1; }
+    if [ -f "$BUFFER_FILE" ]; then
+      # New events were written while we were flushing; prepend old events
+      cat "$flush_file" "$BUFFER_FILE" > "$BUFFER_FILE.merge.$$" 2>/dev/null \
+        && mv "$BUFFER_FILE.merge.$$" "$BUFFER_FILE" \
+        && rm -f "$flush_file" \
+        || rm -f "$BUFFER_FILE.merge.$$"
+    else
+      mv "$flush_file" "$BUFFER_FILE" 2>/dev/null || true
+    fi
+    _unlock
+  fi
+}
+
+# --- status: show telemetry status ---
+cmd_status() {
+  echo "Telemetry status:"
+  echo ""
+
+  # Consent
+  if _check_consent; then
+    echo "  Enabled: yes"
+  else
+    echo "  Enabled: no"
+    if [ "${EGREGORE_NO_TELEMETRY:-}" = "1" ]; then
+      echo "  Reason: EGREGORE_NO_TELEMETRY=1"
+    elif [ "${DO_NOT_TRACK:-}" = "1" ]; then
+      echo "  Reason: DO_NOT_TRACK=1"
+    else
+      echo "  Reason: telemetry=false in .egregore-state.json"
+    fi
+  fi
+
+  # Buffer
+  if [ -f "$BUFFER_FILE" ]; then
+    local count size
+    count=$(grep -c '^{' "$BUFFER_FILE" 2>/dev/null || echo 0)
+    size=$(wc -c < "$BUFFER_FILE" 2>/dev/null | tr -d ' ')
+    echo "  Buffer: $count events ($size bytes)"
+    echo "  Path: $BUFFER_FILE"
+  else
+    echo "  Buffer: empty"
+  fi
+
+  echo ""
+  echo "  Opt-out: set EGREGORE_NO_TELEMETRY=1 in .env, or run /telemetry off"
+}
+
+# --- enable: turn telemetry on ---
+cmd_enable() {
+  if [ -f "$STATE_FILE" ]; then
+    jq '.telemetry = true' "$STATE_FILE" > "$STATE_FILE.tmp" \
+      && mv "$STATE_FILE.tmp" "$STATE_FILE"
+  fi
+  echo "Telemetry enabled."
+}
+
+# --- disable: turn telemetry off ---
+cmd_disable() {
+  if [ -f "$STATE_FILE" ]; then
+    jq '.telemetry = false' "$STATE_FILE" > "$STATE_FILE.tmp" \
+      && mv "$STATE_FILE.tmp" "$STATE_FILE"
+  else
+    echo '{"telemetry": false}' > "$STATE_FILE"
+  fi
+  echo "Telemetry disabled."
+}
+
+# --- clear: delete local buffer ---
+cmd_clear() {
+  rm -f "$BUFFER_FILE"
+  echo "Telemetry buffer cleared."
+}
+
+# --- show: display last N events ---
+cmd_show() {
+  local n="${1:-10}"
+  if [ ! -f "$BUFFER_FILE" ] || [ ! -s "$BUFFER_FILE" ]; then
+    echo "No buffered events."
+    return 0
+  fi
+  echo "Last $n events:"
+  echo ""
+  # Extract JSON objects (handles both single-line and legacy multi-line format)
+  grep '^{' "$BUFFER_FILE" | tail -n "$n" | jq -c . 2>/dev/null \
+    || grep '^{' "$BUFFER_FILE" | tail -n "$n"
+}
+
+# --- Main dispatch ---
+case "${1:-status}" in
+  emit)
+    shift
+    cmd_emit "$@"
+    ;;
+  flush)
+    cmd_flush
+    ;;
+  status)
+    cmd_status
+    ;;
+  enable)
+    cmd_enable
+    ;;
+  disable)
+    cmd_disable
+    ;;
+  clear)
+    cmd_clear
+    ;;
+  show)
+    shift
+    cmd_show "${1:-10}"
+    ;;
+  help|*)
+    echo "Usage: telemetry.sh <command>"
+    echo ""
+    echo "Commands:"
+    echo "  emit <type> <json>  Append event to local buffer (no network)"
+    echo "  flush               Send buffered events to API"
+    echo "  status              Show telemetry status"
+    echo "  enable              Enable telemetry"
+    echo "  disable             Disable telemetry"
+    echo "  clear               Clear local buffer"
+    echo "  show [n]            Show last N events (default 10)"
+    ;;
+esac