Skip to main content

Chapter 26 — Constitutional Evolution Framework

Part II — Constitutional Change Modeling, Compatibility and Migration

Part II defines the machine-governable and human-reviewable mechanics through which ratified Core change is represented, compared, propagated, migrated and made operationally safe.

Part I established:

  • the Core-change boundary;
  • Constitutional Baselines;
  • Constitutional Change Proposals;
  • Change Classes;
  • Protected Invariants;
  • evolution authority;
  • deliberation;
  • impact analysis;
  • Amendment Packages;
  • ratification;
  • compiler and runtime integration;
  • emergency evolution;
  • historical provenance.

Part II governs the internal constitution of the change itself.

It defines:

  • Constitutional Change Sets;
  • Amendment Operations;
  • semantic mutation rules;
  • identity and Namespace evolution;
  • structural evolution;
  • behavioural and methodological evolution;
  • authority and security evolution;
  • Module and Component evolution;
  • Extension-Point evolution;
  • compatibility;
  • grandfathering;
  • transition profiles;
  • migration obligations;
  • transformation contracts;
  • dependency graphs;
  • impact propagation;
  • conformance testing;
  • historical change lineage.

The governing principles are:

Every Core change SHALL be represented as an explicit set of typed constitutional operations, not merely as edited prose, source-code differences or database migrations.

Identity, meaning, structure, behaviour, authority, applicability, lifecycle and historical interpretation SHALL be evaluated independently.

A change that preserves syntax but changes meaning is a breaking constitutional change. A change that alters implementation but preserves ratified meaning is not constitutional evolution.

Constitutional compatibility SHALL be declared across every affected plane: semantic, structural, behavioural, authority, security, runtime, Extension, Publication and historical.

Migration SHALL implement ratified change. Migration SHALL NOT invent, reinterpret or weaken ratified change.

Grandfathering SHALL be explicit, scoped, time-aware and historically reconstructable. Existing use alone SHALL not create an implied grandfathering right.

Every Core change SHALL preserve Module lineage and Component lineage, including where Modules are divided, merged, renamed, reassigned or retired.

The Part II change architecture is:

Ratified Constitutional Change Proposal


Constitutional Change Set

├── Baseline Preconditions
├── Typed Amendment Operations
├── Semantic Assertions
├── Structural Changes
├── Behavioural Changes
├── Authority Changes
├── Module and Component Changes
├── Extension-Point Changes
└── Effective-Time Rules


Constitutional Dependency Graph

├── Direct Dependencies
├── Transitive Dependencies
├── Reverse Dependencies
├── Runtime Dependencies
├── Extension Dependencies
├── Publication Dependencies
└── Historical Dependencies


Compatibility and Transition Model

├── Compatible
├── Conditionally Compatible
├── Grandfathered
├── Migration Required
├── Superseded
├── Invalidated
└── Indeterminate


Migration Obligations and Transformation Contracts


Compiler Projections, HECATE Validation and Conformance


Target Constitutional Baseline

Part II SHALL remain independent of any one diff format, patch language, ontology editor, schema registry, graph engine, source-control system, migration framework, policy language, workflow platform or deployment technology.


26.13. Constitutional Change Set Model

A Constitutional Change Set, abbreviated CCS, is the complete, typed and ordered representation of one ratified or ratification-candidate constitutional change.

A CCS SHALL describe constitutional effect independently from the textual or technical mechanism used to implement it.


26.13.1. Constitutional Change Set Identity

Every CCS SHALL possess:

  • Change Set Identifier;
  • Constitutional Change Proposal;
  • source Constitutional Baseline;
  • target Candidate Baseline;
  • Change Classes;
  • severity;
  • owner;
  • authority;
  • operation inventory;
  • dependency graph;
  • compatibility profile;
  • migration obligations;
  • effective-time model;
  • content digest;
  • lifecycle;
  • version;
  • provenance.

26.13.2. Change Set Types

Change Set Types MAY include:

  • Single-Artefact Change Set;
  • Multi-Artefact Change Set;
  • Coordinated Framework Change Set;
  • Security Change Set;
  • Authority Change Set;
  • Structural Change Set;
  • Behavioural Change Set;
  • Module-Reorganisation Change Set;
  • Extension-Point Change Set;
  • Corrective Change Set;
  • Emergency Change Set;
  • Foundational Change Set.

26.13.3. Change Set Boundary

The CCS boundary SHALL identify:

  • artefacts changed;
  • artefacts added;
  • artefacts removed;
  • artefacts superseded;
  • artefacts unaffected but dependency-relevant;
  • external sources;
  • affected Extensions;
  • affected Runtime Bundles;
  • affected Modules and Components;
  • affected Publications;
  • affected historical interpretations.

26.13.4. Change Set Preconditions

Every CCS SHALL define preconditions including:

  • expected source Baseline Identifier;
  • expected source Baseline digest;
  • required Amendment Package;
  • required authority;
  • required Protected-Invariant state;
  • required dependency versions;
  • required Extension state;
  • required effective-time context;
  • required migration readiness;
  • provenance.

A CCS SHALL NOT apply to an unexpected source baseline.


26.13.5. Change Set Postconditions

Postconditions SHALL define:

  • target constitutional state;
  • target Baseline Identifier;
  • resulting artefact versions;
  • resulting authority state;
  • resulting Extension-Point state;
  • resulting Module and Component state;
  • compatibility state;
  • migration state;
  • conformance state;
  • provenance.

26.13.6. Operation Inventory

The operation inventory SHALL identify every Amendment Operation by:

  • Operation Identifier;
  • operation type;
  • target artefact;
  • source state;
  • target state;
  • authority;
  • order;
  • dependencies;
  • reversibility;
  • effective time;
  • provenance.

26.13.7. Atomic Constitutional Operation

An Atomic Constitutional Operation is the smallest independently reviewable constitutional effect.

Atomicity SHALL be semantic, not textual.

A single line change MAY contain multiple Atomic Operations.

Multiple files MAY implement one Atomic Operation.


26.13.8. Composite Constitutional Operation

A Composite Operation groups Atomic Operations that SHALL be ratified, activated or rolled back as one constitutional unit.


26.13.9. Operation Ordering

Operation ordering SHALL be explicit where one operation depends on another.

Examples include:

  • create replacement identity before superseding prior identity;
  • create target Registry value before migrating references;
  • create new Module before reassigning Components;
  • create new Extension Point before migrating Extensions;
  • ratify authority before assigning new authority.

26.13.10. Operation Dependency

An operation dependency SHALL preserve:

  • dependent operation;
  • prerequisite operation;
  • dependency type;
  • failure effect;
  • rollback relationship;
  • provenance.

26.13.11. Operation Preconditions

Operation preconditions MAY include:

  • artefact exists;
  • artefact does not exist;
  • artefact version matches;
  • lifecycle state matches;
  • no conflicting authority exists;
  • no active non-migrated dependency exists;
  • tenant-isolation proof exists;
  • required migration mapping exists.

26.13.12. Operation Result Classes

Operation result classes MAY include:

  • Applied;
  • Applied with Conditions;
  • Deferred;
  • Skipped as Not Applicable;
  • Failed;
  • Blocked;
  • Rolled Back;
  • Indeterminate.

Indeterminate SHALL NOT be treated as Applied.


26.13.13. Change Set Transaction

A CCS MAY define:

  • fully atomic constitutional transition;
  • staged constitutional transition;
  • phased applicability;
  • jurisdictional transition;
  • tenant-cohort transition;
  • emergency temporary transition.

The transaction model SHALL be explicit.


26.13.14. Constitutional Atomicity

Constitutional atomicity means that the target baseline SHALL not be represented as coherent where only a subset of mandatory interdependent operations is effective.

It does not require every runtime migration to complete in one technical transaction.


26.13.15. Partial Application

Partial application MAY be permitted only where the CCS defines:

  • independently coherent phases;
  • authoritative state for each phase;
  • compatibility;
  • tenant routing;
  • Publication interpretation;
  • end condition;
  • provenance.

26.13.16. Change Set Idempotency

Reapplying a CCS to an already transformed baseline SHALL:

  • detect prior application;
  • avoid duplicate identities or authority;
  • return the existing result; or
  • fail safely.

26.13.17. Change Set Reversibility

Each CCS SHALL classify reversibility as:

  • mechanically reversible;
  • semantically reversible;
  • reversible with migration;
  • reversible only through Corrective Amendment;
  • irreversible;
  • unknown.

26.13.18. Change Set Conflict

A conflict exists where operations:

  • target the same artefact incompatibly;
  • require incompatible baselines;
  • create duplicate identities;
  • impose contradictory authority;
  • create incompatible effective times;
  • conflict with Protected Invariants;
  • conflict with another ratified CCS.

26.13.19. Change Set Merge

Two candidate Change Sets MAY be merged only where:

  • operation identities remain distinct;
  • baseline assumptions are reconciled;
  • semantic conflicts are resolved;
  • review evidence is updated;
  • impact analysis is updated;
  • candidate digest changes;
  • ratification is renewed.

26.13.20. Change Set Split

A CCS MAY be split where operations can form independently coherent amendments.

The split SHALL preserve:

  • source proposal;
  • operation lineage;
  • shared evidence;
  • dependency order;
  • separate ratification;
  • provenance.

26.13.21. Change Set Serialization

A CCS SHOULD support canonical serialization containing:

  • identities;
  • operation types;
  • source and target states;
  • order;
  • dependencies;
  • effective time;
  • digests;
  • provenance references.

Serialization SHALL not replace normative human-readable meaning.


26.13.22. Change Set Signature

A Change Set Signature SHALL bind:

  • CCS Identifier;
  • CCS digest;
  • Amendment Package;
  • source Baseline digest;
  • target Candidate Baseline digest;
  • signer;
  • signing authority;
  • time;
  • provenance.

26.13.23. Change Set Registry

The Change Set Registry SHALL preserve:

  • identifiers;
  • versions;
  • source and target baselines;
  • operations;
  • signatures;
  • ratification state;
  • application state;
  • supersession;
  • provenance.

26.13.24. Change Set Validation

HECATE SHALL validate:

  • CCS identity;
  • source and target baselines;
  • operation inventory;
  • preconditions;
  • postconditions;
  • dependencies;
  • ordering;
  • atomicity;
  • reversibility;
  • conflicts;
  • signatures;
  • provenance.

26.14. Amendment Operations and Semantic Mutation

An Amendment Operation defines one explicit constitutional effect on one or more Core artefacts.

The CEvF SHALL use typed operations to distinguish addition, modification, restriction, supersession, retirement and identity change.


26.14.1. Reference Amendment Operations

Amendment Operations SHALL include as applicable:

  • Add;
  • Define;
  • Clarify;
  • Correct;
  • Modify;
  • Restrict;
  • Expand;
  • Rename Display Label;
  • Reidentify;
  • Split;
  • Merge;
  • Map;
  • Reclassify;
  • Reassign;
  • Deprecate;
  • Supersede;
  • Retire;
  • Revoke;
  • Reinstate;
  • Grandfather;
  • Migrate;
  • Replace;
  • Remove from Active Use;
  • Correct Historical Interpretation;
  • Change Effective Time.

26.14.2. Add Operation

An Add Operation creates a new Core artefact.

It SHALL define:

  • new identity;
  • semantic definition;
  • authority;
  • lifecycle;
  • effective time;
  • relationships;
  • compatibility;
  • provenance.

26.14.3. Define Operation

A Define Operation establishes authoritative meaning for an existing reserved or previously undefined Core identity.

It SHALL not be used to conceal prior incompatible use.


26.14.4. Clarify Operation

A Clarify Operation SHALL preserve existing normative meaning.

It SHALL identify:

  • ambiguity addressed;
  • prior plausible interpretations;
  • intended existing interpretation;
  • evidence that obligations do not change;
  • historical treatment;
  • provenance.

Where obligations change, the operation SHALL be reclassified.


26.14.5. Correct Operation

A Correct Operation repairs constitutional text or semantics that are internally defective.

It SHALL identify:

  • defect;
  • intended meaning;
  • affected historical outcomes;
  • correction versus amendment distinction;
  • provenance.

26.14.6. Modify Operation

A Modify Operation changes one or more normative attributes of an existing artefact.

It SHALL identify each changed attribute independently.


26.14.7. Restrict Operation

A Restrict Operation narrows:

  • applicability;
  • permitted values;
  • authority;
  • access;
  • publication;
  • workflow;
  • Extension use;
  • runtime behaviour.

Existing state affected by the restriction SHALL be addressed.


26.14.8. Expand Operation

An Expand Operation broadens:

  • applicability;
  • permitted values;
  • authority;
  • capabilities;
  • Extension Points;
  • publication scope.

Expansion SHALL receive security and authority review.


26.14.9. Display Rename

A Display Rename changes labels or presentation while preserving canonical identity and semantics.

It SHALL preserve aliases and localisation history where material.


26.14.10. Reidentify Operation

A Reidentify Operation changes canonical identity.

It SHALL require:

  • old identity;
  • new identity;
  • reason;
  • mapping;
  • compatibility;
  • migration;
  • historical resolver behaviour;
  • Publication treatment;
  • provenance.

26.14.11. Split Operation

A Split Operation replaces one Core artefact with two or more distinct artefacts.

It SHALL preserve:

  • source identity;
  • target identities;
  • semantic partition;
  • allocation rule;
  • ambiguous instances;
  • historical interpretation;
  • migration;
  • provenance.

26.14.12. Merge Operation

A Merge Operation consolidates multiple Core artefacts into one.

It SHALL preserve:

  • source identities;
  • target identity;
  • conflict treatment;
  • information loss;
  • historical interpretation;
  • migration;
  • provenance.

26.14.13. Map Operation

A Map Operation creates an explicit relationship between source and target artefacts.

Mapping SHALL identify:

  • exact;
  • narrower;
  • broader;
  • conditional;
  • approximate;
  • lossy;
  • no safe mapping.

26.14.14. Reclassify Operation

A Reclassify Operation changes classification without necessarily changing identity.

It SHALL evaluate whether classification changes:

  • authority;
  • security;
  • lifecycle;
  • applicability;
  • publication;
  • conformance.

26.14.15. Reassign Operation

A Reassign Operation changes ownership, stewardship, Module membership, Component ownership or authority.

It SHALL preserve old and new assignments and effective time.


26.14.16. Deprecate Operation

A Deprecate Operation marks an artefact as disfavoured for future use while preserving historical validity according to policy.


26.14.17. Supersede Operation

A Supersede Operation establishes a replacement artefact or baseline.

It SHALL preserve source-target lineage.


26.14.18. Retire Operation

A Retire Operation ends normal active use while preserving historical identity and interpretation.


26.14.19. Revoke Operation

A Revoke Operation invalidates authority, approval, certificate, key, Extension Point or other revocable constitutional state.

It SHALL identify the affected period and consequences.


26.14.20. Reinstate Operation

A Reinstate Operation restores eligibility or authority after suspension or revocation where constitutionally permitted.

It SHALL not erase the prior suspension or revocation.


26.14.21. Grandfather Operation

A Grandfather Operation permits defined existing state to continue under prior or transitional rules.

It SHALL identify:

  • eligible population;
  • preserved rights or validity;
  • prohibited new creation;
  • transition deadline;
  • review;
  • exit;
  • provenance.

26.14.22. Migrate Operation

A Migrate Operation defines movement from source constitutional state to target constitutional state.

It SHALL reference a Migration Obligation and Transformation Contract.


26.14.23. Replace Operation

A Replace Operation combines supersession, mapping and migration requirements.

It SHALL not imply exact equivalence.


26.14.24. Remove from Active Use

This operation prohibits future authoritative use without deleting historical identity.


26.14.25. Historical-Interpretation Correction

A Historical-Interpretation Correction SHALL be used only where an authoritative clarification determines that prior interpretation was erroneous.

It SHALL identify:

  • affected periods;
  • affected outcomes;
  • legal and assurance implications;
  • Publication treatment;
  • provenance.

Historical records SHALL not be rewritten silently.


26.14.26. Effective-Time Change

An Effective-Time Change modifies:

  • start;
  • end;
  • transition;
  • sunset;
  • grandfathering;
  • enforcement.

Retroactive effective time SHALL require heightened authority and impact analysis.


26.14.27. Semantic Mutation Matrix

Every operation SHALL state its effect on:

  • identity;
  • meaning;
  • structure;
  • behaviour;
  • authority;
  • applicability;
  • lifecycle;
  • compatibility;
  • historical interpretation.

26.14.28. Prohibited Mutation

Prohibited mutation includes:

  • reusing identity for incompatible meaning;
  • deleting historical lineage;
  • changing Core through unratified implementation;
  • weakening tenant isolation without authority;
  • converting derived intelligence into Core truth silently;
  • changing Module or Component lineage without migration;
  • editing ratified baseline content in place.

26.14.29. Operation Explanation

Every material operation SHALL provide a human-readable explanation and machine-readable effect.


26.14.30. Operation Validation

HECATE SHALL validate:

  • operation type;
  • target;
  • source state;
  • target state;
  • semantic effect;
  • identity treatment;
  • effective time;
  • compatibility;
  • migration;
  • prohibited mutations;
  • provenance.

26.15. Core Identity, Namespace and Reference Evolution

Core identity evolution SHALL preserve uniqueness, resolvability, historical continuity and non-ambiguity.

A constitutional identity SHALL not be treated as a mutable display string.


26.15.1. Core Identity Object

Every Core identity SHALL preserve:

  • canonical identifier;
  • semantic identifier;
  • artefact type;
  • Namespace;
  • canonical name;
  • lifecycle;
  • version lineage;
  • aliases;
  • mappings;
  • effective time;
  • provenance.

26.15.2. Identity Change Classes

Identity changes MAY include:

  • display-name change;
  • alias addition;
  • alias withdrawal;
  • canonical-name change;
  • canonical-identifier change;
  • semantic-identifier change;
  • Namespace reassignment;
  • identity split;
  • identity merge;
  • identity supersession;
  • identity retirement.

26.15.3. Display Name Change

A display-name change SHALL preserve canonical identity.

It SHOULD preserve prior labels as aliases where discoverability or historical interpretation requires.


26.15.4. Canonical Name Change

A canonical-name change SHALL identify whether meaning changes.

Where meaning does not change, identity SHALL remain stable.


26.15.5. Canonical Identifier Change

A canonical-identifier change SHALL be rare.

It SHALL require:

  • new identifier;
  • old identifier mapping;
  • resolver support;
  • migration;
  • API treatment;
  • graph treatment;
  • event treatment;
  • Publication treatment;
  • archive treatment;
  • provenance.

26.15.6. Semantic Identifier Change

A Semantic Identifier SHALL change where semantic meaning becomes incompatible with prior meaning.

The old Semantic Identifier SHALL remain historically resolvable.


26.15.7. Core Namespace Evolution

Core Namespace evolution MAY include:

  • Namespace addition;
  • Namespace consolidation;
  • Namespace partition;
  • Namespace renaming;
  • Namespace retirement;
  • delegation change.

It SHALL preserve ownership, authority and collision avoidance.


26.15.8. Namespace Reassignment

Namespace reassignment SHALL preserve:

  • prior Namespace;
  • target Namespace;
  • identity mapping;
  • authority;
  • effective time;
  • affected references;
  • migration;
  • provenance.

26.15.9. Identity Alias

An alias SHALL identify:

  • canonical identity;
  • alias;
  • language;
  • context;
  • valid period;
  • ambiguity;
  • deprecation;
  • provenance.

An alias SHALL not create duplicate Core identity.


26.15.10. Identifier Resolver Evolution

Resolver change SHALL preserve:

  • supported identifiers;
  • version-aware resolution;
  • historical resolution;
  • tenant and white-label context;
  • redirect or mapping;
  • error treatment;
  • provenance.

26.15.11. Reference Integrity

Every changed identity SHALL support impact analysis over:

  • documents;
  • schemas;
  • graph nodes;
  • graph edges;
  • policies;
  • workflows;
  • events;
  • agents;
  • tools;
  • Components;
  • Extensions;
  • APIs;
  • Publications;
  • archives.

26.15.12. Identity Split

Identity split SHALL define:

  • source identity;
  • target identities;
  • partition criteria;
  • unresolved references;
  • ambiguous historical instances;
  • migration;
  • resolver behaviour;
  • provenance.

26.15.13. Identity Merge

Identity merge SHALL define:

  • source identities;
  • surviving identity;
  • source precedence;
  • semantic reconciliation;
  • conflicting properties;
  • relationship treatment;
  • aliases;
  • migration;
  • provenance.

26.15.14. Identity Supersession

Supersession SHALL preserve:

  • superseded identity;
  • successor identity;
  • equivalence limits;
  • effective time;
  • historical resolution;
  • provenance.

26.15.15. Retired Identity

A retired identity SHALL remain:

  • unique;
  • historically resolvable;
  • unavailable for incompatible reuse;
  • linked to replacement where applicable;
  • preserved in archives.

26.15.16. External Identifier Mapping

External mappings SHALL be reassessed when Core identity changes.

The mapping SHALL preserve:

  • external authority;
  • mapping type;
  • version;
  • conditions;
  • information loss;
  • provenance.

26.15.17. API Reference Evolution

API references SHALL support:

  • versioned identifiers;
  • aliases where permitted;
  • deprecation notices;
  • canonical response identity;
  • unknown-identifier treatment;
  • historical resolution.

26.15.18. Event Reference Evolution

Event payloads containing changed identities SHALL preserve:

  • original identifier;
  • event schema version;
  • resolver version;
  • target identifier where migrated;
  • provenance.

26.15.19. Publication Reference Evolution

Published identifiers SHALL not be silently changed.

Corrections, redirects, resolver updates or new Publications SHALL comply with the CPF.


26.15.20. Identity Collision

A collision SHALL block baseline release until resolved.


26.15.21. Identity Migration Receipt

A receipt SHOULD contain:

  • source identity;
  • target identity;
  • operation;
  • mapping;
  • affected references;
  • unresolved references;
  • effective time;
  • authority;
  • provenance.

26.15.22. Identity Validation

HECATE SHALL validate:

  • identifier uniqueness;
  • Namespace;
  • identity operation;
  • aliases;
  • mappings;
  • resolver behaviour;
  • reference integrity;
  • collision;
  • historical preservation;
  • provenance.

26.16. Structural Constitutional Evolution

Structural Constitutional Evolution changes Core object models, properties, datatypes, units, Value Providers, Registries, Relationship Types, graph constraints, mappings or validation.

Structural change SHALL preserve semantic meaning explicitly and SHALL not be reduced to database migration.


26.16.1. Structural Change Object

Every material Structural Change SHALL possess:

  • Structural Change Identifier;
  • CCS;
  • target artefacts;
  • source structure;
  • target structure;
  • semantic rationale;
  • compatibility;
  • migration;
  • validation;
  • effective time;
  • provenance.

26.16.2. Structural Evolution Types

Types MAY include:

  • Object Type addition;
  • Object Type specialisation;
  • Object Type split;
  • Object Type merge;
  • property addition;
  • property modification;
  • property retirement;
  • datatype change;
  • unit change;
  • cardinality change;
  • null-semantics change;
  • Registry change;
  • Value Provider change;
  • Relationship Type change;
  • graph-constraint change;
  • validation-rule change;
  • mapping change.

26.16.3. Object Type Addition

A new Core Object Type SHALL define:

  • identity;
  • semantics;
  • lifecycle;
  • properties;
  • relationships;
  • authority;
  • Extension Points;
  • tenant semantics;
  • publication semantics;
  • provenance.

26.16.4. Object Type Split

A split SHALL address:

  • instance classification;
  • ambiguous instances;
  • shared properties;
  • distinct properties;
  • relationships;
  • workflows;
  • Publications;
  • historical identity;
  • migration.

26.16.5. Object Type Merge

A merge SHALL address:

  • conflicting semantics;
  • duplicate properties;
  • conflicting relationships;
  • lifecycle differences;
  • authority differences;
  • Publication differences;
  • historical interpretation.

26.16.6. Property Addition

A required Core property SHALL not become enforceable until:

  • applicability is explicit;
  • migration exists;
  • grandfathering is defined where applicable;
  • validation is available;
  • Publication impact is assessed;
  • effective time is defined.

26.16.7. Property Semantic Change

Changing property meaning SHALL require:

  • Semantic Identifier evaluation;
  • source and target definition;
  • historical interpretation;
  • data migration;
  • computation impact;
  • Publication impact;
  • provenance.

26.16.8. Datatype Change

Datatype evolution SHALL evaluate:

  • lexical space;
  • value space;
  • precision;
  • scale;
  • ordering;
  • serialization;
  • null semantics;
  • conversion;
  • historical data;
  • API compatibility.

26.16.9. Unit Change

Unit evolution SHALL preserve:

  • quantity kind;
  • dimensions;
  • conversion;
  • context;
  • precision;
  • uncertainty;
  • original values;
  • Publication comparability.

A non-convertible unit change SHALL be breaking.


26.16.10. Cardinality Change

Increasing minimum cardinality or decreasing maximum cardinality SHALL evaluate existing conformant instances and migration.


26.16.11. Null-Semantics Change

Null-semantics evolution SHALL distinguish:

  • absent;
  • unknown;
  • unavailable;
  • not applicable;
  • withheld;
  • confidential;
  • estimated;
  • zero;
  • invalid.

A physical null migration SHALL not collapse semantic states.


26.16.12. Default Change

A default change SHALL identify:

  • old default;
  • new default;
  • persisted versus resolved treatment;
  • historical instances;
  • evidence implications;
  • computation impact;
  • Publication impact.

26.16.13. Registry Evolution

Registry evolution MAY include:

  • entry addition;
  • entry correction;
  • hierarchy change;
  • merge;
  • split;
  • alias;
  • mapping;
  • deprecation;
  • retirement;
  • authority change.

26.16.14. Value Provider Evolution

A Value Provider change SHALL evaluate:

  • provider identity;
  • value identities;
  • code stability;
  • hierarchy;
  • mappings;
  • localisation;
  • tenant Extensions;
  • API and Publication effects.

26.16.15. Relationship Type Evolution

Relationship evolution SHALL evaluate:

  • identity;
  • source and target types;
  • direction;
  • inverse;
  • cardinality;
  • properties;
  • authority;
  • evidence;
  • temporal semantics;
  • inference;
  • tenant boundaries.

26.16.16. Endpoint Change

Changing permitted endpoints SHALL identify:

  • newly valid relationships;
  • newly invalid relationships;
  • migration;
  • inference effect;
  • graph-security effect;
  • historical graph interpretation.

26.16.17. Graph Constraint Evolution

Graph-constraint change SHALL evaluate:

  • node shapes;
  • relationship shapes;
  • paths;
  • cycles;
  • uniqueness;
  • temporal overlap;
  • authority;
  • tenant isolation;
  • inference.

26.16.18. Inference Rule Evolution

An inference change SHALL preserve:

  • prior rule;
  • target rule;
  • premises;
  • conclusion;
  • confidence;
  • contradiction;
  • retraction;
  • affected Derived Assertions;
  • Publication effect.

26.16.19. Validation Rule Evolution

Validation evolution SHALL identify:

  • affected targets;
  • severity;
  • override policy;
  • effective time;
  • historical results;
  • grandfathering;
  • migration;
  • provenance.

26.16.20. Open-to-Closed Schema Change

Closing a previously open schema SHALL address:

  • existing Extension properties;
  • tenant properties;
  • unknown data;
  • quarantine;
  • migration;
  • Extension-Point impact.

26.16.21. Closed-to-Open Schema Change

Opening a schema SHALL define:

  • permitted Namespaces;
  • Extension Points;
  • validation;
  • security;
  • publication treatment;
  • tenant isolation.

26.16.22. Structural Compatibility

Structural compatibility SHALL be evaluated independently for:

  • reading old data;
  • writing old data;
  • reading new data;
  • writing new data;
  • validating historical data;
  • replaying historical events;
  • publishing comparable outcomes.

26.16.23. Structural Migration Contract

Every breaking Structural Change SHALL reference a governed Structural Migration Contract.


26.16.24. Structural Compiler Projection

The Constitutional Compiler SHOULD produce:

  • target schemas;
  • validators;
  • graph shapes;
  • Registry artefacts;
  • mappings;
  • migration artefacts;
  • API contracts;
  • event schemas;
  • conformance fixtures.

26.16.25. Structural Validation

HECATE SHALL validate:

  • source and target structure;
  • semantics;
  • identity;
  • compatibility;
  • Extension impact;
  • migration;
  • grandfathering;
  • historical interpretation;
  • provenance.

26.17. Behavioural and Methodological Constitutional Evolution

Behavioural Constitutional Evolution changes how Core policies, decisions, calculations, methodologies, workflows, events, agents, tools or runtime capabilities are defined.

A behavioural change SHALL be governed by its constitutional effect, not by whether the implementation appears technically small.


26.17.1. Behavioural Change Object

Every material Behavioural Change SHALL possess:

  • Behavioural Change Identifier;
  • CCS;
  • target behaviours;
  • source behaviour;
  • target behaviour;
  • owner;
  • authority;
  • affected Modules;
  • affected Components;
  • input changes;
  • output changes;
  • side-effect changes;
  • compatibility;
  • migration;
  • validation;
  • effective time;
  • provenance.

26.17.2. Behavioural Evolution Types

Types MAY include:

  • Policy Evolution;
  • Decision Evolution;
  • Reasoning Evolution;
  • Computation Evolution;
  • Methodology Evolution;
  • Workflow Evolution;
  • Task Evolution;
  • Gate Evolution;
  • Event Evolution;
  • Command Evolution;
  • Agent Evolution;
  • Model Evolution;
  • Tool Evolution;
  • Integration Behaviour Evolution;
  • Runtime Profile Evolution.

26.17.3. Policy Evolution

Policy evolution SHALL identify changes to:

  • applicability;
  • subject;
  • effect;
  • obligation;
  • permission;
  • prohibition;
  • exception;
  • precedence;
  • override;
  • evidence;
  • explanation;
  • effective time.

26.17.4. Permit-to-Deny Change

A policy change from Permit to Deny, or from optional to mandatory control, SHALL be classified as Restrictive and potentially breaking.

It SHALL evaluate:

  • active workflows;
  • existing approvals;
  • tenant operations;
  • agent permissions;
  • Publication processes;
  • grandfathering;
  • migration;
  • notice.

26.17.5. Deny-to-Permit Change

A policy change from Deny to Permit SHALL receive heightened security, authority, privacy and tenant-isolation review.


26.17.6. Policy Precedence Change

A precedence change SHALL identify:

  • source combining algorithm;
  • target combining algorithm;
  • affected conflicts;
  • changed outcomes;
  • affected tenants;
  • historical decisions;
  • provenance.

26.17.7. Decision Evolution

Decision evolution SHALL preserve:

  • Decision Logic identity;
  • input contract;
  • criteria;
  • thresholds;
  • weights;
  • outcome classes;
  • uncertainty;
  • override;
  • explanation;
  • replay.

26.17.8. Threshold Change

A threshold change SHALL identify:

  • prior threshold;
  • target threshold;
  • basis;
  • affected population;
  • false-positive and false-negative effect;
  • historical comparability;
  • transition treatment;
  • provenance.

26.17.9. Decision Outcome Change

Adding, removing or redefining an outcome class SHALL evaluate:

  • workflow routing;
  • approval;
  • event contracts;
  • Publication eligibility;
  • historical decisions;
  • Extension mappings;
  • migration.

26.17.10. Reasoning Evolution

Reasoning evolution SHALL identify changes to:

  • premises;
  • assumptions;
  • open-world or closed-world treatment;
  • inference steps;
  • contradiction;
  • confidence;
  • conclusion;
  • stopping condition;
  • human review.

26.17.11. Computation Evolution

Computation evolution SHALL preserve:

  • computation identity;
  • formula or algorithm;
  • variables;
  • units;
  • boundaries;
  • factors;
  • assumptions;
  • allocation;
  • precision;
  • uncertainty;
  • output semantics;
  • replay.

26.17.12. Formula Change

A formula change SHALL identify:

  • prior formula;
  • target formula;
  • changed variables;
  • changed operators;
  • changed units;
  • changed rounding;
  • expected output difference;
  • historical comparability;
  • provenance.

26.17.13. Methodology Evolution

Methodology evolution SHALL identify:

  • source methodology;
  • target methodology;
  • authority;
  • boundary;
  • steps;
  • exclusions;
  • factors;
  • allocation;
  • uncertainty;
  • assurance treatment;
  • Publication treatment;
  • migration.

26.17.14. Factor Evolution

A Core factor change SHALL preserve:

  • factor identity;
  • source;
  • geography;
  • period;
  • unit;
  • methodology;
  • uncertainty;
  • licence;
  • prior factor;
  • recalculation obligations;
  • provenance.

26.17.15. Allocation Evolution

An allocation change SHALL evaluate:

  • allocation subject;
  • basis;
  • denominator;
  • double-counting;
  • residuals;
  • rounding;
  • affected outputs;
  • historical comparability;
  • Publication impact.

26.17.16. Scenario Evolution

Scenario evolution SHALL preserve:

  • Scenario identity;
  • assumptions;
  • time horizon;
  • pathways;
  • weighting;
  • model;
  • dependencies;
  • limitations;
  • prior scenario comparability.

26.17.17. Stochastic Model Evolution

Monte Carlo, Bayesian or other stochastic model change SHALL preserve:

  • model identity;
  • parameter changes;
  • distributions;
  • correlations;
  • priors;
  • likelihoods;
  • seed policy;
  • calibration;
  • convergence;
  • uncertainty;
  • replay limitations.

26.17.18. Workflow Evolution

Workflow evolution SHALL identify changes to:

  • Workflow identity;
  • states;
  • transitions;
  • Tasks;
  • Gates;
  • Roles;
  • authority;
  • timers;
  • retries;
  • compensation;
  • side effects;
  • completion;
  • replay.

26.17.19. Running Workflow Treatment

Every breaking Workflow Change SHALL define treatment for running instances:

  • remain on prior definition;
  • migrate to target definition;
  • complete current state then migrate;
  • suspend for review;
  • terminate with compensation;
  • restart under target definition.

26.17.20. Gate Evolution

A Gate change SHALL identify:

  • prior condition;
  • target condition;
  • evidence;
  • approval;
  • assurance;
  • override;
  • outcome;
  • affected in-flight instances;
  • provenance.

26.17.21. Event Evolution

Event evolution SHALL preserve:

  • Event Type identity;
  • payload semantics;
  • producer;
  • consumers;
  • event time;
  • ordering;
  • delivery;
  • correlation;
  • causation;
  • replay;
  • compatibility.

26.17.22. Event Semantic Change

An Event Type SHALL receive a new semantic version or identity where the meaning of occurrence changes.

Payload compatibility SHALL not prove event-semantic compatibility.


26.17.23. Command Evolution

Command evolution SHALL preserve:

  • Command Type;
  • issuer authority;
  • target capability;
  • input contract;
  • preconditions;
  • idempotency;
  • side effects;
  • result;
  • cancellation;
  • provenance.

26.17.24. Agent Evolution

Agent evolution SHALL identify changes to:

  • Agent Profile;
  • purpose;
  • autonomy;
  • authority;
  • model;
  • prompts or instructions;
  • tools;
  • retrieval;
  • memory;
  • oversight;
  • evaluation;
  • side effects;
  • tenant isolation.

26.17.25. Prompt Evolution

A material prompt or instruction change SHALL be treated as behavioural evolution where it changes:

  • interpretation;
  • decisioning;
  • tool use;
  • refusal;
  • evidence use;
  • output format;
  • side-effect likelihood;
  • escalation.

26.17.26. Model Evolution

Model evolution SHALL address:

  • model identity;
  • provider;
  • version;
  • capability;
  • data handling;
  • evaluation;
  • drift;
  • output compatibility;
  • explainability;
  • replay;
  • fallback.

26.17.27. Tool Evolution

Tool evolution SHALL identify changes to:

  • capability;
  • input schema;
  • output schema;
  • authority;
  • side effects;
  • idempotency;
  • security;
  • tenant scope;
  • rollback or compensation.

26.17.28. Integration Behaviour Evolution

Integration evolution SHALL preserve:

  • Integration Contract;
  • Connector;
  • mappings;
  • trust;
  • credentials;
  • tenant routing;
  • delivery;
  • retries;
  • reconciliation;
  • external-system assumptions;
  • provenance.

26.17.29. Behavioural Compatibility

Behavioural compatibility SHALL evaluate:

  • equivalent input treatment;
  • equivalent output meaning;
  • policy outcomes;
  • decision outcomes;
  • side effects;
  • workflow state;
  • event semantics;
  • agent behaviour;
  • tool authority;
  • historical replay.

26.17.30. Behavioural Grandfathering

Grandfathering MAY preserve:

  • existing decisions;
  • running workflows;
  • existing approvals;
  • prior methodology for closed reporting periods;
  • prior agent outputs;
  • prior event streams.

It SHALL not authorise new use outside the grandfathered population.


26.17.31. Behavioural Migration Contract

Every breaking Behavioural Change SHALL reference a governed Behavioural Migration Contract.


26.17.32. Behavioural Compiler Projection

The Constitutional Compiler SHOULD produce:

  • policy artefacts;
  • decision tables;
  • computation plans;
  • methodology profiles;
  • workflow definitions;
  • event and command schemas;
  • Agent Profiles;
  • model profiles;
  • tool contracts;
  • integration contracts;
  • conformance fixtures.

26.17.33. Behavioural Validation

HECATE SHALL validate:

  • source and target behaviour;
  • identity;
  • authority;
  • side effects;
  • compatibility;
  • running-instance treatment;
  • migration;
  • grandfathering;
  • replay;
  • provenance.

26.18. Authority, Governance, Security and Publication Evolution

Changes to authority, governance, security or publication controls can alter who may act, what may be disclosed and which outcomes become constitutionally valid.

These changes SHALL receive heightened review.


26.18.1. Authority Change Object

Every material Authority Change SHALL possess:

  • Authority Change Identifier;
  • CCS;
  • source authority state;
  • target authority state;
  • affected Roles;
  • affected subjects;
  • affected scopes;
  • delegation effect;
  • separation-of-duties effect;
  • security effect;
  • effective time;
  • migration;
  • provenance.

26.18.2. Authority Evolution Types

Types MAY include:

  • Role addition;
  • Role modification;
  • Role retirement;
  • assignment change;
  • delegation change;
  • quorum change;
  • threshold change;
  • veto change;
  • reserved-authority change;
  • override change;
  • emergency-authority change;
  • ratification-authority change;
  • activation-authority change;
  • Publication-authority change.

26.18.3. Role Addition

A new Core Role SHALL define:

  • Role identity;
  • semantic purpose;
  • permitted actions;
  • prohibited actions;
  • subject scope;
  • tenant scope;
  • independence;
  • delegation;
  • lifecycle;
  • provenance.

26.18.4. Role Modification

A Role modification SHALL identify whether it expands or restricts authority.

Expansion SHALL receive heightened review.


26.18.5. Assignment Evolution

Assignment change SHALL preserve:

  • prior holder;
  • target holder;
  • Role;
  • scope;
  • effective time;
  • delegation;
  • revocation;
  • affected pending decisions;
  • provenance.

26.18.6. Quorum Evolution

A quorum change SHALL evaluate:

  • eligible members;
  • minimum participation;
  • domain representation;
  • abstention;
  • recusal;
  • emergency treatment;
  • historical decisions;
  • concentration of authority.

26.18.7. Threshold Evolution

A threshold change SHALL identify:

  • prior threshold;
  • target threshold;
  • Change Classes affected;
  • rationale;
  • minority protection;
  • emergency implications;
  • provenance.

Lowering a threshold for foundational or security-sensitive change SHALL receive the highest applicable review.


26.18.8. Separation-of-Duties Evolution

A change SHALL evaluate whether one actor or Component may newly combine:

  • proposal and approval;
  • authorship and ratification;
  • validation and approval;
  • signing and activation;
  • execution and audit;
  • agent creation and agent approval.

26.18.9. Delegation Evolution

Delegation change SHALL preserve:

  • delegator;
  • delegate;
  • scope;
  • redelegation;
  • duration;
  • revocation;
  • independence;
  • provenance.

26.18.10. Override Evolution

Override evolution SHALL define:

  • overrideable controls;
  • non-overrideable controls;
  • authority;
  • evidence;
  • time;
  • compensating controls;
  • audit;
  • provenance.

26.18.11. Emergency Authority Evolution

Emergency-authority change SHALL define:

  • eligible triggers;
  • actors;
  • maximum scope;
  • maximum duration;
  • preserved invariants;
  • retrospective review;
  • automatic expiration;
  • provenance.

26.18.12. Security Change Object

Every material Security Change SHALL possess:

  • Security Change Identifier;
  • threat or obligation;
  • source and target controls;
  • trust boundaries;
  • identities;
  • credentials;
  • data classes;
  • tenant implications;
  • runtime implications;
  • Publication implications;
  • migration;
  • provenance.

26.18.13. Security Evolution Types

Types MAY include:

  • identity-assurance change;
  • authentication change;
  • authorisation change;
  • key-governance change;
  • encryption change;
  • network-boundary change;
  • tenant-partition change;
  • graph-access change;
  • event-trust change;
  • agent-sandbox change;
  • archive-access change;
  • supply-chain control change.

26.18.14. Tenant-Isolation Evolution

Tenant-isolation change SHALL evaluate every relevant representation:

  • relational data;
  • object storage;
  • graph;
  • cache;
  • search;
  • vector;
  • event;
  • workflow;
  • agent memory;
  • model context;
  • logs;
  • backup;
  • archive;
  • Publication.

26.18.15. Shared-Service Evolution

A change introducing shared services SHALL define:

  • tenant context propagation;
  • data partitioning;
  • authority;
  • resource fairness;
  • failure isolation;
  • cache isolation;
  • observability isolation;
  • incident containment;
  • provenance.

26.18.16. Key and Signature Evolution

Key-governance change SHALL preserve:

  • old keys;
  • new keys;
  • overlap period;
  • permitted signing classes;
  • revocation;
  • trust roots;
  • historical signature verification;
  • provenance.

26.18.17. Privacy Evolution

Privacy evolution SHALL identify changes to:

  • purpose;
  • lawful basis where applicable;
  • minimisation;
  • consent;
  • rights;
  • retention;
  • residency;
  • cross-border transfer;
  • Publication;
  • audit access.

26.18.18. Publication Change Object

Every material Publication Change SHALL possess:

  • Publication Change Identifier;
  • affected CPF artefacts;
  • source publication state;
  • target publication state;
  • authority;
  • audience;
  • disclosure;
  • assurance;
  • correction;
  • retention;
  • compatibility;
  • migration;
  • provenance.

26.18.19. Publication Eligibility Evolution

A change SHALL identify which outcomes become:

  • newly eligible;
  • newly conditional;
  • newly restricted;
  • newly ineligible;
  • newly indeterminate.

26.18.20. Disclosure Evolution

Disclosure change SHALL evaluate:

  • audience;
  • confidentiality;
  • aggregation;
  • redaction;
  • embargo;
  • public API;
  • public dataset;
  • public passport;
  • historical Publications.

26.18.21. Assurance Label Evolution

An assurance-label change SHALL preserve:

  • assurance provider;
  • level;
  • scope;
  • criteria;
  • validity;
  • prior labels;
  • affected Publications;
  • provenance.

26.18.22. Correction and Restatement Evolution

A change to correction or restatement rules SHALL identify:

  • triggering conditions;
  • materiality;
  • prior-period treatment;
  • recipient notification;
  • regulator treatment;
  • archive treatment;
  • historical verification.

26.18.23. Publication Compatibility

Publication compatibility SHALL evaluate:

  • semantic comparability;
  • units;
  • boundaries;
  • methodology;
  • assurance;
  • audience;
  • machine formats;
  • public identifiers;
  • correction obligations.

26.18.24. Governance Migration

Authority and governance migration SHALL address:

  • active assignments;
  • pending approvals;
  • pending ratifications;
  • open workflows;
  • delegated authority;
  • signing keys;
  • audit access;
  • effective time.

26.18.25. Security Migration

Security migration SHALL address:

  • identities;
  • credentials;
  • encryption;
  • keys;
  • network controls;
  • tenant partitions;
  • policy caches;
  • agents;
  • Connectors;
  • archives;
  • rollback.

26.18.26. Publication Migration

Publication migration SHALL address:

  • active preparation workflows;
  • unreleased Packages;
  • released Publications;
  • public projections;
  • APIs;
  • datasets;
  • correction or restatement;
  • assurance;
  • archive.

26.18.27. Authority and Security Compiler Projection

The Constitutional Compiler SHOULD produce:

  • Role definitions;
  • authority policies;
  • quorum rules;
  • threshold rules;
  • security policies;
  • tenant-isolation profiles;
  • key profiles;
  • Publication Profiles;
  • conformance fixtures.

26.18.28. Authority, Security and Publication Validation

HECATE SHALL validate:

  • source and target authority;
  • separation of duties;
  • quorum and thresholds;
  • tenant isolation;
  • security controls;
  • Publication eligibility;
  • assurance;
  • migration;
  • historical treatment;
  • provenance.

26.19. Module, Component and Runtime Contract Evolution

Modules are top-level ZAYAZ platform domains.

Components are engines, micro-engines, Registries, agents, services, workflows, validators and supporting systems that belong to Modules.

Evolution SHALL preserve this ontology.


26.19.1. Module Change Object

Every material Module Change SHALL possess:

  • Module Change Identifier;
  • source Module state;
  • target Module state;
  • affected capabilities;
  • affected Components;
  • affected Constitutional Objects;
  • affected events and commands;
  • affected policies and workflows;
  • affected Integration Contracts;
  • owner;
  • authority;
  • compatibility;
  • migration;
  • provenance.

26.19.2. Module Evolution Types

Types MAY include:

  • Module addition;
  • Module rename;
  • Module responsibility change;
  • Module split;
  • Module merge;
  • Module ownership change;
  • Module deprecation;
  • Module retirement;
  • capability reassignment.

26.19.3. Module Addition

A new Module SHALL define:

  • Module identity;
  • domain responsibility;
  • capabilities;
  • owned Constitutional Objects;
  • owned policies;
  • owned events and commands;
  • Components;
  • external contracts;
  • security;
  • reliability;
  • provenance.

26.19.4. Module Rename

A display rename SHALL preserve Module identity.

A semantic responsibility change MAY require a new Module identity or version.


26.19.5. Module Split

A Module split SHALL preserve:

  • source Module;
  • target Modules;
  • capability allocation;
  • Component allocation;
  • data ownership;
  • event ownership;
  • policy ownership;
  • workflow ownership;
  • contracts;
  • migration;
  • historical lineage.

26.19.6. Module Merge

A Module merge SHALL address:

  • overlapping capabilities;
  • duplicate Components;
  • authority;
  • data ownership;
  • event ownership;
  • workflow ownership;
  • contract consolidation;
  • tenant impact;
  • provenance.

26.19.7. Capability Reassignment

Capability reassignment SHALL preserve:

  • source Module;
  • target Module;
  • capability;
  • source Components;
  • target Components;
  • authority;
  • contracts;
  • events;
  • migration;
  • provenance.

26.19.8. Component Change Object

Every material Component Change SHALL possess:

  • Component Change Identifier;
  • Component identity;
  • source Module;
  • target Module;
  • source capability;
  • target capability;
  • source contract;
  • target contract;
  • authority;
  • state;
  • security;
  • reliability;
  • deployment;
  • compatibility;
  • migration;
  • provenance.

26.19.9. Component Evolution Types

Types MAY include:

  • Component addition;
  • Component replacement;
  • Component split;
  • Component merge;
  • Component reassignment;
  • Component contract change;
  • Component authority change;
  • Component state-model change;
  • Component deprecation;
  • Component retirement.

26.19.10. Orphan Component Prohibition

A Component SHALL NOT exist without an explicit owning Module.

A transition SHALL not create an unowned intermediate state.


26.19.11. Component Reassignment

Reassignment SHALL identify:

  • prior Module;
  • target Module;
  • effective time;
  • capability ownership;
  • contracts;
  • data access;
  • event subscriptions;
  • operational ownership;
  • Pergamum Pulse lineage;
  • provenance.

26.19.12. Component Replacement

Replacement SHALL evaluate:

  • semantic capability;
  • input and output contracts;
  • authority;
  • side effects;
  • state;
  • security;
  • reliability;
  • replay;
  • tenant isolation;
  • migration.

26.19.13. Component Split

A Component split SHALL define:

  • source Component;
  • target Components;
  • capability partition;
  • state partition;
  • contract partition;
  • event routing;
  • tenant routing;
  • operational ownership;
  • provenance.

26.19.14. Component Merge

A Component merge SHALL define:

  • source Components;
  • target Component;
  • capability reconciliation;
  • authority;
  • state migration;
  • contract consolidation;
  • deployment;
  • provenance.

26.19.15. Runtime Contract Evolution

Runtime Contract change SHALL identify:

  • contract identity;
  • source and target versions;
  • request and response semantics;
  • events;
  • commands;
  • errors;
  • timeouts;
  • retries;
  • idempotency;
  • transaction boundary;
  • tenant behaviour;
  • compatibility.

26.19.16. API Contract Evolution

API evolution SHALL preserve:

  • endpoint identity;
  • methods;
  • request schemas;
  • response schemas;
  • error semantics;
  • versioning;
  • deprecation;
  • tenant routing;
  • security;
  • historical clients.

26.19.17. Event Contract Evolution

Event-contract evolution SHALL preserve:

  • producer;
  • consumers;
  • schema;
  • semantic meaning;
  • ordering;
  • replay;
  • upcasting or downcasting;
  • migration.

26.19.18. Workflow Contract Evolution

A workflow service contract SHALL preserve:

  • start;
  • transition;
  • assignment;
  • completion;
  • cancellation;
  • migration;
  • eventing;
  • side effects;
  • replay.

26.19.19. Agent Contract Evolution

An Agent Contract SHALL preserve:

  • task;
  • input;
  • output;
  • tools;
  • model;
  • authority;
  • oversight;
  • evaluation;
  • side effects;
  • tenant isolation.

26.19.20. Data Ownership Evolution

Changing data ownership SHALL identify:

  • source owner;
  • target owner;
  • authoritative store;
  • access;
  • events;
  • migration;
  • retention;
  • audit;
  • provenance.

26.19.21. State Ownership Evolution

State ownership change SHALL define:

  • source state;
  • target state;
  • authoritative Component;
  • migration;
  • dual-write policy;
  • reconciliation;
  • rollback;
  • provenance.

26.19.22. Runtime Compatibility

Runtime compatibility SHALL evaluate:

  • contract compatibility;
  • state compatibility;
  • event compatibility;
  • authority compatibility;
  • deployment compatibility;
  • tenant routing;
  • reliability;
  • replay.

26.19.23. Module and Component Grandfathering

Grandfathering MAY preserve prior Components or contracts for:

  • historical replay;
  • long-running workflows;
  • regulated retention;
  • transition tenants;
  • unsupported but lawful archive access.

It SHALL not create indefinite ungoverned parallel ownership.


26.19.24. Runtime Migration Contract

Every breaking Module, Component or contract change SHALL reference a governed Runtime Migration Contract.


26.19.25. Registry Updates

Evolution SHALL update:

  • Module Registry;
  • Component Registry;
  • capability Registry;
  • Integration Contract Registry;
  • Runtime Manifest schema;
  • Pergamum Pulse lineage.

26.19.26. Compiler Projection

The Constitutional Compiler SHOULD produce:

  • Module manifests;
  • Component manifests;
  • capability contracts;
  • API schemas;
  • event schemas;
  • authority policies;
  • deployment constraints;
  • migration artefacts;
  • conformance fixtures.

26.19.27. Module and Component Validation

HECATE SHALL validate:

  • Module identity;
  • Component identity;
  • Component membership;
  • capability ownership;
  • contracts;
  • authority;
  • state;
  • compatibility;
  • migration;
  • historical lineage;
  • provenance.

26.20. Extension-Point and Extension-Ecosystem Evolution

A Core Extension Point defines where bounded non-Core meaning may attach.

Changing an Extension Point can affect every dependent Extension, tenant and white-label deployment.


26.20.1. Extension-Point Change Object

Every Extension-Point Change SHALL possess:

  • Extension-Point Change Identifier;
  • Extension Point;
  • source contract;
  • target contract;
  • affected Extension Classes;
  • affected artefact types;
  • affected Namespaces;
  • affected Packages;
  • affected tenants;
  • compatibility;
  • migration;
  • authority;
  • effective time;
  • provenance.

26.20.2. Extension-Point Evolution Types

Types MAY include:

  • Extension Point addition;
  • permission expansion;
  • permission restriction;
  • attachment-model change;
  • validation change;
  • authority change;
  • precedence change;
  • security change;
  • version change;
  • deprecation;
  • closure;
  • replacement;
  • retirement.

26.20.3. Extension Point Addition

A new Extension Point SHALL define:

  • identity;
  • owning Core artefact;
  • owning Module;
  • supported Extension Classes;
  • permitted artefacts;
  • prohibited changes;
  • Namespace requirements;
  • authority;
  • validation;
  • compatibility;
  • security;
  • provenance.

26.20.4. Extension Point Expansion

Expansion SHALL evaluate:

  • new Extension Classes;
  • new authorities;
  • new artefacts;
  • security;
  • tenant isolation;
  • precedence;
  • conflict risk;
  • Core-fragmentation risk.

26.20.5. Extension Point Restriction

Restriction SHALL identify:

  • previously permitted Extensions;
  • newly prohibited Extensions;
  • migration;
  • grandfathering;
  • tenant impact;
  • white-label impact;
  • Catalogue impact;
  • provenance.

26.20.6. Attachment-Model Change

Changing how Extensions attach SHALL preserve:

  • parent Core artefact;
  • Extension identities;
  • inherited meaning;
  • precedence;
  • runtime resolution;
  • migration;
  • historical reconstruction.

26.20.7. Extension Authority Change

Changing who may create or approve Extensions SHALL address:

  • existing Packages;
  • pending proposals;
  • active delegations;
  • partner Namespaces;
  • tenant adoption;
  • certification;
  • provenance.

26.20.8. Extension Precedence Change

Precedence evolution SHALL identify changed outcomes for:

  • Core;
  • global Extensions;
  • jurisdictional Extensions;
  • framework Extensions;
  • white-label Extensions;
  • tenant Extensions;
  • organisation Extensions.

26.20.9. Extension Validation Change

A stricter validation change SHALL address active Extensions that may become non-conformant.


26.20.10. Extension Point Closure

Closure SHALL define:

  • affected Extensions;
  • prohibition on new Extensions;
  • treatment of existing active Extensions;
  • migration;
  • replacement Extension Point;
  • grandfathering;
  • retirement;
  • provenance.

26.20.11. Extension Point Replacement

Replacement SHALL preserve:

  • source and target Extension Points;
  • contract mapping;
  • supported artefacts;
  • authority;
  • compatibility;
  • migration;
  • historical lineage.

26.20.12. Extension Point Retirement

A retired Extension Point SHALL remain historically identifiable and unavailable for incompatible reuse.


26.20.13. Extension Inventory

Impact analysis SHALL enumerate:

  • approved Extensions;
  • candidate Extensions;
  • active Extension Packages;
  • Extension Sets;
  • tenant Extensions;
  • white-label Extensions;
  • partner Extensions;
  • deprecated Extensions;
  • withdrawn Extensions;
  • historical Extensions.

26.20.14. Extension Compatibility Outcome

Each affected Extension SHALL receive an outcome such as:

  • Compatible;
  • Compatible after Recompile;
  • Compatible after Revalidation;
  • Compatible after Repackaging;
  • Compatible after Configuration Change;
  • Migration Required;
  • Grandfathered;
  • Superseded by Core;
  • Invalidated;
  • Withdrawn;
  • Indeterminate.

26.20.15. Supersession by Core

Where Core evolution absorbs an Extension concept, the change SHALL preserve:

  • Extension identity;
  • Core target identity;
  • mapping;
  • differences;
  • affected tenants;
  • migration;
  • Catalogue treatment;
  • historical lineage.

26.20.16. Extension-to-Core Migration

Migration SHALL address:

  • Extension artefacts;
  • Core artefacts;
  • data;
  • graph;
  • policies;
  • workflows;
  • agents;
  • Components;
  • Publications;
  • tenant configurations;
  • provenance.

26.20.17. Core-to-Extension Refactoring

A Core artefact MAY be moved to an Extension only through explicit evolution.

The change SHALL address:

  • loss of universal applicability;
  • optionality;
  • tenant adoption;
  • authority;
  • migration;
  • historical Core identity;
  • Publication effects.

26.20.18. Extension Package Recompilation

A Core baseline change MAY require Extension Packages to be recompiled.

Recompilation SHALL preserve source Extension identity and SHALL not imply semantic compatibility.


26.20.19. Extension Package Revalidation

Revalidation SHALL evaluate:

  • Extension Point;
  • Core dependencies;
  • schemas;
  • behaviour;
  • authority;
  • security;
  • tenant isolation;
  • Publication;
  • provenance.

26.20.20. Tenant Extension Treatment

Tenant-specific Extensions SHALL not be overlooked because they are absent from global Catalogues.

The impact process SHALL include tenant-private Extension Registries.


26.20.21. White-Label Extension Treatment

White-label Extensions SHALL be assessed for:

  • operator Namespace;
  • shared Components;
  • tenant population;
  • public projections;
  • contracts;
  • support;
  • migration waves.

26.20.22. Partner Extension Treatment

Partner Extensions SHALL be assessed for:

  • publisher authority;
  • package availability;
  • support;
  • licence;
  • certification;
  • migration capability;
  • withdrawal risk.

26.20.23. Extension Freeze

A Core transition MAY impose an Extension Freeze on:

  • new proposals;
  • new Package versions;
  • new activations;
  • selected Extension Points.

The freeze SHALL be scoped and time-bound.


26.20.24. Extension Migration Window

A migration window SHALL define:

  • affected Extensions;
  • source Core baseline;
  • target Core baseline;
  • recompile deadline;
  • revalidation deadline;
  • activation deadline;
  • exception policy;
  • support;
  • provenance.

26.20.25. Extension Ecosystem Notice

Affected operators, tenants, partners and publishers SHOULD receive notice containing:

  • changed Core baseline;
  • changed Extension Points;
  • compatibility outcome;
  • required actions;
  • dates;
  • support;
  • provenance reference.

26.20.26. Extension Impact Receipt

A receipt SHOULD contain:

  • Core Change Set;
  • Extension;
  • Package;
  • compatibility outcome;
  • required action;
  • migration;
  • authority;
  • deadline;
  • provenance.

26.20.27. Extension Evolution Validation

HECATE SHALL validate:

  • Extension-Point change;
  • affected inventory;
  • compatibility outcomes;
  • closure or replacement;
  • Core supersession;
  • migration windows;
  • tenant and white-label coverage;
  • provenance.

26.21. Constitutional Compatibility, Grandfathering and Transition Profiles

Constitutional compatibility SHALL describe whether source-baseline artefacts, Extensions, data, runtime behaviour and Publications can remain valid under the target baseline.

Compatibility SHALL be multidimensional.

A single “compatible” flag SHALL be insufficient for material Core evolution.


26.21.1. Constitutional Compatibility Profile

Every material CCS SHALL possess a Constitutional Compatibility Profile containing:

  • Compatibility Profile Identifier;
  • source baseline;
  • target baseline;
  • Change Set;
  • assessed subjects;
  • compatibility dimensions;
  • outcomes;
  • conditions;
  • migration obligations;
  • grandfathering;
  • transition period;
  • assessor;
  • validity;
  • provenance.

26.21.2. Compatibility Dimensions

Dimensions SHALL include as applicable:

  • identity compatibility;
  • semantic compatibility;
  • structural compatibility;
  • datatype compatibility;
  • unit compatibility;
  • Registry compatibility;
  • graph compatibility;
  • policy compatibility;
  • decision compatibility;
  • computation compatibility;
  • methodology compatibility;
  • workflow compatibility;
  • event compatibility;
  • agent compatibility;
  • tool compatibility;
  • Module compatibility;
  • Component compatibility;
  • authority compatibility;
  • security compatibility;
  • tenant-isolation compatibility;
  • Extension compatibility;
  • runtime compatibility;
  • API compatibility;
  • Publication compatibility;
  • assurance compatibility;
  • certification compatibility;
  • archival compatibility;
  • historical-replay compatibility.

26.21.3. Compatibility Outcome Classes

Outcome Classes MAY include:

  • Fully Compatible;
  • Backward Compatible;
  • Forward Compatible;
  • Bidirectionally Compatible;
  • Conditionally Compatible;
  • Compatible after Recompile;
  • Compatible after Revalidation;
  • Compatible after Migration;
  • Compatible only for Historical Read;
  • Compatible only for Replay;
  • Grandfathered;
  • Transition-Only;
  • Superseded;
  • Invalidated;
  • Incompatible;
  • Indeterminate;
  • Not Evaluated.

Indeterminate and Not Evaluated SHALL NOT be treated as compatible.


26.21.4. Compatibility Direction

Compatibility direction SHALL be explicit.

Examples include:

  • target runtime reads source data;
  • source runtime reads target data;
  • target policy interprets source decisions;
  • target Publication schema represents source outcomes;
  • target resolver resolves source identity;
  • source Extension runs on target baseline.

26.21.5. Semantic Compatibility

Semantic compatibility exists only where meaning remains equivalent for the claimed purpose and scope.

Equivalent syntax or datatype SHALL not establish semantic compatibility.


26.21.6. Historical Compatibility

Historical compatibility SHALL determine whether source-baseline artefacts and outcomes remain:

  • interpretable;
  • verifiable;
  • replayable;
  • comparable;
  • auditable;
  • publishable with qualification.

26.21.7. Authority Compatibility

Authority compatibility SHALL assess whether source-baseline decisions remain valid where:

  • Roles change;
  • approval thresholds change;
  • authority is revoked;
  • separation of duties changes;
  • ratification requirements change.

26.21.8. Security Compatibility

Security compatibility SHALL assess whether continued source-state use violates target-baseline security or tenant-isolation requirements.

A security-incompatible state SHALL not be preserved solely for operational convenience.


26.21.9. Publication Compatibility

Publication compatibility SHALL distinguish:

  • prior Publication remains valid;
  • prior Publication remains valid with historical label;
  • prior Publication requires qualification;
  • prior Publication requires correction;
  • prior Publication requires restatement;
  • prior Publication is superseded;
  • prior Publication must be withdrawn;
  • status is indeterminate.

26.21.10. Compatibility Matrix

The Runtime SHOULD maintain a Compatibility Matrix covering:

  • source and target baselines;
  • Runtime Bundles;
  • Extension Packages;
  • Modules;
  • Components;
  • schemas;
  • policies;
  • workflows;
  • events;
  • agents;
  • tools;
  • Connectors;
  • Publication Profiles;
  • tenants;
  • white-label deployments.

26.21.11. Compatibility Evidence

Evidence MAY include:

  • semantic comparison;
  • schema analysis;
  • test results;
  • replay results;
  • migration simulation;
  • tenant-isolation tests;
  • security assessment;
  • Extension conformance;
  • Publication comparison;
  • assurance opinion.

26.21.12. Conditional Compatibility

Conditional compatibility SHALL identify:

  • conditions;
  • responsible actor;
  • deadline;
  • verification;
  • failure consequence;
  • scope;
  • provenance.

26.21.13. Compatibility Exception

An exception SHALL identify:

  • incompatible subject;
  • permitted scope;
  • authority;
  • reason;
  • risk;
  • compensating controls;
  • expiration;
  • migration obligation;
  • provenance.

26.21.14. Grandfathering Object

Every Grandfathering arrangement SHALL possess:

  • Grandfathering Identifier;
  • source baseline;
  • target baseline;
  • eligible subjects;
  • preserved state;
  • prohibited new state;
  • scope;
  • authority;
  • start time;
  • end time or review;
  • transition conditions;
  • Publication treatment;
  • provenance.

26.21.15. Grandfathered Subject

A grandfathered subject MAY be:

  • object instance;
  • relationship;
  • Registry entry;
  • approval;
  • decision;
  • workflow instance;
  • Publication;
  • Extension;
  • tenant configuration;
  • certification;
  • authority assignment.

26.21.16. Grandfathering Eligibility

Eligibility SHALL be based on explicit criteria such as:

  • created before effective time;
  • valid under source baseline;
  • active at transition;
  • named tenant or cohort;
  • protected legal reliance;
  • active assurance engagement;
  • closed reporting period;
  • approved exception.

Existing existence alone SHALL not establish eligibility.


26.21.17. Grandfathering Limitations

Grandfathering SHALL define whether the subject may be:

  • read;
  • updated;
  • renewed;
  • extended;
  • copied;
  • reassigned;
  • republished;
  • used as evidence;
  • used in new decisions;
  • migrated.

26.21.18. No New Creation

Where grandfathering preserves old state but prohibits new state, the Runtime SHALL distinguish creation, modification and historical access.


26.21.19. Grandfathering Expiration

Expiration SHALL trigger:

  • migration;
  • suspension;
  • retirement;
  • revalidation;
  • new approval;
  • Publication qualification;
  • explicit extension of grandfathering.

Expiration SHALL not be ignored silently.


26.21.20. Transition Profile

A Transition Profile SHALL identify:

  • source baseline;
  • target baseline;
  • affected scopes;
  • compatibility;
  • grandfathering;
  • migration waves;
  • coexistence;
  • enforcement phases;
  • effective times;
  • rollback;
  • monitoring;
  • provenance.

26.21.21. Transition Phases

Phases MAY include:

  • announcement;
  • preparation;
  • optional early adoption;
  • shadow validation;
  • migration;
  • dual-baseline operation;
  • target-baseline default;
  • source-baseline restriction;
  • source-baseline retirement;
  • historical-only access.

26.21.22. Enforcement Profile

An Enforcement Profile SHALL define:

  • warnings;
  • non-blocking findings;
  • blocking findings;
  • new-creation prohibition;
  • update prohibition;
  • Publication restriction;
  • activation restriction;
  • retirement;
  • effective times.

26.21.23. Baseline Coexistence

Coexistence SHALL define:

  • source and target baseline scopes;
  • authoritative baseline for each context;
  • tenant routing;
  • data and graph treatment;
  • Extension compatibility;
  • Runtime Bundle mapping;
  • Publication interpretation;
  • end condition.

26.21.24. Cross-Baseline Interaction

Cross-baseline interaction SHALL be prohibited unless a governed Compatibility Bridge defines:

  • source and target;
  • permitted interactions;
  • transformations;
  • authority;
  • information loss;
  • security;
  • tenant isolation;
  • expiration;
  • provenance.

26.21.25. Transition Notice

Affected parties SHOULD receive notice containing:

  • source and target baselines;
  • changed obligations;
  • compatibility;
  • grandfathering;
  • migration;
  • key dates;
  • required actions;
  • support;
  • provenance reference.

26.21.26. Compatibility Reassessment

Compatibility SHALL be reassessed where:

  • target CCS changes;
  • dependency state changes;
  • new tenant Extensions are discovered;
  • migration findings arise;
  • security state changes;
  • Publication consequences change;
  • replay divergence appears.

26.21.27. Compatibility Receipt

A receipt SHOULD contain:

  • source and target baselines;
  • assessed subject;
  • dimensions;
  • outcome;
  • conditions;
  • grandfathering;
  • migration;
  • assessor;
  • time;
  • provenance.

26.21.28. Compatibility Validation

HECATE SHALL validate:

  • profile identity;
  • dimensions;
  • outcome;
  • evidence;
  • direction;
  • conditions;
  • exceptions;
  • grandfathering;
  • transition;
  • provenance.

26.22. Migration Obligations and Transformation Contracts

A Migration Obligation is the constitutional requirement to transform, revalidate, reclassify, reapprove, republish, retire or otherwise transition affected state because of a ratified Core change.

A Transformation Contract defines exactly how one class of affected state moves from source-baseline meaning to target-baseline meaning.

Migration obligations SHALL derive from ratified change and compatibility analysis.


26.22.1. Migration Obligation Identity

Every Migration Obligation SHALL possess:

  • Migration Obligation Identifier;
  • CCS;
  • source baseline;
  • target baseline;
  • affected subject type;
  • affected population;
  • required action;
  • authority;
  • deadline;
  • prerequisites;
  • completion criteria;
  • exception policy;
  • rollback or corrective treatment;
  • provenance.

26.22.2. Migration Obligation Types

Types MAY include:

  • data migration;
  • graph migration;
  • Registry migration;
  • identity migration;
  • schema migration;
  • policy migration;
  • decision revalidation;
  • computation recalculation;
  • methodology transition;
  • workflow migration;
  • event migration;
  • agent migration;
  • model migration;
  • tool migration;
  • Module migration;
  • Component migration;
  • Extension migration;
  • Publication migration;
  • assurance migration;
  • certification migration;
  • archive migration.

26.22.3. Migration Subject

A migration subject MAY be:

  • one artefact;
  • one object instance;
  • one relationship;
  • one workflow;
  • one tenant;
  • one white-label deployment;
  • one Extension Package;
  • one Runtime Bundle;
  • one Publication Series;
  • one archive class;
  • an entire platform baseline.

26.22.4. Transformation Contract Identity

Every Transformation Contract SHALL possess:

  • Transformation Contract Identifier;
  • source schema or state;
  • target schema or state;
  • applicable Migration Obligations;
  • transformation semantics;
  • information-loss profile;
  • validation;
  • error treatment;
  • reversibility;
  • implementing Component;
  • version;
  • provenance.

26.22.5. Transformation Classes

Transformation Classes MAY include:

  • identity-preserving transformation;
  • identity-changing transformation;
  • lossless transformation;
  • lossy transformation;
  • deterministic recalculation;
  • probabilistic recalculation;
  • manual adjudication;
  • reclassification;
  • split;
  • merge;
  • aggregation;
  • decomposition;
  • unit conversion;
  • Registry mapping;
  • workflow state mapping;
  • event upcast;
  • event downcast;
  • policy re-evaluation;
  • reapproval;
  • republication.

26.22.6. Source-State Capture

Before migration, source state SHOULD preserve:

  • Baseline Identifier;
  • artefact identity;
  • value;
  • unit;
  • relationships;
  • authority;
  • evidence;
  • assurance;
  • tenant;
  • valid time;
  • transaction time;
  • Package and Runtime Bundle;
  • provenance.

26.22.7. Target-State Definition

Target state SHALL define:

  • target identity;
  • target value;
  • target unit;
  • target relationships;
  • target authority;
  • target lifecycle;
  • target validation;
  • target Publication treatment;
  • provenance.

26.22.8. Information-Loss Profile

A lossy transformation SHALL identify:

  • lost semantics;
  • lost precision;
  • lost hierarchy;
  • lost temporal detail;
  • lost evidence;
  • lost assurance detail;
  • affected uses;
  • authority accepting loss;
  • provenance.

26.22.9. Ambiguous Transformation

Where source state maps to multiple target states, the Contract SHALL require:

  • deterministic rule;
  • authorised human adjudication;
  • explicit unresolved state; or
  • rejection.

Arbitrary selection SHALL be prohibited.


26.22.10. Unmappable State

Unmappable state SHALL be:

  • quarantined;
  • grandfathered;
  • manually remediated;
  • archived as source-only;
  • rejected from target baseline;
  • handled through Corrective Amendment where necessary.

26.22.11. Defaulting

Defaulting SHALL identify:

  • default source;
  • authority;
  • reason;
  • scope;
  • evidence limitation;
  • target use;
  • Publication visibility;
  • provenance.

Defaulting SHALL not fabricate historical observation.


26.22.12. Estimation

Estimated migration values SHALL preserve:

  • estimation method;
  • inputs;
  • assumptions;
  • uncertainty;
  • Component or actor;
  • validation;
  • approval;
  • provenance.

26.22.13. Recalculation

Recalculation SHALL preserve:

  • source inputs;
  • source methodology;
  • target methodology;
  • factors;
  • units;
  • assumptions;
  • original result;
  • target result;
  • divergence;
  • provenance.

26.22.14. Revalidation

Revalidation SHALL identify:

  • target validation profile;
  • prior result;
  • target result;
  • changed rules;
  • findings;
  • remediation;
  • provenance.

26.22.15. Reapproval

Where authority rules change, reapproval SHALL identify:

  • prior approval;
  • target authority;
  • evidence;
  • scope;
  • decision;
  • time;
  • provenance.

26.22.16. Workflow State Transformation

Workflow migration SHALL preserve:

  • source Workflow definition;
  • target Workflow definition;
  • source state;
  • target state;
  • active Tasks;
  • pending Gates;
  • timers;
  • actors;
  • side effects;
  • compensation;
  • provenance.

26.22.17. Event Transformation

Event migration SHALL preserve:

  • original Event Identifier;
  • original payload;
  • source schema;
  • target schema;
  • transformation;
  • event time;
  • order;
  • correlation;
  • causation;
  • replay;
  • provenance.

26.22.18. Agent Transformation

Agent migration SHALL preserve:

  • source Agent Profile;
  • target Agent Profile;
  • model;
  • instructions;
  • tools;
  • memory;
  • authority;
  • oversight;
  • evaluation;
  • prohibited side effects;
  • provenance.

26.22.19. Module and Component Transformation

Migration SHALL preserve:

  • source Module and Component;
  • target Module and Component;
  • capability mapping;
  • state mapping;
  • contract mapping;
  • authority;
  • deployment;
  • operational ownership;
  • Pergamum Pulse lineage;
  • provenance.

26.22.20. Extension Transformation

Extension migration SHALL preserve:

  • Extension identity;
  • source and target Extension Points;
  • Package versions;
  • tenant scope;
  • Namespace;
  • recompile or revalidation state;
  • Core supersession;
  • provenance.

26.22.21. Publication Transformation

Publication treatment SHALL identify whether migration creates:

  • internal-only transformed state;
  • new Publication Object;
  • new Publication Package;
  • correction;
  • restatement;
  • superseding Release;
  • withdrawal;
  • no public action.

26.22.22. Migration Sequencing

Sequence SHALL account for:

  • identities before references;
  • schemas before data;
  • Registries before controlled values;
  • Components before routing;
  • event producers before consumers where required;
  • policies before dependent workflows;
  • Runtime Bundle before activation;
  • archive before destructive migration.

26.22.23. Migration Wave

A wave SHALL identify:

  • scope;
  • tenants;
  • white-label deployments;
  • Modules;
  • Components;
  • Extensions;
  • start;
  • prerequisites;
  • success criteria;
  • failure criteria;
  • rollback;
  • provenance.

26.22.24. Migration Dry Run

A dry run SHOULD use production-representative, protected data or governed synthetic data and SHALL prevent authoritative side effects.


26.22.25. Shadow Migration

Shadow migration MAY generate target state for comparison without making it authoritative.


26.22.26. Migration Reconciliation

Reconciliation SHALL compare as applicable:

  • object counts;
  • identities;
  • values;
  • units;
  • relationships;
  • Registry references;
  • decisions;
  • calculations;
  • workflow states;
  • events;
  • agents;
  • Extensions;
  • Publications;
  • evidence;
  • provenance.

26.22.27. Migration Finding

A Migration Finding SHALL identify:

  • obligation;
  • affected subject;
  • source state;
  • target state;
  • expected result;
  • observed result;
  • severity;
  • materiality;
  • remediation;
  • provenance.

26.22.28. Migration Completion

Completion SHALL require:

  • all blocking obligations satisfied;
  • required reconciliation passed;
  • target baseline state valid;
  • Runtime Manifest updated;
  • unresolved state governed;
  • old state archived or grandfathered;
  • Publication treatment complete;
  • provenance complete.

26.22.29. Migration Failure

Failure SHALL preserve:

  • failed obligation;
  • failed Contract;
  • affected scopes;
  • source state;
  • partial target state;
  • side effects;
  • rollback;
  • incident;
  • provenance.

26.22.30. Rollback

Rollback SHALL define:

  • eligible conditions;
  • reverse transformation;
  • state restoration;
  • event treatment;
  • workflow treatment;
  • Publication treatment;
  • external side effects;
  • authority;
  • provenance.

26.22.31. Corrective Migration

Where rollback is unsafe or impossible, a Corrective Migration or Corrective Amendment SHALL create a new governed target state.


26.22.32. Migration Receipt

A Migration Receipt SHOULD contain:

  • Migration Obligation;
  • Transformation Contract;
  • source and target baselines;
  • affected scope;
  • source digest;
  • target digest;
  • validation;
  • reconciliation;
  • actor or Component;
  • time;
  • provenance.

26.22.33. Migration Registry

The Migration Registry SHALL preserve:

  • obligations;
  • Contracts;
  • versions;
  • waves;
  • receipts;
  • findings;
  • exceptions;
  • completion;
  • rollback;
  • provenance.

26.22.34. Migration Validation

HECATE SHALL validate:

  • obligation;
  • Contract;
  • source and target state;
  • information loss;
  • ambiguity;
  • authority;
  • sequence;
  • reconciliation;
  • completion;
  • rollback;
  • provenance.

26.23. Constitutional Dependency Graph, Diff and Impact Propagation

The CEvF SHALL maintain a Constitutional Dependency Graph capable of identifying direct, transitive, reverse, runtime, Extension, Publication and historical dependencies.

Impact analysis SHALL be graph-driven and evidence-based.


26.23.1. Constitutional Dependency Graph Identity

Every graph snapshot SHALL possess:

  • Dependency Graph Identifier;
  • Constitutional Baseline;
  • graph schema version;
  • included artefact classes;
  • build time;
  • builder Component;
  • source digests;
  • completeness state;
  • lifecycle;
  • provenance.

26.23.2. Dependency Node Types

Nodes MAY include:

  • constitutional principle;
  • definition;
  • Object Type;
  • property;
  • datatype;
  • unit;
  • Registry;
  • Registry entry;
  • Relationship Type;
  • policy;
  • decision;
  • computation;
  • methodology;
  • workflow;
  • event;
  • command;
  • agent;
  • model;
  • tool;
  • Module;
  • Component;
  • Extension Point;
  • Extension;
  • Package;
  • Runtime Bundle;
  • Runtime Manifest;
  • Publication Profile;
  • Publication;
  • assurance object;
  • certification;
  • migration object;
  • tenant;
  • white-label deployment.

26.23.3. Dependency Relationship Types

Relationship Types MAY include:

  • defines;
  • constrains;
  • references;
  • inherits;
  • specialises;
  • validates;
  • computes;
  • consumes;
  • produces;
  • publishes;
  • assures;
  • certifies;
  • implements;
  • belongs to Module;
  • depends on Component;
  • extends through;
  • migrates from;
  • migrates to;
  • supersedes;
  • grandfathers;
  • activates;
  • archived with;
  • historically interpreted by.

26.23.4. Direct Dependency

A direct dependency connects an artefact to an immediately required or referenced artefact.


26.23.5. Transitive Dependency

A transitive dependency is reached through one or more dependency paths.

Impact traversal SHALL define maximum depth, path types and cycle treatment.


26.23.6. Reverse Dependency

Reverse dependency analysis identifies artefacts, Extensions, tenants, Components or Publications that rely on the changed artefact.


26.23.7. Runtime Dependency

Runtime dependency SHALL include:

  • compiler output;
  • Runtime Bundle;
  • policy cache;
  • schema cache;
  • event consumer;
  • workflow;
  • agent;
  • tool;
  • Component;
  • Connector;
  • projection;
  • archive.

26.23.8. Extension Dependency

Extension dependency SHALL include:

  • Extension Point;
  • Core artefact;
  • Core schema;
  • Core policy;
  • Core Module;
  • Core Component contract;
  • Core Runtime Profile;
  • Core Publication Profile.

26.23.9. Publication Dependency

Publication dependency SHALL identify:

  • source object;
  • property;
  • calculation;
  • methodology;
  • assurance;
  • profile;
  • channel;
  • Release;
  • historical public reference.

26.23.10. Historical Dependency

Historical dependency SHALL identify which baseline, artefact version and runtime state are required to interpret or replay prior outcomes.


26.23.11. Dependency Strength

Strength MAY be:

  • mandatory;
  • conditional;
  • optional;
  • advisory;
  • historical only;
  • inferred;
  • unknown.

26.23.12. Dependency Authority

Every material dependency SHOULD preserve the authority or source that establishes it.


26.23.13. Dependency Completeness

Completeness MAY be:

  • Complete;
  • Materially Complete;
  • Partial;
  • Reconstructed;
  • Indeterminate.

Partial or Indeterminate graphs SHALL produce limitations in impact analysis.


26.23.14. Constitutional Diff Object

Every material baseline comparison SHALL produce a Constitutional Diff containing:

  • source baseline;
  • target baseline;
  • CCS;
  • added artefacts;
  • changed artefacts;
  • removed or retired artefacts;
  • semantic changes;
  • structural changes;
  • behavioural changes;
  • authority changes;
  • Module and Component changes;
  • Extension-Point changes;
  • compatibility;
  • migration;
  • provenance.

26.23.15. Textual Diff

A Textual Diff MAY support review but SHALL not substitute for Constitutional Diff.


26.23.16. Semantic Diff

Semantic Diff SHALL identify changed meaning, even where wording or serialization remains unchanged.


26.23.17. Graph Diff

Graph Diff SHALL identify:

  • added nodes;
  • removed nodes;
  • changed node semantics;
  • added relationships;
  • removed relationships;
  • changed relationship semantics;
  • changed constraints;
  • changed paths;
  • tenant-boundary effect.

26.23.18. Behavioural Diff

Behavioural Diff SHALL identify changed outcomes for representative and boundary cases.


26.23.19. Authority Diff

Authority Diff SHALL identify gained, lost, delegated, restricted or reassigned powers.


26.23.20. Runtime Diff

Runtime Diff SHALL identify changes to:

  • Runtime Bundles;
  • Components;
  • contracts;
  • policies;
  • workflows;
  • events;
  • agents;
  • tools;
  • Connectors;
  • caches;
  • projections;
  • Runtime Manifests.

26.23.21. Publication Diff

Publication Diff SHALL identify changed:

  • eligibility;
  • metrics;
  • narratives;
  • units;
  • boundaries;
  • assurance;
  • audiences;
  • disclosures;
  • formats;
  • correction obligations.

26.23.22. Impact Propagation Rule

Every propagation rule SHALL define:

  • source change type;
  • traversed Relationship Types;
  • affected target type;
  • severity transformation;
  • stopping condition;
  • confidence;
  • explanation;
  • provenance.

26.23.23. Propagation Classes

Propagation MAY be:

  • deterministic;
  • rule-based;
  • heuristic;
  • probabilistic;
  • manually confirmed;
  • derived by AI.

Only governed and validated propagation SHALL support authoritative impact claims.


26.23.24. Impact Radius Calculation

Impact Radius SHALL consider:

  • number of artefacts;
  • dependency depth;
  • number of tenants;
  • number of white-label deployments;
  • number of Extensions;
  • number of Modules and Components;
  • number of Publications;
  • legal jurisdictions;
  • security boundaries;
  • reversibility.

26.23.25. Critical Path

A Critical Path identifies dependencies that determine whether the target baseline can be compiled, migrated, activated or published safely.


26.23.26. Dependency Cycle

A cycle SHALL be:

  • prohibited;
  • semantically valid and explicitly modelled;
  • broken through redesign;
  • handled through fixed-point or coordinated migration.

Unanalysed cycles SHALL block ratification readiness.


26.23.27. Orphan Detection

The graph SHALL detect artefacts that become:

  • undefined;
  • unowned;
  • unreferenced where reference is required;
  • without Module;
  • without Component implementation;
  • without migration;
  • without authority;
  • without Publication treatment.

26.23.28. Dead Reference Detection

A dead reference points to a removed, retired or unresolved identity without valid mapping.


26.23.29. Unintended Authority Expansion

Graph analysis SHOULD detect paths that expand authority indirectly through:

  • Role inheritance;
  • delegation;
  • Component capability;
  • tool access;
  • Extension Point expansion;
  • shared-service access.

26.23.30. Tenant Boundary Analysis

Graph analysis SHALL detect changed paths that could cross tenant or white-label boundaries.


26.23.31. Impact Finding

An Impact Finding SHALL identify:

  • source change;
  • dependency path;
  • affected target;
  • severity;
  • confidence;
  • evidence;
  • required action;
  • provenance.

26.23.32. Human Confirmation

High-impact derived findings SHOULD receive human confirmation by an authorised reviewer.


26.23.33. Impact Coverage Report

A report SHOULD identify:

  • artefact classes covered;
  • repositories covered;
  • Runtime systems covered;
  • tenant Registries covered;
  • Extension Catalogues covered;
  • Publication systems covered;
  • known gaps;
  • completeness;
  • provenance.

26.23.34. Dependency Snapshot

The ratified Amendment Package SHOULD bind to the dependency snapshot used for final impact analysis.


26.23.35. Dependency Drift

Dependency Drift exists where actual dependencies differ materially from the ratification snapshot before activation.

It SHALL trigger reassessment.


26.23.36. Pergamum Pulse Integration

Pergamum Pulse MAY derive intelligence including:

  • change concentration;
  • constitutional coupling;
  • high-risk dependency hubs;
  • orphan risk;
  • dead-reference risk;
  • Module boundary pressure;
  • Component concentration;
  • Extension incompatibility clusters;
  • tenant migration concentration;
  • Publication exposure;
  • authority-expansion paths;
  • security-boundary pressure;
  • baseline fragmentation;
  • migration critical paths.

Pergamum Pulse SHALL preserve:

  • Baseline lineage;
  • Change Set lineage;
  • operation lineage;
  • dependency-path lineage;
  • Module lineage;
  • Component lineage;
  • Extension lineage;
  • tenant lineage;
  • Publication lineage;
  • temporal validity;
  • provenance.

Derived intelligence SHALL remain non-authoritative until governed activation.


26.23.37. Dependency and Diff Validation

HECATE SHALL validate:

  • graph identity;
  • node and relationship types;
  • completeness;
  • Diff binding;
  • propagation rules;
  • cycles;
  • orphans;
  • dead references;
  • tenant-boundary findings;
  • impact coverage;
  • dependency drift;
  • provenance.

26.24. Part II Provenance, Testing and Conformance

Every constitutional operation, compatibility decision, grandfathering rule, migration obligation and propagated impact SHALL remain traceable from source baseline to target baseline and historical execution.


26.24.1. Part II Provenance

Part II provenance SHALL include:

  • source Constitutional Baseline;
  • target Candidate Baseline;
  • CCS;
  • Atomic and Composite Operations;
  • semantic mutation matrix;
  • identity changes;
  • Namespace changes;
  • structural changes;
  • behavioural changes;
  • authority changes;
  • security changes;
  • Publication changes;
  • Module and Component changes;
  • Extension-Point changes;
  • compatibility profiles;
  • grandfathering;
  • Transition Profiles;
  • Migration Obligations;
  • Transformation Contracts;
  • Dependency Graph;
  • Constitutional Diffs;
  • impact findings;
  • validation;
  • ratification binding;
  • compiler outputs;
  • runtime migration;
  • historical replay.

26.24.2. Part II Provenance Graph

Source Constitutional Baseline


Constitutional Change Proposal


Constitutional Change Set

├── Typed Amendment Operations
├── Identity and Namespace Changes
├── Structural Changes
├── Behavioural Changes
├── Authority and Security Changes
├── Module and Component Changes
└── Extension-Point Changes


Constitutional Dependency Graph


Constitutional Diff and Impact Propagation


Compatibility Profile and Transition Profile


Migration Obligations and Transformation Contracts


Ratified Amendment Package


Compiler Projections and Runtime Migration


Target Constitutional Baseline


Historical Reconstruction and Replay

26.24.3. Constitutional Change Receipt

A high-impact change SHOULD produce a receipt containing:

  • CCS;
  • source and target baselines;
  • operation inventory;
  • Change Classes;
  • compatibility outcome;
  • grandfathering;
  • migration obligations;
  • dependency snapshot;
  • impacted Modules and Components;
  • impacted Extensions;
  • impacted tenants;
  • impacted Publications;
  • validation;
  • authority;
  • provenance.

26.24.4. Operation History Object

Every material Core artefact SHOULD expose a history containing:

  • all operations;
  • source and target versions;
  • effective times;
  • mappings;
  • supersession;
  • migration;
  • compatibility;
  • authority;
  • provenance.

26.24.5. Compatibility History

Compatibility history SHALL preserve:

  • assessed baseline pairs;
  • assessed subjects;
  • outcomes;
  • evidence;
  • conditions;
  • exceptions;
  • reassessments;
  • provenance.

26.24.6. Migration History

Migration history SHALL preserve:

  • obligations;
  • Contracts;
  • waves;
  • source snapshots;
  • target snapshots;
  • findings;
  • reconciliation;
  • completion;
  • rollback;
  • provenance.

26.24.7. Test Plan

Every material CCS SHALL possess a test plan proportionate to its scope.

Test classes MAY include:

  • semantic conformance;
  • identity resolution;
  • schema compatibility;
  • unit conversion;
  • Registry migration;
  • graph integrity;
  • policy outcomes;
  • decision outcomes;
  • computation comparison;
  • workflow migration;
  • event compatibility;
  • agent evaluation;
  • tool-authority testing;
  • Module and Component conformance;
  • Extension compatibility;
  • tenant isolation;
  • Publication comparison;
  • historical replay.

26.24.8. Golden Constitutional Vector

A Golden Constitutional Vector SHALL preserve:

  • source baseline;
  • source input or state;
  • target baseline;
  • expected target state;
  • expected compatibility;
  • expected migration;
  • expected outcome;
  • tolerance;
  • provenance.

26.24.9. Negative Test

Negative tests SHALL verify rejection of:

  • wrong source baseline;
  • duplicate Core identity;
  • prohibited semantic mutation;
  • invalid authority;
  • invariant violation;
  • incompatible Extension;
  • cross-tenant path;
  • orphan Component;
  • dead reference;
  • unratified operation;
  • invalid migration;
  • unexplained information loss.

26.24.10. Differential Test

Differential tests SHOULD compare source and target baseline behaviour across:

  • representative cases;
  • boundary cases;
  • invalid cases;
  • tenant variants;
  • Extension variants;
  • Publication variants;
  • historical cases.

26.24.11. Metamorphic Test

Metamorphic tests MAY verify invariants under controlled input transformations where exact outcomes are impractical to enumerate.


26.24.12. Property-Based Test

Property-based tests MAY validate:

  • identity uniqueness;
  • referential integrity;
  • tenant isolation;
  • unit consistency;
  • monotonic constraints;
  • idempotent migration;
  • reversibility;
  • no orphan Components;
  • no unowned capabilities.

26.24.13. Migration Test

Migration testing SHALL cover:

  • eligibility;
  • transformation;
  • ambiguity;
  • unmappable state;
  • defaulting;
  • estimation;
  • sequencing;
  • reconciliation;
  • rollback;
  • Publication treatment.

26.24.14. Historical Replay Test

Replay testing SHALL verify that source-baseline outcomes remain interpretable and that target-baseline differences are explained.


26.24.15. Extension Ecosystem Test

Testing SHALL include:

  • global Extensions;
  • white-label Extensions;
  • tenant-private Extensions;
  • partner Extensions;
  • deprecated Extensions;
  • historical Extensions where material.

26.24.16. Module and Component Test

Testing SHALL verify:

  • every Component belongs to one accountable Module;
  • capability ownership is complete;
  • contract changes are compatible or migrated;
  • Runtime Manifest lineage is correct;
  • Pergamum Pulse lineage is preserved.

26.24.17. Tenant-Isolation Test

Testing SHALL cover:

  • data;
  • graph;
  • events;
  • workflows;
  • agents;
  • tools;
  • caches;
  • search;
  • vectors;
  • logs;
  • archives;
  • Publications.

26.24.18. Publication Test

Publication testing SHALL compare:

  • values;
  • units;
  • boundaries;
  • methodology;
  • narratives;
  • assurance;
  • audience;
  • disclosure;
  • machine formats;
  • correction obligations.

26.24.19. Test Evidence

Test evidence SHALL preserve:

  • test identity;
  • CCS;
  • baseline pair;
  • environment;
  • Runtime Bundle;
  • Extension Set;
  • tenant context;
  • input;
  • expected result;
  • actual result;
  • time;
  • Component;
  • provenance.

26.24.20. Conformance Outcome

A Part II Conformance Outcome SHALL preserve:

  • assessed CCS;
  • criteria;
  • tests;
  • evidence;
  • findings;
  • exceptions;
  • outcome;
  • validity;
  • assessor;
  • provenance.

26.24.21. Part II Conformance Suite

The Constitutional Compiler Framework SHOULD generate fixtures including:

  • valid Atomic Operation;
  • valid Composite Operation;
  • wrong-baseline precondition;
  • partial incoherent Change Set;
  • idempotent reapplication;
  • conflicting Change Sets;
  • valid Add Operation;
  • clarification reclassified as semantic mutation;
  • valid Reidentify Operation;
  • identity split with ambiguous instances;
  • identity merge with information loss;
  • prohibited identity reuse;
  • canonical identifier resolver migration;
  • Object Type split;
  • required-property addition;
  • datatype precision loss;
  • non-convertible unit change;
  • Registry merge;
  • Relationship endpoint change;
  • graph-constraint change;
  • Policy Permit-to-Deny change;
  • threshold change;
  • methodology change;
  • workflow migration;
  • event semantic change;
  • prompt evolution;
  • model substitution;
  • Role expansion;
  • quorum change;
  • tenant-isolation change;
  • key rotation;
  • Publication eligibility change;
  • Module split;
  • Component reassignment;
  • orphan Component rejection;
  • Runtime Contract migration;
  • Extension Point restriction;
  • Extension Point closure;
  • Extension superseded by Core;
  • tenant-private Extension incompatibility;
  • Fully Compatible outcome;
  • Conditionally Compatible outcome;
  • Indeterminate compatibility;
  • valid Grandfathering Object;
  • expired grandfathering;
  • cross-baseline bridge;
  • data Migration Obligation;
  • workflow Transformation Contract;
  • ambiguous transformation;
  • unmappable state;
  • migration reconciliation;
  • dependency cycle;
  • dead reference;
  • unintended authority expansion;
  • tenant-boundary path;
  • dependency drift;
  • complete Part II provenance.

Part II Conformance

An implementation conforms to Part II of the Constitutional Evolution Framework where it:

  1. represents every material Core change as a typed Constitutional Change Set;
  2. binds every Change Set to exact source and target baselines;
  3. distinguishes Atomic and Composite Amendment Operations;
  4. defines operation preconditions, postconditions, order, dependencies and reversibility;
  5. prevents partial application from being represented as a coherent target baseline unless an approved phased model exists;
  6. supports idempotent Change Set application;
  7. detects conflicts among Change Sets and Amendment Operations;
  8. uses typed operations for addition, clarification, correction, modification, restriction, expansion, reidentification, split, merge, deprecation, supersession, retirement, grandfathering and migration;
  9. distinguishes display-name change from canonical identity change;
  10. prevents incompatible reuse of Core identifiers;
  11. preserves old identities, aliases, mappings and historical resolver behaviour;
  12. governs Namespace addition, partition, consolidation, reassignment and retirement;
  13. treats structural evolution as semantic constitutional change rather than merely database migration;
  14. governs Object Type, property, datatype, unit, Registry, Relationship Type, graph-constraint and validation evolution;
  15. preserves null semantics, precision, uncertainty, temporal semantics and Publication comparability;
  16. governs behavioural evolution across policies, decisions, computations, methodologies, workflows, events, agents, models, tools and integrations;
  17. treats material prompt, model and tool changes as behavioural changes where outcomes or authority may change;
  18. preserves running-workflow, event-replay and historical-decision treatment;
  19. applies heightened review to authority, governance, security, tenant-isolation and Publication evolution;
  20. preserves separation of duties, quorum, thresholds, delegation and emergency-authority controls;
  21. evaluates tenant isolation across every data, graph, event, agent, cache, archive and Publication representation;
  22. preserves Modules as top-level domains and Components as subordinate engines, services and supporting systems;
  23. prevents orphan Components during Module or Component transition;
  24. preserves capability, contract, state and ownership migration;
  25. governs Extension-Point addition, expansion, restriction, closure, replacement and retirement;
  26. inventories global, white-label, tenant-private, partner, deprecated and historical Extensions;
  27. prevents Core evolution from silently invalidating Extensions without compatibility outcome and migration treatment;
  28. distinguishes semantic, structural, behavioural, authority, security, Runtime, Extension, Publication and historical compatibility;
  29. treats Indeterminate and Not Evaluated as non-compatible for authoritative transition;
  30. governs grandfathering through explicit eligibility, scope, limitations, expiration and exit;
  31. prevents existing use from creating implied grandfathering rights;
  32. defines Transition Profiles, enforcement phases and cross-baseline interaction;
  33. derives Migration Obligations from ratified change and compatibility analysis;
  34. defines Transformation Contracts with source state, target state, information loss, ambiguity, validation and reversibility;
  35. prevents migration from inventing or weakening ratified constitutional meaning;
  36. distinguishes transformation, recalculation, revalidation, reapproval, defaulting and estimation;
  37. preserves original state and provenance through migration;
  38. requires reconciliation, completion criteria, rollback or Corrective Migration;
  39. maintains a Constitutional Dependency Graph with direct, transitive, reverse, Runtime, Extension, Publication and historical dependencies;
  40. produces semantic, structural, behavioural, authority, Runtime and Publication diffs;
  41. detects dependency cycles, orphan artefacts, dead references, authority expansion and tenant-boundary risks;
  42. binds final impact analysis to a dependency snapshot and detects dependency drift;
  43. preserves Module and Component lineage in all impact paths;
  44. integrates Pergamum Pulse without granting it constitutional authority;
  45. supports semantic, differential, negative, migration, tenant-isolation, Extension and historical-replay testing;
  46. preserves complete Part II provenance and conformance evidence.

Part II Foundational Principle

Constitutional evolution must be represented as governed meaning, not as edited files, altered code or hidden migration logic.

Every Core change SHALL be expressed through a typed Constitutional Change Set bound to exact source and target baselines. Each operation SHALL identify its semantic effect on identity, structure, behaviour, authority, applicability, lifecycle, compatibility and historical interpretation. Core identities SHALL never be silently reused. Modules and Components SHALL never lose their explicit lineage. Extensions SHALL never be invalidated or absorbed without governed compatibility and migration.

Compatibility SHALL be multidimensional. Grandfathering SHALL be explicit. Migration SHALL implement ratified meaning without inventing new meaning. Dependency analysis SHALL reach every affected tenant, white-label deployment, Extension, Module, Component, Runtime Bundle, Publication and historical record.

By making Core change typed, identity-safe, graph-aware, compatibility-honest, transition-governed, migration-contractual, tenant-isolated and historically traceable, ZAYAZ can evolve its Constitution without breaking the trust accumulated under prior baselines.




GitHub RepoRequest for Change (RFC)