Repository layout

Directory index for the monorepo. Tutorials and usage guides live in this docs site — not in per-directory READMEs.

Path	Contents
`crates/`	Rust engine: core, adapters, schema, FFI, CLI — see Rust
`bindings/`	Python (PyO3) and Go (cgo) bindings
`python/ontographia/`	Pure-Python package surface (experimental `llm` / `mcp` extras)
`tests/python/llm/`	CI unit tests for `ontographia[llm]` (fake backends)
`tests/python/mcp/`	CI unit tests for `ontographia[mcp]` (in-process tools, mocked Neo4j)
`examples/`	Sample ontologies, Neo4j seed, demo scripts
`schemas/`	COM and native ontology JSON Schemas
`scripts/`	Neo4j setup, CI tests, LiteLLM helpers, release scripts
`skills/`	Agent Skill templates (Intent extraction)

`crates/` workspace

Crate	Role
`ontographia-core`	COM, Intent, validation, QueryAst, emitters, `Engine`
`ontographia-adapters`	Multi-format ontology parsers → COM
`ontographia-schema`	COM → Neo4j schema DDL + offline catalog diff
`ontographia-ffi`	C ABI for Go and other bindings
`ontographia-cli`	`build` and `schema` subcommands

Path	Purpose
`manufacturing.*`	Same domain in native YAML, TTL, JSON-LD, LinkML, OBO
`neo4j/seed.cypher`	Cypher 25 seed graph
`neo4j/schema.json`, `constraints.cypher`	Expected graph catalog and UNIQUE constraints
`run_neo4j_demo.py`	Intent → Cypher → optional Neo4j execute
`run_llm_e2e.py`	Local-only LLM Intent extraction E2E (uses `ontographia.llm`)
`llm/`	Thin demos / eval harnesses on top of `ontographia[llm]`

File	Describes
`com.schema.json`	Canonical Ontology Model (COM)
`native_ontology.schema.json`	Native YAML ontology (`.native.yaml`)

Intent JSON Schema is generated at runtime via Engine.intent_json_schema() (not a static file).