hub.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/core/hub.py
 
# OCT-LINT: disable=tests_exist reason="Re-export shim; the module it names is covered by oc_orchestrator/tests/, and this path by test_272_hub_shims.py"
"""
The hub's contract. — moved to :mod:`oc_orchestrator.hub`.
 
Purpose
-------
Plan 272 P4, in the shape plans 270 and 271 established. This module's
code now lives in the standalone ``oc_orchestrator`` package; this file
keeps ``oc_chat.core.hub`` working for every importer that has always
spelled it that way.
 
It is a REBINDING, not a wrapper: the last statement replaces this
module's entry in :data:`sys.modules` with the moved module itself, so
``oc_chat.core.hub`` and ``oc_orchestrator.hub`` are one object. That is
what keeps every private name reachable, every ``monkeypatch`` effective
across the seam, and every ``isinstance`` true — a wrapper that merely
re-exported public names would break all three quietly. The concrete
reason here is narrower than the queue's but no weaker: ``core/hub_bus``
and ``registry/hub_log`` build :class:`HubMessage` and
:class:`HubEntry` objects that the moved ``Hub`` then handles, and
``tests/unit/test_259_dispatch_hooks.py`` reaches the file log through
THIS path while the hooks it drives reach it through the package's.
Two bindings would make those ``isinstance`` checks answer differently
depending on which import a caller happened to use.
 
Responsibilities
----------------
- Bind the moved module to this path. Nothing else: no behaviour, no
  defaults, no wiring. ``scripts/hub_manage.py`` is the shim that carries
  oc_chat's wiring, because only it has defaults — the program name and
  the registry log factory — that differ from the package's.
 
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 - lifecycle events
    L3 - semantic details
    L4 - deep tracing (the rebinding)
 
Contracts
---------
- Retirement rule (plan 272 P4, the plan-270 rule carried forward): this
  path stays until an explicit retirement plan retargets its importers.
  Nothing new should import it — new code names ``oc_orchestrator.hub``
  directly.
- Adds no behaviour of its own, so it can never drift from the module
  it names.
 
Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
- oc_orchestrator.hub (the moved module this path binds)
"""
 
from __future__ import annotations
 
import sys
 
from oc_diagnostics import _dbg
 
from oc_orchestrator import hub as _moved
 
_dbg("OC_CHAT.MAIN", "module", "hub shim -> oc_orchestrator.hub", 4)
 
sys.modules[__name__] = _moved