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
//! `trusty-analyze` — sidecar code-analysis daemon for trusty-search.
//!
//! # What it does
//!
//! `trusty-analyze` is an HTTP daemon and MCP server that fetches indexed code
//! corpora from a running [trusty-search](https://github.com/bobmatnyc/trusty-tools)
//! instance, performs static analysis, and exposes results on port 7879. It
//! supports cyclomatic / cognitive complexity, code-smell detection, quality-grade
//! aggregation (A–F), git-blame temporal decay, k-means concept clustering (BoW
//! or neural via fastembed/ONNX Runtime), a facts store (redb), SCIP protobuf
//! ingest for LSP-quality symbol data, and an optional deep-analysis LLM pass
//! (OpenRouter or AWS Bedrock). Every HTTP endpoint has an MCP tool equivalent.
//!
//! # Prerequisites — REQUIRED before starting
//!
//! **`trusty-analyze` requires a running `trusty-search` daemon.** The analyzer
//! performs a startup health check against `http://127.0.0.1:7878/health` (or the
//! URL given by `--search-url`) and exits with code 1 if that check fails. There
//! is no standalone or offline mode. Start `trusty-search` first:
//!
//! ```text
//! trusty-search daemon # or: trusty-search start
//! ```
//!
//! See the [trusty-search install guide](https://github.com/bobmatnyc/trusty-tools)
//! for setup instructions.
//!
//! # Installation
//!
//! **From source (recommended — `cargo install --git`):**
//!
//! ```text
//! cargo install --git https://github.com/bobmatnyc/trusty-tools trusty-analyze --locked
//! ```
//!
//! This uses the default `bundled-ort` feature (static ONNX Runtime, glibc ≥ 2.38,
//! macOS arm64). For older-glibc hosts (Amazon Linux 2023 / glibc 2.34), use:
//!
//! ```text
//! cargo install --git https://github.com/bobmatnyc/trusty-tools trusty-analyze \
//! --locked --no-default-features --features http-server,load-dynamic
//! ```
//!
//! Then set `ORT_DYLIB_PATH` to your system `libonnxruntime.so` path at runtime.
//!
//! **Prebuilt binaries** for macOS arm64 and Linux x86_64 are published on the
//! [GitHub Releases page](https://github.com/bobmatnyc/trusty-tools/releases)
//! under tags of the form `trusty-analyze-v<version>`.
//!
//! # Usage
//!
//! ```text
//! # Start trusty-search first (hard dependency)
//! trusty-search daemon
//!
//! # Then start the analyzer
//! trusty-analyze serve --search-url http://127.0.0.1:7878
//!
//! # Analyze an index and view complexity hotspots
//! trusty-analyze analyze <index-id> --top-k 20
//!
//! # Check liveness
//! trusty-analyze health
//! ```
//!
//! # Further reading
//!
//! See the [README](https://github.com/bobmatnyc/trusty-tools/blob/main/crates/trusty-analyze/README.md)
//! for the full API reference, MCP tool list, feature-flag documentation, and
//! Claude Code integration instructions.
// Why (issue #249): the `service` module is the axum HTTP daemon surface and
// only compiles when the `http-server` feature is enabled. Gating it keeps
// library consumers that only need the analysis core / dispatcher free of the
// axum + tower-http stack.