Add resyncPeriod and lastSyncTime API fields

Add resyncPeriod to the code generator spec template allowing
per-resource configuration of how frequently the controller
re-reconciles even when no changes are detected. Add lastSyncTime to the
status template to track when the last successful resync occurred.

Update the adapter template and interface to expose GetResyncPeriod(),
GetLastSyncTime(), and IsImported() methods.

Author: eshulman2

.gitignore

@@ -42,3 +42,6 @@ __pycache__/
 
 /bundle/
 bundle.Dockerfile
+
+# Forge workflow state (do not commit)
+.forge/

api/v1alpha1/controller_options.go

@@ -63,3 +63,4 @@ func (o *ManagedOptions) GetOnDelete() OnDelete {
 	}
 	return o.OnDelete
 }
+

cmd/resource-generator/data/adapter.template

@@ -17,6 +17,8 @@ limitations under the License.
 package {{ .NameLower }}
 
 import (
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+
 	orcv1alpha1 "github.com/k-orc/openstack-resource-controller/v2/api/v1alpha1"
 	"github.com/k-orc/openstack-resource-controller/v2/internal/controllers/generic/interfaces"
 )
@@ -54,6 +56,14 @@ func (f adapterT) GetManagedOptions() *orcv1alpha1.ManagedOptions {
 	return f.Spec.ManagedOptions
 }
 
+func (f adapterT) GetResyncPeriod() *metav1.Duration {
+	return f.Spec.ResyncPeriod
+}
+
+func (f adapterT) GetLastSyncTime() *metav1.Time {
+	return f.Status.LastSyncTime
+}
+
 func (f adapterT) GetStatusID() *string {
 	return f.Status.ID
 }
@@ -76,6 +86,10 @@ func (f adapterT) GetImportFilter() *filterT {
 	return f.Spec.Import.Filter
 }
 
+func (f adapterT) IsImported() bool {
+	return f.GetImportID() != nil || f.GetImportFilter() != nil
+}
+
 {{- if not .IsNotNamed }}
 
 // getResourceName returns the name of the OpenStack resource we should use.

cmd/resource-generator/data/api.template

@@ -90,6 +90,14 @@ type {{ .Name }}Spec struct {
 	// +optional
 	ManagedOptions *ManagedOptions `json:"managedOptions,omitempty"`
 
+	// resyncPeriod defines how frequently the controller will re-reconcile
+	// this resource even when no changes have been detected. This overrides
+	// the global default resync period. The value must be a valid Go duration
+	// string, e.g. "10m", "1h". Set to "0s" to disable periodic resync for
+	// this resource.
+	// +optional
+	ResyncPeriod *metav1.Duration `json:"resyncPeriod,omitempty"` //nolint:kubeapilinter // metav1.Duration is appropriate for user-facing duration config
+
 	// cloudCredentialsRef points to a secret containing OpenStack credentials
 	// +required
 	CloudCredentialsRef CloudCredentialsReference `json:"cloudCredentialsRef,omitzero"`
@@ -127,6 +135,13 @@ type {{ .Name }}Status struct {
 	// resource contains the observed state of the OpenStack resource.
 	// +optional
 	Resource *{{ .Name }}ResourceStatus `json:"resource,omitempty"`
+
+	// lastSyncTime is the timestamp of the last successful reconciliation
+	// that fetched state from OpenStack. It is updated each time the
+	// controller successfully reads the resource state from the OpenStack
+	// API.
+	// +optional
+	LastSyncTime *metav1.Time `json:"lastSyncTime,omitempty"`
 {{- if .StatusExtraType }}
 
 	{{ .StatusExtraType }} `json:",inline"`

internal/controllers/generic/interfaces/adapter.go

@@ -33,9 +33,18 @@ type APIObjectAdapter[orcObjectPT any, resourceSpecT any, filterT any] interface
 
 	GetManagementPolicy() orcv1alpha1.ManagementPolicy
 	GetManagedOptions() *orcv1alpha1.ManagedOptions
+	GetResyncPeriod() *metav1.Duration
+	GetLastSyncTime() *metav1.Time
 
 	GetStatusID() *string
 	GetResourceSpec() *resourceSpecT
 	GetImportID() *string
 	GetImportFilter() *filterT
+
+	// IsImported returns true if the resource was imported (rather than created
+	// by ORC). A resource is considered imported if it has a non-nil importID or
+	// a non-nil importFilter. This is used to decide how to handle external
+	// deletion: imported resources result in a terminal error, while ORC-created
+	// resources are recreated.
+	IsImported() bool
 }