# CorpusFetch Method Slice (Zero-Prose Python Stdlib Reference)
# Canonical Residual: https://corpusfetch.com/c/when-must-an-instance-refuse-to-commit-a-speculative-agent-branch-after-a-rollback-has-already-touched-shared-state.md
# Remnant Warrant:    https://corpusfetch.com/c/when-must-an-instance-refuse-to-commit-a-speculative-agent-branch-after-a-rollback-has-already-touched-shared-state.warrant.json
# Markdown SHA-256:   2bfc1599c6ec138cb111ab6a43ff8a50816827a627b0c62c3ec0352631ddcf14
# Code AST SHA-256:   ddbd386d68a8f278a4e7acdc77e2e34c982704445949ea558997ee9a95ee5809
# Verified Classes:   DirtyReadCommitError, BranchState
# Defensive Guards:   4 fail-closed invariants (zero external deps)

class DirtyReadCommitError(RuntimeError):
    """Raised when a branch is committed after a physical rollback touched state it read."""
    pass


class BranchState:
    def __init__(self, branch_id, read_keys, journaled_writes, external_side_effects_deferred):
        self.branch_id = branch_id
        self.read_keys = read_keys
        self.journaled_writes = journaled_writes
        self.external_side_effects_deferred = external_side_effects_deferred


def reconcile_commit(branch, rollback_barrier, shared_store):
    # rollback_barrier: set of keys physically rolled back since branch.read_keys were observed
    # shared_store: current state; keys may be absent after rollback
    if not branch.journaled_writes:
        raise DirtyReadCommitError(
            f"branch {branch.branch_id} has non-invertible writes; refusing physical rollback path"
        )

    touched = branch.read_keys & rollback_barrier
    if touched:
        # A physical rollback invalidated the world this branch was validated against.
        # Re-execution is required; direct commit would commit stale observations.
        raise DirtyReadCommitError(
            f"branch {branch.branch_id} read {sorted(touched)} which was physically rolled back "
            f"after the read; re-execute against post-rollback state before commit"
        )

    # Existence/version check, not value equality: absent is a conflict, not a pass.
    for key, observed_version in branch.read_keys.items():
        current = shared_store.get(key)
        if current is None or current.version != observed_version:
            raise DirtyReadCommitError(
                f"branch {branch.branch_id} precondition failed on {key}: "
                f"observed version {observed_version}, current {getattr(current, 'version', None)}"
            )

    if not branch.external_side_effects_deferred:
        raise DirtyReadCommitError(
            f"branch {branch.branch_id} issued external side-effects before commit; "
            f"rollback cannot compensate them safely"
        )

    return {"committed": branch.branch_id, "status": "ok"}
