Hoardarr
@funsaized/hoardarrv2026.11.09.1
01README
Recoverable movie and TV automation with configurable Swamp providers
02Behaviors
@funsaized/hoardarr/coordinatorv2026.11.09.1coordinator.ts
fn compareMigration()
Compare preserved catalog and workflow identities with explicit source-path mappings.
fn acquire(owner: uuid)
Acquire an installation lease; refuse overlapping and unrecovered runs.
| Argument | Type | Description |
|---|---|---|
| owner | uuid |
fn assert(owner: uuid)
Verify root-run ownership before a child operation.
| Argument | Type | Description |
|---|---|---|
| owner | uuid |
fn release(owner: uuid)
Release only the requesting owner's lease after recovery.
| Argument | Type | Description |
|---|---|---|
| owner | uuid |
Resources
lease(infinite)— Exclusive reconciliation ownership
@funsaized/hoardarr/providerv2026.11.09.1provider.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| definition | string |
fn invoke(owner: uuid, operation: string, inputs?: record, tolerateFailure?: boolean)
Invoke one configured capability and retain only outputs produced by this call.
| Argument | Type | Description |
|---|---|---|
| owner | uuid | |
| operation | string | |
| inputs? | record | |
| tolerateFailure? | boolean |
Resources
result(30d)— Fresh evidence for a single provider invocation
@funsaized/hoardarr/pipelinev2026.11.09.1pipeline.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| movies? | string | |
| episodes? | string | |
| files? | string | |
| seedTime? | string | |
| movieEnabled? | boolean | |
| downloadProvider? | string | |
| batchLimit? | number | |
| expectedInterface? | string |
fn health()
Require runtime capabilities before submitting configured downloads.
fn plan(owner: uuid)
Build bounded work from durable catalog records and retry policies.
| Argument | Type | Description |
|---|---|---|
| owner | uuid |
fn ingest()
Ingest successful discovery records while preserving terminal catalog state.
fn select()
Apply media eligibility and configured deterministic ranking to successful searches.
fn recordAdd()
Commit successful per-item additions and leave ambiguous outcomes for reconciliation.
fn reconcile()
Reconcile both catalogs against an explicitly supplied current download snapshot.
fn ready()
Authorize delivery only for successfully detached completed downloads.
fn manifest()
Normalize a freshly generated source manifest for a destination.
fn receipt()
Record verified delivery evidence before allowing local cleanup.
fn cleanup()
Persist successful or retryable source cleanup outcomes.
@funsaized/hoardarr/local-destinationv2026.11.09.1local_destination.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| stagingRoot | string | |
| libraryRoot | string |
fn deliver()
Copy into destination staging, verify, and promote without overwriting conflicting content.
Resources
receipt(infinite)— Verified destination receipt
@funsaized/hoardarr/ssh-destinationv2026.11.09.1ssh_destination.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| sshModel? | string | |
| host | string | |
| stagingRoot | string | |
| movies | string | |
| episodes | string |
fn deliver()
Copy and verify a manifest through the configured SSH behavior; retain source files.
Resources
receipt(infinite)— Verified remote filesystem copy; cloud upload is not implied
@funsaized/hoardarr/gluetun-environmentv2026.11.09.1gluetun_environment.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| gluetunModel? | string |
fn inspect()
Require the configured Gluetun VPN to report running.
Resources
network(1h)— Live VPN readiness (isolation is enforced by the deployment firewall)
@funsaized/hoardarr/fixturev2026.11.09.1fixture_provider.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| stagingRoot | string |
fn movies()
Discover a synthetic demonstration movie.
fn episodes()
Discover one synthetic demonstration episode.
fn inspect()
Report the offline demo environment.
fn health()
Report fixture capabilities.
fn search(queries: array)
Return one deterministic synthetic release for each query.
| Argument | Type | Description |
|---|---|---|
| queries | array |
fn add(inputs: array)
Create harmless text payloads for the synthetic download identities.
| Argument | Type | Description |
|---|---|---|
| inputs | array |
fn sync()
Observe synthetic download state.
fn wait(ids: array, until: string, timeoutSeconds: number)
Advance fixture seed timers without waiting.
| Argument | Type | Description |
|---|---|---|
| ids | array | |
| until | string | |
| timeoutSeconds | number |
fn control(ids: array, action: literal)
Detach synthetic torrent metadata without deleting payloads.
| Argument | Type | Description |
|---|---|---|
| ids | array | |
| action | literal |
Resources
evidence(infinite)— Offline fixture evidence
@funsaized/hoardarr/network-sessionv2026.11.09.1public_network_session.ts
@funsaized/hoardarr/movie-catalogv2026.11.09.1public_movie_catalog.ts
@funsaized/hoardarr/episode-catalogv2026.11.09.1public_episode_catalog.ts
@funsaized/hoardarr/media-filesv2026.11.09.1public_media_files.ts
03Reports
@funsaized/hoardarr/migration-comparisonmethod
migration_comparison.ts
Compare preserved identities, catalog fields and delivery evidence without locators
@funsaized/hoardarr/run-summaryworkflow
portable_run_summary.ts
Catalog progress and phase failures across configurable providers
04Extends
@funsaized/hoardarr/network-sessionpublic_guest_network.ts
@funsaized/torlinktorlink_migration.ts
fn relocateState(owner: uuid, session: uuid)
Validate and relocate preserved queue/history directories without running the engine.
| Argument | Type | Description |
|---|---|---|
| owner | uuid | |
| session | uuid |
Resources
relocation(infinite)— Offline downloader relocation evidence without acquisition locators.
05Previous Versions
2026.11.05.1MIT
06Stats
A
100 / 100
Downloads
6
Archive size
128.7 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Docs keep secrets in a vault1/1earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned
Repository
https://github.com/funsaized/hoardarr07Platforms
08Labels