Skip to content
@structural-explainability

Structural Explainability

Structural Explainability

License: MIT Build Status Check Links

A research program on how records stay the same, or stop being the same, as they change, built on a foundation that makes no causal or normative claims of its own.

Overview

Structural Explainability (SE) is a research program on how a record stays the same thing, or stops being it, as it changes: forks, revisions, merges, replications, a body of law like 40 CFR whose parts change while the whole persists. People mostly agree on these verdicts in practice. The aim is to find out how they decide, and to write the rules down explicitly enough that two defensible rules can be compared and their disagreement traced to specific commitments, instead of being buried in an identifier.

The foundation is a neutral substrate, designed to be pre-causal and pre-normative. It makes no causal or normative claims of its own; such claims can enter only as attributed assertions with a source. Parties who disagree about cause or responsibility can therefore still share the same records. This foundation is formalized in Lean under stated assumptions.

What is open is which kinds of things need distinct identity treatment, and why they must differ. That remains active research. Papers, specifications, and other repositories written before this work may use an older inventory of kinds and are being revised as the theory settles.

Core Statement

SE keeps structural commitments separate from the claims built on them. The foundation records identity, structure, transformation, and change; interpretive claims sit above it, each attributed to a source.

Structural Explainability is not anti-interpretation; it is anti-implicit interpretation. Interpretation is welcome when it is stated, attributed, and open to dispute, so disagreement remains explicit, attributable, and contestable over time.

SE supports independently developed accounts of identity and change without requiring a single authority, ontology, or interpretation.

Foundational and Related Theory

Lean 4 formalizations of SE concepts, relationships, and mathematical results.

Each repository owns its definitions, scientific claims, evidence, implementation, documentation, and release information.

Independent Theories

Independent (leaf) theories require no other SE theory repository:

Repository Role in Structural Explainability
se-theory-neutral-substrate Neutral structural and referential foundations, admissibility, and interpretive boundaries.
se-theory-persistence Identity survival and breakage under change, and the commitment calculus (consistency, required, forbidden, undetermined) other theories build on.
se-theory-transformation Structural transformation vocabulary, operators, and intrinsic change semantics.
se-theory-structural-assurability Claim-relative evidentiary capabilities, observational limits, and conditions for resolving or failing to resolve claims about systems.

Dependent and Integrative Theories

Dependent and integrative theories are built on other theories. Deps lists direct SE theory dependencies, excluding transitive dependencies.

NS=neutral substrate, PS=persistence, TR=transformation, IND=individuation, IR=identity regimes.

Deps Repository Role in Structural Explainability
NS+PS se-theory-individuation Conditions under which a presentation picks out one whole, and same-unit and distinct-unit judgments between presentations.
NS+PS+IND se-theory-coreference Context-indexed co-reference judgments, the identity they generate, and the distinct-commitments kept separate from them.
PS+TR se-theory-transformation-persistence Connections between transformation classifications and persistence semantics.
NS+PS se-theory-identity-regimes Regime-relative identity criteria and their relationships to transformations.
TBD se-theory-operational-identity Relationships between declared identity semantics and identity behavior induced by implementations.
TBD se-theory-interpretive-kernel Equivalence relationships and interpretation across distinct carriers.
NS+IR se-theory-structural-explainability Integration of foundational SE concepts and their structural relationships.

Theory Infrastructure

Repository Role
se-theory-reference-kit Shared validation, documentation, cataloging, and reference-artifact tooling for Lean theories.
se-protocols-research Scientific source audits, theory construction, independent review, and theory acceptance procedures.

Research Papers

Research papers develop and communicate the scientific and mathematical foundations of Structural Explainability.

Repository Subject
paper-100-neutral-substrate SE-100: Neutral Substrates
paper-200-identity-regimes SE-200: Referential Regimes
paper-210-operational-identity SE-210: Operational Identity
paper-220-interpretive-kernel SE-220: Interpretive Kernel
paper-320-structural-assurability Structural Assurability

Formal claims and their verification should be evaluated against the authoritative sources identified within each research repository.

Research Pilots

Research pilots evaluate the applicability, explanatory value, and limitations of SE concepts against concrete cases and external evidence.

Repository Research Role
se-pilot-individuation-comparison Source-grounded comparison of independently documented individuation accounts.
se-pilot-identity-preservation-supply-chain-software Identity-preservation conformance across software supply-chain representations, including SBOM formats.
se-pilot-structural-assurability Applied investigation of assurance claims, evidence capabilities, and evaluation limitations.

Verification and Executable Research

These repositories provide executable constructions, independent checks, or domain-specific verification.

Repository Role
se-verification-operational-identity Executable verification of finite Operational Identity constructions and algorithms.
se-verification-vulnerability-matching Examination of identity semantics in software vulnerability matching.
se-verification-judicial-record Structural verification for accountable judicial record systems.
se-interpretive-kernel Executable finite interpretive-kernel constructions and witnesses.

SE Ecosystem Infrastructure

Shared specifications, contracts, registries, and tools support consistency and traceability across repositories.

Repository Role
se-manifest-schema Repository manifest schema and validation.
se-constitution Common governance and structural rules for the SE ecosystem.
se-kernel Shared structural primitives and invariant vocabulary.
se-formal-contract Machine-checked formal contracts for operational SE components.
se-mapspec Structural mapping vocabulary and correspondence rules.
se-contract-kit Shared contract implementation and validation utilities.
se-admin Repository administration and ecosystem consistency tooling.
se-codeowners Projection of repository oversight metadata into GitHub CODEOWNERS files.
spec-se Structural Explainability specification.
spec-se-appendix Supporting disclosure and provenance appendix format.

Domain Applications and Mappings

These repositories apply SE structures and mapping concepts to external domains and information systems.

Repository Role
se-df Domain formalization toolkit.
se-mapping-assurance Structural mappings between assurance frameworks and SE assurance concepts.

Government-source repositories and other domain resources are available through the organization repository index.

How the Work Connects

Structural Explainability develops through related but distinct activities:

  • Papers develop and communicate scientific arguments.
  • Theory repositories formalize definitions, assumptions, and mathematical consequences.
  • Research pilots investigate whether proposed concepts apply faithfully to independently documented cases.
  • Verification repositories examine specified formal, algorithmic, or implementation properties.
  • Research protocols govern source analysis, adversarial review, and scientific acceptance.

For example, se-theory-individuation develops formal constructions concerning individuation, while se-pilot-individuation-comparison investigates the source-grounded comparison of individuation accounts.

Pinned Loading

  1. paper-100-neutral-substrate paper-100-neutral-substrate Public

    Paper defining neutral substrates that preserve shared reference without adopting contested interpretations.

    TeX 1

  2. paper-200-identity-regimes paper-200-identity-regimes Public

    This paper derives identity regimes that preserve stable reference when neutral substrates are transformed under persistent disagreement.

    TeX 1

  3. spec-ae spec-ae Public

    Authoritative specification of Accountable Entities (AE).

    Python 1

  4. spec-cee spec-cee Public

    Authoritative specification of Contextual Evidence & Explanations (CEE).

    1

  5. spec-ep spec-ep Public

    Authoritative specification of the Evolution Protocol (EP).

    Python 1

  6. spec-se spec-se Public

    Authoritative specification of Structural Explainability (SE).

    1

Repositories

Showing 10 of 86 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…