fix(registry): complete large repository source refresh

[harlan-zw]

🔗 Linked issue

Follow-up to #573.

❓ Type of change

• 📖 Documentation
• 🐞 Bug fix
• 👌 Enhancement
• ✨ New feature
• 🧹 Chore
• ⚠️ Breaking change

📚 Description

GitHub truncates large repository trees, leaving existing Skills outside refresh and their reference files unavailable. Durable Skill sync and asset refresh opt into bounded reads of immutable subtrees. The general refresh clock retries affected repositories and prioritizes public references without source commits.

Incomplete trees never become source snapshots. File sizes remain intact. Pages, discovery, and admission keep one bounded tree read.

🤖 AI disclosure: Harlan Agent Kit modified this description. My AI open-source policy.

[harlan-github-agent]

🤖 MERGED

Harlan Agent Kit posted this automated review. It is not Harlan's personal review or approval. AI open source policy. Last updated: 2026-10-08 15:42 UTC.

GitHub merged this pull request.

• Logged (15/100): The sole diagram documenting the new read-bounding architecture is unavailable to review, so the visual contract in the PR description cannot be confirmed against the implementation. View code
  • Ask an agent to verify and fix this finding
• Logged (8/100): Stale rationale on the render-repair sweep exclusion misleads maintainers about why truncated-verdict repos are skipped after this change. View code
  • Ask an agent to verify and fix this finding
• Logged (8/100): The too-large verdict docstring now misdescribes sweep behavior that this very PR changed. View code
  • Ask an agent to verify and fix this finding

13d6abf6-1da3-422f-b79b-6316956ed029

Selected findings run after merge and open separate pull requests.

[harlan-zw]

Agent verification: the exported tree reader reconstructed the live PostHog tree ce264d9f903fc7f37283002e361d286592a8e3e6 into 66,286 entries, including 279 SKILL.md paths, in 45 GitHub reads. The exact candidate query returned 250 production rows in 59.9 ms. Both reads used immutable tree SHAs and changed no production data.

[harlan-github-agent]

Harlan Agent Kit posted this automated review. AI open source policy.

Automated Review: READY.

Read the Review results

[harlan-zw]

Agent verification for the corrected tree reader: replaying the captured immutable PostHog trees reconstructed 66,286 entries. Every one of the 57,739 blob sizes matched GitHub. A separate exported-reader regression confirms repository page reads return the original partial tree in one request. The diagram is now attached as PNG.

[harlan-github-agent]

Harlan Agent Kit posted this automated review. AI open source policy.

Automated Review: READY.

Read the Review results