diffowl 0.5.1 → 0.5.2

package/README.md

@@ -109,7 +109,9 @@ diffowl review --base --format json
 diffowl review --base --fail-on-findings
 ```
 
-Branch review uses the merge base through `HEAD`, matching the committed diff in a pull request. It does not include staged or unstaged changes.
+Commit review compares the selected commit with its first parent. For a merge commit, this means the changes the merge introduced to its first-parent branch. It is not the pull-request diff.
+
+Branch review uses the merge base through `HEAD`, matching the committed diff in a pull request. Use `--base` for pull-request coverage. Neither mode includes staged or unstaged changes.
 
 ## Work with findings
 
@@ -217,6 +219,8 @@ diffowl reasoning --reset
 
 Reasoning names are backend-native identifiers, not a shared DiffOwl scale. A model might advertise `low` and `high`, `thinking`, only one value, or no selectable value. An absent preference means the backend default; DiffOwl never translates one backend's names into another's. Changing a model clears its old reasoning preference so a stale value cannot carry over. Use `diffowl review --reasoning <variant>` for a one-review override.
 
+When an explicit `max` selection is paired with a timeout of 300 seconds or less, DiffOwl warns before starting provider work. It does not lower the reasoning effort or extend the deadline automatically. Increase `timeout` in `.diffowl.yml` when a quality-first review should be allowed to run longer.
+
 When model metadata rejects a variant, DiffOwl uses the backend default and
 prints the model's advertised choices. If the model advertises no selectable
 variants, the warning says so explicitly.