Structural Proper Mutations

Structural proper mutations including insertions, replacements, and omissions.

Propers do not only fill slots. They may insert, omit, replace, or reorder parts of the Ordo.

{
  "id": "proper-holy-friday",
  "mutations": [
    {
      "op": "insertAfter",
      "target": "sec-liturgy-of-word",
      "value": { "$ref": "sec-holy-friday-veneration" }
    },
    {
      "op": "omit",
      "target": "block-festal-dismissal"
    }
  ]
}

Mutation Operations

OperationUse
fillSupply content for a declared proper slot.
insertBefore / insertAfterAdd content adjacent to a stable target.
replaceSubstitute one target while retaining its position.
omitRemove a target from the resolved service.
moveRelocate an existing target without duplicating it.
wrapPlace a target inside additional structure.
setAttributeChange an allowed property without replacing the entity.

Use slot filling for ordinary calendar variation. Use structural mutations only when the service shape genuinely changes.

Apply Mutations Deterministically

Resolve active propers first, order them using calendar conflict rules, and then apply mutations in declared order. Every target must resolve to exactly one entity unless the operation explicitly supports multiple targets.

If one active proper omits a target and another attempts to insert relative to it, the profile or conflict rules must determine the winner. A processor must not use file load order to decide.

Mutation Operations

OperationUse
fillSupply content for a declared proper slot.
insertBefore / insertAfterAdd content adjacent to a stable target.
replaceSubstitute one target while retaining its position.
omitRemove a target from the resolved service.
moveRelocate an existing target without duplicating it.
wrapPlace a target inside additional structure.
setAttributeChange an allowed property without replacing the entity.

Use slot filling for ordinary calendar variation. Use structural mutations only when the service shape genuinely changes.

Apply Mutations Deterministically

Resolve active propers first, order them using calendar conflict rules, and then apply mutations in declared order. Every target must resolve to exactly one entity unless the operation explicitly supports multiple targets.

If one active proper omits a target and another attempts to insert relative to it, the profile or conflict rules must determine the winner. A processor must not use file load order to decide.

Schemas and supported values

Mutation operation

mutation.operation Definition ↗

Deterministic structural mutation operation. Values outside this closed list are invalid.

fillinsertBeforeinsertAfterreplaceomitmovewrapsetAttribute