feat: add comprehensive Lucene search query examples to OpenAPI definitions

Added 34 search query examples to types/types.go covering all Lucene search capabilities:

- Basic field search (exact match, wildcards)
- Boolean operators (AND, OR, NOT)
- Required/Prohibited operators (+, -)
- Range queries (inclusive, exclusive, open-ended, date ranges)
- Quoted phrases and special characters
- Complex nested queries
- Implicit search across all string fields
- JSONB/nested field access with dot notation
- Null value queries
- Fuzzy search with edit distance

These examples can be referenced in Swagger annotations using:
  $ref: "#/components/examples/SearchQueryBasic"
  $ref: "#/components/examples/SearchQueryWildcard"
etc.

This allows API consumers to easily understand and use the Lucene query syntax
for filtering and searching resources, similar to how PatchBody provides examples
for PATCH operations.

Related to PR tink3rlabs#124 which added Lucene search support.

Author: claude

types/types.go

@@ -137,6 +137,178 @@ const definitions = `
 			}
 			}
 		}
+		},
+		"examples": {
+		"SearchQueryBasic": {
+			"summary": "Basic field search",
+			"description": "Search for exact match on a specific field",
+			"value": "name:john"
+		},
+		"SearchQueryWildcard": {
+			"summary": "Wildcard search",
+			"description": "Use wildcards (* or ?) for partial matching",
+			"value": "name:john* OR email:*@example.com"
+		},
+		"SearchQueryWildcardPrefix": {
+			"summary": "Prefix wildcard search",
+			"description": "Match values starting with a prefix",
+			"value": "name:john*"
+		},
+		"SearchQueryWildcardSuffix": {
+			"summary": "Suffix wildcard search",
+			"description": "Match values ending with a suffix",
+			"value": "email:*@example.com"
+		},
+		"SearchQueryWildcardContains": {
+			"summary": "Contains wildcard search",
+			"description": "Match values containing a substring",
+			"value": "description:*important*"
+		},
+		"SearchQueryBooleanAND": {
+			"summary": "Boolean AND operator",
+			"description": "Combine multiple conditions that must all be true",
+			"value": "name:john AND status:active"
+		},
+		"SearchQueryBooleanOR": {
+			"summary": "Boolean OR operator",
+			"description": "Match any of the specified conditions",
+			"value": "status:active OR status:pending"
+		},
+		"SearchQueryBooleanNOT": {
+			"summary": "Boolean NOT operator",
+			"description": "Exclude results matching a condition",
+			"value": "name:john NOT status:inactive"
+		},
+		"SearchQueryRequired": {
+			"summary": "Required term (+)",
+			"description": "Term must be present in results",
+			"value": "+name:john +status:active"
+		},
+		"SearchQueryProhibited": {
+			"summary": "Prohibited term (-)",
+			"description": "Exclude results containing this term",
+			"value": "name:john -status:deleted"
+		},
+		"SearchQueryRangeInclusive": {
+			"summary": "Inclusive range query",
+			"description": "Match values within a range (inclusive boundaries)",
+			"value": "age:[25 TO 65]"
+		},
+		"SearchQueryRangeExclusive": {
+			"summary": "Exclusive range query",
+			"description": "Match values within a range (exclusive boundaries)",
+			"value": "age:{25 TO 65}"
+		},
+		"SearchQueryRangeOpenMin": {
+			"summary": "Open-ended range (minimum)",
+			"description": "Match values greater than or equal to minimum",
+			"value": "age:[25 TO *]"
+		},
+		"SearchQueryRangeOpenMax": {
+			"summary": "Open-ended range (maximum)",
+			"description": "Match values less than or equal to maximum",
+			"value": "age:[* TO 65]"
+		},
+		"SearchQueryRangeDate": {
+			"summary": "Date range query",
+			"description": "Match dates within a specified range",
+			"value": "created_at:[2024-01-01 TO 2024-12-31]"
+		},
+		"SearchQueryQuotedPhrase": {
+			"summary": "Quoted phrase search",
+			"description": "Search for exact phrase match",
+			"value": "description:\"hello world\""
+		},
+		"SearchQueryQuotedSpecialChars": {
+			"summary": "Quoted phrase with special characters",
+			"description": "Preserve special characters in search",
+			"value": "title:\"test-app (v1.0)\""
+		},
+		"SearchQueryEscaped": {
+			"summary": "Escaped special characters",
+			"description": "Escape special characters with backslash",
+			"value": "name:C\\+\\+ OR path:\\/usr\\/bin"
+		},
+		"SearchQueryComplex": {
+			"summary": "Complex nested query",
+			"description": "Combine multiple operators with grouping",
+			"value": "(name:john* OR email:*@example.com) AND status:active AND age:[25 TO 65]"
+		},
+		"SearchQueryComplexNested": {
+			"summary": "Complex nested with multiple groups",
+			"description": "Advanced query with nested conditions",
+			"value": "((name:john OR name:jane) AND status:active) OR (status:pending AND age:[18 TO *])"
+		},
+		"SearchQueryImplicit": {
+			"summary": "Implicit search",
+			"description": "Search across all string fields without specifying field name",
+			"value": "searchterm"
+		},
+		"SearchQueryImplicitWildcard": {
+			"summary": "Implicit search with wildcard",
+			"description": "Wildcard search across all string fields",
+			"value": "john*"
+		},
+		"SearchQueryJSONB": {
+			"summary": "JSONB field access",
+			"description": "Search within nested JSONB fields using dot notation",
+			"value": "labels.category:production"
+		},
+		"SearchQueryJSONBWildcard": {
+			"summary": "JSONB field with wildcard",
+			"description": "Wildcard search on nested JSONB fields",
+			"value": "metadata.tags:prod*"
+		},
+		"SearchQueryJSONBComplex": {
+			"summary": "Complex JSONB query",
+			"description": "Combine JSONB and regular field searches",
+			"value": "name:john AND labels.env:prod AND metadata.team:engineering"
+		},
+		"SearchQueryNull": {
+			"summary": "Null value search",
+			"description": "Find records where field is null",
+			"value": "parent_id:null"
+		},
+		"SearchQueryNotNull": {
+			"summary": "Not null search",
+			"description": "Find records where field is not null",
+			"value": "NOT deleted_at:null"
+		},
+		"SearchQueryNullCombined": {
+			"summary": "Null with other conditions",
+			"description": "Combine null checks with other filters",
+			"value": "name:john AND deleted_at:null"
+		},
+		"SearchQueryFuzzy": {
+			"summary": "Fuzzy search",
+			"description": "Find similar matches using fuzzy matching (~)",
+			"value": "name:roam~"
+		},
+		"SearchQueryFuzzyDistance": {
+			"summary": "Fuzzy search with edit distance",
+			"description": "Fuzzy matching with specified edit distance",
+			"value": "name:roam~2"
+		},
+		"SearchQueryFuzzyJSONB": {
+			"summary": "Fuzzy search on JSONB field",
+			"description": "Fuzzy matching on nested JSONB fields",
+			"value": "labels.tag:prod~"
+		},
+		"SearchQueryMixed": {
+			"summary": "Mixed search operators",
+			"description": "Combine required, prohibited, ranges, and wildcards",
+			"value": "+name:john* -status:deleted age:[25 TO 65] AND (role:admin OR role:moderator)"
+		},
+		"SearchQueryMultiField": {
+			"summary": "Multi-field search",
+			"description": "Search across multiple fields with different conditions",
+			"value": "name:john OR email:john@example.com OR phone:*555*"
+		},
+		"SearchQueryProduction": {
+			"summary": "Production-ready search example",
+			"description": "Real-world example combining multiple features",
+			"value": "(name:*admin* OR role:administrator) AND status:active AND NOT deleted_at:null AND created_at:[2024-01-01 TO *]"
+		}
 		}
 	}
 }