testutil

type BaselineMetadata struct {
	// DAWGSVersion identifies the DAWGS build that produced the baseline.
	DAWGSVersion string `json:"dawgs_version"`
}

type EndpointSeededExpansionScaleConfig struct {
	// Depth sets the number of MemberOf hops in each lane.
	Depth int

	// MatchingEndpoints sets the number of terminal groups whose object IDs
	// satisfy the benchmark predicate.
	MatchingEndpoints int

	// OtherEndpoints sets the number of terminal groups that do not satisfy the
	// benchmark predicate.
	OtherEndpoints int

	// MatchingEligibleLanes sets the number of session-backed lanes ending at a
	// matching endpoint.
	MatchingEligibleLanes int

	// OtherEligibleLanes sets the number of session-backed lanes ending at a
	// nonmatching endpoint.
	OtherEligibleLanes int

	// MatchingIneligibleLanes sets the number of lanes without a session edge
	// that nevertheless end at a matching endpoint.
	MatchingIneligibleLanes int

	// ParallelEdges sets the number of MemberOf edges emitted per lane hop.
	ParallelEdges int

	// AddCycle adds a reverse MemberOf edge near the middle of every lane.
	AddCycle bool

	// PropertyPayloadSize sets the length of synthetic payload properties.
	PropertyPayloadSize int
}

type FixedSuffixExpansionScaleConfig struct {
	// ExpansionDepth sets the number of Expand hops in each branch.
	ExpansionDepth int

	// Fanout sets the number of expansion branches rooted at the fixture root.
	Fanout int

	// ValidSuffixEvery attaches a suffix to every nth legacy branch.
	ValidSuffixEvery int

	// PropertyPayloadSize sets the length of synthetic payload properties.
	PropertyPayloadSize int

	// ExactReachableSuffixSources decouples reachable suffix density from the
	// legacy modulus control. Nil preserves ValidSuffixEvery behavior; zero is
	// an exact zero and is therefore materially different from nil.
	ExactReachableSuffixSources *int

	// ReachableSuffixDepths restricts suffix attachment to the listed expansion
	// depths when nonempty.
	ReachableSuffixDepths []int

	// DisconnectedSuffixSources sets the number of suffix sources unreachable
	// from any expansion root.
	DisconnectedSuffixSources int

	// ReverseFanIn sets the number of decoy Expand edges entering a productive
	// branch boundary.
	ReverseFanIn int

	// SuffixPathsPerBoundary sets the number of distinct suffix paths attached
	// to each selected boundary.
	SuffixPathsPerBoundary int

	// RootMatchCount sets the number of roots matching the fixture root key.
	RootMatchCount int

	// RootHasZeroDepthSuffix controls whether the primary root has a suffix;
	// nil preserves the enabled default.
	RootHasZeroDepthSuffix *bool

	// AddProductiveBoundaryCycle adds a two-edge Expand cycle at the
	// deterministic productive boundary. The two physical relationships have
	// distinct endpoints and logical keys, so the cycle can be traversed once
	// in either relationship-distinct expansion direction.
	AddProductiveBoundaryCycle bool

	// AddProductiveBoundarySelfLoop adds one Expand self-loop at the
	// deterministic productive boundary.
	AddProductiveBoundarySelfLoop bool
}

type GeneratedNodeListParam struct {
	// Prefix is prepended to each generated node identifier.
	Prefix string `json:"prefix"`

	// Count is the number of sequential identifiers to generate.
	Count int `json:"count"`

	// Include lists literal identifiers to place before generated identifiers.
	Include []string `json:"include,omitempty"`
}

type Params map[string]any

type ShortestPathScaleConfig struct {
	// Depth sets the length of the fixture's unique linear route.
	Depth int

	// Fanout sets the number of dead ends attached to the route's start.
	Fanout int
}

type ShortestPathScaleV2Config struct {
	// Depth sets the number of edges in each primary path.
	Depth int

	// ForwardRootFanOut sets the number of forward dead ends at the primary
	// start node.
	ForwardRootFanOut int

	// ReverseRootFanIn sets the number of reverse dead ends entering the inbound
	// root node.
	ReverseRootFanIn int

	// IntermediateFanOut sets the number of forward dead ends at FanInLevel.
	IntermediateFanOut int

	// IntermediateReverseFanIn sets the number of reverse dead ends entering
	// the inbound path at FanInLevel.
	IntermediateReverseFanIn int

	// FanInLevel selects the intermediate level used for fanout and reverse
	// fan-in decoys.
	FanInLevel int

	// ParallelKindCount sets the number of distinct relationship kinds between
	// each parallel start and target pair.
	ParallelKindCount int

	// ParallelTargetCount sets the number of targets in the parallel-edge
	// subgraph.
	ParallelTargetCount int

	// DiamondWidth sets the number of equal-length branches in the diamond
	// subgraph.
	DiamondWidth int

	// DisconnectedWidth sets the number of intermediate nodes in the
	// disconnected path.
	DisconnectedWidth int

	// PropertyPayloadSize sets the length of synthetic payload properties.
	PropertyPayloadSize int

	// AddCycle includes a reachable two-node cycle.
	AddCycle bool

	// AddSelfLoop includes a reachable self-loop.
	AddSelfLoop bool
}