feat(amgi-stomp): add STOMP support

[TomKimber]

Add STOMP support: #51.

[Copilot]

Copilot review overview

🟡 Changes recommended

Python compatibility metadata and shutdown lifecycle handling currently permit installation and concurrency failures.

Review effort: Balanced
Findings: 1 · 2

Open (3)

• Fix Python version metadata and missing stompman dependency · New
• Unsubscribe before lifespan exit and drain pending tasks · New
• Preserve exceptions when exiting message_send context manager · New

What changed in this PR

Adds a STOMP-backed AMGI server with sending, receiving, acknowledgements, documentation, examples, packaging, and CI coverage.

Changes:

• Implements the amgi-stomp server and CLI entry point.
• Adds unit and Artemis integration tests.
• Integrates the package into the workspace, examples, tooling, and CI.

File	Description
uv.lock	Locks the new package and stompman.
tox.ini	Adds STOMP test environments.
README.md	Lists the STOMP server.
packages/​amgi-stomp/​tests_amgi_stomp/​test_stomp_message.py	Tests core message behavior.
packages/​amgi-stomp/​tests_amgi_stomp/​test_stomp_message_integration.py	Tests against Artemis.
packages/​amgi-stomp/​src/​amgi_stomp/​py.typed	Marks the package as typed.
packages/​amgi-stomp/​src/​amgi_stomp/​__init__.py	Implements the server and sender.
packages/​amgi-stomp/​README.md	Documents installation and usage.
packages/​amgi-stomp/​pyproject.toml	Defines package metadata and entry point.
packages/​amgi-stomp/​LICENSE	Adds the package license.
example/​stomp/​docker-compose.yaml	Provides an Artemis broker.
example/​README.md	Documents the STOMP example.
example/​pyproject.toml	Adds the example dependency.
.python-versions	Makes Python 3.11 the primary version.
.pre-commit-config.yaml	Adds stompman for type checking.
.github/​workflows/​tests.yml	Adds STOMP to CI.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[read-the-docs-community]

Documentation build overview

📚 AMGI | 🛠️ Build #35128136 | 📁 Comparing 02b6689 against latest (7f72e38)

  🔍 Preview build  

4 files changed

± specifications.html
± specifications/bindings.html
± specifications/lifespan.html
± specifications/message.html

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[Copilot]

🟡 Changes recommended

Shutdown races, an ineffective handler timeout, and the Python 3.10 import path must be corrected.

6 open findings

• Guard typing.Self import for Python 3.10 · New
• Enforce shutdown deadline while waiting for handlers · New
• Disable callbacks before draining shutdown tasks · New
• Document broker-dependent NACK redelivery behavior · New
• Clarify STOMP receipts do not guarantee message durability · New
• Avoid promising redelivery after STOMP NACK · New

3 resolved since last review

• Fix Python version metadata and missing stompman dependency
• Preserve exceptions when exiting message_send context manager
• Unsubscribe before lifespan exit and drain pending tasks

🧠 Review effort: Balanced

[read-the-docs-community]

Documentation build overview

📚 AsyncFast | 🛠️ Build #35128137 | 📁 Comparing 02b6689 against latest (7f72e38)

  🔍 Preview build  

1 file changed

± message_payload.html