@zachjxyz/moxie 0.6.2 → 0.6.4

package/bin/moxie

@@ -17,7 +17,7 @@
 
 set -euo pipefail
 
-MOXIE_VERSION="0.6.2"
+MOXIE_VERSION="0.6.4"
 # Resolve symlinks (npm installs bin as a symlink)
 _self="$0"
 while [ -L "$_self" ]; do

package/lib/phases.sh

@@ -1108,8 +1108,51 @@ _force_accept_best_draft() {
     done
 
     if [ -z "$best" ]; then
-        echo "  No draft files found to accept." >&2
-        return 1
+        # No draft .md files — create a synthetic FINAL from the ledger
+        # (common for fix/build phases where agents modify code directly)
+        echo "  No draft files found — creating FINAL from ledger state."
+        local ts
+        ts=$(date +"%m%d%y-%H%M%S")
+        local final_file="$phase_dir/${final_prefix}-${ts}.md"
+        python3 -c "
+import json
+with open('$ledger') as f:
+    d = json.load(f)
+lines = ['# $(phase_prefix "${final_prefix%-FINAL}") Phase — Complete', '']
+lines.append('Phase completed via force-accept (all agents verified).')
+lines.append('')
+for name, info in d.get('agents', {}).items():
+    status = 'reached' if info.get('reached') else 'pending'
+    note = info.get('notes', '')
+    lines.append(f'- **{name}**: {status}')
+    if note:
+        lines.append(f'  {note}')
+for item in d.get('findings', d.get('issues', [])):
+    if isinstance(item, str):
+        lines.append(f'- {item}')
+    elif isinstance(item, dict):
+        lines.append(f'- {item}')
+print('\n'.join(lines))
+" > "$final_file" 2>/dev/null
+
+        # Mark all agents as reached in the ledger
+        python3 -c "
+import json, os
+with open('$ledger') as f:
+    d = json.load(f)
+for name in d.get('agents', {}):
+    d['agents'][name]['reached'] = True
+d['status'] = '$(echo "$final_prefix" | tr '[:upper:]' '[:lower:]' | tr '-' '_')'
+tmp = '$ledger' + '.tmp'
+with open(tmp, 'w') as f:
+    json.dump(d, f, indent=2)
+os.rename(tmp, '$ledger')
+" 2>/dev/null
+
+        echo "  Accepted: $(basename "$final_file")"
+        echo ""
+        _show_quorum "$ledger"
+        return 0
     fi
 
     local ts
@@ -1324,8 +1367,18 @@ with open('$prompt_file', 'w') as f:
                 show_phase_tokens "$csv"
                 return 0
             else
-                echo "  All healthy agents reached quorum but FINAL file not yet written."
-                echo "  Next agent will write it."
+                echo "  All healthy agents reached quorum — writing FINAL."
+                _force_accept_best_draft "$phase_dir" "$final_prefix" "$ledger"
+                local healthy
+                healthy=$(count_healthy_agents)
+                echo ""
+                echo "╔════════════════════════════════════════════════════════════╗"
+                printf "║  %-58s║\n" "$(phase_label "$phase") phase complete — quorum reached"
+                printf "║  %d/%d agents signed off                                   ║\n" "$healthy" "$AGENT_COUNT"
+                echo "╚════════════════════════════════════════════════════════════╝"
+                echo ""
+                show_phase_tokens "$csv"
+                return 0
             fi
         fi
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zachjxyz/moxie",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "Run multiple AI coding agents through spec-driven phases with quorum convergence. Supports CLI agents (Claude, Codex, Qwen, Aider, Goose, Amp, Cline, Roo) and Vercel AI Gateway models.",
   "bin": {
     "moxie": "bin/moxie"

package/templates/01-rfc/prompt.txt

@@ -35,22 +35,19 @@ Thoroughly explore the project directory. Read:
 
 ### Step 3: Generate or review the RFC
 
-**If no draft exists:** Write a comprehensive RFC covering:
-
-1. **Title and Summary** — What the project is, in one paragraph
-2. **Motivation** — Why this project exists, what problem it solves
-3. **Architecture Overview** — High-level system diagram (text), key modules and their responsibilities
-4. **Data Model** — All entities, their fields, relationships, constraints
-5. **API Surface** — Every endpoint/tool/command with request/response schemas
-6. **Authentication & Authorization** — Auth model, roles, permissions
-7. **Core Algorithms** — Search, ranking, lifecycle, processing pipelines
-8. **Configuration** — All config options, environment variables, defaults
-9. **Error Handling** — Error taxonomy, status codes, retry strategies
-10. **Observability** — Logging, metrics, tracing, health checks
-11. **Build & Deployment** — How to build, test, deploy
-12. **Security Considerations** — Threat model, mitigations
-13. **Open Questions** — Unresolved design decisions (if any)
-
+**If no draft exists:** Write a comprehensive RFC. Include ONLY sections relevant to this
+project — do not invent sections for features that don't exist. Common sections:
+
+- **Title and Summary** — What the project is, in one paragraph
+- **Architecture Overview** — Key modules, their responsibilities, how they connect
+- **Data Model** — Entities, fields, relationships (if applicable)
+- **API Surface** — Endpoints, commands, or interfaces (if applicable)
+- **Core Logic** — Main algorithms, processing pipelines, business rules
+- **Configuration** — Config options, environment variables, defaults
+- **Build & Deployment** — How to build, test, deploy
+- **Open Questions** — Unresolved design decisions (if any)
+
+Skip sections that don't apply. Do NOT pad the RFC with placeholder content.
 For EACH section, cite specific files and line numbers from the actual source code.
 
 **If a draft exists:** Review it section by section against the actual source code.
@@ -88,6 +85,7 @@ If ALL agents (every agent in the config) show `reached: true`:
 
 - Be EXHAUSTIVE — this RFC drives the entire pipeline. Missing details here mean gaps downstream.
 - ALWAYS verify against actual source code. Cite file paths and line numbers for every claim.
+- Be efficient with tool use: use offset/limit when reading files — only read the sections you need, not entire files.
 - NEVER rubber-stamp a draft. Read the source code yourself and independently verify.
 - The RFC must be self-contained: an agent reading only this document should understand the full system.
 - Do NOT shortcut this phase for speed. Thoroughness is the goal. Quorum means genuine agreement.

package/templates/02-audit/prompt.txt

@@ -63,7 +63,10 @@ Update `.moxie/phases/02-audit/ledger.json`:
 - Add/update your agent in the `agents` map with `output_file` pointing to your file
 - If you confirmed ALL findings from ALL prior agents with ZERO new findings and ZERO corrections:
   set your entry to `reached: true`
-- If you have ANY new findings or corrections: reset ALL agents to `reached: false`
+- If you have new findings rated **medium or higher**, or corrections to existing findings:
+  reset ALL agents to `reached: false` (forces re-verification)
+- Trivial findings (low severity, documentation-only, cosmetic) should be noted but do NOT
+  require resetting quorum — add them to findings and keep existing reached states
 
 ### Step 6: Quorum check
 
@@ -84,6 +87,7 @@ Do NOT write the FINAL file unless ALL agents show `reached: true` in the ledger
 
 - ALWAYS verify against actual source code, not other audits
 - ALWAYS cite file paths and line numbers
+- Be efficient with tool use: use offset/limit when reading files — only read the sections you need, not entire files.
 - NEVER rubber-stamp — check the source yourself even if you agree
 - Do NOT shortcut this phase for speed. Thoroughness prevents bugs downstream.
 - If you are unsure about a finding, investigate deeper rather than confirming blindly

package/templates/03-fix/prompt.txt

@@ -59,7 +59,10 @@ Do NOT write the FINAL file unless ALL agents show `reached: true` in the ledger
 
 ## Rules
 
+- ONLY fix issues listed in the AUDIT-FINAL document. Do not refactor, clean up, or "improve"
+  code beyond what the audit identified. Scope creep here delays the pipeline.
 - Fix highest severity issues first
+- Be efficient with tool use: use offset/limit when reading files — only read the sections you need.
 - ALWAYS run the full test suite after changes
 - NEVER introduce new warnings or break existing tests
 - When verifying, actually READ the code — not just test output

package/templates/04-plan/prompt.txt

@@ -8,8 +8,10 @@ CONTEXT DOCS: .moxie/context/ (if present)
 
 ## Context
 
-Audit issues are fixed. Now we need a finalized implementation plan that covers
-everything in the spec, incorporates fixes, and can be executed by agents in the build phase.
+Audit issues are fixed. Now we need a finalized implementation plan for what the spec
+describes but the codebase doesn't yet have. Compare the spec against the current source —
+the plan should cover the DELTA: features, changes, or improvements the spec calls for
+that are not yet implemented. Do not plan work that's already done.
 
 **IMPORTANT: This pipeline requires UNANIMOUS quorum. ALL agents must independently verify
 the plan against the spec and source code. Do NOT rubber-stamp — thoroughness is the goal.**
@@ -64,6 +66,7 @@ Do NOT write the FINAL file unless ALL agents show `reached: true` in the ledger
 ## Rules
 
 - All file paths must be accurate against current source
+- Be efficient with tool use: use offset/limit when reading files — only read the sections you need.
 - Plan must be self-contained — agents must be able to build from it alone
 - Phase ordering must respect dependencies
 - Cite specific file paths and line numbers for every existing code reference

package/templates/05-build/prompt.txt

@@ -71,6 +71,7 @@ Do NOT write the FINAL file unless ALL agents show `reached: true` in the ledger
 ## Rules
 
 - Complete phases in order — never skip
+- Be efficient with tool use: use offset/limit when reading files — only read the sections you need.
 - Each phase must pass the full test suite before marking "built"
 - Verifiers must READ the code — no rubber-stamping based on test output alone
 - Zero regressions on existing tests