AGENTS

Role

Domain source of truth for VEX statements, consensus rollups, and trust policy orchestration across all Vexer services.

Scope

Records for raw document metadata, normalized claims, consensus projections, and export descriptors.
Policy + weighting engine that projects provider trust tiers into consensus status outcomes.
Connector, normalizer, export, and attestation contracts shared by WebService, Worker, and plug-ins.
Deterministic hashing utilities (query signatures, artifact digests, attestation subjects).

Participants

Vexer WebService uses the models to persist ingress/egress payloads and to perform consensus mutations.
Vexer Worker executes reconciliation and verification routines using policy helpers defined here.
Export/Attestation modules depend on record definitions for envelopes and manifest payloads.

Interfaces & contracts

IVexConnector, INormalizer, IExportEngine, ITransparencyLogClient, IArtifactStore, and policy abstractions for consensus resolution.
Value objects for provider metadata, VexClaim, VexConsensusEntry, ExportManifest, QuerySignature.
Deterministic comparer utilities and stable JSON serialization helpers for tests and cache keys.

In/Out of scope

In: domain invariants, policy evaluation helpers, deterministic serialization, shared abstractions. Out: Mongo persistence implementations, HTTP endpoints, background scheduling, concrete connector logic.

Observability & security expectations

Avoid secret handling; provide structured logging extension methods for consensus decisions.
Emit correlation identifiers and query signatures without embedding PII.
Ensure deterministic logging order to keep reproducibility guarantees intact.

Tests

Unit coverage lives in ../StellaOps.Vexer.Core.Tests (to be scaffolded) focusing on consensus, policy gates, and serialization determinism.
Golden fixtures must rely on canonical JSON snapshots produced via stable serializers.

1.9 KiB Raw Blame History