Structural Explainability MapSpec: mapping vocabulary and structural correspondence rules for the SE ecosystem.
- se-constitution defines rules
- se-kernel defines primitives those rules depend on
- se-admin enforces rules across repositories
- se-mapspec 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
git clone https://github.com/structural-explainability/se-mapspec
cd se-mapspec
code .uvx pup-clean --delete
uv self update
uv python install
uv lock --upgrade
uv sync
uv audit
# set up and run git hooks
uv run prek install --force
uv run prek update
git add -A
uv run prek run --all-files
# repeat if changes were made
uv run prek 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