CNS Type Hierarchy — Claims Processing
Audience: Architects, implementers. Status: Configuration reference; declarative values loaded into NATS KV (SOVEREIGN_LOOKUPS, SOVEREIGN_SCENARIOS). Status: As of 2026-11-09
1. CNS Type URI Pattern
All claim types follow the pattern:
cns://claim/type/<industry>/<claim_subtype>
Where <industry> is one of: insurance, healthcare, government, commerce, construction, real-estate.
2. Claim Type Registry
2.1 Insurance
| CNS URI | Claim Subtype | Bound Resource | Traits |
|---|
cns://claim/type/insurance/motor_claim | Motor vehicle claim | resource:vehicle | [motor, vehicle, accident, property_damage] |
cns://claim/type/insurance/home_claim | Home/property claim | resource:property | [home, property, fire, theft, damage] |
cns://claim/type/insurance/liability_claim | Liability claim | truth_node:person | [liability, third_party, legal] |
cns://claim/type/insurance/catastrophe_claim | Catastrophe claim | resource:policy | [catastrophe, mass_loss, reinsurer_notice] |
cns://claim/type/insurance/policy | Insurance policy | resource:policy | [policy, coverage, premium] |
2.2 Healthcare
| CNS URI | Claim Subtype | Bound Resource | Traits |
|---|
cns://claim/type/healthcare/medical_claim | Medical claim | resource:patient | [medical, clinical, hipaa, phi_scrubbed] |
cns://claim/type/healthcare/pharmacy_claim | Pharmacy claim | resource:patient | [pharmacy, drug, prescription] |
cns://claim/type/healthcare/prior_auth | Prior authorization | resource:patient | [prior_auth, clinical_review, utilization] |
cns://claim/type/healthcare/service_dispute | Service dispute | claim:medical_claim | [dispute, billing, complaint] |
2.3 Government
| CNS URI | Claim Subtype | Bound Resource | Traits |
|---|
cns://claim/type/government/benefit | Government benefit | truth_node:person | [benefit, eligibility, agency_mesh] |
cns://claim/type/government/compensation | Government compensation | truth_node:person | [compensation, loss, cross_agency] |
cns://claim/type/community/ticket | Community ticket | truth_node:person | [community, ticket, triage] |
cns://claim/type/government/permit_dispute | Permit dispute | resource:parcel | [permit, zoning, land_use] |
cns://claim/type/government/land_dispute | Land dispute | truth_edge (ownership) | [land, title, boundary, survey] |
2.4 Commerce
| CNS URI | Claim Subtype | Bound Resource | Traits |
|---|
cns://claim/type/commerce/order_claim | Order claim | resource:order | [order, delivery, refund, escrow] |
cns://claim/type/commerce/refund_claim | Refund claim | claim:order_claim | [refund, return, inspection] |
cns://claim/type/commerce/warranty_claim | Warranty claim | resource:product | [warranty, defect, product] |
cns://claim/type/commerce/vendor_dispute | Vendor dispute | integration_entity:vendor | [vendor, contract, sla] |
cns://claim/type/commerce/payment_dispute | Payment dispute | claim:payment | [payment, transaction, chargeback] |
2.5 Construction
| CNS URI | Claim Subtype | Bound Resource | Traits |
|---|
cns://claim/type/construction/project_delay | Project delay | resource:project | [delay, schedule, force_majeure] |
cns://claim/type/construction/milestone_payment | Milestone payment | claim:payment | [milestone, payment, certificate] |
cns://claim/type/construction/defect_rectification | Defect rectification | resource:building | [defect, snag, rectification, inspection] |
cns://claim/type/construction/insurance_claim | Construction insurance | resource:policy | [construction, insurance, reinsurer] |
cns://claim/type/construction/handover | Handover claim | resource:building | [handover, occupancy, certificate] |
2.6 Real Estate
| CNS URI | Claim Subtype | Bound Resource | Traits |
|---|
cns://claim/type/real-estate/defect | Defect / snag | resource:unit | [defect, snag, unit, maintenance] |
cns://claim/type/real-estate/service-charge | Service charge dispute | claim:service-charge | [service_charge, hoa, finance] |
cns://claim/type/real-estate/warranty | Construction warranty | resource:unit | [warranty, defect, handover] |
cns://claim/type/real-estate/hoa-assessment | HOA assessment dispute | claim:governance/resolution | [hoa, vote, governance, resolution] |
cns://claim/type/real-estate/amenity-booking | Amenity booking dispute | resource:common-area | [amenity, booking, common_area] |
cns://claim/type/real-estate/lease | Lease / tenancy dispute | claim:lease | [lease, tenancy, rent, eviction] |
cns://claim/type/real-estate/sale | Off-plan sale claim | resource:unit | [sale, title, transfer, off_plan] |
3. Workflow CNS Types
| CNS URI | Workflow Type | Description |
|---|
cns://claim/workflow/guarded_transition | Guarded transition | Claim lifecycle transition with gate/quorum/SOD/evidence/external verdict |
cns://claim/workflow/poce_session | PoCE session | Proof of Correct Execution session for claim transitions |
cns://claim/workflow/escrow | Escrow | Emergency escrow hold/release/rollback for claim settlement |
cns://claim/workflow/arbitration | Arbitration override | N-of-M multi-sig override for blocked FSM nodes |
cns://claim/workflow/cascade | Cascade rule | Cascading invalidation when a claim is revoked |
4. Truth Edge Types — Claims
| Edge Type | From | To | Meaning |
|---|
claims:filed_by | claim | truth_node:person | Claimant filed the claim |
claims:bound_to | claim | resource:* | Claim is bound to a resource (vehicle, property, unit, etc.) |
claims:assessed_by | claim | truth_node:person | Adjuster inspected/assessed the claim |
claims:repaired_by | claim | truth_node:person | Provider performed repair/service |
claims:certified_by | claim | truth_node:person | Inspector certified the work |
claims:settled_by | claim | truth_node:organization | Insurer/payer settled the claim |
claims:reinsured_by | claim | integration_entity | Reinsurer was notified |
claims:disputes | claim | claim | One claim disputes another |
claims:justifies | claim | claim | One claim justifies another (dependency) |
claims:escrow_for | claim_escrow | claim | Escrow holds funds for a claim |
5. CNS Lookup Value Groups
Values are stored in NATS KV (SOVEREIGN_LOOKUPS) per claim type:
| Lookup Key | Example Values |
|---|
lookup.claims.guard.policy.<claim_type> | Quorum bands, SOD rules, evidence requirements |
lookup.claims.sla.<claim_type>.<severity> | SLA windows, escalation targets |
lookup.claims.panel.<claim_type> | Panel roles, capabilities, lease TTLs |
lookup.claims.intake.<map_id> | Intake map field mappings |
lookup.claims.quorum.<claim_type> | Quorum bands by amount/risk |
lookup.claims.evidence.<claim_type> | Required evidence per claim type |
6. Deployment Order
- Deploy strata:
s282_processing_claim, s210_claim_validation_registry, s214_claim_arbitration, s206_claim_dependency_cascade - Seed CNS types via
database/seeds/cns/cns_type_catalog_*.surql - Seed lookup values to NATS KV via
scripts/seed-nats-kv-declarative.mjs - Seed scenario packs to
SOVEREIGN_SCENARIOS via scripts/seed-nats-kv-declarative.mjs - Test:
GET /v1/claims/processing/readiness — all probes must pass before LIVE