Skip to content

Commit 2150107

Browse files
committed
general
1 parent 78b1d25 commit 2150107

3 files changed

Lines changed: 22 additions & 13 deletions

File tree

IDENTIFIERS.md

Lines changed: 20 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -37,53 +37,62 @@ Identifiers are:
3737
- suitable for direct mapping to Lean theorem names
3838

3939
Identifiers MUST NOT be renamed or repurposed.
40-
New identifiers MAY be added only in a new major version of CEE.
40+
New identifiers MAY be added only in a new major version of this document.
41+
42+
## Identifier Notes
43+
44+
Each identifier MUST be followed by exactly one note.
45+
46+
- The note MUST be expressed as a single bullet.
47+
- The bullet text MAY wrap across lines.
48+
- No additional bullets, sublists, or structural markers are permitted.
49+
- Notes are explanatory only and do not introduce additional requirements.
4150

4251
## Canonical Identifier List (Alphabetical, with Notes)
4352

4453
CEE.ATTESTATION
4554

46-
Defines records asserting responsibility for an explanation under a given context.
55+
- Defines records asserting responsibility for an explanation under a given context.
4756

4857
CEE.CONFORMANCE.AE.EP.REQUIRED
4958

50-
States that CEE operates over Accountable Entities and Evolution Protocol artifacts.
59+
- States that CEE operates over Accountable Entities and Evolution Protocol artifacts.
5160

5261
CEE.CONFORMANCE.SE.REQUIRED
5362

54-
States that CEE conforms to the Structural Explainability specification.
63+
- States that CEE conforms to the Structural Explainability specification.
5564

5665
CEE.CONTEXT.TAG
5766

58-
Defines identifiers for interpretive contexts applied to explanations.
67+
- Defines identifiers for interpretive contexts applied to explanations.
5968

6069
CEE.DEFINITION.CORE
6170

62-
Defines CEE as a framework for attaching interpretive content to substrate history.
71+
- Defines CEE as a framework for attaching interpretive content to substrate history.
6372

6473
CEE.EXPLANATION.RECORD
6574

66-
Defines records associating explanatory content with substrate references.
75+
- Defines records associating explanatory content with substrate references.
6776

6877
CEE.MULTIPLICITY
6978

70-
Requires support for multiple, potentially conflicting interpretations.
79+
- Requires support for multiple, potentially conflicting interpretations.
7180

7281
CEE.PROVENANCE
7382

74-
Defines records describing how explanatory content was produced.
83+
- Defines records describing how explanatory content was produced.
7584

7685
CEE.SCOPE.EXCLUSIONS
7786

78-
Defines what CEE explicitly does not specify.
87+
- Defines what CEE explicitly does not specify.
7988

8089
## Cross-Artifact Consistency Rule
8190

8291
Each identifier in this list MUST appear:
8392

8493
- exactly once in SPEC.md
8594
- exactly once in CONFORMANCE.md
86-
- exactly once as a field in the Lean ConformanceEvidence structure
95+
- exactly once as a field in the Lean `ConformanceEvidence` structure
8796
- exactly once in the Lean requirements list
8897

8998
Alphabetical order SHOULD be preserved across all artifacts.

SE_MANIFEST.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ excludes = [
4141
[citation]
4242
cff = "CITATION.cff"
4343
preferred = "spec"
44-
bib_hint = "spec-cee-2025"
44+
bib_hint = "case2025-spec-cee"
4545

4646
[traceability]
4747
identifier_map = "none"

SPEC.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Some requirements describe what the substrate MAY represent,
2929
while others constrain how such representations MUST NOT be interpreted.
3030

3131
Overlap between these classes is intentional:
32-
representation permissions do not imply explanatory commitment.
32+
representation permissions do not imply explanatory or normative commitment.
3333

3434
## Identifier Semantics and Stability
3535

0 commit comments

Comments
 (0)