Add agent document reviews

[lastobelus]

Outcome

Adds the first agent-review cycle to the existing unreleased markover-review v1 format. One agent can claim a pristine review, return one atomic batch of annotations (and optionally source proposals), and leave a read-only reviewed artifact for the human without introducing a second protocol.

Linked work

Addresses #132

Scope

• Included: agent-reviewing and reviewed lifecycle states; lifecycle-conditional review.agentReviewer attribution; dedicated reviewer-agent guidance; idempotent claim recovery; atomic whole-artifact submission; exact response-uncertain retries; full renderer convergence; PR, deletion, body-limit, and lifecycle race handling; CLI and authenticated local-service routes; developer/agent/user documentation.
• Included: Settings → Agent Review → Agent review permissions, persisted globally with annotation-only as the default and annotations-and-source-proposals as the opt-in.
• Deliberately excluded: mixed human/agent cycles, multiple reviewers, per-node authorship, attachments in agent submissions, direct source-file application, cross-review history, a new protocol family, and a v2/migration.

Validation

• npm run check
• npm test
• Focused automated tests for changed behavior
• Relevant manual macOS validation, when applicable
• Before-and-after screenshots for meaningful visual changes, when applicable
• Documentation updated, when applicable
• Third-party notices regenerated for production dependency changes, when applicable

Validation details

• npm run ci:local: 732 tests passed on head d56869c7 after rebasing onto current main at d00d5e96, plus lint, type checking, notices verification, and packaged smoke.
• Added format/store tests for lifecycle invariants, pristine claims, unique claim IDs, same-clock stale claims, mode enforcement, additive-field preservation, structural-key ordering, exact retries, PR completion, deletion, and full-artifact convergence.
• Added regression coverage for response-uncertain submit recovery after PR-driven archival, preserving the original receipt without mutating the terminal artifact.
• Added service/CLI tests for the complete claim-submit flow, identity recovery, settings snapshots, serialization barriers, exact body boundaries, post-commit uncertainty, file/stdin submission, and receipts.
• Added renderer/settings tests for reviewed-history placement, non-activating completion notices, zero-finding copy, and both global permission modes.

Manual macOS QA

• Completed three end-to-end cycles in the explicit dev instance at head 6b83fc8e; the later conflict-free rebase to 7756bcc0 retained all six PR patches byte-for-byte according to git range-diff: annotation-only with atomic source-edit rejection and a successful two-finding batch; snapshotted source-proposal permission with non-activating completion; and a zero-finding submission with Reviewed history placement.
• Verified claim attribution, read-only reviewing/reviewed states, settings in both global modes, completion notices, feedback rendering, and restoration of the default annotation-only setting.
• Captured nine 1180×760 screenshots covering both settings modes and all three lifecycle cycles; the durable local QA record is tmp/pr-150-agent-review-qa/RESULTS.md in the PR worktree.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5c717f753c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[lastobelus]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9bf361e703

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[lastobelus]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 09323418ef

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[lastobelus]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1e71573249

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[lastobelus]

@codex review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. 👍

Reviewed commit: 6b83fc8e15

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[lastobelus]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7756bcc063

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[lastobelus]

@codex review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. Already looking forward to the next diff.

Reviewed commit: d56869c76b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".