shipwright-cli 1.7.0

package/scripts/cct-worktree.sh

@@ -0,0 +1,405 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  shipwright worktree — Git worktree management for multi-agent isolation       ║
+# ║                                                                          ║
+# ║  Each agent gets its own worktree so parallel agents don't clobber       ║
+# ║  each other's files. Worktrees live in .worktrees/ relative to root.    ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+set -euo pipefail
+
+# ─── Colors ────────────────────────────────────────────────────────────────
+CYAN='\033[38;2;0;212;255m'
+PURPLE='\033[38;2;124;58;237m'
+GREEN='\033[38;2;74;222;128m'
+YELLOW='\033[38;2;250;204;21m'
+RED='\033[38;2;248;113;113m'
+DIM='\033[2m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+info()    { echo -e "${CYAN}${BOLD}▸${RESET} $*"; }
+success() { echo -e "${GREEN}${BOLD}✓${RESET} $*"; }
+warn()    { echo -e "${YELLOW}${BOLD}⚠${RESET} $*"; }
+error()   { echo -e "${RED}${BOLD}✗${RESET} $*" >&2; }
+
+# ─── Repo root ─────────────────────────────────────────────────────────────
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)" || {
+    error "Not inside a git repository."
+    exit 1
+}
+
+WORKTREE_DIR="$REPO_ROOT/.worktrees"
+
+# ─── .gitignore helper ────────────────────────────────────────────────────
+ensure_gitignore() {
+    local gitignore="$REPO_ROOT/.gitignore"
+    if ! grep -q '^\.worktrees/' "$gitignore" 2>/dev/null; then
+        echo ".worktrees/" >> "$gitignore"
+        info "Added .worktrees/ to .gitignore"
+    fi
+}
+
+# ─── Commands ──────────────────────────────────────────────────────────────
+
+worktree_create() {
+    local name="$1"
+    local branch="${2:-loop/$name}"
+    local worktree_path="$WORKTREE_DIR/$name"
+
+    if [[ -d "$worktree_path" ]]; then
+        warn "Worktree '$name' already exists at $worktree_path"
+        return 0
+    fi
+
+    ensure_gitignore
+    mkdir -p "$WORKTREE_DIR"
+
+    # Create branch from current HEAD if it doesn't exist
+    git branch "$branch" HEAD 2>/dev/null || true
+
+    # Create worktree
+    git worktree add "$worktree_path" "$branch"
+
+    success "Created worktree: ${BOLD}$name${RESET} → $worktree_path ${DIM}(branch: $branch)${RESET}"
+}
+
+worktree_list() {
+    if [[ ! -d "$WORKTREE_DIR" ]]; then
+        echo -e "  ${DIM}No worktrees found.${RESET}"
+        return 0
+    fi
+
+    local found=0
+    echo ""
+    echo -e "${BOLD}AGENT WORKTREES${RESET}"
+    echo -e "${DIM}───────────────────────────────────────────────────────────────${RESET}"
+
+    for dir in "$WORKTREE_DIR"/*/; do
+        [[ -d "$dir" ]] || continue
+        local name
+        name="$(basename "$dir")"
+        local branch="loop/$name"
+        local main_branch
+        main_branch="$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")"
+
+        local ahead behind
+        ahead="$(git rev-list "$main_branch".."$branch" --count 2>/dev/null || echo "?")"
+        behind="$(git rev-list "$branch".."$main_branch" --count 2>/dev/null || echo "?")"
+
+        local status_str=""
+        if [[ "$ahead" != "?" && "$behind" != "?" ]]; then
+            if [[ "$ahead" -gt 0 && "$behind" -gt 0 ]]; then
+                status_str="${GREEN}${ahead} ahead${RESET}, ${YELLOW}${behind} behind${RESET}"
+            elif [[ "$ahead" -gt 0 ]]; then
+                status_str="${GREEN}${ahead} ahead${RESET}"
+            elif [[ "$behind" -gt 0 ]]; then
+                status_str="${YELLOW}${behind} behind${RESET}"
+            else
+                status_str="${DIM}up to date${RESET}"
+            fi
+        else
+            status_str="${DIM}?${RESET}"
+        fi
+
+        printf "  ${CYAN}%-16s${RESET} ${PURPLE}%-22s${RESET} %b  ${DIM}.worktrees/%s/${RESET}\n" \
+            "$name" "$branch" "$status_str" "$name"
+        ((found++))
+    done
+
+    if [[ $found -eq 0 ]]; then
+        echo -e "  ${DIM}No worktrees found.${RESET}"
+    fi
+    echo ""
+}
+
+worktree_sync() {
+    local name="$1"
+    local worktree_path="$WORKTREE_DIR/$name"
+
+    if [[ ! -d "$worktree_path" ]]; then
+        error "Worktree '$name' does not exist."
+        return 1
+    fi
+
+    info "Syncing ${BOLD}$name${RESET} with main..."
+
+    (
+        cd "$worktree_path"
+        git fetch origin main 2>/dev/null || true
+        git merge origin/main --no-edit 2>/dev/null || {
+            warn "Merge conflict in $name — resolve manually in $worktree_path"
+            return 1
+        }
+    )
+
+    success "Synced $name with latest main"
+}
+
+worktree_sync_all() {
+    if [[ ! -d "$WORKTREE_DIR" ]]; then
+        warn "No worktrees found."
+        return 0
+    fi
+
+    local count=0
+    local failed=0
+
+    for dir in "$WORKTREE_DIR"/*/; do
+        [[ -d "$dir" ]] || continue
+        local name
+        name="$(basename "$dir")"
+        worktree_sync "$name" || ((failed++))
+        ((count++))
+    done
+
+    echo ""
+    if [[ $failed -gt 0 ]]; then
+        warn "Synced $count worktrees, $failed had conflicts"
+    else
+        success "Synced $count worktrees"
+    fi
+}
+
+worktree_merge() {
+    local name="$1"
+    local branch="loop/$name"
+    local current_branch
+    current_branch="$(git branch --show-current)"
+
+    if ! git rev-parse --verify "$branch" &>/dev/null; then
+        error "Branch '$branch' does not exist."
+        return 1
+    fi
+
+    info "Merging ${BOLD}$branch${RESET} into ${BOLD}$current_branch${RESET}..."
+
+    git merge "$branch" --no-edit || {
+        error "Merge conflict merging $branch"
+        echo -e "  ${DIM}Resolve conflicts, then run: git merge --continue${RESET}"
+        return 1
+    }
+
+    success "Merged $branch into $current_branch"
+}
+
+worktree_merge_all() {
+    if [[ ! -d "$WORKTREE_DIR" ]]; then
+        warn "No worktrees found."
+        return 0
+    fi
+
+    local count=0
+
+    for dir in "$WORKTREE_DIR"/*/; do
+        [[ -d "$dir" ]] || continue
+        local name
+        name="$(basename "$dir")"
+
+        worktree_merge "$name" || {
+            error "Stopping merge-all due to conflict in $name"
+            echo -e "  ${DIM}Resolve the conflict, then re-run: shipwright worktree merge-all${RESET}"
+            return 1
+        }
+        ((count++))
+    done
+
+    echo ""
+    success "Merged $count worktree branches"
+}
+
+worktree_remove() {
+    local name="$1"
+    local worktree_path="$WORKTREE_DIR/$name"
+    local branch="loop/$name"
+
+    if [[ -d "$worktree_path" ]]; then
+        git worktree remove "$worktree_path" --force 2>/dev/null || {
+            warn "Could not cleanly remove worktree $name, forcing..."
+            rm -rf "$worktree_path"
+        }
+    fi
+
+    git branch -D "$branch" 2>/dev/null || true
+
+    success "Removed worktree: ${BOLD}$name${RESET}"
+}
+
+worktree_cleanup() {
+    if [[ ! -d "$WORKTREE_DIR" ]]; then
+        success "Nothing to clean up — no .worktrees/ directory."
+        return 0
+    fi
+
+    local count=0
+
+    for dir in "$WORKTREE_DIR"/*/; do
+        [[ -d "$dir" ]] || continue
+        local name
+        name="$(basename "$dir")"
+        worktree_remove "$name"
+        ((count++))
+    done
+
+    # Prune stale worktree references
+    git worktree prune
+
+    # Remove .worktrees directory if empty
+    rmdir "$WORKTREE_DIR" 2>/dev/null || true
+
+    echo ""
+    success "Cleaned up $count worktrees"
+}
+
+worktree_status() {
+    if [[ ! -d "$WORKTREE_DIR" ]]; then
+        echo -e "  ${DIM}No worktrees found.${RESET}"
+        return 0
+    fi
+
+    local main_branch
+    main_branch="$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")"
+    local found=0
+
+    echo ""
+    echo -e "${BOLD}WORKTREE STATUS${RESET}  ${DIM}(relative to ${main_branch})${RESET}"
+    echo -e "${DIM}───────────────────────────────────────────────────────────────${RESET}"
+
+    for dir in "$WORKTREE_DIR"/*/; do
+        [[ -d "$dir" ]] || continue
+        local name
+        name="$(basename "$dir")"
+        local branch="loop/$name"
+
+        local ahead behind
+        ahead="$(git rev-list "$main_branch".."$branch" --count 2>/dev/null || echo "?")"
+        behind="$(git rev-list "$branch".."$main_branch" --count 2>/dev/null || echo "?")"
+
+        # Check for uncommitted changes in the worktree
+        local dirty=""
+        if (cd "$dir" && [[ -n "$(git status --porcelain 2>/dev/null)" ]]); then
+            dirty=" ${RED}(dirty)${RESET}"
+        fi
+
+        printf "  ${CYAN}%-16s${RESET} ${PURPLE}%-22s${RESET} ${GREEN}%s ahead${RESET}, ${YELLOW}%s behind${RESET}%b\n" \
+            "$name" "$branch" "$ahead" "$behind" "$dirty"
+        ((found++))
+    done
+
+    if [[ $found -eq 0 ]]; then
+        echo -e "  ${DIM}No worktrees found.${RESET}"
+    fi
+    echo ""
+}
+
+worktree_help() {
+    echo ""
+    echo -e "${CYAN}${BOLD}shipwright worktree${RESET} — Git worktree management for multi-agent isolation"
+    echo ""
+    echo -e "${BOLD}USAGE${RESET}"
+    echo -e "  shipwright worktree <command> [options]"
+    echo ""
+    echo -e "${BOLD}COMMANDS${RESET}"
+    echo -e "  ${GREEN}create${RESET} <name> [--branch <branch>]   Create a worktree for an agent"
+    echo -e "  ${GREEN}list${RESET}                                  List active agent worktrees"
+    echo -e "  ${GREEN}sync${RESET} <name>                           Pull latest main into a worktree"
+    echo -e "  ${GREEN}sync-all${RESET}                              Sync all worktrees with main"
+    echo -e "  ${GREEN}merge${RESET} <name>                          Merge worktree branch back to main"
+    echo -e "  ${GREEN}merge-all${RESET}                             Merge all worktree branches sequentially"
+    echo -e "  ${GREEN}remove${RESET} <name>                         Remove a single worktree"
+    echo -e "  ${GREEN}cleanup${RESET}                               Remove ALL worktrees and branches"
+    echo -e "  ${GREEN}status${RESET}                                Show status of all worktrees"
+    echo -e "  ${GREEN}help${RESET}                                  Show this help"
+    echo ""
+    echo -e "${BOLD}EXAMPLES${RESET}"
+    echo -e "  ${DIM}shipwright worktree create agent-1${RESET}            # Create worktree on branch loop/agent-1"
+    echo -e "  ${DIM}shipwright worktree create agent-1 --branch feat${RESET}  # Custom branch name"
+    echo -e "  ${DIM}shipwright worktree merge-all${RESET}                 # Merge all agent work back to main"
+    echo -e "  ${DIM}shipwright worktree cleanup${RESET}                   # Remove all worktrees when done"
+    echo ""
+    echo -e "${BOLD}DIRECTORY STRUCTURE${RESET}"
+    echo -e "  ${DIM}project-root/${RESET}"
+    echo -e "  ${DIM}├── .worktrees/           # All agent worktrees${RESET}"
+    echo -e "  ${DIM}│   ├── agent-1/          # Full repo copy for agent 1${RESET}"
+    echo -e "  ${DIM}│   ├── agent-2/          # Full repo copy for agent 2${RESET}"
+    echo -e "  ${DIM}│   └── agent-3/          # Full repo copy for agent 3${RESET}"
+    echo -e "  ${DIM}└── .gitignore            # Includes .worktrees/${RESET}"
+    echo ""
+}
+
+# ─── Main dispatch ─────────────────────────────────────────────────────────
+
+COMMAND="${1:-help}"
+shift || true
+
+case "$COMMAND" in
+    create)
+        if [[ $# -lt 1 ]]; then
+            error "Usage: shipwright worktree create <name> [--branch <branch>]"
+            exit 1
+        fi
+        NAME="$1"
+        shift
+        BRANCH=""
+        while [[ $# -gt 0 ]]; do
+            case "$1" in
+                --branch)
+                    BRANCH="${2:-}"
+                    shift 2 || { error "--branch requires a value"; exit 1; }
+                    ;;
+                *)
+                    error "Unknown option: $1"
+                    exit 1
+                    ;;
+            esac
+        done
+        if [[ -n "$BRANCH" ]]; then
+            worktree_create "$NAME" "$BRANCH"
+        else
+            worktree_create "$NAME"
+        fi
+        ;;
+    list)
+        worktree_list
+        ;;
+    sync)
+        if [[ $# -lt 1 ]]; then
+            error "Usage: shipwright worktree sync <name>"
+            exit 1
+        fi
+        worktree_sync "$1"
+        ;;
+    sync-all)
+        worktree_sync_all
+        ;;
+    merge)
+        if [[ $# -lt 1 ]]; then
+            error "Usage: shipwright worktree merge <name>"
+            exit 1
+        fi
+        worktree_merge "$1"
+        ;;
+    merge-all)
+        worktree_merge_all
+        ;;
+    remove)
+        if [[ $# -lt 1 ]]; then
+            error "Usage: shipwright worktree remove <name>"
+            exit 1
+        fi
+        worktree_remove "$1"
+        ;;
+    cleanup)
+        worktree_cleanup
+        ;;
+    status)
+        worktree_status
+        ;;
+    help|--help|-h)
+        worktree_help
+        ;;
+    *)
+        error "Unknown command: $COMMAND"
+        echo -e "  ${DIM}Run 'shipwright worktree help' for usage.${RESET}"
+        exit 1
+        ;;
+esac

package/scripts/postinstall.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// ╔═══════════════════════════════════════════════════════════════════════════╗
+// ║  Shipwright — npm postinstall                                           ║
+// ║  Copies templates and migrates legacy config directories                ║
+// ╚═══════════════════════════════════════════════════════════════════════════╝
+
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, appendFileSync } from "fs";
+import { join } from "path";
+
+const HOME = process.env.HOME || process.env.USERPROFILE;
+const PKG_DIR = join(import.meta.dirname, "..");
+const SHIPWRIGHT_DIR = join(HOME, ".shipwright");
+const LEGACY_DIR = join(HOME, ".claude-teams");
+const CLAUDE_DIR = join(HOME, ".claude");
+
+const CYAN = "\x1b[38;2;0;212;255m";
+const GREEN = "\x1b[38;2;74;222;128m";
+const YELLOW = "\x1b[38;2;250;204;21m";
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+
+function info(msg) { console.log(`${CYAN}${BOLD}▸${RESET} ${msg}`); }
+function success(msg) { console.log(`${GREEN}${BOLD}✓${RESET} ${msg}`); }
+function warn(msg) { console.log(`${YELLOW}${BOLD}⚠${RESET} ${msg}`); }
+
+function ensureDir(dir) {
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+}
+
+function copyDir(src, dest) {
+  if (!existsSync(src)) return;
+  ensureDir(dest);
+  cpSync(src, dest, { recursive: true, force: false });
+}
+
+try {
+  // Copy team templates → ~/.shipwright/templates/
+  copyDir(join(PKG_DIR, "tmux", "templates"), join(SHIPWRIGHT_DIR, "templates"));
+  success("Installed team templates");
+
+  // Copy pipeline templates → ~/.shipwright/pipelines/
+  copyDir(join(PKG_DIR, "templates", "pipelines"), join(SHIPWRIGHT_DIR, "pipelines"));
+  success("Installed pipeline templates");
+
+  // Copy settings template → ~/.claude/settings.json.template (if missing)
+  const settingsTemplate = join(PKG_DIR, "claude-code", "settings.json");
+  const settingsDest = join(CLAUDE_DIR, "settings.json.template");
+  if (existsSync(settingsTemplate) && !existsSync(settingsDest)) {
+    ensureDir(CLAUDE_DIR);
+    cpSync(settingsTemplate, settingsDest);
+    success("Installed settings template");
+  }
+
+  // Install CLAUDE.md agent instructions → ~/.claude/CLAUDE.md (idempotent)
+  const claudeMdSrc = join(PKG_DIR, "claude-code", "CLAUDE.md.shipwright");
+  const claudeMdDest = join(CLAUDE_DIR, "CLAUDE.md");
+  if (existsSync(claudeMdSrc)) {
+    ensureDir(CLAUDE_DIR);
+    if (existsSync(claudeMdDest)) {
+      const existing = readFileSync(claudeMdDest, "utf8");
+      if (!existing.includes("Shipwright")) {
+        appendFileSync(claudeMdDest, "\n---\n\n" + readFileSync(claudeMdSrc, "utf8"));
+        success("Appended Shipwright instructions to ~/.claude/CLAUDE.md");
+      } else {
+        success("~/.claude/CLAUDE.md already contains Shipwright instructions");
+      }
+    } else {
+      cpSync(claudeMdSrc, claudeMdDest);
+      success("Installed ~/.claude/CLAUDE.md");
+    }
+  }
+
+  // Migrate ~/.claude-teams/ → ~/.shipwright/ (non-destructive)
+  if (existsSync(LEGACY_DIR) && !existsSync(join(SHIPWRIGHT_DIR, ".migrated"))) {
+    info("Migrating legacy ~/.claude-teams/ config...");
+    copyDir(LEGACY_DIR, SHIPWRIGHT_DIR);
+    writeFileSync(join(SHIPWRIGHT_DIR, ".migrated"), new Date().toISOString());
+    success("Migrated legacy config (originals preserved)");
+  }
+
+  // Print success banner
+  const version = JSON.parse(readFileSync(join(PKG_DIR, "package.json"), "utf8")).version;
+  console.log();
+  console.log(`${CYAN}${BOLD}  ⚓ Shipwright v${version} installed${RESET}`);
+  console.log();
+  console.log(`  Next steps:`);
+  console.log(`  ${DIM}$${RESET} shipwright doctor     ${DIM}# Verify your setup${RESET}`);
+  console.log(`  ${DIM}$${RESET} shipwright session    ${DIM}# Launch an agent team${RESET}`);
+  console.log(`  ${DIM}$${RESET} shipwright pipeline   ${DIM}# Run a delivery pipeline${RESET}`);
+  console.log();
+} catch (err) {
+  warn(`Postinstall encountered an issue: ${err.message}`);
+  warn("Shipwright is installed — some templates may need manual setup.");
+  warn(`Run: shipwright doctor`);
+}

package/templates/pipelines/autonomous.json

@@ -0,0 +1,71 @@
+{
+  "name": "autonomous",
+  "description": "Fully autonomous pipeline with compound quality — zero human gates",
+  "defaults": {
+    "test_cmd": "npm test",
+    "model": "opus",
+    "agents": 1
+  },
+  "stages": [
+    { "id": "intake", "enabled": true, "gate": "auto", "config": {} },
+    { "id": "plan", "enabled": true, "gate": "auto", "config": { "model": "opus" } },
+    { "id": "design", "enabled": true, "gate": "auto", "config": { "model": "opus" } },
+    {
+      "id": "build",
+      "enabled": true,
+      "gate": "auto",
+      "config": { "max_iterations": 20, "audit": true, "quality_gates": true }
+    },
+    { "id": "test", "enabled": true, "gate": "auto", "config": { "coverage_min": 80 } },
+    { "id": "review", "enabled": true, "gate": "auto", "config": {} },
+    {
+      "id": "compound_quality",
+      "enabled": true,
+      "gate": "auto",
+      "config": {
+        "adversarial": true,
+        "negative": true,
+        "e2e": true,
+        "dod_audit": true,
+        "max_cycles": 3
+      }
+    },
+    { "id": "pr", "enabled": true, "gate": "auto", "config": { "wait_ci": false } },
+    {
+      "id": "merge",
+      "enabled": true,
+      "gate": "auto",
+      "config": {
+        "merge_method": "squash",
+        "wait_ci_timeout_s": 600,
+        "auto_delete_branch": true
+      }
+    },
+    {
+      "id": "deploy",
+      "enabled": false,
+      "gate": "approve",
+      "config": { "staging_cmd": "", "production_cmd": "", "rollback_cmd": "" }
+    },
+    {
+      "id": "validate",
+      "enabled": false,
+      "gate": "auto",
+      "config": { "smoke_cmd": "", "health_url": "", "close_issue": true }
+    },
+    {
+      "id": "monitor",
+      "enabled": true,
+      "gate": "auto",
+      "config": {
+        "duration_minutes": 5,
+        "health_url": "",
+        "error_threshold": 5,
+        "log_pattern": "ERROR|FATAL|PANIC",
+        "log_cmd": "",
+        "rollback_cmd": "",
+        "auto_rollback": false
+      }
+    }
+  ]
+}

package/templates/pipelines/cost-aware.json

@@ -0,0 +1,95 @@
+{
+  "name": "cost-aware",
+  "description": "Cost-optimized pipeline: budget limits, model routing (haiku→sonnet→opus), per-stage tracking",
+  "defaults": {
+    "test_cmd": "npm test",
+    "model": "sonnet",
+    "agents": 1,
+    "cost_tracking": true,
+    "budget_check": true
+  },
+  "stages": [
+    {
+      "id": "intake",
+      "enabled": true,
+      "gate": "auto",
+      "config": {
+        "model": "haiku",
+        "cost_tracking": true
+      }
+    },
+    {
+      "id": "plan",
+      "enabled": true,
+      "gate": "approve",
+      "config": {
+        "model": "sonnet",
+        "cost_tracking": true
+      }
+    },
+    {
+      "id": "build",
+      "enabled": true,
+      "gate": "auto",
+      "config": {
+        "model": "sonnet",
+        "max_iterations": 20,
+        "audit": true,
+        "quality_gates": true,
+        "cost_tracking": true,
+        "abort_on_budget": true
+      }
+    },
+    {
+      "id": "test",
+      "enabled": true,
+      "gate": "auto",
+      "config": {
+        "coverage_min": 80,
+        "model": "haiku",
+        "cost_tracking": true
+      }
+    },
+    {
+      "id": "review",
+      "enabled": true,
+      "gate": "approve",
+      "config": {
+        "model": "opus",
+        "cost_tracking": true
+      }
+    },
+    {
+      "id": "pr",
+      "enabled": true,
+      "gate": "approve",
+      "config": {
+        "wait_ci": false,
+        "model": "haiku",
+        "cost_tracking": true
+      }
+    },
+    {
+      "id": "deploy",
+      "enabled": false,
+      "gate": "approve",
+      "config": {
+        "staging_cmd": "",
+        "production_cmd": "",
+        "rollback_cmd": "",
+        "cost_tracking": true
+      }
+    },
+    {
+      "id": "validate",
+      "enabled": false,
+      "gate": "auto",
+      "config": {
+        "smoke_cmd": "",
+        "health_url": "",
+        "close_issue": true,
+        "cost_tracking": true
+      }
+    }
+  ]
+}