Structural Explainability MapSpec: mapping vocabulary and structural correspondence rules for the SE ecosystem.
- defines rules
- defines primitives those rules depend on
- enforces rules across repositories
- defines how structures correspond across systems
- mapping vocabulary
- mapping relation patterns
- constraints for expressing mappings between artifacts
- source-target relationships
- correspondence identifiers
- how mappings are declared
- how elements align across systems
- allowed mapping forms
- structural consistency requirements
- stable references between mapped elements
- se-mapping-*
- se-adapter-*
Other projects will provide:
- adapters
- runtime transformations
- runtime connectors
- data processing logic
- domain semantics
Show command reference
Open a machine terminal where you want the project:
git clone https://github.com/structural-explainability/se-mapspec
cd se-mapspec
code .uv self update
uv python pin 3.15
uv sync --extra dev --extra docs --upgrade
uvx pre-commit install
git add -A
uvx pre-commit run --all-files
# repeat if changes were made
git add -A
uvx pre-commit run --all-files
# run the module
uv run python -m se_mapspec
# do chores
npx markdownlint-cli "**/*.md" --fix
uv run python -m ruff format .
uv run python -m ruff check . --fix
uv run python -m pyright
uv run python -m pytest
uv run python -m zensical build
# save progress
git add -A
git commit -m "update"
git push -u origin main