__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/registry/regenerate/__init__.py
 
# OCT-LINT: disable=tests_exist reason="Covered by oc_chat/tests/registry/regenerate/*"
"""
The deterministic source -> store rebuild pipeline (Plan 142 P1.4 — the spine).
 
Purpose
-------
Assemble the P1.1 models + P1.3 scanner/canonical/hashing into the 7-step
``regenerate`` pipeline (Registry Source & Storage Spec V0.22 §5.3/§5.3.1/§10):
scan -> parse/load -> local schema -> canonicalisation-check -> source_hash ->
cross-record -> temp-DB build + derive-verify + verification-stamp publish-gate +
WAL-safe atomic swap.
 
Responsibilities
----------------
- Home for the build / cross-record / derive-verify / verified-projection /
  envelope / pipeline modules + the promoted-item load model.
- Run the P1.3 contracts bootstrap so ``option_c_registry_contracts`` imports.
 
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 - package lifecycle
    L3 - submodule wiring
    L4 - bootstrap details
 
Contracts
---------
- Importing any submodule first runs the P1.3 contracts bootstrap.
- The pipeline never reads or writes the shared main-repo registry.
 
Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
- oc_chat.registry.source (scanner/canonical/hashing; runs the contracts bootstrap)
"""
from __future__ import annotations
 
import oc_chat.registry.source  # noqa: F401  (runs the contracts bootstrap)
 
from oc_diagnostics import _dbg
 
_dbg("OC_CHAT.MAIN", "module", "loaded", 4)