Skip to content

docs: troubleshooting, option comparison, new options in README#11

Merged
ShutovKS merged 1 commit into
devfrom
docs/readme-troubleshooting
Jul 14, 2026
Merged

docs: troubleshooting, option comparison, new options in README#11
ShutovKS merged 1 commit into
devfrom
docs/readme-troubleshooting

Conversation

@ShutovKS

Copy link
Copy Markdown
Owner

Обновляет README под все изменения из PR #2#9:

  • Таблица опций и пример конфига дополнены новыми опциями: retry_on_patterns, attempts_window_ms, backoff_ms, backoff_max_ms, recover_original_model, debug.
  • Сравнение unavailable_models vs fallback_models — таблица с разницей по цели, времени срабатывания, триггеру и типичному применению. Раньше их семантика пересекалась и путала.
  • «What Counts As Retryable» обновлено: суженный try again (только с транзиентным квалификатором), детекция через error.cause, retry_on_patterns.
  • Troubleshooting — новый раздел: fallback не срабатывает / слишком агрессивно / залип на fallback / остановился в долгой сессии / известная-сломанная модель.
  • status инструмента — упомянуты failureCounts/switches.
  • Ссылка на CHANGELOG.

Документация — код не затрагивает.

🤖 Generated with Claude Code

- Document all new options (retry_on_patterns, attempts_window_ms,
  backoff_ms, backoff_max_ms, recover_original_model, debug) in the options
  table and config example.
- Add a `unavailable_models` vs `fallback_models` comparison table.
- Update the "What Counts As Retryable" section (narrowed try-again,
  error.cause chain).
- Add a Troubleshooting section covering the common failure modes.
- Update the status tool description to mention failureCounts/switches.
- Link the CHANGELOG.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 14, 2026 08:15

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@ShutovKS ShutovKS merged commit d0dde3b into dev Jul 14, 2026
1 check passed
@ShutovKS ShutovKS deleted the docs/readme-troubleshooting branch July 14, 2026 08:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants