# Contributing

Maintain the declared 0.5.0 source-release scope: public MoonBit libraries, compatible CLI,
portable queries/quality/plans, Native data tools, controlled POSIX private adapters and loopback workbench. Database transactions,
review/signing and local UI are existing components. Changes to compressed pixels,
PACS/network services, diagnosis or full IOD/Profile claims need explicit scope,
independent fixtures and acceptance criteria before those claims enter the README.

Repository issues/PRs are the maintenance channel; the repository owner reviews
behavior and source provenance. No support SLA or production certification is promised.
Record breaking API/schema/tool fingerprints and migration/recovery consequences.
Keep README.md and README.mbt.md synchronized, update the Chinese guide, changelog,
support matrix and executable examples in the same change.

Use [API compatibility](docs/API_COMPATIBILITY.zh-CN.md), [0.5 migration](docs/MIGRATION_0.5.zh-CN.md) and [environment diagnosis](docs/DOCTOR.zh-CN.md) before changing behavior. A bug report must use a synthetic reproduction and stable error code; the issue templates explain the required evidence.

Bounded first contributions (open proposals, not claimed third-party adoption):

- Add keyboard-only selection and screen-reader acceptance for the lab, with actual browser evidence; current checks cover button activation and viewport layout.
- Add one independently generated PN/Sequence normalization fixture within the documented JSON subset, including a rejection counterexample.
- Add a synthetic recovery failure reproduction with an explicit invariant and no original patient values.

Do not expand supported VRs or transfer syntaxes without source provenance, budgets, privacy checks and an independent semantic oracle. Run the [V6 source gate](docs/V6_ACCEPTANCE.zh-CN.md) in a clean checkout before release.

Before submitting a change:

```bash
moon fmt --check
moon check --target all --deny-warn
moon test --target all --deny-warn
moon build --target native
moon info
moon package
```

Every parser branch and bug fix needs a focused regression test. Expected
failures must use stable `MEDSEAL-E...`, `MEDSEAL-W...` or query `QUERY-*` codes and include
safe context such as offset and tag where available. Never log or place an
original patient value in an assertion, snapshot, report, or issue.

Only public, synthetic, or confirmed de-identified DICOM files may be added.
Document every sample's source or generator in `samples/README.md`.

Run python3.12 tools/check_documentation.py after updating all affected docs.
The [document index](docs/DOCUMENTATION_STATUS.zh-CN.md) distinguishes current
contracts, original plans and fixed evidence. Keep private-host guarantees out
of compatibility/basic claims. Never overwrite immutable published archives.

> 文档核对：本文说明已与当前维护代码和实际入口核对；不扩大医疗/生产保证。见[文档账本](docs/DOCUMENTATION_STATUS.zh-CN.md)；正式申报由韩桢本人完成。