scale

type Appearance struct {
	Page  int
	X, Y  int
	Color [3]uint8
}

type BlankStyles int

type DescriptorCeiling struct {
	NativeCompilerIdentity

	SourceSHA256       string `json:"source_sha256"`
	LauncherSHA256     string `json:"launcher_sha256"`
	BinarySHA256       string `json:"binary_sha256"`
	InvocationSHA256   string `json:"invocation_sha256"`
	Token              string `json:"token"`
	Hygiene            string `json:"hygiene"`
	PID                int    `json:"pid"`
	UID                int    `json:"uid"`
	EUID               int    `json:"euid"`
	GID                int    `json:"gid"`
	EGID               int    `json:"egid"`
	Soft               uint64 `json:"soft"`
	Hard               uint64 `json:"hard"`
	Device             uint64 `json:"device"`
	Inode              uint64 `json:"inode"`
	Bytes              int64  `json:"bytes"`
	Mode               uint64 `json:"mode"`
	RaiseErrno         int    `json:"raise_errno"`
	ControlCloseOnExec bool   `json:"control_cloexec"`
	HygieneConfigured  bool   `json:"hygiene_configured"`
}

type DescriptorCollectorIdentity struct {
	NativeCompilerIdentity

	ReadinessStarted  time.Time `json:"readiness_started"`
	ReadinessFinished time.Time `json:"readiness_finished"`
	ReadinessFrame    string    `json:"readiness_frame"`

	SourceSHA256 string `json:"source_sha256"`
	BinarySHA256 string `json:"binary_sha256"`
	ReadinessPID int    `json:"readiness_pid"`
}

type Measurement struct {
	DescriptorCollector *DescriptorCollectorIdentity `json:"descriptor_collector,omitempty"`
	DescriptorCeiling   *DescriptorCeiling           `json:"descriptor_ceiling,omitempty"`
	ObserverRetries     ObserverRetryEvidence
	Stdout              string
	Stderr              string
	// RSSState is valid, unavailable, or error; an error includes any failed intermediate RSS sample.
	RSSState string
	// DescriptorState is valid only when every attempted live-process sample succeeds.
	DescriptorState string
	ReadingFailures []ReadingFailure
	Wall            time.Duration
	PeakRSSBytes    int64
	MaxDescriptors  int64
	// DescriptorSamples counts successful readings. SampleAttempts also includes failures.
	TerminalSamples           int64
	DescriptorTerminalSamples int64
	DescriptorSamples         int64
	SampleAttempts            int64
	// DescriptorCoverage is the observed temporal span divided by launch-to-exit wall time, not exhaustive coverage.
	DescriptorCoverage float64
	PeakScratchBytes   int64
	ExitCode           int
}

type NativeCompilerIdentity struct {
	Compiler       string `json:"compiler"`
	CompilerPath   string `json:"compiler_path"`
	CompilerSHA256 string `json:"compiler_sha256"`
	SDK            string `json:"sdk,omitempty"`
}

type ObserverRetryEvidence struct {
	First time.Time `json:"first,omitzero"`
	Last  time.Time `json:"last,omitzero"`
	Cause string    `json:"cause,omitempty"`
	Count int64     `json:"count"`
}

type ReadingFailure struct {
	ProofWaitStarted  time.Time `json:"proof_wait_started,omitzero"`
	ProofWaitFinished time.Time `json:"proof_wait_finished,omitzero"`
	ReadStarted       time.Time `json:"read_started"`
	ReadFinished      time.Time `json:"read_finished"`
	Metric            string    `json:"metric"`
	Phase             string    `json:"phase"`
	Cause             string    `json:"cause"`
	Stderr            string    `json:"stderr,omitempty"`
	Stdout            string    `json:"stdout,omitempty"`
	Probe             string    `json:"probe,omitempty"`
	ExitCode          int       `json:"exit_code"`
	NativeCode        uint64    `json:"native_code,omitempty"`
}

type RunSpec struct {
	// Binary is the executable to run.
	Binary string
	// Dir is the working directory.
	Dir string
	// ScratchDir is a directory whose total file size is sampled while the process runs; the executable
	// puts its private workspace beside the output, so this is the output directory.
	ScratchDir string
	// Stdin, when not nil, is the process's standard input.
	Stdin io.Reader
	// Env is the process environment; nil inherits this process's.
	Env []string
	// OnSample, when not nil, is called from the sampling goroutine each time a reading of the running
	// process, and of ScratchDir, is complete. A caller that keeps the process alive until it has been
	// read counts the calls instead of guessing how long a reading takes.
	OnSample func()
	// Args are the command-line arguments after the executable's name.
	Args []string
	// DescriptorLimit, when not zero, caps the process's open descriptors on Unix, where exceeding it
	// makes its opens fail; Windows only samples handles.
	DescriptorLimit uint64
}

type Verification struct {
	// Findings are the failed oracle checks and appearance mismatches; empty means the output is right.
	Findings []string
	// Elapsed is how long qpdf, pdftotext and pdftoppm took; it is excluded from the run's measurement.
	Elapsed time.Duration
	// Pages and Objects are the output's page and object counts as qpdf sees them.
	Pages, Objects int
}

type VisualSource struct {
	Path                   string
	SourcePage, OutputPage int
}

type Workload struct {
	// Name identifies the case in results.
	Name string
	// Dir is the directory holding the plan's sources; the executable runs with it as working directory.
	Dir string
	// Plan is the plan JSON.
	Plan []byte
	// Expectation is what the oracle must find in the output.
	Expectation pdforacle.Expectation
	// Appearances lists generated-page appearances to verify by rendering a sample page of each.
	Appearances []Appearance
	// VisualSources samples original image-bearing source pages in the assembled output.
	VisualSources []VisualSource
	// FullTexts verifies long text after whitespace normalization of independent extraction.
	FullTexts map[int]string

	// Pages is the expected number of output pages.
	Pages int
	// SourceFiles and InputBytes describe the input corpus, filled in by Write.
	SourceFiles int
	InputBytes  int64
	// contains filtered or unexported fields
}