Struct CoverageEngine 

pub struct CoverageEngine;

Stateless engine for building and scoring the coverage matrix.

All methods are pure functions — no internal state is mutated. The struct exists as an organisational namespace.

Implementations

impl CoverageEngine

pub fn build_matrix( canonical_asset_ids: &[String], workspaces: &[(PathBuf, Vec<InstalledAsset>)], canonical_hashes: &HashMap<String, String>, canonical_versions: &HashMap<String, String>, ) -> CoverageMatrix

Build the full coverage matrix from canonical assets and scan results.

Arguments

• canonical_asset_ids — ordered list of all catalog asset identifiers. Each entry becomes one row in the matrix.
• workspaces — list of (workspace_name, installed_assets) pairs. Each pair becomes one column and contributes cells for each asset.
• canonical_hashes — map from asset_id → expected SHA-256 hex (from asset-integrity.json).
• canonical_versions — map from asset_id → version string (from catalog).

The matrix rows are ordered by canonical_asset_ids, and columns are ordered by the order of workspaces. Coverage scores are computed for each workspace and stored in workspace_scores.

pub fn compute_coverage_score( installed_matching: usize, total_applicable: usize, ) -> Option<f64>

Compute the per-workspace coverage percentage (Req 3.5).

Formula: (installed_matching / total_applicable) × 100, rounded half-up to one decimal place.

Returns None when total_applicable == 0 (workspace has no applicable canonical assets — display as “N/A” in the UI per Req 3.5).

pub fn compute_freshness_score( current_count: usize, total_with_versions: usize, ) -> f64

Compute the freshness score for a workspace (Req 8.3).

Delegates to freshness_score from versions.rs.

Returns 0.0 when total_with_versions == 0.