docs

Author: v1r3n

WORKER_CONFIGURATION.md

@@ -19,16 +19,18 @@ This means:
 
 The following properties can be configured via environment variables:
 
-| Property | Type | Description | Example |
-|----------|------|-------------|---------|
-| `poll_interval` | float | Polling interval in milliseconds | `1000` |
-| `domain` | string | Worker domain for task routing | `production` |
-| `worker_id` | string | Unique worker identifier | `worker-1` |
-| `thread_count` | int | Number of concurrent threads/coroutines | `10` |
-| `register_task_def` | bool | Auto-register task definition | `true` |
-| `poll_timeout` | int | Poll request timeout in milliseconds | `100` |
-| `lease_extend_enabled` | bool | Enable automatic lease extension | `true` |
-| `paused` | bool | Pause worker from polling/executing tasks | `true` |
+| Property | Type | Description | Example | Decorator? |
+|----------|------|-------------|---------|------------|
+| `poll_interval` | float | Polling interval in milliseconds | `1000` | ✅ Yes |
+| `domain` | string | Worker domain for task routing | `production` | ✅ Yes |
+| `worker_id` | string | Unique worker identifier | `worker-1` | ✅ Yes |
+| `thread_count` | int | Number of concurrent threads/coroutines | `10` | ✅ Yes |
+| `register_task_def` | bool | Auto-register task definition | `true` | ✅ Yes |
+| `poll_timeout` | int | Poll request timeout in milliseconds | `100` | ✅ Yes |
+| `lease_extend_enabled` | bool | Enable automatic lease extension | `false` | ✅ Yes |
+| `paused` | bool | Pause worker from polling/executing tasks | `true` | ❌ **Environment-only** |
+
+**Note**: The `paused` property is intentionally **not available** in the `@worker_task` decorator. It can only be controlled via environment variables, allowing operators to pause/resume workers at runtime without code changes or redeployment.
 
 ## Environment Variable Format
 
@@ -356,7 +358,7 @@ Use sensible defaults in code so workers work without environment variables:
     poll_interval=1000,      # Reasonable default
     domain='dev',            # Safe default domain
     thread_count=5,          # Moderate concurrency
-    lease_extend_enabled=True  # Safe default
+    lease_extend_enabled=False  # Default: disabled
 )
 def process_order(order_id: str):
     ...

WORKER_DESIGN.md

@@ -144,7 +144,7 @@ async def notify(message: str):
 | `domain` | str | None | Worker domain |
 | `worker_id` | str | auto | Worker identifier |
 | `poll_timeout` | int | 100 | Poll timeout (ms) |
-| `lease_extend_enabled` | bool | True | Auto-extend lease |
+| `lease_extend_enabled` | bool | False | Auto-extend lease |
 | `register_task_def` | bool | False | Auto-register task |
 
 ### Examples
@@ -172,6 +172,24 @@ export conductor.worker.process_order.thread_count=50
 
 **Result:** `domain=production`, `thread_count=50`
 
+### Startup Configuration Logging
+
+When workers start, they log their resolved configuration in a compact single-line format:
+
+```
+INFO - Conductor Worker[name=process_order, status=active, poll_interval=1000ms, domain=production, thread_count=50, poll_timeout=100ms, lease_extend=false]
+```
+
+This shows:
+- Worker name and status (active/paused)
+- All resolved configuration values
+- Configuration source (code, global env, or worker-specific env)
+
+**Benefits:**
+- Quick verification of configuration in logs
+- Easy debugging of environment variable issues
+- Single-line format for log aggregation tools
+
 ---
 
 ## Worker Discovery