se-manifest-schema 0.5.0

Canonical SE_MANIFEST.toml schema and validation for the Structural Explainability ecosystem.

se-manifest-schema

Structural Explainability (SE) Manifest Schema

This repository defines the canonical SE_MANIFEST.toml schema for the Structural Explainability ecosystem.

It is the first dependency layer in the SE repository graph. It has no upstream SE dependencies and exists so foundational repositories can validate their manifests without depending on se-constitution.

The schema is maintained in:

• manifest-schema.toml

Validate SE_MANIFEST.toml in a Repository

uvx se-manifest-schema validate-manifest --path SE_MANIFEST.toml --strict

Developer Command Reference

Show command reference

In a machine terminal

Open a machine terminal where you want the project:

git clone https://github.com/structural-explainability/se-manifest-schema

cd se-manifest-schema
code .

In a VS Code terminal

uv self update
uv python pin 3.14
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
uvx pre-commit run --all-files

# validate the role capability map
uv run se-manifest validate-role-capability-map

# verify the manifest dependency graph
uv run se-manifest verify-graph

# validate schema
uv run se-manifest validate-schema --strict

# validate manifest (all repos)
uv run se-manifest validate-manifest --strict

# types, tests, docs
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

Merging GH Agent code example

git fetch origin copilot/analyze-test-coverage
git switch copilot/analyze-test-coverage
uv sync --extra dev --extra docs --upgrade
uvx pre-commit run --all-files
git status

git add -A
uvx pre-commit run --all-files
uv run python -m pyright
uv run python -m pytest
uv run se-manifest validate-schema --strict
uv run se-manifest validate-manifest --strict
uv run python -m zensical build

git add -A
git commit -m "fix copilot generated test formatting"
git push

Citation

CITATION.cff

License

LICENSE

Manifest

SE_MANIFEST.toml