Skip to content

v0.5.0 — Progressive CLI UX: doctor + pilot + grouped help

Choose a tag to compare

View all tags
@JRS1986 JRS1986 released this 18 May 21:01
· 101 commits to main since this release
v0.5.0
4550439
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Minor release. The CLI surface is unchanged from v0.4.2, but the entry point for new users is finally clear: `doctor` and `pilot`. No commands removed or renamed; every hidden compatibility alias still parses.

The three commands a new user needs today

```bash
coding-scaffold doctor --target . # what's set up, what's next
coding-scaffold pilot --target . --tool opencode # print the 10-minute happy path

follow the printed steps

```

What's new

Top-level help grouped by user journey

`coding-scaffold --help` now opens with four labelled sections:

  • START HERE — `doctor`, `pilot`, `setup run --mode beginner`
  • 10-MINUTE PILOT — the exact three commands the printed recipe expands to
  • DAILY WORKFLOW — `session init`, `context lint`, `eval run`
  • ADVANCED / GOVERNANCE — `policy`, `mcp`, `skills`, `memory`, `team`, `permissions`, `tools`, `knowledge distill` — explicitly marked as safe to ignore until the team needs them

The full alphabetical command list still prints below as usual.

`coding-scaffold doctor` as accessibility hub

  • Accepts `--target` and `--json`.
  • Surveys 14 scaffold-artifact paths (AGENTS.md, PR template, `.coding-scaffold/` and sub-directories, eval-config, language signal files).
  • Recommends 1-3 context-aware next commands tailored to what's present. Empty repo → `pilot` + `setup run`. Partial setup → `pr-template init` or `session init`. Fully set up → `eval run`.
  • Explicitly names the advanced surfaces under "Ignore for now (advanced)" so a new user doesn't have to keep them in their head.

`coding-scaffold pilot --target . --tool opencode`

A safe guided wrapper. Runs only read-only local checks (Python version, `git` on PATH, the chosen tool's binary on PATH, credentials in env, local-runtime CLIs) and then prints the exact three-step recipe tailored to your environment.

  • Never installs anything. The printed recipe may include `--install` flags, but the user makes that call.
  • Never writes files.
  • Supports all six tools: `opencode`, `claude-code`, `codex`, `openclaude`, `hermes`, `pi`.
  • `--json` for machine consumption.

Docs

  • README adds a "30-Second Start" block at the top.
  • `docs/wiki/Getting-Started.md` adds a "Smallest Useful Path" section.

Verification

  • `uv run ruff check` clean.
  • `uv run pytest -q` → 327 passed (was 311, +16 new tests).
  • `coding-scaffold eval run --target .` → 9/9 passed on this repo.

Backwards compatibility

Fully backwards compatible with v0.4.2. Power users: every existing command and every hidden compatibility alias still works identically. The grouped help description is additive; argparse still lists every visible command alphabetically below.

Full notes: CHANGELOG.md.

Assets 2
Loading