Skip to main content
Version: 1.3.0

Automatic certificates stay waiting, manual ones render in the zip

Version: 1.3.0 Date: 2026-11-03

Goal: Tower must not fail a proof because the PDF is late, and a Box or web download must still return the certificates.

Solution: Automatic agents read the PDF already stored for that proof. A missing object is published through Hotep and the download answers 409. Manual agents render the missing PDFs during the request. The sweep retries and never marks the job failed.

Features:

  • Agent automatic is agent_codes.automatic on bcyip:agent. A missing attribute is manual
  • After three publishes, retries continue every six hours
  • A PDF included in a zip is posted to Hotep for review. A failed copy does not fail the zip
  • HOTEP_MODE=test reads dev/, HOTEP_MODE=live reads prd/

Files Modified:

  • src/domains/document/zip.service.ts - Automatic and manual zip paths, review copy
  • src/core/certificates/certificate-queue.service.ts - Readiness and slow retry
  • src/core/hotep/hotep.service.ts - Publish call and review-copy post
  • src/core/proof-watcher/proof-watcher.service.ts - Enqueue on confirmation and sweep
  • certificate-zip.md - Download contract

Release fragment: feat-certificate-queue