pmat 3.15.0

PMAT - Zero-config AI context generation and code quality toolkit (CLI, MCP, HTTP)
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

#![cfg_attr(coverage_nightly, coverage(off))]
//! Infra-score scorers — 5 base dimensions (100 pts) + 1 bonus (10 pts).
//!
//! Each scorer implements `InfraScorer` and evaluates one dimension
//! of CI/CD infrastructure quality.

pub mod build_reliability;
pub mod deployment_release;
pub mod provable_contracts;
pub mod quality_pipeline;
pub mod supply_chain;
pub mod workflow_architecture;

pub use build_reliability::BuildReliabilityScorer;
pub use deployment_release::DeploymentReleaseScorer;
pub use provable_contracts::ProvableContractsScorer;
pub use quality_pipeline::QualityPipelineScorer;
pub use supply_chain::SupplyChainScorer;
pub use workflow_architecture::WorkflowArchitectureScorer;

use crate::services::infra_score::models::InfraCategoryScore;
use async_trait::async_trait;
use std::path::Path;

/// Trait for all infra scoring modules
#[async_trait]
pub trait InfraScorer: Send + Sync {
    /// Name of the category (e.g., "Workflow Architecture")
    fn category_name(&self) -> &str;

    /// Maximum points available for this category
    fn max_score(&self) -> f64;

    /// Execute scoring for this category
    async fn score(&self, repo_path: &Path) -> anyhow::Result<InfraCategoryScore>;
}

/// Read all workflow YAML files from .github/workflows/
#[provable_contracts_macros::contract("pmat-core.yaml", equation = "path_exists")]
pub(crate) fn read_workflow_files(repo_path: &Path) -> Vec<(String, String)> {
    let workflows_dir = repo_path.join(".github/workflows");
    let mut files = Vec::new();

    if !workflows_dir.is_dir() {
        return files;
    }

    if let Ok(entries) = std::fs::read_dir(&workflows_dir) {
        for entry in entries.flatten() {
            let path = entry.path();
            if let Some(ext) = path.extension() {
                if (ext == "yml" || ext == "yaml") && path.is_file() {
                    if let Ok(content) = std::fs::read_to_string(&path) {
                        let name = path
                            .file_name()
                            .map(|n| n.to_string_lossy().to_string())
                            .unwrap_or_default();
                        files.push((name, content));
                    }
                }
            }
        }
    }

    files
}

/// Read Cargo.toml content if it exists
#[provable_contracts_macros::contract("pmat-core.yaml", equation = "path_exists")]
pub(crate) fn read_cargo_toml(repo_path: &Path) -> Option<String> {
    let path = repo_path.join("Cargo.toml");
    std::fs::read_to_string(path).ok()
}

#[cfg_attr(coverage_nightly, coverage(off))]
#[cfg(test)]
mod tests {
    use super::*;
    use std::fs;
    use tempfile::TempDir;

    #[test]
    fn test_read_workflow_files_empty_dir() {
        let tmp = TempDir::new().unwrap();
        let files = read_workflow_files(tmp.path());
        assert!(files.is_empty());
    }

    #[test]
    fn test_read_workflow_files_with_yml() {
        let tmp = TempDir::new().unwrap();
        let wf_dir = tmp.path().join(".github/workflows");
        fs::create_dir_all(&wf_dir).unwrap();
        fs::write(wf_dir.join("ci.yml"), "name: CI\non: push").unwrap();
        fs::write(wf_dir.join("nightly.yaml"), "name: Nightly").unwrap();
        fs::write(wf_dir.join("README.md"), "not a workflow").unwrap();

        let files = read_workflow_files(tmp.path());
        assert_eq!(files.len(), 2);
    }

    #[test]
    fn test_read_cargo_toml_exists() {
        let tmp = TempDir::new().unwrap();
        fs::write(tmp.path().join("Cargo.toml"), "[package]\nname = \"test\"").unwrap();
        let content = read_cargo_toml(tmp.path());
        assert!(content.is_some());
        assert!(content.unwrap().contains("[package]"));
    }

    #[test]
    fn test_read_cargo_toml_missing() {
        let tmp = TempDir::new().unwrap();
        let content = read_cargo_toml(tmp.path());
        assert!(content.is_none());
    }
}