Method mark_committed

openkb/mutation.py:166–177

Mark the journal committed without removing the backup. Call this the instant the mutation is durably applied (e.g. the registry write has landed) so a subsequent :func:`recover_pending_journals` discards the journal instead of rolling it back. This is the commit sig

(self)

        atomic_write_json(self.journal_path, self._journal_data(status))

    def mark_committed(self) -> None:
        """Mark the journal committed without removing the backup.

        Call this the instant the mutation is durably applied (e.g. the
        registry write has landed) so a subsequent
        :func:`recover_pending_journals` discards the journal instead of
        rolling it back. This is the commit signal; :meth:`discard` is the
        post-commit cleanup that also removes the backup dir and journal
        file and must itself be best-effort — it runs *after* the commit
        point and its failure must never trigger a rollback.
        """
        self.write_journal("committed")

    def track_new(self, paths: list[Path]) -> None:
        """Register paths created *after* the snapshot for removal on rollback.