capture

type Options struct {
	Tag                         string
	Only                        string // glob over request IDs
	Force                       bool   // replace an existing capture with this tag
	AllowRemote                 bool   // allow a target outside allow_hosts
	AllowRemoteMutations        bool   // and send requests that change data to it
	AllowMutatingWithoutRestore bool
	Restore                     string        // once (default): before the run and before the requests that change data; each: also before every sequence
	Baseline                    *snapshot.Set // the state must match the one this baseline was captured from
	SkipFingerprintCheck        bool
	Out                         io.Writer // progress
	Log                         io.Writer // output of hook commands
	Env                         []string  // added to the environment of the project's commands (bisect: the commit)
	// Concurrency replaces the configured concurrency of the services it
	// names (the decision of concurrency: auto); it applies to the
	// read-only requests only, as every concurrency does.
	Concurrency map[string]int
}

type ProbeOptions struct {
	Services    []string // canonical names
	Requests    int      // read-only requests sent at each setting
	Max         int      // the highest setting tried
	AllowRemote bool
	Out, Log    io.Writer
	Env         []string
}

type SeedOptions struct {
	// SkipCommands copies the working state as it is, without the seed:
	// commands: the data was loaded another way (a cached dump in CI).
	SkipCommands bool
	Out, Log     io.Writer
}

type Summary struct {
	Requests     int
	Failed       []string                 // requests whose transport failed
	Personal     map[string][]pii.Finding // public requests whose body held personal data or credentials (stored as private)
	Unscanned    map[string]string        // public requests whose body could not be scanned, and why (stored as private)
	Tracked      bool                     // side effects were recorded
	Writers      map[string][]string      // read-only requests that changed the state → items
	Unattributed []string                 // items read-only requests changed that no single request explains
	Time         Time                     // where the time went
}

type Throughput struct {
	Concurrency int
	Requests    int
	Duration    time.Duration
}

type Time struct {
	Total, Fingerprint, Restore time.Duration
	Fingerprints, Reused        int // fingerprints taken, and those a check of the write counters made unnecessary
}