claude_runner 1.0.0

CLI for executing Claude Code via builder pattern; YAML schema constants for command registration
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

# Test: `help`

Integration test planning for help output. See [commands.md](../../commands.md#command--2-help) for specification.

## Test Case Index

| ID | Test Name | Category |
|----|-----------|----------|
| TC-01 | `clr --help` → help output, exit 0 | Happy Path |
| TC-02 | `clr -h` → same as `--help` | Alias |
| TC-03 | Help output lists `--system-prompt`, `--append-system-prompt`, and `--no-ultrathink` | Completeness |
| TC-04 | `--help` anywhere in argv → help wins | Override |
| TC-05 | `--help` wins even when unknown flags are present | Override |

## Test Coverage Summary

- Happy Path: 1 test
- Alias: 1 test
- Completeness: 1 test
- Override: 2 tests

**Total:** 5 tests

---

### TC-01: `clr --help` → help output, exit 0

**Goal:** `--help` prints usage and exits 0.
**Setup:** None.
**Command:** `clr --help`
**Expected Output:** Contains "USAGE:", "OPTIONS:", known flags.
**Verification:** Exit 0; stdout contains "USAGE:".
**Pass Criteria:** Exit 0; help listing present.
**Source:** [commands.md — help](../../commands.md#command--2-help)

---

### TC-02: `clr -h` → same as `--help`

**Goal:** Short alias `-h` produces identical output to `--help`.
**Setup:** None.
**Command:** `clr -h`
**Expected Output:** Same as `clr --help`.
**Verification:** Exit 0; stdout contains "USAGE:".
**Pass Criteria:** Exit 0; help listing present.
**Source:** [commands.md — help](../../commands.md#command--2-help)

---

### TC-03: Help lists `--system-prompt`, `--append-system-prompt`, and `--no-ultrathink`

**Goal:** All system-prompt and ultrathink control flags are documented in help output so users can discover them.
**Setup:** None.
**Command:** `clr --help`
**Expected Output:** Contains `--system-prompt`, `--append-system-prompt`, and `--no-ultrathink`.
**Verification:** `output.contains("--system-prompt")` and `output.contains("--append-system-prompt")` and `output.contains("--no-ultrathink")`.
**Pass Criteria:** Exit 0; all three flags present in help.
**Source:** [params.md — --system-prompt](../../params.md#parameter--15---system-prompt), [params.md — --append-system-prompt](../../params.md#parameter--16---append-system-prompt), [params.md — --no-ultrathink](../../params.md#parameter--14---no-ultrathink)

---

### TC-04: `--help` anywhere in argv → help wins

**Goal:** `--help` overrides any other flags regardless of position.
**Setup:** None.
**Command:** `clr --model sonnet --help "Fix bug"`
**Expected Output:** Help output shown; not an execution.
**Verification:** Exit 0; stdout contains "USAGE:".
**Pass Criteria:** Exit 0; help listing wins over message and other flags.
**Source:** [commands.md — help](../../commands.md#command--2-help)

---

### TC-05: `--help` wins even when unknown flags are present

**Goal:** `--help` shows USAGE and exits 0 regardless of unknown/invalid flags in argv, in any position.
**Setup:** None.
**Commands:**
- `clr --help --not-a-real-flag`
- `clr --not-a-real-flag --help`
**Expected Output:** Help shown; exit 0 for both orderings.
**Verification:** Exit 0; stdout contains "USAGE:"; no error message.
**Pass Criteria:** Exit 0; help wins — unknown flags are ignored when `--help` is present.
**Source:** [params.md — implicit `--help`](../../params.md), fix issue-help-loses-to-unknown