regen-classes

Regenerate the class tables and UML diagrams for $ARGUMENTS with bmm-publisher, from the BMM files in the component repo at the current directory, not from the copies bundled in the image (they lag the repos, and a run from a bundled id exits 0 while rendering the older model). The arguments are a schema id without .bmm.json (for example openehr_rm_1.2.0) plus any -d <dependency-schema-id> flags (RM depends on BASE: openehr_rm_1.2.0 -d openehr_base_1.3.0). The layouts and the placement into docs/UML/ are in the openehr-specs:class-generation skill; this wrapper covers generation only.

If $ARGUMENTS is empty, ask for the schema id and stop.

1. Read manifest.json id (or take the directory name specifications-<id>). In the ITS-XML, ITS-BMM, ITS-JSON and ITS-REST repos, say that they hold no model of their own and that bmm-publisher is not run there, and stop. ITS-BMM regenerates its ODIN and YAML with its own make generate.
2. Run docker --version. If Docker is missing, say it is required (the image and its dev container both run on it) and stop.
3. Map each id to its file and Glob that it exists: the schema to computable/BMM/<id>.bmm.json, and a dependency openehr_<component>_<version> to the sibling clone's ../specifications-<COMPONENT>/computable/BMM/<id>.bmm.json (component upper-cased). If one is missing, name it and stop; never fall back to the bundled id.
4. Write to ./out unless the user names another target. Ask before writing into a specifications-XX repo's docs/UML/.
5. Pick the command by layout (step 2 of the class-generation workflow): legacy-adoc -o /app/output/UML/classes when the spec's chapters contain include::{uml_export_dir}/classes/ (the tables land in ./out/UML/classes), otherwise asciidoc. Mount each file read-only under /in/, pass the paths, and map output ownership to the host user (RM with BASE shown):

   docker run --rm --user $(id -u):$(id -g) \
     -v "$PWD/computable/BMM/openehr_rm_1.2.0.bmm.json":/in/openehr_rm_1.2.0.bmm.json:ro \
     -v "$PWD/../specifications-BASE/computable/BMM/openehr_base_1.3.0.bmm.json":/in/openehr_base_1.3.0.bmm.json:ro \
     -v ./out:/app/output \
     ghcr.io/openehr/bmm-publisher asciidoc -v /in/openehr_rm_1.2.0.bmm.json -d /in/openehr_base_1.3.0.bmm.json
   

   Add one mount and one -d /in/<id>.bmm.json per dependency. The -v log lists each file read: check that every one is under /in/.
6. List what was produced (classes/, effective/, diagram SVGs). Do not commit. Generated files are never hand-edited: change the BMM and regenerate. To place the output, follow the class-generation skill.