Skip to content

v0.8.2 — Human-first diagnostics + init/scan correctness

Choose a tag to compare

@qwerfunch qwerfunch released this 07 Jul 05:07
· 269 commits to main since this release
d0a5420

[0.8.2] — Human-first diagnostics + init/scan correctness (2026-07-07)

The "speak the user's language" UX pass, plus three init/scan fixes found while reproducing an onboarding bug.

Heads-up: An A/B against 0.8.1 found all three fixes correct but with no measured user-facing gain under a capable AI host — they ship as correctness, not user wins. The real beneficiary is the bare-terminal first-timer.

Added

  • Plain-language findings — the four human surfaces lead with what drifted and what to do; machine detail (id · path) trails. JSON/SARIF/MCP/events byte-unchanged.
  • Speak the user's language — cladding ships one English source and the host agent renders the user's language; no locale detected or stored. clad init/setup/clarify output moved to it too.

Changed

  • Spec-first window stopped shouting — an unbuilt module on a planned/in-progress feature is an info note, not a block; done/archived keep the hard error.
  • Cards speak human — session/prompt cards and block reasons drop internal ids and tool names; impact cards say "N features depend on this."

Fixed

  • First-run no longer bricks the spec — an empty layers: (null, schema-invalid) now renders layers: [], so a small project's first init stays governable.
  • Scanned globs match real files — layer globs gained the source root (src/api/**) and flat projects stop leaking the project directory name.
  • Docs match detector behavior — the feature-cycle doc and detector catalog now record the status-aware untested-AC / missing-implementation severity.

Net: a correctness release, not a capability leap.