params

type Params struct {
	// RepoName is the repository name. It is used for the Go binary, the
	// Helm chart, and the architect job names.
	RepoName string
	// Language is the repo language (e.g. "go"). "go" selects the go-build
	// job.
	Language string
	// HasDockerfile is true when the repo ships a Dockerfile. It selects the
	// image pipeline (push-to-registries with split-china-push and the
	// paired sync-china-registry job).
	HasDockerfile bool
	// HasApp is true when the repo carries the "app" flavour (at least one
	// Helm chart). It selects the chart pipeline (push-to-app-catalog with the
	// app-build-suite executor and run-tests-with-ats).
	HasApp bool
	// ChartName is the chart name used for the push-to-app-catalog `chart`
	// param and the helm/<chart> directory. Defaults to RepoName. Set it for
	// repos whose chart directory does not match the repo name (e.g.
	// docs-proxy ships helm/docs-proxy-app). The append-only custom.yml merge
	// cannot rename a generated job's chart, so the generator carries it.
	ChartName string
	// ForcePublic pushes the image and chart as public artifacts even though
	// the repo is private (architect `force-public: true` on push-to-registries
	// and push-to-app-catalog). Set it for private repos that publish public
	// artifacts (e.g. web-assets); architect otherwise derives private from the
	// repo visibility. Mutually exclusive with ImagePrivateOnly.
	ForcePublic bool
	// AppCatalog is the catalog the chart pipeline publishes to (the
	// push-to-app-catalog `app_catalog` param). Defaults to "giantswarm-catalog".
	// Repos that ship to a different catalog (e.g. the internal
	// "giantswarm-operations-platform") set it so generation does not silently
	// migrate their chart to the public catalog.
	AppCatalog string
	// AppCatalogTest is the test catalog the chart pipeline publishes to (the
	// push-to-app-catalog `app_catalog_test` param). Defaults to
	// "giantswarm-test-catalog". Kept paired with AppCatalog.
	AppCatalogTest string
	// BranchPublish is true when the repo opts into publishing a dev image and
	// chart on branch builds. By default branches build + test only; when set,
	// the branch path additionally pushes an amd64 dev image and the dev chart
	// (coupled).
	BranchPublish bool
	// ImagePreBuildJob names a repo-owned job (defined in .circleci/custom.yml)
	// that the release image build must wait on. The generated
	// push-to-registries-release job gains a `requires` entry for it, which the
	// append-only custom.yml merge cannot inject into a generated job. Used for
	// workspace-handoff pre-steps (e.g. a job that persists a generated file the
	// Docker build context overlays via attach_workspace). The branch
	// build-image (and branch-publish push-to-registries) job gains the same
	// `requires` entry, so the branch image validation also gets the workspace.
	// Empty for the common case.
	ImagePreBuildJob string
	// ImagePrivateOnly is true when the repo's image must ship only to the
	// private registry (gsociprivate). It replaces the default split-china-push
	// (which also publishes the public gsoci copy and mirrors to Aliyun) with an
	// explicit private-only registries-data, and omits the sync-china-registry
	// job. Set it for private repos whose image must not land in the public
	// catalog.
	ImagePrivateOnly bool
	// ImageName overrides the `giantswarm/<repo>` default the architect orb
	// derives for the published image (the push-to-registries / sync-china-registry
	// `image` param). Set it for repos whose image name differs from the repo
	// name (e.g. kserve publishes `giantswarm/kserve-controller`). The
	// append-only custom.yml merge cannot rename a generated job's image, so the
	// generator carries it. Empty keeps the orb default.
	ImageName string
	// ImagePlatforms overrides the buildx platform list for the image build
	// (the push-to-registries `platforms` param on the build-image and
	// push-to-registries-release jobs). Empty lets the orb fall back to its
	// default (linux/amd64,linux/arm64 when no go-build .platforms file). Set it
	// for repos whose image targets a single architecture (e.g. vllm ships an
	// arm64-only image for DGX Spark; an amd64 build has no prebuilt wheels and
	// fails). The append-only custom.yml merge cannot cap a generated job's
	// platforms, so the generator carries it.
	ImagePlatforms string
	// ImageDockerfile overrides the Dockerfile path on the image jobs (the
	// architect push-to-registries `dockerfile` param). Set it for repos whose
	// Dockerfile is not at the repo root (e.g. backstage builds from
	// packages/backend/Dockerfile). A non-empty value also forces the image
	// pipeline on, since the root-Dockerfile derivation misses a nested
	// Dockerfile. The append-only custom.yml merge cannot set this on a
	// generated job, so the generator carries it. Empty keeps the orb default
	// ("Dockerfile").
	ImageDockerfile string
	// ReleaseBinaries is true when the repo distributes cross-platform Go
	// binaries on its GitHub Release (derived from the "cli" flavour on a Go
	// repo). It adds the six-platform architectures matrix to go-build and an
	// upload-release-assets job, and caps the multi-arch image push to
	// linux/amd64,linux/arm64 (otherwise buildx tries the darwin/windows
	// targets under QEMU and hangs).
	ReleaseBinaries bool
	// BuildConcurrency is the architect go-build `build_concurrency` value the
	// cli-flavour job renders (how many architectures compile concurrently).
	// Defaulted to "auto" by the generator for cli repos; empty for non-cli
	// repos, where the template omits the go-build resource block entirely.
	BuildConcurrency string
	// ResourceClass is the CircleCI resource_class the cli-flavour go-build job
	// renders. Defaulted to "large" by the generator for cli repos; empty for
	// non-cli repos.
	ResourceClass string
	// OrbVersion is the giantswarm/architect orb version to pin.
	OrbVersion string
	// ContinuationOrbVersion is the circleci/continuation orb version the
	// setup config pins.
	ContinuationOrbVersion string
	// BuildJobName is the build/test job the image and chart jobs gate on via
	// `requires` -- "go-build" for Go, "node-build"/"node-test" for Node. Empty
	// for languageless repos (the image/chart jobs then gate on nothing extra).
	BuildJobName string
	// NodeJobName is the generated Node job's name: "node-build" when it
	// persists a build output for an image handoff, "node-test" otherwise.
	// Empty for non-Node repos.
	NodeJobName string
	// NodeImageVersion is the cimg/node Docker tag the Node job runs on.
	NodeImageVersion string
	// NodeInstallCommand installs dependencies for the detected package manager
	// (e.g. "npm ci", "yarn install --immutable").
	NodeInstallCommand string
	// NodeRunPrefix prefixes a package.json script invocation for the detected
	// package manager (e.g. "npm run", "yarn run").
	NodeRunPrefix string
	// NodeCachePath is the dependency cache directory for the detected package
	// manager (e.g. "~/.npm", ".yarn/cache").
	NodeCachePath string
	// NodeCacheKey is the full save_cache key, embedding the literal CircleCI
	// `{{ checksum "<lockfile>" }}` expression so the cache invalidates when the
	// lockfile changes.
	NodeCacheKey string
	// NodeCacheRestoreKey is the lockfile-agnostic restore_cache prefix, so a
	// changed lockfile still warm-starts from the last good cache.
	NodeCacheRestoreKey string
	// NodeCorepack is true when the package manager needs `corepack enable`
	// (pnpm, which cimg/node does not bundle).
	NodeCorepack bool
	// NodeTestTarget is the package.json script the Node job runs for the
	// verify phase (the make-target interface). Defaults to "test".
	NodeTestTarget string
	// NodeBuildTarget is the package.json script the Node job runs to build.
	// Empty omits the build step.
	NodeBuildTarget string
	// NodeBuildOutput is the workspace path the Node job persists for an image
	// handoff (e.g. "packages/*/dist/*"). Empty omits persist_to_workspace.
	NodeBuildOutput string
}