devrites 1.19.0

package/uninstall.sh

@@ -0,0 +1,137 @@
+#!/usr/bin/env bash
+# uninstall.sh — remove DevRites from a project. Removes ONLY the files listed in
+# .claude/devrites.manifest (plus the manifest itself) and prunes dirs left empty.
+# Never touches your feature data in .devrites/work/.
+#
+#   ./uninstall.sh                 uninstall from the current directory
+#   ./uninstall.sh --target DIR    uninstall from DIR
+#   ./uninstall.sh --dry-run       show what would be removed, change nothing
+#
+# Network uninstall (no git clone needed):
+#   curl -fsSL https://raw.githubusercontent.com/ViktorsBaikers/DevRites/main/uninstall.sh | bash
+#   curl -fsSL https://raw.githubusercontent.com/ViktorsBaikers/DevRites/main/uninstall.sh | bash -s -- --target /path
+
+set -u
+SELF_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" 2>/dev/null && pwd -P)" || SELF_DIR=""
+
+# ---- bootstrap (curl | bash) --------------------------------------------
+# Same pattern as install.sh: when piped from curl there are no sibling files,
+# so download a tarball and re-exec.
+DEVRITES_REPO="${DEVRITES_REPO:-ViktorsBaikers/DevRites}"
+DEVRITES_REF="${DEVRITES_REF:-}"
+if [ -z "$SELF_DIR" ] || [ ! -r "$SELF_DIR/scripts/install-lib.sh" ]; then
+  if [ "${DEVRITES_BOOTSTRAPPED:-0}" = "1" ]; then
+    echo "error: bootstrap re-exec did not find scripts/install-lib.sh — aborting." >&2
+    exit 1
+  fi
+  command -v curl >/dev/null 2>&1 || { echo "error: curl is required for the network uninstaller." >&2; exit 1; }
+  command -v tar  >/dev/null 2>&1 || { echo "error: tar is required for the network uninstaller."  >&2; exit 1; }
+
+  BOOT_TMP="$(mktemp -d 2>/dev/null || echo "${TMPDIR:-/tmp}/devrites-bootstrap.$$")"
+  if [ -n "$DEVRITES_REF" ]; then
+    BOOT_TAG="$DEVRITES_REF"
+  else
+    BOOT_TAG="$(curl -fsSL "https://api.github.com/repos/$DEVRITES_REPO/releases/latest" 2>/dev/null \
+      | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -n1)"
+  fi
+  BOOT_DOWNLOADED=0
+  if [ -n "$BOOT_TAG" ]; then
+    BOOT_URL="https://github.com/$DEVRITES_REPO/releases/download/$BOOT_TAG/devrites-$BOOT_TAG.tar.gz"
+    curl -fsSL -o "$BOOT_TMP/devrites.tar.gz" "$BOOT_URL" 2>/dev/null && BOOT_DOWNLOADED=1
+    if [ "$BOOT_DOWNLOADED" -ne 1 ]; then
+      BOOT_URL="https://github.com/$DEVRITES_REPO/archive/refs/tags/$BOOT_TAG.tar.gz"
+      curl -fsSL -o "$BOOT_TMP/devrites.tar.gz" "$BOOT_URL" 2>/dev/null && BOOT_DOWNLOADED=1
+    fi
+  fi
+  if [ "$BOOT_DOWNLOADED" -ne 1 ]; then
+    BOOT_URL="https://github.com/$DEVRITES_REPO/archive/refs/heads/main.tar.gz"
+    curl -fsSL -o "$BOOT_TMP/devrites.tar.gz" "$BOOT_URL" || { echo "error: could not download DevRites from $BOOT_URL" >&2; exit 1; }
+  fi
+  tar -C "$BOOT_TMP" -xzf "$BOOT_TMP/devrites.tar.gz" || { echo "error: could not extract DevRites tarball" >&2; exit 1; }
+  BOOT_BUNDLE="$(find "$BOOT_TMP" -mindepth 1 -maxdepth 1 -type d | head -n1)"
+  [ -n "$BOOT_BUNDLE" ] && [ -f "$BOOT_BUNDLE/uninstall.sh" ] || { echo "error: extracted bundle is missing uninstall.sh" >&2; exit 1; }
+  chmod +x "$BOOT_BUNDLE/uninstall.sh" "$BOOT_BUNDLE"/scripts/*.sh 2>/dev/null || true
+  export DEVRITES_BOOTSTRAPPED=1
+  exec bash "$BOOT_BUNDLE/uninstall.sh" "$@"
+fi
+
+. "$SELF_DIR/scripts/install-lib.sh"
+
+TARGET="$PWD"
+DRYRUN=0
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --target) shift; [ $# -gt 0 ] || dr_die "--target needs a directory"; TARGET="$1" ;;
+    --target=*) TARGET="${1#*=}" ;;
+    --dry-run) DRYRUN=1 ;;
+    -h|--help) sed -n '2,11p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;;
+    *) dr_die "unknown option: $1 (try --help)" ;;
+  esac
+  shift
+done
+
+[ -d "$TARGET" ] || dr_die "target is not a directory: $TARGET"
+TARGET="$(dr_abspath_dir "$TARGET")" || dr_die "cannot resolve target: $TARGET"
+MF="$TARGET/$DR_MANIFEST_NAME"
+[ -f "$MF" ] || dr_die "no DevRites manifest at $MF — nothing to uninstall."
+
+dr_info "DevRites uninstaller"
+dr_say  "  target  : $TARGET"
+dr_say  "  manifest: $MF"
+[ "$DRYRUN" -eq 1 ] && dr_info "  (dry run — no changes)"
+dr_say ""
+
+N_REMOVED=0; N_MISSING=0
+PRUNE_TMP="$(mktemp 2>/dev/null || echo "${TMPDIR:-/tmp}/devrites-prune.$$")"
+: > "$PRUNE_TMP"
+trap 'rm -f "$PRUNE_TMP"' EXIT
+
+# Remove each manifest-listed file.
+while IFS= read -r rel; do
+  case "$rel" in ''|\#*) continue ;; esac          # skip blanks/comments
+  case "$rel" in /*|*..*) dr_warn "ignoring suspicious manifest entry: $rel"; continue ;; esac
+  dest="$TARGET/$rel"
+  if [ -e "$dest" ] || [ -L "$dest" ]; then
+    if [ "$DRYRUN" -eq 1 ]; then
+      dr_say "  [remove] $rel"
+    else
+      rm -f "$dest" || dr_warn "could not remove $dest"
+    fi
+    printf '%s\n' "$(dirname "$dest")" >> "$PRUNE_TMP"
+    N_REMOVED=$((N_REMOVED+1))
+  else
+    N_MISSING=$((N_MISSING+1))
+  fi
+done < "$MF"
+
+# Remove the manifest itself.
+if [ "$DRYRUN" -eq 1 ]; then
+  dr_say "  [remove] $DR_MANIFEST_NAME"
+else
+  rm -f "$MF"
+  printf '%s\n' "$(dirname "$MF")" >> "$PRUNE_TMP"
+fi
+
+# Prune directories left empty (rmdir only removes empty dirs — safe). Two passes
+# walk up to catch parents. Never removes .devrites/work or any non-empty dir.
+if [ "$DRYRUN" -eq 0 ]; then
+  pass=0
+  while [ "$pass" -lt 6 ]; do
+    sort -u "$PRUNE_TMP" | awk '{ print length, $0 }' | sort -rn | cut -d' ' -f2- \
+    | while IFS= read -r d; do
+        case "$d" in "$TARGET"|"$TARGET"/) continue ;; esac
+        [ -d "$d" ] && rmdir "$d" 2>/dev/null && printf '%s\n' "$(dirname "$d")" >> "$PRUNE_TMP.next"
+      done
+    [ -f "$PRUNE_TMP.next" ] || break
+    cat "$PRUNE_TMP.next" >> "$PRUNE_TMP"; rm -f "$PRUNE_TMP.next"
+    pass=$((pass+1))
+  done
+fi
+
+dr_say ""
+dr_ok "DevRites $([ "$DRYRUN" -eq 1 ] && echo 'uninstall plan complete (dry run)' || echo uninstalled)"
+dr_say "  removed: $N_REMOVED   already-absent: $N_MISSING"
+[ -d "$TARGET/.devrites/work" ] && dr_say "  ${DR_Y}kept${DR_R} .devrites/work/ (your feature data) — delete it manually if you want it gone."
+[ -f "$TARGET/.devrites/ACTIVE" ] && dr_say "  ${DR_Y}kept${DR_R} .devrites/ACTIVE (active-feature cursor) — runtime state."
+[ -f "$TARGET/.devrites/AFK" ] && dr_say "  ${DR_Y}kept${DR_R} .devrites/AFK (per-developer AFK sentinel) — runtime state."
+exit 0

package/update.sh

@@ -0,0 +1,196 @@
+#!/usr/bin/env bash
+# update.sh — upgrade an existing DevRites install to the latest GitHub Release.
+#
+#   ./update.sh                       upgrade the install in the current directory
+#   ./update.sh --target DIR          upgrade the install in DIR
+#   ./update.sh --to vX.Y.Z           pin to a specific release tag instead of latest
+#   ./update.sh --check               report installed vs latest, do not change anything
+#   ./update.sh --force               re-install even if already at the latest version
+#   ./update.sh --pre                 allow pre-release tags (default: stable only)
+#
+# Env:
+#   DEVRITES_UPDATE_BUNDLE=PATH       use a local .tar.gz instead of downloading
+#                                     (air-gapped upgrades; also used by tests)
+#
+# How it works:
+#   1. Reads the installed version + flags from .claude/devrites.manifest.
+#   2. Asks the GitHub API for the latest release tag (or the tag passed via --to).
+#   3. If newer, downloads the release tarball, extracts to a temp dir,
+#      and re-runs the bundled install.sh with the same flags the user
+#      originally installed with — preserving .devrites/ feature state.
+#
+# Requires: curl, tar. (jq optional; falls back to sed parsing.)
+
+set -u
+
+REPO="ViktorsBaikers/DevRites"
+API="https://api.github.com/repos/$REPO"
+
+# ---- args ----------------------------------------------------------------
+TARGET="$PWD"
+PIN_TAG=""
+CHECK_ONLY=0
+FORCE=0
+ALLOW_PRE=0
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --target)  shift; [ $# -gt 0 ] || { echo "error: --target needs a directory" >&2; exit 1; }; TARGET="$1" ;;
+    --target=*) TARGET="${1#*=}" ;;
+    --to)      shift; [ $# -gt 0 ] || { echo "error: --to needs a tag" >&2; exit 1; }; PIN_TAG="$1" ;;
+    --to=*)    PIN_TAG="${1#*=}" ;;
+    --check)   CHECK_ONLY=1 ;;
+    --force)   FORCE=1 ;;
+    --pre)     ALLOW_PRE=1 ;;
+    -h|--help) sed -n '2,22p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;;
+    *)         echo "error: unknown option: $1 (try --help)" >&2; exit 1 ;;
+  esac
+  shift
+done
+
+# ---- pretty -------------------------------------------------------------
+if [ -t 1 ]; then
+  B="$(printf '\033[1m')"; R="$(printf '\033[0m')"
+  G="$(printf '\033[32m')"; C="$(printf '\033[36m')"; Y="$(printf '\033[33m')"
+else
+  B=""; R=""; G=""; C=""; Y=""
+fi
+say()  { printf '%s\n' "$*"; }
+info() { printf '%s%s%s\n' "$C" "$*" "$R"; }
+ok()   { printf '%s%s%s\n' "$G" "$*" "$R"; }
+warn() { printf '%swarning:%s %s\n' "$Y" "$R" "$*" >&2; }
+die()  { printf 'error: %s\n' "$*" >&2; exit 1; }
+
+# ---- prerequisites -------------------------------------------------------
+command -v curl >/dev/null 2>&1 || die "curl is required"
+command -v tar  >/dev/null 2>&1 || die "tar is required"
+
+# ---- locate install ------------------------------------------------------
+[ -d "$TARGET" ] || die "target is not a directory: $TARGET"
+TARGET="$(cd "$TARGET" && pwd -P)"
+MANIFEST="$TARGET/.claude/devrites.manifest"
+[ -f "$MANIFEST" ] || die "no DevRites install found at $TARGET (missing .claude/devrites.manifest). Run install.sh first."
+
+INSTALLED_VERSION="$(sed -n 's/^# devrites-version:[[:space:]]*//p' "$MANIFEST" | head -n1)"
+INSTALL_FLAGS="$(sed -n 's/^# devrites-flags:[[:space:]]*//p' "$MANIFEST" | head -n1)"
+[ -n "$INSTALLED_VERSION" ] || INSTALLED_VERSION="unknown"
+
+info "DevRites update"
+say  "  project:   $TARGET"
+say  "  installed: ${B}$INSTALLED_VERSION${R}"
+[ -n "$INSTALL_FLAGS" ] && say "  flags:     $INSTALL_FLAGS"
+
+# ---- resolve target tag --------------------------------------------------
+if [ -n "$PIN_TAG" ]; then
+  LATEST_TAG="$PIN_TAG"
+else
+  if [ "$ALLOW_PRE" -eq 1 ]; then
+    # All releases, take the first one
+    LATEST_TAG="$(curl -fsSL "$API/releases" 2>/dev/null \
+      | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \
+      | head -n1)"
+  else
+    LATEST_TAG="$(curl -fsSL "$API/releases/latest" 2>/dev/null \
+      | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \
+      | head -n1)"
+  fi
+  [ -n "$LATEST_TAG" ] || die "could not resolve the latest release tag from GitHub. Check connectivity, or pass --to vX.Y.Z."
+fi
+LATEST_VERSION="${LATEST_TAG#v}"
+say "  latest:    ${B}$LATEST_VERSION${R}"
+
+# ---- semver compare ------------------------------------------------------
+# Returns 0 if $1 > $2, 1 if equal, 2 if $1 < $2. Pre-release tags compare as lower.
+semver_cmp() {
+  _a="${1%%-*}"; _b="${2%%-*}"
+  _ap="${1#${_a}}"; _bp="${2#${_b}}"
+  IFS=. read -r a1 a2 a3 <<EOF
+$_a
+EOF
+  IFS=. read -r b1 b2 b3 <<EOF
+$_b
+EOF
+  a1=${a1:-0}; a2=${a2:-0}; a3=${a3:-0}
+  b1=${b1:-0}; b2=${b2:-0}; b3=${b3:-0}
+  if   [ "$a1" -gt "$b1" ]; then return 0
+  elif [ "$a1" -lt "$b1" ]; then return 2
+  elif [ "$a2" -gt "$b2" ]; then return 0
+  elif [ "$a2" -lt "$b2" ]; then return 2
+  elif [ "$a3" -gt "$b3" ]; then return 0
+  elif [ "$a3" -lt "$b3" ]; then return 2
+  fi
+  # core equal — pre-release < release
+  if   [ -z "$_ap" ] && [ -n "$_bp" ]; then return 0
+  elif [ -n "$_ap" ] && [ -z "$_bp" ]; then return 2
+  fi
+  return 1
+}
+
+NEEDS_UPDATE=0
+if [ "$INSTALLED_VERSION" = "unknown" ]; then
+  NEEDS_UPDATE=1
+  warn "installed version unknown — treating as out-of-date."
+else
+  semver_cmp "$LATEST_VERSION" "$INSTALLED_VERSION"
+  case $? in
+    0) NEEDS_UPDATE=1 ;;
+    1) NEEDS_UPDATE=0 ;;
+    2) warn "installed version ($INSTALLED_VERSION) is newer than latest release ($LATEST_VERSION)." ;;
+  esac
+fi
+
+if [ "$CHECK_ONLY" -eq 1 ]; then
+  if [ "$NEEDS_UPDATE" -eq 1 ]; then
+    info "update available: $INSTALLED_VERSION → $LATEST_VERSION"
+    exit 10
+  else
+    ok "up to date."
+    exit 0
+  fi
+fi
+
+if [ "$NEEDS_UPDATE" -eq 0 ] && [ "$FORCE" -eq 0 ]; then
+  ok "already at $LATEST_VERSION — nothing to do (use --force to reinstall)."
+  exit 0
+fi
+
+# ---- download release tarball -------------------------------------------
+TMP="$(mktemp -d 2>/dev/null || echo "${TMPDIR:-/tmp}/devrites-update.$$")"
+mkdir -p "$TMP"
+cleanup() { rm -rf "$TMP"; }
+trap cleanup EXIT
+
+ARTIFACT="devrites-${LATEST_TAG}.tar.gz"
+URL="https://github.com/$REPO/releases/download/$LATEST_TAG/$ARTIFACT"
+SRC_TARBALL_URL="https://github.com/$REPO/archive/refs/tags/$LATEST_TAG.tar.gz"
+
+# DEVRITES_UPDATE_BUNDLE — optional escape hatch for air-gapped upgrades and
+# tests: a readable local .tar.gz to use instead of downloading from GitHub.
+if [ -n "${DEVRITES_UPDATE_BUNDLE:-}" ]; then
+  [ -r "$DEVRITES_UPDATE_BUNDLE" ] || die "DEVRITES_UPDATE_BUNDLE not readable: $DEVRITES_UPDATE_BUNDLE"
+  info "using local bundle $DEVRITES_UPDATE_BUNDLE (DEVRITES_UPDATE_BUNDLE set) …"
+  cp "$DEVRITES_UPDATE_BUNDLE" "$TMP/$ARTIFACT" || die "could not copy $DEVRITES_UPDATE_BUNDLE"
+else
+  info "downloading $ARTIFACT …"
+  if ! curl -fsSL -o "$TMP/$ARTIFACT" "$URL" 2>/dev/null; then
+    warn "release artifact $ARTIFACT not found; falling back to the source tarball ($LATEST_TAG)."
+    ARTIFACT="src-$LATEST_TAG.tar.gz"
+    curl -fsSL -o "$TMP/$ARTIFACT" "$SRC_TARBALL_URL" || die "could not download $SRC_TARBALL_URL"
+  fi
+fi
+
+tar -C "$TMP" -xzf "$TMP/$ARTIFACT"
+EXTRACTED="$(find "$TMP" -maxdepth 1 -mindepth 1 -type d | head -n1)"
+[ -n "$EXTRACTED" ] && [ -f "$EXTRACTED/install.sh" ] || die "extracted bundle has no install.sh: $EXTRACTED"
+# GitHub source tarballs strip +x; restore it before re-exec.
+chmod +x "$EXTRACTED/install.sh" "$EXTRACTED"/scripts/*.sh 2>/dev/null || true
+
+# ---- re-run installer with the original flags + --force -----------------
+info "running installer (with --force) — preserving .devrites/ feature state …"
+# shellcheck disable=SC2086
+bash "$EXTRACTED/install.sh" --target "$TARGET" --force $INSTALL_FLAGS \
+  || die "installer failed; the previous install is still in place."
+
+ok "DevRites upgraded: $INSTALLED_VERSION → $LATEST_VERSION"
+say "  run ${C}/rite${R} or ${C}/rite-status${R} to continue where you left off."
+exit 0