clawforge-cli 1.5.5__tar.gz → 1.6.1__tar.gz

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## v1.6.1 — quick-run CI Fix
+
+### Fixed
+- `quick-run` dry-run now works even when no agent (claude/codex) is installed
+- Agent placeholder used for dry-run/help; real runs still validate agent is present
+- Fixes test-quick-run failures on CI environments without Claude/Codex
+
+## v1.6.0 — quick-run: Zero-Overhead Direct Execution
+
+### Added
+- New `clawforge quick-run "<task>"` command
+  - Runs agent directly in current directory (or `--dir <path>`)
+  - No worktree, no branch, no tmux — streams output to terminal
+  - Flags: `--agent`, `--model`, `--save`, `--budget`, `--no-track`, `--dir`, `--dry-run`
+  - Output teed to log file (`~/.clawforge/registry/logs/`) and registered in task history
+  - Appears in `clawforge status` unless `--no-track` used
+- 34 test suites (new: `test-quick-run`)
+
+### Use case
+For quick questions, codebase exploration, or small fixes that don't need a branch/PR workflow.
+Use `clawforge sprint` when you need a branch, worktree, CI loop, and PR.
+
 ## v1.5.5 — TUI Observability: Logs + Diff Keys
 
 ### Added

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/Formula/clawforge.rb

@@ -1,7 +1,9 @@
 class Clawforge < Formula
   desc "Multi-mode coding workflow CLI for orchestrating AI coding agents"
   homepage "https://github.com/cyperx84/clawforge"
-  url "https://github.com/cyperx84/clawforge/archive/refs/tags/v1.5.4.tar.gz"
+  url "https://github.com/cyperx84/clawforge/archive/refs/tags/v1.6.0.tar.gz"
+  sha256 "240927908d5b2738b2e22156eeb360d09c5b20c3bde04b46a2b11d9de7466eba"
+  sha256 "b2d483778e83b9007b22bb4c421c90b71e7343cc4f244d116b99eaa2810dc433"
   sha256 "549b3ebf95c953cd4f366b5a251786c994726761c9d4ed6255b996b6458cf695"
   sha256 "2730fca0066fda9d3c864802c4346ab7c39d0daee39a254cc5cebd2694d4a1db"
   sha256 "a026cb0df5b7c3efae439a9ca912e728843deb56c70441591c9064f81a1041ae"

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawforge-cli
-Version: 1.5.5
+Version: 1.6.1
 Summary: Multi-mode coding workflow CLI for orchestrating AI coding agents
 Project-URL: Homepage, https://github.com/cyperx84/clawforge
 Project-URL: Repository, https://github.com/cyperx84/clawforge

clawforge_cli-1.6.1/VERSION

@@ -0,0 +1 @@
+1.6.1

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/bin/clawforge

@@ -43,6 +43,7 @@ Multi-mode coding workflow CLI — from quick patches to parallel agent orchestr
 Usage: clawforge <command> [options]
 
 Workflow Modes:
+  quick-run   Direct agent execution in cwd (no branch/worktree overhead)
   sprint      Single agent, full dev cycle (the workhorse)
   review      Quality gate on an existing PR (analysis only)
   swarm       Parallel multi-agent orchestration
@@ -260,6 +261,7 @@ doctor)     exec "${BIN_DIR}/doctor.sh" "$@" ;;
   spawn)      exec "${BIN_DIR}/spawn-agent.sh" "$@" ;;
   notify)     exec "${BIN_DIR}/notify.sh" "$@" ;;
   merge)      exec "${BIN_DIR}/merge-helper.sh" "$@" ;;
+  quick-run)  exec "${BIN_DIR}/quick-run.sh" "$@" ;;
   run)        run_combined "$@" ;;
 
   # Meta

clawforge_cli-1.6.1/bin/quick-run.sh

@@ -0,0 +1,211 @@
+#!/usr/bin/env bash
+# quick-run.sh — Zero-overhead direct agent execution in current directory.
+# No worktree, no branch, no tmux. Just runs the agent and streams output.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+usage() {
+  cat <<EOF
+Usage: clawforge quick-run "<task>" [options]
+
+Run an agent directly in the current (or specified) directory.
+No worktree, no branch, no tmux overhead — just streams output to your terminal.
+
+Arguments:
+  <task>               Task description (required)
+
+Options:
+  --dir <path>         Directory to run in (default: current working directory)
+  --agent <name>       Agent to use: claude or codex (default: auto-detect)
+  --model <model>      Model override
+  --no-track           Don't register in task registry
+  --save <file>        Save output to file (in addition to stdout)
+  --budget <usd>       Max spend cap (passed to agent if supported)
+  --dry-run            Show what would run without executing
+  --help               Show this help
+
+Examples:
+  clawforge quick-run "Explain what this codebase does"
+  clawforge quick-run "Add docstrings to all exported functions" --dir ~/github/mylib
+  clawforge quick-run "Fix the failing test" --agent codex --model gpt-5.3-codex
+  clawforge quick-run "Summarize recent git changes" --no-track
+  clawforge quick-run "Refactor auth.ts" --save /tmp/agent-output.log
+
+Notes:
+  - Output streams directly to your terminal (and optionally a file).
+  - The agent runs in the target directory with full file access.
+  - Results are tracked in the registry (use --no-track to skip).
+  - For tasks requiring a branch/PR, use: clawforge sprint "<task>"
+EOF
+}
+
+# ── Parse args ─────────────────────────────────────────────────────────
+TASK="" DIR="" AGENT="" MODEL="" NO_TRACK=false SAVE_PATH="" BUDGET="" DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dir)      DIR="$2"; shift 2 ;;
+    --agent)    AGENT="$2"; shift 2 ;;
+    --model)    MODEL="$2"; shift 2 ;;
+    --no-track) NO_TRACK=true; shift ;;
+    --save)     SAVE_PATH="$2"; shift 2 ;;
+    --budget)   BUDGET="$2"; shift 2 ;;
+    --dry-run)  DRY_RUN=true; shift ;;
+    --help|-h)  usage; exit 0 ;;
+    -*)         log_error "Unknown option: $1"; usage; exit 1 ;;
+    *)
+      if [[ -z "$TASK" ]]; then
+        TASK="$1"; shift
+      else
+        log_error "Unexpected argument: $1"; usage; exit 1
+      fi
+      ;;
+  esac
+done
+
+[[ -z "$TASK" ]] && { log_error "Task description is required"; usage; exit 1; }
+
+# ── Resolve directory ──────────────────────────────────────────────────
+if [[ -n "$DIR" ]]; then
+  [[ -d "$DIR" ]] || { log_error "Directory not found: $DIR"; exit 1; }
+  TARGET_DIR="$(cd "$DIR" && pwd)"
+else
+  TARGET_DIR="$(pwd)"
+fi
+
+# ── Resolve agent ──────────────────────────────────────────────────────
+RESOLVED_AGENT=$(detect_agent "${AGENT:-}" 2>/dev/null || echo "")
+if [[ -z "$RESOLVED_AGENT" ]]; then
+  RESOLVED_AGENT="${AGENT:-claude}"  # Use placeholder for dry-run/help; real run validates below
+fi
+
+# ── Resolve model ──────────────────────────────────────────────────────
+if [[ -z "$MODEL" ]]; then
+  if [[ "$RESOLVED_AGENT" == "codex" ]]; then
+    MODEL=$(config_get default_model_codex "gpt-5.3-codex")
+  else
+    MODEL=$(config_get default_model_claude "claude-sonnet-4-5")
+  fi
+fi
+
+# ── Build task ID ──────────────────────────────────────────────────────
+SAFE_SLUG=$(slugify_task "$TASK" 32)
+TASK_ID="qr-${SAFE_SLUG}"
+NOW=$(epoch_ms)
+
+# ── Dry-run ────────────────────────────────────────────────────────────
+if $DRY_RUN; then
+  echo "──────────────────────────────────────────"
+  echo "  clawforge quick-run [dry-run]"
+  echo "──────────────────────────────────────────"
+  echo "  task:      $TASK"
+  echo "  dir:       $TARGET_DIR"
+  echo "  agent:     $RESOLVED_AGENT"
+  echo "  model:     $MODEL"
+  echo "  track:     $( $NO_TRACK && echo no || echo yes)"
+  [[ -n "$SAVE_PATH" ]] && echo "  Save to:   $SAVE_PATH"
+  [[ -n "$BUDGET" ]]    && echo "  Budget:    \$$BUDGET"
+  echo "──────────────────────────────────────────"
+  exit 0
+fi
+
+# ── Validate agent is actually installed for real runs ────────────────
+REAL_AGENT=$(detect_agent "${AGENT:-}" 2>/dev/null || echo "")
+[[ -z "$REAL_AGENT" ]] && { log_error "No agent (claude/codex) found in PATH. Install Claude Code or Codex."; exit 1; }
+RESOLVED_AGENT="$REAL_AGENT"
+
+# ── Register task ──────────────────────────────────────────────────────
+SHORT_ID=""
+if ! $NO_TRACK; then
+  _ensure_registry
+  TASK_JSON=$(jq -n \
+    --arg id "$TASK_ID" \
+    --arg agent "$RESOLVED_AGENT" \
+    --arg model "$MODEL" \
+    --arg desc "$TASK" \
+    --arg dir "$TARGET_DIR" \
+    --argjson started "$NOW" \
+    '{
+      id: $id,
+      agent: $agent,
+      model: $model,
+      description: $desc,
+      repo: $dir,
+      worktree: $dir,
+      branch: "",
+      mode: "quick-run",
+      status: "running",
+      started_at: $started,
+      files_touched: [],
+      ci_retries: 0
+    }')
+  registry_add "$TASK_JSON"
+  SHORT_ID=$(registry_get "$TASK_ID" | jq -r '.short_id // empty')
+fi
+
+# ── Set up output capture ──────────────────────────────────────────────
+LOG_DIR="${CLAWFORGE_DIR}/registry/logs"
+mkdir -p "$LOG_DIR"
+LOG_FILE="${LOG_DIR}/${TASK_ID}.log"
+
+if ! $NO_TRACK; then
+  registry_update "$TASK_ID" "log_path" "\"$LOG_FILE\""
+fi
+
+# ── Build agent command ────────────────────────────────────────────────
+ESCAPED_TASK=$(printf '%s' "$TASK" | sed "s/'/'\\''/g")
+
+if [[ "$RESOLVED_AGENT" == "claude" ]]; then
+  BUDGET_FLAG=""
+  [[ -n "$BUDGET" ]] && BUDGET_FLAG="--max-budget-usd $BUDGET"
+  AGENT_CMD=(claude --model "$MODEL" --dangerously-skip-permissions -p "$TASK" $BUDGET_FLAG)
+elif [[ "$RESOLVED_AGENT" == "codex" ]]; then
+  AGENT_CMD=(codex --model "$MODEL" --dangerously-bypass-approvals-and-sandbox "$TASK")
+fi
+
+# ── Run ────────────────────────────────────────────────────────────────
+ID_LABEL=""
+[[ -n "$SHORT_ID" ]] && ID_LABEL=" [#${SHORT_ID}]"
+
+echo "──────────────────────────────────────────"
+echo "  ⚡ clawforge quick-run${ID_LABEL}"
+echo "──────────────────────────────────────────"
+echo "  Task:  $TASK"
+echo "  Dir:   $TARGET_DIR"
+echo "  Agent: $RESOLVED_AGENT ($MODEL)"
+echo "──────────────────────────────────────────"
+echo ""
+
+EXIT_CODE=0
+START_MS=$NOW
+
+if [[ -n "$SAVE_PATH" ]]; then
+  (cd "$TARGET_DIR" && "${AGENT_CMD[@]}" 2>&1) | tee "$LOG_FILE" "$SAVE_PATH" || EXIT_CODE=$?
+else
+  (cd "$TARGET_DIR" && "${AGENT_CMD[@]}" 2>&1) | tee "$LOG_FILE" || EXIT_CODE=$?
+fi
+
+END_MS=$(epoch_ms)
+DURATION_S=$(( (END_MS - START_MS) / 1000 ))
+
+echo ""
+echo "──────────────────────────────────────────"
+if [[ $EXIT_CODE -eq 0 ]]; then
+  echo "  ✅ Done in ${DURATION_S}s"
+else
+  echo "  ❌ Agent exited with code $EXIT_CODE (${DURATION_S}s)"
+fi
+[[ -n "$SAVE_PATH" ]] && echo "  📄 Saved to: $SAVE_PATH"
+echo "──────────────────────────────────────────"
+
+# ── Update registry ────────────────────────────────────────────────────
+if ! $NO_TRACK; then
+  FINAL_STATUS="done"
+  [[ $EXIT_CODE -ne 0 ]] && FINAL_STATUS="failed"
+  registry_update "$TASK_ID" "status" "\"$FINAL_STATUS\""
+  registry_update "$TASK_ID" "finished_at" "$(epoch_ms)"
+fi
+
+exit $EXIT_CODE

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyperx/clawforge",
-  "version": "1.5.5",
+  "version": "1.6.1",
   "description": "Multi-mode coding workflow CLI for orchestrating AI coding agents",
   "bin": {
     "@cyperx/clawforge": "./bin/clawforge"

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "clawforge-cli"
-version = "1.5.5"
+version = "1.6.1"
 description = "Multi-mode coding workflow CLI for orchestrating AI coding agents"
 readme = "README.md"
 license = "MIT"

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/tests/run-all-tests.sh

@@ -11,7 +11,7 @@ echo ""
 
 TOTAL_PASS=0
 TOTAL_FAIL=0
-TESTS=(test-cli test-registry test-spawn test-watch test-review test-scope test-notify test-merge test-clean test-learn test-foundation test-modes test-management test-dashboard test-tui test-cost test-templates test-conflicts test-ci-loop test-openclaw test-multi-repo test-routing test-memory test-init test-history test-eval test-reliability test-observability test-practical test-power test-dx test-web test-deps)
+TESTS=(test-cli test-registry test-spawn test-watch test-review test-scope test-notify test-merge test-clean test-learn test-foundation test-modes test-management test-dashboard test-tui test-cost test-templates test-conflicts test-ci-loop test-openclaw test-multi-repo test-routing test-memory test-init test-history test-eval test-reliability test-observability test-practical test-power test-dx test-web test-deps test-quick-run)
 
 for test in "${TESTS[@]}"; do
   echo "────────────────────────────────────────"

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/tests/test-dx.sh

@@ -134,10 +134,10 @@ assert_contains "help shows Developer Experience" "Developer Experience" "$cli_h
 # Test 11: version
 echo "Test 11: version"
 version=$(cat "${SCRIPT_DIR}/../VERSION")
-if [[ "$version" == "1.5.5" ]]; then
-  echo "  ✅ version is 1.5.5"; PASS=$((PASS+1))
+if [[ "$version" == "1.6.1" ]]; then
+  echo "  ✅ version is 1.6.1"; PASS=$((PASS+1))
 else
-  echo "  ❌ version is $version, expected 1.5.5"; FAIL=$((FAIL+1))
+  echo "  ❌ version is $version, expected 1.6.1"; FAIL=$((FAIL+1))
 fi
 
 echo ""

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/tests/test-observability.sh

@@ -77,7 +77,7 @@ assert_contains "dashboard help shows p key" "preview" "$tui_help"
 # Test 7: version
 echo "Test 7: version"
 version=$(cat "${SCRIPT_DIR}/../VERSION")
-assert_eq "version is 1.5.5" "1.5.5" "$version"
+assert_eq "version is 1.6.1" "1.6.1" "$version"
 
 echo ""
 echo "Results: $PASS passed, $FAIL failed"

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/tests/test-power.sh

@@ -121,7 +121,7 @@ assert_contains "help shows Power Features" "Power Features" "$cli_help"
 # Test 13: version
 echo "Test 13: version"
 version=$(cat "${SCRIPT_DIR}/../VERSION")
-assert_eq "version is 1.5.5" "1.5.5" "$version"
+assert_eq "version is 1.6.1" "1.6.1" "$version"
 
 echo ""
 echo "Results: $PASS passed, $FAIL failed"

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/tests/test-practical.sh

@@ -96,7 +96,7 @@ assert_contains "watch checks terminal states" "done|failed|timeout|cancelled" "
 # Test 9: version
 echo "Test 9: version"
 version=$(cat "${SCRIPT_DIR}/../VERSION")
-assert_eq "version is 1.5.5" "1.5.5" "$version"
+assert_eq "version is 1.6.1" "1.6.1" "$version"
 
 echo ""
 echo "Results: $PASS passed, $FAIL failed"

clawforge_cli-1.6.1/tests/test-quick-run.sh

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+# test-quick-run.sh — Tests for clawforge quick-run
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+CLI="${SCRIPT_DIR}/../bin/clawforge"
+QR="${SCRIPT_DIR}/../bin/quick-run.sh"
+
+PASS=0 FAIL=0
+
+assert_ok() {
+  local desc="$1"; shift
+  if "$@" >/dev/null 2>&1; then
+    echo "  ✅ $desc"; ((PASS++)) || true
+  else
+    echo "  ❌ $desc"; ((FAIL++)) || true
+  fi
+}
+
+assert_fail() {
+  local desc="$1"; shift
+  if ! "$@" >/dev/null 2>&1; then
+    echo "  ✅ $desc"; ((PASS++)) || true
+  else
+    echo "  ❌ $desc"; ((FAIL++)) || true
+  fi
+}
+
+assert_contains() {
+  local desc="$1" needle="$2"; shift 2
+  local output
+  output=$("$@" 2>&1 || true)
+  if grep -q "$needle" <<< "$output"; then
+    echo "  ✅ $desc"; ((PASS++)) || true
+  else
+    echo "  ❌ $desc (expected '$needle' in output)"; ((FAIL++)) || true
+  fi
+}
+
+echo "=== test-quick-run.sh ==="
+
+# Test 1: script exists and is executable
+echo "Test 1: script exists"
+assert_ok "quick-run.sh exists" test -f "$QR"
+assert_ok "quick-run.sh is executable" test -x "$QR"
+
+# Test 2: --help
+echo "Test 2: --help"
+assert_ok "help exits 0" "$QR" --help
+assert_contains "help shows usage"    "Usage:"           "$QR" --help
+assert_contains "help shows --dir"    "\-\-dir"          "$QR" --help
+assert_contains "help shows --agent"  "\-\-agent"        "$QR" --help
+assert_contains "help shows --model"  "\-\-model"        "$QR" --help
+assert_contains "help shows --save"   "\-\-save"         "$QR" --help
+assert_contains "help shows --budget" "\-\-budget"       "$QR" --help
+assert_contains "help shows --no-track" "\-\-no-track"   "$QR" --help
+assert_contains "help shows --dry-run" "\-\-dry-run"     "$QR" --help
+
+# Test 3: missing task fails
+echo "Test 3: missing task"
+assert_fail "no task fails" "$QR"
+
+# Test 4: bad dir fails
+echo "Test 4: bad dir"
+assert_fail "nonexistent dir fails" "$QR" "task" --dir /nonexistent/path
+
+# Test 5: dry-run
+echo "Test 5: dry-run"
+TMPDIR_TEST=$(mktemp -d)
+assert_contains "dry-run shows task"      "task"        "$QR" "Explain the code" --dir "$TMPDIR_TEST" --dry-run
+assert_contains "dry-run shows agent"     "agent:" "$QR" "Explain the code" --dir "$TMPDIR_TEST" --dry-run
+assert_contains "dry-run shows dir"       "$TMPDIR_TEST" "$QR" "Explain the code" --dir "$TMPDIR_TEST" --dry-run
+assert_contains "dry-run shows model"     "model"       "$QR" "Explain the code" --dir "$TMPDIR_TEST" --dry-run
+assert_contains "dry-run no-track shows no" "no"        "$QR" "Explain the code" --dir "$TMPDIR_TEST" --dry-run --no-track
+rm -rf "$TMPDIR_TEST"
+
+# Test 6: CLI routes quick-run
+echo "Test 6: CLI routing"
+assert_contains "CLI help shows quick-run" "quick-run"  "$CLI" help
+assert_contains "CLI routes to script"    "Usage:"      "$CLI" quick-run --help
+
+# Test 7: dry-run with options
+echo "Test 7: dry-run with budget + save"
+TMPDIR_TEST=$(mktemp -d)
+assert_contains "dry-run shows budget" "Budget" \
+  "$QR" "Fix the bug" --dir "$TMPDIR_TEST" --dry-run --budget 1.50
+assert_contains "dry-run shows save path" "/tmp" \
+  "$QR" "Fix the bug" --dir "$TMPDIR_TEST" --dry-run --save /tmp/out.log
+rm -rf "$TMPDIR_TEST"
+
+# Test 8: registry + log setup (with --no-track, no agent needed)
+echo "Test 8: source inspection"
+assert_contains "has epoch_ms"          "epoch_ms"     cat "$QR"
+assert_contains "has registry_add"      "registry_add" cat "$QR"
+assert_contains "has log_path"          "log_path"     cat "$QR"
+assert_contains "has tee"               "tee"          cat "$QR"
+assert_contains "has quick-run mode"    "quick-run"    cat "$QR"
+assert_contains "has detect_agent"      "detect_agent" cat "$QR"
+assert_contains "has no-track flag"     "NO_TRACK"     cat "$QR"
+assert_contains "has budget flag"       "BUDGET"       cat "$QR"
+assert_contains "has save flag"         "SAVE_PATH"    cat "$QR"
+
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[[ $FAIL -eq 0 ]] && exit 0 || exit 1

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/tests/test-reliability.sh

@@ -96,7 +96,7 @@ assert_contains "help shows Reliability" "Reliability" "$cli_help"
 # Test 11: version bump
 echo "Test 11: version"
 version=$(cat "${SCRIPT_DIR}/../VERSION")
-assert_eq "version is 1.5.5" "1.5.5" "$version"
+assert_eq "version is 1.6.1" "1.6.1" "$version"
 
 # Test 12: doctor --fix runs without errors
 echo "Test 12: doctor --fix"

{clawforge_cli-1.5.5 → clawforge_cli-1.6.1}/tests/test-web.sh

@@ -107,7 +107,7 @@ assert_contains "help shows Web Dashboard" "Web Dashboard" "$cli_help"
 # Test 7: version
 echo "Test 7: version"
 version=$(cat "${SCRIPT_DIR}/../VERSION")
-assert_eq "version is 1.5.5" "1.5.5" "$version"
+assert_eq "version is 1.6.1" "1.6.1" "$version"
 
 echo ""
 echo "Results: $PASS passed, $FAIL failed"

clawforge_cli-1.5.5/VERSION

@@ -1 +0,0 @@
-1.5.5