v1.28.1

A guide whose DHIS2 codes carry a < now generates under hostile_names = "substitute", and d2w fhir init can set the root organisation unit, so a registry package and the guide depending on it state the same selection.

A < in a code

A DHIS2 code becomes an identifier value, which the IG publisher writes into a table cell unescaped and then strict-parses, so a < in one aborts the build's last pass. Until now substitute rewrote a < in a name and a space in a code, but refused a code carrying <.

Under substitute such a code is now rewritten the way a name is: the comparison is reworded and then every space is hyphenated, as for any code carrying a space. ENTO - IRS < 6 Months publishes as ENTO---IRS-under-6-Months. The DHIS2 code is stated beside it as the dhis2-code property, so it stays joinable back to the instance, and generate raises a note for each rewrite. Under refuse, or with the key unset, the run is refused naming the object, as before. d2w fhir validate grades the code the same way: informational under substitute, an error under refuse.

d2w fhir init --org-unit-root

--org-unit-root <uid> seeds [generate.organisation_units] root, the top of the subtree a project publishes. The UID's shape is checked, and nothing is read from the instance.

d2w fhir init national --with-registry --id dhis2.fhir.national --org-unit-root ImspTQPwCqd --org-unit-max-level 5

Under --with-registry the root lands in both projects, as --org-unit-max-level does. A guide's forms may only be assigned to organisation units the registry package publishes. A guide whose [generate.organisation_units] table is left empty reads the whole instance, including any subtree kept for deactivated organisation units that the package's root leaves out, and d2w fhir check-artifacts then reports each such reference as build-aborting. Publish the registry as a package now states this rule, and Troubleshooting names the finding.

The depth flag beside it is now --org-unit-max-level, so both flags name what they select, the way --org-unit and --org-unit-group do elsewhere in d2w. A script passing --max-level needs the new name, and fhir.toml is unchanged: the keys are still root and max_level.

For a pair scaffolded on an earlier version, copy the registry's root and max_level into the guide's fhir.toml, then run make update and make generate.