@git-stunts/git-warp 10.1.1

package/index.js

@@ -0,0 +1,180 @@
+/**
+ * @fileoverview Empty Graph - A graph database substrate using Git commits pointing to the empty tree.
+ */
+
+import GitGraphAdapter from './src/infrastructure/adapters/GitGraphAdapter.js';
+import GraphNode from './src/domain/entities/GraphNode.js';
+import BitmapIndexBuilder from './src/domain/services/BitmapIndexBuilder.js';
+import BitmapIndexReader from './src/domain/services/BitmapIndexReader.js';
+import IndexRebuildService from './src/domain/services/IndexRebuildService.js';
+import HealthCheckService, { HealthStatus } from './src/domain/services/HealthCheckService.js';
+import CommitDagTraversalService from './src/domain/services/CommitDagTraversalService.js';
+import GraphPersistencePort from './src/ports/GraphPersistencePort.js';
+import IndexStoragePort from './src/ports/IndexStoragePort.js';
+import LoggerPort from './src/ports/LoggerPort.js';
+import ClockPort from './src/ports/ClockPort.js';
+import NoOpLogger from './src/infrastructure/adapters/NoOpLogger.js';
+import ConsoleLogger, { LogLevel } from './src/infrastructure/adapters/ConsoleLogger.js';
+import ClockAdapter from './src/infrastructure/adapters/ClockAdapter.js';
+import PerformanceClockAdapter from './src/infrastructure/adapters/PerformanceClockAdapter.js';
+import GlobalClockAdapter from './src/infrastructure/adapters/GlobalClockAdapter.js';
+import {
+  ForkError,
+  IndexError,
+  QueryError,
+  SchemaUnsupportedError,
+  ShardLoadError,
+  ShardCorruptionError,
+  ShardValidationError,
+  StorageError,
+  TraversalError,
+  OperationAbortedError,
+  SyncError,
+  WormholeError,
+} from './src/domain/errors/index.js';
+import { checkAborted, createTimeoutSignal } from './src/domain/utils/cancellation.js';
+
+// Multi-writer graph support (WARP)
+import WarpGraph from './src/domain/WarpGraph.js';
+import {
+  createNodeAdd,
+  createNodeTombstone,
+  createEdgeAdd,
+  createEdgeTombstone,
+  createPropSet,
+  createInlineValue,
+  createBlobValue,
+  createEventId,
+} from './src/domain/types/WarpTypes.js';
+import { migrateV4toV5 } from './src/domain/services/MigrationService.js';
+import QueryBuilder from './src/domain/services/QueryBuilder.js';
+import ObserverView from './src/domain/services/ObserverView.js';
+import { computeTranslationCost } from './src/domain/services/TranslationCost.js';
+import {
+  encodeEdgePropKey,
+  decodeEdgePropKey,
+  isEdgePropKey,
+} from './src/domain/services/KeyCodec.js';
+import {
+  createTickReceipt,
+  canonicalJson as tickReceiptCanonicalJson,
+  OP_TYPES as TICK_RECEIPT_OP_TYPES,
+  RESULT_TYPES as TICK_RECEIPT_RESULT_TYPES,
+} from './src/domain/types/TickReceipt.js';
+
+// Provenance payload (HOLOGRAM)
+import ProvenancePayload from './src/domain/services/ProvenancePayload.js';
+
+// Boundary Transition Records (HOLOGRAM)
+import {
+  createBTR,
+  verifyBTR,
+  replayBTR,
+  serializeBTR,
+  deserializeBTR,
+} from './src/domain/services/BoundaryTransitionRecord.js';
+
+// Wormhole compression (HOLOGRAM)
+import {
+  createWormhole,
+  composeWormholes,
+  replayWormhole,
+  serializeWormhole,
+  deserializeWormhole,
+} from './src/domain/services/WormholeService.js';
+
+const TraversalService = CommitDagTraversalService;
+
+export {
+  GitGraphAdapter,
+  GraphNode,
+  BitmapIndexBuilder,
+  BitmapIndexReader,
+  IndexRebuildService,
+  HealthCheckService,
+  HealthStatus,
+  CommitDagTraversalService,
+  TraversalService,
+  GraphPersistencePort,
+  IndexStoragePort,
+
+  // Logging infrastructure
+  LoggerPort,
+  NoOpLogger,
+  ConsoleLogger,
+  LogLevel,
+
+  // Clock infrastructure
+  ClockPort,
+  ClockAdapter,
+  PerformanceClockAdapter,
+  GlobalClockAdapter,
+
+  // Error types for integrity failure handling
+  ForkError,
+  IndexError,
+  QueryError,
+  SchemaUnsupportedError,
+  ShardLoadError,
+  ShardCorruptionError,
+  ShardValidationError,
+  StorageError,
+  TraversalError,
+  OperationAbortedError,
+  SyncError,
+  WormholeError,
+
+  // Cancellation utilities
+  checkAborted,
+  createTimeoutSignal,
+
+  // Multi-writer graph support (WARP)
+  WarpGraph,
+  QueryBuilder,
+  ObserverView,
+  computeTranslationCost,
+
+  // WARP type creators
+  createNodeAdd,
+  createNodeTombstone,
+  createEdgeAdd,
+  createEdgeTombstone,
+  createPropSet,
+  createInlineValue,
+  createBlobValue,
+  createEventId,
+
+  // Key codec utilities (BULKHEAD)
+  encodeEdgePropKey,
+  decodeEdgePropKey,
+  isEdgePropKey,
+
+  // WARP migration
+  migrateV4toV5,
+
+  // Tick receipts (LIGHTHOUSE)
+  createTickReceipt,
+  tickReceiptCanonicalJson,
+  TICK_RECEIPT_OP_TYPES,
+  TICK_RECEIPT_RESULT_TYPES,
+
+  // Provenance payload (HOLOGRAM)
+  ProvenancePayload,
+
+  // Boundary Transition Records (HOLOGRAM)
+  createBTR,
+  verifyBTR,
+  replayBTR,
+  serializeBTR,
+  deserializeBTR,
+
+  // Wormhole compression (HOLOGRAM)
+  createWormhole,
+  composeWormholes,
+  replayWormhole,
+  serializeWormhole,
+  deserializeWormhole,
+};
+
+// WarpGraph is the primary API for V7
+export default WarpGraph;

package/package.json

@@ -0,0 +1,129 @@
+{
+  "name": "@git-stunts/git-warp",
+  "version": "10.1.1",
+  "description": "Deterministic WARP graph over Git: graph-native storage, traversal, and tooling.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "James Ross <james@flyingrobots.dev>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/git-stunts/git-warp.git"
+  },
+  "homepage": "https://github.com/git-stunts/git-warp#readme",
+  "bugs": {
+    "url": "https://github.com/git-stunts/git-warp/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "sideEffects": false,
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "bin": {
+    "warp-graph": "./bin/warp-graph.js",
+    "git-warp": "./bin/git-warp"
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./node": {
+      "types": "./index.d.ts",
+      "import": "./src/domain/entities/GraphNode.js",
+      "default": "./src/domain/entities/GraphNode.js"
+    },
+    "./visualization": {
+      "import": "./src/visualization/index.js",
+      "default": "./src/visualization/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin/warp-graph.js",
+    "bin/git-warp",
+    "src",
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "SECURITY.md",
+    "scripts/install-git-warp.sh",
+    "scripts/uninstall-git-warp.sh"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "lint:links": "lychee --config .lychee.toml '**/*.md'",
+    "format": "prettier --write .",
+    "test": "sh -c 'if [ \"$GIT_STUNTS_DOCKER\" = \"1\" ]; then vitest run test/unit \"$@\"; else docker compose run --build --rm test npm run test:local -- \"$@\"; fi' --",
+    "test:local": "vitest run test/unit",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage test/unit",
+    "benchmark": "sh -c 'if [ \"$GIT_STUNTS_DOCKER\" = \"1\" ]; then vitest bench --run test/benchmark \"$@\"; else docker compose run --build --rm test npm run benchmark:local -- \"$@\"; fi' --",
+    "benchmark:local": "vitest bench --run test/benchmark",
+    "demo": "cd examples && docker compose up -d && docker compose exec demo bash",
+    "demo:setup": "cd examples && docker compose up -d && docker compose exec demo sh -c 'cd /app && npm install --silent && cd /demo && node /app/examples/setup.js'",
+    "demo:explore": "cd examples && docker compose exec demo node /app/examples/explore.js",
+    "demo:inspect": "cd examples && docker compose exec demo node /app/examples/inspect-index.js",
+    "demo:lagrangian": "cd examples && docker compose exec demo node /app/examples/lagrangian-path.js",
+    "demo:bench-streaming": "cd examples && docker compose up -d && docker compose exec demo node /app/examples/streaming-benchmark.js",
+    "demo:bench-traversal": "cd examples && docker compose up -d && docker compose exec demo node /app/examples/traversal-benchmark.js",
+    "demo:down": "cd examples && docker compose down -v",
+    "roadmap": "node scripts/roadmap.js",
+    "setup:hooks": "node scripts/setup-hooks.js",
+    "prepare": "patch-package && node scripts/setup-hooks.js",
+    "prepack": "npm run lint && npm run test:local",
+    "install:git-warp": "bash scripts/install-git-warp.sh",
+    "uninstall:git-warp": "bash scripts/uninstall-git-warp.sh"
+  },
+  "dependencies": {
+    "@git-stunts/alfred": "^0.4.0",
+    "@git-stunts/plumbing": "^2.8.0",
+    "@git-stunts/trailer-codec": "^2.1.1",
+    "boxen": "^7.1.1",
+    "cbor-x": "^1.6.0",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.3",
+    "elkjs": "^0.11.0",
+    "figures": "^6.0.1",
+    "roaring": "^2.7.0",
+    "string-width": "^7.1.0",
+    "wrap-ansi": "^9.0.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@git-stunts/docker-guard": "^0.1.0",
+    "@types/node": "^22.15.29",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "eslint": "^9.17.0",
+    "fast-check": "^4.5.3",
+    "patch-package": "^8.0.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0",
+    "vitest": "^2.1.8"
+  },
+  "keywords": [
+    "git",
+    "git-stunts",
+    "warp",
+    "graph",
+    "graph-database",
+    "dag",
+    "merkle",
+    "commit-graph",
+    "content-addressable",
+    "hexagonal",
+    "ddd",
+    "invisible-storage",
+    "empty-tree"
+  ],
+  "packageManager": "npm@10"
+}

package/scripts/install-git-warp.sh

@@ -0,0 +1,258 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_URL=${GIT_WARP_REPO_URL:-https://github.com/git-stunts/git-warp.git}
+INSTALL_DIR=${GIT_WARP_HOME:-$HOME/.git-warp}
+PROFILE_FILE=${GIT_WARP_PROFILE:-}
+FORCE_CLONE=0
+DRY_RUN=0
+SILENT=0
+SKIP_PROFILE=0
+
+usage() {
+  cat <<'USAGE'
+Git Warp bootstrap installer
+
+Usage: install-git-warp.sh [options]
+
+Options:
+  --force         overwrite existing installation directory
+  --profile FILE  shell profile to update (default: auto-detect)
+  --dry-run       show what would happen without making changes
+  --silent        reduce logging
+  --no-profile    do not modify any shell profile (print instructions instead)
+  -h, --help      show this help
+USAGE
+}
+
+log() { [ "$SILENT" -eq 1 ] || echo "[git-warp-install] $*"; }
+run() {
+  if [ "$DRY_RUN" -eq 1 ]; then
+    printf '+ '
+    printf '%q ' "$@"
+    printf '\n'
+    return 0
+  fi
+  "$@" || return $?
+}
+
+resolve_path() {
+  local raw="$1"
+  [ -n "$raw" ] || return 1
+
+  local path="$raw"
+  case "$path" in
+    ~) path="$HOME" ;;
+    ~/*) path="$HOME/${path#~/}" ;;
+  esac
+
+  if [ "${path#/}" = "$path" ]; then
+    path="$PWD/$path"
+  fi
+
+  local current="/"
+  local suffix="${path#/}"
+  local IFS='/'
+  # shellcheck disable=SC2206
+  local parts=( $suffix )
+  local part candidate
+
+  for part in "${parts[@]}"; do
+    case "$part" in
+      ''|.)
+        continue
+        ;;
+      ..)
+        current="${current%/*}"
+        [ -n "$current" ] || current="/"
+        continue
+        ;;
+    esac
+
+    if [ "$current" = "/" ]; then
+      candidate="/$part"
+    else
+      candidate="$current/$part"
+    fi
+
+    if [ -d "$candidate" ]; then
+      current="$(cd "$candidate" 2>/dev/null && pwd -P)" || return 1
+    else
+      current="$candidate"
+    fi
+  done
+
+  printf '%s' "$current"
+}
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --force) FORCE_CLONE=1 ;;
+    --dry-run) DRY_RUN=1 ;;
+    --silent) SILENT=1 ;;
+    --no-profile) SKIP_PROFILE=1 ;;
+    --profile)
+      shift || { usage; exit 1; }
+      PROFILE_FILE="$1"
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown flag: $1" >&2
+      usage
+      exit 1
+      ;;
+  esac
+  shift || break
+ done
+
+if [ -z "$PROFILE_FILE" ]; then
+  if [ -n "${ZDOTDIR:-}" ] && [ -f "$ZDOTDIR/.zshrc" ]; then
+    PROFILE_FILE="$ZDOTDIR/.zshrc"
+  elif [ -f "$HOME/.zshrc" ]; then
+    PROFILE_FILE="$HOME/.zshrc"
+  elif [ -f "$HOME/.bashrc" ]; then
+    PROFILE_FILE="$HOME/.bashrc"
+  elif [ -f "$HOME/.bash_profile" ]; then
+    PROFILE_FILE="$HOME/.bash_profile"
+  elif [ -f "$HOME/.profile" ]; then
+    PROFILE_FILE="$HOME/.profile"
+  fi
+fi
+
+if [ -z "$INSTALL_DIR" ]; then
+  echo "Error: GIT_WARP_HOME (install directory) must not be empty" >&2
+  exit 1
+fi
+
+RESOLVED_INSTALL_DIR=$(resolve_path "$INSTALL_DIR")
+if [ -z "$RESOLVED_INSTALL_DIR" ]; then
+  echo "Error: unable to resolve install path '$INSTALL_DIR'" >&2
+  exit 1
+fi
+
+case "$RESOLVED_INSTALL_DIR" in
+  /|/root|/root/*)
+    echo "Error: refusing to install into $RESOLVED_INSTALL_DIR" >&2
+    exit 1
+    ;;
+ esac
+
+ALLOWED_BASES=${GIT_WARP_ALLOWED_BASES:-$HOME:/opt/git-warp}
+IFS=':' read -r -a _git_warp_allowed <<< "$ALLOWED_BASES"
+allowed_ok=0
+for base in "${_git_warp_allowed[@]}"; do
+  [ -z "$base" ] && continue
+  resolved_base=$(resolve_path "$base" 2>/dev/null || true)
+  [ -z "$resolved_base" ] && continue
+  case "$RESOLVED_INSTALL_DIR" in
+    "$resolved_base"|"$resolved_base"/*)
+      allowed_ok=1
+      break
+      ;;
+  esac
+ done
+unset _git_warp_allowed
+
+if [ "$allowed_ok" -ne 1 ]; then
+  echo "Error: install directory $RESOLVED_INSTALL_DIR is outside permitted bases ($ALLOWED_BASES)" >&2
+  exit 1
+fi
+
+INSTALL_DIR="$RESOLVED_INSTALL_DIR"
+log "Install dir: $INSTALL_DIR"
+if [ -d "$INSTALL_DIR" ]; then
+  if [ "$FORCE_CLONE" -eq 1 ]; then
+    if [ -L "$INSTALL_DIR" ]; then
+      echo "Error: refusing to remove symlinked install dir ($INSTALL_DIR). Remove it manually first." >&2
+      exit 1
+    fi
+    log "Removing existing directory"
+    run rm -rf "$INSTALL_DIR"
+  else
+    log "Directory already exists; pulling latest"
+    if ! git -C "$INSTALL_DIR" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+      echo "Error: $INSTALL_DIR exists but is not a git repository (use --force to replace it)" >&2
+      exit 1
+    fi
+    default_branch=$(git -C "$INSTALL_DIR" remote show origin 2>/dev/null | awk '/HEAD branch/ {print $NF}')
+    if [ -z "$default_branch" ]; then
+      for candidate in main master; do
+        if git -C "$INSTALL_DIR" show-ref --verify --quiet "refs/remotes/origin/$candidate"; then
+          default_branch="$candidate"
+          break
+        fi
+      done
+    fi
+    if [ -z "$default_branch" ]; then
+      echo "Error: unable to determine origin default branch for $INSTALL_DIR" >&2
+      exit 1
+    fi
+    run git -C "$INSTALL_DIR" fetch origin "$default_branch"
+    run git -C "$INSTALL_DIR" reset --hard "origin/$default_branch"
+  fi
+else
+  log "Cloning repo from $REPO_URL"
+  run git clone "$REPO_URL" "$INSTALL_DIR"
+fi
+
+if [ "$DRY_RUN" -eq 0 ]; then
+  log "Installing dependencies"
+  if [ ! -f "$INSTALL_DIR/package.json" ]; then
+    log "Error: package.json not found in $INSTALL_DIR"
+    exit 1
+  fi
+  (cd "$INSTALL_DIR" && npm install ${SILENT:+--silent})
+  if [ ! -f "$INSTALL_DIR/bin/git-warp" ]; then
+    log "Error: expected $INSTALL_DIR/bin/git-warp to exist"
+    exit 1
+  fi
+  if [ ! -x "$INSTALL_DIR/bin/git-warp" ]; then
+    chmod +x "$INSTALL_DIR/bin/git-warp"
+  fi
+else
+  log "Would install dependencies"
+fi
+
+BIN_LINE="export PATH=\"$INSTALL_DIR/bin:\$PATH\""
+HOME_LINE="export GIT_WARP_HOME=\"$INSTALL_DIR\""
+PROFILE_UPDATED=0
+
+if [ "$SKIP_PROFILE" -eq 0 ] && [ -n "$PROFILE_FILE" ]; then
+  touch "$PROFILE_FILE"
+  if [ "$DRY_RUN" -eq 0 ]; then
+    if [ ! -f "$PROFILE_FILE.bak" ]; then
+      log "Creating backup $PROFILE_FILE.bak"
+      cp "$PROFILE_FILE" "$PROFILE_FILE.bak"
+    fi
+    if ! grep -E "^[[:space:]]*export[[:space:]]+GIT_WARP_HOME=" "$PROFILE_FILE" >/dev/null 2>&1; then
+      log "Updating $PROFILE_FILE"
+      printf '\n# Git Warp\nexport GIT_WARP_HOME="%s"\nexport PATH="%s/bin:$PATH"\n' "$INSTALL_DIR" "$INSTALL_DIR" >> "$PROFILE_FILE"
+      PROFILE_UPDATED=1
+    else
+      log "$PROFILE_FILE already references GIT_WARP_HOME; skipping"
+    fi
+  else
+    log "Would append env vars to $PROFILE_FILE"
+  fi
+else
+  log "No shell profile updated; export vars manually:"
+  log "  $HOME_LINE"
+  log "  $BIN_LINE"
+fi
+
+cat <<INFO
+
+Git Warp installed!
+Reload your shell or run:
+  $HOME_LINE
+  $BIN_LINE
+Then test with:
+  git warp --help
+INFO
+
+if [ "$PROFILE_UPDATED" -eq 1 ]; then
+  echo "(Appended PATH setup to $PROFILE_FILE)"
+fi

package/scripts/uninstall-git-warp.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+INSTALL_DIR=${GIT_WARP_HOME:-$HOME/.git-warp}
+PROFILE_FILE=${GIT_WARP_PROFILE:-}
+DRY_RUN=0
+SILENT=0
+NO_BACKUP=0
+
+usage() {
+  cat <<'USAGE'
+Git Warp uninstaller
+
+Usage: uninstall-git-warp.sh [options]
+
+Options:
+  --dry-run       show actions without performing them
+  --silent        reduce logging
+  --no-backup     do not create profile backups before editing
+  --profile FILE  explicit profile to edit (default: auto-detect)
+  -h, --help      show this help
+USAGE
+}
+
+log() { [ "$SILENT" -eq 1 ] || echo "[git-warp-uninstall] $*"; }
+run() {
+  if [ "$DRY_RUN" -eq 1 ]; then
+    printf '+ '
+    printf '%q ' "$@"
+    printf '\n'
+    return 0
+  fi
+  "$@" || return $?
+}
+
+sanitize_profile() {
+  local profile="$1" install_dir="$2"
+  local tmp
+  tmp=$(mktemp) || return 1
+  if ! awk -v dir="$install_dir" '
+    {
+      stripped=$0
+      sub(/^[[:space:]]+/, "", stripped)
+      sub(/[[:space:]]+$/, "", stripped)
+      if (stripped == "# Git Warp") next
+      if (index($0, dir) > 0) {
+        if (stripped ~ /^export[[:space:]]+GIT_WARP_HOME=/) next
+        if (stripped ~ /^export[[:space:]]+PATH=/ && index($0, dir "/bin") > 0) next
+      }
+      print $0
+    }
+  ' "$profile" > "$tmp"; then
+    rm -f "$tmp"
+    return 1
+  fi
+  mv "$tmp" "$profile"
+}
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --dry-run) DRY_RUN=1 ;;
+    --silent) SILENT=1 ;;
+    --no-backup) NO_BACKUP=1 ;;
+    --profile)
+      shift || { usage; exit 1; }
+      PROFILE_FILE="$1"
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown flag: $1" >&2
+      usage
+      exit 1
+      ;;
+  esac
+  shift || break
+ done
+
+if [ -z "$PROFILE_FILE" ]; then
+  if [ -n "${ZDOTDIR:-}" ] && [ -f "$ZDOTDIR/.zshrc" ]; then
+    PROFILE_FILE="$ZDOTDIR/.zshrc"
+  elif [ -f "$HOME/.zshrc" ]; then
+    PROFILE_FILE="$HOME/.zshrc"
+  elif [ -f "$HOME/.bashrc" ]; then
+    PROFILE_FILE="$HOME/.bashrc"
+  elif [ -f "$HOME/.bash_profile" ]; then
+    PROFILE_FILE="$HOME/.bash_profile"
+  elif [ -f "$HOME/.profile" ]; then
+    PROFILE_FILE="$HOME/.profile"
+  fi
+fi
+
+GIT_WARP_TARGET="$INSTALL_DIR/bin/git-warp"
+
+if [ -e "/usr/local/bin/git-warp" ]; then
+  if [ -L "/usr/local/bin/git-warp" ] && [ "$(readlink "/usr/local/bin/git-warp")" = "$GIT_WARP_TARGET" ]; then
+    log "Removing /usr/local/bin/git-warp"
+    run rm -f /usr/local/bin/git-warp
+  elif cmp -s "/usr/local/bin/git-warp" "$GIT_WARP_TARGET" 2>/dev/null; then
+    log "Removing /usr/local/bin/git-warp (matching installed copy)"
+    run rm -f /usr/local/bin/git-warp
+  else
+    log "Skipping removal of /usr/local/bin/git-warp (custom install detected)"
+  fi
+fi
+
+if [ -d "$INSTALL_DIR" ]; then
+  if [ -L "$INSTALL_DIR" ]; then
+    log "Refusing to remove symlinked install dir $INSTALL_DIR; remove manually"
+  else
+    log "Removing $INSTALL_DIR"
+    run rm -rf "$INSTALL_DIR"
+  fi
+else
+  log "Install directory $INSTALL_DIR not found"
+fi
+
+if [ -n "$PROFILE_FILE" ] && [ -f "$PROFILE_FILE" ]; then
+  if [ "$DRY_RUN" -eq 0 ] && [ "$NO_BACKUP" -eq 0 ]; then
+    if [ ! -f "$PROFILE_FILE.git-warp.bak" ]; then
+      log "Creating backup $PROFILE_FILE.git-warp.bak"
+      cp "$PROFILE_FILE" "$PROFILE_FILE.git-warp.bak"
+    fi
+  fi
+  log "Cleaning Git Warp lines from $PROFILE_FILE"
+  if [ "$DRY_RUN" -eq 1 ]; then
+    echo "+ removing Git Warp entries from $PROFILE_FILE"
+  else
+    if ! sanitize_profile "$PROFILE_FILE" "$INSTALL_DIR"; then
+      log "Error: failed to clean $PROFILE_FILE; leaving original in place."
+    fi
+  fi
+else
+  log "Profile file not found or unspecified; remove PATH/GIT_WARP_HOME entries manually if needed."
+fi
+
+log "Git Warp uninstall complete"