Marks stale drive paths and sweeps them in batches over gossip; coordinate exclusive sweep windows with hyper-p2p-topic-lease. Hyperswarm gossip when topic is set.

Category: Storage (Hyperdrive)

Composes with: hyper-p2p-topic-lease

Protocol: drive-gc-sweep/v1

When to use

Orphaned paths must be collected consistently across mirroring peers.

When not to use

GC is purely local or drive has no shared replication topic.

Quick start

const { HyperP2PDriveGcSweep } = require('hyper-p2p-drive-gc-sweep')
const topic = process.argv[2] // 64-char hex or string
const mod = new HyperP2PDriveGcSweep({ topic })
await mod.ready()   // joins swarm when topic set
// ... application logic ...
await mod.close()

Docs

docs/api.md — constructor, methods, events, errors
docs/architecture.md — wire types, state, composition
../_shared/PRODUCTION.md — production checklist
../_shared/DOC_STANDARDS.md — documentation standards

Test

npm install && npm test