Reporting Reproducible Issues#

Good reports make fixes faster.

Minimum report payload#

Include:

  • library version (host library and smonitor if available),

  • operating system and Python version,

  • minimal code snippet to reproduce,

  • exact error/warning message (including code ID),

  • optional bundle export.

Suggested report format#

  1. What you expected.

  2. What happened.

  3. Reproducer snippet.

  4. Full message output.

  5. Bundle path or attachment.

Copy-paste issue template#

## Summary
Short description of the problem.

## Expected behavior
What you expected to happen.

## Observed behavior
What actually happened.

## Reproducer
```python
# minimal script/cell
```

## Diagnostic message
Paste full warning/error text and code ID.

## Environment
- host library version:
- smonitor version (if available):
- Python:
- OS:

## Optional bundle
Path/attachment (redacted if needed).

Example short issue body#

Expected: selection should return only CA atoms.
Observed: warning MYLIB-W001 and empty result.
Reproducer: <10-line script>
Message: WARNING [MYLIB-W001] ...
Bundle: attached (redacted)