PatentChecker

Adapters quickstart (import layer)

Adapters are the import layer that translates upstream similarity outputs (BLAST/MMseqs/CSV) into contract-grade match sets for the deterministic diff engine.

Platform quickstart Verification Self-hosting Request a snapshot drift run

PatentChecker Adapters are thin translators that turn upstream similarity outputs (BLAST/MMseqs2/CSV) into schema-valid match_set.v0.1 JSON for the patentchecker diff engine.

Core rule: adapters are where search happens. PatentChecker verifies drift between match sets and emits deterministic Evidence Packets.

Where the code lives

You will typically interact with three repos:

~/patentchecker: the trust anchor (contract + verifier + diff engine)
~/patentchecker-adapters: import/transcode layer (BLAST/MMseqs/CSV → match_set.v0.1)
~/patentchecker-platform: control plane + runner protocol (optional; SaaS / headless platform)

Contract coupling (non-negotiable)

Adapters and the diff engine must target the same contract version. If they diverge, runs fail fast with an explicit error.

Print contract metadata:

BashPowerShellPython API (coming)

ogn CLI

patentchecker info
patentchecker-adapters info

Demo (local, one command)

From the adapters repo:

BashPowerShellPython API (coming)

ogn CLI

cd ~/patentchecker-adapters
npm ci
npm run demo:zip -- --out demo_bundle_contract_<contract_version> --force

This produces a self-contained demo folder and a .tgz you can email. It also includes contract_run/, which is shaped to be verifiable by the PatentChecker verifier.

Verify the emitted contract run (offline):

BashPowerShellPython API (coming)

ogn CLI

patentchecker artifacts verify demo_bundle_contract_<contract_version>/out_blast/contract_run

Pilot run (two-run drift)

The pilot runner imports two upstream result files (prior + current), pins corpus coverage, and produces deterministic outputs.

From ~/patentchecker-adapters:

BashPowerShellPython API (coming)

ogn CLI

PATENTCHECKER_REPO=../patentchecker npm run pilot:run -- --config examples/pilot_run_config.sample.v0.1.json

Stable output layout (under the out_dir specified in the config):

run_manifest.json (contract: watchlist-run-manifest.v0.1)
watchlist_state.json (contract: watchlist-state.v0.1)
packets/*.json (Evidence Packets)
suppressed/*.json (cooldown suppressions)
summary.json (machine-readable rollup)
pilot_report.md (human-readable rollup)
contract_run/ (verify-run-ready output)

Supported import formats

blast-tsv (BLAST outfmt 6, 12-column TSV)
mmseqs-tsv (same 12-column TSV)
csv (minimal BLAST-like headers)

Docker (optional)

Print version + pinned contract target:

BashPowerShellPython API (coming)

ogn CLI

docker run --rm ghcr.io/omniscoder/patentchecker-adapters:latest --info

One-command demo (requires a built ~/patentchecker checkout mounted at /contract):

BashPowerShellPython API (coming)

ogn CLI

mkdir -p out
docker run --rm \
  -v "$PWD/out:/out" \
  -v "$HOME/patentchecker:/contract" \
  -e PATENTCHECKER_REPO=/contract \
  -e PATENTCHECKER_ADAPTERS_RUNNER=ghcr.io/omniscoder/patentchecker-adapters:latest \
  ghcr.io/omniscoder/patentchecker-adapters:latest \
  demo:zip --out /out/demo_bundle_contract_<contract_version> --force