kempersc fa5680f0dd Add initial versions of custodian hub UML diagrams in Mermaid and PlantUML formats

- Introduced custodian_hub_v3.mmd, custodian_hub_v4_final.mmd, and custodian_hub_v5_FINAL.mmd for Mermaid representation.
- Created custodian_hub_FINAL.puml and custodian_hub_v3.puml for PlantUML representation.
- Defined entities such as CustodianReconstruction, Identifier, TimeSpan, Agent, CustodianName, CustodianObservation, ReconstructionActivity, Appellation, ConfidenceMeasure, Custodian, LanguageCode, and SourceDocument.
- Established relationships and associations between entities, including temporal extents, observations, and reconstruction activities.
- Incorporated enumerations for various types, statuses, and classifications relevant to custodians and their activities.

2025-11-22 14:33:51 +01:00

2.5 KiB

Raw Blame History

Verification Report: Agent → ReconstructionAgent Rename

Date: 2025-11-22

Summary

Successfully renamed Agent class to ReconstructionAgent across all schema files.

Files Modified (9 total)

1. Class Definition

✅ /modules/classes/Agent.yaml → /modules/classes/ReconstructionAgent.yaml

Class name: Agent → ReconstructionAgent
ID: https://nde.nl/ontology/hc/class/ReconstructionAgent
Title: ReconstructionAgent Class

2. Slot Definitions (5 files)

✅ /modules/slots/responsible_agent.yaml - Updated import & range ✅ /modules/slots/agent_name.yaml - Updated header ✅ /modules/slots/agent_type.yaml - Updated header ✅ /modules/slots/affiliation.yaml - Updated header ✅ /modules/slots/contact.yaml - Updated header

✅ /modules/classes/ReconstructionActivity.yaml - Updated import & range

4. Main Schema (1 file)

✅ /01_custodian_name_modular.yaml - Updated import

5. Documentation (1 file)

✅ /RENAME_AGENT_TO_RECONSTRUCTION_AGENT.md - Created

Verification Checks

Syntax Validation

✅ Main schema YAML syntax valid ✅ ReconstructionAgent.yaml YAML syntax valid

Reference Completeness

✅ No remaining range: Agent (except AgentTypeEnum which is correct) ✅ No remaining classes/Agent imports ✅ All slot files updated ✅ File successfully renamed

Semantic Integrity

✅ Ontology mappings preserved ✅ Class description clarified ✅ Misleading comments corrected

Breaking Changes

⚠️ IMPORTANT: This is a breaking change for existing data.

Migration Required For:

Instance data (YAML/JSON files) using Agent: class
External documentation referencing Agent class
Example files in /schemas/20251121/examples/

Migration Steps:

# For YAML instance files
sed -i '' 's/^  Agent:/  ReconstructionAgent:/g' *.yaml

# For documentation
sed -i '' 's/\bAgent\b/ReconstructionAgent/g' *.md

Next Actions

Required:

⏳ Regenerate RDF/OWL from LinkML schema
⏳ Update example instance files
⏳ Check for documentation references

Schema Integrity

✅ All changes completed successfully ✅ No syntax errors ✅ No broken references ✅ Ontology mappings intact

Status: COMPLETE ✅
Breaking Change: YES ⚠️
Requires RDF Regeneration: YES

2.5 KiB Raw Blame History