neurocore.persistence.base.RunStore
===================================

.. py:class:: neurocore.persistence.base.RunStore

   Bases: :py:obj:`abc.ABC`


   Abstract durable store for run history.

   Implementations: :class:`~neurocore.persistence.sqlite_store.SQLiteRunStore`
   (default) and :class:`~neurocore.persistence.memory_store.InMemoryRunStore`
   (tests).


   .. py:method:: save_run(run: RunRecord) -> str
      :abstractmethod:


      Insert or update a run by ``run_id``. Returns the run_id.



   .. py:method:: save_step(step: StepRecord) -> None
      :abstractmethod:


      Insert or update a step by ``(run_id, step_index)``.



   .. py:method:: load_run(run_id: str) -> RunRecord | None
      :abstractmethod:


      Load a run by id, or None if not found.



   .. py:method:: load_steps(run_id: str) -> list[StepRecord]
      :abstractmethod:


      Load a run's steps, ordered by step_index.



   .. py:method:: list_runs(*, status: RunStatus | None = None, blueprint: str | None = None, limit: int = 50) -> list[RunRecord]
      :abstractmethod:


      List runs newest-first, optionally filtered by status/blueprint.



   .. py:method:: delete_run(run_id: str) -> None
      :abstractmethod:


      Delete a run and its steps.



   .. py:method:: close() -> None

      Release any underlying resources (no-op by default).