neurocore.cli.runs_cmd
======================

.. py:module:: neurocore.cli.runs_cmd

.. autoapi-nested-parse::

   neurocore runs — inspect, replay, resume, and approve execution history.

   Usage:
       neurocore runs list [--status suspended] [--blueprint research] [--limit 20]
       neurocore runs inspect <run_id> [--full] [--json]
       neurocore runs replay <run_id>
       neurocore runs resume <run_id> [--data key=value ...]
       neurocore runs approve <run_id> [--reject] [--note "..."] [--by you@example.com]



Attributes
----------

.. autoapisummary::

   neurocore.cli.runs_cmd.console
   neurocore.cli.runs_cmd.output_console
   neurocore.cli.runs_cmd.runs_app


Functions
---------

.. autoapisummary::

   neurocore.cli.runs_cmd.runs_list
   neurocore.cli.runs_cmd.runs_inspect
   neurocore.cli.runs_cmd.runs_replay
   neurocore.cli.runs_cmd.runs_resume
   neurocore.cli.runs_cmd.runs_approve


Module Contents
---------------

.. py:data:: console

.. py:data:: output_console

.. py:data:: runs_app

.. py:function:: runs_list(status: Optional[str] = typer.Option(None, '--status', '-s', help='Filter by status.'), blueprint: Optional[str] = typer.Option(None, '--blueprint', '-b', help='Filter by blueprint name.'), limit: int = typer.Option(50, '--limit', '-n', help='Max rows.'), project_root: Optional[pathlib.Path] = typer.Option(None, '--project-root', '-p')) -> None

   List recorded runs (newest first).


.. py:function:: runs_inspect(run_id: str = typer.Argument(help='Run id (full or unique prefix).'), full: bool = typer.Option(False, '--full', help='Show the final context data.'), output_json: bool = typer.Option(False, '--json', '-j', help='Emit JSON.'), project_root: Optional[pathlib.Path] = typer.Option(None, '--project-root', '-p')) -> None

   Show a run's details and step history.


.. py:function:: runs_replay(run_id: str = typer.Argument(help='Run id (full or unique prefix).'), project_root: Optional[pathlib.Path] = typer.Option(None, '--project-root', '-p')) -> None

   Re-execute a stored run from its original inputs (creates a new run).


.. py:function:: runs_resume(run_id: str = typer.Argument(help='Run id (full or unique prefix).'), data: list[str] = typer.Option([], '--data', '-d', help='resume_data as KEY=VALUE pairs.'), project_root: Optional[pathlib.Path] = typer.Option(None, '--project-root', '-p')) -> None

   Resume a suspended or failed run.


.. py:function:: runs_approve(run_id: str = typer.Argument(help='Run id (full or unique prefix).'), reject: bool = typer.Option(False, '--reject', help='Reject instead of approve.'), note: str = typer.Option('', '--note', help='Optional decision note.'), by: str = typer.Option('', '--by', help='Who made the decision.'), project_root: Optional[pathlib.Path] = typer.Option(None, '--project-root', '-p')) -> None

   Approve (or --reject) a suspended approval gate and resume the run.