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:

  1. Venture market diligence — monitor a portfolio page for change, extract structured organization fields, and capture founder pages.
  2. Technical and scientific research — federate scholarly graphs by DOI with citation-edge provenance, plus local release-note documents.
  3. 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-evidence confirmation.

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.