ergon-framework-python 0.1.0__tar.gz → 0.1.2__tar.gz

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ergon-framework-python
-Version: 0.1.0
+Version: 0.1.2
 Summary: Ergon internal task-oriented project bootstrapper
 Author-email: Ergondata Technologies <anza.vossos@protonmail.com>
 License-Expression: MIT
@@ -55,7 +55,7 @@ For local development, install in editable mode:
 pip install -e /path/to/ergon-framework/sdks/python
 ```
 
-📖 **[Full Getting Started Guide](docs/getting-started.md)** — Complete setup, project configuration, and task registration
+📖 **[Full Getting Started Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/getting-started.md)** — Complete setup, project configuration, and task registration
 
 ---
 
@@ -419,7 +419,7 @@ my-project/
         └── helpers.py       # Task-specific utilities
 ```
 
-📖 **[Full Project Structure Guide](docs/project-structure.md)** — Detailed documentation on organizing connectors, tasks, and shared modules.
+📖 **[Full Project Structure Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/project-structure.md)** — Detailed documentation on organizing connectors, tasks, and shared modules.
 
 ---
 
@@ -427,23 +427,23 @@ my-project/
 
 ### Python SDK Guides
 
-- **[Getting Started](docs/getting-started.md)** — Installation, project setup, and running your first task
-- **[CLI Reference](docs/cli.md)** — Commands, options, and exit codes
-- **[Project Structure Guide](docs/project-structure.md)** — How to organize connectors, tasks, and shared modules
+- **[Getting Started](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/getting-started.md)** — Installation, project setup, and running your first task
+- **[CLI Reference](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/cli.md)** — Commands, options, and exit codes
+- **[Project Structure Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/project-structure.md)** — How to organize connectors, tasks, and shared modules
 
 ### Framework Concepts
 
-- **[Framework Architecture](../../docs/architecture.md)** — Full system specification and design philosophy
-- **[Transaction Abstraction](../../docs/modules/1.transaction.md)** — Understanding atomicity rules
-- **[Task Module](../../docs/modules/2.task.md)** — Mixins, lifecycles, and execution modes
-- **[Connector Module](../../docs/modules/3.connector.md)** — Building integration boundaries
-- **[Service Module](../../docs/modules/4.service.md)** — Protocol engineering and reliability
-- **[Telemetry Module](../../docs/modules/5.telemetry.md)** — Configuring OTel logs, metrics, and traces
+- **[Framework Architecture](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/architecture.md)** — Full system specification and design philosophy
+- **[Transaction Abstraction](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/1.transaction.md)** — Understanding atomicity rules
+- **[Task Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/2.task.md)** — Mixins, lifecycles, and execution modes
+- **[Connector Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/3.connector.md)** — Building integration boundaries
+- **[Service Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/4.service.md)** — Protocol engineering and reliability
+- **[Telemetry Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/5.telemetry.md)** — Configuring OTel logs, metrics, and traces
 
 ---
 
 ## License
 
-This project is licensed under the [MIT License](../../LICENSE).
+This project is licensed under the [MIT License](https://github.com/danzanellovossos/ergon-framework/blob/main/LICENSE).
 
 <br/>

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/README.md

@@ -20,7 +20,7 @@ For local development, install in editable mode:
 pip install -e /path/to/ergon-framework/sdks/python
 ```
 
-📖 **[Full Getting Started Guide](docs/getting-started.md)** — Complete setup, project configuration, and task registration
+📖 **[Full Getting Started Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/getting-started.md)** — Complete setup, project configuration, and task registration
 
 ---
 
@@ -384,7 +384,7 @@ my-project/
         └── helpers.py       # Task-specific utilities
 ```
 
-📖 **[Full Project Structure Guide](docs/project-structure.md)** — Detailed documentation on organizing connectors, tasks, and shared modules.
+📖 **[Full Project Structure Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/project-structure.md)** — Detailed documentation on organizing connectors, tasks, and shared modules.
 
 ---
 
@@ -392,23 +392,23 @@ my-project/
 
 ### Python SDK Guides
 
-- **[Getting Started](docs/getting-started.md)** — Installation, project setup, and running your first task
-- **[CLI Reference](docs/cli.md)** — Commands, options, and exit codes
-- **[Project Structure Guide](docs/project-structure.md)** — How to organize connectors, tasks, and shared modules
+- **[Getting Started](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/getting-started.md)** — Installation, project setup, and running your first task
+- **[CLI Reference](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/cli.md)** — Commands, options, and exit codes
+- **[Project Structure Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/project-structure.md)** — How to organize connectors, tasks, and shared modules
 
 ### Framework Concepts
 
-- **[Framework Architecture](../../docs/architecture.md)** — Full system specification and design philosophy
-- **[Transaction Abstraction](../../docs/modules/1.transaction.md)** — Understanding atomicity rules
-- **[Task Module](../../docs/modules/2.task.md)** — Mixins, lifecycles, and execution modes
-- **[Connector Module](../../docs/modules/3.connector.md)** — Building integration boundaries
-- **[Service Module](../../docs/modules/4.service.md)** — Protocol engineering and reliability
-- **[Telemetry Module](../../docs/modules/5.telemetry.md)** — Configuring OTel logs, metrics, and traces
+- **[Framework Architecture](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/architecture.md)** — Full system specification and design philosophy
+- **[Transaction Abstraction](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/1.transaction.md)** — Understanding atomicity rules
+- **[Task Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/2.task.md)** — Mixins, lifecycles, and execution modes
+- **[Connector Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/3.connector.md)** — Building integration boundaries
+- **[Service Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/4.service.md)** — Protocol engineering and reliability
+- **[Telemetry Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/5.telemetry.md)** — Configuring OTel logs, metrics, and traces
 
 ---
 
 ## License
 
-This project is licensed under the [MIT License](../../LICENSE).
+This project is licensed under the [MIT License](https://github.com/danzanellovossos/ergon-framework/blob/main/LICENSE).
 
 <br/>

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ergon-framework-python"
-version = "0.1.0"
+version = "0.1.2"
 description = "Ergon internal task-oriented project bootstrapper"
 readme = "README.md"
 license = "MIT"

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/src/ergon/__init__.py

@@ -10,4 +10,4 @@ __all__ = [
     "manager",
 ]
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/src/ergon/connector/rabbitmq/async_connector.py

@@ -116,5 +116,14 @@ class AsyncRabbitMQConnector(AsyncConnector):
             raise ValueError(f"Cannot nack transaction {transaction.id}: no raw message in metadata")
         await self.service.nack(raw_message, requeue=requeue)
 
+    def health(self) -> Dict[str, Any]:
+        """Consumer liveness snapshot (last fetch/ack, active tag, channel state).
+
+        Intended for wiring a service-level health check that can detect a
+        wedged or zombie consumer rather than silently running after a broker
+        cancel.
+        """
+        return self.service.health()
+
     async def close(self) -> None:
         await self.service.close()

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/src/ergon/connector/rabbitmq/async_service.py

@@ -2,6 +2,7 @@ import asyncio
 import json
 import logging
 import ssl as ssl_module
+import time
 from typing import Any, Callable, Dict, List, Optional
 
 import aio_pika
@@ -31,6 +32,15 @@ _DEAD_CHANNEL_EXCEPTIONS: tuple[type[BaseException], ...] = (
     aiormq.exceptions.ChannelInvalidStateError,
 )
 
+# Same as above plus ``TimeoutError`` (raised by ``asyncio.timeout`` when an
+# ack/nack stalls on a half-open socket). A stalled ack is functionally a dead
+# channel: we tear down and let the broker redeliver instead of blocking until
+# the heartbeat eventually fires.
+_DEAD_CHANNEL_TIMEOUT_EXCEPTIONS: tuple[type[BaseException], ...] = (
+    *_DEAD_CHANNEL_EXCEPTIONS,
+    TimeoutError,
+)
+
 
 class AsyncRabbitMQService:
     def __init__(self, client: AsyncRabbitmqClient) -> None:
@@ -49,6 +59,13 @@ class AsyncRabbitMQService:
         self._exchanges: Dict[str, AbstractExchange] = {}
         self._queues: Dict[str, AbstractQueue] = {}
 
+        # Liveness signals so services can wire a real health check instead of
+        # silently running with a zombie/dead consumer. Updated on every
+        # successful fetch/ack and reset when the consume channel is torn down.
+        self._last_fetch_ts: Optional[float] = None
+        self._last_ack_ts: Optional[float] = None
+        self._active_consumer_tag: Optional[str] = None
+
     # ---------- Connection / Channel ----------
 
     async def _get_connection(self) -> AbstractRobustConnection:
@@ -89,6 +106,61 @@ class AsyncRabbitMQService:
         self._queues.clear()
         self._exchanges.clear()
 
+    async def _teardown_consume_channel(self, reason: str = "explicit teardown") -> None:
+        """Deterministically tear down the consume channel.
+
+        Unlike :meth:`_invalidate_consume_channel` (which only drops Python
+        references), this snapshots the live channel, clears the cache, then
+        explicitly ``close()``-es the channel. Closing the channel:
+
+        * drops every consumer registered on it at the broker — this is what
+          eliminates the *zombie consumer* left behind by a broker-initiated
+          ``Basic.Cancel`` that the per-fetch iterator could not cancel
+          cleanly; and
+        * for a ``RobustChannel`` removes it from aio_pika's reconnection set,
+          so the robust layer does not silently restore the dead consumer on
+          the next reconnect.
+
+        It also prevents the channel leak: previously the dropped channel
+        object was orphaned without ever being closed, so its broker-side
+        channel lingered and ``ChannelCount`` climbed over time.
+        """
+        channel = self._consume_channel
+        self._invalidate_consume_channel(reason)
+        self._active_consumer_tag = None
+        await self._close_channel_safely(channel, reason)
+
+    async def _close_channel_safely(self, channel: Optional[AbstractChannel], reason: str) -> None:
+        """Best-effort close of a (possibly already-dead) channel."""
+        if channel is None:
+            return
+        try:
+            if not channel.is_closed:
+                await channel.close()
+                logger.info("Closed dead consume channel (%s)", reason)
+        except Exception as exc:  # noqa: BLE001 - best-effort teardown
+            logger.warning("Error closing consume channel during teardown (%s): %r", reason, exc)
+
+    def _schedule_teardown(self, reason: str) -> None:
+        """Tear down the consume channel from a sync callback context.
+
+        ``add_close_callback`` / consumer-cancel callbacks are synchronous, so
+        we cannot ``await``. We invalidate the cache synchronously (so the next
+        consume never sees a stale channel) and, when a running event loop is
+        available, schedule the explicit ``close()`` as a task to drop the dead
+        channel's consumers at the broker and avoid the channel leak.
+        """
+        channel = self._consume_channel
+        self._invalidate_consume_channel(reason)
+        self._active_consumer_tag = None
+        if channel is None or channel.is_closed:
+            return
+        try:
+            loop = asyncio.get_running_loop()
+        except RuntimeError:
+            return
+        loop.create_task(self._close_channel_safely(channel, reason))
+
     def _on_consume_channel_close(self, *args: Any, **kwargs: Any) -> None:
         """Callback registered with ``channel.add_close_callback``.
 
@@ -97,7 +169,7 @@ class AsyncRabbitMQService:
         """
         exc = args[1] if len(args) >= 2 else kwargs.get("exc")
         reason = f"channel closed: {exc!r}" if exc is not None else "channel closed"
-        self._invalidate_consume_channel(reason)
+        self._schedule_teardown(reason)
 
     async def _get_consume_channel(self, prefetch_count: Optional[int] = None) -> AbstractChannel:
         if self._consume_channel is None or self._consume_channel.is_closed:
@@ -246,24 +318,32 @@ class AsyncRabbitMQService:
             async with asyncio.timeout(timeout):  # type: ignore[attr-defined]
                 async with queue.iterator(no_ack=config.auto_ack) as iterator:
                     self._register_consumer_cancel_callback(iterator)
+                    # Surface the active consumer tag for liveness diagnostics;
+                    # attribute name varies across aio_pika versions.
+                    self._active_consumer_tag = getattr(iterator, "_consumer_tag", None) or getattr(
+                        iterator, "consumer_tag", None
+                    )
                     async for message in iterator:
                         msg_dict = self._message_to_dict(message)
                         buffer.append(msg_dict)
+                        self._last_fetch_ts = time.time()
                         if len(buffer) >= batch_size:
                             break
         except TimeoutError:
             pass
         except _DEAD_CHANNEL_EXCEPTIONS as exc:
-            # Broker cancelled this subscription mid-iteration; invalidate
-            # the cached channel so the next call rebuilds against a fresh
-            # consumer and the broker redelivers what we had prefetched.
-            self._invalidate_consume_channel(f"consume aborted: {exc!r}")
+            # Broker cancelled this subscription mid-iteration; deterministically
+            # tear down (cancel consumers + close) the dead channel so the next
+            # call rebuilds against a fresh consumer, the broker redelivers what
+            # we had prefetched, and no zombie consumer / leaked channel is left
+            # behind.
+            await self._teardown_consume_channel(f"consume aborted: {exc!r}")
             return buffer
         finally:
             # If the channel was closed during iteration, make sure we don't
             # hand back a stale cache to the next caller.
             if self._consume_channel is not None and self._consume_channel.is_closed:
-                self._invalidate_consume_channel("consume channel observed closed after iteration")
+                await self._teardown_consume_channel("consume channel observed closed after iteration")
 
         return buffer
 
@@ -290,7 +370,7 @@ class AsyncRabbitMQService:
             return
 
         def _on_cancel(*_args: Any, **_kwargs: Any) -> None:
-            self._invalidate_consume_channel("consumer cancelled by broker (Basic.Cancel)")
+            self._schedule_teardown("consumer cancelled by broker (Basic.Cancel)")
 
         try:
             candidate(_on_cancel)
@@ -373,9 +453,13 @@ class AsyncRabbitMQService:
         from ...task import exceptions as task_exceptions
 
         try:
-            await message.ack()
-        except _DEAD_CHANNEL_EXCEPTIONS as exc:
-            self._invalidate_consume_channel(f"ack failed: {exc!r}")
+            # Bound the ack so a half-open socket is detected in seconds rather
+            # than blocking until the (much longer) heartbeat timeout fires.
+            async with asyncio.timeout(self.client.ack_timeout):  # type: ignore[attr-defined]
+                await message.ack()
+            self._last_ack_ts = time.time()
+        except _DEAD_CHANNEL_TIMEOUT_EXCEPTIONS as exc:
+            await self._teardown_consume_channel(f"ack failed: {exc!r}")
             raise task_exceptions.AckOnDeadChannelError(
                 delivery_tag=getattr(message, "delivery_tag", None),
                 queue=getattr(message, "routing_key", None),
@@ -386,15 +470,39 @@ class AsyncRabbitMQService:
         from ...task import exceptions as task_exceptions
 
         try:
-            await message.nack(requeue=requeue)
-        except _DEAD_CHANNEL_EXCEPTIONS as exc:
-            self._invalidate_consume_channel(f"nack failed: {exc!r}")
+            async with asyncio.timeout(self.client.ack_timeout):  # type: ignore[attr-defined]
+                await message.nack(requeue=requeue)
+        except _DEAD_CHANNEL_TIMEOUT_EXCEPTIONS as exc:
+            await self._teardown_consume_channel(f"nack failed: {exc!r}")
             raise task_exceptions.NackOnDeadChannelError(
                 delivery_tag=getattr(message, "delivery_tag", None),
                 queue=getattr(message, "routing_key", None),
                 cause=exc,
             ) from exc
 
+    # ---------- Health / Liveness ----------
+
+    def health(self) -> Dict[str, Any]:
+        """Snapshot of consumer liveness for external health checks.
+
+        Exposes the timestamps of the last successful fetch and ack, the active
+        consumer tag, and connection/channel state so a service can detect a
+        wedged or zombie consumer (e.g. no successful ack within N seconds)
+        instead of silently running for hours after a broker cancel.
+        """
+        now = time.time()
+        connection_open = self._connection is not None and not self._connection.is_closed
+        consume_channel_open = self._consume_channel is not None and not self._consume_channel.is_closed
+        return {
+            "connection_open": connection_open,
+            "consume_channel_open": consume_channel_open,
+            "active_consumer_tag": self._active_consumer_tag,
+            "last_fetch_ts": self._last_fetch_ts,
+            "last_ack_ts": self._last_ack_ts,
+            "seconds_since_last_fetch": (now - self._last_fetch_ts) if self._last_fetch_ts is not None else None,
+            "seconds_since_last_ack": (now - self._last_ack_ts) if self._last_ack_ts is not None else None,
+        }
+
     # ---------- Lifecycle ----------
 
     async def close(self) -> None:

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/src/ergon/connector/rabbitmq/models.py

@@ -51,7 +51,22 @@ class AsyncRabbitmqClient(BaseModel):
     username: str = Field(default="guest", description="RabbitMQ username")
     password: str = Field(default="guest", description="RabbitMQ password")
     virtual_host: str = Field(default="/", description="RabbitMQ virtual host")
-    heartbeat: int = Field(default=600, description="Heartbeat interval in seconds")
+    heartbeat: int = Field(
+        default=60,
+        description=(
+            "Heartbeat interval in seconds. Kept low (default 60) so a half-open "
+            "socket is detected within ~2x heartbeat instead of blocking for many "
+            "minutes. AmazonMQ/RabbitMQ negotiate the lower of client/server values."
+        ),
+    )
+    ack_timeout: float = Field(
+        default=30,
+        description=(
+            "Max seconds to wait for an ack/nack RPC before treating the channel as "
+            "dead. Bounds recovery so a stalled ack on a half-open connection fails "
+            "fast (broker redelivers) rather than wedging the consumer."
+        ),
+    )
     connection_attempts: int = Field(default=3, description="Connection retry attempts")
     ssl_enabled: bool = Field(default=False, description="Enable SSL/TLS")
     ssl_ca_certs: Optional[str] = Field(default=None, description="Path to CA certificate when using SSL")
@@ -67,7 +82,15 @@ class AsyncRabbitmqConsumerConfig(BaseModel):
     exchange_name: str = Field(default="", description="Exchange name (empty for default exchange)")
     exchange_type: str = Field(default="topic", description="Exchange type: topic, direct, fanout, headers")
     binding_keys: list[str] = Field(default=["#"], description="Routing key patterns for queue binding")
-    prefetch_count: int = Field(default=10, description="Number of unacknowledged messages allowed")
+    prefetch_count: int = Field(
+        default=10,
+        description=(
+            "Number of unacknowledged messages allowed. Recommended: set equal to the "
+            "consumer loop concurrency. A prefetch larger than concurrency lets idle "
+            "sibling messages sit unacked until they age past the broker "
+            "consumer_timeout, which triggers a Basic.Cancel and consumer recovery."
+        ),
+    )
     durable: bool = Field(default=True, description="Durable exchange and queue declarations")
     auto_ack: bool = Field(default=False, description="Automatically acknowledge messages on delivery")
     consume_timeout: float = Field(default=2.0, description="Max seconds to wait per fetch call")

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/src/ergon/task/mixins/consumer.py

@@ -45,6 +45,34 @@ def _wrap_handler_failure(result: Any) -> exceptions.TransactionException:
     )
 
 
+def _warn_if_prefetch_exceeds_concurrency(conn: Any, policy: policies.ConsumerPolicy, task_name: str) -> None:
+    """Warn when a broker consumer holds more unacked messages than it can process.
+
+    A prefetch larger than the loop concurrency lets idle sibling messages sit
+    unacked until they age past the broker ``consumer_timeout``, which triggers
+    a ``Basic.Cancel`` and the whole consumer-recovery path. The connector
+    cannot see the loop concurrency and the policy cannot see the connector's
+    prefetch, so the check lives here where both are visible. Best-effort:
+    silently skips connectors that do not expose a consumer config.
+    """
+    consumer_config = getattr(conn, "_consumer_config", None)
+    prefetch = getattr(consumer_config, "prefetch_count", None)
+    if not isinstance(prefetch, int):
+        return
+    concurrency = policy.loop.concurrency.value
+    if prefetch > concurrency:
+        logger.warning(
+            "[%s] prefetch_count=%d exceeds loop concurrency=%d: up to %d messages will be "
+            "held unacked while only %d are processed concurrently. Idle siblings can age past "
+            "the broker consumer_timeout and trigger a Basic.Cancel. Set prefetch_count == concurrency.",
+            task_name,
+            prefetch,
+            concurrency,
+            prefetch,
+            concurrency,
+        )
+
+
 class ConsumerMixin(ABC):
     name: str
     connectors: dict[str, connector.Connector]
@@ -702,6 +730,7 @@ class AsyncConsumerMixin(ABC):
             logger.debug(f"Consume loop running with loop policy: {policy.loop.model_dump_json(indent=2)}")
 
             conn = self._resolve_connector(policy.fetch.connector_name)
+            _warn_if_prefetch_exceeds_concurrency(conn, policy, getattr(self, "name", self.__class__.__name__))
 
             ctx = otel_context.Context()
 

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/src/ergon_framework_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ergon-framework-python
-Version: 0.1.0
+Version: 0.1.2
 Summary: Ergon internal task-oriented project bootstrapper
 Author-email: Ergondata Technologies <anza.vossos@protonmail.com>
 License-Expression: MIT
@@ -55,7 +55,7 @@ For local development, install in editable mode:
 pip install -e /path/to/ergon-framework/sdks/python
 ```
 
-📖 **[Full Getting Started Guide](docs/getting-started.md)** — Complete setup, project configuration, and task registration
+📖 **[Full Getting Started Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/getting-started.md)** — Complete setup, project configuration, and task registration
 
 ---
 
@@ -419,7 +419,7 @@ my-project/
         └── helpers.py       # Task-specific utilities
 ```
 
-📖 **[Full Project Structure Guide](docs/project-structure.md)** — Detailed documentation on organizing connectors, tasks, and shared modules.
+📖 **[Full Project Structure Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/project-structure.md)** — Detailed documentation on organizing connectors, tasks, and shared modules.
 
 ---
 
@@ -427,23 +427,23 @@ my-project/
 
 ### Python SDK Guides
 
-- **[Getting Started](docs/getting-started.md)** — Installation, project setup, and running your first task
-- **[CLI Reference](docs/cli.md)** — Commands, options, and exit codes
-- **[Project Structure Guide](docs/project-structure.md)** — How to organize connectors, tasks, and shared modules
+- **[Getting Started](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/getting-started.md)** — Installation, project setup, and running your first task
+- **[CLI Reference](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/cli.md)** — Commands, options, and exit codes
+- **[Project Structure Guide](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/docs/project-structure.md)** — How to organize connectors, tasks, and shared modules
 
 ### Framework Concepts
 
-- **[Framework Architecture](../../docs/architecture.md)** — Full system specification and design philosophy
-- **[Transaction Abstraction](../../docs/modules/1.transaction.md)** — Understanding atomicity rules
-- **[Task Module](../../docs/modules/2.task.md)** — Mixins, lifecycles, and execution modes
-- **[Connector Module](../../docs/modules/3.connector.md)** — Building integration boundaries
-- **[Service Module](../../docs/modules/4.service.md)** — Protocol engineering and reliability
-- **[Telemetry Module](../../docs/modules/5.telemetry.md)** — Configuring OTel logs, metrics, and traces
+- **[Framework Architecture](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/architecture.md)** — Full system specification and design philosophy
+- **[Transaction Abstraction](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/1.transaction.md)** — Understanding atomicity rules
+- **[Task Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/2.task.md)** — Mixins, lifecycles, and execution modes
+- **[Connector Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/3.connector.md)** — Building integration boundaries
+- **[Service Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/4.service.md)** — Protocol engineering and reliability
+- **[Telemetry Module](https://github.com/danzanellovossos/ergon-framework/blob/main/docs/modules/5.telemetry.md)** — Configuring OTel logs, metrics, and traces
 
 ---
 
 ## License
 
-This project is licensed under the [MIT License](../../LICENSE).
+This project is licensed under the [MIT License](https://github.com/danzanellovossos/ergon-framework/blob/main/LICENSE).
 
 <br/>

{ergon_framework_python-0.1.0 → ergon_framework_python-0.1.2}/tests/test_smoke.py

@@ -4,4 +4,4 @@ import ergon
 
 
 def test_ergon_package_is_importable() -> None:
-    assert ergon.__version__ == "0.1.0"
+    assert ergon.__version__ == "0.1.1"