Rename cost-mode flag to cost-optimized

Author: easel

cmd/dun/main.go

@@ -143,7 +143,7 @@ LOOP MODE:
   Quorum Options (multi-agent consensus):
     --quorum      Strategy: any, majority, unanimous, or number (e.g., 2)
     --harnesses   Comma-separated list of harnesses (e.g., codex,claude,gemini,opencode)
-    --cost-mode   Run harnesses sequentially to minimize cost
+    --cost-optimized   Run harnesses sequentially to minimize cost
     --escalate    Pause for human review on conflict
     --prefer      Preferred harness on conflict (e.g., codex)
     --similarity  Similarity threshold for conflict detection (default: 0.8)
@@ -525,7 +525,7 @@ func runLoop(args []string, stdout io.Writer, stderr io.Writer) int {
 	// Quorum flags
 	quorumFlag := fs.String("quorum", "", "quorum strategy: any, majority, unanimous, or number")
 	harnessesFlag := fs.String("harnesses", "", "comma-separated list of harnesses for quorum")
-	costMode := fs.Bool("cost-mode", false, "run harnesses sequentially to minimize cost")
+	costMode := fs.Bool("cost-optimized", false, "run harnesses sequentially to minimize cost")
 	escalate := fs.Bool("escalate", false, "pause for human review on conflict")
 	prefer := fs.String("prefer", "", "preferred harness on conflict")
 	similarity := fs.Float64("similarity", 0.8, "similarity threshold for conflict detection")

cmd/dun/main_test.go

@@ -2103,7 +2103,7 @@ func TestRunLoopQuorumCostMode(t *testing.T) {
 		"--max-iterations", "2",
 		"--harnesses", "mock1,mock2",
 		"--quorum", "any",
-		"--cost-mode",
+		"--cost-optimized",
 	}, &stdout, &stderr)
 	if code != dun.ExitSuccess {
 		t.Fatalf("expected code %d, got %d: stdout=%s stderr=%s", dun.ExitSuccess, code, stdout.String(), stderr.String())

docs/design/contracts/API-001-dun-cli.md

@@ -218,7 +218,7 @@ proceeding (quorum is applied to the iteration prompt, not per-check prompts).
 - `--verbose` : Print prompts sent to harnesses and responses received
 - `--quorum` : Quorum strategy (`any`, `majority`, `unanimous`, or number)
 - `--harnesses` : Comma-separated harness list for quorum (supports `name@persona`)
-- `--cost-mode` : Run harnesses sequentially to minimize cost
+- `--cost-optimized` : Run harnesses sequentially to minimize cost
 - `--escalate` : Pause for human review on conflict
 - `--prefer` : Preferred harness on conflict
 - `--similarity` : Similarity threshold for conflict detection (default `0.8`)
@@ -261,7 +261,7 @@ $ dun loop --verbose
 - `--task` : Task prompt (string)
 - `--quorum` : Quorum strategy (`any`, `majority`, `unanimous`, or number)
 - `--harnesses` : Comma-separated harness list (supports `name@persona`)
-- `--cost-mode` : Run harnesses sequentially to minimize cost
+- `--cost-optimized` : Run harnesses sequentially to minimize cost
 - `--escalate` : Pause for human review on conflict
 - `--prefer` : Preferred harness on conflict
 - `--similarity` : Similarity threshold for conflict detection (default `0.8`)

docs/helix/02-design/solution-designs/SD-011-agent-quorum.md

@@ -637,7 +637,7 @@ as task prompts to the harnesses.
 | P7.1 | Implement sequential execution | `quorum.go` | 3h |
 | P7.2 | Add early exit optimization | `quorum.go` | 2h |
 
-**Deliverable**: `--cost-mode` runs harnesses sequentially with early exit.
+**Deliverable**: `--cost-optimized` runs harnesses sequentially with early exit.
 
 ### Phase 8: Statistics Tracking (2 tasks)
 
@@ -669,7 +669,7 @@ Quorum Flags:
   --quorum <strategy|N>   Quorum strategy: any, majority, unanimous, or number
                           (default: none - single harness mode)
   --harnesses <list>      Comma-separated harness names (supports name@persona)
-  --cost-mode             Run harnesses sequentially, stop on quorum
+  --cost-optimized             Run harnesses sequentially, stop on quorum
   --escalate              Pause for human review on conflict
   --prefer <harness>      Use this harness response on conflict
   --similarity <float>    Semantic similarity threshold (default: 0.95)
@@ -685,7 +685,7 @@ dun loop --harnesses claude,gemini,codex --quorum 2
 dun loop --harnesses claude,gemini --quorum unanimous
 
 # Cost-optimized: stop when 2 agree
-dun loop --harnesses claude,gemini,codex --quorum 2 --cost-mode
+dun loop --harnesses claude,gemini,codex --quorum 2 --cost-optimized
 
 # With escalation on conflict
 dun loop --harnesses claude,gemini --quorum unanimous --escalate
@@ -751,7 +751,7 @@ dun synth --task \"Write the quorum spec\" --harnesses codex@architect,claude@cr
 
 | Risk | Impact | Likelihood | Mitigation |
 |------|--------|------------|------------|
-| 3x cost increase with quorum | Unexpected bills | High | Clear documentation, cost-mode default |
+| 3x cost increase with quorum | Unexpected bills | High | Clear documentation, cost-optimized default |
 | User confusion on conflict resolution | Stuck loops | Medium | Good defaults, clear prompts |
 | Stats storage grows unbounded | Disk usage | Low | Retention policy, compaction |
 

docs/helix/02-design/technical-designs/TD-011-agent-quorum.md

@@ -58,7 +58,7 @@ dun:
 ## Interfaces and Config
 
 - CLI:
-  - `dun loop --quorum`, `--harnesses`, `--cost-mode`, `--escalate`.
+  - `dun loop --quorum`, `--harnesses`, `--cost-optimized`, `--escalate`.
   - `dun quorum [--synthesize] --task "<prompt>" --harnesses ...`
   - `dun synth` = `dun quorum --synthesize`
 - Config: default quorum strategy, similarity threshold, harness personas,
@@ -79,7 +79,7 @@ dun:
 ## Risks and Mitigations
 
 - **Risk**: Conflicts slow down loops. **Mitigation**: allow `--prefer` and
-  `--cost-mode` options.
+  `--cost-optimized` options.
 
 ## Rollout / Compatibility
 

docs/helix/03-test/test-plans/TP-011-agent-quorum.md

@@ -185,9 +185,9 @@ commands.
 
 | Test | Condition | Expected |
 |------|-----------|----------|
-| TC-011-13a | `--cost-mode`, quorum 2, first 2 agree | Third harness not invoked |
-| TC-011-13b | `--cost-mode`, quorum 2, first 2 disagree | Third harness invoked |
-| TC-011-13c | `--cost-mode`, unanimous, first disagrees | Remaining harnesses not invoked |
+| TC-011-13a | `--cost-optimized`, quorum 2, first 2 agree | Third harness not invoked |
+| TC-011-13b | `--cost-optimized`, quorum 2, first 2 disagree | Third harness invoked |
+| TC-011-13c | `--cost-optimized`, unanimous, first disagrees | Remaining harnesses not invoked |
 
 ### TC-011-14: Agreement Tracking
 

docs/helix/04-build/implementation-plans/IP-015-agent-quorum.md

@@ -51,7 +51,7 @@ dun:
 
 1. **Add new command surface**
    - Files: `cmd/dun/main.go`, new `cmd/dun/quorum.go`
-   - Implement `dun quorum` with `--task`, `--quorum`, `--harnesses`, `--cost-mode`,
+   - Implement `dun quorum` with `--task`, `--quorum`, `--harnesses`, `--cost-optimized`,
      `--escalate`, `--prefer`, `--similarity`, `--synthesize`, `--synthesizer`.
    - Implement `dun synth` as shorthand for `dun quorum --synthesize`.