cmn-hypha 0.1.1

CMN CLI tool — spawn, grow, release, taste, bond, and absorb spores on the Code Mycelial Network
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use super::*;

/// Search spores via Synapse.
/// Pass [`crate::NoopSink`] if you don't need event notifications.
pub async fn search(
    query: &str,
    synapse_arg: Option<&str>,
    synapse_token_secret: Option<&str>,
    domain: Option<&str>,
    license: Option<&str>,
    limit: u32,
    _sink: &dyn crate::EventSink,
) -> Result<crate::output::SearchOutput, crate::HyphaError> {
    search_with_bond(
        query,
        synapse_arg,
        synapse_token_secret,
        domain,
        license,
        None,
        limit,
        _sink,
    )
    .await
}

/// Like [`search`] but also accepts a `bond` filter string.
///
/// `bond_filter` format: `"relation:uri"` or comma-separated for AND logic,
/// e.g. `"spawned_from:cmn://a.dev/b3.3yMR7vZQ9hL,follows:cmn://b.dev/b3.def"`.
#[allow(clippy::too_many_arguments)]
pub async fn search_with_bond(
    query: &str,
    synapse_arg: Option<&str>,
    synapse_token_secret: Option<&str>,
    domain: Option<&str>,
    license: Option<&str>,
    bond_filter: Option<&str>,
    limit: u32,
    _sink: &dyn crate::EventSink,
) -> Result<crate::output::SearchOutput, crate::HyphaError> {
    let resolved =
        crate::config::resolve_synapse(synapse_arg, synapse_token_secret).map_err(|e| {
            crate::HyphaError::with_hint(
                "synapse_error",
                &e,
                "Add a synapse node with: hypha synapse add <url>",
            )
        })?;

    let client = substrate::client::http_client(30)
        .map_err(|e| crate::HyphaError::new("synapse_error", format!("HTTP client error: {e}")))?;

    let response = substrate::client::search(
        &client,
        &resolved.url,
        query,
        domain,
        license,
        bond_filter,
        limit,
        fetch_opts(resolved.token_secret.as_deref()),
    )
    .await
    .map_err(|e| crate::HyphaError::new("synapse_error", e.to_string()))?;

    let results: Vec<serde_json::Value> = response
        .result
        .spores
        .iter()
        .filter_map(|r| serde_json::to_value(r).ok())
        .collect();

    Ok(crate::output::SearchOutput {
        query: query.to_string(),
        synapse: resolved.url,
        count: results.len(),
        results,
    })
}

/// Handle the `search` command — thin CLI wrapper around [`search_with_bond`].
#[allow(clippy::too_many_arguments)]
pub async fn handle_search(
    out: &Output,
    query: &str,
    synapse_arg: Option<&str>,
    synapse_token_secret: Option<&str>,
    domain: Option<&str>,
    license: Option<&str>,
    bond_filter: Option<&str>,
    limit: u32,
) -> ExitCode {
    let sink = crate::api::OutSink(out);
    match search_with_bond(
        query,
        synapse_arg,
        synapse_token_secret,
        domain,
        license,
        bond_filter,
        limit,
        &sink,
    )
    .await
    {
        Ok(output) => out.ok(serde_json::to_value(output).unwrap_or_default()),
        Err(e) => out.error_hypha(&e),
    }
}