claude_profile 1.0.0

Claude Code account credential management and token status
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

# Test: `.help`

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

## Test Case Index

| ID | Test Name | Category |
|----|-----------|----------|
| IT-1 | `.help` lists all registered visible commands | Content |
| IT-2 | `.help` excludes hidden commands (only bare `.`) | Visibility |
| IT-3 | `.help` shows usage line with binary name | Content |
| IT-4 | `.help` exits 0 | Exit Code |
| IT-5 | `.help` output includes command purposes | Content |
| IT-6 | `.help` output includes parameter hints per command | Content |
| IT-7 | `.help` IS visible in its own listing | Visibility |
| IT-8 | `.help` output is stable across repeated invocations | Stability |

## Test Coverage Summary

- Content: 4 tests
- Visibility: 2 tests
- Exit Code: 1 test
- Stability: 1 test

**Total:** 8 integration tests

---

### IT-1: `.help` lists all registered visible commands

**Goal:** Confirm the help output includes all 9 registered visible commands by name.
**Setup:** No special state required. Default environment with `clp` binary on PATH.
**Command:** `clp .help`
**Expected Output:** Output contains all 9 registered command names.
**Verification:**
- Capture stdout
- Assert stdout contains the string `.account.list`
- Assert stdout contains the string `.account.status`
- Assert stdout contains the string `.account.save`
- Assert stdout contains the string `.account.switch`
- Assert stdout contains the string `.account.delete`
- Assert stdout contains the string `.token.status`
- Assert stdout contains the string `.paths`
- Assert stdout contains the string `.usage`
- Assert stdout contains the string `.credentials.status`
**Pass Criteria:** Exit 0; all 9 registered command names present in output.
**Source:** [commands.md — .help](../../commands.md#command--2-help)

---

### IT-2: `.help` excludes hidden commands

**Goal:** Confirm that the hidden command `.` does not appear in the listing. Note: `.help` IS visible (unilang auto-registers it as a non-hidden command).
**Setup:** No special state required. Default environment with `clp` binary on PATH.
**Command:** `clp .help`
**Expected Output:** The listing does not contain a bare `.` entry. The 9 registered commands plus `.help` itself (10 total) are all visible.
**Verification:**
- Capture stdout
- Extract lines that start with `.` after trimming whitespace
- Assert no extracted line has `.` as its sole command token (i.e. bare dot is absent)
- Assert bare `.` does not appear as a standalone entry distinct from `.account.*`, `.token.*`, etc.
**Pass Criteria:** Exit 0; bare `.` absent from listing; `.help` visible.
**Source:** [commands.md — .help](../../commands.md#command--2-help)

---

### IT-3: `.help` shows usage line with binary name

**Goal:** Confirm the output contains a usage line that references the binary name `clp`.
**Setup:** No special state required. Default environment with `clp` binary on PATH.
**Command:** `clp .help`
**Expected Output:** Output contains a line matching `Usage: clp <command> [params]`.
**Verification:**
- Capture stdout
- Assert stdout contains the string `Usage: clp`
- Assert the usage line includes `<command>` placeholder syntax
**Pass Criteria:** Exit 0; usage line with `clp` binary name is present.
**Source:** [commands.md — .help](../../commands.md#command--2-help)

---

### IT-4: `.help` exits 0

**Goal:** Confirm the `.help` command exits with success status code 0.
**Setup:** No special state required. Default environment with `clp` binary on PATH.
**Command:** `clp .help`
**Expected Output:** Help text printed to stdout; exit code 0.
**Verification:**
- Run command and capture exit code
- Assert exit code equals 0
**Pass Criteria:** Exit 0.
**Source:** [commands.md — .help](../../commands.md#command--2-help)

---

### IT-5: `.help` output includes command purposes

**Goal:** Confirm that each listed command is accompanied by its purpose description string.
**Setup:** No special state required. Default environment with `clp` binary on PATH.
**Command:** `clp .help`
**Expected Output:** Each command entry in the listing is followed by its purpose text as defined in the spec.
**Verification:**
- Capture stdout
- Assert stdout contains `List all saved accounts` (purpose of `.account.list`)
- Assert stdout contains `Save current credentials` (purpose of `.account.save`)
- Assert stdout contains `Switch active account` (purpose of `.account.switch`)
- Assert stdout contains `Delete a saved account` (purpose of `.account.delete`)
- Assert stdout contains `Show active OAuth token expiry` (purpose of `.token.status`)
- Assert stdout contains `Show all resolved` (purpose of `.paths`)
- Assert stdout contains `7-day token usage` or `token usage` (purpose of `.usage`)
- Assert stdout contains `live credentials` or `credential` (purpose of `.credentials.status`)
**Pass Criteria:** Exit 0; all 9 command purpose descriptions present in output.
**Source:** [commands.md — .help](../../commands.md#command--2-help)

---

### IT-6: `.help` output includes parameter hints per command

**Goal:** Confirm that commands with parameters show parameter hints in the help listing.
**Setup:** No special state required. Default environment with `clp` binary on PATH.
**Command:** `clp .help`
**Expected Output:** Commands that accept parameters show parameter names or placeholders (e.g., `name::`, `v::`, `format::`, `dry::`, `threshold::`).
**Verification:**
- Capture stdout
- Assert the `.account.save` line or its description references its parameters (e.g., `name::`)
- Assert the `.token.status` line or its description references its parameters (e.g., `threshold::`)
- Assert commands with parameters are distinguishable from parameterless commands
**Pass Criteria:** Exit 0; parameter hints visible for commands that accept parameters.
**Source:** [commands.md — .help](../../commands.md#command--2-help)

---

### IT-7: `.help` IS visible in its own listing

**Goal:** Confirm `.help` appears in its own command listing. Unilang auto-registers `.help` as a non-hidden command, so it must appear alongside the 9 user-registered commands (10 total visible).
**Setup:** No special state required. Default environment with `clp` binary on PATH.
**Command:** `clp .help`
**Expected Output:** The listing contains `.help` as a command entry; 10 total visible commands.
**Verification:**
- Capture stdout
- Extract lines that start with `.` after trimming whitespace
- Assert at least one extracted line starts with `.help` as a command name column entry
**Pass Criteria:** Exit 0; `.help` appears in the listing as a visible command.
**Source:** [commands.md — .help](../../commands.md#command--2-help)

---

### IT-8: `.help` output is stable across repeated invocations

**Goal:** Confirm that running `.help` multiple times produces identical output, proving deterministic behavior.
**Setup:** No special state required. Default environment with `clp` binary on PATH.
**Command:** `clp .help` (run 3 times)
**Expected Output:** All 3 invocations produce identical stdout.
**Verification:**
- Run `clp .help` three times, capturing stdout each time
- Assert output from run 1 == output from run 2
- Assert output from run 2 == output from run 3
**Pass Criteria:** Exit 0 on all runs; all 3 outputs are byte-identical.
**Source:** [commands.md — .help](../../commands.md#command--2-help)