superpowers-manager 0.1.6 → 0.3.0

package/scripts/core/adapter.sh

@@ -1,92 +0,0 @@
-#!/bin/sh
-# Sourced module; callers own set -eu.
-
-spw_adapter_package_root() {
-  if [ -n "${SPW_PACKAGE_ROOT:-}" ]; then
-    printf '%s\n' "$SPW_PACKAGE_ROOT"
-  elif [ -n "${root:-}" ]; then
-    printf '%s\n' "$root"
-  else
-    spw_root
-  fi
-}
-
-SPW_ADAPTER_ROOT=$(spw_adapter_package_root)
-SPW_ADAPTER="${SPW_ADAPTER:-$SPW_ADAPTER_ROOT/scripts/adapters/codex/adapter}"
-SPW_ADAPTER_RESPONSE_VALIDATOR="${SPW_ADAPTER_RESPONSE_VALIDATOR:-$SPW_ADAPTER_ROOT/scripts/core/validate-adapter-response.py}"
-
-spw_invoke_adapter() {
-  operation="$1"
-  result_file="$2"
-  inspect_view="$3"
-  shift 3
-  [ "${1:-}" = "--" ] || spw_die "internal adapter invocation missing --"
-  shift
-
-  response_file="${result_file}.response"
-  adapter_exit=0
-  "$SPW_ADAPTER" "$operation" "$@" > "$response_file" || adapter_exit=$?
-
-  args=""
-  if [ -n "$inspect_view" ]; then
-    args="$inspect_view"
-  fi
-  if [ -n "$args" ]; then
-    python3 -S "$SPW_ADAPTER_RESPONSE_VALIDATOR" \
-      --operation "$operation" --adapter-exit "$adapter_exit" \
-      --response "$response_file" --result "$result_file" \
-      --inspect-view "$inspect_view"
-  else
-    python3 -S "$SPW_ADAPTER_RESPONSE_VALIDATOR" \
-      --operation "$operation" --adapter-exit "$adapter_exit" \
-      --response "$response_file" --result "$result_file"
-  fi
-}
-
-spw_adapter_result_get() {
-  result_file="$1"
-  dotted_key="$2"
-  spw_json_get "$result_file" "$dotted_key"
-}
-
-spw_adapter_result_boolean() {
-  result_file="$1"
-  dotted_key="$2"
-  value=$(spw_adapter_result_get "$result_file" "$dotted_key")
-  case "$value" in
-    true|True)
-      printf 'true\n'
-      ;;
-    false|False)
-      printf 'false\n'
-      ;;
-    *)
-      spw_die "expected Boolean adapter result at $dotted_key in $result_file"
-      ;;
-  esac
-}
-
-spw_inspect_fingerprint() {
-  result_file="$1"
-  spw_invoke_adapter inspect "$result_file" fingerprint -- --view fingerprint
-}
-
-spw_inspect_ownership() {
-  result_file="$1"
-  spw_invoke_adapter inspect "$result_file" ownership -- --view ownership
-}
-
-spw_adapter_install() {
-  result_file="$1"
-  package_root="$2"
-  spw_invoke_adapter install "$result_file" "" -- --package-root "$package_root"
-}
-
-spw_adapter_uninstall() {
-  result_file="$1"
-  plugin_present="$2"
-  marketplace_present="$3"
-  spw_invoke_adapter uninstall "$result_file" "" -- \
-    --plugin-present "$plugin_present" \
-    --marketplace-present "$marketplace_present"
-}

package/scripts/core/common.sh

@@ -1,35 +0,0 @@
-#!/bin/sh
-# Sourced module; callers own set -eu.
-
-spw_die() {
-  echo "error: $*" >&2
-  exit 1
-}
-
-spw_require_command() {
-  command_name="$1"
-  if ! command -v "$command_name" >/dev/null 2>&1; then
-    spw_die "required command not found: $command_name"
-  fi
-}
-
-spw_root() {
-  CDPATH= cd -- "$(dirname "$0")/.." && pwd
-}
-
-spw_copy_path_if_present() {
-  src="$1"
-  dst="$2"
-  if [ -e "$src" ]; then
-    rm -rf "$dst"
-    cp -R "$src" "$dst"
-  fi
-}
-
-spw_require_upstream_path() {
-  path="$1"
-  label="$2"
-  if [ ! -e "$path" ]; then
-    spw_die "required upstream path missing: $label"
-  fi
-}

package/scripts/core/lifecycle.sh

@@ -1,127 +0,0 @@
-#!/bin/sh
-# Sourced module; callers own set -eu.
-
-# Replace the live tree with a single atomic rename, keeping a backup so a
-# failed swap restores the previous working generated tree. candidate and
-# live_root must be same-filesystem siblings for atomic renames.
-spw_replace_generated_tree() {
-  candidate="$1"
-  live_root="$2"
-  parent=$(dirname "$live_root")
-  backup="$parent/.superpowers.bak.$$"
-
-  rm -rf "$backup"
-  if [ -e "$live_root" ]; then
-    mv "$live_root" "$backup"
-  fi
-  if mv "$candidate" "$live_root"; then
-    rm -rf "$backup"
-  else
-    if [ -e "$backup" ]; then
-      mv "$backup" "$live_root"
-    fi
-    rm -rf "$candidate"
-    spw_die "failed to install generated tree into $live_root; previous tree restored"
-  fi
-}
-
-spw_generated_metadata_path() (
-  generated_root="$1"
-  printf '%s\n' "$generated_root/plugins/superpowers/.superpowers-upstream.json"
-)
-
-spw_generated_commit_or_empty() (
-  generated_root="$1"
-  generated_metadata=$(spw_generated_metadata_path "$generated_root")
-  spw_metadata_commit_lenient_or_empty "$generated_metadata"
-)
-
-spw_require_no_legacy_state() {
-  identity_state="$1"
-  case "$identity_state" in
-    neither|manager)
-      return 0
-      ;;
-    legacy|both)
-      printf '%s\n' \
-        'Legacy superpowers-wrapper Codex state is installed.' \
-        'Run: npx superpowers-wrapper@0.1.1 uninstall' \
-        'Then run: npx superpowers-manager install' >&2
-      return 1
-      ;;
-    *)
-      spw_die "unknown adapter identity state: $identity_state"
-      ;;
-  esac
-}
-
-spw_report_legacy_state() {
-  case "$1" in
-    legacy|both)
-      printf '%s\n' \
-        'Legacy superpowers-wrapper Codex state remains installed.' \
-        'Run: npx superpowers-wrapper@0.1.1 uninstall'
-      ;;
-    neither|manager)
-      ;;
-    *)
-      spw_die "unknown adapter identity state: $1"
-      ;;
-  esac
-}
-
-spw_verify_installed_fingerprint() {
-  desired_commit="$1"
-  install_result="$2"
-  inspect_result="$3"
-  if ! spw_inspect_fingerprint "$inspect_result"; then
-    echo "error: installed manager fingerprint inspection failed after install." >&2
-    return 1
-  fi
-  if ! installed_commit=$(spw_adapter_result_get "$inspect_result" "fingerprint"); then
-    echo "error: cannot parse installed manager fingerprint inspection result after install." >&2
-    return 1
-  fi
-  printf 'desired_commit=%s\n' "$desired_commit"
-  printf 'installed_commit=%s\n' "$installed_commit"
-  if [ -n "$installed_commit" ] && spw_commit_matches "$desired_commit" "$installed_commit"; then
-    echo "manager updated"
-    return 0
-  fi
-
-  hint=""
-  if [ -f "$install_result" ]; then
-    if [ -n "$installed_commit" ]; then
-      hint=$(spw_adapter_result_get "$install_result" "verification_hints.mismatch" || true)
-    else
-      hint=$(spw_adapter_result_get "$install_result" "verification_hints.missing" || true)
-    fi
-  fi
-
-  if [ -n "$installed_commit" ]; then
-    echo "error: installed manager fingerprint does not match the prepared plugin after install." >&2
-  else
-    echo "error: installed manager fingerprint is not detectable after install." >&2
-  fi
-  if [ -n "$hint" ]; then
-    echo "hint: $hint" >&2
-  fi
-  return 1
-}
-
-spw_verify_uninstalled_resources() {
-  inspect_result="$1"
-
-  if ! plugin_present=$(spw_adapter_result_boolean "$inspect_result" "resources.plugin"); then
-    return 1
-  fi
-  if ! marketplace_present=$(spw_adapter_result_boolean "$inspect_result" "resources.marketplace"); then
-    return 1
-  fi
-  if [ "$plugin_present" = true ]; then
-    spw_die "owned plugin resource is still installed after removal"
-  fi
-  if [ "$marketplace_present" = true ]; then
-    spw_die "owned marketplace resource is still registered after removal"
-  fi
-}

package/scripts/core/provenance.sh

@@ -1,135 +0,0 @@
-#!/bin/sh
-# Sourced module; callers own set -eu.
-
-spw_json_get() {
-  file="$1"
-  key="$2"
-  if ! value=$(
-    python3 - "$file" "$key" 2>&1 <<'PY'
-import json
-import sys
-
-path, dotted_key = sys.argv[1:]
-MAX_JSON_NESTING = 256
-
-def reject_constant(constant):
-    raise ValueError(f"non-standard numeric constant: {constant}")
-
-def nesting_exceeds_limit(value):
-    stack = [(value, 0)]
-    while stack:
-        current, depth = stack.pop()
-        if isinstance(current, dict):
-            next_depth = depth + 1
-            if next_depth > MAX_JSON_NESTING:
-                return True
-            stack.extend((child, next_depth) for child in current.values())
-        elif isinstance(current, list):
-            next_depth = depth + 1
-            if next_depth > MAX_JSON_NESTING:
-                return True
-            stack.extend((child, next_depth) for child in current)
-    return False
-
-try:
-    with open(path, "r", encoding="utf-8") as f:
-        data = json.load(f, parse_constant=reject_constant)
-except RecursionError:
-    sys.exit(f"JSON nesting exceeds limit in {path}")
-except json.JSONDecodeError as exc:
-    sys.exit(
-        f"invalid JSON in {path}: "
-        f"line {exc.lineno} column {exc.colno}: {exc.msg}"
-    )
-except (OSError, UnicodeError) as exc:
-    sys.exit(f"cannot read JSON in {path}: {exc}")
-except ValueError as exc:
-    sys.exit(f"invalid JSON in {path}: {exc}")
-
-if nesting_exceeds_limit(data):
-    sys.exit(f"JSON nesting exceeds limit in {path}")
-
-if not isinstance(data, dict):
-    sys.exit(f"JSON value must be an object in {path}")
-
-value = data
-for part in dotted_key.split("."):
-    if not isinstance(value, dict):
-        value = ""
-        break
-    value = value.get(part, "")
-try:
-    print(value if value is not None else "")
-except (OSError, UnicodeError) as exc:
-    sys.exit(f"cannot output JSON value from {path}: {exc}")
-PY
-  ); then
-    spw_die "$value"
-  fi
-  printf '%s\n' "$value"
-}
-
-spw_write_metadata_json() {
-  file="$1"
-  source="$2"
-  requested_ref="$3"
-  resolved_ref="$4"
-  commit="$5"
-  upstream_manifest_version="$6"
-  python3 - "$file" "$source" "$requested_ref" "$resolved_ref" "$commit" "$upstream_manifest_version" <<'PY'
-import json, sys
-path, source, requested, resolved, commit, version = sys.argv[1:]
-data = {
-    "source": source,
-    "requested_ref": requested,
-    "resolved_ref": resolved,
-    "commit": commit,
-    "upstream_manifest_version": version,
-}
-try:
-    with open(path, "w", encoding="utf-8") as f:
-        json.dump(data, f, indent=2, allow_nan=False)
-        f.write("\n")
-except RecursionError as exc:
-    sys.exit(f"JSON nesting exceeds limit while writing {path}: {exc}")
-except (OSError, UnicodeError, ValueError) as exc:
-    sys.exit(f"cannot write JSON to {path}: {exc}")
-PY
-}
-
-spw_metadata_commit_or_empty() {
-  file="$1"
-  if [ -f "$file" ]; then
-    spw_json_get "$file" "commit"
-  fi
-}
-
-spw_metadata_commit_lenient_or_empty() {
-  file="$1"
-  [ -f "$file" ] || return 0
-
-  if value=$(
-    python3 -S - "$file" 2>/dev/null <<'PY'
-import json
-import re
-import sys
-
-path = sys.argv[1]
-
-def reject_constant(constant):
-    raise ValueError(f"non-standard numeric constant: {constant}")
-
-try:
-    with open(path, "r", encoding="utf-8") as handle:
-        data = json.load(handle, parse_constant=reject_constant)
-except (OSError, UnicodeError, ValueError, RecursionError):
-    raise SystemExit(1)
-
-commit = data.get("commit") if isinstance(data, dict) else None
-if isinstance(commit, str) and re.fullmatch(r"[0-9a-fA-F]{40}", commit):
-    print(commit)
-PY
-  ); then
-    printf '%s\n' "$value"
-  fi
-}

package/scripts/core/status.sh

@@ -1,27 +0,0 @@
-#!/bin/sh
-# Sourced module; callers own set -eu.
-
-spw_commit_matches() {
-  desired="$1"
-  observed="$2"
-  short=$(printf '%s' "$desired" | cut -c 1-7)
-  [ -n "$observed" ] && { [ "$observed" = "$desired" ] || [ "$observed" = "$short" ]; }
-}
-
-spw_status_for_commits() {
-  desired="$1"
-  generated="$2"
-  installed="$3"
-
-  if [ -z "$generated" ]; then
-    printf '%s\n' "needs prepare"
-  elif ! spw_commit_matches "$desired" "$generated"; then
-    printf '%s\n' "needs prepare"
-  elif [ -z "$installed" ]; then
-    printf '%s\n' "needs install"
-  elif ! spw_commit_matches "$desired" "$installed"; then
-    printf '%s\n' "needs install"
-  else
-    printf '%s\n' "current"
-  fi
-}

package/scripts/core/upstream.sh

@@ -1,146 +0,0 @@
-#!/bin/sh
-# Sourced module; callers own set -eu.
-
-SPW_UPSTREAM_URL_DEFAULT="https://github.com/obra/superpowers"
-
-spw_config_ref() (
-  config_root="$1"
-  if [ -n "${SUPERPOWERS_REF:-}" ]; then
-    printf '%s\n' "$SUPERPOWERS_REF"
-    return
-  fi
-  sed -n '1{s/[[:space:]]*$//;p;}' "$config_root/config/upstream-ref"
-)
-
-spw_short_commit() {
-  commit="$1"
-  printf '%s' "$commit" | cut -c 1-7
-}
-
-spw_is_semver_base() {
-  version="$1"
-  printf '%s' "$version" | grep -Eq '^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(-((0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)(\.(0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*))*))?$'
-}
-
-spw_sanitize_ref_for_version() {
-  ref="$1"
-  sanitized=$(printf '%s' "$ref" | sed 's/[^0-9A-Za-z-][^0-9A-Za-z-]*/-/g; s/^-*//; s/-*$//')
-  sanitized=$(printf '%s' "$sanitized" | cut -c 1-48 | sed 's/^-*//; s/-*$//')
-  if [ -z "$sanitized" ]; then
-    sanitized="unknown"
-  fi
-  printf '%s' "$sanitized"
-}
-
-spw_manifest_version_for_ref() {
-  requested_ref="$1"
-  resolution_kind="$2"
-  resolved_ref="$3"
-  commit="$4"
-  short=$(spw_short_commit "$commit")
-
-  case "$resolution_kind" in
-    latest-release|tag)
-      base=$(printf '%s' "$resolved_ref" | sed -n 's/^v//p')
-      if [ -n "$base" ] && spw_is_semver_base "$base"; then
-        printf '%s+manager.%s\n' "$base" "$short"
-        return
-      fi
-      ;;
-    ref)
-      if [ "$requested_ref" = "main" ]; then
-        printf '0.0.0-main+manager.%s\n' "$short"
-        return
-      fi
-      sanitized=$(spw_sanitize_ref_for_version "$requested_ref")
-      printf '0.0.0-ref-%s+manager.%s\n' "$sanitized" "$short"
-      return
-      ;;
-    raw-commit)
-      ;;
-  esac
-
-  printf '0.0.0+manager.%s\n' "$short"
-}
-
-spw_manifest_version_for_commit() {
-  commit="$1"
-  spw_manifest_version_for_ref "$commit" "raw-commit" "$commit" "$commit"
-}
-
-spw_select_latest_release_from_ls_remote() {
-  awk '
-    $2 ~ /^refs\/tags\/v[0-9]+\.[0-9]+\.[0-9]+(\^\{\})?$/ {
-      ref = $2
-      peeled = 0
-      if (ref ~ /\^\{\}$/) {
-        peeled = 1
-        sub(/\^\{\}$/, "", ref)
-      }
-      tag = ref
-      sub(/^refs\/tags\//, "", tag)
-      split(substr(tag, 2), parts, ".")
-      key = sprintf("%010d.%010d.%010d", parts[1], parts[2], parts[3])
-      tag_by_key[key] = tag
-      if (peeled || !(tag in sha_by_tag)) {
-        sha_by_tag[tag] = $1
-      }
-    }
-    END {
-      for (key in tag_by_key) {
-        tag = tag_by_key[key]
-        print key, tag, sha_by_tag[tag]
-      }
-    }
-  ' | sort | tail -n 1 | awk '
-    NF == 3 { print $2 " " $3; found = 1 }
-    END { if (!found) exit 1 }
-  '
-}
-
-spw_resolve_ref() {
-  upstream_url="$1"
-  requested_ref="$2"
-  spw_require_command git
-
-  if [ "$requested_ref" = "latest-release" ]; then
-    if ! output=$(git ls-remote --tags "$upstream_url" 'refs/tags/v*' 2>&1); then
-      spw_die "cannot query upstream tags from $upstream_url: $output"
-    fi
-    if ! selected=$(printf '%s\n' "$output" | spw_select_latest_release_from_ls_remote); then
-      spw_die "no stable semver tag found for latest-release"
-    fi
-    printf 'latest-release %s\n' "$selected"
-    return
-  fi
-
-  if printf '%s' "$requested_ref" | grep -Eq '^[0-9a-fA-F]{40}$'; then
-    printf 'raw-commit %s %s\n' "$requested_ref" "$requested_ref"
-    return
-  fi
-
-  if ! tag_output=$(git ls-remote --tags "$upstream_url" "refs/tags/$requested_ref" "refs/tags/$requested_ref^{}" 2>&1); then
-    spw_die "cannot query upstream tag $requested_ref from $upstream_url: $tag_output"
-  fi
-  resolved=$(printf '%s\n' "$tag_output" | awk -v tag_ref="refs/tags/$requested_ref" '
-    NF >= 2 && ($2 == tag_ref || $2 == tag_ref "^{}") {
-      sha = $1
-    }
-    END { if (sha != "") print sha }
-  ')
-  if [ -n "$resolved" ]; then
-    printf 'tag %s %s\n' "$requested_ref" "$resolved"
-    return
-  fi
-
-  if ! ref_output=$(git ls-remote "$upstream_url" "$requested_ref" 2>&1); then
-    spw_die "cannot query upstream ref $requested_ref from $upstream_url: $ref_output"
-  fi
-  resolved=$(printf '%s\n' "$ref_output" | awk 'NF >= 2 { print $1; exit }')
-  if [ -n "$resolved" ]; then
-    printf 'ref %s %s\n' "$requested_ref" "$resolved"
-    return
-  fi
-
-  spw_die "cannot resolve upstream ref: $requested_ref"
-}