subcommands

var ClearCmd = &cobra.Command{
	Use:   "clear",
	Short: "Clear the semantic analysis cache",
	Long: "\nClear entries from the semantic analysis cache.\n\n" +
		"By default, this command requires a flag to specify what to clear:\n" +
		"  --all    Clear all cached entries\n" +
		"  --stale  Clear only stale entries (non-current versions)\n\n" +
		"Cleared entries will be re-analyzed on next daemon rebuild or when " +
		"the corresponding files are modified.",
	PreRunE: validateClear,
	RunE:    runClear,
}

var StatusCmd = &cobra.Command{
	Use:   "status",
	Short: "Show cache statistics",
	Long: "\nShow statistics about the semantic analysis cache.\n\n" +
		"Displays the total number of cached entries, their size, and version distribution. " +
		"Legacy entries (v0.0.0) are entries created before versioning was implemented and " +
		"will be re-analyzed on next daemon rebuild.",
	PreRunE: validateStatus,
	RunE:    runStatus,
}