Lifecycle Hooks

IAtomLifecycleHook lets you run code at specific points in the Atom build lifecycle without modifying target definitions.

Interface

public interface IAtomLifecycleHook
{
    Task BeforeExecute(CancellationToken cancellationToken) => Task.CompletedTask;
    Task AfterExecute(CancellationToken cancellationToken) => Task.CompletedTask;
}

Both methods have default no-op implementations, so you only override what you need.

Hook Points

Method	When it runs	Use cases
`BeforeExecute`	After the build model is resolved, before targets execute	Validation, file generation, precondition checks
`AfterExecute`	After all targets complete (success or failure)	Cleanup, reporting, notifications

Registering a Hook

public class MyHook : IAtomLifecycleHook
{
    public Task BeforeExecute(CancellationToken cancellationToken)
    {
        // e.g. verify workflow files are up to date
        return Task.CompletedTask;
    }
}

// In your build definition or module:
builder.Services.AddSingleton<IAtomLifecycleHook, MyHook>();

Multiple hooks can be registered. They run in registration order.

Built-in Hooks

The WorkflowLifecycleHook (registered by WorkflowBuildDefinition) uses BeforeExecute to check whether generated workflow files are outdated and warns or fails accordingly.

Next Steps