docs: nightly doc-gardening sweep 2026-06-10 - #724
Conversation
Automated sweep via .claude/skills/doc-gardening. Updates per-package CLAUDE.md/AGENTS.md, docs/index.md entries, and ARCHITECTURE.md as needed. Packages updated: chainsource: document BlockEpochConfig reconnect fields (ReconnectBackoff/MaxReconnectBackoff) and the BlockEpochActor auto-reconnect invariant added in PR #715. round: document per-round operator keys delivered in CommitmentTxBuilt (TreeCosignKey, ConnectorOperatorKey, SweepKey, SweepDelay, ForfeitKey) from PRs #698/#699; sweep-vs-exit-delay check now runs in CommitmentTxReceivedState; confirmation tracker watches the validated batch output, not always output 0. oor: document normalizeCheckpointOwnerLeaves invariant from PR #699 -- rebinds checkpoint output owner leaf to session operator key before standard OOR transfer to handle operator key rotation. darepod: document multi-recipient SendOOR support (PR #696), maxOORRecipients=256 cap, RecipientOutpoints (plural) response; cleanupSubmittedOORStartWithTimeout unlock-context fix (PR #707); OperatorTerms no longer carries ForfeitScript/SweepKey/SweepDelay. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
litbot-9000
added
documentation
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request updates the documentation (AGENTS.md and CLAUDE.md) across several packages (chainsource, darepod, oor, and round) to reflect recent architectural changes. These include adding auto-reconnect with exponential backoff to BlockEpochActor, supporting multiple recipients in SendOOR, normalizing checkpoint owner leaves to the session operator key, and delivering sweep/forfeit parameters per round in CommitmentTxBuilt. The review feedback correctly identifies a minor technical inaccuracy in the round documentation, pointing out that SweepDelay is an absolute timelock parameter rather than an operator key, and suggests updating the terminology accordingly.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| `ConnectorLeafInfo`, `IntentPackage` (atomic delivery of all intent | ||
| types). | ||
| `ConnectorLeafInfo`, `IntentPackage` (atomic delivery of all intent types). | ||
| `CommitmentTxBuilt` carries five per-round operator keys in addition to the |
There was a problem hiding this comment.
The description states that CommitmentTxBuilt carries "five per-round operator keys", but SweepDelay is a uint32 representing an absolute timelock, not a key. Consider changing "five per-round operator keys" to "five per-round parameters" to be technically accurate.
| `CommitmentTxBuilt` carries five per-round operator keys in addition to the | |
| `CommitmentTxBuilt` carries five per-round parameters in addition to the |
| `ConnectorLeafInfo`, `IntentPackage` (atomic delivery of all intent | ||
| types). | ||
| `ConnectorLeafInfo`, `IntentPackage` (atomic delivery of all intent types). | ||
| `CommitmentTxBuilt` carries five per-round operator keys in addition to the |
There was a problem hiding this comment.
The description states that CommitmentTxBuilt carries "five per-round operator keys", but SweepDelay is a uint32 representing an absolute timelock, not a key. Consider changing "five per-round operator keys" to "five per-round parameters" to be technically accurate.
| `CommitmentTxBuilt` carries five per-round operator keys in addition to the | |
| `CommitmentTxBuilt` carries five per-round parameters in addition to the |
|
Superseded by tonight's doc-gardening sweep. |
1 participant
Automated nightly doc-gardening sweep for 2026-06-10.
Summary
BlockEpochConfig.ReconnectBackoff/MaxReconnectBackofffields and auto-reconnect invariant (PR chainsource: reconnect block epoch subscriptions #715).CommitmentTxBuilt(TreeCosignKey,ConnectorOperatorKey,SweepKey,SweepDelay,ForfeitKey); sweep-vs-exit-delay check moved toCommitmentTxReceivedState; confirmation tracker now watches the validated batch output (PRs round: Round-scoped VTXO-tree + connector signing keys #698, oor: Bind OOR checkpoint outputs to the session operator key #699, round: Bind VTXO trees to the commitment tx before signing #712).normalizeCheckpointOwnerLeavesinvariant — rebinds checkpoint output owner leaf to session operator key before transfer to handle operator key rotation (PR oor: Bind OOR checkpoint outputs to the session operator key #699).SendOORsupport (maxOORRecipients=256, pluralRecipientOutpoints);cleanupSubmittedOORStartWithTimeoutunlock-context fix;OperatorTermsno longer carriesForfeitScript/SweepKey/SweepDelay(PRs darepod: support multi-recipient SendOOR #696, darepod: unlock wallet VTXOs on OOR cleanup timeout #707, round: Round-scoped VTXO-tree + connector signing keys #698).Review notes
Please review the diffs in
chainsource/CLAUDE.md,round/CLAUDE.md,oor/CLAUDE.md, anddarepod/CLAUDE.md(plus theirAGENTS.mdmirrors).make doc-checkpasses on this branch.🤖 Generated with Claude Code