v0.2.9 — examples/ + fuzzy hints + architecture docs + --quiet/--verbose

[0.2.9] - 2026-05-19

Added

• examples/ directory — five runnable end-to-end shell scripts that
  encode the README cookbook recipes. examples/render-current-timeline.sh,
  examples/import-by-date.sh, examples/tag-bin-for-review.sh,
  examples/markers-from-csv.sh, examples/wait-and-notify.sh. POSIX
  shell + jq; ~15-30 lines each; copy-and-modify for your own workflow.
• Project-wide fuzzy hints. Following v0.2.8's render-preset fuzzy
  hint, the same pattern now applies to:
  • project open <name> → suggests close-name projects on not-found
  • media tag --color <bad> → suggests close colors
  • timeline marker add --color <bad> → suggests close colors
    Implemented via difflib.get_close_matches (n=3, cutoff=0.4).
    NotFound gained an optional hint= keyword to support this.
• docs/architecture.md + Mermaid diagram in README. Single-page
  walkthrough of the layering: two entry points (dvr + dvr mcp) over
  one engine, the DaVinciResolveScript bridge, the Workflow Integration
  escape hatch (with its inverted "CLI is server, plugin polls" topology),
  the async render store, the structured-error/output IO discipline. The
  README now embeds the architecture diagram between Cookbook and
  Compatibility.
• Global --quiet / -q flag — suppress successful stdout for CI
  scripts that only care about exit codes. Errors still go to stderr.
• Global --verbose flag — equivalent to setting DVR_DEBUG=1; show
  Python tracebacks on internal errors (the regular structured-error path
  is unchanged).

Tests

• 203 (was 197). Six new tests cover project open fuzzy hint, both color
  fuzzy hints (media + timeline), emit() quiet behavior, and is_quiet
  / set_quiet API. The output-test module gained an autouse fixture that
  resets the module-level quiet flag around each test.

No code-breaking changes.