__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/registry/round/__init__.py
 
# OCT-LINT: disable=tests_exist reason="Re-export surface; covered by oc_chat/tests/registry/test_round_*.py"
"""
Public surface for the round-close orchestration subpackage.
 
Purpose
-------
Re-export the round-close state machine, executors, escalation contract,
and resume protocol so callers import from a single stable namespace
(``oc_chat.registry.round``) rather than reaching into private modules.
 
Responsibilities
----------------
- Expose the driver entry points (run_round_close, resume_round, drive_steps).
- Expose the executor context and dataclasses (RoundContext, PlanSpec, ...).
- Expose the escalation contract and conflict policy types.
 
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 - lifecycle events
    L3 - semantic details
    L4 - module load tracing
 
Contracts
---------
- This module only re-exports; it holds no behavior of its own.
- ``__all__`` is the stable public surface for the subpackage.
 
Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
- oc_chat.registry.round.conflict (re-exports the conflict policy types)
- oc_chat.registry.round.escalation (re-exports the escalation contract)
- oc_chat.registry.round.executors (re-exports the executor context, result types and run_* executors)
- oc_chat.registry.round.git_shim (re-exports the GitShim seam, GitError and MergeResult)
- oc_chat.registry.round.preflight (re-exports the open and resume preflight checks)
- oc_chat.registry.round.resume (re-exports resume_round)
- oc_chat.registry.round.state_machine (re-exports the round-close driver entry points)
"""
from __future__ import annotations
 
from oc_diagnostics import _dbg
 
from oc_chat.registry.round.conflict import (
    ConflictDecision,
    ConflictPolicy,
    ConflictStrategy,
)
from oc_chat.registry.round.escalation import (
    Escalation,
    EscalationCode,
    RoundEscalation,
    make_escalation,
    resume_command_for,
)
from oc_chat.registry.round.executors import (
    LintRunResult,
    PlanSpec,
    RoundContext,
    StepOutcome,
    TestRunResult,
    run_abort,
    run_cleanup,
    run_consolidate,
    run_ff_main,
    run_lint,
    run_merge,
    run_open,
    run_rollback,
    run_test,
)
from oc_chat.registry.round.git_shim import GitError, GitShim, MergeResult
from oc_chat.registry.round.preflight import (
    PreflightResult,
    preflight_open,
    preflight_resume,
)
from oc_chat.registry.round.resume import resume_round
from oc_chat.registry.round.state_machine import (
    RoundCloseResult,
    StepDef,
    build_step_plan,
    create_close_job,
    drive_steps,
    new_job_id,
    run_round_close,
)
 
_dbg("OC_CHAT.MAIN", "module", "loaded", 4)
 
__all__ = [
    # state machine / driver
    "RoundCloseResult",
    "StepDef",
    "build_step_plan",
    "create_close_job",
    "drive_steps",
    "new_job_id",
    "run_round_close",
    # resume protocol
    "resume_round",
    # executors
    "RoundContext",
    "PlanSpec",
    "StepOutcome",
    "TestRunResult",
    "LintRunResult",
    "run_open",
    "run_merge",
    "run_test",
    "run_lint",
    "run_consolidate",
    "run_ff_main",
    "run_cleanup",
    "run_abort",
    "run_rollback",
    # escalation contract
    "Escalation",
    "EscalationCode",
    "RoundEscalation",
    "make_escalation",
    "resume_command_for",
    # conflict policy
    "ConflictDecision",
    "ConflictPolicy",
    "ConflictStrategy",
    # git seam
    "GitShim",
    "GitError",
    "MergeResult",
    # preflight
    "PreflightResult",
    "preflight_open",
    "preflight_resume",
]