Glossary

Core Concepts

Desired State: A declaration of what state data should be in. Nagi evaluates data against this declaration and, when drift is detected, converges toward it.
Evaluation: Determining whether data satisfies its desired state. The result is either Ready (in the desired state) or Drifted (drifted from the desired state).
Convergence: The process of bringing drifted data back to its desired state.
Reconciliation Loop: A loop that keeps data in its desired state by continuously repeating evaluation and convergence.

Evaluate: The operation that performs evaluation. It only determines the state of data — it does not modify data.
Sync: The concrete action that performs convergence. Executes operations to bring data back to its desired state.

Asset: A unit of data whose desired state is declared and evaluated by Nagi. Runs the corresponding Sync when drift is detected.
Conditions: A resource that groups desired state definitions. Can be referenced by multiple Assets.
Connection: Connection information for a data warehouse.
Sync: A convergence action definition. Can be referenced by multiple Assets.
Origin: A resource that automatically generates Assets. Generates Assets from data structure information held by other software.

Ready: All desired states of an Asset are satisfied.
Drifted: The data has drifted from its desired state. The corresponding Sync is run.
Suspended: Sync has been automatically stopped. This occurs when state degrades after a Sync or when Syncs fail repeatedly.
Halted: All Asset Syncs have been stopped at once.

Controller: The execution unit that manages scheduling of Evaluate and Sync.
Guardrails: Prevents further state degradation caused by Sync. Detects state degradation or repeated failures and automatically suspends Sync for the affected Asset.
Graceful Shutdown: On receiving a stop signal, waits for running Syncs to complete before exiting.