validation

type AuditOptions struct {
	// RootDir is the repository root directory.
	RootDir string

	// Strict promotes all advisory issues to blocking errors.
	Strict bool

	// Warn includes advisory violations in the output (exit 0).
	Warn bool

	// NoBaseline disables advisory baseline filtering.
	NoBaseline bool

	// StyleDebt includes legacy style debt in advisory output.
	StyleDebt bool

	// ContractDebt includes legacy contract debt in advisory output.
	ContractDebt bool
}

type AuditResult struct {
	// Blocking violations cause the validator to exit non-zero.
	Blocking []Violation

	// Advisory violations are informational warnings.
	Advisory []Violation
}

type AuditRow = ConsumerAuditRow

type CasingIssue struct {
	Description string
}

type ConsumerAuditOptions struct {
	// Schema repo root (required).
	RootDir string

	// Consumer repos. Empty = skip that consumer.
	MesheryRepo string
	CloudRepo   string

	// TypeScript consumer repos. Each of these points at a checkout whose
	// ui/rtk-query (or equivalent) directories are parsed by the TS
	// consumer auditor. MesheryRepoUI defaults to MesheryRepo when unset
	// because meshery/meshery keeps Go and TS consumers in the same
	// checkout; CloudRepoUI likewise defaults to CloudRepo.
	MesheryRepoUI  string
	CloudRepoUI    string
	ExtensionsRepo string

	// Google Sheets update. Empty = no sheet interaction (dry run).
	SheetID           string
	SheetsCredentials []byte
}

type ConsumerAuditResult struct {
	// Analysis results.
	Match *matchResult

	// Reconciled state (nil if no previous state was provided).
	Tracked []TrackedEndpoint

	// NewDeletions are endpoints detected as removed on this run.
	NewDeletions []DeletionRecord

	// Output rows for sheet serialization (sorted, deterministic).
	Rows []AuditRow

	// Summary counts for terminal display.
	Summary auditSummary

	// TSFindings is the flat list of TypeScript consumer drift findings
	// (case-flips, snake_case wrappers, snake_case params) produced by
	// the TS consumer auditor. Sorted by (file, line, key) for
	// deterministic output. Empty when no TS consumer trees are provided.
	TSFindings []TSFinding
}

type ConsumerAuditRow struct {
	Category            string
	SubCategory         string
	Endpoint            string
	Method              string
	EndpointStatus      string
	XAnnotated          string
	SchemaDrivenMeshery string
	SchemaDrivenCloud   string
	SchemaCompleteness  string
	PathDrift           string
	Notes               string
	// ChangeLog is the UTC timestamp of the last state transition
	// (new / changed) for this row, in format "YYYY-MM-DD HH:MM:SS".
	// Empty on rows that have never been touched by reconciliation.
	ChangeLog string
}

type DeletionRecord struct {
	Endpoint  string
	Method    string
	RemovedAt string
}

type EndpointState int

type Severity int

type TSConsumerRepo string

type TSFinding struct {
	Repo     TSConsumerRepo
	File     string // repo-relative path, forward slashes
	Line     int    // 1-based source line
	Endpoint string // RTK endpoint name, e.g. "getWorkspaceForCatalog"
	URL      string // URL template extracted from the `url` property
	Method   string // HTTP method (upper-case)
	Kind     TSFindingKind
	Key      string // the offending wire key (e.g. "orgID", "pattern_data")
	Message  string // human-readable description
}

type TSFindingKind string

type TrackedEndpoint struct {
	Row   ConsumerAuditRow
	State EndpointState
	// Prev is the row as it appeared on the previous run. Populated only
	// when State == StateChanged, so the CLI can render before/after diffs.
	Prev *ConsumerAuditRow
}

type Violation struct {
	// File is the path to the file containing the violation, relative to the
	// repository root.
	File string

	// Message describes the violation in human-readable form.
	Message string

	// Severity indicates whether this violation is blocking or advisory.
	Severity Severity

	// RuleNumber is the rule that triggered this violation (1–41+).
	RuleNumber int
}