__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/registry/source/__init__.py
 
# OCT-LINT: disable=tests_exist reason="Covered by oc_chat/tests/registry/source/*"
"""
Registry AuthoredSource format engine (Plan 142 P1.3).
 
Purpose
-------
Provide the closed-world scanner, the canonical YAML dumper, and the three
hash projections for the ``oc_chat/roadmap/source/**`` AuthoredSource tree, per
the Registry Source & Storage Spec V0.22 §3.1/§3.2/§10. These are the building
blocks the ``regenerate`` pipeline (P1.4) orchestrates.
 
Responsibilities
----------------
- Expose the source subpackage as the home for ``scanner``/``canonical``/
  ``hashing``/``errors`` modules (the entity models live in the installed
  ``option_c_registry_contracts`` sibling, P1.1).
 
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 - package lifecycle
    L3 - contracts-bootstrap decisions
    L4 - sys.path mutation details
 
Contracts
---------
- ``from option_c_registry_contracts import ...`` resolves via the installed
  sibling package (Plan 151 T7/B1 — no sys.path bootstrap).
- The submodules never write outside a caller-provided source tree.
 
Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
"""
from __future__ import annotations
 
from oc_diagnostics import _dbg
 
# ``option_c_registry_contracts`` is installed editable as a monorepo sibling
# (Plan 151 T7/B1 gave RC its real install + promoted the contracts packages to
# ``contracts/``); a plain ``from option_c_registry_contracts import ...``
# resolves the real package directly. The flat-layout sys.path bootstrap that
# lived here was retired atomically with that install.
 
_dbg("OC_CHAT.MAIN", "module", "loaded", 4)