SE Regimes Explorer

Interactive decision tree for classifying objects into Structural Explainability identity and persistence regimes.

Try the Interactive Explorer

Context

Structural Explainability defines nine identity and persistence regimes that describe how objects maintain or lose identity under transformation.

In practice, assigning a regime requires understanding:

• what kind of object is being evaluated
• which aspects of identity matter
• how transformations interact with those aspects

The Explorer provides a direct path from object description to regime classification.

When To Use

Use the Explorer when:

• determining how identity should be tracked for a given object
• evaluating how an object responds to branching, decomposition, or reorganization
• checking whether a classification aligns with the formal regime definitions
• exploring disagreements between intuitive classification and registry behavior

Benefits

• No prior knowledge of the theory required
• Step-by-step classification using plain-language questions
• Transparent reasoning path (not a black-box assignment)
• Independent derivation of regime assignments
• Supports identification of edge cases and theory stress points

What the Explorer Does

The Explorer:

• asks structured questions about an object and its transformation
• derives a regime classification from those answers
• shows the reasoning path that led to the classification
• allows comparison with the regime registry (se-regimes)

This Project

This repository provides:

• an interactive browser-based decision tree
• decision logic for regime classification
• documentation (motivation, glossary)
• integration point with the se-regimes registry

The decision tree is independent of the registry:

• it derives classifications from object properties
• it does not reuse registry logic

Differences between Explorer output and registry behavior are treated as candidate stress tests of the theory.

Working Files

Working files are found in these areas:

• docs/ – documentation, explorer UI, and narrative content
• src/ – decision logic and optional CLI tooling
• data/ – optional supporting artifacts (if used)

Command Reference

Show command reference

In a machine terminal (open in your Repos folder)

After you get a copy of this repo in your own GitHub account, open a machine terminal in your Repos folder:

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

cd se-regimes-explorer
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

# run explorer
uv run python -m se_regimes_explorer

# optionally export explorer metadata
uv run python -m se_regimes_explorer --output-json docs/data/regimes.json

# 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

git add -A
git commit -m "update"
git push -u origin main

Test page:

uv run python -m http.server 8000