@cyperx/clawforge 1.2.0

package/bin/templates.sh

@@ -0,0 +1,244 @@
+#!/usr/bin/env bash
+# templates.sh — Task templates: pre-configured workflow settings
+# Usage: clawforge templates [list|new|show] [name]
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+BUILTIN_DIR="${CLAWFORGE_DIR}/lib/templates"
+USER_DIR="${HOME}/.clawforge/templates"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: clawforge templates [command] [name]
+
+Manage task templates for pre-configured workflows.
+
+Commands:
+  clawforge templates              List all available templates
+  clawforge templates show <name>  Show template details
+  clawforge templates new <name>   Create a new custom template
+
+Template Usage:
+  clawforge sprint --template refactor "Refactor auth module"
+  clawforge swarm --template migration "Migrate to TypeScript"
+
+Flags:
+  --json       Output as JSON
+  --help       Show this help
+EOF
+}
+
+# ── Parse args ─────────────────────────────────────────────────────────
+COMMAND="" NAME="" JSON_OUTPUT=false
+POSITIONAL=()
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --json)     JSON_OUTPUT=true; shift ;;
+    --help|-h)  usage; exit 0 ;;
+    --*)        log_error "Unknown option: $1"; usage; exit 1 ;;
+    *)          POSITIONAL+=("$1"); shift ;;
+  esac
+done
+
+if [[ ${#POSITIONAL[@]} -gt 0 ]]; then
+  COMMAND="${POSITIONAL[0]}"
+fi
+if [[ ${#POSITIONAL[@]} -gt 1 ]]; then
+  NAME="${POSITIONAL[1]}"
+fi
+
+# ── List templates ─────────────────────────────────────────────────────
+_list_templates() {
+  if $JSON_OUTPUT; then
+    local result="[]"
+  fi
+
+  if ! $JSON_OUTPUT; then
+    echo "=== Available Templates ==="
+    echo ""
+    echo "  Built-in:"
+  fi
+
+  # Built-in templates
+  if [[ -d "$BUILTIN_DIR" ]]; then
+    for f in "$BUILTIN_DIR"/*.json; do
+      [[ -f "$f" ]] || continue
+      local name desc mode
+      name=$(basename "$f" .json)
+      desc=$(jq -r '.description // "No description"' "$f" 2>/dev/null)
+      mode=$(jq -r '.mode // "—"' "$f" 2>/dev/null)
+      if $JSON_OUTPUT; then
+        local entry
+        entry=$(jq -c --arg name "$name" --arg source "builtin" '. + {name: $name, source: $source}' "$f" 2>/dev/null)
+        result=$(echo "$result" | jq --argjson e "$entry" '. += [$e]')
+      else
+        printf "    %-20s %-10s %s\n" "$name" "[$mode]" "$desc"
+      fi
+    done
+  fi
+
+  # User templates
+  if [[ -d "$USER_DIR" ]]; then
+    if ! $JSON_OUTPUT; then
+      echo ""
+      echo "  Custom:"
+    fi
+    local found=false
+    for f in "$USER_DIR"/*.json; do
+      [[ -f "$f" ]] || continue
+      found=true
+      local name desc mode
+      name=$(basename "$f" .json)
+      desc=$(jq -r '.description // "No description"' "$f" 2>/dev/null)
+      mode=$(jq -r '.mode // "—"' "$f" 2>/dev/null)
+      if $JSON_OUTPUT; then
+        local entry
+        entry=$(jq -c --arg name "$name" --arg source "custom" '. + {name: $name, source: $source}' "$f" 2>/dev/null)
+        result=$(echo "$result" | jq --argjson e "$entry" '. += [$e]')
+      else
+        printf "    %-20s %-10s %s\n" "$name" "[$mode]" "$desc"
+      fi
+    done
+    if ! $found && ! $JSON_OUTPUT; then
+      echo "    (none — create with: clawforge templates new <name>)"
+    fi
+  elif ! $JSON_OUTPUT; then
+    echo ""
+    echo "  Custom:"
+    echo "    (none — create with: clawforge templates new <name>)"
+  fi
+
+  if $JSON_OUTPUT; then
+    echo "$result" | jq '.'
+  fi
+}
+
+# ── Show template ──────────────────────────────────────────────────────
+_show_template() {
+  local name="$1"
+  local file=""
+
+  # Check user templates first, then builtin
+  if [[ -f "${USER_DIR}/${name}.json" ]]; then
+    file="${USER_DIR}/${name}.json"
+  elif [[ -f "${BUILTIN_DIR}/${name}.json" ]]; then
+    file="${BUILTIN_DIR}/${name}.json"
+  else
+    log_error "Template '$name' not found"
+    echo "Available templates:"
+    _list_templates
+    exit 1
+  fi
+
+  if $JSON_OUTPUT; then
+    jq --arg name "$name" '. + {name: $name}' "$file"
+  else
+    echo "=== Template: $name ==="
+    echo ""
+    jq -r 'to_entries[] | "  \(.key): \(.value)"' "$file" 2>/dev/null
+  fi
+}
+
+# ── Create new template ───────────────────────────────────────────────
+_new_template() {
+  local name="$1"
+  mkdir -p "$USER_DIR"
+
+  local target="${USER_DIR}/${name}.json"
+  if [[ -f "$target" ]]; then
+    log_error "Template '$name' already exists at $target"
+    exit 1
+  fi
+
+  echo "Creating template: $name"
+  echo ""
+
+  # Interactive prompts (or defaults if non-interactive)
+  local mode="sprint" max_agents=3 auto_merge=false ci_loop=false description=""
+
+  if [[ -t 0 ]]; then
+    printf "  Mode [sprint/swarm/review] (sprint): "
+    read -r mode_input
+    [[ -n "$mode_input" ]] && mode="$mode_input"
+
+    if [[ "$mode" == "swarm" ]]; then
+      printf "  Max agents (3): "
+      read -r agents_input
+      [[ -n "$agents_input" ]] && max_agents="$agents_input"
+    fi
+
+    printf "  Auto-merge [true/false] (false): "
+    read -r merge_input
+    [[ "$merge_input" == "true" ]] && auto_merge=true
+
+    printf "  CI loop [true/false] (false): "
+    read -r ci_input
+    [[ "$ci_input" == "true" ]] && ci_loop=true
+
+    printf "  Description: "
+    read -r description
+  fi
+
+  # Build template JSON
+  local template
+  template=$(jq -cn \
+    --arg mode "$mode" \
+    --argjson maxAgents "$max_agents" \
+    --argjson autoMerge "$auto_merge" \
+    --argjson ciLoop "$ci_loop" \
+    --arg description "${description:-Custom template: $name}" \
+    '{
+      mode: $mode,
+      maxAgents: $maxAgents,
+      autoMerge: $autoMerge,
+      ciLoop: $ciLoop,
+      description: $description
+    }')
+
+  echo "$template" | jq '.' > "$target"
+  echo ""
+  echo "Template saved: $target"
+  echo "$template" | jq '.'
+}
+
+# ── Load template (called from sprint/swarm) ──────────────────────────
+# Usage: source templates.sh && load_template <name>
+# Returns JSON template to stdout
+load_template() {
+  local name="$1"
+  local file=""
+
+  if [[ -f "${USER_DIR}/${name}.json" ]]; then
+    file="${USER_DIR}/${name}.json"
+  elif [[ -f "${BUILTIN_DIR}/${name}.json" ]]; then
+    file="${BUILTIN_DIR}/${name}.json"
+  else
+    log_error "Template '$name' not found"
+    return 1
+  fi
+
+  cat "$file"
+}
+
+# ── Route ──────────────────────────────────────────────────────────────
+case "${COMMAND:-list}" in
+  list|"")
+    _list_templates
+    ;;
+  show)
+    [[ -z "$NAME" ]] && { log_error "Template name required"; usage; exit 1; }
+    _show_template "$NAME"
+    ;;
+  new)
+    [[ -z "$NAME" ]] && { log_error "Template name required"; usage; exit 1; }
+    _new_template "$NAME"
+    ;;
+  *)
+    # Treat as template name to show
+    _show_template "$COMMAND"
+    ;;
+esac

package/lib/common.sh

@@ -0,0 +1,302 @@
+#!/usr/bin/env bash
+# common.sh — Shared functions for clawforge
+# Registry helpers, logging, config
+
+set -euo pipefail
+
+# ── Paths ──────────────────────────────────────────────────────────────
+CLAWFORGE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+REGISTRY_FILE="${CLAWFORGE_DIR}/registry/active-tasks.json"
+CONFIG_FILE="${CLAWFORGE_DIR}/config/defaults.json"
+
+# ── Logging ────────────────────────────────────────────────────────────
+log_info()  { echo "[INFO]  $(date +%H:%M:%S) $*" >&2; }
+log_warn()  { echo "[WARN]  $(date +%H:%M:%S) $*" >&2; }
+log_error() { echo "[ERROR] $(date +%H:%M:%S) $*" >&2; }
+log_debug() { [[ "${CLAWFORGE_DEBUG:-0}" == "1" ]] && echo "[DEBUG] $(date +%H:%M:%S) $*" >&2 || true; }
+
+# ── Config ─────────────────────────────────────────────────────────────
+USER_CONFIG_FILE="${HOME}/.clawforge/config.json"
+
+config_get() {
+  local key="$1"
+  local default="${2:-}"
+  # User config takes priority
+  if [[ -f "$USER_CONFIG_FILE" ]]; then
+    local val
+    val=$(jq -r ".$key // empty" "$USER_CONFIG_FILE" 2>/dev/null)
+    if [[ -n "$val" ]]; then
+      echo "$val"
+      return
+    fi
+  fi
+  # Fall back to project defaults
+  if [[ -f "$CONFIG_FILE" ]]; then
+    local val
+    val=$(jq -r ".$key // empty" "$CONFIG_FILE" 2>/dev/null)
+    if [[ -n "$val" ]]; then
+      echo "$val"
+      return
+    fi
+  fi
+  echo "$default"
+}
+
+config_set() {
+  local key="$1" value="$2"
+  mkdir -p "$(dirname "$USER_CONFIG_FILE")"
+  if [[ ! -f "$USER_CONFIG_FILE" ]]; then
+    echo '{}' > "$USER_CONFIG_FILE"
+  fi
+  local tmp
+  tmp=$(mktemp)
+  jq --arg k "$key" --arg v "$value" '.[$k] = $v' "$USER_CONFIG_FILE" > "$tmp" && mv "$tmp" "$USER_CONFIG_FILE"
+}
+
+config_list() {
+  echo "── User config (~/.clawforge/config.json) ──"
+  if [[ -f "$USER_CONFIG_FILE" ]]; then
+    jq '.' "$USER_CONFIG_FILE"
+  else
+    echo "(not created yet)"
+  fi
+  echo ""
+  echo "── Project defaults (config/defaults.json) ──"
+  if [[ -f "$CONFIG_FILE" ]]; then
+    jq '.' "$CONFIG_FILE"
+  else
+    echo "(not found)"
+  fi
+}
+
+# ── Registry helpers ───────────────────────────────────────────────────
+_ensure_registry() {
+  mkdir -p "$(dirname "$REGISTRY_FILE")"
+  if [[ ! -f "$REGISTRY_FILE" ]]; then
+    echo '{"tasks":[]}' > "$REGISTRY_FILE"
+  fi
+}
+
+
+# ── Registry file locking ──────────────────────────────────────────────
+REGISTRY_LOCK="${CLAWFORGE_DIR}/registry/.lock"
+
+_with_lock() {
+  mkdir -p "$(dirname "$REGISTRY_LOCK")"
+  local fd=200
+  eval "exec ${fd}>"$REGISTRY_LOCK""
+  if ! flock -w 5 $fd 2>/dev/null; then
+    log_error "Registry lock timeout — another clawforge process may be writing"
+    return 1
+  fi
+}
+
+_unlock() {
+  local fd=200
+  flock -u $fd 2>/dev/null || true
+}
+
+registry_add() {
+  local task_json="$1"
+  _ensure_registry
+  local tmp
+  tmp=$(mktemp)
+  jq --argjson task "$task_json" '.tasks += [$task]' "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
+  log_info "Registry: added task $(echo "$task_json" | jq -r '.id')"
+}
+
+registry_update() {
+  local id="$1" field="$2" value="$3"
+  _ensure_registry
+  local tmp
+  tmp=$(mktemp)
+  # Try to parse value as JSON; if it fails, treat as string
+  if echo "$value" | jq . >/dev/null 2>&1; then
+    jq --arg id "$id" --arg field "$field" --argjson val "$value" \
+      '(.tasks[] | select(.id == $id))[$field] = $val' "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
+  else
+    jq --arg id "$id" --arg field "$field" --arg val "$value" \
+      '(.tasks[] | select(.id == $id))[$field] = $val' "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
+  fi
+  log_debug "Registry: updated $id.$field"
+}
+
+registry_get() {
+  local id="$1"
+  _ensure_registry
+  jq --arg id "$id" '.tasks[] | select(.id == $id)' "$REGISTRY_FILE"
+}
+
+registry_list() {
+  _ensure_registry
+  local status_filter=""
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --status) status_filter="$2"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+  if [[ -n "$status_filter" ]]; then
+    jq --arg s "$status_filter" '[.tasks[] | select(.status == $s)]' "$REGISTRY_FILE"
+  else
+    jq '.tasks' "$REGISTRY_FILE"
+  fi
+}
+
+registry_remove() {
+  local id="$1"
+  _ensure_registry
+  local tmp
+  tmp=$(mktemp)
+  jq --arg id "$id" '.tasks = [.tasks[] | select(.id != $id)]' "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
+  log_info "Registry: removed task $id"
+}
+
+# ── Agent detection ────────────────────────────────────────────────────
+detect_agent() {
+  local preferred="${1:-}"
+  if [[ -n "$preferred" ]]; then
+    if command -v "$preferred" &>/dev/null; then
+      echo "$preferred"
+      return 0
+    else
+      log_error "Requested agent '$preferred' not found"
+      return 1
+    fi
+  fi
+  if command -v claude &>/dev/null; then
+    echo "claude"
+  elif command -v codex &>/dev/null; then
+    echo "codex"
+  else
+    log_error "No coding agent found (need claude or codex)"
+    return 1
+  fi
+}
+
+# ── Short ID management ───────────────────────────────────────────────
+# Sequential short IDs (#1, #2, #3...) mapped in registry
+_next_short_id() {
+  _ensure_registry
+  local max_id
+  max_id=$(jq '[.tasks[].short_id // 0] | max // 0' "$REGISTRY_FILE" 2>/dev/null || echo 0)
+  echo $((max_id + 1))
+}
+
+resolve_task_id() {
+  # Accept short ID (#1, 1), sub-agent ID (3.2), or full UUID/slug
+  local input="$1"
+  _ensure_registry
+
+  # Strip leading # if present
+  input="${input#\#}"
+
+  # Check if it's a sub-agent reference (e.g., 3.2)
+  if [[ "$input" =~ ^([0-9]+)\.([0-9]+)$ ]]; then
+    local parent_short="${BASH_REMATCH[1]}"
+    local sub_index="${BASH_REMATCH[2]}"
+    local parent_id
+    parent_id=$(jq -r --argjson sid "$parent_short" '.tasks[] | select(.short_id == $sid) | .id' "$REGISTRY_FILE" 2>/dev/null || true)
+    if [[ -n "$parent_id" ]]; then
+      # Find sub-agent by parent_id and sub_index
+      jq -r --arg pid "$parent_id" --argjson idx "$sub_index" \
+        '.tasks[] | select(.parent_id == $pid and .sub_index == $idx) | .id' "$REGISTRY_FILE" 2>/dev/null || true
+      return
+    fi
+  fi
+
+  # Check if it's a numeric short ID
+  if [[ "$input" =~ ^[0-9]+$ ]]; then
+    local resolved
+    resolved=$(jq -r --argjson sid "$input" '.tasks[] | select(.short_id == $sid) | .id' "$REGISTRY_FILE" 2>/dev/null || true)
+    if [[ -n "$resolved" ]]; then
+      echo "$resolved"
+      return
+    fi
+  fi
+
+  # Fall through: treat as full ID/slug
+  echo "$input"
+}
+
+# ── Auto-repo detection ──────────────────────────────────────────────
+detect_repo() {
+  # Walk up from cwd (or given path) to find .git
+  local start="${1:-$(pwd)}"
+  local dir="$start"
+  while [[ "$dir" != "/" ]]; do
+    if [[ -d "$dir/.git" ]] || [[ -f "$dir/.git" ]]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  log_error "No git repository found from $start"
+  return 1
+}
+
+# ── Auto-branch naming ───────────────────────────────────────────────
+slugify_task() {
+  # Convert task description to a URL-safe branch slug
+  local task="$1"
+  local max_len="${2:-40}"
+  echo "$task" \
+    | tr '[:upper:]' '[:lower:]' \
+    | sed 's/[^a-z0-9 ]//g' \
+    | sed 's/^  *//;s/  *$//' \
+    | sed 's/  */ /g' \
+    | sed 's/ /-/g' \
+    | cut -c1-"$max_len" \
+    | sed 's/-$//'
+}
+
+auto_branch_name() {
+  # Generate branch name with mode prefix and collision detection
+  local mode="$1"    # sprint, quick, swarm
+  local task="$2"
+  local repo="${3:-}"
+
+  local slug
+  slug=$(slugify_task "$task")
+  local prefix="${mode}/"
+  local candidate="${prefix}${slug}"
+
+  # Collision detection if repo is provided
+  if [[ -n "$repo" ]] && [[ -d "$repo/.git" ]]; then
+    local attempt=1
+    local base="$candidate"
+    while git -C "$repo" show-ref --verify --quiet "refs/heads/$candidate" 2>/dev/null; do
+      attempt=$((attempt + 1))
+      candidate="${base}-${attempt}"
+    done
+  fi
+
+  echo "$candidate"
+}
+
+# ── Utilities ──────────────────────────────────────────────────────────
+sanitize_branch() {
+  echo "$1" | sed 's|/|-|g' | sed 's|[^a-zA-Z0-9_-]|-|g'
+}
+
+epoch_ms() {
+  python3 -c 'import time; print(int(time.time()*1000))' 2>/dev/null || echo "$(date +%s)000"
+}
+
+# ── Disk space check ──────────────────────────────────────────────────
+disk_check() {
+  local dir="${1:-.}"
+  local warn_gb="${2:-5}"
+  local error_gb="${3:-1}"
+  local avail_kb
+  avail_kb=$(df -k "$dir" 2>/dev/null | awk 'NR==2{print $4}')
+  [[ -z "$avail_kb" ]] && return 0
+  local avail_gb=$((avail_kb / 1048576))
+  if [[ $avail_gb -lt $error_gb ]]; then
+    log_error "Disk space critically low: ${avail_gb}GB free (need ${error_gb}GB minimum)"
+    return 1
+  elif [[ $avail_gb -lt $warn_gb ]]; then
+    log_warn "Disk space low: ${avail_gb}GB free (warning threshold: ${warn_gb}GB)"
+  fi
+  return 0
+}

package/lib/templates/bugfix.json

@@ -0,0 +1,6 @@
+{
+  "mode": "sprint",
+  "quick": true,
+  "autoMerge": true,
+  "description": "Quick bugfix: sprint with auto-merge, skip review"
+}

package/lib/templates/migration.json

@@ -0,0 +1,7 @@
+{
+  "mode": "swarm",
+  "maxAgents": 4,
+  "autoMerge": true,
+  "ciLoop": true,
+  "description": "Large-scale migration: parallel agents with auto-merge and CI feedback"
+}

package/lib/templates/refactor.json

@@ -0,0 +1,6 @@
+{
+  "mode": "sprint",
+  "autoMerge": false,
+  "ciLoop": true,
+  "description": "Code refactoring: single agent with CI loop, manual merge for safety"
+}

package/lib/templates/security-audit.json

@@ -0,0 +1,5 @@
+{
+  "mode": "review",
+  "depth": "deep",
+  "description": "Security audit: deep review mode for thorough vulnerability analysis"
+}

package/lib/templates/test-coverage.json

@@ -0,0 +1,6 @@
+{
+  "mode": "swarm",
+  "maxAgents": 3,
+  "autoMerge": true,
+  "description": "Boost test coverage: parallel agents adding tests across modules"
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@cyperx/clawforge",
+  "version": "1.2.0",
+  "description": "Multi-mode coding workflow CLI for orchestrating AI coding agents",
+  "bin": {
+    "@cyperx/clawforge": "./bin/clawforge"
+  },
+  "scripts": {
+    "postinstall": "echo 'ClawForge installed. Run: clawforge help'"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cyperx84/clawforge.git"
+  },
+  "keywords": ["cli", "coding", "agents", "orchestration", "tmux", "worktree"],
+  "author": "cyperx84",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "os": ["darwin", "linux"],
+  "files": [
+    "bin/",
+    "lib/",
+    "tui/",
+    "registry/",
+    "VERSION",
+    "README.md",
+    "LICENSE"
+  ]
+}