ralphctl 0.11.0 → 0.12.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +51 -23
- package/dist/cli.mjs +4770 -2968
- package/dist/manifest.json +1 -1
- package/dist/prompts/_partials/decisions.md +9 -5
- package/dist/prompts/_partials/validation-checklist.md +1 -1
- package/dist/prompts/detect-scripts/template.md +75 -5
- package/dist/prompts/evaluate/template.md +24 -9
- package/dist/prompts/evaluate-continuation/template.md +17 -3
- package/dist/prompts/ideate/template.md +14 -5
- package/dist/prompts/implement/template.md +36 -13
- package/dist/prompts/implement-continuation/template.md +9 -3
- package/dist/prompts/plan/template.md +18 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -22,10 +22,10 @@ with [GitHub Copilot](https://docs.github.com/en/copilot/github-copilot-in-the-c
|
|
|
22
22
|
> _"I'm helping!"_ — Ralph Wiggum
|
|
23
23
|
|
|
24
24
|
> [!NOTE]
|
|
25
|
-
> **Active development.** New features and polish ship regularly.
|
|
26
|
-
>
|
|
27
|
-
>
|
|
28
|
-
> Upgrades are
|
|
25
|
+
> **Active development.** New features and polish ship regularly. The latest release expands the preset
|
|
26
|
+
> matrix to 20 presets across five families (`standard`, `economic`, `strong-gate`, `fast`, `frontier`),
|
|
27
|
+
> each in `mixed` / `claude-only` / `copilot-only` / `codex-only` variants.
|
|
28
|
+
> Upgrades are best-effort: install the latest version, redo your config, proceed.
|
|
29
29
|
> See [Upgrading](#upgrading) and [CHANGELOG](./CHANGELOG.md).
|
|
30
30
|
|
|
31
31
|
---
|
|
@@ -95,7 +95,7 @@ ralphctl export-context --sprint <id> --project <id> --output <path>
|
|
|
95
95
|
|
|
96
96
|
# Settings
|
|
97
97
|
ralphctl settings show
|
|
98
|
-
ralphctl settings apply-preset claude-only # or mixed / copilot-only / codex-only
|
|
98
|
+
ralphctl settings apply-preset claude-only # or mixed / copilot-only / codex-only / *-economic / *-strong-gate / *-fast / *-frontier
|
|
99
99
|
ralphctl settings set ai.implement.generator.provider claude-code
|
|
100
100
|
ralphctl settings set ai.implement.generator.model <model-id>
|
|
101
101
|
ralphctl settings set ai.implement.generator.effort high
|
|
@@ -163,8 +163,9 @@ scope (cwd + `--add-dir`) is the only safety envelope. Parallel execution is pro
|
|
|
163
163
|
provider each implement role is configured to use, under the same per-provider caveats. If you hit a rough edge on a
|
|
164
164
|
preview provider, please [open an issue](https://github.com/lukas-grigis/ralphctl/issues).
|
|
165
165
|
|
|
166
|
-
One-shot configuration for any provider: `ralphctl settings apply-preset <name>` where `<name>` is
|
|
167
|
-
`
|
|
166
|
+
One-shot configuration for any provider: `ralphctl settings apply-preset <name>` where `<name>` is one of
|
|
167
|
+
20 presets across five families — `standard`, `economic`, `strong-gate`, `fast`, and `frontier`, each in
|
|
168
|
+
`mixed` / `claude-only` / `copilot-only` / `codex-only` variants.
|
|
168
169
|
|
|
169
170
|
---
|
|
170
171
|
|
|
@@ -182,8 +183,8 @@ One-shot configuration for any provider: `ralphctl settings apply-preset <name>`
|
|
|
182
183
|
provider restarts
|
|
183
184
|
- **Separate the what from the how** — AI clarifies requirements first (Refine), then generates the implementation
|
|
184
185
|
plan (Plan), with human approval gates between
|
|
185
|
-
- **Pick up where you left off** — full state persistence; interrupted Implement runs
|
|
186
|
-
|
|
186
|
+
- **Pick up where you left off** — full state persistence; interrupted Implement runs resume in-progress tasks
|
|
187
|
+
first — the crashed attempt is settled as aborted (kept in history) and a fresh attempt opens automatically
|
|
187
188
|
- **Pair or let it run** — work alongside your AI agent interactively, or let it execute unattended
|
|
188
189
|
- **Zero-memorization start** — run `ralphctl` with no args for a guided menu
|
|
189
190
|
|
|
@@ -196,14 +197,41 @@ Configure via the TUI `Settings` view or one-shot CLI commands.
|
|
|
196
197
|
**Quickest path — apply a preset:**
|
|
197
198
|
|
|
198
199
|
```bash
|
|
199
|
-
|
|
200
|
-
ralphctl settings apply-preset
|
|
201
|
-
ralphctl settings apply-preset
|
|
202
|
-
ralphctl settings apply-preset
|
|
200
|
+
# Standard — flagship model per flow
|
|
201
|
+
ralphctl settings apply-preset mixed # best-fit provider per flow
|
|
202
|
+
ralphctl settings apply-preset claude-only # every flow on Claude Code
|
|
203
|
+
ralphctl settings apply-preset copilot-only # every flow on GitHub Copilot
|
|
204
|
+
ralphctl settings apply-preset codex-only # every flow on OpenAI Codex
|
|
205
|
+
|
|
206
|
+
# Economic — implement starts one tier below flagship; escalation ladder climbs only on plateau
|
|
207
|
+
ralphctl settings apply-preset mixed-economic
|
|
208
|
+
ralphctl settings apply-preset claude-economic
|
|
209
|
+
ralphctl settings apply-preset copilot-economic
|
|
210
|
+
ralphctl settings apply-preset codex-economic
|
|
211
|
+
|
|
212
|
+
# Strong-gate — cheap generator, permanently-flagship evaluator gate
|
|
213
|
+
ralphctl settings apply-preset mixed-strong-gate
|
|
214
|
+
ralphctl settings apply-preset claude-strong-gate
|
|
215
|
+
ralphctl settings apply-preset copilot-strong-gate
|
|
216
|
+
ralphctl settings apply-preset codex-strong-gate
|
|
217
|
+
|
|
218
|
+
# Fast — cheapest viable tier at low effort; plateau settles rather than escalating (escalateOnPlateau=false)
|
|
219
|
+
ralphctl settings apply-preset mixed-fast
|
|
220
|
+
ralphctl settings apply-preset claude-fast
|
|
221
|
+
ralphctl settings apply-preset copilot-fast
|
|
222
|
+
ralphctl settings apply-preset codex-fast
|
|
223
|
+
|
|
224
|
+
# Frontier — flagship everywhere at max effort
|
|
225
|
+
ralphctl settings apply-preset mixed-frontier
|
|
226
|
+
ralphctl settings apply-preset claude-frontier
|
|
227
|
+
ralphctl settings apply-preset copilot-frontier
|
|
228
|
+
ralphctl settings apply-preset codex-frontier
|
|
203
229
|
```
|
|
204
230
|
|
|
205
|
-
|
|
206
|
-
|
|
231
|
+
Twenty presets across five families ship, all equally first-class — none is marked default. Applying a
|
|
232
|
+
preset stamps the entire `ai` section plus `harness.escalateOnPlateau` in one transaction (`fast` stamps it
|
|
233
|
+
`false` so a plateau settles; all others stamp it `true`). On a fresh install the welcome view silently
|
|
234
|
+
auto-seeds a preset based on which provider CLIs it detects on `PATH`.
|
|
207
235
|
|
|
208
236
|
**Per-flow settings.** Each flow carries its own `{provider, model, effort?}` row: `refine`, `plan`, `readiness`,
|
|
209
237
|
`ideate`, and `createPr`. The `implement` flow instead splits into a nested `generator` / `evaluator` pair
|
|
@@ -298,14 +326,14 @@ readiness / create sprint) stay TUI-only by design. The CLI exposes inspection +
|
|
|
298
326
|
|
|
299
327
|
### Getting Started
|
|
300
328
|
|
|
301
|
-
| Command | Description
|
|
302
|
-
| --------------------------------------- |
|
|
303
|
-
| `ralphctl` | Interactive TUI (primary surface)
|
|
304
|
-
| `ralphctl doctor` | Check environment health
|
|
305
|
-
| `ralphctl settings show` | Print current settings
|
|
306
|
-
| `ralphctl settings set <key> <value>` | Set a single settings key
|
|
307
|
-
| `ralphctl settings apply-preset <name>` | Stamp the entire `ai` section
|
|
308
|
-
| `ralphctl completion <shell>` | Print shell tab-completion script
|
|
329
|
+
| Command | Description |
|
|
330
|
+
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
331
|
+
| `ralphctl` | Interactive TUI (primary surface) |
|
|
332
|
+
| `ralphctl doctor` | Check environment health |
|
|
333
|
+
| `ralphctl settings show` | Print current settings |
|
|
334
|
+
| `ralphctl settings set <key> <value>` | Set a single settings key |
|
|
335
|
+
| `ralphctl settings apply-preset <name>` | Stamp the entire `ai` section — 20 presets across five families: `standard` / `economic` / `strong-gate` / `fast` / `frontier`, each in `mixed` / `*-only` / `*-economic` / `*-strong-gate` / `*-fast` / `*-frontier` variants |
|
|
336
|
+
| `ralphctl completion <shell>` | Print shell tab-completion script |
|
|
309
337
|
|
|
310
338
|
### Project & Sprint Inspection
|
|
311
339
|
|