feat: add --semantic-query to all function-targeted commands

Adds natural-language entry point discovery via HNSW embeddings:
- query::semantic module (Ollama embedding + HNSW search)
- --semantic-query flag on paths, cfg, dominators, loops, patterns,
  frontiers, coverage, risk, suggest, hotpaths
- resolve_function_or_semantic helper in storage::operations
- MirageDb::path() getter for db path access

Author: oldnordic

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to Mirage are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.8.0] - 2026-06-08
+
+### Added
+
+- **`--semantic-query` flag** for all function-targeted commands (`paths`, `cfg`, `dominators`, `loops`, `patterns`, `frontiers`, `coverage`, `risk`, `suggest`, `hotpaths`) — resolves natural-language queries to function entry points via HNSW embeddings (generated by Magellan, queried via Ollama). Falls back to exact `--function` name resolution when `--semantic-query` is not provided.
+- **`query::semantic` module** — Query embedding via Ollama, HNSW index search via sqlitegraph, entity resolution from `graph_entities`.
+- **`resolve_function_or_semantic()` helper** — Centralized resolution that checks HNSW index existence before calling Ollama, filters by `--file` disambiguation, and returns the top semantic match.
+
 ## [1.7.0] - 2026-05-29
 
 ### Added

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "mirage-analyzer"
-version = "1.7.0"
+version = "1.8.0"
 edition = "2021"
 rust-version = "1.70"
 authors = ["Mirage Contributors"]
@@ -51,6 +51,10 @@ tracing-subscriber = { version = "0.3", features = ["env-filter"] }
 anyhow = "1.0"
 thiserror = "1.0"
 
+# Semantic search
+ureq = "3"
+toml = "0.8"
+
 # Utils
 blake3 = "1.5"
 sha2 = "0.10"

Cargo.toml

@@ -50,6 +50,7 @@ allow = [
     "Zlib",
     "BSL-1.0",
     "Apache-2.0 WITH LLVM-exception",
+    "CDLA-Permissive-2.0",
 ]
 exceptions = [
     { allow = ["OpenSSL"], name = "ring", version = "*" },

deny.toml

@@ -3,8 +3,9 @@ use crate::output;
 use anyhow::Result;
 
 pub fn cfg(args: &CfgArgs, cli: &Cli) -> Result<()> {
+    use crate::cfg::load_cfg_from_db;
     use crate::cfg::{export_dot, export_json, CFGExport};
-    use crate::cfg::{load_cfg_from_db, resolve_function_name_with_file};
+    use crate::storage::resolve_function_or_semantic;
     use crate::storage::MirageDb;
 
     // Resolve database path
@@ -28,26 +29,31 @@ pub fn cfg(args: &CfgArgs, cli: &Cli) -> Result<()> {
         }
     };
 
-    // Resolve function name/ID to function_id (with optional file filter)
-    let function_id =
-        match resolve_function_name_with_file(&db, &args.function, args.file.as_deref()) {
-            Ok(id) => id,
-            Err(_e) => {
-                if matches!(cli.output, OutputFormat::Json | OutputFormat::Pretty) {
-                    let error = output::JsonError::function_not_found(&args.function);
-                    let wrapper = output::JsonResponse::new(error);
-                    println!("{}", wrapper.to_json());
-                    std::process::exit(output::EXIT_DATABASE);
-                } else {
-                    output::error(&format!(
-                        "Function '{}' not found in database",
-                        args.function
-                    ));
-                    output::info(&format!("Hint: {}", output::R_HINT_LIST_FUNCTIONS));
-                    std::process::exit(output::EXIT_DATABASE);
-                }
+    // Resolve function name/ID or semantic query to function_id (with optional file filter)
+    let function_id = match resolve_function_or_semantic(
+        &db,
+        &args.function,
+        args.semantic_query.as_deref(),
+        args.file.as_deref(),
+    ) {
+        Ok(id) => id,
+        Err(e) => {
+            if matches!(cli.output, OutputFormat::Json | OutputFormat::Pretty) {
+                let error = output::JsonError::new(
+                    "FunctionNotFound",
+                    &format!("{}", e),
+                    output::E_CFG_ERROR,
+                );
+                let wrapper = output::JsonResponse::new(error);
+                println!("{}", wrapper.to_json());
+                std::process::exit(output::EXIT_DATABASE);
+            } else {
+                output::error(&format!("{}", e));
+                output::info(&format!("Hint: {}", output::R_HINT_LIST_FUNCTIONS));
+                std::process::exit(output::EXIT_DATABASE);
             }
-        };
+        }
+    };
 
     // Load CFG from database
     let cfg = match load_cfg_from_db(&db, function_id) {