Findings from code review that await an owner decision or an implementation. Each row is one file in issues/details/, which holds the evidence, the effect, the possible fix, the test that would prove it and the risk. Resolved issues are kept in issues/resolved/ so that their numbers are never reused. Issues that concern a SimObject are also shown on that model's documentation page.

How to work an item

Reproduce the Evidence at the file:line given in the detail file, at HEAD.
For a blocked item, get the owner's answer to "Decision needed" first, then set Status to ready.
Write the proving test, apply the fix, check the Risk paragraph.
git mv the file to issues/resolved/, add a | Resolved | <commit>, <date> | row, delete the matching \xrefitem reviewissue "Review issues" "Review issues" \ref fhsim_core_issue_<ID> lines from the headers, rerun the script and commit it all together.

New issue: add issues/details/<slug>.md with the metadata table but no ID row; the script assigns the next free number, writes the heading and renames the file to <TAG>-<ID>-<slug>.md.

Legend

Tag	Values
Class	`BUG` code does something other than its documentation or sibling code says; `KNOWN-LIMITATION` behaviour gap by design or omission, document rather than fix silently; `ARCHITECTURE` structure, dependencies, build layout, dead code and stale artefacts; `DOCUMENTATION` missing or wrong documentation or example; `TEST` test coverage or infrastructure; `API` public name (port, state, parameter, registration string) whose change breaks input files; `SECURITY` credentials and supply chain
Severity	`3` wrong numbers, a crash or a secret exposure reaches a user; `2` a documented interface does not work as documented; `1` tidiness, readers and tools only
Status	`blocked` needs the owner decision named in the file; `ready` fully specified

Open issues (2)

ID	Class	Severity	Status	Models	Title
FHSIM-0002	BUG	2	blocked	—	copySimObjectLibraries uses hasVis where bundlesVisualization is meant
FHSIM-0001	KNOWN-LIMITATION	1	blocked	—	FMU export metadata is not reproducible

Resolved issues (1)

ID	Class	Title	Resolved	File
FHSIM-0003	BUG	A visual FMU omits the plain SimObject modules, so visualization=false fails	`pending`, 2026-09-21	`resolved/FHSIM-0003-visual-fmu-omits-plain-simobject-modules.md`