Wave 2: CLI skeleton, cache write, config system, spec indexer (bd-3d2, bd-1ie, bd-1sb, bd-189)

src/cli/search.rs

@@ -0,0 +1,21 @@
+use clap::Args as ClapArgs;
+
+use crate::errors::SwaggerCliError;
+
+/// Search endpoints by keyword
+#[derive(Debug, ClapArgs)]
+pub struct Args {
+    /// Alias of the cached spec
+    pub alias: String,
+
+    /// Search query
+    pub query: String,
+
+    /// Maximum number of results
+    #[arg(long, default_value = "20")]
+    pub limit: usize,
+}
+
+pub async fn execute(_args: &Args, _robot: bool) -> Result<(), SwaggerCliError> {
+    Err(SwaggerCliError::Usage("search not yet implemented".into()))
+}