cmd

type AuditCmd struct {
	Linux    LinuxAuditCmd   `cmd:"" help:"Audit Linux packages"`
	Windows  WindowsAuditCmd `cmd:"" help:"Audit Windows KB updates"`
	Host     HostAuditCmd    `cmd:"" help:"Audit host packages (v4 API)"`
	Winaudit WinFullAuditCmd `cmd:"" name:"winaudit" help:"Full Windows audit (KBs + software)"`
}

type AutocompleteCmd struct {
	Query string `arg:"" help:"Partial query to autocomplete"`
}

type CLI struct {
	// Global flags
	Output      string   `` /* 131-byte string literal not displayed */
	Quiet       bool     `help:"Suppress non-error output" short:"q"`
	Verbose     bool     `help:"Enable verbose/debug output" short:"v"`
	Offline     bool     `help:"Use offline database only"`
	Agent       bool     `help:"Machine-friendly mode: JSON output, quiet, deterministic ordering, no color"`
	NoColor     bool     `help:"Disable colored log output" name:"no-color"`
	OutputFile  string   `help:"Write output to file instead of stdout" name:"output-file" type:"path"`
	MaxFindings int      `help:"Maximum findings to include in output (0 = unlimited)" default:"0" name:"max-findings"`
	SummaryOnly bool     `help:"Output summary and top findings only (omit full lists)" name:"summary-only"`
	FailOn      string   `help:"Fail with exit code 1 if findings at or above severity (low, medium, high, critical)" default:""`
	Ignore      []string `help:"CVE IDs to ignore"`
	VEX         string   `help:"Path to OpenVEX document for suppression"`
	Fields      []string `help:"Select top-level JSON fields to include in output (JSON only)" name:"fields"`
	Plan        bool     `help:"Show what a scan would do without executing it" name:"plan"`

	// Commands
	Version      VersionCmd      `cmd:"" help:"Print version information"`
	Search       SearchCmd       `cmd:"" help:"Search Vulners database"`
	CVE          CVECmd          `cmd:"" name:"cve" help:"Look up a CVE by ID"`
	CPE          CPECmd          `cmd:"" name:"cpe" help:"Search by CPE"`
	Audit        AuditCmd        `cmd:"" help:"Audit OS packages"`
	Scan         ScanCmd         `cmd:"" help:"Scan targets for vulnerabilities"`
	Offline_     OfflineCmd      `cmd:"" name:"offline" help:"Manage offline database"`
	STIX         StixCmd         `cmd:"" name:"stix" help:"Export STIX bundle for a bulletin or CVE"`
	Autocomplete AutocompleteCmd `cmd:"" help:"Autocomplete a Vulners search query"`
	Suggest      SuggestCmd      `cmd:"" help:"Get field value suggestions for search queries"`
	Doctor       DoctorCmd       `cmd:"" help:"Run environment health checks"`
	Spec         SpecCmd         `cmd:"" help:"Output machine-readable command and flag definitions"`
	Report       ReportCmd       `cmd:"" help:"Account-level vulnerability reports"`
	Webhook      WebhookCmd      `cmd:"" help:"Manage search query webhooks"`
	Subscription SubscriptionCmd `cmd:"" help:"Manage alert subscriptions"`
	VScan        VScanCmd        `cmd:"" name:"vscan" help:"Manage VScanner remote vulnerability scans"`
	MCP          MCPCmd          `cmd:"" name:"mcp" help:"Run as MCP (Model Context Protocol) server"`
}

type CPECmd struct {
	Product string `arg:"" help:"Product name to search"`
	Vendor  string `help:"Vendor name" default:""`
	Limit   int    `help:"Maximum results to return" default:"10"`
}

type CVECmd struct {
	ID         string `arg:"" help:"CVE identifier (e.g. CVE-2021-44228)"`
	References bool   `help:"Include external references"`
	History    bool   `help:"Include change history"`
}

type CVEOutput struct {
	Bulletin   *vulners.Bulletin      `json:"bulletin"`
	References []string               `json:"references,omitempty"`
	History    []vulners.HistoryEntry `json:"history,omitempty"`
}

type CheckResult struct {
	Name        string `json:"name"`
	Status      string `json:"status"` // "pass", "fail", "warn"
	Message     string `json:"message,omitempty"`
	Remediation string `json:"remediation,omitempty"`
}

type Deps struct {
	Intel    intel.Client
	VScanner intel.VScannerClient
}

type DistroMeta struct {
	Name    string `json:"name"`
	Version string `json:"version"`
}

type DoctorCmd struct{}

type DoctorOutput struct {
	Checks  []CheckResult `json:"checks"`
	AllPass bool          `json:"allPass"`
}

type HostAuditCmd struct {
	OS       string   `help:"Operating system name (e.g. ubuntu, centos)" required:""`
	Version  string   `help:"OS version (e.g. 22.04, 8)" required:""`
	Packages []string `help:"Packages in 'name version' format" required:""`
}

type ImageMeta struct {
	Distro      *DistroMeta `json:"distro,omitempty"`
	OSPackages  int         `json:"osPackages"`
	AppPackages int         `json:"appPackages"`
	AuditMode   string      `json:"auditMode"` // "hybrid", "sbom", "offline"
}

type IntelOutput struct {
	SchemaVersion string `json:"schemaVersion"`
	Command       string `json:"command"`
	Data          any    `json:"data"`
	Meta          any    `json:"meta,omitempty"`
}

type LinuxAuditCmd struct {
	Distro  string   `help:"Linux distribution name (e.g. ubuntu, debian, centos)" required:""`
	Version string   `help:"Distribution version (e.g. 22.04)" required:""`
	Pkg     []string `help:"Package as name=version or 'name version arch'. Deb-based distros require arch (auto-detected if omitted)." required:""`
	Arch    string   `help:"Default architecture to append when not specified in --pkg (e.g. amd64)" default:""`
}

type MCPCmd struct{}

type OfflineCmd struct {
	Sync   OfflineSyncCmd   `cmd:"" help:"Sync vulnerability data for offline use"`
	Status OfflineStatusCmd `cmd:"" help:"Show offline database status"`
	Purge  OfflinePurgeCmd  `cmd:"" help:"Purge offline database"`
}

type OfflinePurgeCmd struct{}

type OfflineStatusCmd struct{}

type OfflineSyncCmd struct {
	Collections []string `help:"Collections to sync (e.g. cve,exploit,debian)" default:"cve"`
	Full        bool     `help:"Force full sync even if recent data exists"`
}

type PlanOutput struct {
	Target         string            `json:"target"`
	Mode           string            `json:"mode"` // "online" or "offline"
	ComponentCount int               `json:"componentCount"`
	Ecosystems     map[string]int    `json:"ecosystems"`
	HasAPIKey      bool              `json:"hasApiKey"`
	Components     []model.Component `json:"components,omitempty"`
}

type ReportCmd struct {
	Summary ReportSummaryCmd `cmd:"" help:"Aggregated vulnerability summary"`
	Vulns   ReportVulnsCmd   `cmd:"" help:"List known vulnerabilities"`
	Hosts   ReportHostsCmd   `cmd:"" help:"Host vulnerability status"`
	Scans   ReportScansCmd   `cmd:"" help:"Scan history"`
	IPs     ReportIPsCmd     `cmd:"" name:"ips" help:"IP-level vulnerability summary"`
}

type ReportHostsCmd struct {
	Limit  int `help:"Maximum results" default:"100"`
	Offset int `help:"Result offset" default:"0"`
}

type ReportIPsCmd struct{}

type ReportScansCmd struct {
	Limit  int `help:"Maximum results" default:"100"`
	Offset int `help:"Result offset" default:"0"`
}

type ReportSummaryCmd struct {
	Limit  int `help:"Maximum results" default:"100"`
	Offset int `help:"Result offset" default:"0"`
}

type ReportVulnsCmd struct {
	Limit  int `help:"Maximum results" default:"100"`
	Offset int `help:"Result offset" default:"0"`
}

type ScanCmd struct {
	Repo  ScanRepoCmd  `cmd:"" help:"Scan a repository for vulnerabilities"`
	SBOM  ScanSBOMCmd  `cmd:"" name:"sbom" help:"Scan an SBOM file"`
	Image ScanImageCmd `cmd:"" help:"Scan a container image"`
	Dir   ScanDirCmd   `cmd:"" help:"Scan a directory for package manifests"`
}

type ScanDirCmd struct {
	Path string `arg:"" help:"Directory path to scan" default:"."`
}

type ScanImageCmd struct {
	Image  string `arg:"" help:"Image reference (e.g. alpine:3.18, ./image.tar)"`
	Distro string `help:"Override auto-detected distro (format: name/version, e.g. alpine/3.18)" name:"distro" default:""`
}

type ScanOutput struct {
	SchemaVersion string            `json:"schemaVersion"`
	Target        string            `json:"target"`
	Components    []model.Component `json:"components"`
	Findings      []model.Finding   `json:"findings"`
	Summary       ScanSummary       `json:"summary"`
	TopFindings   []model.Finding   `json:"topFindings,omitempty"`
	Truncated     bool              `json:"truncated,omitempty"`
	TotalFindings int               `json:"totalFindings,omitempty"`
	ImageMeta     *ImageMeta        `json:"imageMeta,omitempty"`
}

type ScanRepoCmd struct {
	Path string `arg:"" help:"Path to repository" default:"."`
}

type ScanSBOMCmd struct {
	File   string `arg:"" help:"Path to SBOM file"`
	Format string `help:"SBOM format (cyclonedx, spdx)" enum:"cyclonedx,spdx" default:"cyclonedx"`
}

type ScanSummary struct {
	ComponentCount int `json:"componentCount"`
	FindingCount   int `json:"findingCount"`
	Critical       int `json:"critical"`
	High           int `json:"high"`
	Medium         int `json:"medium"`
	Low            int `json:"low"`
	ExploitedCount int `json:"exploitedCount,omitempty"`
	HighEPSSCount  int `json:"highEpssCount,omitempty"`
}

type SearchCmd struct {
	Query    string `arg:"" help:"Lucene search query"`
	Limit    int    `help:"Maximum results to return" default:"10"`
	Offset   int    `help:"Result offset for pagination" default:"0"`
	Exploits bool   `help:"Search exploits only"`
}

type SpecArg struct {
	Name     string `json:"name"`
	Help     string `json:"help,omitempty"`
	Required bool   `json:"required,omitempty"`
}

type SpecCmd struct {
	Schema string `help:"Generate JSON Schema for a command's output (use 'list' to see available)" name:"schema" default:""`
}

type SpecCommand struct {
	Name     string        `json:"name"`
	Help     string        `json:"help,omitempty"`
	Aliases  []string      `json:"aliases,omitempty"`
	Hidden   bool          `json:"hidden,omitempty"`
	Flags    []SpecFlag    `json:"flags,omitempty"`
	Args     []SpecArg     `json:"args,omitempty"`
	Commands []SpecCommand `json:"commands,omitempty"`
}

type SpecFlag struct {
	Name     string `json:"name"`
	Help     string `json:"help,omitempty"`
	Type     string `json:"type,omitempty"`
	Default  string `json:"default,omitempty"`
	Enum     string `json:"enum,omitempty"`
	Required bool   `json:"required,omitempty"`
	Short    string `json:"short,omitempty"`
	Hidden   bool   `json:"hidden,omitempty"`
}

type SpecOutput struct {
	Commands []SpecCommand `json:"commands"`
	Globals  []SpecFlag    `json:"globals"`
}

type StixCmd struct {
	ID    string `arg:"" help:"Bulletin or CVE identifier"`
	ByCVE bool   `help:"Look up by CVE ID instead of bulletin ID"`
}

type SubscriptionCmd struct {
	List    SubscriptionListCmd    `cmd:"" help:"List all subscriptions"`
	Get     SubscriptionGetCmd     `cmd:"" help:"Get a subscription by ID"`
	Create  SubscriptionCreateCmd  `cmd:"" help:"Create a new subscription"`
	Update  SubscriptionUpdateCmd  `cmd:"" help:"Update an existing subscription"`
	Delete  SubscriptionDeleteCmd  `cmd:"" help:"Delete a subscription"`
	Enable  SubscriptionEnableCmd  `cmd:"" help:"Enable a subscription"`
	Disable SubscriptionDisableCmd `cmd:"" help:"Disable a subscription"`
}

type SubscriptionCreateCmd struct {
	Name   string `help:"Subscription name" required:""`
	Type   string `help:"Subscription type" required:""`
	Query  string `help:"Search query" required:""`
	Config string `help:"JSON config string" default:""`
}

type SubscriptionDeleteCmd struct {
	ID string `arg:"" help:"Subscription ID"`
}

type SubscriptionDisableCmd struct {
	ID string `arg:"" help:"Subscription ID"`
}

type SubscriptionEnableCmd struct {
	ID string `arg:"" help:"Subscription ID"`
}

type SubscriptionGetCmd struct {
	ID string `arg:"" help:"Subscription ID"`
}

type SubscriptionListCmd struct{}

type SubscriptionUpdateCmd struct {
	ID     string `arg:"" help:"Subscription ID"`
	Name   string `help:"Subscription name"`
	Type   string `help:"Subscription type"`
	Query  string `help:"Search query"`
	Config string `help:"JSON config string"`
}

type SuggestCmd struct {
	Field string `arg:"" help:"Field name to get suggestions for (e.g. type, bulletinFamily)"`
}

type VScanCmd struct {
	Project VScanProjectCmd `cmd:"" help:"Manage VScanner projects"`
	Task    VScanTaskCmd    `cmd:"" help:"Manage VScanner scan tasks"`
	Result  VScanResultCmd  `cmd:"" help:"Access VScanner scan results"`
	License VScanLicenseCmd `cmd:"" help:"Show VScanner license information"`
}

type VScanLicenseCmd struct{}

type VScanProjectCmd struct {
	List   VScanProjectListCmd   `cmd:"" help:"List all projects"`
	Get    VScanProjectGetCmd    `cmd:"" help:"Get a project by ID"`
	Create VScanProjectCreateCmd `cmd:"" help:"Create a new project"`
	Update VScanProjectUpdateCmd `cmd:"" help:"Update a project"`
	Delete VScanProjectDeleteCmd `cmd:"" help:"Delete a project"`
}

type VScanProjectCreateCmd struct {
	Name        string `help:"Project name" required:""`
	Description string `help:"Project description" default:""`
	License     string `help:"License ID to use" default:""`
}

type VScanProjectDeleteCmd struct {
	ID string `arg:"" help:"Project ID"`
}

type VScanProjectGetCmd struct {
	ID string `arg:"" help:"Project ID"`
}

type VScanProjectListCmd struct {
	Limit  int `help:"Maximum items to return" default:"100"`
	Offset int `help:"Pagination offset" default:"0"`
}

type VScanProjectUpdateCmd struct {
	ID          string `arg:"" help:"Project ID"`
	Name        string `help:"Project name" required:""`
	Description string `help:"Project description" default:""`
}

type VScanResultCmd struct {
	List   VScanResultListCmd   `cmd:"" help:"List scan results for a project"`
	Get    VScanResultGetCmd    `cmd:"" help:"Get a scan result"`
	Stats  VScanResultStatsCmd  `cmd:"" help:"Get statistics for a scan result"`
	Hosts  VScanResultHostsCmd  `cmd:"" help:"List hosts from a scan result"`
	Host   VScanResultHostCmd   `cmd:"" help:"Get detailed host information"`
	Vulns  VScanResultVulnsCmd  `cmd:"" help:"List vulnerabilities from a scan result"`
	Delete VScanResultDeleteCmd `cmd:"" help:"Delete a scan result"`
	Export VScanResultExportCmd `cmd:"" help:"Export a scan result"`
}

type VScanResultDeleteCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	ResultID  string `arg:"" help:"Result ID"`
}

type VScanResultExportCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	ResultID  string `arg:"" help:"Result ID"`
	Format    string `help:"Export format" enum:"pdf,csv,json,xml" default:"json" name:"format"`
}

type VScanResultGetCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	ResultID  string `arg:"" help:"Result ID"`
}

type VScanResultHostCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	ResultID  string `arg:"" help:"Result ID"`
	Host      string `arg:"" help:"Host identifier or IP"`
}

type VScanResultHostsCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	ResultID  string `arg:"" help:"Result ID"`
	Limit     int    `help:"Maximum items to return" default:"100"`
	Offset    int    `help:"Pagination offset" default:"0"`
}

type VScanResultListCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	Limit     int    `help:"Maximum items to return" default:"100"`
	Offset    int    `help:"Pagination offset" default:"0"`
}

type VScanResultStatsCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	ResultID  string `arg:"" help:"Result ID"`
}

type VScanResultVulnsCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	ResultID  string `arg:"" help:"Result ID"`
	Limit     int    `help:"Maximum items to return" default:"100"`
	Offset    int    `help:"Pagination offset" default:"0"`
}

type VScanTaskCmd struct {
	List   VScanTaskListCmd   `cmd:"" help:"List tasks in a project"`
	Get    VScanTaskGetCmd    `cmd:"" help:"Get a task by ID"`
	Create VScanTaskCreateCmd `cmd:"" help:"Create a scan task"`
	Update VScanTaskUpdateCmd `cmd:"" help:"Update a scan task"`
	Start  VScanTaskStartCmd  `cmd:"" help:"Start a scan task"`
	Stop   VScanTaskStopCmd   `cmd:"" help:"Stop a running scan task"`
	Delete VScanTaskDeleteCmd `cmd:"" help:"Delete a scan task"`
}

type VScanTaskCreateCmd struct {
	ProjectID      string   `arg:"" help:"Project ID"`
	Name           string   `help:"Task name" required:""`
	Description    string   `help:"Task description" default:""`
	Targets        []string `help:"Scan targets (IPs, hostnames, CIDR ranges)" required:""`
	ScanType       string   `help:"Scan type" enum:"fast,normal,full" default:"normal" name:"scan-type"`
	Ports          string   `help:"Port range or list (e.g. 1-1000, 22,80,443)" default:""`
	MaxConcurrency int      `help:"Maximum concurrent scan threads" default:"0" name:"max-concurrency"`
}

type VScanTaskDeleteCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	TaskID    string `arg:"" help:"Task ID"`
}

type VScanTaskGetCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	TaskID    string `arg:"" help:"Task ID"`
}

type VScanTaskListCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	Limit     int    `help:"Maximum items to return" default:"100"`
	Offset    int    `help:"Pagination offset" default:"0"`
}

type VScanTaskStartCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	TaskID    string `arg:"" help:"Task ID"`
}

type VScanTaskStopCmd struct {
	ProjectID string `arg:"" help:"Project ID"`
	TaskID    string `arg:"" help:"Task ID"`
}

type VScanTaskUpdateCmd struct {
	ProjectID   string   `arg:"" help:"Project ID"`
	TaskID      string   `arg:"" help:"Task ID"`
	Name        string   `help:"Task name" required:""`
	Description string   `help:"Task description" default:""`
	Targets     []string `help:"Scan targets (IPs, hostnames, CIDR ranges)"`
}

type VersionCmd struct{}

type VersionInfo struct {
	Version   string `json:"version"`
	Commit    string `json:"commit"`
	Date      string `json:"date"`
	GoVersion string `json:"goVersion"`
}

type WebhookAddCmd struct {
	Query string `arg:"" help:"Search query for the webhook"`
}

type WebhookCmd struct {
	List    WebhookListCmd    `cmd:"" help:"List all webhooks"`
	Add     WebhookAddCmd     `cmd:"" help:"Create a webhook for a search query"`
	Get     WebhookGetCmd     `cmd:"" help:"Get a webhook by ID"`
	Read    WebhookReadCmd    `cmd:"" help:"Read new data from a webhook"`
	Enable  WebhookEnableCmd  `cmd:"" help:"Enable a webhook"`
	Disable WebhookDisableCmd `cmd:"" help:"Disable a webhook"`
	Delete  WebhookDeleteCmd  `cmd:"" help:"Delete a webhook"`
}

type WebhookDeleteCmd struct {
	ID string `arg:"" help:"Webhook ID"`
}

type WebhookDisableCmd struct {
	ID string `arg:"" help:"Webhook ID"`
}

type WebhookEnableCmd struct {
	ID string `arg:"" help:"Webhook ID"`
}

type WebhookGetCmd struct {
	ID string `arg:"" help:"Webhook ID"`
}

type WebhookListCmd struct{}

type WebhookReadCmd struct {
	ID         string `arg:"" help:"Webhook ID"`
	NewestOnly bool   `help:"Only return data since last read" default:"true" name:"newest-only"`
}

type WinFullAuditCmd struct {
	OS       string   `help:"Windows version (e.g. 'Windows 10')" required:""`
	Version  string   `help:"OS build version" required:""`
	KB       []string `help:"Installed KB numbers"`
	Software []string `help:"Installed software in 'name version' format"`
}

type WindowsAuditCmd struct {
	OS string   `help:"Windows OS version (e.g. 'Windows 10')" default:"Windows 10"`
	KB []string `help:"Installed KB identifiers" required:""`
}