SEA-Debt Ontology Reference

The sea-debt ontology defines the semantic vocabulary for debt and incident management in SEA-Forge™.

Overview

Namespace URI
sea-debt: http://sea-forge.com/schema/debt#
sea-inc: http://sea-forge.com/schema/incident#
sea: http://sea-forge.com/schema/core#

File: ontologies/sea-debt.ttl

Triples: 155

Classes

Debt Classes

Class Description
sea-debt:SemanticDebtItem A record of semantic failure or governance violation
sea-debt:Evidence Proof or context explaining why debt occurred
sea-debt:Decision Architectural decision or waiver allowing debt
sea-debt:MitigationPlan Planned steps to resolve debt

Incident Classes

Class Description
sea-inc:SemanticIncident Groups related debt items under common root cause
sea-inc:RootCause Underlying cause category for incident
sea-inc:BlastRadius Impact assessment across concepts/policies

Core Classes

Class Description
sea:Concept Semantic concept in domain model
sea:Policy Governance policy in registry
sea:BoundedContext Bounded context in architecture

Properties

Debt Item Properties

Property Domain Range Description
sea-debt:debtId SemanticDebtItem xsd:string Unique identifier
sea-debt:failureClass SemanticDebtItem xsd:string Classification (e.g., Incomplete_Model)
sea-debt:severity SemanticDebtItem xsd:string Low/Medium/High/Critical/Blocking
sea-debt:status SemanticDebtItem xsd:string open/triaged/accepted/resolved
sea-debt:boundedContext SemanticDebtItem xsd:string Where debt was detected
sea-debt:detectorSignal SemanticDebtItem xsd:string system:checkFamily:checkId
sea-debt:dedupeKey SemanticDebtItem xsd:string SHA-256 dedupe key
sea-debt:expiresAt SemanticDebtItem xsd:dateTime Expiration date

Relationship Properties

Property Domain Range Description
sea-debt:hasEvidence SemanticDebtItem Evidence Links to supporting evidence
sea-debt:hasDecision SemanticDebtItem Decision Links to allowing decision
sea-debt:hasMitigation SemanticDebtItem MitigationPlan Links to mitigation plan
sea-debt:regardingConcept SemanticDebtItem sea:Concept Affected concept
sea-debt:regardingPolicy SemanticDebtItem sea:Policy Violated policy
sea-debt:supersededBy SemanticDebtItem SemanticDebtItem Superseding debt item

Incident Properties

Property Domain Range Description
sea-inc:hasDebtItem SemanticIncident SemanticDebtItem Constituent debt items
sea-inc:rootCause SemanticIncident RootCause Root cause analysis
sea-inc:blastRadius SemanticIncident BlastRadius Impact assessment
sea-inc:incidentId SemanticIncident xsd:string Unique incident ID
sea-inc:title SemanticIncident xsd:string Human-readable title
sea-inc:severity SemanticIncident xsd:string Low/Medium/High/Critical
sea-inc:status SemanticIncident xsd:string detected/investigating/resolved

Example Usage

Turtle

1
2
3
4
5
6
7
8

@prefix sea-debt: <http://sea-forge.com/schema/debt#> .

<http://sea-forge.com/debt/debt-001> a sea-debt:SemanticDebtItem ;
    sea-debt:debtId "debt-001" ;
    sea-debt:failureClass "Incomplete_Model" ;
    sea-debt:severity "Medium" ;
    sea-debt:status "open" ;
    sea-debt:boundedContext "orders" .

SPARQL Query

1
2
3
4
5
6
7
8

PREFIX sea-debt: <http://sea-forge.com/schema/debt#>

SELECT ?debt ?status ?severity
WHERE {
  ?debt a sea-debt:SemanticDebtItem ;
        sea-debt:status ?status ;
        sea-debt:severity ?severity .
}