lean-ctx 3.7.1

Context Runtime for AI Agents with CCP. 63 MCP tools, 10 read modes, 60+ compression patterns, cross-session memory (CCP), persistent AI knowledge with temporal facts + contradiction detection, multi-agent context sharing, LITM-aware positioning, AAAK compact format, adaptive compression with Thompson Sampling bandits. Supports 24+ AI tools. Reduces LLM token consumption by up to 99%.
Documentation
pub mod config;
pub mod drift;
pub mod lint;
pub mod sync;

pub use config::RulesConfig;
pub use drift::{DriftReport, DriftStatus};
pub use lint::{LintSeverity, LintWarning};
pub use sync::SyncReport;

use std::path::Path;

pub struct ContextOps {
    pub home: std::path::PathBuf,
    pub project_root: std::path::PathBuf,
}

impl ContextOps {
    pub fn new(home: &Path, project_root: &Path) -> Self {
        Self {
            home: home.to_path_buf(),
            project_root: project_root.to_path_buf(),
        }
    }

    pub fn detect_drift(&self) -> Result<Vec<DriftReport>, String> {
        let config = RulesConfig::load(&self.project_root)?;
        Ok(drift::detect_drift(&self.home, &config))
    }

    pub fn sync_all(&self) -> SyncReport {
        sync::sync_all(&self.home)
    }

    pub fn sync_agent(&self, agent: &str) -> SyncReport {
        sync::sync_agent(&self.home, agent)
    }

    pub fn lint(&self) -> Result<Vec<LintWarning>, String> {
        let config = RulesConfig::load(&self.project_root)?;
        Ok(lint::lint(&config, &self.home))
    }

    pub fn status(&self) -> Vec<crate::rules_inject::RulesTargetStatus> {
        crate::rules_inject::collect_rules_status(&self.home)
    }

    pub fn init(&self) -> Result<RulesConfig, String> {
        RulesConfig::init_from_existing(&self.project_root, &self.home)
    }

    pub fn has_config(&self) -> bool {
        RulesConfig::config_path(&self.project_root).exists()
    }
}

pub fn format_status(statuses: &[crate::rules_inject::RulesTargetStatus]) -> String {
    let mut lines = Vec::new();
    lines.push("Agent Rules Status:".to_string());
    lines.push(String::new());

    for s in statuses {
        let icon = match s.state.as_str() {
            "up_to_date" => "",
            "outdated" => "",
            "missing" => "",
            "not_detected" => "·",
            _ => "?",
        };
        let detected = if s.detected { "" } else { " (not installed)" };
        lines.push(format!("  [{icon}] {}{detected}{}", s.name, s.state));
    }

    lines.join("\n")
}

pub fn format_drift(reports: &[DriftReport]) -> String {
    let mut lines = Vec::new();
    lines.push("Drift Report:".to_string());
    lines.push(String::new());

    for r in reports {
        if r.status == DriftStatus::NotDetected {
            continue;
        }
        lines.push(format!("  [{}] {} ({})", r.status, r.target, r.path));
        if let Some(diff) = &r.diff {
            for dl in diff.lines().take(10) {
                lines.push(format!("    {dl}"));
            }
            let total = diff.lines().count();
            if total > 10 {
                lines.push(format!("    ... ({} more lines)", total - 10));
            }
        }
    }

    lines.join("\n")
}

pub fn format_lint(warnings: &[LintWarning]) -> String {
    if warnings.is_empty() {
        return "No lint issues found.".to_string();
    }

    let mut lines = Vec::new();
    lines.push(format!("Lint Results ({} issues):", warnings.len()));
    lines.push(String::new());

    for w in warnings {
        let target = w
            .target
            .as_deref()
            .map(|t| format!(" [{t}]"))
            .unwrap_or_default();
        lines.push(format!(
            "  [{severity}] {code}{target}: {msg}",
            severity = w.severity,
            code = w.code,
            msg = w.message,
        ));
    }

    lines.join("\n")
}

pub fn format_sync(report: &SyncReport) -> String {
    let mut lines = Vec::new();
    lines.push("Sync Report:".to_string());
    lines.push(String::new());

    if !report.synced.is_empty() {
        lines.push(format!("  Synced: {}", report.synced.join(", ")));
    }
    if !report.skipped.is_empty() {
        lines.push(format!("  Already in sync: {}", report.skipped.join(", ")));
    }
    if !report.errors.is_empty() {
        lines.push(format!("  Errors: {}", report.errors.join(", ")));
    }
    if report.synced.is_empty() && report.skipped.is_empty() && report.errors.is_empty() {
        lines.push("  No targets found.".to_string());
    }

    lines.join("\n")
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn context_ops_has_config_false() {
        let ops = ContextOps::new(
            Path::new("/tmp/fake"),
            Path::new("/tmp/nonexistent_contextops"),
        );
        assert!(!ops.has_config());
    }

    #[test]
    fn format_status_output() {
        let statuses = vec![crate::rules_inject::RulesTargetStatus {
            name: "TestAgent".to_string(),
            detected: true,
            path: "/tmp/test".to_string(),
            state: "up_to_date".to_string(),
            note: None,
        }];
        let output = format_status(&statuses);
        assert!(output.contains(""));
        assert!(output.contains("TestAgent"));
    }

    #[test]
    fn format_drift_skips_not_detected() {
        let reports = vec![DriftReport {
            target: "Ghost".to_string(),
            path: "/tmp/ghost".to_string(),
            status: DriftStatus::NotDetected,
            diff: None,
        }];
        let output = format_drift(&reports);
        assert!(!output.contains("Ghost"));
    }

    #[test]
    fn format_lint_empty() {
        let output = format_lint(&[]);
        assert_eq!(output, "No lint issues found.");
    }

    #[test]
    fn format_lint_with_warnings() {
        let warnings = vec![LintWarning {
            severity: LintSeverity::Warning,
            code: "TEST".to_string(),
            message: "test warning".to_string(),
            target: Some("cursor".to_string()),
        }];
        let output = format_lint(&warnings);
        assert!(output.contains("[WARNING]"));
        assert!(output.contains("[cursor]"));
    }

    #[test]
    fn format_sync_empty() {
        let report = SyncReport {
            synced: vec![],
            skipped: vec![],
            errors: vec![],
        };
        let output = format_sync(&report);
        assert!(output.contains("No targets found"));
    }

    #[test]
    fn format_sync_with_results() {
        let report = SyncReport {
            synced: vec!["Cursor".to_string()],
            skipped: vec!["Claude Code".to_string()],
            errors: vec![],
        };
        let output = format_sync(&report);
        assert!(output.contains("Cursor"));
        assert!(output.contains("Claude Code"));
    }
}