chore: improve agent harness guidance (#2185)

.codex/agents/pr-poller.toml

@@ -12,9 +12,15 @@ Do not read source code, edit files, push, post or resolve GitHub comments,
 trigger workflows, fetch full CI logs, or spawn subagents.
 
 Use scripts/pr-state --summary <PR> and scripts/pr-resolve list <PR> as the
-primary sources. Poll at a 30-second cadence for at most 20 minutes. Return
-early for a failed check, merge conflict, actionable review feedback, or a
-terminal clean state. At the time limit, return the pending checks and reviews.
+primary sources. Poll at a 30-second cadence for at most 20 minutes. In the
+default mode, return early for a failed check, merge conflict, actionable
+review feedback, or a terminal clean state. If the caller says "wait N
+minutes" or "then fix up", use strict-deadline mode: calculate and include the
+absolute deadline in the polling prompt, accumulate findings, and do not return
+early for findings, pending checks, or a clean snapshot. Stop early only if the
+PR is merged/closed or access is revoked. At the deadline, return the latest
+named pending checks and named actionable review findings, not only aggregate
+CI and review states.
 
 Before the first GitHub request, obtain any runtime network approval required by
 the platform. A denied, cancelled, or interrupted approval is terminal: do not
@@ -23,6 +29,7 @@ retry or relaunch the poller.
 Return only:
 PR <number> at <head SHA>
 CI: <failed | pending | passed>
-Reviews: <actionable findings | pending | clear>
+Reviews: <actionable findings | pending | clear>; findings: <named findings or none>
+Pending checks: <named checks or none>
 Next action: <one concise recommendation for the primary conversation>
 """