plan_metadata.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/core/plan_metadata.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_257_dispatcher_seams.py"
"""
One reader for a plan file's header conventions. — moved to :mod:`oc_orchestrator.plan_metadata`.
 
Purpose
-------
Plan 270 P4. This module's code now lives in the standalone
``oc_orchestrator`` package; this file keeps ``oc_chat.core.plan_metadata``
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.plan_metadata`` and ``oc_orchestrator.plan_metadata`` 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.
 
Responsibilities
----------------
- Bind the moved module to this path. Nothing else: no behaviour, no
  defaults, no wiring. The two CLI shims (``scripts/plan_status.py`` and
  ``scripts/plan_manage.py``) are the ones that carry oc_chat's wiring,
  because only they have defaults 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 270 P8): this path stays until an explicit
  retirement plan retargets its importers. Nothing new should import
  it — new code names ``oc_orchestrator.plan_metadata`` 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.plan_metadata (the moved module this path binds)
"""
 
from __future__ import annotations
 
import sys
 
from oc_diagnostics import _dbg
 
from oc_orchestrator import plan_metadata as _moved
 
_dbg("OC_CHAT.MAIN", "module", "plan_metadata shim -> oc_orchestrator.plan_metadata", 4)
 
sys.modules[__name__] = _moved