Restic Repository
@sntxrr/restic-repositoryv2026.08.07.2
01README
Validate one restic repository from a neutral host — snapshot freshness and backup-scope drift, structural check, read-data verification against bitrot, a dump canary, and a size-capped restore drill that proves the backup can actually be restored. Strictly read-only: it refuses every restic write command and never takes a repository lock, so it can never break the backup it validates.
02Models
@sntxrr/restic/repositoryv2026.08.07.2restic_repository.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| repository | string | restic repository URL, e.g. s3:s3.us-west-002.backblazeb2.com/<bucket> |
| password | string | Repository password — supply via vault.get(), never inline. |
| accessKeyId | string | B2 application key ID. Needs only listBuckets, readBuckets, listFiles |
| secretAccessKey | string | B2 application key — supply via vault.get(), never inline. |
| resticBinary? | string | Path to the restic binary. Defaults to `restic` on PATH. Use an |
| cacheDir? | string | RESTIC_CACHE_DIR. Set it explicitly — clearEnv means there is nothing |
| expectedPaths? | array | Paths this repository is expected to contain. Compared against the |
| dormant? | boolean | Declare this repository deliberately inactive (host powered off or |
| maxStaleDays? | number | Age in days beyond which the latest snapshot is stale. Default 2. |
| maxRestoreBytes? | number | Byte ceiling for a restore drill, checked BEFORE any data moves. |
| timeoutMinutes? | number | Per-invocation timeout. Default 30. |
| allowUnlock? | boolean | Permit `unlock` to remove stale locks. Can also be passed per run. |
Resources
repository(infinite)— Freshness and identity of one restic repository — snapshot age,
snapshot(infinite)— One restic snapshot, emitted only in detailed scan mode,
validation(infinite)— The outcome of one validation-ladder rung — whether it passed, and
maintenance(infinite)— A record of the one mutation this suite performs — a stale-lock
03Previous Versions
2026.08.07.1
04Stats
A
100 / 100
Downloads
2
Archive size
31.6 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
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/sntxrr/swamp-restic05Platforms
06Labels