workers

You can scaffold a Go background worker with graceful shutdown by generating an implementation where Start(ctx) blocks until context cancellation and Stop(ctx) performs deadline-bound cleanup. This enforces a consistent lifecycle contract for long-running tasks.

Create a cron-scheduled worker by specifying a cron expression during scaffolding. The generated code starts and stops the scheduler inside the Start(ctx) block, allowing periodic maintenance jobs to participate cleanly in the single-binary runtime.

Yes, worker scaffolding includes testing support by generating a basic lifecycle test and providing patterns for verifying message processing using mock dependencies, ensuring your background tasks behave correctly during startup and shutdown.

Wiring a new background worker involves adding its metadata to forge.yaml and running the generation command. This process integrates the worker's lifecycle hooks directly through pkg/app/bootstrap.go for automatic dependency injection.

The best way to handle queue consumers and periodic batch processing is using a consistent Start/Stop lifecycle contract. This ensures long-running Go tasks block correctly during execution and perform deadline-bound cleanup upon context cancellation.