homeboy 0.142.0

CLI for multi-component deployment and development workflow automation
Documentation
use crate::code_audit::report::{
    build_audit_summary, build_changed_since_summary, compute_fixability, finding_kind_key,
    from_main_workflow, AuditChangedSinceSummary, AuditCommandOutput,
};
use crate::code_audit::test_helpers::{empty_result, make_finding};
use crate::code_audit::{AuditFinding, Finding, FindingConfidence, Severity};

#[test]
fn test_build_audit_summary_empty_result() {
    let result = empty_result();
    let summary = build_audit_summary(&result, 0);

    assert_eq!(summary.total_findings, 0);
    assert_eq!(summary.warnings, 0);
    assert_eq!(summary.info, 0);
    assert_eq!(summary.exit_code, 0);
    assert!(summary.top_findings.is_empty());
    assert_eq!(summary.alignment_score, None);
}

#[test]
fn test_build_audit_summary() {
    let result = empty_result();
    let summary = build_audit_summary(&result, 0);

    assert_eq!(summary.total_findings, 0);
    assert_eq!(summary.exit_code, 0);
}

#[test]
fn test_build_audit_summary_counts_severities() {
    let mut result = empty_result();
    result.findings.push(make_finding(Severity::Warning));
    result.findings.push(make_finding(Severity::Warning));
    result.findings.push(make_finding(Severity::Info));

    let summary = build_audit_summary(&result, 1);

    assert_eq!(summary.total_findings, 3);
    assert_eq!(summary.warnings, 2);
    assert_eq!(summary.info, 1);
    assert_eq!(summary.exit_code, 1);
}

#[test]
fn test_build_audit_summary_includes_finding_confidence() {
    let mut result = empty_result();
    result.findings.push(make_finding(Severity::Warning));
    result.findings[0].kind = AuditFinding::OrphanedTest;

    let summary = build_audit_summary(&result, 1);

    assert_eq!(summary.top_findings.len(), 1);
    assert_eq!(
        summary.top_findings[0].confidence,
        FindingConfidence::Heuristic
    );
}

#[test]
fn test_build_audit_summary_caps_top_findings_at_20() {
    let mut result = empty_result();
    for _ in 0..25 {
        result.findings.push(make_finding(Severity::Warning));
    }

    let summary = build_audit_summary(&result, 1);

    assert_eq!(summary.total_findings, 25);
    assert_eq!(summary.top_findings.len(), 20);
}

#[test]
fn test_build_audit_summary_preserves_alignment_score() {
    let mut result = empty_result();
    result.summary.alignment_score = Some(0.85);

    let summary = build_audit_summary(&result, 0);

    assert_eq!(summary.alignment_score, Some(0.85));
}

#[test]
fn test_build_audit_summary_omits_changed_since_by_default() {
    let result = empty_result();
    let summary = build_audit_summary(&result, 0);

    assert!(summary.changed_since.is_none());
}

#[test]
fn test_build_changed_since_summary_splits_introduced_from_context() {
    let mut result = empty_result();
    result.findings.push(Finding {
        convention: "structural".to_string(),
        severity: Severity::Warning,
        file: "src/large.rs".to_string(),
        description: "Existing large file debt".to_string(),
        suggestion: "Consider decomposing into focused modules".to_string(),
        kind: AuditFinding::GodFile,
    });
    result.findings.push(Finding {
        convention: "dead_code".to_string(),
        severity: Severity::Warning,
        file: "src/large.rs".to_string(),
        description: "New unused export".to_string(),
        suggestion: "Remove or reference the export".to_string(),
        kind: AuditFinding::UnreferencedExport,
    });

    let comparison = crate::engine::baseline::Comparison {
        new_items: vec![crate::engine::baseline::NewItem {
            fingerprint: "dead_code::src/large.rs::UnreferencedExport".to_string(),
            description: "New unused export".to_string(),
            context_label: "dead_code".to_string(),
        }],
        resolved_fingerprints: vec![],
        delta: 1,
        drift_increased: true,
    };

    assert_eq!(
        build_changed_since_summary(&result, &comparison),
        AuditChangedSinceSummary {
            introduced_findings: 1,
            contextual_findings: 1,
        }
    );
}

#[test]
fn test_changed_since_summary_serializes_as_additive_summary_field() {
    let mut summary = build_audit_summary(&empty_result(), 0);
    summary.changed_since = Some(AuditChangedSinceSummary {
        introduced_findings: 0,
        contextual_findings: 3,
    });

    let value = serde_json::to_value(summary).expect("summary serializes");

    assert_eq!(value["changed_since"]["introduced_findings"], 0);
    assert_eq!(value["changed_since"]["contextual_findings"], 3);
}

#[test]
fn test_compute_fixability_returns_none_for_empty_result() {
    let result = empty_result();
    // source_path is /tmp/test which exists but has no source files to fix
    let fixability = compute_fixability(&result);
    assert!(fixability.is_none());
}

#[test]
fn test_compute_fixability() {
    let mut result = empty_result();
    result.source_path = "/nonexistent/path/that/does/not/exist".to_string();

    assert!(compute_fixability(&result).is_none());
}

#[test]
fn test_compute_fixability_returns_none_for_nonexistent_path() {
    let mut result = empty_result();
    result.source_path = "/nonexistent/path/that/does/not/exist".to_string();
    result.findings.push(make_finding(Severity::Warning));
    let fixability = compute_fixability(&result);
    assert!(fixability.is_none());
}

#[test]
fn test_compute_fixability_skips_structural_only_results() {
    let mut result = empty_result();
    result.findings.push(Finding {
        convention: "structural".to_string(),
        severity: Severity::Warning,
        file: "src/big.rs".to_string(),
        description: "File has 1200 lines".to_string(),
        suggestion: "Consider decomposing into focused modules".to_string(),
        kind: AuditFinding::GodFile,
    });

    assert!(compute_fixability(&result).is_none());
}

#[test]
fn test_compute_fixability_counts_fixes_from_real_audit() {
    use std::fs;

    let dir = tempfile::tempdir().expect("temp dir");
    let root = dir.path();

    // Create a minimal codebase with a detectable convention + outlier
    fs::create_dir_all(root.join("commands")).unwrap();
    // Two conforming files establish a convention (methods: run + helper)
    fs::write(
        root.join("commands/good_one.rs"),
        "pub fn run() {}\npub fn helper() {}\n",
    )
    .unwrap();
    fs::write(
        root.join("commands/good_two.rs"),
        "pub fn run() {}\npub fn helper() {}\n",
    )
    .unwrap();
    // One outlier is missing a method → should produce a fixable finding
    fs::write(root.join("commands/bad.rs"), "pub fn run() {}\n").unwrap();

    // Run a real audit
    let result = crate::code_audit::audit_path_with_id("fixability-test", &root.to_string_lossy())
        .expect("audit should run");

    // Compute fixability
    let fixability = compute_fixability(&result);

    // Should have at least some fixable findings (the missing method outlier)
    if let Some(fix) = fixability {
        assert!(
            fix.fixable_count > 0,
            "expected at least one fixable finding"
        );
        // automated + manual_only should equal fixable_count
        assert_eq!(
            fix.fixable_count,
            fix.automated_count + fix.manual_only_count
        );
        // by_kind should not be empty
        assert!(!fix.by_kind.is_empty(), "expected per-kind breakdown");
    }
    // Note: fixability may also be None if the minimal codebase doesn't trigger
    // enough conventions — that's acceptable for this test.
}

#[test]
fn test_finding_kind_key_produces_snake_case() {
    // finding_kind_key must produce serde-compatible snake_case keys
    // so that fixability.by_kind matches the JSON finding group keys.
    assert_eq!(
        finding_kind_key(&AuditFinding::CompilerWarning),
        "compiler_warning"
    );
    assert_eq!(
        finding_kind_key(&AuditFinding::UnusedParameter),
        "unused_parameter"
    );
    assert_eq!(
        finding_kind_key(&AuditFinding::UnreferencedExport),
        "unreferenced_export"
    );
    assert_eq!(
        finding_kind_key(&AuditFinding::IntraMethodDuplicate),
        "intra_method_duplicate"
    );
    assert_eq!(
        finding_kind_key(&AuditFinding::OrphanedTest),
        "orphaned_test"
    );
    assert_eq!(
        finding_kind_key(&AuditFinding::MissingTestFile),
        "missing_test_file"
    );
    assert_eq!(
        finding_kind_key(&AuditFinding::MissingTestMethod),
        "missing_test_method"
    );
    assert_eq!(
        finding_kind_key(&AuditFinding::MissingMethod),
        "missing_method"
    );
    assert_eq!(finding_kind_key(&AuditFinding::GodFile), "god_file");
    assert_eq!(
        finding_kind_key(&AuditFinding::DuplicateFunction),
        "duplicate_function"
    );
    assert_eq!(
        finding_kind_key(&AuditFinding::NearDuplicate),
        "near_duplicate"
    );
}

#[test]
fn test_finding_kind_key() {
    assert_eq!(
        finding_kind_key(&AuditFinding::OrphanedTest),
        "orphaned_test"
    );
}

#[test]
fn test_from_main_workflow() {
    let output = AuditCommandOutput::Summary(build_audit_summary(&empty_result(), 0));
    let (output, exit_code) = from_main_workflow(crate::code_audit::run::AuditRunWorkflowResult {
        output,
        exit_code: 3,
    });

    assert_eq!(exit_code, 3);
    assert!(matches!(output, AuditCommandOutput::Summary(_)));
}