{
  "name": "iSHANG TNOS Ontology",
  "version": "8.4.1",
  "description": "Machine-readable ontology of the Trust Network Operating System (TNOS) — the System of Trust behind the iSHANG Trust Network Hub. The Hub is the execution layer of TNOS: participants join Trust Circle Programs (TCPs), campaigns run, Digital Entitlements (DEs) are issued, Trust Signals accumulate, and Trust Networks compound. Campaigns end. Trust compounds. v8.4.1 (build v4-82): TNOS added as a first-class entity per AI Communication Plan v1.0 §4.4 Priority 3 (all 7 entities: TNOS, TCP, DE, Trust Signal, Trusted Relationship, Trust Network, Relationship Capital).",
  "chain": [
    "Digital Entitlements",
    "Participation",
    "Trust Signals",
    "Trusted Relationships",
    "Trust Networks",
    "Relationship Capital"
  ],
  "entities": {
    "TNOS": {
      "description": "The Trust Network Operating System (TNOS) is a new category of enterprise infrastructure designed to help organizations create, measure, and scale trusted relationships, build Trust Networks, and grow Relationship Capital.",
      "positioning": "System of Record captured data. System of Engagement orchestrated interaction. System of Trust creates, measures, and scales trusted relationships.",
      "executionLayer": "The iSHANG Trust Network Hub",
      "attributes": ["name", "category", "executionLayer"]
    },
    "Organization": {
      "description": "A brand, institution, or community running Trust Circle Programs on TNOS.",
      "attributes": ["id", "name", "slug", "industry", "verified", "website"]
    },
    "TrustCircleProgram": {
      "description": "The persistent asset — the branded container (name, brand, story, target audience) an organization operates. Lives in exactly one Trust Circle Category. DEs are owned by the TCP, not by any campaign.",
      "attributes": ["id", "name", "organizationId", "categoryId", "levels"],
      "persistentLayers": {
        "Identity Layer": ["Identity-DE", "Membership-DE"],
        "Trust Layer": ["Trust Signals", "Recognitions", "Achievements"],
        "Network Layer": ["Trusted Relationships", "Trust Network"],
        "Capital Layer": ["Relationship Capital"]
      }
    },
    "TrustCircleCategory": {
      "description": "An iSHANG-owned market lane. 16 canonical Categories; organizations pick one when applying for a program.",
      "attributes": ["id", "name"]
    },
    "Campaign": {
      "description": "The mechanism — a time-boxed initiative inside a Trust Circle Program: objectives, business rules, DE orchestration, value flow. Campaigns are temporary; the TCP persists. A campaign may attach (reuse) any DE owned by its parent TCP; the DE persists after the campaign ends.",
      "attributes": ["id", "name", "programId", "framework", "status", "primaryLifecycleObjective", "startsAt", "endsAt"]
    },
    "DigitalEntitlement": {
      "description": "The verifiable record of what a participant owns, does, or contributes. Exactly ONE type per DE — Impact attribution is metadata, never a second type. An entitlement, not a token; iSHANG never takes custody of underlying physical assets. Used, not burned: redeemed DEs remain permanently in the holder's collection.",
      "attributes": ["id", "type", "campaignId", "holderId", "issuedAt", "metadata"]
    },
    "TrustSignal": {
      "description": "The measurement — proof generated by participation; feeds Trusted Relationships. Always measured by the platform; never configured by the organizer.",
      "attributes": ["id", "signalType", "subjectId", "campaignId", "recordedAt"]
    },
    "TrustedRelationship": {
      "description": "The outcome — Organization + Participant + Active Digital Entitlement + Trust Signals + Time. Anchored to the Identity-DE timestamp.",
      "attributes": ["organizationId", "participantId", "identityDeId", "establishedAt", "strength"]
    },
    "TrustNetwork": {
      "description": "The strategic asset — the web of Trusted Relationships an organization builds over time.",
      "attributes": ["organizationId", "relationshipCount", "categories"]
    },
    "RelationshipCapital": {
      "description": "The board-level metric — the composite value of a Trust Network.",
      "attributes": ["organizationId", "score", "computedAt"]
    }
  },
  "trustCircleCategories": [
    { "id": "heritage", "name": "Heritage Circle", "theme": "Culture, heritage, legacy" },
    { "id": "collector", "name": "Collector Circle", "theme": "Collectibles, provenance, stewardship" },
    { "id": "impact", "name": "Impact Circle", "theme": "ESG, sustainability, social purpose" },
    { "id": "education", "name": "Education Circle", "theme": "Learning, alumni, professional development" },
    { "id": "wealth", "name": "Wealth Circle", "theme": "Financial services, insurance, wealth" },
    { "id": "wellness", "name": "Wellness Circle", "theme": "Health, longevity, wellbeing" },
    { "id": "sports", "name": "Sports Circle", "theme": "Sports, teams, athletes, fans" },
    { "id": "lifestyle", "name": "Lifestyle Circle", "theme": "Hobbies, interests, casual communities" },
    { "id": "entertainment", "name": "Entertainment Circle", "theme": "Media, film, music, gaming, content" },
    { "id": "executive", "name": "Executive Circle", "theme": "C-suite, boards, leadership" },
    { "id": "technology", "name": "Technology Circle", "theme": "Tech, infrastructure, Web3" },
    { "id": "food-travel", "name": "Food & Travel Circle", "theme": "Dining, travel, hospitality, discovery" },
    { "id": "shopping", "name": "Shopping Circle", "theme": "Retail, consumer brands, e-commerce" },
    { "id": "beauty", "name": "Beauty Circle", "theme": "Beauty, apparel, fashion" },
    { "id": "pet", "name": "Pet Circle", "theme": "Pet owners, breeders, vets, pet brands" },
    { "id": "industrial", "name": "Industrial & Resources Circle", "theme": "Industrial ecosystems, commodities, resources, infrastructure" }
  ],
  "deTypes": [
    { "type": "Identity-DE", "group": "Identity & Membership", "sellable": false },
    { "type": "Membership-DE", "group": "Identity & Membership", "sellable": true },
    { "type": "Recognition-DE", "group": "Identity & Membership", "sellable": true },
    { "type": "Benefit-DE", "group": "Access & Participation", "sellable": true },
    { "type": "Credential-DE", "group": "Access & Participation", "sellable": true },
    { "type": "Experience-DE", "group": "Access & Participation", "sellable": true },
    { "type": "Service-DE", "group": "Access & Participation", "sellable": true },
    { "type": "Product-DE", "group": "Assets & Impact", "sellable": true },
    { "type": "Impact-DE", "group": "Assets & Impact", "sellable": true },
    { "type": "Provenance-DE", "group": "Assets & Impact", "sellable": true },
    { "type": "IP-DE", "group": "Assets & Impact", "sellable": true }
  ],
  "trustSignals": [
    { "signal": "Identity", "sourceDEs": ["Identity-DE"], "shows": "Verified — always present" },
    { "signal": "Verification", "sourceDEs": ["Credential-DE", "Provenance-DE", "IP-DE"], "shows": "Records confirmed" },
    { "signal": "Participation", "sourceDEs": ["Experience-DE", "Service-DE"], "shows": "Engagements" },
    { "signal": "Achievement", "sourceDEs": ["Credential-DE", "Product-DE", "IP-DE"], "shows": "Milestones" },
    { "signal": "Recognition", "sourceDEs": ["Recognition-DE"], "shows": "Honors" },
    { "signal": "Stewardship", "sourceDEs": ["Experience-DE", "Service-DE"], "shows": "Long-term care" },
    { "signal": "Impact", "sourceDEs": ["Impact-DE"], "shows": "Contributions" },
    { "signal": "Loyalty", "sourceDEs": ["Membership-DE", "Benefit-DE"], "shows": "Tenure" }
  ],
  "lifecycleStages": ["Aware", "Join", "Participate", "Contribute", "Recognized", "Trusted", "Advocate", "Steward"],
  "primaryLifecycleObjectives": ["Join", "Participate", "Recognized", "Steward"],
  "rules": {
    "deReuse": "DEs are owned by the Trust Circle Program — not by the Campaign. A Campaign may attach any DE from its parent TCP. The DE persists after the Campaign ends.",
    "singleType": "Each DE has one type. The Impact attribution is metadata — not a second DE type.",
    "trustOutcome": "Trust is an outcome, not an input. Organizers configure campaigns; the platform measures trust (signals, weighting, progression are never organizer-configurable).",
    "usedNotBurned": "Redeemed DEs remain permanently with the holder as a verifiable record."
  },
  "relationships": [
    { "from": "Organization", "to": "TrustCircleProgram", "kind": "operates" },
    { "from": "TrustCircleProgram", "to": "TrustCircleCategory", "kind": "belongsTo" },
    { "from": "TrustCircleProgram", "to": "Campaign", "kind": "contains" },
    { "from": "TrustCircleProgram", "to": "DigitalEntitlement", "kind": "owns" },
    { "from": "Campaign", "to": "DigitalEntitlement", "kind": "attaches (reuse) or issues" },
    { "from": "DigitalEntitlement", "to": "TrustSignal", "kind": "generates (through Participation)" },
    { "from": "TrustSignal", "to": "TrustedRelationship", "kind": "accumulatesInto" },
    { "from": "TrustedRelationship", "to": "TrustNetwork", "kind": "forms" },
    { "from": "TrustNetwork", "to": "RelationshipCapital", "kind": "measuredAs" }
  ],
  "agentSurfaces": {
    "llms": "https://hub.ishang.com/llms.txt",
    "agentDocs": "https://hub.ishang.com/#/docs/agents",
    "agentOnboarding": "https://hub.ishang.com/#/agents/onboarding",
    "openapi": "https://hub.ishang.com/openapi.json",
    "ontology": "https://hub.ishang.com/ontology.json",
    "verify": "https://hub.ishang.com/#/verify"
  },
  "contact": "noreply@ishang.com"
}