librarian-fetch

You can submit releases to NZBGet via JSON-RPC after validating available disk space against a budget floor. The submission enforces preflight checks to prevent stalling the transcoding cache before appending the job.

Disk-budget enforcement validates free disk space before each NZBGet append to prevent stalling the transcoding cache. It acts as a preflight check ensuring sufficient storage exists before the queue accepts the job.

You can retrieve a read-only queue-status snapshot of the active NZBGet queue for monitoring and traceability. This observation mode provides visibility into current jobs without triggering new submissions.

Duplicate prevention is built into the submission logic, checking the queue before appending releases. This ensures the librarian workflow does not submit the same release to NZBGet twice during a run.

The workflow writes a per-run audit log documenting submissions and outcomes for traceability and debugging. Safe failure handling ensures reliable, auditable queue submissions even when errors occur during the process.

Submissions will fail safely if the disk-budget floor is exceeded or if duplicate releases are detected. The preflight checks prevent appending jobs when storage is insufficient, limiting queue growth to protect the transcoding cache.