se-regimes

Executable identity and persistence regime kernel for Structural Explainability.

Owns

• src/se_regimes/data/regimes.toml - all 9 identity and persistence regime profiles
• src/se_regimes/data/transformations.toml - transformation family definitions (BF, decomposition, nor_reorg)

Includes

Regime profiles

• 9 regime profiles: 3 unsplit carrier regimes + 6 split products (ENR-L/I, CTX-E/S, NOR-C/S)
• per-profile: persistence invariant, break condition, transform response

Transformation families

• branching (BF), decomposition, normative reorganization (nor_reorg)
• per-family: split trigger, descriptive rationale

Engine

• case evaluation against regime registry
• coverage matrix (regime x family)
• stress report generation

Split theorems

• ENR refinement: locus vs. instance under branching
• CTX refinement: extensional vs. structural under decomposition
• NOR refinement: content vs. structural under normative reorganization

Command Reference

Show command reference

In a machine terminal

After you get a copy of this repo in your own GitHub account, open a machine terminal in Repos or where you want the project:

# Replace username with YOUR GitHub username.
git clone https://github.com/username/se-regimes

cd se-regimes
code .

In a VS Code terminal

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

# validate registry (structure and completeness)
uv run python -m se_regimes.registry

# list data artifacts and all 9 regimes (inspection)
uv run python -m se_regimes show

# evaluate cases and write reports/stress_report.md
uv run python -m se_regimes report

# optional explicit paths
uv run python -m se_regimes report --cases cases/ --report reports/stress_report.md

# 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

Citation

CITATION.cff

License

LICENSE

Manifest

SE_MANIFEST.toml