generator: make generated Go types implement runtime.Object (#143)

Add opt-in generation of controller-gen-style DeepCopy methods, runtime.Object
and schema.ObjectKind methods on root types, and a per-package
groupversion_info.go (GroupVersion/SchemeBuilder/AddToScheme), so generated Go
models can be registered in a runtime.Scheme and used with k8s ecosystem
libraries. This lets users register types instead of setting apiVersion/kind by
hand.

Gated behind a new features.generateGoRuntimeObjects config flag (off by
default), threaded from config through the project build/run and function
generate commands. When enabled, the generated models module additionally
depends on k8s.io/apimachinery (v0.33.0, matching the function go template so a
generated function that consumes the models still builds).

Root types are detected structurally (APIVersion+Kind+Metadata fields). The
runtime.Object pass runs after the k8s type-name fixups so it sees final type
names, and copies known stdlib-backed alias types (Time, MicroTime, FieldsV1,
RawExtension) by value rather than calling DeepCopyInto.

Verified by compile gates that build the generated module (CRD and OpenAPI
paths) plus a behavioral test asserting deep-copy independence for scalar,
slice-of-struct and map fields and AddToScheme GVK round-tripping.

Author: erikmiller-gusto

cmd/crossplane/config/help/config.md

@@ -18,3 +18,11 @@ Enable alpha commands:
 ```shell
 crossplane config set features.enableAlpha true
 ```
+
+Generate runtime.Object methods and per-package AddToScheme helpers on generated
+Go models (off by default), so generated types can be registered in a
+runtime.Scheme:
+
+```shell
+crossplane config set features.generateGoRuntimeObjects true
+```

cmd/crossplane/config/set.go

@@ -42,8 +42,9 @@ type boolSetter func(c *config.Config, v bool)
 //
 //nolint:gochecknoglobals // This is a constant.
 var boolKeys = map[string]boolSetter{
-	"features.enableAlpha": func(c *config.Config, v bool) { c.Features.EnableAlpha = v },
-	"features.disableBeta": func(c *config.Config, v bool) { c.Features.DisableBeta = v },
+	"features.enableAlpha":              func(c *config.Config, v bool) { c.Features.EnableAlpha = v },
+	"features.disableBeta":              func(c *config.Config, v bool) { c.Features.DisableBeta = v },
+	"features.generateGoRuntimeObjects": func(c *config.Config, v bool) { c.Features.GenerateGoRuntimeObjects = v },
 }
 
 func (c *setCmd) AfterApply() error {

cmd/crossplane/function/generate.go

@@ -39,6 +39,7 @@ import (
 	"github.com/crossplane/crossplane-runtime/v2/pkg/xpkg"
 
 	v1alpha1 "github.com/crossplane/cli/v2/apis/dev/v1alpha1"
+	"github.com/crossplane/cli/v2/internal/config"
 	"github.com/crossplane/cli/v2/internal/filesystem"
 	"github.com/crossplane/cli/v2/internal/kcl"
 	"github.com/crossplane/cli/v2/internal/project/projectfile"
@@ -144,7 +145,7 @@ func functionSchemaLanguage(functionLang string) string {
 }
 
 // Run generates a function scaffold.
-func (c *generateCmd) Run(sp terminal.SpinnerPrinter) error {
+func (c *generateCmd) Run(sp terminal.SpinnerPrinter, cfg *config.Config) error {
 	if err := c.validatePaths(); err != nil {
 		return err
 	}

cmd/crossplane/function/generate_test.go

@@ -30,6 +30,7 @@ import (
 	apiextv1 "github.com/crossplane/crossplane/apis/v2/apiextensions/v1"
 
 	v1alpha1 "github.com/crossplane/cli/v2/apis/dev/v1alpha1"
+	"github.com/crossplane/cli/v2/internal/config"
 	"github.com/crossplane/cli/v2/internal/terminal"
 )
 
@@ -324,7 +325,7 @@ func TestRunErrors(t *testing.T) {
 			case "afterApply":
 				err = c.AfterApply()
 			case "run":
-				err = c.Run(terminal.NewSpinnerPrinter(io.Discard, false))
+				err = c.Run(terminal.NewSpinnerPrinter(io.Discard, false), &config.Config{})
 			}
 			if err == nil {
 				t.Fatalf("expected error containing %q, got nil", tc.wantErrSubstring)

cmd/crossplane/main.go

@@ -126,6 +126,8 @@ func main() {
 		// at runtime.
 		kong.BindTo(logger, (*logging.Logger)(nil)),
 		kong.BindTo(configcmd.ConfigPath(cfgPath), (*configcmd.ConfigPath)(nil)),
+		// Bind the loaded config so commands can read feature flags at runtime.
+		kong.Bind(cfg),
 		kong.Help(helpPrinter),
 		kong.UsageOnError())
 

cmd/crossplane/project/build.go

@@ -31,6 +31,7 @@ import (
 
 	devv1alpha1 "github.com/crossplane/cli/v2/apis/dev/v1alpha1"
 	"github.com/crossplane/cli/v2/internal/async"
+	"github.com/crossplane/cli/v2/internal/config"
 	"github.com/crossplane/cli/v2/internal/dependency"
 	"github.com/crossplane/cli/v2/internal/project"
 	"github.com/crossplane/cli/v2/internal/project/functions"
@@ -83,7 +84,7 @@ func (c *buildCmd) AfterApply() error {
 }
 
 // Run executes the build command.
-func (c *buildCmd) Run(logger logging.Logger, sp terminal.SpinnerPrinter) error {
+func (c *buildCmd) Run(logger logging.Logger, sp terminal.SpinnerPrinter, cfg *config.Config) error {
 	ctx := context.Background()
 
 	if c.Repository != "" {
@@ -97,7 +98,7 @@ func (c *buildCmd) Run(logger logging.Logger, sp terminal.SpinnerPrinter) error
 	concurrency := max(1, c.MaxConcurrency)
 
 	schemasFS := afero.NewBasePathFs(c.projFS, c.proj.Spec.Paths.Schemas)
-	generators := generator.Filter(generator.AllLanguages(), c.proj.Spec.Schemas.GetLanguages())
+	generators := generator.Filter(generator.AllLanguages(generator.WithGoRuntimeObjects(cfg.Features.GenerateGoRuntimeObjects)), c.proj.Spec.Schemas.GetLanguages())
 	schemaRunner := runner.NewRealSchemaRunner(runner.WithImageConfig(c.proj.Spec.ImageConfigs))
 	schemaMgr := manager.New(schemasFS, generators, schemaRunner)
 	cacheDir := c.CacheDir

cmd/crossplane/project/run.go

@@ -42,6 +42,7 @@ import (
 	devv1alpha1 "github.com/crossplane/cli/v2/apis/dev/v1alpha1"
 	"github.com/crossplane/cli/v2/cmd/crossplane/render"
 	"github.com/crossplane/cli/v2/internal/async"
+	"github.com/crossplane/cli/v2/internal/config"
 	"github.com/crossplane/cli/v2/internal/dependency"
 	"github.com/crossplane/cli/v2/internal/project"
 	"github.com/crossplane/cli/v2/internal/project/controlplane"
@@ -132,7 +133,7 @@ func (c *runCmd) AfterApply() error {
 }
 
 // Run executes the run command.
-func (c *runCmd) Run(logger logging.Logger, sp terminal.SpinnerPrinter) error { //nolint:gocyclo // Main command orchestration.
+func (c *runCmd) Run(logger logging.Logger, sp terminal.SpinnerPrinter, cfg *config.Config) error { //nolint:gocyclo // Main command orchestration.
 	ctx := context.Background()
 
 	if c.Repository != "" {
@@ -150,7 +151,7 @@ func (c *runCmd) Run(logger logging.Logger, sp terminal.SpinnerPrinter) error {
 	concurrency := max(1, c.MaxConcurrency)
 
 	schemasFS := afero.NewBasePathFs(c.projFS, c.proj.Spec.Paths.Schemas)
-	generators := generator.Filter(generator.AllLanguages(), c.proj.Spec.Schemas.GetLanguages())
+	generators := generator.Filter(generator.AllLanguages(generator.WithGoRuntimeObjects(cfg.Features.GenerateGoRuntimeObjects)), c.proj.Spec.Schemas.GetLanguages())
 	schemaRunner := runner.NewRealSchemaRunner(runner.WithImageConfig(c.proj.Spec.ImageConfigs))
 	schemaMgr := manager.New(schemasFS, generators, schemaRunner)
 	cacheDir := c.CacheDir

internal/config/config.go

@@ -42,6 +42,11 @@ type Config struct {
 type Features struct {
 	EnableAlpha bool `json:"enableAlpha,omitempty"`
 	DisableBeta bool `json:"disableBeta,omitempty"`
+
+	// GenerateGoRuntimeObjects enables generation of runtime.Object methods and
+	// per-package AddToScheme helpers on generated Go models. Disabled by
+	// default; opt in to register generated types with a runtime.Scheme.
+	GenerateGoRuntimeObjects bool `json:"generateGoRuntimeObjects,omitempty"`
 }
 
 // Load reads a Config from path. A missing file is not an error; the zero