enumeration-discovery

name	Enumeration Discovery
description	Instructions for identifying ontology enumeration classes and rendering them in generated application models.

Enumeration Discovery Skill

Use these instructions to automatically identify which owl__Class nodes in the schema/model database, normally stagingdb, should be treated as enumerations in diagrams and generated application code models.

Discovery Logic

An enumeration is defined as an owl__Class that has one or more owl__NamedIndividual members linked via rdf__type.

Cypher Identification Pattern

Run this query to find active enums in the staging database:

MATCH (c:owl__Class)<-[:rdf__type]-(i:owl__NamedIndividual)
WITH c, count(i) as memberCount, collect(i.rdfs__label)[0..5] as sampleMembers
WHERE memberCount > 0
RETURN c.rdfs__label as className, c.uri as uri, memberCount, sampleMembers
ORDER BY memberCount DESC

Application Model Rendering

When an enum class is identified, generated application code models should render it as a native enumeration type when the target language supports one.

For Pydantic output, generate_schema_code(target_type='pydantic') renders it as a Python Enum automatically when owl__NamedIndividual members exist via rdf__type.

Verification Pattern

After regeneration, confirm:

• the generated Pydantic artifact contains from enum import Enum
• Enum classes are present (for example, class Currency(Enum):)
• Member constants are present (for example, US_DOLLAR, MARRIED_FILING_JOINTLY)

UML Visualization

In UML diagrams, ensure these classes use the «enumeration» stereotype.

• Flattening Rule: When a class has a relationship to an enumeration, render it as an Attribute inside the class box rather than an Association arrow, unless the enum itself has complex metadata that needs visualization.

Maintenance

• New Members: When adding new individuals to the database, always ensure they are linked to the correct class via rdf__type.
• Deduplication: Periodically run deduplication queries to ensure that enumeration members are not duplicated across different URIs.
• Schema vs Dataset Boundary: rdf__type links are valid in stagingdb for schema/model enumeration discovery. Do not load ontology-only rdf__type links into dataset databases unless the task explicitly requires schema validation there.
• Regeneration Workflow: After enum changes, regenerate transient local review artifacts under staging/, then copy finalized artifacts into the relevant domain package staging folder before release.