pm-upgrade

Multi-host portability rules. When invoking AskUserQuestion:

1. The header field MUST be a short noun phrase (≤ 12 characters). Mistral Vibe rejects longer headers with string_too_long. Pick from: Start, Target, Scope, Audience, Methodology, Feature, Question.
2. The options list MUST have at least 2 items. Vibe rejects empty/single-option calls. For free-text input, always provide ≥ 2 framing options (e.g. Yes, here's the input / Skip) — never call ask_user_question with options: [].

Preamble (run first)

source ~/.nanopm/lib/nanopm.sh 2>/dev/null || \
  source .nanopm/lib/nanopm.sh 2>/dev/null || \
  { echo "ERROR: nanopm not installed. Run: curl -fsSL https://raw.githubusercontent.com/nmrtn/nanopm/main/setup | bash"; exit 1; }
nanopm_preamble

Inline upgrade flow

This section is followed by all skill preambles when they detect UPGRADE_AVAILABLE {old} {new} in the preamble output.

Step 1: Ask or auto-upgrade

Check if auto-upgrade is configured:

source ~/.nanopm/lib/nanopm.sh 2>/dev/null || source .nanopm/lib/nanopm.sh 2>/dev/null || true
_AUTO=$(nanopm_config_get "auto_upgrade")
echo "AUTO_UPGRADE=${_AUTO:-false}"

If AUTO_UPGRADE=true: skip AskUserQuestion. Log "Auto-upgrading nanopm v{old} → v{new}..." and proceed to Step 2.

Otherwise, ask via AskUserQuestion:

• Question: "nanopm v{new} is available (you have v{old}). Upgrade now?"
• Options:
  • "Yes, upgrade now"
  • "Always keep me up to date (auto-upgrade)"
  • "Not now (remind me later)"
  • "Never ask again"

If "Yes, upgrade now": proceed to Step 2.

If "Always keep me up to date":

source ~/.nanopm/lib/nanopm.sh 2>/dev/null || source .nanopm/lib/nanopm.sh 2>/dev/null || true
nanopm_config_set "auto_upgrade" "true"

Tell user: "Auto-upgrade enabled — future updates will install automatically." Then proceed to Step 2.

If "Not now": write snooze state with escalating backoff. Then continue with the originally invoked skill without upgrading.

_SNOOZE="$HOME/.nanopm/update-snoozed"
_REMOTE_VER="{new}"
_CUR_LEVEL=0
if [ -f "$_SNOOZE" ]; then
  _SV=$(awk '{print $1}' "$_SNOOZE")
  if [ "$_SV" = "$_REMOTE_VER" ]; then
    _CUR_LEVEL=$(awk '{print $2}' "$_SNOOZE")
    case "$_CUR_LEVEL" in *[!0-9]*) _CUR_LEVEL=0 ;; esac
  fi
fi
_NEW_LEVEL=$(( _CUR_LEVEL + 1 ))
[ "$_NEW_LEVEL" -gt 3 ] && _NEW_LEVEL=3
echo "$_REMOTE_VER $_NEW_LEVEL $(date +%s)" > "$_SNOOZE"

Tell user the snooze duration: level 1 → "next reminder in 24h"; level 2 → "48h"; level 3 → "1 week".