[codex] Document Generate wait semantics

[WalksWithASwagger]

Summary

• Document the current synchronous Generate execution path through /api/regen and Python run_batch.
• Clarify that Stop Waiting aborts only the browser wait/request and does not imply provider cancellation.
• Capture the future Python-owned local job ledger direction while deferring cancellation, polling, resumable runs, and provider-state persistence.

Closes #297

Verification

• npm run docs:check
• npm run public:check
• git diff --check
• git diff --cached --check
• npm run e2e:portal not run; docs-only change with no visible UI copy changes.

[github-actions]

Agentic PR Review

Verdict: needs-human

Checks:

• Linked issue via Closes #... or Refs #...: yes
• Issue acceptance criteria found: 11
• PR verification section present: yes
• PR acceptance self-check present: no
• Diff within v1 limits: yes

This PR is not blocked from human review, but the agentic gate is not satisfied.

[github-actions]

Agentic PR Review

Verdict: needs-human

Checks:

• Linked issue via Closes #... or Refs #...: yes
• Issue acceptance criteria found: 11
• PR verification section present: yes
• PR acceptance self-check present: no
• Diff within v1 limits: yes

This PR is not blocked from human review, but the agentic gate is not satisfied.

[github-actions]

Agentic PR Review

Verdict: needs-human

Checks:

• Linked issue via Closes #... or Refs #...: yes
• Issue acceptance criteria found: 11
• PR verification section present: yes
• PR acceptance self-check present: no
• Diff within v1 limits: no

This PR is not blocked from human review, but the agentic gate is not satisfied.

[github-actions]

Agentic PR Review

Verdict: needs-human

Checks:

• Linked issue via Closes #... or Refs #...: yes
• Issue acceptance criteria found: 11
• PR verification section present: yes
• PR acceptance self-check present: no
• Diff within v1 limits: no

This PR is not blocked from human review, but the agentic gate is not satisfied.

[github-actions]

Agentic PR Review

Verdict: needs-human

Checks:

• Linked issue via Closes #... or Refs #...: yes
• Issue acceptance criteria found: 11
• PR verification section present: yes
• PR acceptance self-check present: no
• Diff within v1 limits: no

This PR is not blocked from human review, but the agentic gate is not satisfied.

[github-actions]

Agentic PR Review

Verdict: needs-human

Checks:

• Linked issue via Closes #... or Refs #...: yes
• Issue acceptance criteria found: 11
• PR verification section present: yes
• PR acceptance self-check present: no
• Diff within v1 limits: no

This PR is not blocked from human review, but the agentic gate is not satisfied.

[github-actions]

Agentic PR Review

Verdict: needs-human

Checks:

• Linked issue via Closes #... or Refs #...: yes
• Issue acceptance criteria found: 11
• PR verification section present: yes
• PR acceptance self-check present: no
• Diff within v1 limits: no

This PR is not blocked from human review, but the agentic gate is not satisfied.