Actuality & Potentiality

Materializes the objectives required by an active situation, reusing reference templates when available and preserving their lineage.

A/P

ActualityAndPotentialityModelsPopulateInterceptor

Situation-to-objective projection inside core governance.

afterAdd · afterUpdate · beforeDelete

TriggerThe node inherits Actuality or Potentiality, is ACTIVE, and the global ActualityAndPotentialityInterceptorControl is not disabled.

TEMPLATE PATHClone reference objectives

A Near relation to a FREEZE or REFERENCE situation supplies the objectives and semantic edges to clone.

FALLBACK PATHCreate one objective

Creates objective_<nodeId> when no template applies and the situation is not NOT_VALIDATED.

DELETE PATHRemove dependants

Associated active objectives and their relations are deleted before the situation disappears.

UPDATE PATHActivate frozen objectives

Only on a FREEZE → ACTIVE transition of a situation that is not NOT_VALIDATED: FREEZE objectives linked by Treats, Prevents or Enables become ACTIVE; if none is linked, the creation path is replayed.

01 · Creation

From a situation template to live objectives

ACTIVE situationActuality, Risk or Opportunity

Near templateFREEZE / REFERENCE

Clone objectivesACTIVE + new color

Rewire meaningTreats / Prevents / Enables

Keep lineageNear original objective

Each clone receives an id suffixed with _clonedFor_<situationId>. Modeling metadata and broken edges are cleared. Derived writes notify only when the element is new and use preAndPostTreatment=false; deletions, by contrast, replay the chain.

afterAddNodesimplified

if disabled or not Actuality/Potentiality or status != ACTIVE: return
templates = query Near(FREEZE | REFERENCE, situation)
if templates are present:
    for objective linked to template:
        clone objective as ACTIVE
        add Treats, Prevents or Enables toward situation
        add Near(clone, originalObjective)
        persist without nested treatments
else if situation is valid and has no active objective:
    create objective_<situation.id>
    connect with Treats / Prevents / Enables

02 · Semantics

The relation depends on the situation kind

ActualityObjective —Treats→ Actuality

The objective describes how the current fact is handled.

RiskObjective —Prevents→ Risk

The objective aims to stop a potential adverse situation.

OpportunityObjective —Enables→ Opportunity

The objective makes a beneficial potentiality achievable.

Update limited to one transition

Only the FREEZE → ACTIVE transition is handled (for example a sensor rule activating a frozen actuality in place): core governance passes the previously stored node to actionAfterUpdateNode(previous, node, …). Reactivated objectives receive a refreshed Created at, so a new incident after a previous supervision is not treated as an old objective. Any other update is ignored, because recreating objectives on update is incompatible with r-iota’s positive-deviation deletion workflow.

Actuality & Potentiality

Matérialise les objectifs requis par une situation active, en réutilisant les modèles de référence disponibles et en conservant leur filiation.

A/P

ActualityAndPotentialityModelsPopulateInterceptor

Projection d’une situation vers ses objectifs dans la gouvernance.

afterAdd · afterUpdate · beforeDelete

DéclencheurLe nœud hérite d’Actuality ou Potentiality, est ACTIVE et le contrôle global n’est pas désactivé.

AVEC MODÈLECloner les objectifs

Une relation Near vers une situation FREEZE ou REFERENCE fournit les objectifs et les arêtes sémantiques.

SANS MODÈLECréer un objectif

Crée objective_<nodeId> si aucun modèle ne convient et si la situation n’est pas NOT_VALIDATED.

SUPPRESSIONNettoyer les dépendances

Les objectifs actifs associés et leurs relations sont supprimés avant la situation.

MISE À JOURActiver les objectifs gelés

Uniquement lors d’une transition FREEZE → ACTIVE d’une situation non NOT_VALIDATED : les objectifs FREEZE reliés par Treats, Prevents ou Enables passent ACTIVE ; si aucun n’est relié, le chemin de création est rejoué.

01 · Création

Du modèle de situation aux objectifs vivants

Situation ACTIVEActuality, Risk ou Opportunity

Modèle NearFREEZE / REFERENCE

ClonerACTIVE + nouvelle couleur

RelierTreats / Prevents / Enables

Conserver la filiationNear vers l’original

Chaque clone reçoit un identifiant suffixé par _clonedFor_<situationId>. Les informations de modélisation et les broken edges sont effacées. Les écritures dérivées notifient seulement si l’élément est nouveau et désactivent les traitements imbriqués ; les suppressions, elles, rejouent la chaîne.

afterAddNodesimplifié

si désactivé, type incorrect ou statut != ACTIVE : sortir
modèles = chercher Near(FREEZE | REFERENCE, situation)
si modèles présents :
    pour chaque objectif du modèle :
        cloner comme ACTIVE
        créer Treats, Prevents ou Enables vers la situation
        créer Near(clone, objectifOriginal)
        persister sans traitements imbriqués
sinon, si situation valide et sans objectif actif :
    créer objective_<situation.id> et sa relation

02 · Sémantique

La relation dépend du type de situation

ActualityObjective —Treats→ Actuality

L’objectif décrit le traitement du fait actuel.

RiskObjective —Prevents→ Risk

L’objectif empêche une potentialité défavorable.

OpportunityObjective —Enables→ Opportunity

L’objectif rend une potentialité favorable réalisable.

Update limité à une transition

Seule la transition FREEZE → ACTIVE est traitée (par exemple une règle capteur qui active sur place une actualité gelée) : la gouvernance transmet le nœud stocké avant la mise à jour à actionAfterUpdateNode(précédent, nœud, …). Les objectifs réactivés reçoivent un Created at renouvelé : un nouvel incident après une supervision précédente n’est donc pas traité comme un ancien objectif. Toute autre mise à jour est ignorée, car recréer les objectifs à l’update serait incompatible avec la suppression d’une déviation positive dans r-iota.