comindly-engine 0.5.0-beta.12

comindly's engine: the index behind /api/v1 and /mcp, on this machine or as a team server, with the web app, indexing jobs, members and roles.
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

//! The library guide's snippets: `cargo run --example library -- <index root>`.

use std::sync::{Arc, RwLock};

use comindly_engine::context::{IndexContext, Settings};
use comindly_engine::events::{Event, EventSink};
use comindly_engine::graph::CodeGraph;
use comindly_engine::pipeline::{self, Source};

/// Where indexing reports its steps, results and progress.
struct Print;

impl EventSink for Print {
    fn emit(&self, e: Event) {
        eprintln!("{:?} {}", e.kind, e.message);
    }
}

/// Index two repositories into `root`, cross-repo links included.
#[allow(dead_code)]
async fn index(root: &str) -> anyhow::Result<()> {
    let settings = Settings::resolve(&Default::default(), |_| None);
    let ctx = IndexContext::new(
        root,
        settings,
        Arc::new(Print),
        "/tmp/comindly-cache".into(),
    );
    let sources = vec![Source::at("../orders"), Source::at("../payments")];
    pipeline::link(&ctx, sources, false, comindly_engine::scip::Mode::Auto).await?;
    Ok(())
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let root = std::env::args()
        .nth(1)
        .unwrap_or_else(|| "s3://bucket/comindly".into());
    let (symbols, edges) = comindly_engine::index::read_graph(&format!("{root}/_graph")).await?;
    let graph = CodeGraph::build(&symbols, &edges);

    for (repo, count) in graph.repos() {
        println!("{repo}: {count} symbols");
    }
    for node in graph.find("create_order", 5) {
        println!("{} {} at {}", node.kind, node.name, node.location);
    }

    if let Some(start) = graph.lookup("placeOrder") {
        for step in graph.flow(start, 8) {
            println!(
                "{}{} via {}",
                "  ".repeat(step.depth),
                step.node.name,
                step.via
            );
        }
    }
    for (entry, repos) in graph.entry_points(10) {
        println!("{} reaches {repos} repositories", graph.node(entry).name);
    }

    let ledger = comindly_engine::ledger::Ledger::open(&root)?;
    let records = ledger.all().await?;
    for record in &records {
        println!("{:?}: {}", record.kind, record.title);
    }
    let verifier = comindly_engine::signing::Verifier::default();
    for entry in comindly_engine::ledger::derive(&records, &symbols, &verifier) {
        println!("{:?}: {}", entry.status, entry.record.title);
    }

    let fresh = std::time::Duration::from_secs(comindly_engine::cache::DEFAULT_TTL);
    let server = comindly_engine::mcp::load(&format!("{root}/_graph"), true, fresh).await?;
    let current = Arc::new(RwLock::new(Some(server)));
    let _app: axum::Router = axum::Router::new().nest_service(
        "/mcp",
        comindly_engine::mcp::http(current.clone(), vec!["mcp.example.com".into()]),
    );
    Ok(())
}