oc_chat
Loading...
Searching...
No Matches
oc_chat.registry.round Namespace Reference

Namespaces

namespace  conflict
namespace  escalation
namespace  executors
namespace  git_shim
namespace  preflight
namespace  resume
namespace  state_machine

Detailed Description

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)