WAVE VI · STRUCTURED REASONING LAYER

KOKON · developer capability map · 9 sub-arcs · 52/52 tests passing
Developer capability map — live metrics + endpoint reference for the structured reasoning layer. Endpoints and curl examples are visible for diagnostic use; clients consume corresponding operator surfaces (e.g. Diagnose Intake / Verdict Report / Twin Action approval queues) which never expose raw routes.
loading…

Claim layer · structured assertions

Sub-arc R

Structured triples (subject · predicate · object) extracted from ARIN evidence. Foundation for everything below.

claims total
last hour
By extractor:
Developer · endpoints & curl
· GET /api/control/claims/status
· POST /api/control/claims/extract/<entity_id>

Bitemporal · time-travel queries

Sub-arc S

Every claim carries ValidFrom / ValidTo plus AsOf. Lets a regulator ask "what did we believe on day X?" and get a bit-exact answer.

Developer · endpoints & curl
· GET /api/control/claims/latest/<subject>/<predicate>
· GET /api/control/claims/as-of/<subject>/<predicate>?at=<ISO>&mode=valid|known
Demo: latest fx_reserves_usd_b for country:RU:
curl https://<your-tenant>.kokon.saa-alliance.com/api/control/claims/latest/country:RU/fx_reserves_usd_b

Confidence · source reliability × extractor

Sub-arc T

No black-box scores. Confidence is an auditable product of two transparent factors.

sources tuned
Developer · formula & endpoints
claim.confidence = source_reliability × extractor_confidence
· GET /api/control/reliability

Optimization · min-variance portfolio rebalancer

Sub-arc U

Diagonal-Q QP solver with projected gradient + budget constraint (∑w = 1) + box bounds.

Developer · endpoints & curl
· POST /api/control/optimize/rebalance/<client-id>
Template (replace placeholders with your tenant + client):
curl -X POST https://<your-tenant>.kokon.saa-alliance.com/api/control/optimize/rebalance/<client-id>
Never use http://127.0.0.1:* in shared snippets — that resolves to the reader's own machine, not the KOKON service.

Feedback loop · predictions → outcomes → backtest

Sub-arc V

Forward track record (frozen ex-ante prediction vs realized outcome) plus Brier, drift detector, calibration suggester.

predictions
outcomes
Developer · endpoints
· GET /api/control/feedback/predictions

Identity · alias index (LEI / ISIN / CUSIP / SWIFT / TaxID)

Sub-arc W

Bayesian match_confidence — more authoritative sources lift merge confidence; conflicting authoritative sources block the merge.

entities tracked
with aliases
Developer · endpoints
· GET /api/control/entity-identities

Twin control · gated proposed → approved → executed

Sub-arc X

Cardinal rule: every action gated by operator approval (or strict policy). Same primitive that should back every destructive button across the platform.

proposed
approved
executed
rejected
Developer · endpoints
· GET /api/control/twin/actions

Evidence chain · action → claim → ARIN chunk

Sub-arc Y

Foundry-equivalent provenance. Any TwinControlAction resolves back to source_uri + evidence_hash + snippet through claim_ids.

Developer · endpoints & curl
· GET /api/control/twin/actions/<action_id>/evidence-chain
curl https://<your-tenant>.kokon.saa-alliance.com/api/control/twin/actions/<action_id>/evidence-chain

Data quality · contradictions / stale / duplicates / anomalies

Sub-arc Z

First-class DQ scan — surfaces classes regulators ask about (consistency, freshness, dedup, outliers) on every refresh.

contradict.
stale
duplicates
anomalies
Total open issues:
Developer · endpoints
· GET /api/control/dq/scan