specrails-core 3.5.3 → 3.7.0

package/install.sh

@@ -3,7 +3,7 @@ set -euo pipefail
 
 # specrails installer
 # Installs the agent workflow system into any repository.
-# Step 1 of 2: Prerequisites + scaffold. Step 2: Run /specrails:setup inside Claude Code.
+# Step 1 of 2: Prerequisites + scaffold. Step 2: Run /specrails:enrich inside Claude Code.
 
 # Detect pipe mode (curl | bash) vs local execution
 if [[ -z "${BASH_SOURCE[0]:-}" || "${BASH_SOURCE[0]:-}" == "bash" ]]; then
@@ -46,6 +46,13 @@ HAS_CLAUDE=false
 HAS_CODEX=false
 AGENT_TEAMS=false
 
+# Direct-mode flags (set by bin/specrails-core.js after TUI completes)
+FROM_CONFIG=false   # read provider/agent_teams from .specrails/install-config.yaml
+CONFIG_PATH=""      # explicit config file path (passed after --from-config)
+HAS_GUM=false       # set to true if gum CLI is available (optional UI enhancement)
+TIER="full"         # install tier: full (default) or quick (template-only, no enrich)
+HUB_JSON=false      # emit JSON checkpoint lines for programmatic consumption (specrails-hub)
+
 while [[ $# -gt 0 ]]; do
     case "$1" in
         --root-dir)
@@ -72,9 +79,36 @@ while [[ $# -gt 0 ]]; do
             CLI_PROVIDER="$2"
             shift 2
             ;;
+        --from-config)
+            # Config was written by the TUI; skip interactive prompts and read
+            # provider + agent_teams from install-config.yaml.
+            # Optional: --from-config <path>  (defaults to .specrails/install-config.yaml)
+            FROM_CONFIG=true
+            if [[ -n "${2:-}" && "${2:-}" != -* ]]; then
+                CONFIG_PATH="${2}"
+                shift 2
+            else
+                shift
+            fi
+            ;;
+        --agent-teams)
+            # Explicitly enable agent teams commands (alternative to config file).
+            AGENT_TEAMS=true
+            shift
+            ;;
+        --quick)
+            # Template-only install; sets tier=quick in the generated config.
+            TIER="quick"
+            shift
+            ;;
+        --hub-json)
+            # Emit JSON checkpoint lines for programmatic consumption by specrails-hub.
+            HUB_JSON=true
+            shift
+            ;;
         *)
             echo "Unknown argument: $1" >&2
-            echo "Usage: install.sh [--root-dir <path>] [--yes|-y] [--provider <claude|codex>]" >&2
+            echo "Usage: install.sh [--root-dir <path>] [--yes|-y] [--provider <claude|codex>] [--from-config [<path>]] [--agent-teams] [--quick] [--hub-json]" >&2
             exit 1
             ;;
     esac
@@ -162,14 +196,14 @@ generate_manifest() {
     \"${relpath}\": \"${checksum}\""
     done < <(find "$SCRIPT_DIR/templates" -type f -not -path '*/node_modules/*' -not -name 'package-lock.json' -print0 | sort -z)
 
-    # Include commands/setup.md
-    local setup_checksum
-    setup_checksum="sha256:$(shasum -a 256 "$SCRIPT_DIR/commands/setup.md" | awk '{print $1}')"
+    # Include commands/enrich.md
+    local enrich_checksum
+    enrich_checksum="sha256:$(shasum -a 256 "$SCRIPT_DIR/commands/enrich.md" | awk '{print $1}')"
     if [ -n "$artifacts_json" ]; then
         artifacts_json="${artifacts_json},"
     fi
     artifacts_json="${artifacts_json}
-    \"commands/specrails/setup.md\": \"${setup_checksum}\""
+    \"commands/specrails/enrich.md\": \"${enrich_checksum}\""
 
     # Include commands/doctor.md
     local doctor_checksum
@@ -215,47 +249,149 @@ if command -v codex &> /dev/null; then
     HAS_CODEX=true
 fi
 
-if [[ -n "$CLI_PROVIDER" ]]; then
-    # --provider flag was set explicitly — skip interactive detection
-    ok "Provider: $CLI_PROVIDER (--provider flag)"
-elif [ "$HAS_CLAUDE" = true ] && [ "$HAS_CODEX" = true ]; then
-    echo ""
-    echo -e "  ${BOLD}Both Claude Code and Codex detected.${NC}"
-    if [ "$AUTO_YES" = true ]; then
-        CLI_PROVIDER="claude"
-        info "Auto-selected Claude Code (--yes flag active)"
+# 1.2a Gum detection (optional UI enhancement — used in non-TUI bash paths)
+if command -v gum &> /dev/null; then
+    HAS_GUM=true
+    ok "gum CLI: found (enhanced UI available)"
+else
+    # Attempt a lightweight auto-install on supported platforms (best-effort)
+    _GUM_INSTALLED=false
+    if command -v brew &> /dev/null; then
+        info "Installing gum CLI via Homebrew (optional — adds nicer prompts)..."
+        if brew install gum &>/dev/null; then
+            HAS_GUM=true
+            _GUM_INSTALLED=true
+            ok "gum installed via Homebrew"
+        fi
+    fi
+    if [[ "$_GUM_INSTALLED" == false ]]; then
+        info "gum CLI not found — install via 'brew install gum' for enhanced prompts (optional)"
+    fi
+fi
+
+if [[ "$FROM_CONFIG" == true ]]; then
+    # Config was written by the TUI — read provider and agent_teams from it.
+    # Resolve config path: explicit path > default location.
+    if [[ -z "$CONFIG_PATH" ]]; then
+        CONFIG_PATH="${REPO_ROOT}/.specrails/install-config.yaml"
+    fi
+    if [[ -f "$CONFIG_PATH" ]]; then
+        _cfg_version=$(grep '^version:' "$CONFIG_PATH" 2>/dev/null | awk '{print $2}' | tr -d '[:space:]' || true)
+        _cfg_provider=$(grep '^provider:' "$CONFIG_PATH" 2>/dev/null | awk '{print $2}' | tr -d '[:space:]' || true)
+        _cfg_agent_teams=$(grep '^agent_teams:' "$CONFIG_PATH" 2>/dev/null | awk '{print $2}' | tr -d '[:space:]' || true)
+        _cfg_tier=$(grep '^tier:' "$CONFIG_PATH" 2>/dev/null | awk '{print $2}' | tr -d '[:space:]' || true)
+        _cfg_preset=$(grep '^\s*preset:' "$CONFIG_PATH" 2>/dev/null | head -1 | awk '{print $2}' | tr -d '[:space:]' || true)
+        _cfg_has_agents=$(grep -c '^\s*selected:' "$CONFIG_PATH" 2>/dev/null || true)
+
+        _config_errors=0
+        if [[ -z "$_cfg_version" ]]; then
+            fail "Invalid config: missing required 'version' field"
+            _config_errors=$(( _config_errors + 1 ))
+        elif [[ "$_cfg_version" != "1" ]]; then
+            fail "Invalid config: unsupported version '$_cfg_version' (expected: 1)"
+            _config_errors=$(( _config_errors + 1 ))
+        fi
+        if [[ -z "$_cfg_provider" ]]; then
+            fail "Invalid config: missing required 'provider' field"
+            _config_errors=$(( _config_errors + 1 ))
+        elif [[ "$_cfg_provider" != "claude" && "$_cfg_provider" != "codex" ]]; then
+            fail "Invalid config: unsupported provider '$_cfg_provider' (expected: claude or codex)"
+            _config_errors=$(( _config_errors + 1 ))
+        fi
+        if [[ "$_cfg_has_agents" -eq 0 ]]; then
+            fail "Invalid config: missing required 'agents' section with 'selected' list"
+            _config_errors=$(( _config_errors + 1 ))
+        fi
+        if [[ -n "$_cfg_tier" && "$_cfg_tier" != "full" && "$_cfg_tier" != "quick" ]]; then
+            fail "Invalid config: unsupported tier '$_cfg_tier' (expected: full or quick)"
+            _config_errors=$(( _config_errors + 1 ))
+        fi
+        if [[ -n "$_cfg_preset" && "$_cfg_preset" != "balanced" && "$_cfg_preset" != "budget" && "$_cfg_preset" != "max" ]]; then
+            fail "Invalid config: unsupported preset '$_cfg_preset' (expected: balanced, budget, or max)"
+            _config_errors=$(( _config_errors + 1 ))
+        fi
+
+        # Warn about unknown agents in selected list
+        if [[ "$_cfg_has_agents" -gt 0 ]]; then
+            _selected_line=$(grep '^\s*selected:' "$CONFIG_PATH" 2>/dev/null | head -1 || true)
+            if echo "$_selected_line" | grep -q '\[' 2>/dev/null; then
+                _selected_agents=$(echo "$_selected_line" | sed 's/.*\[//;s/\].*//;s/,/\n/g' | tr -d ' ')
+            else
+                _selected_agents=$(grep -A100 '^\s*selected:' "$CONFIG_PATH" 2>/dev/null \
+                    | tail -n +2 | grep '^\s*-\s*' | sed 's/^\s*-\s*//' | tr -d ' ' || true)
+            fi
+            while IFS= read -r _agent_name; do
+                [[ -z "$_agent_name" ]] && continue
+                if [[ ! -f "$SCRIPT_DIR/templates/agents/${_agent_name}.md" ]]; then
+                    warn "Unknown agent in selected list: ${_agent_name}"
+                fi
+            done <<< "$_selected_agents"
+        fi
+
+        if [[ "$_config_errors" -gt 0 ]]; then
+            fail "Config validation failed with ${_config_errors} error(s) — aborting"
+            exit 1
+        fi
+
+        if [[ -n "$_cfg_provider" ]]; then
+            CLI_PROVIDER="$_cfg_provider"
+            ok "Provider: $CLI_PROVIDER (from install-config.yaml)"
+        fi
+        if [[ "$_cfg_agent_teams" == "true" ]]; then
+            AGENT_TEAMS=true
+        fi
+        if [[ -n "$_cfg_tier" ]]; then
+            TIER="$_cfg_tier"
+        fi
     else
+        warn "install-config.yaml not found at $CONFIG_PATH — falling back to auto-detection"
+        FROM_CONFIG=false
+    fi
+fi
+
+if [[ "$FROM_CONFIG" != true ]]; then
+    if [[ -n "$CLI_PROVIDER" ]]; then
+        # --provider flag was set explicitly — skip interactive detection
+        ok "Provider: $CLI_PROVIDER (--provider flag)"
+    elif [ "$HAS_CLAUDE" = true ] && [ "$HAS_CODEX" = true ]; then
         echo ""
-        echo "    Which provider would you like to use?"
-        echo "      1) Claude Code (claude)  → output to .claude/"
-        echo "      2) Codex (codex)         → output to .codex/"
-        echo ""
-        read -p "    Select provider (1 or 2, default: 1): " PROVIDER_CHOICE || PROVIDER_CHOICE="1"
-        PROVIDER_CHOICE="${PROVIDER_CHOICE:-1}"
-        if [[ "$PROVIDER_CHOICE" == "2" ]]; then
-            CLI_PROVIDER="codex"
-        else
+        echo -e "  ${BOLD}Both Claude Code and Codex detected.${NC}"
+        if [ "$AUTO_YES" = true ]; then
             CLI_PROVIDER="claude"
+            info "Auto-selected Claude Code (--yes flag active)"
+        else
+            echo ""
+            echo "    Which provider would you like to use?"
+            echo "      1) Claude Code (claude)  → output to .claude/"
+            echo "      2) Codex (codex)         → output to .codex/"
+            echo ""
+            read -p "    Select provider (1 or 2, default: 1): " PROVIDER_CHOICE || PROVIDER_CHOICE="1"
+            PROVIDER_CHOICE="${PROVIDER_CHOICE:-1}"
+            if [[ "$PROVIDER_CHOICE" == "2" ]]; then
+                CLI_PROVIDER="codex"
+            else
+                CLI_PROVIDER="claude"
+            fi
         fi
+        ok "Provider: $CLI_PROVIDER"
+    elif [ "$HAS_CLAUDE" = true ]; then
+        CLI_PROVIDER="claude"
+        CLAUDE_VERSION=$(claude --version 2>/dev/null || echo "unknown")
+        ok "Claude Code CLI: $CLAUDE_VERSION"
+    elif [ "$HAS_CODEX" = true ]; then
+        CLI_PROVIDER="codex"
+        CODEX_VERSION=$(codex --version 2>/dev/null || echo "unknown")
+        ok "Codex CLI: $CODEX_VERSION"
+    elif [[ "$SKIP_PREREQS" == "1" ]]; then
+        CLI_PROVIDER="claude"
+        warn "No AI CLI found (skipped — SPECRAILS_SKIP_PREREQS=1)"
+    else
+        fail "No AI CLI found (claude or codex)."
+        echo ""
+        echo "    Install Claude Code: https://claude.ai/download"
+        echo "    Install Codex:       https://github.com/openai/codex"
+        exit 1
     fi
-    ok "Provider: $CLI_PROVIDER"
-elif [ "$HAS_CLAUDE" = true ]; then
-    CLI_PROVIDER="claude"
-    CLAUDE_VERSION=$(claude --version 2>/dev/null || echo "unknown")
-    ok "Claude Code CLI: $CLAUDE_VERSION"
-elif [ "$HAS_CODEX" = true ]; then
-    CLI_PROVIDER="codex"
-    CODEX_VERSION=$(codex --version 2>/dev/null || echo "unknown")
-    ok "Codex CLI: $CODEX_VERSION"
-elif [[ "$SKIP_PREREQS" == "1" ]]; then
-    CLI_PROVIDER="claude"
-    warn "No AI CLI found (skipped — SPECRAILS_SKIP_PREREQS=1)"
-else
-    fail "No AI CLI found (claude or codex)."
-    echo ""
-    echo "    Install Claude Code: https://claude.ai/download"
-    echo "    Install Codex:       https://github.com/openai/codex"
-    exit 1
 fi
 
 # Derive output directory and instruction file from provider
@@ -269,12 +405,24 @@ fi
 
 # 1.2b Agent Teams opt-in (Claude Code only)
 if [[ "$CLI_PROVIDER" == "claude" ]]; then
-    echo ""
-    if [ "$AUTO_YES" = true ]; then
+    if [[ "$FROM_CONFIG" == true || "$AGENT_TEAMS" == true ]]; then
+        # Already resolved from config or --agent-teams flag
+        if [[ "$AGENT_TEAMS" == true ]]; then
+            ok "Agent Teams commands: enabled (from install-config.yaml)"
+            echo ""
+            info "Remember to set the feature flag before using these commands:"
+            echo ""
+            echo "    export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1"
+            echo ""
+        else
+            info "Agent Teams commands: skipped (from install-config.yaml)"
+        fi
+    elif [ "$AUTO_YES" = true ]; then
         # --yes flag: default to NOT installing (opt-in, not opt-out)
         AGENT_TEAMS=false
         info "Agent Teams commands: skipped (opt-in, use interactive mode to enable)"
     else
+        echo ""
         echo -e "  ${BOLD}Agent Teams commands are available (experimental):${NC}"
         echo "    /specrails:team-review — Multi-perspective code review with AI reviewers"
         echo "    /specrails:team-debug  — Collaborative debugging with competing hypotheses"
@@ -433,8 +581,8 @@ if command -v jira &> /dev/null; then
     HAS_JIRA=true
 else
     HAS_JIRA=false
-    # Don't warn here — JIRA is only relevant if chosen during /specrails:setup.
-    # If the user selects JIRA in /specrails:setup and it's not installed, the setup
+    # Don't warn here — JIRA is only relevant if chosen during /specrails:enrich.
+    # If the user selects JIRA in /specrails:enrich and it's not installed, the enrich
     # wizard will offer to install it (go-jira via brew/go, or Atlassian CLI).
 fi
 
@@ -488,7 +636,7 @@ step "Phase 3: Installing specrails artifacts"
 mkdir -p "$REPO_ROOT/specrails"
 if [[ "$CLI_PROVIDER" == "codex" ]]; then
     # Codex: install as Agent Skills (Codex doesn't support .codex/commands/)
-    mkdir -p "$REPO_ROOT/.agents/skills/setup"
+    mkdir -p "$REPO_ROOT/.agents/skills/enrich"
     mkdir -p "$REPO_ROOT/.agents/skills/doctor"
 else
     mkdir -p "$REPO_ROOT/$SPECRAILS_DIR/commands/specrails"
@@ -503,13 +651,13 @@ mkdir -p "$REPO_ROOT/.specrails/setup-templates/settings"
 mkdir -p "$REPO_ROOT/.specrails/setup-templates/prompts"
 mkdir -p "$REPO_ROOT/$SPECRAILS_DIR/agent-memory/explanations"
 
-# Copy the /specrails:setup and /specrails:doctor commands (or skills for Codex)
+# Copy the /specrails:enrich and /specrails:doctor commands (or skills for Codex)
 if [[ "$CLI_PROVIDER" == "codex" ]]; then
     # Codex uses Agent Skills in .agents/skills/<name>/SKILL.md
     {
         echo '---'
-        echo 'name: setup'
-        echo 'description: "Interactive wizard to configure the full specrails agent workflow system for this repository."'
+        echo 'name: enrich'
+        echo 'description: "Interactive wizard to configure the full specrails agent workflow system for this repository. Supports config-driven mode for direct installation from a pre-built config file."'
         echo 'license: MIT'
         echo 'compatibility: "Requires npm, git."'
         echo 'metadata:'
@@ -517,9 +665,9 @@ if [[ "$CLI_PROVIDER" == "codex" ]]; then
         echo '  version: "1.0"'
         echo '---'
         echo ''
-        cat "$SCRIPT_DIR/commands/setup.md"
-    } > "$REPO_ROOT/.agents/skills/setup/SKILL.md"
-    ok "Installed \$setup skill"
+        cat "$SCRIPT_DIR/commands/enrich.md"
+    } > "$REPO_ROOT/.agents/skills/enrich/SKILL.md"
+    ok "Installed \$enrich skill"
 
     {
         echo '---'
@@ -537,8 +685,8 @@ if [[ "$CLI_PROVIDER" == "codex" ]]; then
     ok "Installed \$doctor skill"
 else
     # Claude Code uses commands in .claude/commands/specrails/ (namespaced as /specrails:*)
-    cp "$SCRIPT_DIR/commands/setup.md" "$REPO_ROOT/$SPECRAILS_DIR/commands/specrails/setup.md"
-    ok "Installed /specrails:setup command"
+    cp "$SCRIPT_DIR/commands/enrich.md" "$REPO_ROOT/$SPECRAILS_DIR/commands/specrails/enrich.md"
+    ok "Installed /specrails:enrich command"
 
     cp "$SCRIPT_DIR/commands/doctor.md" "$REPO_ROOT/$SPECRAILS_DIR/commands/specrails/doctor.md"
     ok "Installed /specrails:doctor command"
@@ -550,13 +698,130 @@ cp "$SCRIPT_DIR/bin/doctor.sh" "$REPO_ROOT/.specrails/bin/doctor.sh"
 chmod +x "$REPO_ROOT/.specrails/bin/doctor.sh"
 ok "Installed specrails doctor (bin/doctor.sh)"
 
+# Write install-config.yaml: copy from --from-config source if provided,
+# otherwise write defaults. Ensures a config file always exists after install
+# so /specrails:enrich --from-config works regardless of how the installer was invoked.
+_install_config="${REPO_ROOT}/.specrails/install-config.yaml"
+if [[ "$FROM_CONFIG" == true && -n "$CONFIG_PATH" && -f "$CONFIG_PATH" && "$CONFIG_PATH" != "$_install_config" ]]; then
+    cp "$CONFIG_PATH" "$_install_config"
+    ok "Copied install-config.yaml from ${CONFIG_PATH}"
+elif [[ ! -f "$_install_config" ]]; then
+    _ic_provider="${CLI_PROVIDER:-claude}"
+    _ic_tier="${TIER:-full}"
+    _ic_agent_teams="${AGENT_TEAMS:-false}"
+    cat > "$_install_config" << YAML
+# specrails install config — generated during install (defaults)
+# Re-run: npx specrails-core@latest init  to regenerate with TUI
+version: 1
+provider: ${_ic_provider}
+tier: ${_ic_tier}
+agents:
+  selected: [sr-architect, sr-developer, sr-reviewer, sr-test-writer, sr-product-manager]
+  excluded: [sr-frontend-developer, sr-backend-developer, sr-frontend-reviewer, sr-backend-reviewer, sr-security-reviewer, sr-performance-reviewer, sr-product-analyst, sr-doc-sync, sr-merge-resolver]
+models:
+  preset: balanced
+  defaults: { model: sonnet }
+  overrides: {}
+quick_context:
+  product_description: ""
+  target_users: ""
+agent_teams: ${_ic_agent_teams}
+YAML
+    ok "Written .specrails/install-config.yaml (defaults)"
+fi
+
 # Copy templates (includes commands, skills, agents, rules, personas, settings)
 # Use tar to exclude node_modules and package-lock.json for performance
 tar -C "$SCRIPT_DIR/templates" --exclude='node_modules' --exclude='package-lock.json' -cf - . \
     | tar -C "$REPO_ROOT/.specrails/setup-templates/" -xf -
 ok "Installed setup templates (commands + skills)"
 
-# Write OSS detection results for /specrails:setup
+# Filter agent templates to only those listed in agents.selected (when --from-config is active).
+# This allows hub or the TUI to pre-select a subset of agents before enrichment.
+if [[ "$FROM_CONFIG" == true ]]; then
+    _cfg_to_read="${CONFIG_PATH:-${REPO_ROOT}/.specrails/install-config.yaml}"
+    if [[ -f "$_cfg_to_read" ]]; then
+        # Parse selected agents from inline YAML list: selected: [sr-architect, sr-developer, ...]
+        _selected_raw=$(grep '^  selected:' "$_cfg_to_read" | sed 's/.*\[//;s/\].*//;s/,/ /g' || true)
+        if [[ -n "$_selected_raw" ]]; then
+            _agents_dir="${REPO_ROOT}/.specrails/setup-templates/agents"
+            _removed=0
+            for _agent_file in "$_agents_dir/"*.md; do
+                [[ -f "$_agent_file" ]] || continue
+                _agent_name="$(basename "$_agent_file" .md)"
+                _in_selected=false
+                for _sel in $_selected_raw; do
+                    # Strip whitespace/commas from parsed token
+                    _sel="${_sel//,/}"
+                    _sel="${_sel// /}"
+                    if [[ "$_sel" == "$_agent_name" ]]; then
+                        _in_selected=true
+                        break
+                    fi
+                done
+                if [[ "$_in_selected" == false ]]; then
+                    rm -f "$_agent_file"
+                    (( _removed++ )) || true
+                fi
+            done
+            if (( _removed > 0 )); then
+                ok "Agent templates filtered: removed ${_removed} excluded agent(s)"
+            fi
+        fi
+
+        # Apply defaults.model to all agent templates when present.
+        # Handles both inline "defaults: { model: haiku }" and block "defaults:\n  model: haiku"
+        _cfg_default_model=""
+        _defaults_line=$(grep '^\s*defaults:' "$_cfg_to_read" 2>/dev/null | head -1 || true)
+        if echo "$_defaults_line" | grep -q 'model:' 2>/dev/null; then
+            _cfg_default_model=$(echo "$_defaults_line" | sed 's/.*model:[[:space:]]*//' | awk '{print $1}' | tr -d '}[:space:]')
+        else
+            _cfg_default_model=$(sed -n '/^\s*defaults:/,/^\s*[a-z]/{ /^\s*model:/p; }' "$_cfg_to_read" 2>/dev/null | awk '{print $2}' | tr -d '[:space:]' || true)
+        fi
+        if [[ -n "$_cfg_default_model" ]]; then
+            for _agent_file in "$_agents_dir/"*.md; do
+                [[ -f "$_agent_file" ]] || continue
+                sed -i.bak "s/^model: .*/model: ${_cfg_default_model}/" "$_agent_file" && rm -f "${_agent_file}.bak"
+            done
+        fi
+
+        # Apply model overrides to agent frontmatter when present.
+        # Overrides YAML format: "  overrides:\n    sr-architect: opus"
+        _in_overrides=false
+        while IFS= read -r _line; do
+            if [[ "$_line" =~ ^[[:space:]]*overrides: ]]; then
+                # Check if overrides are on same line: overrides: { sr-architect: opus }
+                if [[ "$_line" =~ \{.*\} ]]; then
+                    _inline=$(echo "$_line" | sed 's/.*{//;s/}.*//;s/,/ /g')
+                    for _pair in $_inline; do
+                        _key="${_pair%%:*}"
+                        _val="${_pair##*:}"
+                        _agent_file="${REPO_ROOT}/.specrails/setup-templates/agents/${_key}.md"
+                        if [[ -f "$_agent_file" ]]; then
+                            sed -i.bak "s/^model: .*/model: ${_val}/" "$_agent_file" && rm -f "${_agent_file}.bak"
+                        fi
+                    done
+                    _in_overrides=false
+                else
+                    _in_overrides=true
+                fi
+            elif [[ "$_in_overrides" == true ]]; then
+                if [[ "$_line" =~ ^[[:space:]]{4}([a-z0-9_-]+):[[:space:]]*([a-z]+) ]]; then
+                    _key="${BASH_REMATCH[1]}"
+                    _val="${BASH_REMATCH[2]}"
+                    _agent_file="${REPO_ROOT}/.specrails/setup-templates/agents/${_key}.md"
+                    if [[ -f "$_agent_file" ]]; then
+                        sed -i.bak "s/^model: .*/model: ${_val}/" "$_agent_file" && rm -f "${_agent_file}.bak"
+                    fi
+                elif [[ ! "$_line" =~ ^[[:space:]]{4} ]]; then
+                    _in_overrides=false
+                fi
+            fi
+        done < "$_cfg_to_read"
+    fi
+fi
+
+# Write OSS detection results for /specrails:enrich
 cat > "$REPO_ROOT/.specrails/setup-templates/.oss-detection.json" << EOF
 {
   "is_oss": $IS_OSS,
@@ -569,7 +834,7 @@ cat > "$REPO_ROOT/.specrails/setup-templates/.oss-detection.json" << EOF
 EOF
 ok "OSS detection results written"
 
-# Write provider detection results for /setup
+# Write provider detection results for /specrails:enrich
 cat > "$REPO_ROOT/.specrails/setup-templates/.provider-detection.json" << EOF
 {
   "cli_provider": "$CLI_PROVIDER",
@@ -629,12 +894,12 @@ fi
 echo ""
 echo "  Files installed:"
 if [[ "$CLI_PROVIDER" == "codex" ]]; then
-    echo "    .agents/skills/setup/SKILL.md        ← The \$setup skill"
+    echo "    .agents/skills/enrich/SKILL.md       ← The \$enrich skill"
     echo "    .agents/skills/doctor/SKILL.md       ← The \$doctor skill"
 else
-    echo "    $SPECRAILS_DIR/commands/specrails/setup.md  ← The /specrails:setup command"
+    echo "    $SPECRAILS_DIR/commands/specrails/enrich.md  ← The /specrails:enrich command"
 fi
-echo "    .specrails/setup-templates/              ← Templates: commands + skills (temporary, removed after setup)"
+echo "    .specrails/setup-templates/              ← Templates: commands + skills (temporary, removed after enrich)"
 echo "    .specrails/specrails-version             ← Installed specrails version"
 echo "    .specrails/specrails-manifest.json       ← Artifact checksums for update detection"
 echo ""
@@ -653,12 +918,12 @@ echo "  1. Open $CLI_PROVIDER in this repo:"
 echo ""
 echo -e "     ${BOLD}cd $REPO_ROOT && $CLI_PROVIDER${NC}"
 echo ""
-echo "  2. Run the setup wizard:"
+echo "  2. Run the enrich wizard:"
 echo ""
 if [[ "$CLI_PROVIDER" == "codex" ]]; then
-    echo -e "     ${BOLD}\$setup${NC}"
+    echo -e "     ${BOLD}\$enrich${NC}"
 else
-    echo -e "     ${BOLD}/specrails:setup${NC}"
+    echo -e "     ${BOLD}/specrails:enrich${NC}"
 fi
 echo ""
 if [[ "$CLI_PROVIDER" == "codex" ]]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specrails-core",
-  "version": "3.5.3",
+  "version": "3.7.0",
   "description": "AI agent workflow system for Claude Code — installs 12 specialized agents, orchestration commands, and persona-driven product discovery into any repository",
   "bin": {
     "specrails-core": "bin/specrails-core.js"
@@ -14,8 +14,7 @@
     ".claude/skills/",
     "commands/",
     "docs/",
-    "VERSION",
-    "integration-contract.json"
+    "VERSION"
   ],
   "engines": {
     "node": ">=18.0.0"
@@ -54,6 +53,9 @@
     "test": "bash tests/run-all.sh",
     "test:coverage": "bash tests/run-coverage.sh"
   },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0"
+  },
   "license": "MIT",
   "author": "fjpulidop"
 }