docs: nightly doc-gardening sweep 2026-07-10

[litbot-9000]

Automated nightly doc-gardening sweep via .claude/skills/doc-gardening.

Workflow: https://github.com/lightninglabs/darepo-client/actions/workflows/doc-gardening-nightly.yml

This run's grep-based baseline (last merge titled ^docs: nightly doc-gardening sweep) pointed at 2026-06-08 (PR #704), but the intervening month of nightly
attempts were closed unmerged in favor of #908/#909, a manual full-repo doc
re-audit merged earlier today (2026-07-10) that already brought the whole
graph current and green. Redoing that month-long diff would have duplicated
#908's work, so this sweep instead targeted the small residual gap: three
commits on top of #909 (314cc51b, 07b39cb6, afc7b33a) that landed after
that PR's own doc-reconciliation commit.

Updates:

• db, vtxo: document the new vtxo.ErrVTXONotFound sentinel
  VTXOStore.GetVTXO returns on a miss, and how the VTXO manager's
  force-unroll path matches it (also fixed a stale db/CLAUDE.md method
  list — InsertClientVTXO/FetchByOutpoint don't exist; the real methods
  are SaveVTXO/GetVTXO).
• vhtlcrecovery/coordinator: document that UnrollRegistry.GetStatus may
  legitimately return a nil status with no error, and that callers must not
  dereference it directly.
• darepod: document the fraud-trigger gap in orphan-recovery re-admission
  (tracked as darepo-client#914) that the code comment in server.go
  already calls out.

make doc-check passes. ARCHITECTURE.md and docs/index.md needed no
changes (no new packages, no new docs/*.md files in this residual diff).

Note: this run's sandboxed tool surface could not resolve this specific
workflow run's permalink (GITHUB_RUN_ID was not readable), so the link
above points at the workflow's run list rather than this exact run.

Please review the updated CLAUDE.md/AGENTS.md diffs for accuracy.

[gemini-code-assist]

Code Review

This pull request updates the documentation in several AGENTS.md and CLAUDE.md files to align with recent codebase changes. Specifically, it documents the behavior of recoverOrphanedUnrollJobs regarding exit triggers, the introduction of the domain-level sentinel ErrVTXONotFound in VTXOPersistenceStore.GetVTXO, the handling of nil status returns in UnrollRegistry.GetStatus, and updates to spawnForceUnrollActor's error handling. I have no feedback to provide as there are no review comments.

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.

[litbot-9000]

Superseded by tonight's doc-gardening sweep.