Eve library

ISIS v2 Coverage Complete Formulas

Guide

Revision 1

On this page

Date: 2026-02-23 Scope: WS01-006 coverage-complete formulas and CI assertion rules.

Objective#

Define deterministic formulas for taxonomy coverage so "coverage complete" can be validated by CI instead of manual interpretation.

Symbols#

  • W_total: total catalog workflows.
  • A_mapped: workflows mapped to a valid canonical asset family.
  • C_mapped: workflows mapped to valid control modalities.
  • S_mapped: workflows mapped to valid consistency dimensions.
  • P_mapped: workflows mapped to a valid output package profile.
  • R_ctrl_total: required canonical controls count.
  • R_ctrl_used: required controls referenced by at least one workflow mapping.
  • R_dim_total: required consistency dimensions count.
  • R_dim_used: required consistency dimensions referenced by at least one workflow mapping.
  • R_pkg_total: required output package classes count.
  • R_pkg_used: required package classes reached by mapped workflow profiles.

Coverage Formulas#

  1. Asset mapping coverage: asset_coverage = A_mapped / W_total
  2. Control mapping coverage: control_coverage = C_mapped / W_total
  3. Consistency mapping coverage: consistency_coverage = S_mapped / W_total
  4. Output profile coverage: output_profile_coverage = P_mapped / W_total
  5. Required control surface coverage: required_control_coverage = R_ctrl_used / R_ctrl_total
  6. Required consistency dimension coverage: required_dimension_coverage = R_dim_used / R_dim_total
  7. Required output package class coverage: required_package_coverage = R_pkg_used / R_pkg_total

Coverage Complete Gate#

Coverage is considered complete only when all formula values are exactly 1.0 (100%).

CI Assertion#

Authoritative gate script:

  • scripts/isis/validate-v2-coverage-formulas.mjs

Generated report artifact:

  • docs/domains/isis/remediation-v2/ISIS_V2_COVERAGE_ASSERTIONS.md

Traceability#

  • Checklist item: WS01-006
  • Depends on: WS01-001, WS01-002, WS01-003, WS01-004, WS01-005