aptu-core

Core library for Aptu - AI-Powered Triage Utility.

Features

AI Triage - Analyze issues with summaries, labels, and contributor guidance
PR Review - AI-powered pull request analysis with full file content and multi-language AST context (Rust, Python, Go, Java, TypeScript, TSX, JavaScript, C, C++, C#, Fortran)
Security Scanning - Built-in security pattern detection with SARIF output
Multiple Providers - OpenRouter (default), Cerebras, Groq, Gemini, Z.AI, and ZenMux
GitHub Integration - Auth, issues, PRs, and GraphQL queries
Resilient - Exponential backoff, circuit breaker, rate limit handling

Installation

Add to your Cargo.toml:

[dependencies]
aptu-core = "*"

Note: Replace * with the current version on crates.io when used in production.

Optional Features

Feature	Description
`keyring`	Secure token storage using system keyring (macOS Keychain, Linux Secret Service, Windows Credential Manager)
`ast-context`	AST and call-graph context injection for PR reviews (Rust, Go, Python, TypeScript, JS, C/C++, C#, Java, Fortran)

To enable optional features:

[dependencies]
aptu-core = { version = "*", features = ["keyring"] }

Example

use aptu_core::{load_config, AiClient, IssueDetails, ai::AiProvider};
use anyhow::Result;

#[tokio::main]
async fn main() -> Result<()> {
    // Load configuration
    let config = load_config()?;

    // Create AI client
    let client = AiClient::new(&config.ai.provider, &config.ai)?;

    // Create issue details
    let issue = IssueDetails::builder()
        .owner("block".to_string())
        .repo("goose".to_string())
        .number(123)
        .title("Example issue".to_string())
        .body("Issue description...".to_string())
        .url("https://github.com/block/goose/issues/123".to_string())
        .build();

    // Analyze with AI
    let response = client.analyze_issue(&issue).await?;
    println!("Summary: {}", response.triage.summary);

    Ok(())
}

Modules

ai - AI integration and triage analysis
config - Configuration loading and XDG paths
facade - High-level platform-agnostic API
github - GitHub API and authentication
history - Contribution history tracking
repos - Curated repository list
security - Security pattern detection and SARIF output

Benchmarks

Head-to-head comparison of aptu+mercury-2 vs a raw claude-opus-4.6 call (no schema, no rubric, no AST context) across 6 fixtures (3 triage, 3 PR review).

Arm	Quality (mean, /5)	Cost/call	Latency p50
aptu+mercury-2	4.8/5	$0.0011	1,934 ms
raw claude-opus-4.6	2.2/5	$0.0193	16,032 ms

Measured across aptu #737, #850, #1094 (triage) and #1091, #1098, #1101 (PR review); n=1 per fixture.

aptu+mercury-2 is 17x cheaper and 8x faster than a raw claude-opus-4.6 call, while scoring more than twice as high on the structured rubric.

See docs/BENCHMARKS.md for full methodology, fixture breakdown, and C1-C5 scores.

FAQ

Q: The install examples use "*" -- what version should I pin in production?

The "*" wildcard in documentation examples means "any version" and is used so the docs stay accurate across releases. For production use or library dependencies, always pin to a specific version:

[dependencies]
aptu-core = "0.4"            # semver-compatible: accepts patch and minor updates
# or for exact pinning:
aptu-core = "=0.4.0"         # exact: only this release

Check crates.io/crates/aptu-core for the latest published version. aptu-core follows Semantic Versioning: patch releases are bug-fixes only; minor releases may add new APIs but remain backward-compatible with existing usage.

Support

For questions and support, visit clouatre.ca.

License

Apache-2.0. See LICENSE.

aptu-core 0.4.2