Ontogenesis

Ontogenesis is an auditable, policy-gated ontology engineering framework for RDF/OWL/JSON-LD assets used across the SocioProphet stack.

It supports ontology creation, linking, validation, and lifecycle governance across layered semantic modules.

Quick start

make venv
make deps
make all

This runs:

• RDF parse validation
• SHACL gates
• JSON-LD roundtrip checks
• dist build
• ledger build + verification
• SPDX SBOM generation

What’s in this repository

• Upper/, Middle/, Lower/ — layered ontology modules
• Domains/ — domain ontologies
• Platform/ — platform-level ontology modules
• prophet/, epi/ — product-specific ontology modules and shapes
• shapes/ — SHACL constraints and promotion gates
• examples/ — example instance graphs and JSON-LD inputs
• catalog/registry.ttl — module index with layer, path, SemVer, and base IRI metadata
• scripts/ — validation, dist, ledger, signing, and SBOM utilities
• docs/ — specifications, onboarding, architecture notes, and diagrams

Documentation index

Start here:

• docs/README.md — documentation hub
• docs/how-to-add-a-module.md — module authoring workflow
• docs/module-map.md — current module layout
• docs/specs/namespaces.md — canonical namespace references

Validation and release discipline

make all runs the full local verification pipeline:

1. make validate
2. make shacl
3. make jsonld
4. make build
5. make ledger
6. make verify
7. make sbom

On release tags (v*), CI performs deterministic dist builds, validation, ledger generation/verification, detached signatures, and SPDX SBOM emission.

Repository policies

• dist/ and audit/ are generated-only.
• Changes under Upper/, Middle/, Lower/, Domains/, Platform/, prophet/, and epi/ should include regenerated derived outputs where policy requires.
• Promotion gates are enforced through SHACL bundles in shapes/.

Metadata

• Base namespace references: docs/specs/namespaces.md
• Module metadata: catalog/registry.ttl
• Project version: VERSION
• Citation metadata: CITATION.cff

Contributing and governance

• Contribution guide: CONTRIBUTING.md
• Security policy: SECURITY.md
• Code of conduct: CODE_OF_CONDUCT.md
• Support: SUPPORT.md

Keywords

ontology, RDF, OWL, SHACL, JSON-LD, semantic web, knowledge graph, provenance, supply-chain integrity, governance

License

MIT. See LICENSE.