Ce Setup

# Compound Engineering -- local config
# Copy to .compound-engineering/config.local.yaml in your project root.
# All settings are optional. Invalid values fall through to defaults.

# --- Work delegation (Codex) ---

# work_delegate: codex           # codex | false (default: false)
# work_delegate_consent: true    # true | false (default: false)
# work_delegate_sandbox: yolo    # yolo | full-auto (default: yolo)
# work_delegate_decision: auto   # auto | ask (default: auto)
# work_delegate_model: gpt-5.4   # any valid codex model (omit to use ~/.codex/config.toml default)
# work_delegate_effort: high     # minimal | low | medium | high | xhigh (omit to use ~/.codex/config.toml default)

# --- Product pulse ---
# Settings written by /ce-product-pulse first-run interview. Re-run the skill with
# argument `setup` or `reconfigure` to edit interactively.

# pulse_product_name: "Spiral"                          # used in report titles (no default)
# pulse_lookback_default: 24h                           # 1h | 24h | 7d | 30d (default: 24h)
# pulse_primary_event: "session_started"                # the event that means "user showed up"
# pulse_value_event: "task_completed"                   # the event that means "user got value"
# pulse_completion_events: "onboarded,first_purchase"   # comma-separated, 0-3 events
# pulse_quality_scoring: false                          # true | false (default: false; AI products only)
# pulse_quality_dimension: "answer accuracy"            # dimension scored 1-5 when pulse_quality_scoring is true
# pulse_analytics_source: posthog                       # posthog | mixpanel | custom (no default)
# pulse_tracing_source: sentry                          # sentry | datadog | custom (no default)
# pulse_payments_source: stripe                         # stripe | custom (no default)
# pulse_db_enabled: false                               # true | false (default: false; read-only DB if true)
# pulse_metric_sources: "retention_d7=posthog,nps=delighted"  # strategy-metric -> source overrides; comma-separated 'metric=source' pairs; unlisted metrics fall back to pulse_analytics_source
# pulse_pending_metrics: "retention_d7,nps"             # comma-separated strategy metrics awaiting instrumentation; render as 'no data'
# pulse_excluded_metrics: "north_star"                  # comma-separated strategy metrics intentionally not in pulse

# --- Output format ---
# Per-skill output format default. Selects the exclusive format the artifact
# is written in: `md` produces a markdown file, `html` produces a single
# self-contained HTML file. The two are mutually exclusive -- there is no
# sibling artifact. See DESIGN.md or your agent instructions to influence
# HTML styling. CLI arguments override these defaults; pipeline contexts
# (e.g., LFG, disable-model-invocation) always force `md` regardless.

# plan_output: html              # md | html (default: md)
# brainstorm_output: html        # md | html (default: md)
# ideate_output: md              # md | html (default: html -- ideation docs are human-facing, so HTML is the default; set md to opt out)

# --- ce-promote ---
# Written automatically when you decline the Spiral setup offer in /ce-promote.
# Suppresses that one-time setup nudge in this project. Remove the key to re-enable.

# ce_promote_spiral_optout: true   # true | (absent) (default: absent -- offer once)

#!/usr/bin/env bash
# Compound Engineering environment health check.
# Reports optional tool capabilities and repo-local config safety in one pass.

set -o pipefail

# =====================================================
#  Optional capability config
# =====================================================
# Format: name|install_cmd|url|capability

deps=(
  "agent-browser|CI=true npm install -g agent-browser --no-audit --no-fund --loglevel=error && agent-browser install|https://github.com/vercel-labs/agent-browser|browser testing, dogfood QA, and visual polish inspection"
  "gh|NONINTERACTIVE=1 HOMEBREW_NO_AUTO_UPDATE=1 brew install -q gh|https://cli.github.com|GitHub PR, issue, and review workflows"
  "jq|NONINTERACTIVE=1 HOMEBREW_NO_AUTO_UPDATE=1 brew install -q jq|https://jqlang.github.io/jq/|JSON inspection in shell-based workflows"
  "ast-grep|NONINTERACTIVE=1 HOMEBREW_NO_AUTO_UPDATE=1 brew install -q ast-grep|https://ast-grep.github.io|syntax-aware structural code search"
  "ffmpeg|NONINTERACTIVE=1 HOMEBREW_NO_AUTO_UPDATE=1 brew install -q ffmpeg|https://ffmpeg.org/download.html|media chunking and screenshot extraction for Riffrec analysis"
)

# =====================================================
#  Args
# =====================================================

plugin_version=""
while [ $# -gt 0 ]; do
  case "$1" in
    --version) [ -n "$2" ] && plugin_version="$2" && shift 2 || shift ;;
    *) shift ;;
  esac
done

# =====================================================
#  Helpers
# =====================================================

ok()      { echo "  🟢  $1"; }
warn()    { echo "  🟡  $1"; }
skip()    { echo "  ➖  $1"; }
detail()  { echo "       $1"; }
section() { echo ""; echo " $1"; }

has_brew=$(command -v brew >/dev/null 2>&1 && echo "yes" || echo "no")
in_repo=$(git rev-parse --is-inside-work-tree >/dev/null 2>&1 && echo "yes" || echo "no")

# =====================================================
#  Check optional capabilities
# =====================================================

capability_ok=0
capability_total=0
capability_missing=0
results=()

for entry in "${deps[@]}"; do
  IFS='|' read -r name install_cmd url capability <<< "$entry"
  capability_total=$((capability_total + 1))
  if command -v "$name" >/dev/null 2>&1; then
    capability_ok=$((capability_ok + 1))
    results+=("$name|ok|$install_cmd|$url|$capability")
  else
    capability_missing=$((capability_missing + 1))
    results+=("$name|missing|$install_cmd|$url|$capability")
  fi
done

# =====================================================
#  Project checks (repo only)
# =====================================================

legacy_cfg="skip"
repo_cfg_gitignore="skip"
local_cfg="skip"
example_cfg="skip"
project_issues=0

if [ "$in_repo" = "yes" ]; then
  repo_root=$(git rev-parse --show-toplevel 2>/dev/null)
  legacy_cfg="missing"
  [ -f "$repo_root/compound-engineering.local.md" ] && legacy_cfg="present"

  local_cfg="missing"
  if [ -e "$repo_root/.compound-engineering/config.local.yaml" ]; then
    local_cfg="present"
    if git check-ignore -q "$repo_root/.compound-engineering/config.local.yaml" 2>/dev/null; then
      repo_cfg_gitignore="ok"
    else
      repo_cfg_gitignore="missing"
    fi
  fi

  script_dir="$(cd "$(dirname "$0")" && pwd)"
  template="$script_dir/../references/config-template.yaml"
  example="$repo_root/.compound-engineering/config.local.example.yaml"
  if [ ! -f "$example" ]; then
    example_cfg="missing"
  elif [ -f "$template" ] && ! diff -q "$template" "$example" >/dev/null 2>&1; then
    example_cfg="outdated"
  else
    example_cfg="ok"
  fi
fi

# =====================================================
#  Output
# =====================================================

echo ""
if [ -n "$plugin_version" ]; then
  ok "Plugin version v${plugin_version}"
fi

section "Optional capabilities  ${capability_ok}/${capability_total}"

for result in "${results[@]}"; do
  IFS='|' read -r name status install_cmd url capability <<< "$result"
  if [ "$status" = "ok" ]; then
    ok "$name -- $capability"
  else
    warn "$name -- unavailable: $capability"
    if [[ "$install_cmd" == *"brew install"* ]] && [ "$has_brew" != "yes" ]; then
      detail "$url"
    else
      detail "$install_cmd"
      detail "$url"
    fi
  fi
done

if [ "$in_repo" = "yes" ]; then
  section "Project config"

  if [ "$legacy_cfg" = "present" ]; then
    warn "Obsolete compound-engineering.local.md exists"
    project_issues=$((project_issues + 1))
  else
    ok "No obsolete compound-engineering.local.md"
  fi

  if [ "$local_cfg" = "present" ]; then
    ok ".compound-engineering/config.local.yaml exists"
    if [ "$repo_cfg_gitignore" = "ok" ]; then
      ok "Local config is gitignored"
    else
      warn "Local config is not safely gitignored"
      project_issues=$((project_issues + 1))
    fi
  else
    skip "No local config yet (.compound-engineering/config.local.yaml)"
  fi

  if [ "$example_cfg" = "ok" ]; then
    ok "Example config is current"
  elif [ "$example_cfg" = "missing" ]; then
    warn "Example config missing (.compound-engineering/config.local.example.yaml)"
    project_issues=$((project_issues + 1))
  elif [ "$example_cfg" = "outdated" ]; then
    warn "Example config outdated (new settings available)"
    project_issues=$((project_issues + 1))
  fi
else
  section "Project config"
  skip "Not inside a git repository"
fi

echo ""
if [ "$project_issues" -eq 0 ]; then
  echo " ✅  Project config healthy. Optional capabilities available: ${capability_ok}/${capability_total}"
else
  echo " ⚠️   ${project_issues} project issue(s) found. Optional capabilities available: ${capability_ok}/${capability_total}"
fi

if [ "$capability_missing" -gt 0 ]; then
  echo "     Missing optional tools do not block setup; install them only for the workflows you use."
fi

echo ""