winnex-tracer-core

The shared base for the Winnex tracer family — a pip package.

Generic infrastructure reused by tracer-gov, tracer-med, tracer-jus and tracer-gap (each a separate pip package that depends on this one):

AuditCommitment (the production audit-trail path)

The C++ motor (winnex-madhava >= 1.9.2) returns a compact commitment (total_excluded_count + global_threshold + a deterministic boundary sample) instead of the full O(N) certificate (~2 MB at scale). This layer signs it with Ed25519 for non-repudiation, then stores the ~500-byte record in the WORM.

from winnex_tracer_core.core import make_worm_record, verify_record, public_key_hex
from winnex_tracer_core.persistence import WormStorage

# engine = winnex_madhava engine with search_with_commitment
record = make_worm_record(engine, query, k=10, max_sample=50)  # ~500 B
worm = WormStorage(base_path="/var/lib/tracer/worm")
worm.append(record)

# Auditor: verify non-repudiation
v = verify_record(record, public_key_hex())
assert v["status"] == "VALID"

The signing key comes from WORM_SIGNING_PRIVATE_KEY_HEX (or _FILE) — held outside the C++ binary, so a compromised engine cannot forge past records.

The layer architecture

winnex-madhava        (motor C++20, pip)   — the search engine + bound
winnex-tracer-core    (base, pip)          — WORM, Signer, AuditLog, commitment  ← THIS PACKAGE
  ├─ tracer-gov       (domínio governo)    — depends on winnex-tracer-core
  ├─ tracer-med       (domínio saúde)      — depends on winnex-tracer-core
  ├─ tracer-jus       (domínio legal)      — depends on winnex-tracer-core
  └─ tracer-gap       (domínio financeiro) — depends on winnex-tracer-core
        │
        ▼  (REST API de cada domínio)
Consumo final: Liferay (tracer-gov-liferay, tracer-med-liferay) e qualquer
outra plataforma (Pinecone, Weaviate, aplicações próprias) que chame o REST
dos domínios. O Liferay é UM dos consumidores finais, não a base.

Install

pip install -e .               # core (numpy)
pip install -e ".[signature]"  # + PyNaCl (Ed25519)
pip install -e ".[all]"        # + pg + blockchain

License

Business Source License 1.1 (BSL 1.1) | pay@winnex.ai | Winnex Brasil Soluções Empresariais LTDA (CNPJ 58.364.637/0001-47)