docs(policy): document safe range for dev_stall_nudges_cap

[gmoncor]

What: Add one comment sentence to dev_stall_nudges_cap stating its safe range relative to session_timeout_min.

Why: The cap exists specifically to prevent bug #149 (a turn burned per cycle until session_timeout_min) from recurring, but nothing documents what value keeps that guarantee if dev_stall_nudges_cap or session_timeout_min change independently in the future. Related to #149 (closed), the original bug this cap guards against.

How:

• Add a comment above dev_stall_nudges_cap noting it should stay comfortably below session_timeout_min / (dev_stall_grace_s/60) so the cap fires before the timeout ceiling would anyway.

Testing: Comment-only change; no behavior affected. Ran uv run pytest -q tests/test_policy.py (352 passed, 2 skipped) to confirm no regression.

Changelog: n/a (no user-visible change).

🤖 Generated with Claude Code

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}