run

type Options struct {
	Config *config.Config
	// Enricher fills descriptions for brand-new fields in sync mode. Nil skips
	// the step entirely (descriptions stay blank). Ignored by Check.
	Enricher enrich.Enricher
	// Stderr receives the extraction command's stdout+stderr chatter, so the
	// rendered report on the real stdout stays clean. Defaults to os.Stderr.
	Stderr io.Writer
}

type Result struct {
	Report         *diff.Report
	RenderedReport string // per Config.Report (text | md | json)
	Patches        []patch.Patch
	Applied        int
	Failed         []applier.Failure
	Corrected      []byte // sync only: the rewritten published spec
	// ExitCode is the process exit code check should use, per Config.FailOn.
	// Always 0 for Sync (the PR is the gate).
	ExitCode int
}