dipship 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Centricle LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# dipship
+
+YOLO deployment. Git add, commit, push.
+
+```
+$ dipship
+dipship · 3 files changed
+YOLO? [Y/n] █
+```
+
+That's it. One command. Everything staged, committed, pushed.
+
+## Install
+
+```bash
+npm i -g dipship
+```
+
+Requires git and bash. The npm package is just a delivery vehicle — no Node runtime at invocation.
+
+## Usage
+
+```bash
+dipship                     # Interactive — prompts before shipping
+dipship "fixed the thing"   # Commit with message
+dipship -m "fixed the thing"  # Same thing
+dipship --yolo              # Skip the prompt, just ship
+dipship --dry-run           # See what would happen
+dipship uninstall           # Remove dipship and all config
+dipship uninstall --force   # Remove everything without prompts
+```
+
+## Config
+
+dipship uses source-able bash files. No JSON, no YAML, no parser.
+
+**Global** `~/.dipship`:
+
+```bash
+DIPSHIP_YOLO_REPOS=(
+  ~/Projects/scratch
+  ~/Projects/dotfiles
+)
+```
+
+**Per-repo** `.dipship` in repo root:
+
+```bash
+DIPSHIP_YOLO=true
+```
+
+YOLO-configured repos get a different prompt tone but still confirm. Only `--yolo` skips the prompt entirely.
+
+## Uninstall
+
+```bash
+dipship uninstall
+```
+
+Removes global config (`~/.dipship`), per-repo `.dipship` files, npx cache entries, and the global npm package. Prompts before each removal.
+
+`dipship uninstall --force` skips all prompts.
+
+## Edge cases
+
+- **No changes** — "Nothing to ship.", exit 0
+- **Not a git repo** — error, exit 1
+- **No remote** — error, exit 1
+
+## License
+
+MIT

package/bin/dipship

@@ -0,0 +1,307 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# dipship — YOLO deployment. Git add, commit, push.
+# ---------------------------------------------------------------------------
+
+VERSION="1.0.0"
+
+# Defaults
+DIPSHIP_YOLO=false
+DIPSHIP_MESSAGE="dipship"
+DRY_RUN=false
+DIPSHIP_YOLO_REPOS=()
+
+# ---------------------------------------------------------------------------
+# Config loading
+# ---------------------------------------------------------------------------
+
+# Global config
+[[ -f "$HOME/.dipship" ]] && source "$HOME/.dipship"
+
+# Per-repo config (overrides global)
+[[ -f "./.dipship" ]] && source "./.dipship"
+
+# Check if PWD is in YOLO repos list
+for repo in "${DIPSHIP_YOLO_REPOS[@]+"${DIPSHIP_YOLO_REPOS[@]}"}"; do
+  resolved=$(cd "$repo" 2>/dev/null && pwd -P) || continue
+  if [[ "$(pwd -P)" == "$resolved" ]]; then
+    DIPSHIP_YOLO=true
+    break
+  fi
+done
+
+# ---------------------------------------------------------------------------
+# Arg parsing
+# ---------------------------------------------------------------------------
+
+YOLO_FLAG=false
+MESSAGE_SET=false
+
+usage() {
+  cat <<'EOF'
+dipship — YOLO deployment. Git add, commit, push.
+
+Usage:
+  dipship                     Interactive commit & push
+  dipship "message"           Commit with message & push
+  dipship -m "message"        Same thing
+  dipship --yolo              Skip prompt, just ship
+  dipship --dry-run           Show what would happen
+  dipship uninstall           Remove dipship and all config
+  dipship uninstall --force   Remove everything without prompts
+
+Flags:
+  --yolo        Skip confirmation prompt
+  --dry-run     Preview without executing
+  -m "msg"      Commit message
+  -h, --help    Show this help
+  -v, --version Show version
+
+Config:
+  ~/.dipship        Global config (bash, source-able)
+  ./.dipship        Per-repo config (bash, source-able)
+
+  Set DIPSHIP_YOLO=true or list repos in DIPSHIP_YOLO_REPOS.
+EOF
+  exit 0
+}
+
+# ---------------------------------------------------------------------------
+# Uninstall
+# ---------------------------------------------------------------------------
+
+_confirm() {
+  local prompt="$1"
+  if [[ "$FORCE_UNINSTALL" == true ]]; then
+    return 0
+  fi
+  read -r -p "$prompt [y/N] " answer
+  [[ "$answer" =~ ^[Yy]$ ]]
+}
+
+dipship_uninstall() {
+  local removed=()
+  local kept=()
+
+  echo "dipship uninstall"
+  echo ""
+
+  # 1. Global config
+  if [[ -f "$HOME/.dipship" ]]; then
+    if _confirm "Remove global config ~/.dipship?"; then
+      rm "$HOME/.dipship"
+      removed+=("~/.dipship")
+    else
+      kept+=("~/.dipship")
+    fi
+  fi
+
+  # 2. Per-repo configs
+  local search_dirs=()
+  for dir in "$HOME/Projects" "$HOME/Clients" "$HOME/src" "$HOME/code" "$HOME/repos" "$HOME/dev" "$HOME/workspace"; do
+    [[ -d "$dir" ]] && search_dirs+=("$dir")
+  done
+
+  local repo_configs=()
+  if [[ ${#search_dirs[@]} -gt 0 ]]; then
+    while IFS= read -r -d '' f; do
+      repo_configs+=("$f")
+    done < <(find "${search_dirs[@]}" -name ".dipship" -not -path "*/node_modules/*" -not -path "*/.git/*" -print0 2>/dev/null)
+  fi
+
+  if [[ ${#repo_configs[@]} -gt 0 ]]; then
+    echo ""
+    echo "Found ${#repo_configs[@]} per-repo .dipship config(s):"
+    for f in "${repo_configs[@]}"; do
+      echo "  $f"
+    done
+
+    if [[ ${#repo_configs[@]} -gt 3 ]]; then
+      if _confirm "Remove all ${#repo_configs[@]} per-repo configs?"; then
+        for f in "${repo_configs[@]}"; do
+          rm "$f"
+          removed+=("$f")
+        done
+      else
+        kept+=("${repo_configs[@]}")
+      fi
+    else
+      for f in "${repo_configs[@]}"; do
+        if _confirm "Remove $f?"; then
+          rm "$f"
+          removed+=("$f")
+        else
+          kept+=("$f")
+        fi
+      done
+    fi
+  fi
+
+  # 3. npx cache
+  local npx_dir="$HOME/.npm/_npx"
+  if [[ -d "$npx_dir" ]]; then
+    local npx_removed=0
+    for entry in "$npx_dir"/*/; do
+      [[ -d "$entry" ]] || continue
+      if [[ -f "${entry}package-lock.json" ]] && grep -q '"dipship"' "${entry}package-lock.json" 2>/dev/null; then
+        rm -rf "$entry"
+        ((npx_removed++))
+      fi
+    done
+    if [[ $npx_removed -gt 0 ]]; then
+      removed+=("npx cache ($npx_removed entries)")
+    fi
+  fi
+
+  # 4. npm uninstall -g (last — this script is already in memory)
+  echo ""
+  if command -v dipship &>/dev/null; then
+    echo "Removing global npm package..."
+    npm uninstall -g dipship 2>/dev/null || true
+    removed+=("npm global package")
+  fi
+
+  # 5. Summary
+  echo ""
+  if [[ ${#removed[@]} -gt 0 ]]; then
+    echo "Removed:"
+    for item in "${removed[@]}"; do
+      echo "  ✓ $item"
+    done
+  fi
+  if [[ ${#kept[@]} -gt 0 ]]; then
+    echo "Kept:"
+    for item in "${kept[@]}"; do
+      echo "  - $item"
+    done
+  fi
+
+  # 6. Shell alias reminder
+  echo ""
+  echo "Check your shell profile for any dipship aliases you added manually."
+
+  # 7. Exit
+  echo ""
+  echo "dipship is gone. You animal."
+  exit 0
+}
+
+FORCE_UNINSTALL=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    uninstall)
+      shift
+      if [[ "${1:-}" == "--force" ]]; then
+        FORCE_UNINSTALL=true
+      fi
+      dipship_uninstall
+      ;;
+    --yolo)
+      YOLO_FLAG=true
+      shift
+      ;;
+    --dry-run)
+      DRY_RUN=true
+      shift
+      ;;
+    -m)
+      if [[ -z "${2:-}" ]]; then
+        echo "dipship: -m requires a message" >&2
+        exit 1
+      fi
+      DIPSHIP_MESSAGE="$2"
+      MESSAGE_SET=true
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      ;;
+    -v|--version)
+      echo "dipship $VERSION"
+      exit 0
+      ;;
+    -*)
+      echo "dipship: unknown flag '$1'" >&2
+      echo "Try 'dipship --help'" >&2
+      exit 1
+      ;;
+    *)
+      # Positional = commit message
+      DIPSHIP_MESSAGE="$1"
+      MESSAGE_SET=true
+      shift
+      ;;
+  esac
+done
+
+# ---------------------------------------------------------------------------
+# Preflight
+# ---------------------------------------------------------------------------
+
+# Must be in a git repo
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  echo "dipship: not a git repo" >&2
+  exit 1
+fi
+
+# Must have a remote
+if ! git remote get-url origin &>/dev/null; then
+  echo "dipship: no remote 'origin' configured" >&2
+  exit 1
+fi
+
+# Check for changes
+changes=$(git status --porcelain)
+if [[ -z "$changes" ]]; then
+  echo "Nothing to ship."
+  exit 0
+fi
+
+file_count=$(echo "$changes" | wc -l | tr -d ' ')
+branch=$(git symbolic-ref --short HEAD 2>/dev/null || echo "detached")
+remote_url=$(git remote get-url origin)
+
+# ---------------------------------------------------------------------------
+# Dry run
+# ---------------------------------------------------------------------------
+
+if [[ "$DRY_RUN" == true ]]; then
+  echo "dipship · dry run"
+  echo "  git add -A         → $file_count files"
+  echo "  git commit -m \"$DIPSHIP_MESSAGE\""
+  echo "  git push           → origin/$branch"
+  echo "Didn't ship."
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Prompt
+# ---------------------------------------------------------------------------
+
+if [[ "$YOLO_FLAG" != true ]]; then
+  if [[ "$DIPSHIP_YOLO" == true ]]; then
+    prompt="dipship · YOLO repo · $file_count files changed"$'\n'"Ship it? [Y/n] "
+  else
+    prompt="dipship · $file_count files changed"$'\n'"YOLO? [Y/n] "
+  fi
+
+  read -r -p "$prompt" answer
+  answer=${answer:-Y}
+  if [[ ! "$answer" =~ ^[Yy]$ ]]; then
+    echo "Bailed."
+    exit 0
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# Ship
+# ---------------------------------------------------------------------------
+
+git add -A
+git commit -m "$DIPSHIP_MESSAGE"
+git push
+
+echo "Shipped."

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "dipship",
+  "version": "1.0.0",
+  "description": "YOLO deployment. Git add, commit, push.",
+  "bin": {
+    "dipship": "bin/dipship"
+  },
+  "files": [
+    "bin/"
+  ],
+  "keywords": [
+    "git",
+    "deploy",
+    "yolo",
+    "cli"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/centricle/dipship.git"
+  },
+  "homepage": "https://github.com/centricle/dipship#readme",
+  "bugs": {
+    "url": "https://github.com/centricle/dipship/issues"
+  }
+}