Structural Explainability Mapping: Assurance

Assurance-mapping record schema and structural validation for the Structural Explainability ecosystem.

Purpose

Domain-specific consumer of se-mapspec's general mapping vocabulary, scoped to records that map an external assurance or evaluation framework against Structural Assurability.

For full documentation, see SPECIFICATION.md.

Included

• assurance-mapping-schema.toml - the canonical record schema.
• src/se_mapping_assurance/record.py - a typed record model.
• src/se_mapping_assurance/validate.py - structural and internal- consistency checks against that schema.

Not Included

Framework-specific mapping records, findings, and crosswalk content live in consuming repositories.

Development

Clone and Open in VS Code

git clone https://github.com/structural-explainability/se-mapping-assurance.git
cd se-mapping-assurance
code .

Set Up the Project

uvx pup-clean --delete
uv self update
uv python pin 3.14
uv python install
uv lock --upgrade
uv sync
uv audit

Validate the Schema and Example

uv run se-mapping-assurance validate-schema --strict
uv run se-mapping-assurance validate-mapping --path examples/record-001.toml --strict

Canonical Schema

assurance-mapping-schema.toml

Documentation

Documentation

Status

Initial development. The schema and validator require testing against at least two independently developed framework mappings before release.

Citation

CITATION.cff

License

MIT

Repository Manifest

SE_MANIFEST.toml