magellan 4.7.4

Deterministic codebase mapping tool for local development
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

//! HNSW command implementation
//!
//! Create and query HNSW vector indexes via sqlitegraph.

use anyhow::{Context, Result};
use magellan::OutputFormat;
use serde_json::json;
use sqlitegraph::SqliteGraph;
use std::path::PathBuf;

/// Create an HNSW index
pub fn run_hnsw_create(
    db_path: PathBuf,
    name: String,
    dim: usize,
    m: usize,
    ef_construction: usize,
    ef_search: usize,
    _output_format: OutputFormat,
) -> Result<()> {
    use sqlitegraph::hnsw::config::HnswConfig;
    use sqlitegraph::hnsw::distance_metric::DistanceMetric;

    let graph = SqliteGraph::open(&db_path)
        .with_context(|| format!("Failed to open database: {}", db_path.display()))?;

    let mut config = HnswConfig::new(dim, m, ef_construction, DistanceMetric::Cosine);
    config.ef_search = ef_search;

    let _guard = graph
        .hnsw_index(&name, config)
        .map_err(|e| anyhow::anyhow!("Failed to create HNSW index: {}", e))?;

    println!(
        "Created HNSW index '{}' (dim={}, m={}, ef_construction={}, ef_search={})",
        name, dim, m, ef_construction, ef_search
    );
    Ok(())
}

/// Query an HNSW index
pub fn run_hnsw_query(
    db_path: PathBuf,
    name: String,
    vector_str: String,
    k: usize,
    output_format: OutputFormat,
) -> Result<()> {
    let vector: Vec<f32> = serde_json::from_str(&vector_str).with_context(|| {
        format!(
            "Failed to parse vector as JSON array of f32: {}",
            vector_str
        )
    })?;

    let graph = SqliteGraph::open(&db_path)
        .with_context(|| format!("Failed to open database: {}", db_path.display()))?;

    let results: Vec<(u64, f32)> = graph
        .get_hnsw_index_ref(&name, |idx| idx.search(&vector, k).unwrap_or_default())
        .map_err(|e| anyhow::anyhow!("HNSW query failed: {}", e))?;

    let rows: Vec<serde_json::Value> = results
        .into_iter()
        .enumerate()
        .map(|(i, (id, dist))| {
            json!({
                "rank": i + 1,
                "id": id,
                "distance": dist,
            })
        })
        .collect();

    match output_format {
        OutputFormat::Json => println!("{}", serde_json::to_string(&rows)?),
        OutputFormat::Pretty => println!("{}", serde_json::to_string_pretty(&rows)?),
        OutputFormat::Human => {
            println!("HNSW query results (index '{}', k={}):", name, k);
            for row in &rows {
                println!(
                    "  #{}: id={}, distance={:.6}",
                    row["rank"].as_u64().unwrap_or(0),
                    row["id"].as_u64().unwrap_or(0),
                    row["distance"].as_f64().unwrap_or(f64::NAN),
                );
            }
            println!("{} result(s)", rows.len());
        }
    }

    Ok(())
}