11.0.284

parruda/swarm11.0.284Jun 28, 2026by adubovikov

AI Summary

Bugfix release addressing parsing issues in virtual search fields and URI handling, accompanied by documentation updates for search timeouts and custom fields.

Key Highlights

  • Fixed virtual `data_extra_json` search fields to accept hyphenated JSON keys.
  • Fixed From/To URI parsing when display-name contains angle brackets.
  • Updated documentation for search timeouts and custom header search mappings.

New Features

  • Support for hyphenated JSON keys in virtual search fields.
  • Improved URI parsing logic for SIP messages.

Full Release Notes

## Summary

Bugfix and documentation release.

### Fixes
* **#844** - Virtual `data_extra_json` search fields accept hyphenated JSON keys (e.g. `custom_headers.X-icc_uuid`) ([#847](https://github.com/sipcapture/homer/pull/847))
* **#846** - From/To URI parsing when display-name contains angle brackets, e.g. `"a <b@c>" <sip:foo@bar>` ([#848](https://github.com/sipcapture/homer/pull/848))

### Documentation
* [TROUBLESHOOTING.md](https://sipcapture.github.io/homer/TROUBLESHOOTING/) - search timeouts (`query_timeout_sec`, `http_server` read/write timeouts)
* [SEARCH_MAPPINGS_AND_FIELDS.md](https://sipcapture.github.io/homer/SEARCH_MAPPINGS_AND_FIELDS/) - custom SIP header virtual field example
* Data retention guide and cross-links

### Upgrade notes
* **Custom header search:** use exact JSON key in `virtual.path` (e.g. `custom_headers.X-icc_uuid`).
* **Long searches:** raise `coordinator.query_timeout_sec` and matching `http_server.read_timeout` / `write_timeout` - see [TROUBLESHOOTING](https://sipcapture.github.io/homer/TROUBLESHOOTING/#search-timeouts-30-seconds).

**Full Changelog**: https://github.com/sipcapture/homer/compare/11.0.283...11.0.284