Reconciliation
Use a business system export, provider usage export, or auditor-controlled extract as the reference set to detect missing, unexpected, and late answer-audit records.
Independent reconciliation is a detective control, not an inline gate. Export decision ids and occurrence times from a separate system of record, then compare that set with rawctx answer-audit logs.
Each run binds the reference-set root, rawctx-set root, finding counts, period, app/environment, and reference-source commitment into a receipt anchored by the trust log. Raw decision ids are not exposed in the proof.
Use systems that are hard to rewrite in lockstep with answer logs: LOS, ATS, provider usage exports, or auditor-owned extracts.
The request payload carries raw ids, but persisted findings and proofs are commitment-oriented. The source key appears in proof material only as a commitment. Do not put secrets, API keys, raw customer exports, raw PII, or private system URLs in payload metadata.
Reference payload
v1 assumes short-period set reconciliation. Each decision_id should match the selected key_field value.
{
"source_key": "los-daily-export",
"source_type": "business_system_export",
"period_start": "2026-06-12T00:00:00Z",
"period_end": "2026-06-13T00:00:00Z",
"application_key": "loan_review_bot",
"environment": "production",
"key_field": "idempotency_key",
"allowed_lag_seconds": 3600,
"reference_records": [
{
"decision_id": "loan-review:app-123",
"occurred_at": "2026-06-12T09:13:00Z"
}
],
"metadata": {
"export_period": "daily-close"
}
}CLI
rawctx reconcile run reconciliation.json --json
rawctx reconcile findings RUN_ID --json
rawctx reconcile proof RUN_ID --output reconciliation-proof.json
rawctx trust verify reconciliation-proof.json --onlinePython SDK
import rawctx
run = rawctx.create_reconciliation_run(
source_key="los-daily-export",
source_type="business_system_export",
period_start="2026-06-12T00:00:00Z",
period_end="2026-06-13T00:00:00Z",
application_key="loan_review_bot",
environment="production",
key_field="idempotency_key",
reference_records=[
{
"decision_id": "loan-review:app-123",
"occurred_at": "2026-06-12T09:13:00Z",
},
],
)
findings = rawctx.list_reconciliation_findings(run["id"])
proof = rawctx.proof_reconciliation(run["id"])Operating sequence
Align the decision id stored in the business system with one of the rawctx answer-audit keys: idempotency_key, external_trace_id, or external_message_id.
When a decision is made, write the same decision key to the business system, model-call trace, and rawctx answer-audit log.
Export only decision ids and occurrence timestamps from the reference system by day or close period.
Review missing, unexpected, late, duplicate, and unanchored findings, then fix the operational gap.
Honest boundary
The strength of reconciliation is bounded by the independence of the reference source.