KeiSeiKit-1.0/install.sh
Parfii-bot 72d257e602 feat(install): Rust binary acquisition for fresh-clone installs (Path A + Path B)
Pre-fix: install.sh on a fresh clone has no binaries — target/ is gitignored,
copy_prebuilt_substrate_binaries() skips silently with "no pre-built found",
end users get zero kei-fork / kei-ledger / kei-cortex / etc.

New module: install/lib-rust-prebuild.sh (~120 LOC, Constructor Pattern).

  ensure_rust_binaries() — main entry, idempotent
    1. has_prebuilt_substrate_binaries() — quorum check (5+ kit binaries already in
       target/release/ → no-op).
    2. Else Path A: download keisei-${TARGET}.tar.gz from
       https://github.com/KeiSei84/KeiSeiKit-1.0/releases/latest/download/
       Detects target via uname (x86_64/aarch64 × darwin/linux), verifies
       sha256, extracts into target/release/.
    3. Path A fail (404, network, sha mismatch) → Path B fallback:
       cargo build --release --workspace (slow first time, requires Rust).
    4. Path B fail (no cargo) → say + return non-zero.

  Bypass: KEI_SKIP_RUST=1 — skip both paths (markdown-only install).

Wired in install/lib-rust.sh — ensure_rust_binaries() called BEFORE
copy_prebuilt_substrate_binaries() in regenerate_rust_workspace.

Path A activates ONLY after a v* tag is pushed and release.yml uploads
tarballs to github releases. Until then, Path A 404s and Path B kicks in.
This commit lays the wire — release tag is a separate user-driven action.

Verify:
- bash -n install.sh: OK
- bash -n install/lib-rust-prebuild.sh: OK
- detect_rust_target on this host: aarch64-apple-darwin
- has_prebuilt_substrate_binaries: correctly returns false on partial dev
  target (only kei-memory + kei-db-contract built locally today)

Out of scope (not done in this commit):
- Tag v0.X release to populate github tarballs (deploy step, deferred)
- Update keiseikit.dev/install.sh redirect target (downstream wiring)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 19:07:55 +08:00

181 lines
6.8 KiB
Bash
Executable file

#!/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
# --- 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"
# --- 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-args.sh
source "$LIB_DIR/lib-args.sh"
# shellcheck source=install/lib-menu.sh
source "$LIB_DIR/lib-menu.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"
# --- parse flags + install rollback trap ---------------------------------
parse_args "$@"
setup_backup_trap
# --- --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
# --- 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) ;;
*)
err "unknown profile: $PROFILE. Valid: minimal | core | frontend | ops | dev | mcp | cortex | local-mirror | dashboard | full-hub | full"
exit 1
;;
esac
say "profile: $PROFILE"
# --- prerequisites -------------------------------------------------------
check_prereqs
# --- confirm screen + --no-execute ---------------------------------------
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
if [ "$NO_EXECUTE" = "1" ]; then
say "--no-execute: plan resolved, exiting before install"
exit 0
fi
# --- execute install phases ----------------------------------------------
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
if [ "$WITH_PATHWAY" = "1" ] || { [ -t 0 ] && [ -t 1 ]; }; then
pathway_install
fi
fi
# --- final summary --------------------------------------------------------
print_summary