System Model: Tooling Layer

ores.compass is the Python repository compass: the primary quality-of-life tool for both human contributors and LLM agents. It provides temporal orientation in the sprint (where are we, what is in flight), semantic search over the org-roam knowledge graph, agile scaffolding (story, task, capture, memory), and fleet management for parallel Claude environments.

ores.codegen is the Python + Mustache code generator that produces SQL schemas, C++ domain types, and v2 org documents from per-entity model files. It embodies the MASD back-out-from-reference-implementation strategy: entities are commissioned by hand first, the recurring pattern is extracted into a template, and every subsequent entity is generated. See Document MASD and code generation principles for the design rationale.

ores.seeder is the database-level synthetic test-data generator: it emits SQL INSERT populate scripts at codegen time that load hand-curated test rows ("crafted" datasets) into the schema for local development and CI. ores.seeder is distinct from ores.synthetic.service (and its sibling api / core), which generates synthetic data inside the running C++ process at runtime; the seeder operates at build time and ships SQL files, not in-memory data.

The first inhabitant is the slovaris "imaginary world" — fake countries (Aerilon and others) with fake currencies (Ducat, …) — which exercises the refdata schema end-to-end without depending on real ISO data.

A roadmap item, not built yet: a synthesised flavour that reads a codegen entity model + its column generator_expr hints (faker::internet::url() etc., already preserved by the codegen migrations) and emits a Python+Faker script that produces SQL inserts on demand.

ores.lisp is the Emacs Lisp developer tooling layer: dashboard, database browser, shell integration, and the org-roam export pipeline that converts the knowledge graph to the project site. It is the operational surface for contributors who work in Emacs.

ores.sql owns the PostgreSQL lifecycle: schema definitions, migration scripts, role provisioning, and database recreation. It is the authoritative source of the SQL schema and the scripts that set up a development or CI database from scratch. See the * Scripts section in the component overview for the full script inventory.