{
  "$schema": "./_schema/entity.v1.schema.json",
  "entity": {
    "id": "RLM",
    "title": "Realm",
    "description": "A namespace in which Entity Unique Identifiers are unique and Rule Identifier Format is consistent. The organizational boundary for rule authoring."
  },
  "rule_set": {
    "version": "0.41.59",
    "timestamp": "2026-11-09T11:44:23Z",
    "hash": "blake3:c3c14225c63dac5066a0c5bacb0d99002941116391f1dcb93f9f7544600fc6fd"
  },
  "rules": [
    {
      "id": "RLM-001",
      "revision": 0,
      "state": "I",
      "body": "IS a namespace in which Entity Unique Identifiers are unique.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-002",
      "revision": 0,
      "state": "I",
      "body": "HAS a Rule Identifier Format configuration.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-003",
      "revision": 0,
      "state": "I",
      "body": "MUST contain a `_schema/` directory with schema files used to validate its entities.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-004",
      "revision": 0,
      "state": "I",
      "body": "MUST contain a `realm.json` manifest at its root.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-005",
      "revision": 0,
      "state": "I",
      "body": "MAY declare dependencies on other Realms, importing their rules as read-only references.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-006",
      "revision": 0,
      "state": "I",
      "body": "MUST NOT define Entity Unique Identifiers that collide with any Realm it depends on.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-007",
      "revision": 0,
      "state": "I",
      "body": "An Entity MUST reside in the directory tree of exactly one Realm.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-008",
      "revision": 0,
      "state": "R",
      "body": "MUST have an identifier that follows reverse domain notation (e.g., `com.example.realm`) to ensure global uniqueness across organizations.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-009",
      "revision": 0,
      "state": "R",
      "body": "Cross-realm entity references MUST use the qualified form `<realm-id>:<EUID>`. Within the same Realm, the short form (EUID only) is sufficient.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-22",
      "supersedes": null
    },
    {
      "id": "RLM-010",
      "revision": 0,
      "state": "I",
      "body": "MAY declare sub-realms via a `sub_realms` array in its manifest, where each entry is a single directory name (no `/` or `..`), relative to the parent Realm directory, containing a child Realm.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-25",
      "supersedes": null
    },
    {
      "id": "RLM-011",
      "revision": 0,
      "state": "I",
      "body": "A sub-realm's identifier MUST equal `<parent-realm-id>.<subdirectory-name>`, where the subdirectory name MUST satisfy the realm-id segment grammar (`[a-z][a-z0-9]*`).",
      "added_by": "github:pleberre",
      "added_at": "2026-03-25",
      "supersedes": null
    },
    {
      "id": "RLM-012",
      "revision": 0,
      "state": "I",
      "body": "Sub-realms are limited to one level of nesting; a sub-realm MUST NOT declare its own `sub_realms`.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-25",
      "supersedes": null
    },
    {
      "id": "RLM-013",
      "revision": 0,
      "state": "I",
      "body": "EUID uniqueness (RLM-001) spans the parent Realm and all its declared sub-realms.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-25",
      "supersedes": null
    },
    {
      "id": "RLM-014",
      "revision": 0,
      "state": "I",
      "body": "A sub-realm inherits its parent's dependencies (RLM-005) and MAY declare additional dependencies of its own.",
      "added_by": "github:pleberre",
      "added_at": "2026-03-25",
      "supersedes": null
    },
    {
      "id": "RLM-015",
      "revision": 0,
      "state": "D",
      "body": "A sub-realm MUST inherit its parent Realm's Rule Identifier Format.",
      "added_by": "github:pleberre",
      "added_at": "2026-10-28",
      "supersedes": null
    },
    {
      "id": "RLM-016",
      "revision": 1,
      "state": "D",
      "body": "A Realm tree IS a top-level Realm together with all its declared sub-realms.",
      "added_by": "github:pleberre",
      "added_at": "2026-10-31",
      "supersedes": null
    },
    {
      "id": "RLM-017",
      "revision": 1,
      "state": "D",
      "body": "HAS a natural language, identified by a BCP 47 tag.",
      "added_by": "github:pleberre",
      "added_at": "2026-10-31",
      "supersedes": null
    },
    {
      "id": "RLM-018",
      "revision": 1,
      "state": "D",
      "body": "A sub-realm MUST inherit its parent Realm's language.",
      "added_by": "github:pleberre",
      "added_at": "2026-10-31",
      "supersedes": null
    },
    {
      "id": "RLM-019",
      "revision": 0,
      "state": "D",
      "body": "In a Realm's Entity files, Rule bodies, Notes and Entity titles MUST be written in the Realm's language, except for identifiers, code spans and Key Words.",
      "added_by": "github:pleberre",
      "added_at": "2026-10-31",
      "supersedes": null
    },
    {
      "id": "RLM-020",
      "revision": 0,
      "state": "D",
      "body": "The Realm tree of a sub-realm IS the Realm tree of its top-level Realm.",
      "added_by": "github:pleberre",
      "added_at": "2026-11-03",
      "supersedes": null
    },
    {
      "id": "RLM-021",
      "revision": 0,
      "state": "D",
      "body": "The language of a top-level Realm whose manifest declares none IS `en`.",
      "added_by": "github:pleberre",
      "added_at": "2026-11-03",
      "supersedes": null
    },
    {
      "id": "RLM-022",
      "revision": 0,
      "state": "D",
      "body": "The manifest of a sub-realm MUST NOT declare a language.",
      "added_by": "github:pleberre",
      "added_at": "2026-11-03",
      "supersedes": null
    },
    {
      "id": "RLM-023",
      "revision": 0,
      "state": "I",
      "body": "MUST have an identifier that follows reverse domain notation.",
      "added_by": "github:pleberre",
      "added_at": "2026-11-03",
      "supersedes": "RLM-008"
    },
    {
      "id": "RLM-024",
      "revision": 0,
      "state": "I",
      "body": "Cross-realm Entity references MUST use the qualified form `<realm-id>:<EUID>`.",
      "added_by": "github:pleberre",
      "added_at": "2026-11-05",
      "supersedes": "RLM-009"
    },
    {
      "id": "RLM-025",
      "revision": 0,
      "state": "I",
      "body": "An Entity reference within the same Realm MAY use the short form, the EUID alone.",
      "added_by": "github:pleberre",
      "added_at": "2026-11-05",
      "supersedes": "RLM-009"
    }
  ],
  "sub_entities": [
    {
      "$schema": "./_schema/entity.v1.schema.json",
      "entity": {
        "id": "RLMMNFST",
        "title": "Realm Manifest",
        "description": "The realm.json file that declares a Realm's identity, version, and dependencies.",
        "parent": "RLM"
      },
      "rule_set": {
        "version": "0.13.14",
        "timestamp": "2026-11-07T15:29:45Z",
        "hash": "blake3:783be206fce0d410427aa1d280cad838a5cd5d846e811ae65dd82dbe7b517af5"
      },
      "rules": [
        {
          "id": "RLMMNFST-001",
          "revision": 0,
          "state": "I",
          "body": "IS a JSON file named `realm.json` at the root of a Realm directory.",
          "added_by": "github:pleberre",
          "added_at": "2026-03-22",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-002",
          "revision": 0,
          "state": "I",
          "body": "MUST declare the Realm's identifier, title, and version.",
          "added_by": "github:pleberre",
          "added_at": "2026-03-22",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-003",
          "revision": 0,
          "state": "P",
          "body": "MAY declare dependencies on other Realms with pinned version references.",
          "added_by": "github:pleberre",
          "added_at": "2026-03-22",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-004",
          "revision": 0,
          "state": "P",
          "body": "MAY override the Rule Identifier Format defaults for the Realm.",
          "added_by": "github:pleberre",
          "added_at": "2026-03-22",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-005",
          "revision": 0,
          "state": "I",
          "body": "MAY declare a `sub_realms` field, which MUST be either null or an array of unique strings matching the realm-id segment grammar (`[a-z][a-z0-9]*`), where each string is the name of a subdirectory that MUST contain a valid `realm.json`.",
          "added_by": "github:pleberre",
          "added_at": "2026-03-25",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-006",
          "revision": 0,
          "state": "D",
          "body": "MAY declare a top-level Realm's language in a `language` field of the `realm` object, whose value MUST be `en`.",
          "added_by": "github:pleberre",
          "added_at": "2026-10-31",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-007",
          "revision": 0,
          "state": "D",
          "body": "MAY declare a `standards` array of Standard References in the `realm` object.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-008",
          "revision": 0,
          "state": "D",
          "body": "MAY declare a `kind` field in the `realm` object, whose value MUST be `standard`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-009",
          "revision": 0,
          "state": "D",
          "body": "A Realm whose manifest declares no kind IS a code Realm.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-010",
          "revision": 0,
          "state": "D",
          "body": "MAY declare a `license` field in the `realm` object, whose value MUST be an SPDX license identifier.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-011",
          "revision": 0,
          "state": "D",
          "body": "MAY declare an `attribution` object in the `realm` object, with a non-empty `text` and an absolute `http` or `https` `url`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-012",
          "revision": 0,
          "state": "D",
          "body": "MAY declare a `notes` array of Realm Notes.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-013",
          "revision": 0,
          "state": "D",
          "body": "HAS a `hash`, the Blake3 hash of the manifest without its `hash` field, computed as for a Rule Set Hash.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "RLMMNFST-014",
          "revision": 0,
          "state": "D",
          "body": "The `hash` MUST be recomputed in every change to the manifest.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        }
      ],
      "notes": [
        {
          "id": "RLMMNFST-004/01",
          "rule_ref": "RLMMNFST-004",
          "type": "clarification",
          "content": "The override is the rule_identifier_format field of realm.json, typed by realm.v1.schema.json as an object or null. Each field is optional and falls back to its default: brackets (RLIFRMT-002, \"[,]\"), euid_position (RLIFRMT-003, \"opening\"), id_splitter (RLIFRMT-005, \"-\"), revision_splitter (RLIFRMT-006, \".\"), state_splitter (RLIFRMT-007, \"/\"). RLIFRMT-004 has no field because the Rule Set Unique Number always takes the opposing position. For a top-level Realm, null keeps every default; for a sub-realm, null means the parent's format applies (RLM-015). The format changes rendering only (RLIFRMT-008).",
          "added_by": "github:pleberre",
          "added_at": "2026-10-28",
          "revision": 0
        },
        {
          "id": "RLMMNFST-006/01",
          "rule_ref": "RLMMNFST-006",
          "type": "rationale",
          "content": "The value is limited to `en` because the Key Words are defined as English terms (KWRD-002 to KWRD-006). Accepting another language first needs a Rule for how Key Words read in it.",
          "added_by": "github:pleberre",
          "added_at": "2026-10-31",
          "revision": 0
        },
        {
          "id": "RLMMNFST-013/01",
          "rule_ref": "RLMMNFST-013",
          "type": "clarification",
          "content": "The hash covers the whole manifest, `realm.version` and `dependencies` included. Release bumps and pin changes must therefore recompute it, through the CLI.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "revision": 0
        },
        {
          "id": "RLMMNFST-012/01",
          "rule_ref": "RLMMNFST-012",
          "type": "clarification",
          "content": "A sub-realm's manifest can hold Realm Notes too: no rule limits them to the top-level Realm, as RLM-022 does for language. An exclusion's ref names a Standard Reference of the same manifest (NTE-034), so a sub-realm that declares its own linked Standard Reference keeps that reference's exclusions in its own manifest.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "revision": 0
        }
      ]
    },
    {
      "$schema": "./_schema/entity.v1.schema.json",
      "entity": {
        "id": "STDREF",
        "title": "Standard Reference",
        "description": "A citation of an external standard, declared by a Realm or an Entity.",
        "parent": "RLM"
      },
      "rule_set": {
        "version": "0.1.49",
        "timestamp": "2026-11-07T16:32:28Z",
        "hash": "blake3:99d3129e8771f8168168a4bbb328f798892f0fc751358853b36d0424f7adeb38"
      },
      "rules": [
        {
          "id": "STDREF-001",
          "revision": 0,
          "state": "D",
          "body": "IS a citation of an external standard held in a `standards` array.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-002",
          "revision": 0,
          "state": "D",
          "body": "HAS an `id` matching `^[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)+$`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-003",
          "revision": 0,
          "state": "D",
          "body": "The `id` MUST be unique within its `standards` array.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-004",
          "revision": 0,
          "state": "D",
          "body": "HAS a `relation` of `implements` or `derived_from`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-005",
          "revision": 0,
          "state": "D",
          "body": "The relation `implements` IS a claim of coverage of the standard.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-006",
          "revision": 0,
          "state": "D",
          "body": "The relation `derived_from` IS a citation of the standard as a source, with no claim of coverage.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-007",
          "revision": 0,
          "state": "D",
          "body": "MAY have a `version`, a non-empty free string naming the edition of the standard.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-008",
          "revision": 1,
          "state": "D",
          "body": "MAY have a `url`, the absolute `http` or `https` URL of the standard.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-009",
          "revision": 0,
          "state": "D",
          "body": "An `inherits` declaration MUST NOT make a Standard Reference of the inherited Entity available to the `standard` Notes of the inheriting Entity's own Rules.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-010",
          "revision": 0,
          "state": "D",
          "body": "The coverage rule set of an Entity IS its own Rules in state Draft, Published or Implemented with the Rules it acquires under ENT-009, less those that any of them overrides.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-011",
          "revision": 0,
          "state": "D",
          "body": "A clause IS identified by its `<clause>` together with the `id` and `version` of the Standard Reference its `standard` Note resolves to under NTE-016.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-012",
          "revision": 0,
          "state": "D",
          "body": "A clause IS covered in an Entity if and only if a `standard` Note naming it, whose Standard Reference has relation `implements`, is on a Rule in state Implemented in the coverage rule set of that Entity.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-013",
          "revision": 0,
          "state": "D",
          "body": "A clause not covered in an Entity IS mapped there if and only if a `standard` Note naming it, whose Standard Reference has relation `implements`, is on a Rule in the coverage rule set of that Entity.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-014",
          "revision": 0,
          "state": "D",
          "body": "A clause neither covered nor mapped in an Entity IS lapsed there when a `standard` Note naming it, whose Standard Reference has relation `implements`, is on a Rule in state Retired or Terminated owned by the Entity or an Entity it inherits from.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-015",
          "revision": 0,
          "state": "D",
          "body": "A clause neither covered nor mapped in an Entity IS lapsed there when a `standard` Note naming it, whose Standard Reference has relation `implements`, is on a Rule that an override by the Entity or an Entity it inherits from replaced.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-016",
          "revision": 0,
          "state": "D",
          "body": "A Rule that overrides or supersedes another Rule IS mapped only by its own `standard` Notes.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "supersedes": null
        },
        {
          "id": "STDREF-017",
          "revision": 0,
          "state": "D",
          "body": "MAY have a `realm`, the `realm_id` of a Standard Realm that is a dependency of the Realm tree declaring the Standard Reference.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-018",
          "revision": 0,
          "state": "D",
          "body": "A Standard Reference with a `realm` MUST have a `version` equal to the `edition` of that Realm.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-019",
          "revision": 0,
          "state": "D",
          "body": "MAY have a `profile` only when it has a `realm`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-020",
          "revision": 0,
          "state": "D",
          "body": "The clause list of a Standard Reference with a `realm` IS the clause list of that Realm, limited when it has a `profile` to the clauses whose Rules declare that profile.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-021",
          "revision": 0,
          "state": "D",
          "body": "The `<clause>` of a `standard` Note whose Standard Reference has a `realm` MUST be in the clause list of that Realm, matched exactly.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-022",
          "revision": 1,
          "state": "D",
          "body": "A clause IS excluded for a Standard Reference when the manifest that declares the reference holds a Note of type `exclusion` naming it.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-023",
          "revision": 0,
          "state": "D",
          "body": "A clause of the clause list of a Standard Reference that is neither covered, mapped, lapsed nor excluded in an Entity IS unmapped there.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-024",
          "revision": 1,
          "state": "D",
          "body": "The coverage figure of an Entity for a Standard Reference with a `realm` IS the number of its clauses covered and not excluded there divided by the number in its clause list less those excluded there.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-025",
          "revision": 0,
          "state": "D",
          "body": "The Realm coverage figure of a Standard Reference IS the figure of STDREF-024 with a clause counted as covered when it is covered in any Entity of the Realm tree.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-026",
          "revision": 0,
          "state": "D",
          "body": "A Standard Reference with relation `derived_from` HAS no coverage figure.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-027",
          "revision": 0,
          "state": "D",
          "body": "The `profile` of a Standard Reference MUST name one of the `profiles` of the Realm named by its `realm`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDREF-028",
          "revision": 0,
          "state": "D",
          "body": "A coverage figure whose divisor is zero IS undefined.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        }
      ],
      "notes": [
        {
          "id": "STDREF-002/01",
          "rule_ref": "STDREF-002",
          "type": "applies_to",
          "content": "The `standards` array of a Realm manifest or an Entity file in a rule directory, not any other data of that name.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-002/02",
          "rule_ref": "STDREF-002",
          "type": "rationale",
          "content": "There is no central registry of standards, so a Realm chooses its own slug, and requiring a dot keeps the form namespaced.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-002/03",
          "rule_ref": "STDREF-002",
          "type": "example",
          "content": "`owasp.asvs` and `ietf.rfc2119` are valid values of `id`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-003/01",
          "rule_ref": "STDREF-003",
          "type": "applies_to",
          "content": "The `standards` array of a Realm manifest or an Entity file in a rule directory, not any other data of that name.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-004/01",
          "rule_ref": "STDREF-004",
          "type": "applies_to",
          "content": "The `standards` array of a Realm manifest or an Entity file in a rule directory, not any other data of that name.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-007/01",
          "rule_ref": "STDREF-007",
          "type": "applies_to",
          "content": "The `standards` array of a Realm manifest or an Entity file in a rule directory, not any other data of that name.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-007/02",
          "rule_ref": "STDREF-007",
          "type": "rationale",
          "content": "Semantic versioning cannot express the edition of every standard, and an RFC has no version. The edition of a standard is separate from the version of the Realm citing it.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-007/03",
          "rule_ref": "STDREF-007",
          "type": "example",
          "content": "`ISO 27001:2022` and `ECSS-E-ST-40C Rev.1` are valid values of `version`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-008/01",
          "rule_ref": "STDREF-008",
          "type": "applies_to",
          "content": "The `standards` array of a Realm manifest or an Entity file in a rule directory, not any other data of that name.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-009/01",
          "rule_ref": "STDREF-009",
          "type": "rationale",
          "content": "A citation describes the declaring Entity, and an inheriting Entity may override Rules so that the citation no longer holds for it. Notes on an inherited Rule resolve from the Entity that owns the Rule.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-010/01",
          "rule_ref": "STDREF-010",
          "type": "rationale",
          "content": "An overriding Rule counts from Draft, as it does in default evaluation, so a clause stops being covered in that Entity as soon as its replacement is drafted, not when the replacement is promoted.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-011/01",
          "rule_ref": "STDREF-011",
          "type": "rationale",
          "content": "Editions renumber their clauses, so the same `<clause>` under two versions of a standard names two different clauses.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-012/01",
          "rule_ref": "STDREF-012",
          "type": "rationale",
          "content": "SteerSpec holds no clause lists, because the text of many standards is licensed, so coverage says what is mapped and implemented and cannot name a clause that nothing maps.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-014/01",
          "rule_ref": "STDREF-014",
          "type": "rationale",
          "content": "With no clause lists, a clause that loses its only Rule would otherwise disappear from a report without trace.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-016/01",
          "rule_ref": "STDREF-016",
          "type": "rationale",
          "content": "Without this, an inheriting Entity could weaken a Rule and still claim the clause.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-01",
          "revision": 0
        },
        {
          "id": "STDREF-021/01",
          "rule_ref": "STDREF-021",
          "type": "clarification",
          "content": "The check uses the whole clause list of the linked Realm, not the list narrowed by `profile`. A Rule may map a clause above the claimed profile; that mapping is valid, and the figure counts only clauses in the profile (STDREF-020).",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "revision": 0
        },
        {
          "id": "STDREF-025/01",
          "rule_ref": "STDREF-025",
          "type": "clarification",
          "content": "The exclusions are those of the manifest that declares the Standard Reference (STDREF-022), since an exclusion names a reference of its own manifest (NTE-034). A sub-realm that declares a reference with the same id declares a separate reference, with its own exclusions and its own figure.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "revision": 0
        }
      ]
    },
    {
      "$schema": "./_schema/entity.v1.schema.json",
      "entity": {
        "id": "STDRLM",
        "title": "Standard Realm",
        "description": "A Realm that transcribes one edition of an external standard, as one or more Rules per clause.",
        "parent": "RLM"
      },
      "rule_set": {
        "version": "0.1.32",
        "timestamp": "2026-11-09T11:44:23Z",
        "hash": "blake3:334ea7240bdc38489a73fc3635eaf555d8d5f6cc9852f60dea9e97f42e74c154"
      },
      "rules": [
        {
          "id": "STDRLM-001",
          "revision": 0,
          "state": "D",
          "body": "IS a Realm whose manifest declares the kind `standard`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-002",
          "revision": 0,
          "state": "D",
          "body": "MUST declare an `edition` field in the `realm` object of its manifest, a non-empty string naming the edition of the standard it transcribes.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-003",
          "revision": 0,
          "state": "D",
          "body": "MUST declare a `license` field in the `realm` object of its manifest.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-004",
          "revision": 0,
          "state": "D",
          "body": "MAY declare a `profiles` array of unique non-empty names in the `realm` object of its manifest.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-005",
          "revision": 0,
          "state": "D",
          "body": "Every live Rule of a Standard Realm MUST have a `clause`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-006",
          "revision": 0,
          "state": "D",
          "body": "The clause list of a Standard Realm IS the distinct `clause` values of its live Rules.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-007",
          "revision": 0,
          "state": "D",
          "body": "The text of a clause IS the bodies of the live Rules carrying it, in Rule identifier order.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-008",
          "revision": 0,
          "state": "D",
          "body": "Each entry of the `profiles` of a Rule MUST be declared in the `profiles` of its Realm.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-009",
          "revision": 0,
          "state": "D",
          "body": "The live Rules carrying one `clause` MUST declare the same `profiles`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-010",
          "revision": 0,
          "state": "D",
          "body": "A Rule of a Standard Realm MUST NOT enter Implemented.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-011",
          "revision": 0,
          "state": "D",
          "body": "The Rules of a Standard Realm MUST NOT be evaluated against code.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-012",
          "revision": 0,
          "state": "D",
          "body": "A Rule of a Standard Realm that supersedes another MUST have the `clause` of the Rule it supersedes.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-013",
          "revision": 0,
          "state": "D",
          "body": "When a Rule of a Standard Realm that supersedes another enters Published, the superseded Rule MUST enter Terminated in the same change.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-014",
          "revision": 0,
          "state": "D",
          "body": "A live Rule of a Standard Realm IS a Rule that is not Abandoned, Retired or Terminated and is not a Draft Rule that supersedes another.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-015",
          "revision": 0,
          "state": "D",
          "body": "MUST declare an `attribution` object in the `realm` object of its manifest.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-016",
          "revision": 0,
          "state": "D",
          "body": "At most one Rule that is not Abandoned MAY supersede a given Rule of a Standard Realm.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-017",
          "revision": 0,
          "state": "D",
          "body": "A Rule of a Standard Realm MUST supersede only a live Rule.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-018",
          "revision": 0,
          "state": "D",
          "body": "When a Standard Realm declares `profiles`, each of its live Rules MUST declare `profiles`.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "supersedes": null
        },
        {
          "id": "STDRLM-019",
          "revision": 0,
          "state": "D",
          "body": "The body of a Rule of a Standard Realm MUST be the wording of the standard for its clause, divided only at sentence ends (RUL-004).",
          "added_by": "github:pleberre",
          "added_at": "2026-11-09",
          "supersedes": null
        },
        {
          "id": "STDRLM-020",
          "revision": 0,
          "state": "D",
          "body": "The body of a Rule of a Standard Realm MAY hold no Key Word.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-09",
          "supersedes": null
        },
        {
          "id": "STDRLM-021",
          "revision": 0,
          "state": "D",
          "body": "Examples in the body of a Rule of a Standard Realm MAY stay in the body, as an exception to NTE-020.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-09",
          "supersedes": null
        }
      ],
      "sub_entities": [
        {
          "$schema": "./_schema/entity.v1.schema.json",
          "entity": {
            "id": "STDCWK",
            "title": "Crosswalk",
            "description": "A mapping from the clauses of an earlier edition of a standard to those of a Standard Realm.",
            "parent": "STDRLM"
          },
          "rule_set": {
            "version": "0.1.7",
            "timestamp": "2026-11-07T09:17:57Z",
            "hash": "blake3:a4fd9609f9b5aac983a4c7abd52c1842011362922551b2dc8a81d95d0916b4d7"
          },
          "rules": [
            {
              "id": "STDCWK-001",
              "revision": 0,
              "state": "D",
              "body": "IS a mapping from the clauses of an earlier edition of a standard to the clause list of a Standard Realm.",
              "added_by": "github:pleberre",
              "added_at": "2026-11-07",
              "supersedes": null
            },
            {
              "id": "STDCWK-002",
              "revision": 0,
              "state": "D",
              "body": "MUST be stored in the file `_crosswalk/<edition>.json` of the Standard Realm, where `<edition>` is the earlier edition.",
              "added_by": "github:pleberre",
              "added_at": "2026-11-07",
              "supersedes": null
            },
            {
              "id": "STDCWK-003",
              "revision": 0,
              "state": "D",
              "body": "HAS a `from` equal to the earlier edition and an `entries` array.",
              "added_by": "github:pleberre",
              "added_at": "2026-11-07",
              "supersedes": null
            },
            {
              "id": "STDCWK-004",
              "revision": 0,
              "state": "D",
              "body": "Each entry HAS a `clause` of the earlier edition and a `kind` of `moved`, `modified`, `split`, `merged`, `covered_by` or `deleted`.",
              "added_by": "github:pleberre",
              "added_at": "2026-11-07",
              "supersedes": null
            },
            {
              "id": "STDCWK-005",
              "revision": 0,
              "state": "D",
              "body": "An entry whose kind is not `deleted` MUST list in `to` one or more clauses of the clause list of the Standard Realm.",
              "added_by": "github:pleberre",
              "added_at": "2026-11-07",
              "supersedes": null
            },
            {
              "id": "STDCWK-006",
              "revision": 0,
              "state": "D",
              "body": "An entry of kind `deleted` MAY have a `reason`.",
              "added_by": "github:pleberre",
              "added_at": "2026-11-07",
              "supersedes": null
            },
            {
              "id": "STDCWK-007",
              "revision": 0,
              "state": "D",
              "body": "A clause of the earlier edition MUST appear in at most one entry.",
              "added_by": "github:pleberre",
              "added_at": "2026-11-07",
              "supersedes": null
            }
          ],
          "notes": []
        }
      ],
      "notes": [
        {
          "id": "STDRLM-007/01",
          "rule_ref": "STDRLM-007",
          "type": "rationale",
          "content": "A clause with more than one sentence is split into several Rules so that each Rule stays a single phrase (RUL-004). The clause remains the unit that `standard` Notes name and that coverage counts.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-07",
          "revision": 0
        },
        {
          "id": "STDRLM-019/01",
          "rule_ref": "STDRLM-019",
          "type": "rationale",
          "content": "A Standard Realm transcribes text it doesn't own. Rewording a requirement around a Key Word, or moving its examples to Notes, would change what the standard says and break the match between a clause and its text (STDRLM-007). The checks for Key Words and inline examples are for Rules that SteerSpec users write.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-09",
          "revision": 0
        },
        {
          "id": "STDRLM-020/01",
          "rule_ref": "STDRLM-020",
          "type": "example",
          "content": "ASVS writes its requirements as \"Verify that …\", with no RFC 2119 Key Word.",
          "added_by": "github:pleberre",
          "added_at": "2026-11-09",
          "revision": 0
        }
      ]
    }
  ],
  "notes": [
    {
      "id": "RLM-015/01",
      "rule_ref": "RLM-015",
      "type": "clarification",
      "content": "A sub-realm shares its parent Realm's identifier namespace (RLM-013), so it also shares the parent's Rule Identifier Format and its manifest leaves rule_identifier_format null (RLMMNFST-004). Dependent Realms are separate namespaces: a Realm never inherits the format of a Realm it depends on, each one has its own configuration (RLM-002).",
      "added_by": "github:pleberre",
      "added_at": "2026-10-28",
      "revision": 0
    },
    {
      "id": "RLM-016/01",
      "rule_ref": "RLM-016",
      "type": "clarification",
      "content": "Realm tree membership compares Realm identifiers: a Realm is the same Realm at any version, and the identifier in its manifest is trusted because it is globally unique (RLM-023). An Entity belongs to the Realm with the nearest manifest above it. Membership is read from the manifest of the top-level Realm, because a sub-realm's identifier does not show that the parent declares it and its manifest does not list its siblings, so a sub-realm resolved on its own cannot see them. A check that depends on the Realm tree is therefore defined from the top-level Realm.",
      "added_by": "github:pleberre",
      "added_at": "2026-10-31",
      "revision": 1
    },
    {
      "id": "RLM-019/01",
      "rule_ref": "RLM-019",
      "type": "clarification",
      "content": "A Rule that an Entity inherits from an Entity in another Realm, or that a Realm imports from a dependency (RLM-005), stays in its owning Entity's file and follows the language of that Entity's Realm, whatever the importing Realm's language. A Rule declaring `overrides` follows the language of the declaring Entity's Realm.",
      "added_by": "github:pleberre",
      "added_at": "2026-10-31",
      "revision": 1
    },
    {
      "id": "RLM-019/02",
      "rule_ref": "RLM-019",
      "type": "rationale",
      "content": "Language detection is unreliable on short text that is mostly domain terms, so this Rule is enforced in review and no automated check detects the text's language.",
      "added_by": "github:pleberre",
      "added_at": "2026-10-31",
      "revision": 0
    },
    {
      "id": "RLM-023/01",
      "rule_ref": "RLM-023",
      "type": "example",
      "content": "`com.example.realm`",
      "added_by": "github:pleberre",
      "added_at": "2026-11-03",
      "revision": 0
    },
    {
      "id": "RLM-023/02",
      "rule_ref": "RLM-023",
      "type": "rationale",
      "content": "Reverse domain notation keeps Realm identifiers unique across organizations.",
      "added_by": "github:pleberre",
      "added_at": "2026-11-03",
      "revision": 0
    }
  ]
}
