/ontology-core - Core Ontology Schema Validator

Version: 3.0.0 | Model: opus

---

Overview

| Aspect | Description | |--------|-------------| | Purpose | Validate and scaffold ODA ontology type definitions | | Output | L1: Pass/fail summary / L2: Per-file results / L3: Detailed fix suggestions | | Reference | .claude/rules/ontology.md for naming conventions and rules |

---

Cross-Skill Integration

| Skill | Relationship | |-------|--------------| | /ontology-objecttype | Calls this skill for validation after generation | | /ontology-why | Provides design rationale for validation errors | | /ontology-linktype | (Planned) LinkType definition assistant |

---

Commands

| Command | Description | |---------|-------------| | validate <file> | Validate single ontology file | | validate-all <dir> | Validate all files in directory | | scaffold <type> <name> | Generate ObjectType/LinkType/ActionType template | | check-links <dir> | Cross-validate LinkType source/target references |

---

Supported Types

| Type | Key Validations | |------|-----------------| | ObjectType | Primary key, properties, backing dataset | | LinkType | Cardinality, foreign key, cascade policy | | ActionType | Parameters, affected types, edit specs | | PropertyDefinition | Data type, constraints, visibility |

---

Validation Rules

ObjectType Rules

| Rule ID | Name | Severity | |---------|------|----------| | OT-001 | Primary Key Required | ERROR | | OT-002 | Primary Key Property Exists | ERROR | | OT-003 | Unique Property Names | ERROR | | OT-004 | Valid Status | ERROR | | OT-005 | Endorsed Requires Active | WARNING | | OT-006 | Backing Dataset RID Format | ERROR | | OT-007 | Property Data Type Valid | ERROR |

LinkType Rules

| Rule ID | Name | Severity | |---------|------|----------| | LT-001 | Source ObjectType Required | ERROR | | LT-002 | Target ObjectType Required | ERROR | | LT-003 | Cardinality Required | ERROR | | LT-004 | Foreign Key Implementation | ERROR | | LT-005 | Backing Table for N:N | ERROR | | LT-006 | No Endorsed Status | WARNING | | LT-007 | Cascade Policy Consistency | WARNING |

ActionType Rules

| Rule ID | Name | Severity | |---------|------|----------| | AT-001 | Unique Parameter Names | ERROR | | AT-002 | Required Parameters First | WARNING | | AT-003 | Affected ObjectType Exists | ERROR | | AT-004 | Hazardous Flag | WARNING | | AT-005 | Edit Spec Property Valid | ERROR | | AT-006 | Implementation Required | ERROR | | AT-007 | No Endorsed Status | WARNING |

PropertyDefinition Rules

| Rule ID | Name | Severity | |---------|------|----------| | PD-001 | Valid Data Type | ERROR | | PD-002 | Array Item Type | ERROR | | PD-003 | Struct Reference | ERROR | | PD-004 | Required Without Default | WARNING | | PD-005 | Primary Key Constraints | ERROR |

---

Output Format

L1 - Summary (Default)

Validation Complete: 3 files, 21 rules passed, 1 warning, 0 errors

L2 - Per-File Results

Validating: src/ontology/

src/ontology/employee.py
  ObjectType: Employee (7 passed, 1 warning)
    OT-005: Endorsed Requires Active

src/ontology/links.py
  LinkType: ProjectToEmployee (5 passed, 2 errors)
    LT-001: Source ObjectType 'Project' not found

Summary: 26 passed, 1 warning, 2 errors

L3 - Detailed with Fix Suggestions

LT-001: Source ObjectType Required
   File: src/ontology/links.py:45
   LinkType: ProjectToEmployee
   Issue: source_object_type references 'Project' which doesn't exist

   Fix: Create Project ObjectType first, or change source to existing type

   Available ObjectTypes:
   - Employee (src/ontology/employee.py)
   - Department (src/ontology/department.py)

---

Scaffold Templates

ObjectType Template

from ontology_definition.types import (
    ObjectType, PropertyDefinition, DataTypeSpec,
    PrimaryKeyDefinition, PropertyConstraints,
)
from ontology_definition.core.enums import DataType, ObjectStatus

{entity_name_lower}_type = ObjectType(
    api_name="{EntityName}",
    display_name="{Entity Name}",
    description="TODO: Add description",
    primary_key=PrimaryKeyDefinition(property_api_name="{entityName}Id"),
    properties=[
        PropertyDefinition(
            api_name="{entityName}Id",
            display_name="{Entity Name} ID",
            data_type=DataTypeSpec(type=DataType.STRING),
            constraints=PropertyConstraints(required=True, unique=True),
        ),
        # TODO(human): Add more properties
    ],
    status=ObjectStatus.ACTIVE,
)

LinkType Template

from ontology_definition.types import (
    LinkType, ObjectTypeReference, CardinalityConfig,
    LinkImplementation, ForeignKeyConfig,
)
from ontology_definition.core.enums import Cardinality, LinkImplementationType

{source_lower}_to_{target_lower} = LinkType(
    api_name="{Source}To{Target}",
    display_name="{Source} to {Target}",
    source_object_type=ObjectTypeReference(api_name="{Source}"),
    target_object_type=ObjectTypeReference(api_name="{Target}"),
    cardinality=CardinalityConfig(type=Cardinality.MANY_TO_ONE),
    implementation=LinkImplementation(
        type=LinkImplementationType.FOREIGN_KEY,
        foreign_key=ForeignKeyConfig(
            foreign_key_property="{target}Id",
            foreign_key_location=ForeignKeyLocation.SOURCE,
        ),
    ),
)

---

Package Reference

from ontology_definition.types import (
    ObjectType, LinkType, ActionType, PropertyDefinition,
)
from ontology_definition.core.enums import (
    DataType, ObjectStatus, Cardinality, LinkImplementationType,
)

Package Location: /home/palantir/park-kyungchan/palantir/Ontology-Definition/

---

Error Handling

| Error | Recovery | |-------|----------| | File not found | Show available files | | Parse error | Show line number and context | | Unknown type | Suggest valid type names | | Validation timeout | Save partial results |

---

Version History

| Version | Change | |---------|--------| | 1.0.0 | Core ontology schema validator | | 3.0.0 | Frontmatter normalization, MCP tool inclusion, duplicate removal |

End of Skill Definition