configcmd

type Deps struct {
	// ConfigFlag returns the raw --config flag value (may be empty).
	ConfigFlag func() string
	// Force returns the --force flag value.
	Force func() bool
	// Reinitialize regenerates ~/.vigolium with fresh defaults (used by `config clean`).
	Reinitialize func() error

	// JSON reports whether the caller asked for machine output. The config
	// commands accepted the persistent --json flag and ignored it, printing
	// ANSI-colored prose to stdout and exiting 0 — so a consumer's parse failed
	// for a reason the exit code did not describe.
	JSON func() bool
	// WriteJSON emits a result through the CLI's shared envelope writer, so a
	// config result has the same schema_version/items/generated_at spine as every
	// other -j payload rather than a second shape invented here. total is the row
	// count, which the caller already knows — passing it avoids reflecting over
	// the slice on the other side of the seam. cmd names the document.
	WriteJSON func(cmd *cobra.Command, legacyKey string, items any, total int, extra map[string]any) error
	// WriteMutation emits a state-changing command's result through the CLI's
	// mutation spine (kind "mutation", changed, action, dry_run). changed and
	// action are arguments, not extras: the envelope owns those keys, and an
	// extra named "changed" is dropped rather than rendered.
	WriteMutation func(cmd *cobra.Command, items any, changed bool, action string, extra map[string]any) error

	// RecentScanTargets returns the targets of the n most recent scans in the
	// given project ("" = the project the CLI resolves by default), for
	// `config validate`'s scope_include_matches_no_recent_target rule. Injected
	// because this package cannot reach the database. nil, or an error (no
	// database yet), skips the rule.
	RecentScanTargets func(projectUUID string, n int) ([]string, error)
}

type Examples struct {
	Parent   string
	Ls       string
	Set      string
	Clean    string
	Validate string
}