@zachjxyz/moxie 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zach Johnson
+
+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/bin/moxie

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# moxie — spec-driven multi-agent development with quorum convergence
+#
+# Pipeline: rfc → audit → fix → plan → build
+# Each phase requires UNANIMOUS quorum from all agents.
+#
+# Usage:
+#   moxie init [--spec ./RFC.md]
+#   moxie start [--phase rfc|audit|fix|plan|build]
+#   moxie stop
+#   moxie run [--phase rfc|audit|fix|plan|build] [--dry-run]
+#   moxie status
+#   moxie cost
+#   moxie logs [phase]
+#   moxie agents
+
+set -euo pipefail
+
+MOXIE_VERSION="0.2.0"
+MOXIE_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+MOXIE_LIB="$MOXIE_ROOT/lib"
+
+# Source core library
+source "$MOXIE_LIB/core.sh"
+source "$MOXIE_LIB/agents.sh"
+source "$MOXIE_LIB/phases.sh"
+source "$MOXIE_LIB/tokens.sh"
+
+# ---- Subcommand dispatch ----
+
+COMMAND="${1:-help}"
+shift || true
+
+case "$COMMAND" in
+    init)       cmd_init "$@" ;;
+    start)      cmd_start "$@" ;;
+    stop)       cmd_stop "$@" ;;
+    run)        cmd_run "$@" ;;
+    status)     cmd_status "$@" ;;
+    cost)       cmd_cost "$@" ;;
+    logs)       cmd_logs "$@" ;;
+    agents)     cmd_agents "$@" ;;
+    doctor)     cmd_doctor "$@" ;;
+    version)    echo "moxie $MOXIE_VERSION" ;;
+    help|--help|-h)
+        cat <<'EOF'
+moxie — spec-driven multi-agent development with quorum convergence
+
+Commands:
+  init     Scaffold .moxie/ for the current project
+  start    Run pipeline in background (caffeinated, durable)
+  stop     Stop a running pipeline
+  run      Run pipeline in foreground (caffeinated)
+  status   Show phase progress, quorum state, and running status
+  cost     Token usage breakdown by phase and agent
+  logs     Tail or view logs for a phase
+  agents   List configured agents
+  doctor   Check agent CLIs, auth, and project health
+  version  Print version
+  help     Show this help
+
+Usage:
+  moxie init                         Initialize (RFC generated by agents)
+  moxie init --spec ./RFC.md         Initialize with existing spec
+  moxie init --no-discover           Skip context document discovery
+  moxie start                        Run pipeline in background
+  moxie start --phase build          Start just the build phase
+  moxie stop                         Stop background pipeline
+  moxie run                          Run full pipeline (foreground)
+  moxie run --phase fix              Run just the fix phase
+  moxie run --dry-run                Trace without spawning agents
+  moxie status                       Show progress and quorum
+  moxie cost                         Show token usage summary
+  moxie doctor                       Check agents and dependencies
+
+Pipeline: rfc → audit → fix → plan → build
+Each phase uses randomized agent rotation with UNANIMOUS quorum.
+The pipeline is durable — it resumes from where it left off.
+EOF
+        ;;
+    *)
+        echo "Unknown command: $COMMAND" >&2
+        echo "Run 'moxie help' for usage." >&2
+        exit 1
+        ;;
+esac

package/lib/agents.sh

@@ -0,0 +1,330 @@
+#!/usr/bin/env bash
+# moxie/lib/agents.sh — Agent dispatch and rotation
+# Compatible with Bash 3.2 (macOS default) — no associative arrays.
+
+# Global arrays populated by load_agents():
+#   AGENT_NAMES=("codex" "claude" "qwen")
+#   AGENT_CMDS_0="codex exec ..."  (indexed by position in AGENT_NAMES)
+#   AGENT_CMDS_1="claude ..."
+#   AGENT_CMDS_2="qwen ..."
+
+# ---- Load agents from config ----
+
+load_agents() {
+    require_moxie_project
+
+    AGENT_NAMES=()
+    local agent_cmds=()
+    local agent_orders=()
+
+    local current_agent=""
+    local current_cmd=""
+    local current_order="99"
+
+    while IFS= read -r line; do
+        [[ "$line" =~ ^[[:space:]]*# ]] && continue
+        [[ -z "${line// /}" ]] && continue
+
+        if [[ "$line" =~ ^\[agents\.([a-zA-Z0-9_-]+)\] ]]; then
+            if [ -n "$current_agent" ] && [ -n "$current_cmd" ]; then
+                AGENT_NAMES+=("$current_agent")
+                agent_cmds+=("$current_cmd")
+                agent_orders+=("$current_order")
+            fi
+            current_agent="${BASH_REMATCH[1]}"
+            current_cmd=""
+            current_order="99"
+            continue
+        fi
+
+        # New non-agent section
+        if [[ "$line" =~ ^\[ ]] && ! [[ "$line" =~ ^\[agents\. ]]; then
+            if [ -n "$current_agent" ] && [ -n "$current_cmd" ]; then
+                AGENT_NAMES+=("$current_agent")
+                agent_cmds+=("$current_cmd")
+                agent_orders+=("$current_order")
+            fi
+            current_agent=""
+            continue
+        fi
+
+        if [ -n "$current_agent" ]; then
+            if [[ "$line" =~ ^[[:space:]]*command[[:space:]]*=[[:space:]]*(.*) ]]; then
+                current_cmd="${BASH_REMATCH[1]}"
+                current_cmd="${current_cmd#\"}"
+                current_cmd="${current_cmd%\"}"
+                current_cmd="${current_cmd#\'}"
+                current_cmd="${current_cmd%\'}"
+            fi
+            if [[ "$line" =~ ^[[:space:]]*order[[:space:]]*=[[:space:]]*([0-9]+) ]]; then
+                current_order="${BASH_REMATCH[1]}"
+            fi
+        fi
+    done < "$MOXIE_CONFIG"
+
+    # Save last agent
+    if [ -n "$current_agent" ] && [ -n "$current_cmd" ]; then
+        AGENT_NAMES+=("$current_agent")
+        agent_cmds+=("$current_cmd")
+        agent_orders+=("$current_order")
+    fi
+
+    # Sort by order using a temp file
+    local sorted
+    sorted=$(for i in "${!AGENT_NAMES[@]}"; do
+        echo "${agent_orders[$i]} $i ${AGENT_NAMES[$i]}"
+    done | sort -n)
+
+    local sorted_names=()
+    local sorted_cmds=()
+
+    while read -r _order idx _name; do
+        sorted_names+=("${AGENT_NAMES[$idx]}")
+        sorted_cmds+=("${agent_cmds[$idx]}")
+    done <<< "$sorted"
+
+    AGENT_NAMES=("${sorted_names[@]}")
+
+    # Store commands as indexed globals (Bash 3.2 compatible)
+    for i in "${!sorted_cmds[@]}"; do
+        eval "AGENT_CMD_$i=\"${sorted_cmds[$i]}\""
+    done
+    AGENT_COUNT=${#AGENT_NAMES[@]}
+}
+
+# Get command for agent by name
+_agent_cmd() {
+    local name="$1"
+    for i in "${!AGENT_NAMES[@]}"; do
+        if [ "${AGENT_NAMES[$i]}" = "$name" ]; then
+            eval "echo \"\$AGENT_CMD_$i\""
+            return
+        fi
+    done
+    echo ""
+}
+
+# ---- Dispatch ----
+
+dispatch_agent() {
+    local agent="$1"
+    local prompt_file="$2"
+    local timeout_secs="$3"
+    local cmd
+    cmd=$(_agent_cmd "$agent")
+
+    if [ -z "$cmd" ]; then
+        echo "ERROR: No command configured for agent '$agent'" >&2
+        return 1
+    fi
+
+    # Isolate: strip plugin root vars so hooks from other CLIs can't fire
+    env -u CLAUDE_PLUGIN_ROOT \
+        -u CODEX_PLUGIN_ROOT \
+        -u CURSOR_PLUGIN_ROOT \
+        timeout "$timeout_secs" $cmd "$(cat "$prompt_file")" || {
+        local rc=$?
+        if [ $rc -eq 124 ]; then
+            echo "[TIMEOUT] $agent exceeded ${timeout_secs}s — skipping"
+        fi
+        return $rc
+    }
+}
+
+# ---- Rotation ----
+
+next_agent() {
+    local last="$1"
+    local len=${#AGENT_NAMES[@]}
+    for i in "${!AGENT_NAMES[@]}"; do
+        if [ "${AGENT_NAMES[$i]}" = "$last" ]; then
+            echo "${AGENT_NAMES[$(( (i + 1) % len ))]}"
+            return
+        fi
+    done
+    echo "${AGENT_NAMES[0]}"
+}
+
+# ---- Logging ----
+
+dispatch_logged() {
+    local agent="$1"
+    local prompt_file="$2"
+    local timeout_secs="$3"
+    local log_dir="$4"
+    local turn="$5"
+    local csv_file="$6"
+    local phase="$7"
+    local ts
+    ts=$(date +"%m%d%y-%H%M%S")
+    local logfile="${log_dir}/${agent}-${ts}.log"
+
+    echo "  Log: $(basename "$logfile")"
+
+    if [ "${DRY_RUN:-0}" = "1" ]; then
+        echo "  [DRY RUN] Would run: $agent" | tee "$logfile"
+        echo "  [DRY RUN] Prompt: $(wc -c < "$prompt_file" | tr -d ' ') bytes" | tee -a "$logfile"
+        record_tokens "$csv_file" "$turn" "$agent" "$ts" "0" "$phase"
+        return 0
+    fi
+
+    dispatch_agent "$agent" "$prompt_file" "$timeout_secs" 2>&1 | tee "$logfile" || true
+
+    local tokens
+    tokens=$(extract_tokens "$logfile" "$agent")
+    record_tokens "$csv_file" "$turn" "$agent" "$ts" "$tokens" "$phase"
+    echo "  Tokens: $tokens"
+}
+
+# ---- List agents ----
+
+cmd_agents() {
+    require_moxie_project
+    load_agents
+
+    echo "Configured agents (rotation order):"
+    echo ""
+    for i in "${!AGENT_NAMES[@]}"; do
+        local name="${AGENT_NAMES[$i]}"
+        local cmd
+        cmd=$(_agent_cmd "$name")
+        echo "  $((i + 1)). $name"
+        echo "     $cmd"
+    done
+}
+
+# ---- Doctor: health checks ----
+
+cmd_doctor() {
+    local has_project=0
+    if [ -d "$MOXIE_DIR" ] && [ -f "$MOXIE_CONFIG" ]; then
+        has_project=1
+        load_agents
+    fi
+
+    local all_ok=1
+
+    echo "moxie doctor"
+    echo ""
+
+    # ---- Dependencies ----
+    echo "Dependencies:"
+    _check_dep "python3" "Required for ledger parsing and token tracking" || all_ok=0
+    _check_dep "caffeinate" "Keeps machine awake during runs (macOS)" || true  # non-fatal
+    if ! command -v timeout &>/dev/null; then
+        if command -v gtimeout &>/dev/null; then
+            echo "  [OK] gtimeout (aliased as timeout)"
+        else
+            echo "  [!!] timeout — not found. Install coreutils: brew install coreutils"
+            echo "        Agent turns will have no timeout protection."
+        fi
+    else
+        echo "  [OK] timeout"
+    fi
+    echo ""
+
+    # ---- Agents ----
+    if [ "$has_project" = "1" ]; then
+        echo "Agents (from .moxie/config.toml):"
+        for i in "${!AGENT_NAMES[@]}"; do
+            local name="${AGENT_NAMES[$i]}"
+            local cmd
+            cmd=$(_agent_cmd "$name")
+
+            # Extract the base binary from the command
+            local binary
+            binary=$(echo "$cmd" | awk '{print $1}')
+
+            if ! command -v "$binary" &>/dev/null; then
+                echo "  [!!] $name — '$binary' not found on PATH"
+                all_ok=0
+                continue
+            fi
+
+            # Try --version to verify it's functional
+            local version
+            version=$("$binary" --version 2>&1 | head -1)
+            if [ $? -eq 0 ] && [ -n "$version" ]; then
+                echo "  [OK] $name — $version"
+            else
+                echo "  [??] $name — '$binary' found but --version failed"
+                echo "        May not be authenticated. Try running: $binary --version"
+            fi
+        done
+    else
+        echo "Agents:"
+        echo "  (no .moxie/ project — checking common agents)"
+        _check_agent_binary "codex" || all_ok=0
+        _check_agent_binary "claude" || all_ok=0
+        _check_agent_binary "qwen" || all_ok=0
+    fi
+    echo ""
+
+    # ---- Project state ----
+    if [ "$has_project" = "1" ]; then
+        echo "Project:"
+        echo "  [OK] .moxie/ directory found"
+
+        local spec="$MOXIE_DIR/spec.md"
+        if [ -f "$spec" ]; then
+            echo "  [OK] spec.md present ($(wc -l < "$spec" | tr -d ' ') lines)"
+        else
+            echo "  [!!] spec.md missing"
+            all_ok=0
+        fi
+
+        for phase in "${PHASES[@]}"; do
+            local ledger="$MOXIE_DIR/phases/$phase/ledger.json"
+            local prompt="$MOXIE_DIR/phases/$phase/prompt.txt"
+            if [ ! -f "$ledger" ]; then
+                echo "  [!!] $phase/ledger.json missing"
+                all_ok=0
+            fi
+            if [ ! -f "$prompt" ]; then
+                echo "  [!!] $phase/prompt.txt missing"
+                all_ok=0
+            fi
+        done
+        if [ "$all_ok" = "1" ]; then
+            echo "  [OK] All phase ledgers and prompts present"
+        fi
+    else
+        echo "Project:"
+        echo "  [--] No .moxie/ directory. Run 'moxie init' to set up."
+    fi
+
+    echo ""
+    if [ "$all_ok" = "1" ]; then
+        echo "All checks passed. Ready to run."
+    else
+        echo "Some checks failed. Fix the issues above before running."
+    fi
+}
+
+_check_dep() {
+    local binary="$1"
+    local desc="$2"
+    if command -v "$binary" &>/dev/null; then
+        echo "  [OK] $binary"
+        return 0
+    else
+        echo "  [!!] $binary — not found. $desc"
+        return 1
+    fi
+}
+
+_check_agent_binary() {
+    local binary="$1"
+    if ! command -v "$binary" &>/dev/null; then
+        echo "  [!!] $binary — not found on PATH"
+        return 1
+    fi
+    local version
+    version=$("$binary" --version 2>&1 | head -1)
+    if [ $? -eq 0 ] && [ -n "$version" ]; then
+        echo "  [OK] $binary — $version"
+    else
+        echo "  [??] $binary — found but --version failed"
+    fi
+    return 0
+}

package/lib/core.sh

@@ -0,0 +1,111 @@
+#!/usr/bin/env bash
+# moxie/lib/core.sh — Core utilities and configuration
+
+# ---- Constants ----
+MOXIE_DIR=".moxie"
+MOXIE_CONFIG="$MOXIE_DIR/config.toml"
+PHASES=(rfc audit fix plan build)
+
+# ---- macOS timeout compatibility ----
+if ! command -v timeout &>/dev/null; then
+    if command -v gtimeout &>/dev/null; then
+        timeout() { gtimeout "$@"; }
+    else
+        timeout() { shift; "$@"; }  # no-op fallback
+    fi
+fi
+
+# ---- Config parsing (TOML subset) ----
+
+# Read a dotted key from a TOML file. Supports flat keys only.
+# Usage: toml_get config.toml settings.max_rounds
+toml_get() {
+    local file="$1" key="$2" default="${3:-}"
+    local section="" field=""
+
+    # Split key into section.field
+    if [[ "$key" == *.* ]]; then
+        section="${key%%.*}"
+        field="${key#*.}"
+    else
+        field="$key"
+    fi
+
+    local in_section=0
+    local value=""
+
+    while IFS= read -r line; do
+        # Skip comments and empty lines
+        [[ "$line" =~ ^[[:space:]]*# ]] && continue
+        [[ -z "${line// /}" ]] && continue
+
+        # Section header
+        if [[ "$line" =~ ^\[([a-zA-Z0-9_.]+)\] ]]; then
+            local current="${BASH_REMATCH[1]}"
+            if [ -n "$section" ] && [ "$current" = "$section" ]; then
+                in_section=1
+            else
+                in_section=0
+            fi
+            continue
+        fi
+
+        # Key = value (only if in the right section, or no section needed)
+        if { [ -z "$section" ] && [ $in_section -eq 0 ]; } || [ $in_section -eq 1 ]; then
+            if [[ "$line" =~ ^[[:space:]]*${field}[[:space:]]*=[[:space:]]*(.*) ]]; then
+                value="${BASH_REMATCH[1]}"
+                # Strip quotes and trailing comments
+                value="${value%%#*}"
+                value="${value## }"
+                value="${value%% }"
+                value="${value#\"}"
+                value="${value%\"}"
+                value="${value#\'}"
+                value="${value%\'}"
+                break
+            fi
+        fi
+    done < "$file"
+
+    echo "${value:-$default}"
+}
+
+# ---- Project detection ----
+
+require_moxie_project() {
+    if [ ! -d "$MOXIE_DIR" ] || [ ! -f "$MOXIE_CONFIG" ]; then
+        echo "ERROR: No .moxie/ directory found." >&2
+        echo "Run 'moxie init --spec <file>' first." >&2
+        exit 1
+    fi
+}
+
+# ---- Display helpers ----
+
+banner() {
+    local title="$1"
+    local max_rounds="$2"
+    local timeout="$3"
+    local dry_run="${4:-0}"
+    echo "╔══════════════════════════════════════════════════╗"
+    printf "║  %-48s║\n" "$title"
+    echo "║  Round-robin quorum convergence                 ║"
+    printf "║  Max rounds: %-35s║\n" "$max_rounds"
+    printf "║  Timeout/turn: %-33s║\n" "${timeout}s"
+    if [ "$dry_run" = "1" ]; then
+    echo "║  Mode: DRY RUN                                  ║"
+    fi
+    echo "╚══════════════════════════════════════════════════╝"
+    echo ""
+}
+
+phase_label() {
+    case "$1" in
+        rfc)   echo "RFC" ;;
+        audit) echo "Audit" ;;
+        fix)   echo "Fix" ;;
+        plan)  echo "Plan" ;;
+        build) echo "Build" ;;
+        *)     echo "$1" ;;
+    esac
+}