rrskill 0.1.0

package/dist/install.sh

@@ -0,0 +1,580 @@
+#!/usr/bin/env bash
+# 文件作用：面向最终用户的安装脚本，负责准备 Node 运行时、安装 rrskill 并执行 bootstrap。
+set -euo pipefail
+
+# Keep these mirrored defaults aligned with src/installer/constants.ts.
+DEFAULT_HOST="openclaw"
+DEFAULT_BIN_NAME="rrskill"
+HOST="${RRSKILL_HOST:-$DEFAULT_HOST}"
+MIN_NODE_MAJOR=20
+NODE_VERSION="${RRSKILL_NODE_VERSION:-20.19.0}"
+INSTALL_BASE="${RRSKILL_INSTALL_BASE:-${HOME}/.rrskill}"
+RUNTIME_ROOT="${INSTALL_BASE}/runtime/node"
+MANAGED_NODE_DIR="${RUNTIME_ROOT}/v${NODE_VERSION}"
+CURRENT_NODE_DIR="${RUNTIME_ROOT}/current"
+NPM_PREFIX="${RRSKILL_NPM_PREFIX:-${INSTALL_BASE}/npm-global}"
+BIN_DIR="${RRSKILL_BIN_DIR:-${HOME}/.local/bin}"
+PACKAGE_SPEC="${RRSKILL_NPM_PACKAGE:-rrskill}"
+NODE_DOWNLOAD_BASE="${RRSKILL_NODE_DOWNLOAD_BASE:-https://nodejs.org/dist}"
+
+MODE="install"
+OUTPUT_MODE="text"
+SKIP_BOOTSTRAP=0
+BOOTSTRAP_SKIPPED=0
+
+NODE_BIN=""
+NPM_BIN=""
+RRSKILL_BIN=""
+
+STEP_RESULTS=()
+NEXT_COMMANDS=()
+LAST_CHANGED=false
+
+json_escape() {
+  printf '%s' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g'
+}
+
+record_step() {
+  local name="$1"
+  local status="$2"
+  local changed="${3:-false}"
+  local message="${4:-}"
+  local json
+
+  json="{\"name\":\"$(json_escape "$name")\",\"status\":\"$(json_escape "$status")\",\"changed\":${changed}"
+  if [[ -n "$message" ]]; then
+    json="${json},\"message\":\"$(json_escape "$message")\""
+  fi
+  json="${json}}"
+  STEP_RESULTS+=("$json")
+}
+
+add_next_command() {
+  NEXT_COMMANDS+=("$1")
+}
+
+render_steps_json() {
+  local first=1
+  printf '['
+  for step in "${STEP_RESULTS[@]-}"; do
+    if [[ $first -eq 0 ]]; then
+      printf ','
+    fi
+    first=0
+    printf '%s' "$step"
+  done
+  printf ']'
+}
+
+render_next_commands_json() {
+  local first=1
+  printf '['
+  for command in "${NEXT_COMMANDS[@]-}"; do
+    if [[ $first -eq 0 ]]; then
+      printf ','
+    fi
+    first=0
+    printf '"%s"' "$(json_escape "$command")"
+  done
+  printf ']'
+}
+
+emit_json_success() {
+  printf '{'
+  printf '"ok":true,'
+  printf '"mode":"%s",' "$(json_escape "$MODE")"
+  printf '"host":"%s",' "$(json_escape "$HOST")"
+  printf '"bootstrap_skipped":%s,' "$([[ $BOOTSTRAP_SKIPPED -eq 1 ]] && printf 'true' || printf 'false')"
+  printf '"steps":%s,' "$(render_steps_json)"
+  printf '"next_commands":%s' "$(render_next_commands_json)"
+  printf '}\n'
+}
+
+emit_json_error() {
+  local code="$1"
+  local message="$2"
+
+  printf '{'
+  printf '"ok":false,'
+  printf '"mode":"%s",' "$(json_escape "$MODE")"
+  printf '"host":"%s",' "$(json_escape "$HOST")"
+  printf '"error":{"code":"%s","message":"%s","host":"%s"},' \
+    "$(json_escape "$code")" \
+    "$(json_escape "$message")" \
+    "$(json_escape "$HOST")"
+  printf '"steps":%s,' "$(render_steps_json)"
+  printf '"next_commands":%s' "$(render_next_commands_json)"
+  printf '}\n'
+}
+
+log() {
+  if [[ "$OUTPUT_MODE" == "text" ]]; then
+    printf '[rrskill-install] %s\n' "$*"
+  fi
+}
+
+warn() {
+  if [[ "$OUTPUT_MODE" == "text" ]]; then
+    printf '[rrskill-install] Warning: %s\n' "$*" >&2
+  fi
+}
+
+die() {
+  local code="$1"
+  local message="$2"
+  local exit_code="${3:-1}"
+
+  if [[ "$OUTPUT_MODE" == "json" ]]; then
+    emit_json_error "$code" "$message"
+  else
+    printf '[rrskill-install] Error: %s\n' "$message" >&2
+  fi
+  exit "$exit_code"
+}
+
+usage() {
+  cat <<'USAGE'
+Usage: install.sh [--host <openclaw|codex|claude-code>] [--openclaw|--codex|--claude-code] [--check|--dry-run] [--skip-bootstrap] [--output <json|text>|--json]
+
+Modes:
+  --check            Verify current environment only and report missing steps
+  --dry-run          Print the planned initialization steps without changing anything
+  --skip-bootstrap   Install the CLI without attempting host bootstrap repair
+
+Examples:
+  install.sh --host openclaw
+  install.sh --host openclaw --check --output json
+  install.sh --host codex --skip-bootstrap --output json
+  install.sh --dry-run
+USAGE
+}
+
+default_retry_command() {
+  printf 'curl -fsSL https://rrskill.ai/install/install.sh | bash -s -- --host %s' "$HOST"
+}
+
+skip_bootstrap_retry_command() {
+  printf 'curl -fsSL https://rrskill.ai/install/install.sh | bash -s -- --host %s --skip-bootstrap' "$HOST"
+}
+
+validate_host() {
+  case "${HOST}" in
+    openclaw|codex|claude-code) ;;
+    *) die "unsupported_host" "unsupported host: ${HOST}" ;;
+  esac
+}
+
+validate_output_mode() {
+  case "${OUTPUT_MODE}" in
+    text|json) ;;
+    *) die "unsupported_output_mode" "unsupported output mode: ${OUTPUT_MODE}" ;;
+  esac
+}
+
+ensure_bootstrap_mode_allowed() {
+  if [[ "$HOST" == "openclaw" || $SKIP_BOOTSTRAP -eq 1 || "$MODE" == "check" || "$MODE" == "dry-run" ]]; then
+    return 0
+  fi
+
+  add_next_command "$(skip_bootstrap_retry_command)"
+  add_next_command "npm install -g rrskill"
+  die "unsupported_bootstrap_host" "bootstrap is currently supported only for openclaw; ${HOST} integration is not implemented yet"
+}
+
+parse_args() {
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --host)
+        [[ $# -ge 2 ]] || die "missing_host_value" "--host requires a value"
+        HOST="$2"
+        shift 2
+        ;;
+      --openclaw)
+        HOST="openclaw"
+        shift
+        ;;
+      --codex)
+        HOST="codex"
+        shift
+        ;;
+      --claude-code)
+        HOST="claude-code"
+        shift
+        ;;
+      --check)
+        MODE="check"
+        shift
+        ;;
+      --dry-run)
+        MODE="dry-run"
+        shift
+        ;;
+      --skip-bootstrap)
+        SKIP_BOOTSTRAP=1
+        shift
+        ;;
+      --output)
+        [[ $# -ge 2 ]] || die "missing_output_mode" "--output requires a value"
+        OUTPUT_MODE="$2"
+        shift 2
+        ;;
+      --json)
+        OUTPUT_MODE="json"
+        shift
+        ;;
+      -h|--help)
+        usage
+        exit 0
+        ;;
+      *)
+        die "unknown_argument" "unknown argument: $1"
+        ;;
+    esac
+  done
+}
+
+resolve_platform() {
+  local os
+  local arch
+
+  case "$(uname -s)" in
+    Darwin) os="darwin" ;;
+    Linux) os="linux" ;;
+    *) die "unsupported_os" "unsupported operating system: $(uname -s)" ;;
+  esac
+
+  case "$(uname -m)" in
+    x86_64|amd64) arch="x64" ;;
+    arm64|aarch64) arch="arm64" ;;
+    *) die "unsupported_arch" "unsupported architecture: $(uname -m)" ;;
+  esac
+
+  printf '%s %s\n' "$os" "$arch"
+}
+
+node_major_version() {
+  local version_text
+  version_text="$("$1" --version 2>/dev/null || true)"
+  version_text="${version_text#v}"
+  printf '%s\n' "${version_text%%.*}"
+}
+
+use_node_pair() {
+  NODE_BIN="$1"
+  NPM_BIN="$2"
+  export PATH="$(dirname "$NODE_BIN"):$PATH"
+}
+
+has_system_node() {
+  if ! command -v node >/dev/null 2>&1 || ! command -v npm >/dev/null 2>&1; then
+    return 1
+  fi
+
+  local system_major
+  system_major="$(node_major_version "$(command -v node)")"
+  [[ "$system_major" =~ ^[0-9]+$ ]] && (( system_major >= MIN_NODE_MAJOR ))
+}
+
+has_managed_node() {
+  if [[ ! -x "${CURRENT_NODE_DIR}/bin/node" || ! -x "${CURRENT_NODE_DIR}/bin/npm" ]]; then
+    return 1
+  fi
+
+  local current_major
+  current_major="$(node_major_version "${CURRENT_NODE_DIR}/bin/node")"
+  [[ "$current_major" =~ ^[0-9]+$ ]] && (( current_major >= MIN_NODE_MAJOR ))
+}
+
+check_npm_prefix() {
+  [[ -d "${NPM_PREFIX}/bin" && -d "${BIN_DIR}" ]]
+}
+
+check_cli_installed() {
+  [[ -x "${NPM_PREFIX}/bin/${DEFAULT_BIN_NAME}" ]]
+}
+
+check_bin_link() {
+  [[ -x "${BIN_DIR}/${DEFAULT_BIN_NAME}" ]]
+}
+
+check_openclaw_bootstrap() {
+  [[ -f "${HOME}/.openclaw/workspace/skills/find-skills/SKILL.md" ]] || return 1
+  [[ -f "${HOME}/.openclaw/workspace/skills/rrskill-preference/SKILL.md" ]] || return 1
+  [[ -f "${HOME}/.openclaw/extensions/rrskill/index.ts" ]] || return 1
+  [[ -f "${HOME}/.openclaw/extensions/rrskill/openclaw.plugin.json" ]] || return 1
+  [[ -f "${HOME}/.openclaw/openclaw.json" ]] || return 1
+
+  grep -q '"rrskill"' "${HOME}/.openclaw/openclaw.json" || return 1
+  grep -q '"primaryCli"[[:space:]]*:[[:space:]]*"rrskill"' "${HOME}/.openclaw/openclaw.json" || return 1
+  grep -q '"primaryLabel"[[:space:]]*:[[:space:]]*"official-registry"' "${HOME}/.openclaw/openclaw.json" || return 1
+}
+
+record_check_results() {
+  local all_ok=0
+
+  if has_system_node || has_managed_node; then
+    record_step "ensure_node" "ok" false "node runtime available"
+  else
+    all_ok=1
+    record_step "ensure_node" "missing" false "node runtime is not ready"
+    add_next_command "$(default_retry_command)"
+  fi
+
+  if check_npm_prefix; then
+    record_step "ensure_npm_prefix" "ok" false "npm prefix directories present"
+  else
+    all_ok=1
+    record_step "ensure_npm_prefix" "missing" false "npm prefix directories are missing"
+    add_next_command "$(default_retry_command)"
+  fi
+
+  if check_cli_installed; then
+    record_step "ensure_cli_installed" "ok" false "rrskill CLI is installed"
+  else
+    all_ok=1
+    record_step "ensure_cli_installed" "missing" false "rrskill CLI is not installed"
+    add_next_command "$(default_retry_command)"
+  fi
+
+  if check_bin_link; then
+    record_step "ensure_bin_link" "ok" false "rrskill executable link is present"
+  else
+    all_ok=1
+    record_step "ensure_bin_link" "missing" false "rrskill executable link is missing"
+    add_next_command "$(default_retry_command)"
+  fi
+
+  if [[ "$HOST" == "openclaw" && $SKIP_BOOTSTRAP -eq 0 ]]; then
+    if check_openclaw_bootstrap; then
+      record_step "run_bootstrap" "ok" false "openclaw bootstrap is complete"
+    else
+      all_ok=1
+      record_step "run_bootstrap" "missing" false "openclaw bootstrap is not complete"
+      add_next_command "rrskill bootstrap --host openclaw"
+    fi
+  elif [[ $SKIP_BOOTSTRAP -eq 1 ]]; then
+    BOOTSTRAP_SKIPPED=1
+    record_step "run_bootstrap" "skipped" false "bootstrap explicitly skipped"
+  else
+    BOOTSTRAP_SKIPPED=1
+    record_step "run_bootstrap" "skipped" false "bootstrap integration is not implemented for this host"
+    add_next_command "rrskill search <query>"
+    add_next_command "rrskill install <slug>"
+  fi
+
+  return "$all_ok"
+}
+
+run_check_mode() {
+  set +e
+  record_check_results
+  local ok=$?
+  set -e
+
+  if [[ "$OUTPUT_MODE" == "json" ]]; then
+    if [[ "$ok" -eq 0 ]]; then
+      emit_json_success
+      exit 0
+    fi
+
+    emit_json_error "environment_not_ready" "rrskill environment is not fully initialized"
+    exit 1
+  fi
+
+  if [[ "$ok" -eq 0 ]]; then
+    log "Environment check passed"
+    exit 0
+  fi
+
+  die "environment_not_ready" "rrskill environment is not fully initialized"
+}
+
+run_dry_run_mode() {
+  record_step "ensure_node" "planned" false "would ensure a supported Node runtime"
+  record_step "ensure_npm_prefix" "planned" false "would ensure npm prefix directories"
+  record_step "ensure_cli_installed" "planned" false "would install rrskill via npm"
+  record_step "ensure_bin_link" "planned" false "would link rrskill into the final bin directory"
+
+  if [[ "$HOST" == "openclaw" && $SKIP_BOOTSTRAP -eq 0 ]]; then
+    record_step "run_bootstrap" "planned" false "would run rrskill bootstrap for openclaw"
+  else
+    BOOTSTRAP_SKIPPED=1
+    record_step "run_bootstrap" "planned" false "would skip bootstrap for this host"
+  fi
+
+  if [[ "$OUTPUT_MODE" == "json" ]]; then
+    emit_json_success
+  else
+    log "Dry run complete"
+  fi
+  exit 0
+}
+
+install_managed_node() {
+  command -v curl >/dev/null 2>&1 || die "missing_curl" "curl is required to install a managed Node runtime"
+  command -v tar >/dev/null 2>&1 || die "missing_tar" "tar is required to install a managed Node runtime"
+
+  if has_managed_node; then
+    log "Using previously installed managed Node ${NODE_VERSION}"
+    use_node_pair "${CURRENT_NODE_DIR}/bin/node" "${CURRENT_NODE_DIR}/bin/npm"
+    LAST_CHANGED=false
+    return 0
+  fi
+
+  local os
+  local arch
+  read -r os arch <<<"$(resolve_platform)"
+
+  local archive_name
+  archive_name="node-v${NODE_VERSION}-${os}-${arch}.tar.xz"
+
+  local tmp_dir
+  tmp_dir="$(mktemp -d)"
+  local archive_path="${tmp_dir}/${archive_name}"
+
+  log "Installing managed Node ${NODE_VERSION} (${os}/${arch})"
+  curl -fsSL "${NODE_DOWNLOAD_BASE}/v${NODE_VERSION}/${archive_name}" -o "${archive_path}"
+  tar -xJf "${archive_path}" -C "${tmp_dir}"
+
+  local extracted_node
+  extracted_node="$(find "${tmp_dir}" -type f -path '*/bin/node' | head -n 1 || true)"
+  [[ -n "${extracted_node}" ]] || die "missing_extracted_node" "failed to locate extracted node binary"
+
+  local extracted_root
+  extracted_root="$(dirname "$(dirname "${extracted_node}")")"
+
+  mkdir -p "${RUNTIME_ROOT}"
+  rm -rf "${MANAGED_NODE_DIR}"
+  cp -R "${extracted_root}" "${MANAGED_NODE_DIR}"
+  rm -rf "${CURRENT_NODE_DIR}"
+  ln -s "${MANAGED_NODE_DIR}" "${CURRENT_NODE_DIR}"
+  rm -rf "${tmp_dir}"
+
+  use_node_pair "${CURRENT_NODE_DIR}/bin/node" "${CURRENT_NODE_DIR}/bin/npm"
+  LAST_CHANGED=true
+}
+
+ensure_node() {
+  if has_system_node; then
+    local system_node
+    local system_npm
+    local system_major
+    system_node="$(command -v node)"
+    system_npm="$(command -v npm)"
+    system_major="$(node_major_version "${system_node}")"
+    log "Using system Node ${system_major}"
+    use_node_pair "${system_node}" "${system_npm}"
+    record_step "ensure_node" "ok" false "using supported system Node"
+    return 0
+  fi
+
+  if command -v node >/dev/null 2>&1 && command -v npm >/dev/null 2>&1; then
+    log "System Node is too old; installing managed Node ${NODE_VERSION}"
+  else
+    log "Node/npm not found; installing managed Node ${NODE_VERSION}"
+  fi
+
+  install_managed_node
+  record_step "ensure_node" "ok" "$LAST_CHANGED" "managed Node runtime is ready"
+}
+
+ensure_npm_prefix() {
+  local changed=false
+  if ! check_npm_prefix; then
+    changed=true
+  fi
+
+  mkdir -p "${NPM_PREFIX}/bin" "${BIN_DIR}"
+  export NPM_CONFIG_PREFIX="${NPM_PREFIX}"
+  export PATH="${NPM_PREFIX}/bin:$PATH"
+
+  record_step "ensure_npm_prefix" "ok" "$changed" "npm prefix directories are ready"
+}
+
+ensure_rrskill_installed() {
+  log "Installing ${PACKAGE_SPEC} via npm"
+  "${NPM_BIN}" install -g "${PACKAGE_SPEC}"
+  record_step "ensure_cli_installed" "ok" true "rrskill CLI installed via npm"
+}
+
+ensure_bin_link() {
+  local target="${NPM_PREFIX}/bin/${DEFAULT_BIN_NAME}"
+  [[ -x "${target}" ]] || die "missing_cli_binary" "expected ${DEFAULT_BIN_NAME} binary at ${target} after npm install"
+
+  local changed=true
+  if [[ -L "${BIN_DIR}/${DEFAULT_BIN_NAME}" ]]; then
+    local existing_target
+    existing_target="$(readlink "${BIN_DIR}/${DEFAULT_BIN_NAME}" || true)"
+    if [[ "${existing_target}" == "${target}" ]]; then
+      changed=false
+    fi
+  fi
+
+  mkdir -p "${BIN_DIR}"
+  rm -f "${BIN_DIR}/${DEFAULT_BIN_NAME}"
+  ln -s "${target}" "${BIN_DIR}/${DEFAULT_BIN_NAME}"
+  RRSKILL_BIN="${BIN_DIR}/${DEFAULT_BIN_NAME}"
+
+  record_step "ensure_bin_link" "ok" "$changed" "rrskill executable link is ready"
+}
+
+warn_if_bin_dir_missing_from_path() {
+  case ":${PATH}:" in
+    *":${BIN_DIR}:"*) ;;
+    *)
+      warn "${BIN_DIR} is not on PATH. You may need to add it before running rrskill in a new shell."
+      ;;
+  esac
+}
+
+run_bootstrap() {
+  if [[ $SKIP_BOOTSTRAP -eq 1 ]]; then
+    BOOTSTRAP_SKIPPED=1
+    record_step "run_bootstrap" "skipped" false "bootstrap explicitly skipped"
+    return 0
+  fi
+
+  if [[ "$HOST" != "openclaw" ]]; then
+    BOOTSTRAP_SKIPPED=1
+    record_step "run_bootstrap" "skipped" false "bootstrap integration is not implemented for this host"
+    return 0
+  fi
+
+  log "Running rrskill bootstrap --host ${HOST}"
+  "${RRSKILL_BIN}" bootstrap --host "${HOST}"
+  record_step "run_bootstrap" "ok" true "bootstrap completed"
+}
+
+run_install_mode() {
+  ensure_node
+  ensure_npm_prefix
+  ensure_rrskill_installed
+  ensure_bin_link
+  warn_if_bin_dir_missing_from_path
+  run_bootstrap
+
+  if [[ "$OUTPUT_MODE" == "json" ]]; then
+    emit_json_success
+  else
+    log "Install complete"
+  fi
+}
+
+main() {
+  parse_args "$@"
+  validate_output_mode
+  validate_host
+
+  if [[ "$MODE" == "check" ]]; then
+    run_check_mode
+  fi
+
+  if [[ "$MODE" == "dry-run" ]]; then
+    run_dry_run_mode
+  fi
+
+  ensure_bootstrap_mode_allowed
+  run_install_mode
+}
+
+main "$@"