report

type ActionContractPacket struct {
	SchemaID              string                                    `json:"schema_id"`
	SchemaVersion         string                                    `json:"schema_version"`
	PacketID              string                                    `json:"packet_id"`
	Template              string                                    `json:"template"`
	SectionOrder          []string                                  `json:"section_order"`
	Identity              ActionContractPacketIdentity              `json:"identity"`
	Path                  ActionContractPacketPath                  `json:"path"`
	AffectedAsset         string                                    `json:"affected_asset,omitempty"`
	AuthorityRequirements []risk.ProposedActionRequirement          `json:"authority_requirements"`
	CredentialPosture     ActionContractPacketCredentialPosture     `json:"credential_posture"`
	ReadinessChecks       []risk.ProposedActionPrecondition         `json:"readiness_checks"`
	Effects               ActionContractPacketEffects               `json:"effects"`
	Confirmation          *risk.ProposedActionConfirmation          `json:"confirmation_requirement"`
	Approval              *risk.ProposedActionApproval              `json:"approval_requirement"`
	Compensation          *risk.ProposedActionCompensation          `json:"compensation_requirement"`
	EvidenceGaps          []ActionContractPacketGap                 `json:"evidence_gaps"`
	LifecycleObservations []risk.ProposedActionLifecycleObservation `json:"lifecycle_observations"`
	Reachability          ActionContractPacketReachability          `json:"reachability"`
	NextStep              ActionContractPacketNextStep              `json:"next_step"`
	Truncations           []ActionContractPacketTruncation          `json:"truncations,omitempty"`
	Boundary              string                                    `json:"authority_boundary"`
	ReportOnly            bool                                      `json:"report_only"`
}

type ActionContractPacketCredentialPosture struct {
	RequiredMode    string   `json:"required_mode,omitempty"`
	RequirementIDs  []string `json:"requirement_ids,omitempty"`
	EvidenceState   string   `json:"evidence_state"`
	FreshnessState  string   `json:"freshness_state"`
	ActivationGrant bool     `json:"activation_grant"`
}

type ActionContractPacketEffects struct {
	Expected  []string `json:"expected"`
	Forbidden []string `json:"forbidden"`
}

type ActionContractPacketGap struct {
	RequirementID string   `json:"requirement_id"`
	Kind          string   `json:"kind"`
	EvidenceState string   `json:"evidence_state"`
	Freshness     string   `json:"freshness_state"`
	ReasonCodes   []string `json:"reason_codes,omitempty"`
}

type ActionContractPacketIdentity struct {
	ArtifactID             string   `json:"artifact_id"`
	ContractID             string   `json:"contract_id"`
	ContractFamilyID       string   `json:"contract_family_id"`
	ContractContentDigest  string   `json:"contract_content_digest"`
	CanonicalContentDigest string   `json:"canonical_content_digest"`
	ContractVersion        string   `json:"contract_version"`
	Revision               int      `json:"revision"`
	SupersedesRef          string   `json:"supersedes_ref,omitempty"`
	ShareProfile           string   `json:"share_profile"`
	Redacted               bool     `json:"redacted"`
	SourceScanRefs         []string `json:"source_scan_refs"`
	CreationEvidence       []string `json:"creation_evidence"`
}

type ActionContractPacketInput struct {
	ArtifactID             string
	CanonicalContentDigest string
	ShareProfile           string
	ArtifactRedacted       bool
	SourceScanRefs         []string
	CreationEvidence       []string
	Contract               risk.ProposedActionContract
	Composition            risk.ComposedActionPath
}

type ActionContractPacketNextStep struct {
	Action string `json:"action"`
	Reason string `json:"reason"`
	Owner  string `json:"owner"`
}

type ActionContractPacketPath struct {
	CompositionID      string                       `json:"composition_id"`
	PatternID          string                       `json:"pattern_id,omitempty"`
	ResolutionKey      string                       `json:"resolution_key,omitempty"`
	PathIDs            []string                     `json:"path_ids,omitempty"`
	Target             string                       `json:"target,omitempty"`
	TargetClass        string                       `json:"target_class,omitempty"`
	OutcomeClass       string                       `json:"outcome_class,omitempty"`
	ReachabilityState  string                       `json:"reachability_state,omitempty"`
	ObservedExecution  bool                         `json:"observed_execution,omitempty"`
	AlternateRouteRefs []string                     `json:"alternate_route_refs,omitempty"`
	Truncations        []risk.CompositionTruncation `json:"truncations,omitempty"`
	Stages             []ActionContractPacketStage  `json:"stages"`
}

type ActionContractPacketReachability struct {
	State             string `json:"state,omitempty"`
	ClaimState        string `json:"claim_state"`
	EvidenceState     string `json:"evidence_state"`
	FreshnessState    string `json:"freshness_state"`
	ObservedExecution bool   `json:"observed_execution"`
	BuyerLabel        string `json:"buyer_label"`
}

type ActionContractPacketStage struct {
	StageID            string   `json:"stage_id"`
	Role               string   `json:"role"`
	ToolType           string   `json:"tool_type,omitempty"`
	Location           string   `json:"location,omitempty"`
	ActionClasses      []string `json:"action_classes,omitempty"`
	TargetClass        string   `json:"target_class,omitempty"`
	EvidenceState      string   `json:"evidence_state,omitempty"`
	Freshness          string   `json:"freshness_state,omitempty"`
	SystemClass        string   `json:"system_class,omitempty"`
	TrustBoundary      string   `json:"trust_boundary,omitempty"`
	CorrelationRefs    []string `json:"correlation_refs,omitempty"`
	AlternateRouteRefs []string `json:"alternate_route_refs,omitempty"`
	ReachabilityState  string   `json:"reachability_state,omitempty"`
	ObservedExecution  bool     `json:"observed_execution,omitempty"`
}

type ActionContractPacketTruncation struct {
	Field        string `json:"field"`
	OmittedCount int    `json:"omitted_count,omitempty"`
	Reason       string `json:"reason"`
}

type ActionSurfaceRegistryEntry struct {
	RegistryID             string                               `json:"registry_id"`
	SurfaceType            string                               `json:"surface_type,omitempty"`
	Org                    string                               `json:"org"`
	Repo                   string                               `json:"repo"`
	ToolType               string                               `json:"tool_type"`
	ToolInstanceID         string                               `json:"tool_instance_id,omitempty"`
	Location               string                               `json:"location,omitempty"`
	Label                  string                               `json:"label,omitempty"`
	Owner                  string                               `json:"owner,omitempty"`
	OwnerSource            string                               `json:"owner_source,omitempty"`
	Purpose                string                               `json:"purpose,omitempty"`
	PurposeSource          string                               `json:"purpose_source,omitempty"`
	PurposeConfidence      string                               `json:"purpose_confidence,omitempty"`
	Version                string                               `json:"version,omitempty"`
	VersionSource          string                               `json:"version_source,omitempty"`
	ConfigFingerprint      string                               `json:"config_fingerprint,omitempty"`
	ConfigSource           string                               `json:"config_source,omitempty"`
	Credentials            []*agginventory.CredentialProvenance `json:"credentials,omitempty"`
	CredentialAuthorityRef string                               `json:"credential_authority_ref,omitempty"`
	CredentialAuthority    *agginventory.CredentialAuthority    `json:"credential_authority,omitempty"`
	AuthorityBindingRefs   []string                             `json:"authority_binding_refs,omitempty"`
	ReachableActions       []string                             `json:"reachable_actions,omitempty"`
	agginventory.EndpointRefGroupProjection
	MutableEndpointSemanticRefs []string                               `json:"mutable_endpoint_semantic_refs,omitempty"`
	MutableEndpointSemantics    []agginventory.MutableEndpointSemantic `json:"mutable_endpoint_semantics,omitempty"`
	ConfidenceLane              string                                 `json:"confidence_lane,omitempty"`
	ProofStatus                 string                                 `json:"proof_status,omitempty"`
	Remediation                 string                                 `json:"remediation,omitempty"`
	PathIDs                     []string                               `json:"path_ids,omitempty"`
	ActionPathCount             int                                    `json:"action_path_count"`
	GraphRefs                   AgentActionBOMGraphRefs                `json:"graph_refs,omitempty"`
}

type ActivationItem struct {
	Rank                     int     `json:"rank"`
	RiskScore                float64 `json:"risk_score"`
	FindingType              string  `json:"finding_type"`
	ToolType                 string  `json:"tool_type"`
	Severity                 string  `json:"severity"`
	Location                 string  `json:"location"`
	Repo                     string  `json:"repo"`
	NextStep                 string  `json:"next_step"`
	ItemClass                string  `json:"item_class,omitempty"`
	WriteCapable             bool    `json:"write_capable,omitempty"`
	ProductionWrite          bool    `json:"production_write,omitempty"`
	ProductionImpactInferred bool    `json:"production_impact_inferred,omitempty"`
	ApprovalClassification   string  `json:"approval_classification,omitempty"`
	SecurityVisibilityStatus string  `json:"security_visibility_status,omitempty"`
}

type ActivationSummary struct {
	TargetMode            string           `json:"target_mode"`
	Message               string           `json:"message"`
	EligibleCount         int              `json:"eligible_count"`
	SuppressedPolicyItems bool             `json:"suppressed_policy_items,omitempty"`
	Reason                string           `json:"reason,omitempty"`
	Items                 []ActivationItem `json:"items"`
}

type AgentActionBOM struct {
	BOMID                string                    `json:"bom_id"`
	SchemaVersion        string                    `json:"schema_version"`
	GeneratedAt          string                    `json:"generated_at"`
	ShareProfile         string                    `json:"share_profile,omitempty"`
	ShareProfileMetadata *ShareProfileMetadata     `json:"share_profile_metadata,omitempty"`
	Summary              AgentActionBOMSummary     `json:"summary"`
	ScanQuality          *scanquality.Report       `json:"scan_quality,omitempty"`
	Items                []AgentActionBOMItem      `json:"items,omitempty"`
	ComposedActionPaths  []risk.ComposedActionPath `json:"composed_action_paths,omitempty"`
	GraphRefs            AgentActionBOMGraphRefs   `json:"graph_refs,omitempty"`
	EvidenceRefs         []string                  `json:"evidence_refs,omitempty"`
	ProofRefs            []string                  `json:"proof_refs,omitempty"`
	// contains filtered or unexported fields
}

type AgentActionBOMCompositionStage struct {
	StageID       string   `json:"stage_id"`
	Role          string   `json:"role"`
	PathID        string   `json:"path_id,omitempty"`
	ToolType      string   `json:"tool_type,omitempty"`
	Location      string   `json:"location,omitempty"`
	ActionClasses []string `json:"action_classes,omitempty"`
	TargetClass   string   `json:"target_class,omitempty"`
	EvidenceState string   `json:"evidence_state,omitempty"`
}

type AgentActionBOMGraphRefs struct {
	NodeIDs []string `json:"node_ids,omitempty"`
	EdgeIDs []string `json:"edge_ids,omitempty"`
}

type AgentActionBOMItem struct {
	PathID                              string                               `json:"path_id"`
	AgentID                             string                               `json:"agent_id,omitempty"`
	ToolFamilyID                        string                               `json:"tool_family_id,omitempty"`
	ToolInstanceID                      string                               `json:"tool_instance_id,omitempty"`
	Org                                 string                               `json:"org"`
	Repo                                string                               `json:"repo"`
	ToolType                            string                               `json:"tool_type"`
	Location                            string                               `json:"location,omitempty"`
	Purpose                             string                               `json:"purpose,omitempty"`
	PurposeSource                       string                               `json:"purpose_source,omitempty"`
	PurposeConfidence                   string                               `json:"purpose_confidence,omitempty"`
	Version                             string                               `json:"version,omitempty"`
	VersionSource                       string                               `json:"version_source,omitempty"`
	ConfigFingerprint                   string                               `json:"config_fingerprint,omitempty"`
	ConfigSource                        string                               `json:"config_source,omitempty"`
	Owner                               string                               `json:"owner,omitempty"`
	OwnerSource                         string                               `json:"owner_source,omitempty"`
	OwnershipStatus                     string                               `json:"ownership_status,omitempty"`
	OwnershipState                      string                               `json:"ownership_state,omitempty"`
	EvidenceDecisions                   []evidencepolicy.Decision            `json:"evidence_decisions,omitempty"`
	Contradictions                      []evidencepolicy.Contradiction       `json:"contradictions,omitempty"`
	ControlResolutionState              string                               `json:"control_resolution_state,omitempty"`
	BoundaryLabel                       string                               `json:"boundary_label,omitempty"`
	ControlResolutionReasons            []string                             `json:"control_resolution_reasons,omitempty"`
	ResolutionKey                       string                               `json:"resolution_key,omitempty"`
	ResolutionSelector                  *resolution.Selector                 `json:"resolution_selector,omitempty"`
	ResolutionMatchConfidence           string                               `json:"resolution_match_confidence,omitempty"`
	ResolutionMismatchReasons           []string                             `json:"resolution_mismatch_reasons,omitempty"`
	ControlEvidenceRefs                 []string                             `json:"control_evidence_refs,omitempty"`
	ConstraintEvidenceClasses           []string                             `json:"constraint_evidence_classes,omitempty"`
	ConstraintEvidenceRefs              []string                             `json:"constraint_evidence_refs,omitempty"`
	ApprovalEvidenceState               string                               `json:"approval_evidence_state,omitempty"`
	OwnerEvidenceState                  string                               `json:"owner_evidence_state,omitempty"`
	ProofEvidenceState                  string                               `json:"proof_evidence_state,omitempty"`
	RuntimeEvidenceState                string                               `json:"runtime_evidence_state,omitempty"`
	TargetEvidenceState                 string                               `json:"target_evidence_state,omitempty"`
	CredentialEvidenceState             string                               `json:"credential_evidence_state,omitempty"`
	TargetClass                         string                               `json:"target_class,omitempty"`
	TargetClassReasons                  []string                             `json:"target_class_reasons,omitempty"`
	TargetClassEvidenceRefs             []string                             `json:"target_class_evidence_refs,omitempty"`
	ActionPathEligible                  bool                                 `json:"action_path_eligible,omitempty"`
	ActionBindingState                  string                               `json:"action_binding_state,omitempty"`
	ActionPathType                      string                               `json:"action_path_type,omitempty"`
	ActionPathTypeReasons               []string                             `json:"action_path_type_reasons,omitempty"`
	ActionPathTypeEvidenceRefs          []string                             `json:"action_path_type_evidence_refs,omitempty"`
	CIFlowClass                         string                               `json:"ci_flow_class,omitempty"`
	CIFlowReasons                       []string                             `json:"ci_flow_reasons,omitempty"`
	CredentialAccess                    bool                                 `json:"credential_access"`
	Credentials                         []*agginventory.CredentialProvenance `json:"credentials,omitempty"`
	CredentialProvenance                *agginventory.CredentialProvenance   `json:"credential_provenance,omitempty"`
	CredentialAuthorityRef              string                               `json:"credential_authority_ref,omitempty"`
	CredentialAuthority                 *agginventory.CredentialAuthority    `json:"credential_authority,omitempty"`
	AuthorityBindingRefs                []string                             `json:"authority_binding_refs,omitempty"`
	AuthorityBindings                   []*agginventory.AuthorityBinding     `json:"authority_bindings,omitempty"`
	PathContext                         *agginventory.PathContext            `json:"path_context,omitempty"`
	StandingPrivilege                   bool                                 `json:"standing_privilege,omitempty"`
	StandingPrivilegeReasons            []string                             `json:"standing_privilege_reasons,omitempty"`
	ControlState                        string                               `json:"control_state,omitempty"`
	ControlStateReasons                 []string                             `json:"control_state_reasons,omitempty"`
	RiskZone                            string                               `json:"risk_zone,omitempty"`
	RiskZoneReasons                     []string                             `json:"risk_zone_reasons,omitempty"`
	ReviewBurden                        string                               `json:"review_burden,omitempty"`
	ReviewBurdenReasons                 []string                             `json:"review_burden_reasons,omitempty"`
	ConfidenceLane                      string                               `json:"confidence_lane,omitempty"`
	ConfidenceLaneReasons               []string                             `json:"confidence_lane_reasons,omitempty"`
	ReviewLifecycleState                string                               `json:"review_lifecycle_state,omitempty"`
	ReviewLifecycleReasons              []string                             `json:"review_lifecycle_reasons,omitempty"`
	ReviewRationale                     string                               `json:"review_rationale,omitempty"`
	ReviewOwner                         string                               `json:"review_owner,omitempty"`
	ReviewSource                        string                               `json:"review_source,omitempty"`
	ReviewObservedAt                    string                               `json:"review_observed_at,omitempty"`
	ReviewValidUntil                    string                               `json:"review_valid_until,omitempty"`
	ReviewScope                         string                               `json:"review_scope,omitempty"`
	ReviewAuditContext                  *risk.ReviewAuditContext             `json:"review_audit_context,omitempty"`
	ResolvedVisibility                  string                               `json:"resolved_visibility,omitempty"`
	ResolvedAppendixRefs                []string                             `json:"resolved_appendix_refs,omitempty"`
	PreviousReviewLifecycleState        string                               `json:"previous_review_lifecycle_state,omitempty"`
	ReopenState                         string                               `json:"reopen_state,omitempty"`
	ReopenReasons                       []string                             `json:"reopen_reasons,omitempty"`
	ReopenEvidenceRefs                  []string                             `json:"reopen_evidence_refs,omitempty"`
	AutonomyTier                        string                               `json:"autonomy_tier,omitempty"`
	AutonomyTierReasons                 []string                             `json:"autonomy_tier_reasons,omitempty"`
	AutonomyTierEvidenceRefs            []string                             `json:"autonomy_tier_evidence_refs,omitempty"`
	DelegationReadinessState            string                               `json:"delegation_readiness_state,omitempty"`
	DelegationReadinessReasons          []string                             `json:"delegation_readiness_reasons,omitempty"`
	RecommendedControl                  string                               `json:"recommended_control,omitempty"`
	RecommendedControlReasons           []string                             `json:"recommended_control_reasons,omitempty"`
	RiskClassificationValidationReasons []string                             `json:"risk_classification_validation_reasons,omitempty"`
	RiskClassificationValidationRefs    []string                             `json:"risk_classification_validation_refs,omitempty"`
	RecommendedActionContract           *risk.RecommendedActionContract      `json:"recommended_action_contract,omitempty"`
	TodayPath                           *risk.GovernedPathView               `json:"today_path,omitempty"`
	RecommendedGovernedPath             *risk.GovernedPathView               `json:"recommended_governed_path,omitempty"`
	AgenticDeliverySystemChange         *risk.AgenticDeliverySystemChange    `json:"agentic_delivery_system_change,omitempty"`
	RuntimeContextEvidenceState         string                               `json:"runtime_context_evidence_state,omitempty"`
	RuntimeProvider                     string                               `json:"runtime_provider,omitempty"`
	RuntimeHost                         string                               `json:"runtime_host,omitempty"`
	RuntimeKind                         string                               `json:"runtime_kind,omitempty"`
	ModelProvider                       string                               `json:"model_provider,omitempty"`
	ModelVersion                        string                               `json:"model_version,omitempty"`
	ExecutionEnvironment                string                               `json:"execution_environment,omitempty"`
	StateRetentionEvidenceState         string                               `json:"state_retention_evidence_state,omitempty"`
	StateRetentionStatus                string                               `json:"state_retention_status,omitempty"`
	RetainedStateTypes                  []string                             `json:"retained_state_types,omitempty"`
	StateLocationRefs                   []string                             `json:"state_location_refs,omitempty"`
	StateDigestRefs                     []string                             `json:"state_digest_refs,omitempty"`
	AgentIdentity                       *risk.AgentIdentity                  `json:"agent_identity,omitempty"`
	DecisionPrecedent                   *risk.DecisionPrecedent              `json:"decision_precedent,omitempty"`
	DeliveryControlContext              *risk.DeliveryControlContext         `json:"delivery_control_context,omitempty"`
	HighStakesPresets                   []risk.HighStakesPreset              `json:"high_stakes_presets,omitempty"`
	ProductionContext                   *risk.ProductionContext              `json:"production_context,omitempty"`
	EvidencePacketStatus                string                               `json:"evidence_packet_status,omitempty"`
	EvidencePacketResult                string                               `json:"evidence_packet_result,omitempty"`
	EvidencePacketMissingEvidenceState  string                               `json:"evidence_packet_missing_evidence_state,omitempty"`
	EvidencePacketRefs                  []string                             `json:"evidence_packet_refs,omitempty"`
	ActionClasses                       []string                             `json:"action_classes,omitempty"`
	ActionReasons                       []string                             `json:"action_reasons,omitempty"`
	OccurrenceCount                     int                                  `json:"occurrence_count,omitempty"`
	OccurrenceRefs                      []string                             `json:"occurrence_refs,omitempty"`
	ExecutionRelationships              []model.ExecutionRelationship        `json:"execution_relationships,omitempty"`
	agginventory.EndpointRefGroupProjection
	MutableEndpointSemanticRefs  []string                               `json:"mutable_endpoint_semantic_refs,omitempty"`
	MutableEndpointSemantics     []agginventory.MutableEndpointSemantic `json:"mutable_endpoint_semantics,omitempty"`
	ProductionWrite              bool                                   `json:"production_write,omitempty"`
	ProductionTargetStatus       string                                 `json:"production_target_status,omitempty"`
	ProductionTargetSource       string                                 `json:"production_target_source,omitempty"`
	ProductionImpactInferred     bool                                   `json:"production_impact_inferred,omitempty"`
	MatchedProductionTargets     []string                               `json:"matched_production_targets,omitempty"`
	ApprovalGap                  bool                                   `json:"approval_gap"`
	ApprovalGapReasons           []string                               `json:"approval_gap_reasons,omitempty"`
	PolicyStatus                 string                                 `json:"policy_status,omitempty"`
	PolicyRefs                   []string                               `json:"policy_refs,omitempty"`
	PolicyMissingReasons         []string                               `json:"policy_missing_reasons,omitempty"`
	PolicyStatusReasons          []string                               `json:"policy_status_reasons,omitempty"`
	PolicyConfidence             string                                 `json:"policy_confidence,omitempty"`
	PolicyEvidenceRefs           []string                               `json:"policy_evidence_refs,omitempty"`
	ProofCoverage                string                                 `json:"proof_coverage,omitempty"`
	ProofRefs                    []string                               `json:"proof_refs,omitempty"`
	RuntimeSessionStatus         string                                 `json:"runtime_session_status,omitempty"`
	RuntimeSessionRefs           []string                               `json:"runtime_session_refs,omitempty"`
	ObservedSessionActions       []string                               `json:"observed_session_actions,omitempty"`
	ObservedChangedFiles         []string                               `json:"observed_changed_files,omitempty"`
	RuntimeEvidenceStatus        string                                 `json:"runtime_evidence_status,omitempty"`
	RuntimeEvidenceAbsenceStatus string                                 `json:"runtime_evidence_absence_status,omitempty"`
	RuntimeEvidenceClasses       []string                               `json:"runtime_evidence_classes,omitempty"`
	RuntimeEvidenceRefs          []string                               `json:"runtime_evidence_refs,omitempty"`
	GaitCoverage                 *risk.GaitCoverage                     `json:"gait_coverage,omitempty"`
	Confidence                   string                                 `json:"confidence,omitempty"`
	EvidenceStrength             string                                 `json:"evidence_strength,omitempty"`
	InventoryRisk                string                                 `json:"inventory_risk,omitempty"`
	ControlPriority              string                                 `json:"control_priority,omitempty"`
	RiskTier                     string                                 `json:"risk_tier,omitempty"`
	RecommendedNextAction        string                                 `json:"recommended_next_action,omitempty"`
	Queue                        string                                 `json:"queue,omitempty"`
	FindingVisibility            string                                 `json:"finding_visibility,omitempty"`
	Remediation                  string                                 `json:"remediation,omitempty"`
	ClosureRequirements          []risk.ClosureRequirement              `json:"closure_requirements,omitempty"`
	ClosureActions               []risk.ClosureAction                   `json:"closure_actions,omitempty"`
	EvidenceCompleteness         *risk.EvidenceCompleteness             `json:"evidence_completeness,omitempty"`
	GovernanceDisposition        *controlbacklog.GovernanceDisposition  `json:"governance_disposition,omitempty"`
	LifecycleQueue               *governancequeue.Item                  `json:"lifecycle_queue,omitempty"`
	AttackPathRefs               []string                               `json:"attack_path_refs,omitempty"`
	SourceFindingKeys            []string                               `json:"source_finding_keys,omitempty"`
	WorkflowChainRefs            []string                               `json:"workflow_chain_refs,omitempty"`
	DecisionTraceRefs            []string                               `json:"decision_trace_refs,omitempty"`
	CompositionIDs               []string                               `json:"composition_ids,omitempty"`
	ProposedActionContractRefs   []string                               `json:"proposed_action_contract_refs,omitempty"`
	ExclusionReason              string                                 `json:"exclusion_reason,omitempty"`
	GraphRefs                    AgentActionBOMGraphRefs                `json:"graph_refs,omitempty"`
	EvidenceRefs                 []string                               `json:"evidence_refs,omitempty"`
	Reachability                 []AgentActionBOMReachability           `json:"reachability,omitempty"`
	ReachableServers             []AgentActionBOMReachability           `json:"reachable_servers,omitempty"`
	ReachableTools               []AgentActionBOMReachability           `json:"reachable_tools,omitempty"`
	ReachableEndpoints           []AgentActionBOMReachability           `json:"reachable_endpoints,omitempty"`
	ReachableTargets             []AgentActionBOMReachability           `json:"reachable_targets,omitempty"`
	ReachableAPIs                []AgentActionBOMReachability           `json:"reachable_apis,omitempty"`
	ReachableAgents              []AgentActionBOMReachability           `json:"reachable_agents,omitempty"`
	IntroducedBy                 *attribution.Result                    `json:"introduced_by,omitempty"`
	ActionLineage                *risk.ActionLineage                    `json:"action_lineage,omitempty"`
}

type AgentActionBOMPrimaryPathMap struct {
	Tool       string `json:"tool,omitempty"`
	RepoPR     string `json:"repo_pr,omitempty"`
	Workflow   string `json:"workflow,omitempty"`
	Credential string `json:"credential,omitempty"`
	Action     string `json:"action,omitempty"`
	Target     string `json:"target,omitempty"`
}

type AgentActionBOMPrimaryView struct {
	PathID                      string                            `json:"path_id"`
	SelectionReason             string                            `json:"selection_reason"`
	PathMap                     AgentActionBOMPrimaryPathMap      `json:"path_map"`
	ControlResolutionState      string                            `json:"control_resolution_state,omitempty"`
	BoundaryLabel               string                            `json:"boundary_label,omitempty"`
	EvidenceClassification      string                            `json:"evidence_classification,omitempty"`
	ApprovalEvidenceState       string                            `json:"approval_evidence_state,omitempty"`
	OwnerEvidenceState          string                            `json:"owner_evidence_state,omitempty"`
	ProofEvidenceState          string                            `json:"proof_evidence_state,omitempty"`
	RuntimeEvidenceState        string                            `json:"runtime_evidence_state,omitempty"`
	TargetEvidenceState         string                            `json:"target_evidence_state,omitempty"`
	CredentialEvidenceState     string                            `json:"credential_evidence_state,omitempty"`
	AutonomyTier                string                            `json:"autonomy_tier,omitempty"`
	DelegationReadinessState    string                            `json:"delegation_readiness_state,omitempty"`
	RecommendedControl          string                            `json:"recommended_control,omitempty"`
	EffectiveControl            string                            `json:"effective_control,omitempty"`
	EffectiveControlScope       string                            `json:"effective_control_scope,omitempty"`
	EffectiveControlReason      string                            `json:"effective_control_reason,omitempty"`
	RiskTier                    string                            `json:"risk_tier,omitempty"`
	EvidenceCompletenessLabel   string                            `json:"evidence_completeness_label,omitempty"`
	EvidenceCompletenessScore   int                               `json:"evidence_completeness_score,omitempty"`
	UnresolvedEvidence          []string                          `json:"unresolved_evidence,omitempty"`
	RecommendedNextActions      []string                          `json:"recommended_next_actions,omitempty"`
	CoverageStatus              string                            `json:"coverage_status,omitempty"`
	CoverageReasons             []string                          `json:"coverage_reasons,omitempty"`
	CoverageImpact              string                            `json:"coverage_impact,omitempty"`
	TodayPath                   *risk.GovernedPathView            `json:"today_path,omitempty"`
	RecommendedGovernedPath     *risk.GovernedPathView            `json:"recommended_governed_path,omitempty"`
	RecommendedActionContract   *risk.RecommendedActionContract   `json:"recommended_action_contract,omitempty"`
	CompositionID               string                            `json:"composition_id,omitempty"`
	CompositionStageMap         []AgentActionBOMCompositionStage  `json:"composition_stage_map,omitempty"`
	CredentialSummary           string                            `json:"credential_summary,omitempty"`
	DelegationSummary           string                            `json:"delegation_summary,omitempty"`
	TargetSummary               string                            `json:"target_summary,omitempty"`
	CurrentCoverage             string                            `json:"current_coverage,omitempty"`
	ProposedControl             string                            `json:"proposed_control,omitempty"`
	ExpectedOutcome             string                            `json:"expected_outcome,omitempty"`
	ProposedActionContract      *risk.ProposedActionContract      `json:"proposed_action_contract,omitempty"`
	ClosureRequirements         []risk.ClosureRequirement         `json:"closure_requirements,omitempty"`
	AgenticDeliverySystemChange *risk.AgenticDeliverySystemChange `json:"agentic_delivery_system_change,omitempty"`
	RuntimeProvider             string                            `json:"runtime_provider,omitempty"`
	RuntimeHost                 string                            `json:"runtime_host,omitempty"`
	RuntimeKind                 string                            `json:"runtime_kind,omitempty"`
	ModelProvider               string                            `json:"model_provider,omitempty"`
	ModelVersion                string                            `json:"model_version,omitempty"`
	ExecutionEnvironment        string                            `json:"execution_environment,omitempty"`
	StateRetentionStatus        string                            `json:"state_retention_status,omitempty"`
	AgentIdentity               *risk.AgentIdentity               `json:"agent_identity,omitempty"`
	DecisionPrecedent           *risk.DecisionPrecedent           `json:"decision_precedent,omitempty"`
	DeliveryControlContext      *risk.DeliveryControlContext      `json:"delivery_control_context,omitempty"`
	WorkflowChainRefs           []string                          `json:"workflow_chain_refs,omitempty"`
	CompositionIDs              []string                          `json:"composition_ids,omitempty"`
	ProposedActionContractRefs  []string                          `json:"proposed_action_contract_refs,omitempty"`
	GraphRefs                   AgentActionBOMGraphRefs           `json:"graph_refs,omitempty"`
	ProofRefs                   []string                          `json:"proof_refs,omitempty"`
	EvidencePacketRefs          []string                          `json:"evidence_packet_refs,omitempty"`
	DecisionTraceRefs           []string                          `json:"decision_trace_refs,omitempty"`
	AppendixRefs                []string                          `json:"appendix_refs,omitempty"`
}

type AgentActionBOMReachability struct {
	Surface      string                   `json:"surface"`
	Name         string                   `json:"name,omitempty"`
	Capabilities []string                 `json:"capabilities,omitempty"`
	TrustDepth   *agginventory.TrustDepth `json:"trust_depth,omitempty"`
	EvidenceRefs []string                 `json:"evidence_refs,omitempty"`
}

type AgentActionBOMSummary struct {
	TotalItems                    int                                  `json:"total_items"`
	ControlFirstItems             int                                  `json:"control_first_items"`
	StandingPrivilegeItems        int                                  `json:"standing_privilege_items"`
	StaticCredentialItems         int                                  `json:"static_credential_items"`
	ProductionTargetItems         int                                  `json:"production_target_items"`
	ProductionImpactInferredItems int                                  `json:"production_impact_inferred_items"`
	AcceptedRiskItems             int                                  `json:"accepted_risk_items,omitempty"`
	ResolvedAppendixItems         int                                  `json:"resolved_appendix_items,omitempty"`
	LifecycleQueueItems           int                                  `json:"lifecycle_queue_items,omitempty"`
	ApprovalEvidenceUnknownItems  int                                  `json:"approval_evidence_unknown_items,omitempty"`
	ControlEvidenceUnknownItems   int                                  `json:"control_evidence_unknown_items,omitempty"`
	OwnerEvidenceUnknownItems     int                                  `json:"owner_evidence_unknown_items,omitempty"`
	ProofEvidenceUnknownItems     int                                  `json:"proof_evidence_unknown_items,omitempty"`
	MissingApprovalItems          int                                  `json:"missing_approval_items"`
	MissingPolicyItems            int                                  `json:"missing_policy_items"`
	MissingProofItems             int                                  `json:"missing_proof_items"`
	RuntimeProvenItems            int                                  `json:"runtime_proven_items"`
	UnresolvedOwnerItems          int                                  `json:"unresolved_owner_items"`
	ConfirmedActionPathItems      int                                  `json:"confirmed_action_path_items,omitempty"`
	LikelyActionPathItems         int                                  `json:"likely_action_path_items,omitempty"`
	SemanticReviewCandidateItems  int                                  `json:"semantic_review_candidate_items,omitempty"`
	ContextOnlyItems              int                                  `json:"context_only_items,omitempty"`
	EligibleActionPathItems       int                                  `json:"eligible_action_path_items,omitempty"`
	TargetSurfaceContextItems     int                                  `json:"target_surface_context_items,omitempty"`
	InstructionControlItems       int                                  `json:"instruction_control_surface_items,omitempty"`
	EmptyStateStatus              string                               `json:"empty_state_status,omitempty"`
	EmptyStateReasons             []string                             `json:"empty_state_reasons,omitempty"`
	ScanScope                     *ScanScopeSummary                    `json:"scan_scope,omitempty"`
	SourcePrivacy                 *sourceprivacy.Contract              `json:"source_privacy,omitempty"`
	OperationalExposure           *scorecore.AxisSummary               `json:"operational_exposure,omitempty"`
	GovernanceReadiness           *scorecore.AxisSummary               `json:"governance_readiness,omitempty"`
	EvidenceCompleteness          *risk.EvidenceCompletenessSummary    `json:"evidence_completeness,omitempty"`
	ExecutiveRollup               *controlbacklog.ExecutiveRollup      `json:"executive_rollup,omitempty"`
	GovernedUsageMetrics          *controlbacklog.GovernedUsageMetrics `json:"governed_usage_metrics,omitempty"`
	RepeatUsageSignals            *RepeatUsageSignals                  `json:"repeat_usage_signals,omitempty"`
	ScanCoverage                  *scanquality.CompactCoverageSummary  `json:"scan_coverage,omitempty"`
	CoverageConfidence            string                               `json:"coverage_confidence,omitempty"`
	AutonomyTiers                 risk.AutonomyTierCounts              `json:"autonomy_tiers"`
	DelegationReadiness           risk.DelegationReadinessCounts       `json:"delegation_readiness"`
	RecommendedControls           risk.RecommendedControlCounts        `json:"recommended_controls"`
	DriftReview                   *RegressSummary                      `json:"drift_review,omitempty"`
	PrimaryView                   *AgentActionBOMPrimaryView           `json:"primary_view,omitempty"`
}

type ArtifactBudget struct {
	MaxActionPaths         int `json:"max_action_paths,omitempty"`
	MaxComposedActionPaths int `json:"max_composed_action_paths,omitempty"`
	MaxBacklogItems        int `json:"max_backlog_items,omitempty"`
	MaxGraphNodes          int `json:"max_graph_nodes,omitempty"`
	MaxGraphEdges          int `json:"max_graph_edges,omitempty"`
	MaxWorkflowChains      int `json:"max_workflow_chains,omitempty"`
	MaxExposureGroups      int `json:"max_exposure_groups,omitempty"`
	MaxAgentActionBOM      int `json:"max_agent_action_bom_items,omitempty"`
	MarkdownLineCap        int `json:"markdown_line_cap,omitempty"`
	MarkdownLeadLineCap    int `json:"markdown_lead_line_cap,omitempty"`
	MarkdownLeadSectionCap int `json:"markdown_lead_section_cap,omitempty"`
}

type ArtifactJoinEntry struct {
	Kind     string `json:"kind"`
	Internal string `json:"internal"`
	External string `json:"external"`
}

type ArtifactJoinMap struct {
	PairID               string              `json:"pair_id"`
	GeneratedAt          string              `json:"generated_at"`
	InternalShareProfile string              `json:"internal_share_profile"`
	ExternalShareProfile string              `json:"external_share_profile"`
	Entries              []ArtifactJoinEntry `json:"entries,omitempty"`
}

type ArtifactMetadata struct {
	ArtifactID            string   `json:"artifact_id"`
	PairID                string   `json:"pair_id,omitempty"`
	VariantKind           string   `json:"variant_kind,omitempty"`
	ShareProfile          string   `json:"share_profile,omitempty"`
	RedactionVersion      string   `json:"redaction_version,omitempty"`
	SelectedFields        []string `json:"selected_fields,omitempty"`
	SourceArtifactRefs    []string `json:"source_artifact_refs,omitempty"`
	SourceArtifactDigests []string `json:"source_artifact_digests,omitempty"`
	PrivateJoinMapPath    string   `json:"private_join_map_path,omitempty"`
	ShareabilityStatus    string   `json:"shareability_status,omitempty"`
}

type AssessmentSummary struct {
	GovernablePathCount         int                           `json:"governable_path_count"`
	WriteCapablePathCount       int                           `json:"write_capable_path_count"`
	ProductionBackedPathCount   int                           `json:"production_target_backed_path_count"`
	ProductionInferredPathCount int                           `json:"production_impact_inferred_path_count"`
	TopPathToControlFirst       *risk.ActionPath              `json:"top_path_to_control_first,omitempty"`
	TopExecutionIdentityBacked  *risk.ActionPath              `json:"top_execution_identity_backed_path,omitempty"`
	OwnerlessExposure           *risk.OwnerlessExposure       `json:"ownerless_exposure,omitempty"`
	IdentityExposureSummary     *risk.IdentityExposureSummary `json:"identity_exposure_summary,omitempty"`
	IdentityToReviewFirst       *risk.IdentityActionTarget    `json:"identity_to_review_first,omitempty"`
	IdentityToRevokeFirst       *risk.IdentityActionTarget    `json:"identity_to_revoke_first,omitempty"`
	ProofChainPath              string                        `json:"proof_chain_path,omitempty"`
}

type AttackPathSummary struct {
	Total      int      `json:"total"`
	TopPathIDs []string `json:"top_path_ids"`
}

type BuildInput struct {
	GeneratedAt      time.Time
	StatePath        string
	Snapshot         state.Snapshot
	PreviousSnapshot *state.Snapshot
	Baseline         *regress.Baseline
	RegressResult    *regress.Result
	Manifest         *manifest.Manifest
	Top              int
	Template         Template
	ShareProfile     ShareProfile
	RedactionFields  []RedactionField
}

type BuyerArtifactPathEvidence struct {
	ActionPathType string
	Repo           string
	Location       string
}

type BuyerArtifactQAInput struct {
	ActionPathTypes []string
	PathEvidence    []BuyerArtifactPathEvidence
	Texts           map[string]string
}

type CampaignArtifact struct {
	SchemaVersion string               `json:"schema_version"`
	GeneratedAt   string               `json:"generated_at"`
	InputGlob     string               `json:"input_glob,omitempty"`
	Methodology   CampaignMethodology  `json:"methodology"`
	Metrics       CampaignMetrics      `json:"metrics"`
	Segments      CampaignSegments     `json:"segments"`
	Scans         []CampaignScanResult `json:"scans"`
}

type CampaignDetector struct {
	ID           string `json:"id"`
	Version      string `json:"version"`
	FindingCount int    `json:"finding_count"`
}

type CampaignMethodology struct {
	WrkrVersion        string             `json:"wrkr_version"`
	ScanCount          int                `json:"scan_count"`
	RepoCount          int                `json:"repo_count"`
	FileCountProcessed int                `json:"file_count_processed"`
	Detectors          []CampaignDetector `json:"detectors"`
}

type CampaignMetrics struct {
	ReposScanned                        int      `json:"repos_scanned"`
	ToolsDetectedTotal                  int      `json:"tools_detected_total"`
	WriteCapableTools                   int      `json:"write_capable_tools"`
	CredentialAccessTools               int      `json:"credential_access_tools"`
	ExecCapableTools                    int      `json:"exec_capable_tools"`
	ApprovedTools                       int      `json:"approved_tools"`
	UnapprovedTools                     int      `json:"unapproved_tools"`
	UnknownTools                        int      `json:"unknown_tools"`
	UnknownToSecurityTools              int      `json:"unknown_to_security_tools"`
	UnknownToSecurityAgents             int      `json:"unknown_to_security_agents"`
	UnknownToSecurityWriteCapableAgents int      `json:"unknown_to_security_write_capable_agents"`
	SecurityVisibilityReference         string   `json:"security_visibility_reference"`
	ApprovedPercent                     float64  `json:"approved_percent"`
	UnapprovedPercent                   float64  `json:"unapproved_percent"`
	UnknownPercent                      float64  `json:"unknown_percent"`
	UnapprovedPerApproved               *float64 `json:"unapproved_per_approved"`
	ProductionWriteStatus               string   `json:"production_write_status"`
	ProductionWriteTools                *int     `json:"production_write_tools"`
}

type CampaignOptions struct {
	SegmentMetadata map[string]SegmentMetadata
}

type CampaignScanInput struct {
	Path            string
	Target          source.Target
	SourceManifest  source.Manifest
	Inventory       *agginventory.Inventory
	PrivilegeBudget agginventory.PrivilegeBudget
	Findings        []source.Finding
}

type CampaignScanResult struct {
	Path                 string `json:"path"`
	TargetMode           string `json:"target_mode"`
	TargetValue          string `json:"target_value"`
	RepoCount            int    `json:"repo_count"`
	ToolsDetected        int    `json:"tools_detected"`
	WriteCapableTools    int    `json:"write_capable_tools"`
	CredentialAccessTool int    `json:"credential_access_tools"`
	ExecCapableTools     int    `json:"exec_capable_tools"`
}

type CampaignSegmentBucket struct {
	Segment   string `json:"segment"`
	OrgCount  int    `json:"org_count"`
	ToolCount int    `json:"tool_count"`
}

type CampaignSegments struct {
	OrgSizeBands  []CampaignSegmentBucket `json:"org_size_bands"`
	IndustryBands []CampaignSegmentBucket `json:"industry_bands"`
}

type ChecklistItem struct {
	ID   string `json:"id"`
	Text string `json:"text"`
}

type CompositionCorrelationRef struct {
	CompositionID              string            `json:"composition_id"`
	ResolutionKey              string            `json:"resolution_key,omitempty"`
	PatternID                  string            `json:"pattern_id,omitempty"`
	PathIDs                    []string          `json:"path_ids,omitempty"`
	WorkflowChainRefs          []string          `json:"workflow_chain_refs,omitempty"`
	ProposedActionContractRefs []string          `json:"proposed_action_contract_refs,omitempty"`
	RecommendedControl         string            `json:"recommended_control,omitempty"`
	EvidenceState              string            `json:"evidence_state,omitempty"`
	PolicyCoverageStatus       string            `json:"policy_coverage_status,omitempty"`
	GaitCoverageSummary        map[string]string `json:"gait_coverage_summary,omitempty"`
	ProposedActionContractID   string            `json:"proposed_action_contract_id,omitempty"`
	ContractFamilyID           string            `json:"contract_family_id,omitempty"`
	ContractRevision           int               `json:"contract_revision,omitempty"`
	ContractContentDigest      string            `json:"contract_content_digest,omitempty"`
	SupersedesRef              string            `json:"supersedes_ref,omitempty"`
	ActionContractArtifactRefs []string          `json:"action_contract_artifact_refs,omitempty"`
	LifecycleObservationRefs   []string          `json:"lifecycle_observation_refs,omitempty"`
}

type ControlProofStatus struct {
	LinkedActionPathID string   `json:"linked_action_path_id,omitempty"`
	Repo               string   `json:"repo,omitempty"`
	Path               string   `json:"path,omitempty"`
	ControlID          string   `json:"control_id"`
	BacklogItemID      string   `json:"backlog_item_id"`
	AgentID            string   `json:"agent_id,omitempty"`
	Status             string   `json:"status"`
	ExistingProof      []string `json:"existing_proof,omitempty"`
	MissingProof       []string `json:"missing_proof,omitempty"`
	RecordIDs          []string `json:"record_ids,omitempty"`
}

type DeclarationSnippet struct {
	Mode                   string   `json:"mode"`
	TargetPath             string   `json:"target_path"`
	ActionType             string   `json:"action_type"`
	DeclarationKind        string   `json:"declaration_kind"`
	ReviewDispositionState string   `json:"review_disposition_state,omitempty"`
	CorrelationKind        string   `json:"correlation_kind,omitempty"`
	DirectlyApplicable     bool     `json:"directly_applicable"`
	Warnings               []string `json:"warnings,omitempty"`
	Content                string   `json:"content"`
}

type DeltaMetric struct {
	Current     float64 `json:"current"`
	Previous    float64 `json:"previous"`
	Delta       float64 `json:"delta"`
	HasPrevious bool    `json:"has_previous"`
}

type DeltaSummary struct {
	RiskScoreTrend         DeltaMetric `json:"risk_score_trend"`
	ProfileComplianceDelta DeltaMetric `json:"profile_compliance_delta"`
	PostureScoreTrend      DeltaMetric `json:"posture_score_trend_delta"`
}

type EvidenceBundle struct {
	ReportBundleVersion    string                               `json:"report_bundle_version"`
	GeneratedAt            string                               `json:"generated_at"`
	Template               string                               `json:"template"`
	ShareProfile           string                               `json:"share_profile"`
	DeploymentMode         string                               `json:"deployment_mode,omitempty"`
	ShareProfileMetadata   *ShareProfileMetadata                `json:"share_profile_metadata,omitempty"`
	ArtifactMetadata       *ArtifactMetadata                    `json:"artifact_metadata,omitempty"`
	ArtifactBudget         *ArtifactBudget                      `json:"artifact_budget,omitempty"`
	AppendixAvailable      bool                                 `json:"appendix_available,omitempty"`
	FocusedBundleAvailable bool                                 `json:"focused_bundle_available,omitempty"`
	FullExportAvailable    bool                                 `json:"full_export_available,omitempty"`
	SuppressedCounts       *SuppressedCounts                    `json:"suppressed_counts,omitempty"`
	ControlBacklog         *controlbacklog.Backlog              `json:"control_backlog,omitempty"`
	ExecutiveRollup        *controlbacklog.ExecutiveRollup      `json:"executive_rollup,omitempty"`
	GovernedUsageMetrics   *controlbacklog.GovernedUsageMetrics `json:"governed_usage_metrics,omitempty"`
	ControlPathGraph       *aggattack.ControlPathGraph          `json:"control_path_graph,omitempty"`
	WorkflowChains         *agentresolver.WorkflowChainArtifact `json:"workflow_chains,omitempty"`
	ActionSurfaceRegistry  []ActionSurfaceRegistryEntry         `json:"action_surface_registry,omitempty"`
	RuntimeSessions        *ingest.SessionSummary               `json:"runtime_sessions,omitempty"`
	RuntimeEvidence        *ingest.Summary                      `json:"runtime_evidence,omitempty"`
	EvidencePackets        *ingest.EvidencePacketSummary        `json:"evidence_packets,omitempty"`
	CompositionRefs        []CompositionCorrelationRef          `json:"composition_refs,omitempty"`
	AgentActionBOM         *AgentActionBOM                      `json:"agent_action_bom,omitempty"`
	ComplianceSummary      any                                  `json:"compliance_summary"`
	Proof                  ProofReference                       `json:"proof"`
	NextActions            []ChecklistItem                      `json:"next_actions"`
}

type FocusPreset string

type FocusView struct {
	Preset                 string              `json:"preset"`
	Title                  string              `json:"title"`
	MatchingPaths          int                 `json:"matching_paths"`
	MatchingWorkflowChains int                 `json:"matching_workflow_chains"`
	MatchingBacklogItems   int                 `json:"matching_backlog_items"`
	EmptyStateStatus       string              `json:"empty_state_status,omitempty"`
	EmptyStateMessage      string              `json:"empty_state_message,omitempty"`
	RecommendedNextActions []string            `json:"recommended_next_actions,omitempty"`
	PathIDs                []string            `json:"path_ids,omitempty"`
	WorkflowChainRefs      []string            `json:"workflow_chain_refs,omitempty"`
	ControlBacklogIDs      []string            `json:"control_backlog_ids,omitempty"`
	Highlights             []WorkflowHighlight `json:"highlights,omitempty"`
}

type Headline struct {
	Score            float64 `json:"score"`
	Grade            string  `json:"grade"`
	ComplianceStatus string  `json:"compliance_status"`
	Compliance       float64 `json:"compliance_percent"`
}

type LifecycleSummary struct {
	IdentityCount      int                    `json:"identity_count"`
	UnderReviewCount   int                    `json:"under_review_count"`
	RevokedCount       int                    `json:"revoked_count"`
	DeprecatedCount    int                    `json:"deprecated_count"`
	PendingActionCount int                    `json:"pending_action_count"`
	Gaps               []lifecycle.Gap        `json:"gaps,omitempty"`
	Queue              []governancequeue.Item `json:"queue,omitempty"`
	RecentTransitions  []LifecycleTransition  `json:"recent_transitions"`
}

type LifecycleTransition struct {
	AgentID       string `json:"agent_id"`
	PreviousState string `json:"previous_state"`
	NewState      string `json:"new_state"`
	Trigger       string `json:"trigger"`
	Timestamp     string `json:"timestamp"`
}

type MCPCandidate struct {
	CandidateName     string   `json:"candidate_name"`
	Org               string   `json:"org"`
	Repo              string   `json:"repo"`
	Location          string   `json:"location"`
	EvidenceType      string   `json:"evidence_type"`
	Confidence        string   `json:"confidence"`
	DeclarationType   string   `json:"declaration_type"`
	TransportHint     string   `json:"transport_hint"`
	CredentialRefs    []string `json:"credential_refs,omitempty"`
	UnsupportedReason string   `json:"unsupported_reason,omitempty"`
}

type MCPList struct {
	Status         string              `json:"status"`
	GeneratedAt    string              `json:"generated_at"`
	RepoFilter     string              `json:"repo_filter,omitempty"`
	Rows           []MCPListRow        `json:"rows"`
	Candidates     []MCPCandidate      `json:"candidates,omitempty"`
	Diagnostics    []MCPMissDiagnostic `json:"diagnostics,omitempty"`
	Warnings       []string            `json:"warnings,omitempty"`
	AbsenceStatus  string              `json:"absence_status,omitempty"`
	AbsenceReasons []string            `json:"absence_reasons,omitempty"`
	AbsenceImpact  string              `json:"absence_impact,omitempty"`
}

type MCPListOptions struct {
	GeneratedAt         time.Time
	OverlayPath         string
	AllowAmbientOverlay bool
	RepoFilter          string
	ExpectedServers     []string
}

type MCPListRow struct {
	ServerName           string                   `json:"server_name"`
	Org                  string                   `json:"org"`
	Repo                 string                   `json:"repo"`
	Location             string                   `json:"location"`
	Transport            string                   `json:"transport"`
	RequestedPermissions []string                 `json:"requested_permissions,omitempty"`
	PrivilegeSurface     []string                 `json:"privilege_surface,omitempty"`
	GatewayCoverage      string                   `json:"gateway_coverage"`
	TrustDepth           *agginventory.TrustDepth `json:"trust_depth,omitempty"`
	TrustStatus          string                   `json:"trust_status"`
	RiskNote             string                   `json:"risk_note"`
}

type MCPMissDiagnostic struct {
	Org                     string   `json:"org"`
	Repo                    string   `json:"repo"`
	ExpectedServer          string   `json:"expected_server,omitempty"`
	Status                  string   `json:"status"`
	AbsenceStatus           string   `json:"absence_status,omitempty"`
	CandidateFilesScanned   []string `json:"candidate_files_scanned,omitempty"`
	ParsedConfigs           []string `json:"parsed_configs,omitempty"`
	CandidatesFound         []string `json:"candidates_found,omitempty"`
	ParseFailures           []string `json:"parse_failures,omitempty"`
	GeneratedSuppressions   []string `json:"generated_suppressions,omitempty"`
	UnsupportedDeclarations []string `json:"unsupported_declarations,omitempty"`
	Explanation             []string `json:"explanation,omitempty"`
	AbsenceImpact           string   `json:"absence_impact,omitempty"`
}

type Methodology struct {
	WrkrVersion         string   `json:"wrkr_version"`
	ScanStartedAt       string   `json:"scan_started_at"`
	ScanCompletedAt     string   `json:"scan_completed_at"`
	ScanDurationSeconds float64  `json:"scan_duration_seconds"`
	RepoCount           int      `json:"repo_count"`
	FileCountProcessed  int      `json:"file_count_processed"`
	DetectorCount       int      `json:"detector_count"`
	CommandSet          []string `json:"command_set"`
	SampleDefinition    string   `json:"sample_definition"`
	ExclusionCriteria   []string `json:"exclusion_criteria"`
}

type PolicyOutcome = outputsignal.PolicyOutcome

type ProofReference struct {
	ChainPath            string            `json:"chain_path"`
	HeadHash             string            `json:"head_hash"`
	RecordCount          int               `json:"record_count"`
	RecordTypeCounts     []RecordTypeCount `json:"record_type_counts"`
	CanonicalFindingKeys []string          `json:"canonical_finding_keys"`
}

type PublicSurfaceAssessment struct {
	ManifestName string                   `json:"manifest_name,omitempty"`
	TotalSources int                      `json:"total_sources"`
	LabelCounts  PublicSurfaceLabelCounts `json:"label_counts"`
	Entries      []PublicSurfaceEntry     `json:"entries,omitempty"`
}

type PublicSurfaceEntry struct {
	EntryID            string   `json:"entry_id"`
	SourceClass        string   `json:"source_class"`
	Title              string   `json:"title,omitempty"`
	PublicRef          string   `json:"public_ref"`
	CapturePath        string   `json:"capture_path,omitempty"`
	CapturedAt         string   `json:"captured_at,omitempty"`
	EvidenceLabel      string   `json:"evidence_label"`
	Confidence         string   `json:"confidence,omitempty"`
	InferenceRationale string   `json:"inference_rationale,omitempty"`
	Claims             []string `json:"claims,omitempty"`
}

type PublicSurfaceLabelCounts struct {
	PublicObserved         int `json:"public_observed"`
	PublicInferred         int `json:"public_inferred"`
	UnsupportedPublicClaim int `json:"unsupported_public_claim"`
	PrivateEvidenceAbsent  int `json:"private_evidence_absent"`
}

type ReasonGroup struct {
	Code  string `json:"code"`
	Count int    `json:"count"`
}

type RecentPRReview struct {
	Mode            string               `json:"mode"`
	Limit           int                  `json:"limit"`
	SelectedIDs     []string             `json:"selected_ids,omitempty"`
	DateFrom        string               `json:"date_from,omitempty"`
	DateTo          string               `json:"date_to,omitempty"`
	TotalCandidates int                  `json:"total_candidates"`
	Ranked          []RecentPRReviewItem `json:"ranked,omitempty"`
}

type RecentPRReviewItem struct {
	Rank                     int                     `json:"rank"`
	ReviewID                 string                  `json:"review_id"`
	Reference                string                  `json:"reference,omitempty"`
	Provider                 string                  `json:"provider,omitempty"`
	Repo                     string                  `json:"repo,omitempty"`
	PathID                   string                  `json:"path_id,omitempty"`
	Workflow                 string                  `json:"workflow,omitempty"`
	AutonomyTier             string                  `json:"autonomy_tier,omitempty"`
	DelegationReadinessState string                  `json:"delegation_readiness_state,omitempty"`
	RecommendedControl       string                  `json:"recommended_control,omitempty"`
	TargetClass              string                  `json:"target_class,omitempty"`
	EvidenceCompleteness     string                  `json:"evidence_completeness,omitempty"`
	Contradiction            bool                    `json:"contradiction,omitempty"`
	AIAssisted               bool                    `json:"ai_assisted,omitempty"`
	AutomationAssisted       bool                    `json:"automation_assisted,omitempty"`
	CheckCount               int                     `json:"check_count,omitempty"`
	ApprovalCount            int                     `json:"approval_count,omitempty"`
	DeploymentCount          int                     `json:"deployment_count,omitempty"`
	FocusBOMPathID           string                  `json:"focus_bom_path_id,omitempty"`
	Provenance               *attribution.Result     `json:"provenance,omitempty"`
	WorkflowChainRefs        []string                `json:"workflow_chain_refs,omitempty"`
	GraphRefs                AgentActionBOMGraphRefs `json:"graph_refs,omitempty"`
	ProofRefs                []string                `json:"proof_refs,omitempty"`
	EvidencePacketRefs       []string                `json:"evidence_packet_refs,omitempty"`
	MissingEvidence          []string                `json:"missing_evidence,omitempty"`
}

type RecentPRReviewOptions struct {
	IDs         []string
	DateFrom    time.Time
	HasDateFrom bool
	DateTo      time.Time
	HasDateTo   bool
	Limit       int
}

type RecordTypeCount struct {
	RecordType string `json:"record_type"`
	Count      int    `json:"count"`
}

type RedactionConfig struct {
	Profile       ShareProfile
	DefaultFields []RedactionField
	Fields        []RedactionField
	// contains filtered or unexported fields
}

type RedactionField string

type RegressSummary struct {
	BaselineProvided   bool                           `json:"baseline_provided"`
	DriftDetected      bool                           `json:"drift_detected"`
	ReasonCount        int                            `json:"reason_count"`
	ReasonGroups       []ReasonGroup                  `json:"reason_groups"`
	DriftCategoryCount int                            `json:"drift_category_count,omitempty"`
	DriftCategories    []regress.DriftCategorySummary `json:"drift_categories,omitempty"`
	ComparisonStatus   string                         `json:"comparison_status,omitempty"`
	ComparisonIssues   []string                       `json:"comparison_issues,omitempty"`
}

type RepeatUsageSignals struct {
	Status                string   `json:"status"`
	BaselinePresent       bool     `json:"baseline_present,omitempty"`
	AssessRuns            int      `json:"assess_runs,omitempty"`
	AssessRerunDetected   bool     `json:"assess_rerun_detected,omitempty"`
	RegressArtifacts      int      `json:"regress_artifacts,omitempty"`
	DriftArtifacts        int      `json:"drift_artifacts,omitempty"`
	EvidenceExports       int      `json:"evidence_exports,omitempty"`
	TicketExports         int      `json:"ticket_exports,omitempty"`
	ActionContractExports int      `json:"action_contract_exports,omitempty"`
	ReasonCodes           []string `json:"reason_codes,omitempty"`
}

type RiskItem struct {
	Rank                     int      `json:"rank"`
	CanonicalKey             string   `json:"canonical_key"`
	Score                    float64  `json:"risk_score"`
	FindingType              string   `json:"finding_type"`
	Severity                 string   `json:"severity"`
	ToolType                 string   `json:"tool_type"`
	Org                      string   `json:"org"`
	Repo                     string   `json:"repo"`
	Location                 string   `json:"location"`
	PathID                   string   `json:"path_id,omitempty"`
	GroupedPathCount         int      `json:"grouped_path_count,omitempty"`
	GroupedPathIDs           []string `json:"grouped_path_ids,omitempty"`
	InventoryRisk            string   `json:"inventory_risk,omitempty"`
	AttackPathScore          float64  `json:"attack_path_score,omitempty"`
	ControlPriority          string   `json:"control_priority,omitempty"`
	RiskTier                 string   `json:"risk_tier,omitempty"`
	ControlState             string   `json:"control_state,omitempty"`
	RiskZone                 string   `json:"risk_zone,omitempty"`
	ReviewBurden             string   `json:"review_burden,omitempty"`
	ConfidenceLane           string   `json:"confidence_lane,omitempty"`
	CredentialAccess         bool     `json:"credential_access,omitempty"`
	ProductionTargetStatus   string   `json:"production_target_status,omitempty"`
	ProductionTargetSource   string   `json:"production_target_source,omitempty"`
	ProductionImpactInferred bool     `json:"production_impact_inferred,omitempty"`
	RecommendedAction        string   `json:"recommended_action,omitempty"`
	WriteCapable             bool     `json:"write_capable,omitempty"`
	ProductionWrite          bool     `json:"production_write,omitempty"`
	Rationale                []string `json:"rationale"`
	Remediation              string   `json:"remediation"`
}

type ScanScopeSummary struct {
	Mode           string `json:"mode"`
	ScopeLabel     string `json:"scope_label"`
	SourceBoundary string `json:"source_boundary"`
	RepoCount      int    `json:"repo_count"`
	TargetCount    int    `json:"target_count"`
}

type Section struct {
	ID     string         `json:"id"`
	Title  string         `json:"title"`
	Facts  []string       `json:"facts"`
	Impact string         `json:"impact"`
	Action string         `json:"action"`
	Proof  ProofReference `json:"proof"`
}

type SegmentMetadata struct {
	Industry string
	SizeBand string
}

type ShareProfile string

type ShareProfileMetadata struct {
	RedactionApplied     bool     `json:"redaction_applied"`
	RedactionVersion     string   `json:"redaction_version,omitempty"`
	PolicySummary        []string `json:"policy_summary,omitempty"`
	SelectedFields       []string `json:"selected_fields,omitempty"`
	ProfileDefaultFields []string `json:"profile_default_fields,omitempty"`
}

type Summary struct {
	SummaryVersion                   string                                 `json:"summary_version"`
	GeneratedAt                      string                                 `json:"generated_at"`
	Template                         string                                 `json:"template"`
	ShareProfile                     string                                 `json:"share_profile"`
	DeploymentMode                   string                                 `json:"deployment_mode,omitempty"`
	ShareProfileMetadata             *ShareProfileMetadata                  `json:"share_profile_metadata,omitempty"`
	ArtifactMetadata                 *ArtifactMetadata                      `json:"artifact_metadata,omitempty"`
	ArtifactBudget                   *ArtifactBudget                        `json:"artifact_budget,omitempty"`
	AppendixAvailable                bool                                   `json:"appendix_available,omitempty"`
	FocusedBundleAvailable           bool                                   `json:"focused_bundle_available,omitempty"`
	FullExportAvailable              bool                                   `json:"full_export_available,omitempty"`
	SectionOrder                     []string                               `json:"section_order"`
	Sections                         []Section                              `json:"sections"`
	Headline                         Headline                               `json:"headline"`
	ScanScope                        *ScanScopeSummary                      `json:"scan_scope,omitempty"`
	OperationalExposure              *scorecore.AxisSummary                 `json:"operational_exposure,omitempty"`
	GovernanceReadiness              *scorecore.AxisSummary                 `json:"governance_readiness,omitempty"`
	EvidenceCompleteness             *risk.EvidenceCompletenessSummary      `json:"evidence_completeness,omitempty"`
	ExecutiveRollup                  *controlbacklog.ExecutiveRollup        `json:"executive_rollup,omitempty"`
	GovernedUsageMetrics             *controlbacklog.GovernedUsageMetrics   `json:"governed_usage_metrics,omitempty"`
	WorkflowHighlights               *WorkflowHighlights                    `json:"workflow_highlights,omitempty"`
	FocusView                        *FocusView                             `json:"focus_view,omitempty"`
	RepeatUsageSignals               *RepeatUsageSignals                    `json:"repeat_usage_signals,omitempty"`
	AssessmentSummary                *AssessmentSummary                     `json:"assessment_summary,omitempty"`
	PublicSurfaceAssessment          *PublicSurfaceAssessment               `json:"public_surface_assessment,omitempty"`
	Methodology                      Methodology                            `json:"methodology"`
	TopRisks                         []RiskItem                             `json:"top_risks"`
	PrivilegeBudget                  agginventory.PrivilegeBudget           `json:"privilege_budget"`
	SecurityVisibility               agginventory.SecurityVisibilitySummary `json:"security_visibility"`
	Deltas                           DeltaSummary                           `json:"deltas"`
	Lifecycle                        LifecycleSummary                       `json:"lifecycle"`
	RegressDrift                     *RegressSummary                        `json:"regress_drift,omitempty"`
	AttackPaths                      AttackPathSummary                      `json:"attack_paths"`
	ComplianceSummary                compliance.RollupSummary               `json:"compliance_summary"`
	ControlBacklog                   *controlbacklog.Backlog                `json:"control_backlog,omitempty"`
	ScanQuality                      *scanquality.Report                    `json:"scan_quality,omitempty"`
	RuntimeSessions                  *ingest.SessionSummary                 `json:"runtime_sessions,omitempty"`
	RuntimeEvidence                  *ingest.Summary                        `json:"runtime_evidence,omitempty"`
	EvidencePackets                  *ingest.EvidencePacketSummary          `json:"evidence_packets,omitempty"`
	AgentActionBOM                   *AgentActionBOM                        `json:"agent_action_bom,omitempty"`
	RecentPRReview                   *RecentPRReview                        `json:"recent_pr_review,omitempty"`
	Proof                            ProofReference                         `json:"proof"`
	NextActions                      []ChecklistItem                        `json:"next_actions"`
	Activation                       *ActivationSummary                     `json:"activation,omitempty"`
	PolicyOutcomes                   []PolicyOutcome                        `json:"policy_outcomes,omitempty"`
	SuppressedCounts                 *SuppressedCounts                      `json:"suppressed_counts,omitempty"`
	ActionPaths                      []risk.ActionPath                      `json:"action_paths,omitempty"`
	ActionPathToControlFirst         *risk.ActionPathToControlFirst         `json:"action_path_to_control_first,omitempty"`
	ComposedActionPaths              []risk.ComposedActionPath              `json:"composed_action_paths,omitempty"`
	ComposedActionPathToControlFirst *risk.ComposedActionPathToControlFirst `json:"composed_action_path_to_control_first,omitempty"`
	ActionSurfaceRegistry            []ActionSurfaceRegistryEntry           `json:"action_surface_registry,omitempty"`
	ControlPathGraph                 *aggattack.ControlPathGraph            `json:"control_path_graph,omitempty"`
	WorkflowChains                   *agentresolver.WorkflowChainArtifact   `json:"workflow_chains,omitempty"`
	ExposureGroups                   []risk.ExposureGroup                   `json:"exposure_groups,omitempty"`
	SourcePrivacy                    *sourceprivacy.Contract                `json:"source_privacy,omitempty"`
	// contains filtered or unexported fields
}

type SuppressedCounts = outputsignal.SuppressedCounts

type Template string

type WorkflowHighlight struct {
	PathID               string   `json:"path_id"`
	WorkflowChainRefs    []string `json:"workflow_chain_refs,omitempty"`
	Repo                 string   `json:"repo,omitempty"`
	Workflow             string   `json:"workflow,omitempty"`
	PathType             string   `json:"path_type,omitempty"`
	TargetClass          string   `json:"target_class,omitempty"`
	AutonomyTier         string   `json:"autonomy_tier,omitempty"`
	DelegationReadiness  string   `json:"delegation_readiness,omitempty"`
	Authority            string   `json:"authority,omitempty"`
	BlastRadius          string   `json:"blast_radius,omitempty"`
	EvidenceSummary      string   `json:"evidence_summary,omitempty"`
	ApprovalPath         string   `json:"approval_path,omitempty"`
	ProofStatus          string   `json:"proof_status,omitempty"`
	RuntimeStatus        string   `json:"runtime_status,omitempty"`
	RuntimeSessionStatus string   `json:"runtime_session_status,omitempty"`
	Recommendation       string   `json:"recommendation,omitempty"`
	BoundaryLabel        string   `json:"boundary_label,omitempty"`
	Explanation          string   `json:"explanation,omitempty"`
}

type WorkflowHighlights struct {
	TotalItems int                 `json:"total_items"`
	Highlights []WorkflowHighlight `json:"highlights,omitempty"`
	// contains filtered or unexported fields
}