Skip to content

Commit 2efef1d

Browse files
denisecasedenisecase
committed
clarify AE/EP
1 parent f778e66 commit 2efef1d

2 files changed

Lines changed: 34 additions & 24 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ Initialize once:
1616
uv self update
1717
uv python pin 3.15
1818
uvx pre-commit install
19+
1920
uvx pre-commit run --all-files
2021
npx markdownlint-cli2 --fix
2122
```

‎profile/README.md‎

Lines changed: 33 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -506,7 +506,8 @@ This organization is structured around roles:
506506

507507
These repositories define the admissible representational space
508508
for structurally explainable systems.
509-
They are normative only in the sense of **defining structural constraints**, not interpretations.
509+
They are normative only in the sense of defining structural constraints,
510+
not interpretations.
510511

511512
<details>
512513
<summary>See more</summary>
@@ -521,15 +522,22 @@ Defines neutrality and boundary constraints that apply to all downstream systems
521522

522523
### Accountable Entity and Evolution Specifications
523524

524-
These repositories define the accountable-entity and evolution layers
525-
used by downstream structurally explainable information systems.
525+
Accountable Entities defines the entity-kind layer used by downstream
526+
information systems:
527+
Actor, Locus, Instrument, Event, Scope, and Observation.
528+
It references canonical identity-regime profiles defined in
529+
`se-theory-identity-regimes`; it does not define those profiles.
526530

527-
| Repository | Purpose | Status |
528-
| --------------------------------------------------------------- | ----------------------------------------- | --------- |
529-
| [spec-ae](https://github.com/structural-explainability/spec-ae) | Accountable Entities and identity regimes | Normative |
530-
| [spec-ep](https://github.com/structural-explainability/spec-ep) | Graph evolution over accountable entities | Normative |
531+
Evolution Protocol defines graph evolution over accountable entities.
532+
Together, these specifications define reusable structural vocabularies for
533+
systems that need accountable-entity and evolution layers.
531534

532-
### Interface (CEE)
535+
| Repository | Purpose | Status |
536+
| --------------------------------------------------------------- | ----------------------------------------------------------------------- | --------- |
537+
| [spec-ae](https://github.com/structural-explainability/spec-ae) | Accountable entity kinds; references canonical identity-regime profiles | Normative |
538+
| [spec-ep](https://github.com/structural-explainability/spec-ep) | Graph evolution over accountable entities | Normative |
539+
540+
### Interface Specification (CEE)
533541

534542
The Contextual Evidence and Explanation (CEE) layer defines
535543
a structural interface to the neutral substrate.
@@ -539,19 +547,20 @@ It does not alter identity, structure, or recorded change.
539547
| ----------------------------------------------------------------- | ------------------------------------------------------------- | --------- |
540548
| [spec-cee](https://github.com/structural-explainability/spec-cee) | Contextual evidence, explanation, attestation, and provenance | Normative |
541549

542-
### Boundaries (GB / IB)
550+
### Boundary Specifications (GB / IB)
543551

544552
These repositories define additional structural boundaries
545553
that operate relative to the neutral substrate.
546554
They do not alter identity, structure, or recorded change.
547-
They serve as guardrails that prevent interpretation from leaking into the neutral substrate.
555+
They prevent interpretation, governance status, or external authority claims
556+
from leaking into the neutral substrate.
548557

549558
| Repository | Purpose | Status |
550559
| --------------------------------------------------------------- | -------------------------------------------------------- | --------- |
551560
| [spec-gb](https://github.com/structural-explainability/spec-gb) | Governance boundary for structural artifacts and actions | Normative |
552561
| [spec-ib](https://github.com/structural-explainability/spec-ib) | Interpretation boundary for external frameworks | Normative |
553562

554-
### Informative
563+
### Informative Specification Materials
555564

556565
| Repository | Purpose | Status |
557566
| --------------------------------------------------------------------------------- | --------------------------------------------------- | ----------- |
@@ -582,10 +591,10 @@ These repositories provide reusable accountable-entity and evolution foundations
582591
for downstream systems that need them.
583592
They are reference implementation layers, not universal dependencies.
584593

585-
| Repository | Purpose | CI | Description |
586-
| --------------------------------------------------------------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
587-
| [AccountableEntities](https://github.com/structural-explainability/AccountableEntities) | Entity-regime instantiation | ![CI](https://github.com/structural-explainability/AccountableEntities/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Formalization of AE identity regimes |
588-
| [EvolutionProtocol](https://github.com/structural-explainability/EvolutionProtocol) | Neutral exchange substrate | ![CI](https://github.com/structural-explainability/EvolutionProtocol/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Formalization of EP graph evolution |
594+
| Repository | Purpose | CI | Description |
595+
| --------------------------------------------------------------------------------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
596+
| [AccountableEntities](https://github.com/structural-explainability/AccountableEntities) | Accountable entity kinds | ![CI](https://github.com/structural-explainability/AccountableEntities/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Lean formalization of six AE entity kinds and their mapping to canonical identity-regime profiles |
597+
| [EvolutionProtocol](https://github.com/structural-explainability/EvolutionProtocol) | Graph evolution over entities | ![CI](https://github.com/structural-explainability/EvolutionProtocol/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Formalization of EP graph evolution |
589598

590599
### Optional Interface Implementation (CEE)
591600

@@ -594,9 +603,9 @@ explanation, attestation, and provenance.
594603
Systems may implement equivalent boundary-respecting structures without depending
595604
on this repository directly.
596605

597-
| Repository | Purpose | CI | Description |
598-
| ------------------------------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
599-
| [CEE](https://github.com/structural-explainability/CEE) | Explanation overlay | ![CI](https://github.com/structural-explainability/CEE/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Structural forms for contextual explanation and evidence |
606+
| Repository | Purpose | CI | Description |
607+
| ------------------------------------------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
608+
| [CEE](https://github.com/structural-explainability/CEE) | Contextual evidence and explanation interface | ![CI](https://github.com/structural-explainability/CEE/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Structural forms for contextual explanation, evidence, attestation, and provenance |
600609

601610
### Optional Boundary Implementations (GB / IB)
602611

@@ -607,19 +616,19 @@ for systems that already enforce these constraints internally.
607616

608617
| Repository | Purpose | CI | Description |
609618
| --------------------------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
610-
| [GovernanceBoundary](https://github.com/structural-explainability/GovernanceBoundary) | Governance boundary | ![CI](https://github.com/structural-explainability/GovernanceBoundary/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Governance |
619+
| [GovernanceBoundary](https://github.com/structural-explainability/GovernanceBoundary) | Governance boundary | ![CI](https://github.com/structural-explainability/GovernanceBoundary/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Structural boundary for governance artifacts and actions |
611620
| [InterpretationBoundary](https://github.com/structural-explainability/InterpretationBoundary) | Interpretation boundary | ![CI](https://github.com/structural-explainability/InterpretationBoundary/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Conditions under which external frameworks may interpret substrate records |
612621

613622
### Archived / Superseded Theory Repositories
614623

615624
> ⚠️ The repositories below are archived. Active development has moved to
616625
> the `se-theory-*` series.
617626
618-
| Repository | Purpose | CI | Description |
619-
| ------------------------------------------------------------------------------------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
620-
| [StructuralExplainability](https://github.com/structural-explainability/StructuralExplainability) | Cross-cutting constraints | ![CI](https://github.com/structural-explainability/StructuralExplainability/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Neutrality and conformance predicates |
621-
| [NeutralSubstrate](https://github.com/structural-explainability/NeutralSubstrate) | Neutrality theorem | ![CI](https://github.com/structural-explainability/NeutralSubstrate/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Substrates stable under incompatible extensions must be pre-causal and pre-normative |
622-
| [IdentityRegimes](https://github.com/structural-explainability/IdentityRegimes) | Identity regimes | ![CI](https://github.com/structural-explainability/IdentityRegimes/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Six identity-and-persistence regime (families) are necessary and sufficient for accountability-oriented substrates under neutrality assumptions |
627+
| Repository | Purpose | CI | Description |
628+
| ------------------------------------------------------------------------------------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
629+
| [StructuralExplainability](https://github.com/structural-explainability/StructuralExplainability) | Cross-cutting constraints | ![CI](https://github.com/structural-explainability/StructuralExplainability/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Neutrality and conformance predicates |
630+
| [NeutralSubstrate](https://github.com/structural-explainability/NeutralSubstrate) | Neutrality theorem | ![CI](https://github.com/structural-explainability/NeutralSubstrate/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Substrates stable under incompatible extensions must be pre-causal and pre-normative |
631+
| [IdentityRegimes](https://github.com/structural-explainability/IdentityRegimes) | Identity regimes | ![CI](https://github.com/structural-explainability/IdentityRegimes/actions/workflows/ci-lean.yml/badge.svg?branch=main) | Earlier formalization of six identity-and-persistence regime families as a necessary lower bound under neutrality assumptions |
623632

624633
</details>
625634

0 commit comments

Comments
 (0)