oc_chat.registry.cli.round Namespace Reference

Functions
None	add_round_subcommands (argparse.ArgumentParser round_parser)
int	_cmd_round_group (argparse.Namespace args)
str	_interactive_prompter (StepDef step, RoundContext _ctx)
int	_cmd_close (argparse.Namespace args)
int	_cmd_resume (argparse.Namespace args)
int	_cmd_abort (argparse.Namespace args)
int	_cmd_status (argparse.Namespace args)
RoundContext	_build_context (argparse.Namespace args)
list[PlanSpec]	_parse_plan_specs (list[str] raw_specs)
	_default_test_runner (Path repo_dir)
	_default_lint_runner (Path repo_dir)
	_default_roadmap_bumper (str actor_slot, str actor_type)
int	_render_result (RoundCloseResult result)
str	_resolve_orchestrator (SQLiteBackend backend, str|None actor_slot)
str	_actor_type_for_slot (SQLiteBackend backend, str slot)
tuple[Registry, SQLiteBackend]	_registry (str|None registry_path)
None	_add_common (argparse.ArgumentParser parser)

Detailed Description

Registry-native round-close commands.

Purpose
-------
Expose the seven-phase round-close orchestration beneath
``python -m oc_chat.registry round``: close, resume, abort, and status.

Responsibilities
----------------
- Parse round-close command arguments and plan specs.
- Resolve the registry, orchestrator actor, and the git seam.
- Drive run_round_close / resume_round / run_abort and render results.
- Render the versioned escalation document when a job stops.

Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 - lifecycle events
    L3 - semantic details
    L4 - deep tracing

Contracts
---------
- ``status`` is read-only; it never mutates the registry or git.
- Interactive prompting is the default; ``--non-interactive`` disables it.

Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
- oc_chat.registry.backends.sqlite (SQLite backend)
- oc_chat.registry.discovery (registry path discovery)
- oc_chat.registry (Registry facade carried in the round context)
- oc_chat.registry.errors (PreflightFailedError reported by the resume command)
- oc_chat.registry.round.executors (round context, plan specs, test and lint results and run_abort)
- oc_chat.registry.round.git_shim (GitShim git seam over the workspace repository)
- oc_chat.registry.round.resume (resume_round for the resume command)
- oc_chat.registry.round.state_machine (run_round_close, step definitions and job ids)
- pytest (not imported; python -m pytest subprocess run by the default round-close test runner)
- oct_lint (not imported; python -m oct_lint subprocess run by the default round-close lint runner)

Function Documentation

_actor_type_for_slot()

str oc_chat.registry.cli.round._actor_type_for_slot ( SQLiteBackend backend, str slot )

protected

Definition at line 336 of file round.py.

Here is the caller graph for this function:

_add_common()

None oc_chat.registry.cli.round._add_common ( argparse.ArgumentParser parser )

protected

Definition at line 351 of file round.py.

Here is the caller graph for this function:

_build_context()

RoundContext oc_chat.registry.cli.round._build_context ( argparse.Namespace args )

protected

Definition at line 212 of file round.py.

Here is the call graph for this function:

Here is the caller graph for this function:

_cmd_abort()

int oc_chat.registry.cli.round._cmd_abort ( argparse.Namespace args )

protected

Definition at line 185 of file round.py.

Here is the call graph for this function:

_cmd_close()

int oc_chat.registry.cli.round._cmd_close ( argparse.Namespace args )

protected

Definition at line 159 of file round.py.

Here is the call graph for this function:

_cmd_resume()

int oc_chat.registry.cli.round._cmd_resume ( argparse.Namespace args )

protected

Definition at line 170 of file round.py.

Here is the call graph for this function:

_cmd_round_group()

int oc_chat.registry.cli.round._cmd_round_group ( argparse.Namespace args )

protected

Definition at line 147 of file round.py.

_cmd_status()

int oc_chat.registry.cli.round._cmd_status ( argparse.Namespace args )

protected

Definition at line 192 of file round.py.

Here is the call graph for this function:

_default_lint_runner()

oc_chat.registry.cli.round._default_lint_runner ( Path repo_dir )

protected

Definition at line 287 of file round.py.

Here is the caller graph for this function:

_default_roadmap_bumper()

oc_chat.registry.cli.round._default_roadmap_bumper ( str actor_slot, str actor_type )

protected

Definition at line 301 of file round.py.

Here is the caller graph for this function:

_default_test_runner()

oc_chat.registry.cli.round._default_test_runner ( Path repo_dir )

protected

Definition at line 267 of file round.py.

Here is the caller graph for this function:

_interactive_prompter()

str oc_chat.registry.cli.round._interactive_prompter ( StepDef step, RoundContext _ctx )

protected

Prompt the operator at a phase boundary; default is to continue.

Definition at line 152 of file round.py.

_parse_plan_specs()

list[PlanSpec] oc_chat.registry.cli.round._parse_plan_specs ( list[str] raw_specs )

protected

Definition at line 246 of file round.py.

Here is the caller graph for this function:

_registry()

tuple[Registry, SQLiteBackend] oc_chat.registry.cli.round._registry ( str | None registry_path )

protected

Definition at line 345 of file round.py.

Here is the caller graph for this function:

_render_result()

int oc_chat.registry.cli.round._render_result ( RoundCloseResult result )

protected

Definition at line 313 of file round.py.

Here is the caller graph for this function:

_resolve_orchestrator()

str oc_chat.registry.cli.round._resolve_orchestrator ( SQLiteBackend backend, str | None actor_slot )

protected

Definition at line 321 of file round.py.

Here is the caller graph for this function:

add_round_subcommands()

None oc_chat.registry.cli.round.add_round_subcommands

(

argparse.ArgumentParser

round_parser

)

Attach registry-native round-close subcommands.

Definition at line 82 of file round.py.

Here is the call graph for this function: