refactor!: rename python-mediator to gridflow-python-mediator

Package name collision discovered on PyPI.org - python-mediator already exists.
Renamed to gridflow-python-mediator to avoid conflicts and establish GridFlow branding.

BREAKING CHANGE: Package and module names changed
- PyPI package: python-mediator → gridflow-python-mediator
- Python module: python_mediator → gridflow_python_mediator
- Import statement: from python_mediator → from gridflow_python_mediator

Migration guide:
1. Update pyproject.toml dependencies: python-mediator → gridflow-python-mediator
2. Update imports: from python_mediator import X → from gridflow_python_mediator import X
3. Reinstall: pip uninstall python-mediator && pip install gridflow-python-mediator

Changes:
- Renamed package folder: packages/python-mediator/ → packages/gridflow-python-mediator/
- Renamed Python module: src/python_mediator/ → src/gridflow_python_mediator/
- Updated all imports across codebase (tests, examples, dependent packages)
- Updated documentation (README, docs/, examples/)
- Updated pyproject.toml files (root and package-specific)
- Updated python-cqrs-dispatcher dependency

Author: FirstUnicorn

README.md

@@ -175,7 +175,7 @@ app = FastAPI(lifespan=create_lifespan_manager(on_startup=init_db, on_shutdown=c
 </details>
 
 <details>
-<summary><b>python-mediator</b> — mediator with pipeline behaviors</summary>
+<summary><b>gridflow-python-mediator</b> — mediator with pipeline behaviors</summary>
 
 BEFORE (without library):
 ```python
@@ -190,7 +190,7 @@ logger.info(f"Done in {time.time() - start:.2f}s")
 
 AFTER (using library):
 ```python
-from python_mediator import Mediator, LoggingBehavior, TimingBehavior
+from gridflow_python_mediator import Mediator, LoggingBehavior, TimingBehavior
 
 mediator = Mediator()
 mediator.add_pipeline_behavior(LoggingBehavior().handle)
@@ -475,7 +475,7 @@ await dispatcher.dispatch(UserCreated(user_id=42))
 | **sqlalchemy-async-session-factory** | Copy-paste async engine + session boilerplate per project | `create_engine()` / `create_session()` — one-liner setup |
 | **python-structlog-config** | Raw `print()` or inconsistent logging setup | `configure_logging("dev")` — JSON in prod, colored in dev |
 | **fastapi-middleware-toolkit** | Manual CORS / error handler / lifespan wiring | `setup_middleware(app)` — one call configures everything |
-| **python-mediator** | Direct handler calls, no cross-cutting concerns | `mediator.send(cmd)` with pipeline behaviors (logging, validation) |
+| **gridflow-python-mediator** | Direct handler calls, no cross-cutting concerns | `mediator.send(cmd)` with pipeline behaviors (logging, validation) |
 | **python-cqrs-core** | Business logic mixed into route handlers | `Command` / `Query` objects enforce read-write separation |
 | **python-dto-mappers** | Manual `dict → DTO` conversion in every endpoint | `@auto_map` decorator — zero boilerplate mapping |
 | **fastapi-config-patterns** | Scattered `os.getenv()` calls, no validation | Pydantic `Settings` classes with type-safe env loading |
@@ -575,9 +575,9 @@ All packages are **v0.1.0** and independently installable.
   ```bash
   pip install python-cqrs-core
   ```
-- **python-mediator** - Generic mediator with pipeline behaviors
+- **gridflow-python-mediator** - Generic mediator with pipeline behaviors
   ```bash
-  pip install python-mediator
+  pip install gridflow-python-mediator
   ```
 - **python-cqrs-dispatcher** - CQRS dispatcher integrating commands/queries with mediator
   ```bash
@@ -647,7 +647,7 @@ poetry run pytest -v
 **Use when:** Working on a single package in isolation.
 
 **⚠️ Note:** Some packages have cross-dependencies within the monorepo:
-- `python-cqrs-dispatcher` requires `python-cqrs-core` + `python-mediator`
+- `python-cqrs-dispatcher` requires `python-cqrs-core` + `gridflow-python-mediator`
 - `sqlalchemy-async-repositories` may require specific Python constraints
 
 For packages with cross-dependencies, use **Option 1 (Workspace)** instead.
@@ -694,7 +694,7 @@ pip install -e ./python-web-toolkit/packages/python-structlog-config
 pip install -e ./python-web-toolkit/packages/python-infrastructure-exceptions
 pip install -e ./python-web-toolkit/packages/python-dto-mappers
 pip install -e ./python-web-toolkit/packages/python-cqrs-core
-pip install -e ./python-web-toolkit/packages/python-mediator
+pip install -e ./python-web-toolkit/packages/gridflow-python-mediator
 pip install -e ./python-web-toolkit/packages/python-cqrs-dispatcher
 pip install -e ./python-web-toolkit/packages/python-outbox-core
 ```
@@ -806,23 +806,23 @@ poetry run pytest && poetry run lint-imports
    - ✗ Cannot import: CQRS, mediator, repositories, FastAPI, DTOs
 
 2. **Domain Layer Cannot Import Application** - Mid layer depends only on primitives
-   - `python-cqrs-core`, `python-mediator`, `pydantic-response-models`, `python-dto-mappers`
+   - `python-cqrs-core`, `gridflow-python-mediator`, `pydantic-response-models`, `python-dto-mappers`
    - ✗ Cannot import: `python-cqrs-dispatcher`, repositories, FastAPI middleware
 
 3. **Core Components Independence** - Prevents circular dependencies
-   - `python-cqrs-core` and `python-mediator` must not import each other
+   - `python-cqrs-core` and `gridflow-python-mediator` must not import each other
 
 **Layer Hierarchy:**
 
 | Layer | Position | Packages | Import Rules |
 |-------|----------|----------|--------------|
 | **Application** | Top | `python-cqrs-dispatcher`<br>`sqlalchemy-async-repositories`<br>`fastapi-middleware-toolkit`<br>`fastapi-config-patterns` | ✅ Can import from any layer |
-| **Domain** | Middle | `python-cqrs-core`<br>`python-mediator`<br>`pydantic-response-models`<br>`python-dto-mappers`<br>`python-input-validation`<br>`python-outbox-core` | ✅ Can import primitives<br>❌ Cannot import application |
+| **Domain** | Middle | `python-cqrs-core`<br>`gridflow-python-mediator`<br>`pydantic-response-models`<br>`python-dto-mappers`<br>`python-input-validation`<br>`python-outbox-core` | ✅ Can import primitives<br>❌ Cannot import application |
 | **Primitives** | Bottom | `python-technical-primitives`<br>`python-app-exceptions`<br>`python-infrastructure-exceptions`<br>`postgres-data-sanitizers`<br>`sqlalchemy-async-session-factory`<br>`python-structlog-config` | ❌ Cannot import domain/application<br>(Fully isolated foundation) |
 
 **Text Summary:**
 - **Primitives** (bottom): `python-technical-primitives`, exceptions → Cannot import domain/application
-- **Domain** (middle): `python-cqrs-core`, `python-mediator`, DTOs → Cannot import application
+- **Domain** (middle): `python-cqrs-core`, `gridflow-python-mediator`, DTOs → Cannot import application
 - **Application** (top): `python-cqrs-dispatcher`, repositories, FastAPI → Can import anything
 
 ### Adding a New Package

docs/architecture.md

@@ -4,7 +4,7 @@
 
 ```
 Application layer (depends on Domain + Primitives)
-├── python-mediator
+├── gridflow-python-mediator
 ├── python-cqrs-dispatcher (depends on cqrs-core + mediator)
 ├── fastapi-config-patterns
 ├── fastapi-middleware-toolkit
@@ -41,7 +41,7 @@ Only one cross-package dependency exists:
 ```
 python-cqrs-dispatcher
 ├── python-cqrs-core (ICommand, IQuery interfaces)
-└── python-mediator  (Mediator dispatch engine)
+└── gridflow-python-mediator  (Mediator dispatch engine)
 ```
 
 All other packages are fully independent.
@@ -53,9 +53,9 @@ All other packages are fully independent.
 | Specification | `python-technical-primitives` |
 | Repository + Strategy | `sqlalchemy-async-repositories` |
 | Factory Method | `sqlalchemy-async-repositories` (pagination) |
-| Mediator | `python-mediator` |
+| Mediator | `gridflow-python-mediator` |
 | CQRS | `python-cqrs-core`, `python-cqrs-dispatcher` |
-| Pipeline behaviors | `python-mediator` |
+| Pipeline behaviors | `gridflow-python-mediator` |
 | Transactional outbox | `python-outbox-core` |
 | Strategy (formatters) | `python-outbox-core` |
 | CloudEvents | `python-outbox-core` |

docs/conf.py

@@ -28,7 +28,7 @@
         "postgres-data-sanitizers",
         "pydantic-response-models",
         "python-cqrs-core",
-        "python-mediator",
+        "gridflow-python-mediator",
         "python-cqrs-dispatcher",
         "python-dto-mappers",
         "python-domain-events",

docs/packages/python-mediator.md docs/packages/gridflow-python-mediator.mddocs/packages/python-mediator.md renamed to docs/packages/gridflow-python-mediator.md

@@ -1,11 +1,11 @@
-# python-mediator
+# gridflow-python-mediator
 
 Generic mediator pattern with pipeline behaviors for cross-cutting concerns.
 
 ## Installation
 
 ```bash
-pip install python-mediator
+pip install gridflow-python-mediator
 ```
 
 ## Public API
@@ -21,8 +21,8 @@ pip install python-mediator
 ## Usage
 
 ```python
-from python_mediator import Mediator
-from python_mediator.behaviors import LoggingBehavior, ValidationBehavior
+from gridflow_python_mediator import Mediator
+from gridflow_python_mediator.behaviors import LoggingBehavior, ValidationBehavior
 
 mediator = Mediator()
 mediator.add_pipeline_behavior(LoggingBehavior())

docs/packages/index.rst

@@ -11,7 +11,7 @@ Packages
    postgres-data-sanitizers
    pydantic-response-models
    python-cqrs-core
-   python-mediator
+   gridflow-python-mediator
    python-cqrs-dispatcher
    python-dto-mappers
    python-domain-events

docs/quickstart.md

@@ -5,7 +5,7 @@
 All packages are published to PyPI. Install only what you need:
 
 ```bash
-pip install python-cqrs-core python-mediator python-cqrs-dispatcher
+pip install python-cqrs-core gridflow-python-mediator python-cqrs-dispatcher
 pip install sqlalchemy-async-session-factory sqlalchemy-async-repositories
 pip install fastapi-config-patterns fastapi-middleware-toolkit
 pip install python-structlog-config python-outbox-core

examples/README.md

@@ -72,7 +72,7 @@ pip install python-structlog-config>=0.1.0
 pip install python-infrastructure-exceptions>=0.1.0
 pip install python-dto-mappers>=0.1.0
 pip install python-cqrs-core>=0.1.0
-pip install python-mediator>=0.1.0
+pip install gridflow-python-mediator>=0.1.0
 pip install python-cqrs-dispatcher>=0.1.0
 pip install python-outbox-core>=0.1.0
 ```

examples/infrastructure/application-patterns.md

@@ -64,8 +64,8 @@ user = await query_handler.handle(query)
 Generic mediator with logging, timing, and validation behaviors for cross-cutting concerns.
 
 ```python
-from python_mediator import Mediator
-from python_mediator.behaviors import (
+from gridflow_python_mediator import Mediator
+from gridflow_python_mediator.behaviors import (
     LoggingBehavior,
     TimingBehavior,
     ValidationBehavior,

packages/python-mediator/README.md …kages/gridflow-python-mediator/README.mdpackages/python-mediator/README.md renamed to packages/gridflow-python-mediator/README.md packages/python-mediator/README.md renamed to packages/gridflow-python-mediator/README.md

@@ -1,4 +1,4 @@
-# Python Mediator
+# gridflow-python-mediator
 
 Generic mediator pattern implementation with zero dependencies and pipeline behavior support.
 
@@ -8,10 +8,10 @@ Generic mediator pattern implementation with zero dependencies and pipeline beha
 
 ```bash
 # Core (zero dependencies)
-pip install python-mediator
+pip install gridflow-python-mediator
 
 # With logging support
-pip install python-mediator[logging]
+pip install gridflow-python-mediator[logging]
 ```
 
 ## Features
@@ -26,7 +26,7 @@ pip install python-mediator[logging]
 ### Basic Mediator
 
 ```python
-from python_mediator import Mediator
+from gridflow_python_mediator import Mediator
 
 # Define request and handler
 class GetUserRequest:
@@ -51,7 +51,7 @@ result = await mediator.send(request)
 
 ```python
 from python_cqrs_core import BaseCommand, ICommandHandler
-from python_mediator import Mediator
+from gridflow_python_mediator import Mediator
 
 class CreateUserCommand(BaseCommand):
     name: str
@@ -72,7 +72,7 @@ user_id = await mediator.send(cmd)
 ### Pipeline Behaviors
 
 ```python
-from python_mediator import (
+from gridflow_python_mediator import (
     Mediator,
     LoggingBehavior,
     TimingBehavior,