v4.2.0 — First-time-user UX fixes
Three frictions reported on the v4.1 scaffolding flow are fixed.
✨ New / changed
| Change | Why |
|---|---|
ctx init is now recursive (4 levels deep, --depth N or --no-recursive to opt out) |
v4.1 only scanned the root, so monorepos with frontend/ + api/ saw only the root manifest. Vendored dirs are skipped (node_modules, .venv, vendor, dist, build, target, ...). Each rationale line is prefixed with the relative path. |
ctx eval-init <name> [--target rag|anthropic_skill] |
First-time users hit "Invalid value for SUITE_FILE" because the suite is a hand-written artefact. ctx eval-init scaffolds one with a realistic case so ctx eval ... --dry-run works immediately. |
Friendlier ctx eval error |
Missing suite file → actionable hint pointing at ctx eval-init, not Typer's generic "File does not exist". |
| README rewrite (EN + FR) | New Input / Output columns on the CLI table + 11 numbered worked examples covering create → init → compile → lint → audit → eval-init → eval → upgrade. Every command's --help now includes an Examples: block. |
🧪 Quality
- 1178 passed, 1 skipped (Anthropic key absent)
mypy --strictclean across 178 filesruff check+ruff formatclean- 11 new tests: recursive walk (depth cap, skip list, symlinks),
ctx eval-initfor both targets, friendly eval error
📦 Install / upgrade
pip install --upgrade context-os-ctx==4.2.0
# or, if already installed:
ctx upgrade🔗 PRs
Full changelog: CHANGELOG.md § 4.2.0