oxibrain-cli 0.2.0

Command-line interface and MCP server for oxibrain
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

use oxibrain::Brain;
use oxibrain::BrainConfig;
use oxibrain_core::{DropReason, Query, QueryMode};
use std::path::Path;

/// `oxibrain why --dropped "<query>"` — print what `rank` discarded for a
/// query, from the conservation guarantee (DESIGN §11.8). Empty output
/// means nothing was dropped.
pub async fn run_dropped(
    dir: &Path,
    query_text: &str,
    space: &str,
    min_confidence: f32,
) -> anyhow::Result<()> {
    let brain = Brain::open(BrainConfig::at(dir)).await?;
    let space_id = brain.ensure_space(space).await?;
    let q = Query {
        text: query_text.to_string(),
        mode: QueryMode::Hybrid,
        space: space_id,
        as_of: None,
        limit: 20,
        min_confidence,
    };
    let result = brain.query(q).await?;
    if result.dropped.is_empty() {
        println!(
            "no candidates were dropped (limit {})",
            result.total_candidates
        );
        return Ok(());
    }
    println!(
        "dropped {} of {} candidates:",
        result.dropped.len(),
        result.total_candidates
    );
    for d in &result.dropped {
        let reason = match &d.reason {
            DropReason::BelowConfidenceFloor { actual, floor } => {
                format!("below confidence floor: {actual:.2} < {floor:.2}")
            }
            DropReason::OutsideValidWindow { valid_at } => {
                format!("outside valid window at {valid_at:?}")
            }
            DropReason::BeforeKnownAt {
                known_at,
                recorded_at,
            } => {
                format!("recorded {recorded_at:?} after known_at {known_at:?}")
            }
            DropReason::TrustExcluded { tier } => format!("trust tier excluded: {tier:?}"),
            DropReason::PredicateDenied { predicate } => {
                format!("predicate denied: {predicate}")
            }
            DropReason::EntityTypeMismatch { expected } => {
                format!("entity type mismatch, expected {expected:?}")
            }
            DropReason::TruncatedByBudget { position } => {
                format!("truncated by budget (position {position})")
            }
        };
        println!("  {} — {reason}", d.target.rrf_key());
    }
    Ok(())
}

pub async fn run(dir: &Path, statement_id: &str, space: &str) -> anyhow::Result<()> {
    let brain = Brain::open(BrainConfig::at(dir)).await?;
    let space_id = brain.ensure_space(space).await?;
    let block = brain.why(&space_id, statement_id).await?;
    println!("statement: {}", block.statement.id);
    println!("  subject: {}", block.statement.subject);
    println!("  predicate: {}", block.statement.predicate);
    println!("  object: {:?}", block.statement.object);
    println!("status: {}", block.status);
    println!(
        "confidence: raw={:.3} support={} contradiction={}",
        block.confidence_breakdown.raw_confidence,
        block.confidence_breakdown.support_count,
        block.confidence_breakdown.contradiction_count
    );
    println!("assertions: {}", block.assertions.len());
    for a in &block.assertions {
        println!(
            "  [{}] episode={} extractor={:?} conf={:.3} recorded={}",
            a.polarity, a.episode_id, a.extractor, a.confidence, a.recorded_at
        );
    }
    Ok(())
}