KeiSeiKit-1.0/install.sh

#!/usr/bin/env bash
# KeiSeiKit — Constructor-Pattern Agent Kit installer
# Idempotent: safe to re-run. Never overwrites settings.json or existing user manifests.
#
# Usage:
#   ./install.sh                           # interactive menu on TTY; profile=minimal on non-TTY
#   ./install.sh --profile=<name>          # minimal|core|frontend|ops|dev|mcp|cortex|full  (skips menu)
#   ./install.sh --add=<name>[,<name>]     # install one or more primitives on top of current state
#   ./install.sh --remove=<name>           # remove a single primitive
#   ./install.sh --list                    # list installed primitives (name | kind | desc | path)
#   ./install.sh --with-bridges            # also render cross-tool bridges into $PWD
#   ./install.sh --with-pathway            # force PATH wiring (auto-on for TTY)
#   ./install.sh --no-pathway              # force-skip PATH wiring (CI / nix)
#   ./install.sh --activate-hooks          # jq-merge settings-snippet.json into ~/.claude/settings.json
#   ./install.sh --yes                     # skip confirm screen after menu (automation)
#   ./install.sh --no-execute              # parse menu+confirm, print plan, exit (testing)
#
# Internals: this file is a thin orchestrator. All implementation lives in
# install/lib-*.sh cubes (Constructor Pattern: 1 file = 1 concern, <200 LOC).

set -euo pipefail

# --- OS guard (v0.47): friendly message on bare Windows ------------------
_uname_s="$(uname -s 2>/dev/null || echo unknown)"
case "$_uname_s" in
    Darwin|Linux) ;;  # ok
    MINGW*|MSYS*|CYGWIN*)
        echo "[install.sh] ERROR: bare Windows ($_uname_s) detected." >&2
        echo "" >&2
        echo "KeiSeiKit's substrate is Bash-only. Use WSL2 instead:" >&2
        echo "  1. PowerShell (admin):  wsl --install -d Ubuntu" >&2
        echo "  2. Reboot when prompted; launch Ubuntu." >&2
        echo "  3. Inside Ubuntu, re-run this installer." >&2
        echo "" >&2
        echo "See README → 'Platforms' for the full path + MCP-only fallback." >&2
        exit 1
        ;;
    *)
        echo "[install.sh] ERROR: unsupported OS: $_uname_s (supported: Darwin / Linux / WSL2)" >&2
        exit 1
        ;;
esac
unset _uname_s

# --- paths ----------------------------------------------------------------
KIT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
HOME_DIR="${HOME:?HOME not set}"
AGENTS_DIR="$HOME_DIR/.claude/agents"
HOOKS_DIR="$HOME_DIR/.claude/hooks"
SKILLS_DIR="$HOME_DIR/.claude/skills"
MANIFEST="$KIT_DIR/_primitives/MANIFEST.toml"
INSTALLED_FILE="$AGENTS_DIR/_primitives/.installed"
LIB_DIR="$KIT_DIR/install"

# --- v0.49: interactive-prompt cube (Constructor Pattern SSoT) -----------
# ALL interactive logic — `kei_is_interactive`, `kei_prompt`, `kei_prompt_yn`,
# `kei_prompt_secret` — lives in scripts/kei-prompt.sh. NEVER inline
# `[ -t 0 ]` or `read -r` in installer code. Source it BEFORE other libs
# so they can use the helpers.
if [ -r "$KIT_DIR/scripts/kei-prompt.sh" ]; then
    # shellcheck source=scripts/kei-prompt.sh
    source "$KIT_DIR/scripts/kei-prompt.sh"
elif [ -r "$HOME/.claude/scripts/kei-prompt.sh" ]; then
    # shellcheck disable=SC1091
    source "$HOME/.claude/scripts/kei-prompt.sh"
else
    # Self-contained fallback — same contract as the cube's kei_is_interactive.
    kei_is_interactive() {
        [ "${KEI_NONINTERACTIVE:-0}" = "1" ] && return 1
        if [ -r /dev/tty ] && [ -w /dev/tty ]; then return 0; fi
        [ -t 0 ] && return 0
        return 1
    }
fi

# --- source cubes (order matters: logs -> backup -> profile -> rest) ------
# shellcheck source=install/lib-log.sh
source "$LIB_DIR/lib-log.sh"
# shellcheck source=install/lib-backup.sh
source "$LIB_DIR/lib-backup.sh"
# shellcheck source=install/lib-profile.sh
source "$LIB_DIR/lib-profile.sh"
# shellcheck source=install/lib-packs.sh
source "$LIB_DIR/lib-packs.sh"
# shellcheck source=install/lib-args.sh
source "$LIB_DIR/lib-args.sh"
# shellcheck source=install/lib-menu.sh
source "$LIB_DIR/lib-menu.sh"
# shellcheck source=install/lib-i18n.sh
source "$LIB_DIR/lib-i18n.sh"
# Загружаем английский словарь по умолчанию — welcome banner идёт до выбора языка.
i18n_load_default
# shellcheck source=install/lib-preflight.sh
source "$LIB_DIR/lib-preflight.sh"
# shellcheck source=install/lib-onboarding.sh
source "$LIB_DIR/lib-onboarding.sh"
# shellcheck source=install/lib-plan.sh
source "$LIB_DIR/lib-plan.sh"
# shellcheck source=install/lib-prereqs.sh
source "$LIB_DIR/lib-prereqs.sh"
# shellcheck source=install/lib-primitives.sh
source "$LIB_DIR/lib-primitives.sh"
# shellcheck source=install/lib-rust.sh
source "$LIB_DIR/lib-rust.sh"
# shellcheck source=install/lib-substrate.sh
source "$LIB_DIR/lib-substrate.sh"
# shellcheck source=install/lib-rust-mirror.sh
source "$LIB_DIR/lib-rust-mirror.sh"
# shellcheck source=install/lib-rust-prebuild.sh
source "$LIB_DIR/lib-rust-prebuild.sh"
# shellcheck source=install/lib-scaffold.sh
source "$LIB_DIR/lib-scaffold.sh"
# shellcheck source=install/lib-bridges.sh
source "$LIB_DIR/lib-bridges.sh"
# shellcheck source=install/lib-hooks.sh
source "$LIB_DIR/lib-hooks.sh"
# shellcheck source=install/lib-agents.sh
source "$LIB_DIR/lib-agents.sh"
# shellcheck source=install/lib-skills.sh
source "$LIB_DIR/lib-skills.sh"
# shellcheck source=install/lib-wizard.sh
source "$LIB_DIR/lib-wizard.sh"
# shellcheck source=install/lib-pathway.sh
source "$LIB_DIR/lib-pathway.sh"
# shellcheck source=install/lib-bin.sh
source "$LIB_DIR/lib-bin.sh"
# shellcheck source=install/lib-summary.sh
source "$LIB_DIR/lib-summary.sh"
# shellcheck source=install/lib-profile-outcome-only.sh
source "$LIB_DIR/lib-profile-outcome-only.sh"

# --- parse flags + install rollback trap ---------------------------------
parse_args "$@"
setup_backup_trap

# Fix 3: --dry-run is only meaningful with --profile=outcome-only.
# Warn early so the user doesn't assume other profiles respect it.
if [ "${OUTCOME_DRY_RUN:-0}" = "1" ] && [ "$PROFILE" != "outcome-only" ] && [ -n "$PROFILE" ]; then
  warn "--dry-run is only effective with --profile=outcome-only; for other profiles use --no-execute"
fi

# --- --list short-circuit -------------------------------------------------
if [ "$LIST_MODE" = "1" ]; then
  [ -f "$MANIFEST" ] || { err "MANIFEST.toml missing: $MANIFEST"; exit 2; }
  cmd_list
  exit 0
fi

# --- --rebuild-rust short-circuit (dev-mode mirror) ----------------------
if [ "$REBUILD_RUST_FLAG" = "1" ]; then
  if ! is_dev_mode; then
    say "rust-mirror: not in dev mode (no fat workspace at $KIT_DIR/_primitives/_rust/Cargo.toml)"
    say "rust-mirror: nothing to rebuild — kit users get fresh binaries via release tarball"
    exit 0
  fi
  if [ -n "$REBUILD_RUST_LIST" ]; then
    # Comma-separated list → individual args
    # shellcheck disable=SC2086
    rebuild_and_mirror_rust ${REBUILD_RUST_LIST//,/ }
  else
    rebuild_and_mirror_rust
  fi
  exit 0
fi

# --- incremental --add / --remove short-circuit --------------------------
if [ -n "$ADD_LIST" ] || [ -n "$REMOVE_NAME" ]; then
  run_incremental_change
  exit 0
fi

# --- outcome-only profile short-circuit (see docs/PROFILE-OUTCOME-ONLY.md) ---
if [ "${PROFILE:-}" = "outcome-only" ]; then
  _outcome_confirm_if_needed
  export OUTCOME_DRY_RUN
  install_profile_outcome_only
  exit 0
fi

# --- interactive menu (option C hybrid) ----------------------------------
# Runs ONLY when: no selection flag passed AND stdin+stdout are TTY AND
# --list / --add / --remove short-circuits above did NOT fire.
run_menu_if_needed || exit 1

# --- resolve profile (default=minimal) -----------------------------------
PROFILE="${PROFILE:-minimal}"
case "$PROFILE" in
  minimal|core|frontend|ops|dev|mcp|cortex|full|custom|local-mirror|dashboard|full-hub|outcome-only) ;;
  *)
    err "unknown profile: $PROFILE. Valid: outcome-only | minimal | core | frontend | ops | dev | mcp | cortex | local-mirror | dashboard | full-hub | full"
    exit 1
    ;;
esac
say "profile: $PROFILE"
# Stamp the chosen profile so `kei` splash + tools can show it (bin/kei reads this).
mkdir -p "$HOME_DIR/.claude" 2>/dev/null || true
printf '%s\n' "$PROFILE" > "$HOME_DIR/.claude/.kei-profile" 2>/dev/null || true
# Stamp the kit checkout dir so `kei configure` can re-source the libs later.
printf '%s\n' "$KIT_DIR" > "$HOME_DIR/.claude/.kei-kit-dir" 2>/dev/null || true

# --- resolve profile -> primitive list (UNCONDITIONAL, SSoT) -------------
# Must run BEFORE any reader of PROFILE_PRIMS: the --no-execute plan block
# below, the --skip-prereqs path (which bypasses check_prereqs), and the
# conditional cargo gate in check_hard_prereqs. Previously this lived only
# inside check_prereqs, so --no-execute / --skip-prereqs saw PROFILE_PRIMS
# unbound and silently resolved to 0 primitives.
resolve_profile_prims

# --- skip heavy substrate workspace build for no-rust-primitive profiles --
# The agent assembler always compiles (tiny), but the 105-crate substrate
# workspace (kei-fork / kei-ledger / kei-cortex / ...) only matters for
# profiles that ship rust primitives. With no prebuilt release binaries,
# every install would otherwise fall back to a 5-15 min `cargo build
# --workspace`. Auto-skip keeps minimal / shell-only profiles fast. An
# explicit user-set KEI_SKIP_RUST always wins.
if [ -z "${KEI_SKIP_RUST:-}" ] && ! _profile_needs_cargo; then
  export KEI_SKIP_RUST=1
  say "no rust primitives in profile=$PROFILE -> skipping substrate workspace build (assembler only)"
fi

# --- welcome banner + onboarding wizard ----------------------------------
# Banner всегда EN — пользователь ещё не выбрал язык.
# Wizard: TTY + нет ~/.claude/.onboarded + не задан KEISEI_SKIP_ONBOARD.
# Skip: KEISEI_SKIP_ONBOARD=1 ./install.sh
if onboarding_should_run; then
  i18n_print_welcome
fi
onboarding_run

# --- early exit: --no-execute или --skip-prereqs ДО prereqs --------------
# Это позволяет смотреть план без установленных зависимостей.
if [ "$NO_EXECUTE" = "1" ]; then
  CONFIRM_LABEL="$PROFILE"
  [ "$PROFILE" = "custom" ] && CONFIRM_LABEL="custom ($CUSTOM_PRIMS)"
  CONFIRM_INPUT="$(printf '%s\n' $PROFILE_PRIMS | grep -v '^$' || true)"
  printf '%s\n' "$CONFIRM_INPUT" | show_confirm_screen "$CONFIRM_LABEL" || true
  say "--no-execute: plan resolved, exiting before install"
  exit 0
fi

# --- prerequisites -------------------------------------------------------
if [ "$SKIP_PREREQS" != "1" ]; then
  check_prereqs
fi

# --- confirm screen ------------------------------------------------------
CONFIRM_LABEL="$PROFILE"
[ "$PROFILE" = "custom" ] && CONFIRM_LABEL="custom ($CUSTOM_PRIMS)"
CONFIRM_INPUT="$(printf '%s\n' $PROFILE_PRIMS | grep -v '^$' || true)"
if ! printf '%s\n' "$CONFIRM_INPUT" | show_confirm_screen "$CONFIRM_LABEL"; then
  say "install declined at confirm screen — aborting"
  exit 1
fi

# --- execute install phases ----------------------------------------------
kei_banner
setup_target_dirs
scaffold_memory_index
install_blocks
install_roles
install_capabilities
run_primitives_phase
install_bridges
install_manifests
build_assembler
generate_agents
install_hooks
install_skills
install_bin
maybe_activate_hooks

# Bail out cleanly if the rollback trap already fired (activate_hooks err path).
if [ "${ROLLED_BACK:-0}" = "1" ]; then
  exit 2
fi

# --- optional post-install hooks ------------------------------------------
[ "$WITH_BRIDGES"    = "1" ] && render_bridges
[ "$WITH_SLEEP_SYNC" = "1" ] && run_sleep_wizard

# --- substrate PATH wiring (Wave 39) --------------------------------------
# Forced on by --with-pathway, forced off by --no-pathway. Default: auto-on
# for interactive TTY installs. Substrate binaries are copied to
# target/release/ regardless of profile (lib-substrate.sh), so PATH wiring
# is meaningful for every profile except minimal-without-prebuilt.
if [ "$NO_PATHWAY" != "1" ]; then
  # Gate on interactive stdin only — NOT -t 1: curl|bash tees stdout to a
  # logfile, so -t 1 is false even interactively. Requiring it skipped PATH
  # wiring (~/.claude/bin), so the `kei` entry-point was not found after a
  # curl|bash install. (Same tee/-t1 trap as the onboarding gates.)
  if [ "$WITH_PATHWAY" = "1" ] || kei_is_interactive; then
    pathway_install
  fi
fi

# --- final summary --------------------------------------------------------
print_summary