contention

const (
	// TransportSim is the in-memory [sim.SimListener] pipe every committed
	// Bolt workload runs over.
	TransportSim = "sim"
	// TransportTCP is a real loopback socket on 127.0.0.1.
	TransportTCP = "tcp"

	// TransportSimReadDeadlineCleared converts the server's per-read deadline
	// to the zero Time: the mutex and Broadcast still happen, the per-wait
	// timer and goroutine do not.
	TransportSimReadDeadlineCleared = "sim-rdl-clear"
	// TransportSimReadDeadlineDropped drops the per-read deadline call
	// entirely: neither the Broadcast nor the per-wait timer happens.
	TransportSimReadDeadlineDropped = "sim-rdl-drop"
	// TransportSimWriteDeadlineDropped drops the per-record write deadline
	// call entirely, which on the pipe is one mutex acquisition and one
	// spurious Broadcast per record.
	TransportSimWriteDeadlineDropped = "sim-wdl-drop"
	// TransportSimNoDeadlines drops both.
	TransportSimNoDeadlines = "sim-no-dl"
	// TransportTCPNoDeadlines drops both on the socket. It is the CONTROL: the
	// same removal, on a transport where the deadline is cheap, must buy
	// little or nothing. Without it, a gain on the pipe arms could be the
	// removal of any per-message work rather than of the pipe's own.
	TransportTCPNoDeadlines = "tcp-no-dl"

	// TransportCommitted is not a transport at all: it is the COMMITTED
	// workload of the same shape, taken straight from [ByName], driven through
	// this campaign's replica machinery.
	//
	// It is the FIDELITY control, and it is here because without it the whole
	// campaign rests on an unchecked assumption. The sim arm is built to stand
	// in for bolt-wire-rows and bolt-wire-read, but it is not identical to
	// them: it discards the server log where they let it fall through to
	// slog.Default, it pre-dials its connections where they dial lazily inside
	// the first operation, and it reaches the client through
	// [sim.NewWireClientNetConn] rather than [sim.NewWireClient]. Whether those
	// three differences move the number is a question, not a given — and it
	// became a live one when the sim arm read 0.920 at level 8 against the
	// published bolt-wire-rows row's 1.087.
	//
	// The arm overrides the committed workload's Ops with this campaign's, so
	// the two arms do the same total work. A scaling ratio is a rate and is
	// therefore invariant to that, but the WALL CLOCK of a cell is not, and two
	// arms of one interleaved campaign must cost the same or the interleaving
	// stops being balanced.
	TransportCommitted = "committed"

	// TransportSimLazyDial dials each worker's connection inside its FIRST
	// operation through a padded [perWorker] table, exactly as boltClient
	// does, instead of pre-dialling every connection in Setup.
	TransportSimLazyDial = "sim-lazydial"
	// TransportSimDefaultLog leaves Options.Logger nil, so server.NewServer
	// falls through to slog.Default as [sim.NewSimServer] does, instead of
	// installing a discarding handler.
	TransportSimDefaultLog = "sim-defaultlog"
	// TransportSimConnClient builds the client with [sim.NewWireClient] over
	// the concrete *SimConn, as every committed Bolt workload does, instead of
	// [sim.NewWireClientNetConn] over the net.Conn interface.
	TransportSimConnClient = "sim-simconn-client"

	// TransportTCPLazyDial is [TransportSimLazyDial] on the socket, and it is
	// REQUIRED, not optional.
	//
	// The bisect above found that dialling in Setup rather than inside the
	// worker's first operation costs the pipe arm 25% of its level-8
	// throughput. If that penalty is a property of the pipe, then a pre-dialled
	// sim arm compared against a pre-dialled tcp arm understates the pipe and
	// inflates the headline. The A/B must therefore be taken with the dial site
	// held constant AND known to be neutral on both sides, which is what this
	// arm establishes.
	TransportTCPLazyDial = "tcp-lazydial"
)