Gather Pilot Evidence Engine
July 31, 2026 · View on GitHub
The gather pilot command turns Gather's existing adapters into a retained,
verifiable research corpus: one closed manifest drives an offline or
controlled-live capture, every captured item lands in a content-addressed
corpus with a hash-chained witness, and the result is a redacted report and
receipt bundle any third party re-verifies without private source material.
Gather is a retained Zentropy Labs capability. This pilot makes no acquisition, customer, market-fit, source-truth, or external-availability claim.
Customer outcome
Turn difficult mixed sources (web pages, feeds, scholarly graphs, video metadata, JSON APIs, local documents) into one continuously monitored, locally retained, independently verifiable research corpus, with change custody and a privacy boundary between private evidence and shareable receipts.
Three representative mission classes
The showcase (examples/pilot/showcase-offline.json) exercises all three:
- Venture market diligence — monitor a portfolio page for change, extract structured organization fields, and capture founder pages.
- Technical and scientific research — federate scholarly graphs by DOI with citation-edge provenance, plus local release-note documents.
- Media and operational intelligence — ingest newsroom feeds, video metadata with comments, JSON engagement records, and a private operator memo.
Deployment choices
- Workstation — the operator runs the pilot on their own machine against allowlisted local roots and controlled hosts. The showcase runs this way.
- Customer-hosted — the pilot runs inside the customer's network; Gather never sees private payloads, only the redacted receipts the customer chooses to share.
- Zentropy-managed — Zentropy operates the pilot on a customer's behalf under a custody agreement; the same manifest and verification apply.
In every deployment, a shared bundle carries only receipts, hashes, redacted refs, and verdicts. Raw private payloads stay in the local adapters.
Manifest safety boundary
A pilot manifest is a closed schema: unknown fields, wildcard hosts, ports,
userinfo, IP literals, .. paths, and absolute paths are all rejected. Offline
network adapters require a fixture; live adapters require an exact allowed
host. Browser navigation is not safe for hostile arbitrary URLs and is
disabled by default — this is a known limitation, not a feature gap.
Commands
gather pilot run MANIFEST --output DIR # capture once, write report + receipt
gather pilot refresh DIR # re-capture monitored sources, archive the prior view
gather pilot verify DIR # network-free verification of the whole root
gather pilot bundle DIR --output FILE --visibility shared
gather pilot bundle DIR --output FILE --visibility full --include-private-evidence
Exit semantics: manifest refusal exits 2; a required-source failure or
verification failure exits 1; success exits 0.
Artifact inventory and independent verification
A pilot evidence root contains:
manifest.json pilot-receipt.json report.json
report.html monitor-state.json corpus/ history/
gather pilot verify DIR re-derives every binding from local bytes only: the
manifest digest, the semantic report digest, the deterministic HTML, the
receipt's byte bindings, every corpus body and run witness, the monitor
ledger, and the history chain. No network path is opened. A tampered byte
anywhere in the chain flips the verdict to false.
Private and shared evidence boundary
- Private sources retain their mission/source id, adapter, visibility, status, item count, and receipt digests, but never their target, body, or extraction value.
- Shared bundles omit the corpus, monitor state, history, and normalized
manifest entirely. A full bundle (which includes private evidence) requires
explicit
--include-private-evidenceconfirmation.
Retained capability
Gather is retained by Zentropy Labs. The pilot is the first shipped subproject of a larger SaaS roadmap (a FastAPI control plane, React application, billing, and deployment system). Those later subprojects are not shipped here; this document links to the roadmap without claiming they are available.
Limitations and Does Not Prove
The report's limitations and does_not_prove fields carry the honest
boundaries. Summarized: the pilot does not build a multi-tenant hosted SaaS,
does not add billing or accounts, does not crawl unrestricted domains, does not
claim captured statements are true, and does not make browser navigation safe.
It does not prove product-market fit, customer willingness to pay,
comprehensive source coverage, legal sufficiency for regulated retention, the
truth of source claims, the correctness of OCR/transcription/external
metadata, the safety of unrestricted browser automation, or that any specific
organization will partner, invest, advise, or purchase.