# `3.10.0` Use-Case Smoke Trust And Recipe Fidelity

Status: Done

## Goal

Make the documented use-case pack trustworthy enough to act like a real release
gate for the advertised chat-first workflows.

## Public API Changes

No new core API is required in this milestone.

The user-visible change is reliability and alignment:

- `make smoke-use-cases` should pass cleanly on a supported host
- each smoke scenario should verify the same user-facing path the recipe docs
  actually recommend
- smoke assertions should prefer structured CLI, SDK, or MCP results over
  brittle checks against human-mode text formatting when both exist

## Implementation Boundaries

- fix the current repro-plus-fix drift as part of this milestone
- keep the focus on user-facing flow fidelity, not on broad internal test
  harness refactors
- prefer exact recipe fidelity over inventing more synthetic smoke-only steps
- if the docs say one workflow is canonical, the smoke should exercise that same
  workflow directly

## Non-Goals

- no new workspace capability just to make the smoke harness easier to write
- no conversion of the product into a CI/reporting framework
- no requirement that every README transcript becomes a literal byte-for-byte
  golden test

## Acceptance Scenarios

- `make smoke-use-cases` passes end to end on a supported host
- the repro-plus-fix smoke proves the documented patch path without relying on
  fragile human-output assumptions
- each use-case recipe still maps to one real guest-backed smoke target
- a maintainer can trust a red smoke result as a real user-facing regression,
  not just harness drift

## Required Repo Updates

- use-case smoke scenarios audited and corrected to follow the canonical docs
- any brittle human-output assertions replaced with structured checks where
  possible
- docs updated if a recipe or expected output changed during the alignment pass
- at least one release/readiness note should point to the smoke pack as a
  trustworthy verification path once this lands
